shithub: purgatorio

ref: 75c92428225428c8fde2d015f010e608a0b12f1d
dir: purgatorio/man/4/export

View raw version
.TH EXPORT 4
.SH NAME
export \- export name space on a connection
.SH SYNOPSIS
.B export
[
.B \-a
]
.I dir
[
.I file
]
.SH DESCRIPTION
.I Export
calls
.IR sys-export (2)
to serve the name space rooted at
.I dir
over a connection to a 9P (Styx) client.
.I Export
opens the connection on the given
.IR file ,
or uses the standard input by default.
It returns when the client closes the connection.
If the
.B \-a
option is given, however,
.I export
starts an Inferno kernel process
to serve the name space and returns immediately.
.I Export
serves the current name space without forking it; changes made to it
will be visible to clients.
.PP
.I Export
starts serving 9P immediately; it assumes that the connection
has been authenticated if required.
.I Export
is typically called via
.IR listen (1),
which can authenticate the connection.
.SH EXAMPLE
Start a background process to serve the name space on the serial port.
.IP
.B "export / /dev/eia0 &"
.PP
Although useful when bootstrapping a system, this is unsafe
unless a transport protocol is run on the connection.
.SH SOURCE
.B /appl/cmd/export.b
.SH SEE ALSO
.IR cpu (1),
.IR listen (1),
.IR dial (2),
.IR sys-export (2),
.IR intro (5)