diff options
Diffstat (limited to '9mount.1')
-rw-r--r-- | 9mount.1 | 115 |
1 files changed, 115 insertions, 0 deletions
diff --git a/9mount.1 b/9mount.1 new file mode 100644 index 0000000..a4884b0 --- /dev/null +++ b/9mount.1 @@ -0,0 +1,115 @@ +.TH "9mount" "1" "04 September 2007" "9mount" "User commands" +.SH NAME +9mount, 9bind, 9umount \- mount/unmount 9p filesystems +.SH SYNOPSIS +.B 9mount +[ insuvx ] [ -a SPEC ] [ -c CACHE ] [ -d DEBUG ] [ -m MSIZE ] DIAL MOUNTPT +.PP +.B 9bind +OLD NEW +.PP +.B 9umount +MOUNTPT +.SH DESCRIPTION +.B 9mount +mounts a 9p filesystem served at DIAL on MOUNTPT. MOUNTPT must be +writable by you and not sticky. DIAL is a dial string assuming one of +the forms: +.PP +unix!SOCKET +.br +tcp!HOST[!PORT] +.br +virtio!CHANNEL +.br +- +.PP +where SOCKET is the name of a file representing a socket, HOST is a +hostname, PORT is a port number or service name, and CHANNEL is a +virtio channel name (currently ignored). - indicates that 9p messages +should be read/written on stdin/stdout. +.B 9mount +has several options: +.TP +-i +mount the file system with your uid/gid +.TP +-n +dry-run, print mount command to stderr but don't actually mount anything +.TP +-s +single attach mode - all users accessing the mount point see the same +filesystem (by default they'll each see a unique attach) +.TP +-u +use the 9P2000.u extensions +.TP +-v +use device mapping +.TP +-x +exclusive access - other users cannot access the mount point +.TP +-a SPEC +SPEC determines which file tree to mount when attaching to file servers that +export multiple trees +.TP +-c CACHE +turns on caching using CACHE mode. Currently only +.I loose +cache mode is available, which is suitable for exclusive read-only mounts. +.TP +-d DEBUG +comma seperated list of channels for which to enable debug output. Possible +channels include: err, devel, 9p, vfs, conv, mux, trans, alloc, fcall. +.TP +-m MSIZE +specifies the maximum length of a single 9p message in bytes. +.PP +.B 9bind +performs a bind mount, making the tree visible at directory OLD also visible +at mount point NEW. +.PP +.B 9umount +unmounts a 9p filesystem previously mounted by you. +.SH ENVIRONMENT +.TP +$USER +the uname to provide to the server. +.SH EXAMPLES +.TP +9mount -i 'unix!/tmp/ns.'$USER'.:0/factotum' $HOME/n/factotum +mount p9p's factotum interface +.TP +9mount 'tcp!sources.cs.bell-labs.com' $HOME/n/sources +import plan 9's "sources" +.TP +9mount -u -a/home/sqweek/mail 'tcp!wren!5640' $HOME/mail +import my maildir from my server(wren), being served by ufs +.TP +9mount -i 'tcp!wren' $HOME/n/wren; 9bind $HOME/n/wren/home/sqweek/mail $HOME/mail +again importing my maildir, this time serving via u9fs +.SH BUGS +.B 9mount +truncates user names and SPECs to 249 characters. +.B 9umount +doesn't know this, so you won't be able to unmount anything +outside your home directory. But you probably never bother +logging out if your user name is that long. +.PP +.B 9mount +doesn't update /etc/mtab. +.PP +.B 9bind +only does a "shallow", non-recursive bind - any mounted filesystems +under the OLD tree will not appear mounted in the NEW tree. +.PP +If you +.B 9bind +a non-9p filesystem outside your home directory, +.B 9umount +won't let you unmount it. +.SH AUTHOR +sqweek@gmail.com +.SH SEE ALSO +.BR mount (1) |