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 commands such as wm-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. 

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] [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).

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

SEE ALSO

nsbuild(1), wm-logon(1), newns(2)

Plan 9  —  May 17, 2000