shithub: riscv

ref: 4195e1a54e54d76aad8352d62b774c07e2b8ec98
dir: /sys/man/4/execnet/

View raw version
.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.