NAMESPACE(6)                                         NAMESPACE(6)

     NAME
          namespace - name space description file

     DESCRIPTION
          Namespace files describe how to construct a name space from
          scratch, or add to an existing name space.  The files are
          interpreted by newns(2), invoked by commands such as
          logon(1) and by other system services.

          The name space description file contains one or more lines
          each of which specifies one name space operation.  Empty
          lines and lines with # as the first non-space character are
          ignored.  Environment variables of the form $name are
          expanded within arguments, where name is a string terminated
          by white space, or one of the characters `/', `.', or `$'.

          The known operations and their arguments are:

          bind [-abci] old new
               Use new as an alias for file or directory old. Options
               a, b and c translate to flag values Sys->MAFTER,
               Sys->MBEFORE and Sys->MCREATE of sys-bind(2). If nei-
               ther a nor b are given, the default is Sys->MREPL.
               Option i means to ignore errors.

          cd directory
               Change working directory to directory.

          fork Split the name space before modification.  This is
               equivalent to passing a value of Sys->FORKNS to sys-
               pctl(2).

     [spec]
          mount [-abc9i] [-k keyfile] [-C alg] [net!]machine[!svc] dir
               Mount the file tree of machine upon directory dir. The
               default service is styx.  Options a, b, c and i are the
               same as for bind.  The tokens dir and spec translate to
               old and aname of mount as described under sys-bind(2).
               The -k, -C and -9 options are the same as those for the
               mount command (see bind(1)).

          import [-abc9i] [net!]machine[!svc] [remotedir] dir
               Import a directory from a remote Plan 9 machine and
               make it appear on directory dir. Options a, b, c and i
               are the same as for mount.  By default, remotedir is
               assumed to be the same name as dir. The default service
               is exportfs.  (Currently this operation works only
               under native Inferno and Plan 9.)

          new  Create a new name space in which the current directory

     Page 1                       Plan 9            (printed 11/18/24)

     NAMESPACE(6)                                         NAMESPACE(6)

               becomes the root directory; typically used after cd.
               This is equivalent to passing a value of Sys->NEWNS to
               sys-pctl(2).

          nodev
               Disallow device attaches.  This is equivalent to pass-
               ing a value of Sys->NODEVS to sys-pctl(2).

          unmount [-i] [name] from
               If two arguments are given, undo a bind or mount with
               the same arguments.  If only one argument is given,
               everything bound to or mounted on from is unmounted.
               The -i option means ignore errors.

          . path
               Include the name space description file path.

     SEE ALSO
          nsbuild(1), wm(1), newns(2)

     Page 2                       Plan 9            (printed 11/18/24)