Man Linux: Main Page and Category List

NAME

       9mount, 9bind, 9umount - mount/unmount 9p filesystems

SYNOPSIS

       9mount  [  insuvx  ] [ -a SPEC ] [ -c CACHE ] [ -d DEBUG ] [ -m MSIZE ]
       DIAL MOUNTPT

       9bind OLD NEW

       9umount MOUNTPT

DESCRIPTION

       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:

       unix!SOCKET
       tcp!HOST[!PORT]
       virtio!CHANNEL
       -

       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.  9mount has several options:

       -i     mount the file system with your uid/gid

       -n     dry-run,  print mount command to stderr but don’t actually mount
              anything

       -s     single attach mode - all users accessing the mount point see the
              same filesystem (by default they’ll each see a unique attach)

       -u     use the 9P2000.u extensions

       -v     use device mapping

       -x     exclusive access - other users cannot access the mount point

       -a SPEC
              SPEC  determines which file tree to mount when attaching to file
              servers that export multiple trees

       -c CACHE
              turns on caching using CACHE mode. Currently  only  loose  cache
              mode  is  available,  which  is suitable for exclusive read-only
              mounts.

       -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.

       -m MSIZE
              specifies the maximum length of a single 9p message in bytes.

       9bind performs a bind mount, making the tree visible at  directory  OLD
       also visible at mount point NEW.

       9umount unmounts a 9p filesystem previously mounted by you.

ENVIRONMENT

       $USER  the uname to provide to the server.

EXAMPLES

       9mount -i ’unix!/tmp/ns.’$USER’.:0/factotum’ $HOME/n/factotum
              mount p9p’s factotum interface

       9mount ’tcp!sources.cs.bell-labs.com’ $HOME/n/sources
              import plan 9’s "sources"

       9mount -u -a/home/sqweek/mail ’tcp!wren!5640’ $HOME/mail
              import my maildir from my server(wren), being served by ufs

       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

BUGS

       9mount  truncates  user  names  and  SPECs  to 249 characters.  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.

       9mount doesn’t update /etc/mtab.

       9bind  only  does  a  "shallow",  non-recursive  bind  -  any   mounted
       filesystems under the OLD tree will not appear mounted in the NEW tree.

       If you 9bind a non-9p filesystem outside your home  directory,  9umount
       won’t let you unmount it.

AUTHOR

       sqweek@gmail.com

SEE ALSO

       mount(1)