4.9.5.2 Ssi tcp links
Ssi tcp links give the possibility to exchange data
between two processes which may run on the same or on different
computers. Ssi tcp links can be opened in four different modes:
tcp
- SINGULAR acts as a server.
connect
- SINGULAR acts as a client.
tcp <host>:<program>
- SINGULAR acts as a client, launching an application as server.
This reuires
ssh /sshd to be installed an the computers
(and preferably an automatic login via .ssh/authorized_keys ).
fork
- SINGULAR acts as a client, forking another SINGULAR as
server.
The Ssi tcp link describing string has to be
- tcp mode:
"ssi:tcp"
SINGULAR becomes a server and waits at the first free port (>1024) for a
connect call.
- connect mode:
"ssi:connect " + host: port
SINGULAR becomes a client and connects to a server waiting at
the host and port.
- launch mode:
"ssi:tcp" + host: application
SINGULAR becomes a client and starts (launches) the application
using ssh on a (possibly) different host
which then acts as a server.
- fork mode:
"ssi:fork"
SINGULAR becomes a client and forks another SINGULAR on the
same host which acts as a server.
To open an ssi tcp link in launch mode, the application to launch must
either be given with an absolute pathname, or must be in a directory
contained in the search path. The launched application acts as a server,
whereas the SINGULAR that actually opened the link acts as a
client.
The client "listens" at the some free port until the server
application does a connect call.
If the ssi tcp link is opened in fork mode a child of the current
SINGULAR is forked. All variables and their values are inherited by
the child. The child acts as a server whereas the SINGULAR that
actually opened the link acts as a client.
To arrange the evaluation of an expression by a server, the expression
must be quoted using the command quote (see quote), so that
a local evaluation is prevented. Otherwise, the expression is evaluated
first, and the result of the evaluation is written, instead of the
expression which is to be evaluated.
If SINGULAR is in server mode, the value of the variable
link_ll is the ssi link connecting to the client and
SINGULAR is in an infinite read-eval-write loop until the
connection is closed from the client side (by closing its connecting
link).
Reading and writing is done to the link link_ll :
After an
expression is read, it is evaluated and the result of the evaluation is
written back. That is, for each expression which was written to the
server, there is exactly one expression written back. This might be an
"empty" expression, if the evaluation on the server side does not return
a value.
Ssi tcp links should explicitly be opened before being used. Ssi tcp links
are bidirectional, i.e. can be used for both, writing and
reading. Reading from an ssi tcp link blocks until data was written to
that link. The status command can be used to check whether there
is data to read.
Example:
| int i=7;
link l = "ssi:fork"; // fork link declaration
open(l); l;
==> // type : ssi
==> // mode : fork
==> // name :
==> // open : yes
==> // read : not ready
==> // write: ready
write(l,quote(i)); // Child inherited vars and their values
read(l);
==> 7
close(l); // shut down forked child
|
|