aboutsummaryrefslogtreecommitdiff
path: root/man/man4
diff options
context:
space:
mode:
authorAkshat Kumar <seed@mail.nanosouffle.net>2012-09-24 10:35:01 -0400
committerRuss Cox <rsc@swtch.com>2012-09-24 10:35:01 -0400
commitac3ba726f9b4978829e4ad186b00109262fa2b93 (patch)
tree5e8e17412c3c3827a67cf1f2aa403c083834a143 /man/man4
parent37f8ed2410ad5cbd46eda00a77f8bf4950bcf544 (diff)
downloadplan9port-ac3ba726f9b4978829e4ad186b00109262fa2b93.tar.gz
plan9port-ac3ba726f9b4978829e4ad186b00109262fa2b93.tar.bz2
plan9port-ac3ba726f9b4978829e4ad186b00109262fa2b93.zip
src/cmd: Add a repurposed import(4), called `9import', to the ports.
The code is adapted from Plan 9's import(4); this allows us to speak that protocol. We don't currently support AAN (in the works) or TLS/SSL. Thanks to David for help with the man page, testing, and development. R=0intro, rsc CC=plan9port.codebot http://codereview.appspot.com/6458100
Diffstat (limited to 'man/man4')
-rw-r--r--man/man4/9import.479
1 files changed, 79 insertions, 0 deletions
diff --git a/man/man4/9import.4 b/man/man4/9import.4
new file mode 100644
index 00000000..e5b177cf
--- /dev/null
+++ b/man/man4/9import.4
@@ -0,0 +1,79 @@
+.TH 9IMPORT 4
+.SH NAME
+9import \- import a name space from a remote system
+.SH SYNOPSIS
+.B 9import
+[
+.I options
+]
+.I system
+.I file
+[
+.I mountpoint
+]
+.SH DESCRIPTION
+The
+.I 9import
+tool allows an arbitrary
+.I file
+on a remote
+.I system,
+with the capability of running the Plan 9
+.IR exportfs (4)
+service,
+to be imported into the local name space.
+Usually
+.I file
+is a directory, so the complete
+file tree under the directory is made available.
+.PP
+A process is started on the
+remote machine, with authority of the user of
+.IR 9import ,
+to perform work for the local machine using the
+.IR exportfs (4)
+service.
+The default port used is TCP 17007.
+If
+.I mountpoint
+is omitted, then
+.I 9import
+uses the name of the remote
+.I file
+as the local mount point.
+.PP
+The options are:
+.TF "-s namexxx"
+.PD
+.TP
+.B -A
+Skip the authentication protocol.
+This is useful for connecting to foreign systems like Inferno.
+.TP
+.B -k \fIkeypattern
+Use
+.I keypattern
+to select a key to authenticate to the remote side
+(see
+.IR auth (2)).
+.TP
+.B -p
+Push the
+.IR aan (8)
+filter onto the connection to protect against
+temporary network outages.
+.TP
+.B -s \fIname
+Post the connection's mountable file descriptor as
+.BI /srv/ name\fR.
+.SH SOURCE
+.B \*9/src/cmd/9import.c
+.SH SEE ALSO
+.IR srv (4),
+.IR aan (8),
+.IR listen1 (8),
+.B cs
+in
+.IR ndb (7)
+.SH BUGS
+Encryption is not implemented.