plan9fox/sys/man/4/execnet
2016-01-12 08:43:36 +01:00

62 lines
995 B
Text

.TH EXECNET 4
.SH NAME
execnet \- network interface to program execution
.SH SYNOPSIS
.B execnet
[
.B -n
.I name
]
[
.B netdir
]
.SH DESCRIPTION
.I Execnet
presents a network protocol directory
(see, for example,
.IR ip (3))
called
.IB netdir / name
(default
.BR /net/exec ).
.PP
Once the protocol directory exists, dialing
(see
.IR dial (2))
strings of
the form
.IB name ! cmd
will connect to a newly executed instance of
.IR cmd .
.SH EXAMPLE
.I Execnet
can be used to connect to instances of u9fs
running on other hosts:
.EX
g% execnet
g% srv -m 'exec!ssh ny start-u9fs' ny /n/ny
.EE
This example assumes that the remote command
.B start-u9fs
executed on
.B ny
will start
.I u9fs
appropriately.
For example, it might be:
.EX
ny% cat start-u9fs
#!/bin/sh
u9fs -na none -u $USER -l $HOME/tmp/u9fs.log
ny%
.EE
.SH SOURCE
.B /sys/src/cmd/execnet
.SH "SEE ALSO
.IR dial (2),
.IR ip (3),
.SH BUGS
Almost certainly:
.IR execnet
has only been tested as in the example shown.