Skip to main content

Peer management

GETHOSTNAME

gethostname( ) -> Charstring
STABLE

The local host name of this computer


GET_IP

get_ip(Charstring host) -> Bag of Charstring
STABLE

The IP address(es) of host


HOST

host(Peer p) -> Charstring
STABLE

No description.


IPS

ips(Peer p) -> Record
STABLE

No description.


IS_RUNNING

is_running(Charstring peer)
STABLE

Is peer running?


LISTEN

listen( )
STABLE

Start running this peer as a server


MULTICASTRECEIVE

multicastreceive(Vector peers, Charstring fn, Vector args) -> Bag
STABLE

No description.


MY_HOSTNAME

my_hostname(Charstring host) -> Charstring
STABLE

Set the hostname used by the system to host


my_hostname( ) -> Charstring
STABLE

The hostname to locate the computer where SE Engine runs


MY_LOCAL_IP

my_local_ip( ) -> Bag of Charstring
STABLE

The IP addresses for localhost of this computer.

 Same as `get_ip("localhost")`

For all IP addresses on all interfaces use
`get_all_addrs()`

NAME

name(Peer p) -> Charstring
STABLE

No description.


NAMESERVER

nameserver(Charstring descr) -> Charstring
STABLE

Make this peer the nameserver of a federation of sa.engine peers.

 Format of `descr`: `''` or `'name'` or `'name:port'` or `':port'`. 
The default `name` is NAMESERVER.
The default `port` is 35021 or the envonment variable NAMESERVERPORT.
If `name` is non-empty the nameserver will still have the name
NAMESERVER as alias.
Start the nameserver by calling `listen()`

NAMESERVERHOST

nameserverhost( ) -> Charstring
STABLE

Get current nameserver's host name


nameserverhost(Charstring name) -> Charstring
STABLE

Set host name of nameserver to name


NAMESERVERPORT

nameserverport(Integer no) -> Integer
STABLE

Set port number used by nameserver to no


OTHER_PEERS

other_peers( ) -> Bag of Charstring nm
STABLE

Return all other peers in federation


PEERINFO

peerinfo(Peer p)->(Charstring, Charstring, Integer, Integer, Record)
STABLE

In nameserver: basic information about peer p


PEER_NAMED

peer_named(Charstring peer) -> Peer
STABLE

Get the object representing the peer


PID

pid(Peer p) -> Integer
STABLE

No description.


PORTNO

portno(Peer p) -> Integer
STABLE

No description.


PORTTIMEOUT

porttimeout(Real timeout) -> Real
STABLE

Set timout for opening a port to a peer


REGISTER

register(Charstring peerspec) -> Charstring
STABLE

Register this peer in the nameserver with peerspec being

 `peer` or `peer@host` or `peer@host:port` or `peer@:port` 

REMOTE_FUNCTION_TUPLES

remote_function_tuples(Charstring peer, Charstring fn, Vector args) -> Bag of Vector
STABLE

No description.


REREGISTER

reregister(Charstring peerspec) -> Charstring
STABLE

Register this peer in the nameserver with peerspec being

 `peer` or `peer@host` or `peer@host:port` or `peer@:port`.
Override possible existing registration

ROUTEAPPLY

routeapply(Charstring fn, Bag inputs) -> Bag
STABLE

No description.


SEND

send(Charstring peer, Charstring query) -> Literal
STABLE

Send query to peer for evaluation without waiting for result


SERVER

server(Charstring name, Charstring host, Integer port)
STABLE

Run this process as server named name on host listening on port


SHIP

ship(Charstring peer, Charstring query) -> Bag of Vector
STABLE

Ship query string to peer for evaluation and ship back result


START_ENGINE

start_engine(Charstring name, Charstring image, Number timeou) -> Charstring
STABLE

Start a new local server named name on this computer with image.

 Wait for server to start `timeout` seconds before failing 

start_engine(Charstring name, Charstring image, Number timeout, Charstring flgs) -> Charstring
STABLE

No description.


start_engine(Charstring name) -> Charstring
STABLE

Start a new local server named name on this computer


start_engine(Charstring name, Charstring image) -> Charstring
STABLE

Start a new local server named name with image


START_NAMESERVER

start_nameserver(Charstring name) -> Charstring
STABLE

Start a new nameserver named name on this computer


start_nameserver(Charstring name, Charstring extra_flags) -> Charstring
STABLE

Start a new nameserver named name on this computer


THIS_PEERID

this_peerid( ) -> Charstring
STABLE

Get the name of this peer


WAIT_FOR

wait_for(Vector of Charstring peers)
STABLE

Wait for peers to start listening


wait_for(Charstring peer)
STABLE

Wait for peer to start listening