20060303-partial

1 files changed, 69 insertions, 0 deletions

diff --git a/man/4/export b/man/4/export
new file mode 100644
index 00000000..ea2fdf39
--- /dev/null
+++ b/man/4/export
@@ -0,0 +1,69 @@
+.TH EXPORT 4
+.SH NAME
+export \- export name space on a connection
+.SH SYNOPSIS
+.B export
+[
+.B \-a
+] [
+.B \-n
+]
+.I dir
+[
+.I file
+]
+.SH DESCRIPTION
+.I Export
+calls
+.B Sys->export
+(see
+.IR sys-dial (2))
+to serve a name space rooted at
+.I dir
+over a connection to a 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.
+.PP
+Normally,
+.I export
+forks the current name space, and makes
+.I dir
+the root of its copy.
+Changes subsequently made to the current name space will
+not be visible to clients of
+.IR export .
+If the
+.B \-n
+option is given, however, and
+.I dir
+is the root
+.RB (` / '),
+.I export
+serves the current name space without forking it; changes made to it
+will be visible to clients.
+.PP
+.I Export
+starts serving Styx immediately; it assumes that the connection
+has been authenticated if required.
+.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 sys-dial (2),
+.IR intro (5)