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 the Newns module of newns(2), invoked by com-
          mands such as wm(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.

          The known operations and their arguments are:

          bind [-abrci] old new
               Use new as an alias for file or directory old. Options
               a, b, c, and r translate to flag values Sys->MAFTER,
               Sys->MBEFORE, Sys->MCREATE and Sys->MREPL respectively,
               of sys-bind(2). 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).

          mount [-abrci] [-k keyfile] [-
               C alg] [net!]machine dir [spec]
               Mount the file tree of machine upon directory dir.
               Options a, b, c, i, and r 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 and -C
               options are the same as those for the mount command
               (see bind(1)).

          new  Create a new name space in which the current directory
               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,

     Page 1                       Plan 9            (printed 12/30/24)

     NAMESPACE(6)                                         NAMESPACE(6)

               everything bound to or mounted on from is unmounted.
               The -i option means ignore errors.

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

     Page 2                       Plan 9            (printed 12/30/24)