aboutsummaryrefslogtreecommitdiff
path: root/man/4/export
diff options
context:
space:
mode:
authorbhgv <bhgv.empire@gmail.com>2018-03-01 16:54:45 +0200
committerbhgv <bhgv.empire@gmail.com>2018-03-01 16:54:45 +0200
commitb786f20bbab5a59046aa78a2c6c2a11536497202 (patch)
tree0851ecdec889eb9b7ba3751cc04d4f0b474e4a9e /man/4/export
inferno-os tree was separated from the inferno-os-android (separated from the Android driver)
Diffstat (limited to 'man/4/export')
-rw-r--r--man/4/export56
1 files changed, 56 insertions, 0 deletions
diff --git a/man/4/export b/man/4/export
new file mode 100644
index 0000000..ea2b378
--- /dev/null
+++ b/man/4/export
@@ -0,0 +1,56 @@
+.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)