.TH NAMESPACE 6.SH NAMEnamespace \- name space description file.SH DESCRIPTIONNamespace files describe how to construct a name space from scratch,or add to an existing name space.The files are interpreted by.IR newns (2),invoked by commands such as.IR logon (1)and by other system services..PPThe name space description file contains one or morelines each of which specifies one name space operation.Empty lines and lines with.B #as the first non-space character are ignored.Environment variables of the form.BI $ nameare expanded within arguments, where.I nameis a string terminated by white space, or one of the characters.LR / ,.LR . ,or.LR $ ..PPThe known operations and their arguments are:.TP.B "bind [-abci] \f2old\fP \f2new\fP"Use .I newas an alias for file or directory.IR old .Options.BR a ,.BR band.BR ctranslate to flag values.BR Sys\->MAFTER ,.B Sys\->MBEFOREand.B Sys\->MCREATEof.IR sys-bind (2).If neither.B anor.B bare given, the default is.BR Sys\->MREPL .Option.B imeans to ignore errors..TP.B cd \f2directory\fPChange working directory to.IR directory ..TP.B forkSplit the name space before modification.This is equivalent to passing a value of.B Sys->FORKNSto.IR sys-pctl (2)..TP.B "mount [-abc9i] [-k \f2keyfile\fP] [-C \f2alg\fP] [\f2net\fP!]\f2machine\fP[!\f2svc\fP] \f2dir\fP [\f2spec\fP]"Mount the file tree of.I machineupon directory.IR dir .The default service is.BR styx .Options.BR a ,.BR b ,.B cand. B iare the same as for.BR bind .The tokens.I dirand.I spectranslate to.I oldand.I anameof.B mountas described under.IR sys-bind (2).The.BR -k ,.B -Cand.B -9options are the same as those for the.I mountcommand (see.IR bind (1))..TP.B "import [-abc9i] [\f2net\fP!]\f2machine\fP[!\f2svc\fP] [\f2remotedir\fP] \f2dir\fP"Import a directory from a remote Plan 9.I machineand make it appear on directory.IR dir .Options.BR a ,.BR b ,.BR cand.B iare the same as for.BR mount .By default,.I remotediris assumed to be the same name as.IR dir .The default service is.BR exportfs .(Currently this operation works only under native Inferno and Plan 9.).TP.B newCreate a new name space in which the current directorybecomes the root directory;typically used after.BR cd .This is equivalent to passing a value of.B Sys->NEWNSto.IR sys-pctl (2)..TP.B nodevDisallow device attaches.This is equivalent to passing a value of.B Sys->NODEVSto.IR sys-pctl (2)..TP.B unmount [-i] [\f2name\fP] \f2from\fPIf two arguments are given, undo a.B bindor.B mountwith the same arguments.If only one argument is given, everything bound to or mounted on.I fromis unmounted.The.B -ioption means ignore errors..TP.BI "\&." " path"Include the name space description file.IR path ..SH SEE ALSO.IR nsbuild (1),.IR wm (1),.IR newns (2)
.TH NAMESPACE 6
.SH NAME
namespace \- name space description file
.SH DESCRIPTION
Namespace files describe how to construct a name space from scratch,
or add to an existing name space.
The files are interpreted by
.IR newns (2),
invoked by commands such as
.IR logon (1)
and by other system services.
.PP
The name space description file contains one or more
lines each of which specifies one name space operation.
Empty lines and lines with
.B #
as the first non-space character are ignored.
Environment variables of the form
.BI $ name
are expanded within arguments, where
.I name
is a string terminated by white space, or one of the characters
.LR / ,
.LR . ,
or
.LR $ .
.PP
The known operations and their arguments are:
.TP
.B "bind [-abci] \f2old\fP \f2new\fP"
Use
.I new
as an alias for file or directory
.IR old .
Options
.BR a ,
.BR b
and
.BR c
translate to flag values
.BR Sys\->MAFTER ,
.B Sys\->MBEFORE
and
.B Sys\->MCREATE
of
.IR sys-bind (2).
If neither
.B a
nor
.B b
are given, the default is
.BR Sys\->MREPL .
Option
.B i
means to ignore errors.
.TP
.B cd \f2directory\fP
Change working directory to
.IR directory .
.TP
.B fork
Split the name space before modification.
This is equivalent to passing a value of
.B Sys->FORKNS
to
.IR sys-pctl (2).
.TP
.B "mount [-abc9i] [-k \f2keyfile\fP] [-C \f2alg\fP] [\f2net\fP!]\f2machine\fP[!\f2svc\fP] \f2dir\fP [\f2spec\fP]"
Mount the file tree of
.I machine
upon directory
.IR dir .
The default service is
.BR styx .
Options
.BR a ,
.BR b ,
.B c
and
. B i
are the same as for
.BR bind .
The tokens
.I dir
and
.I spec
translate to
.I old
and
.I aname
of
.B mount
as described under
.IR sys-bind (2).
The
.BR -k ,
.B -C
and
.B -9
options are the same as those for the
.I mount
command (see
.IR bind (1)).
.TP
.B "import [-abc9i] [\f2net\fP!]\f2machine\fP[!\f2svc\fP] [\f2remotedir\fP] \f2dir\fP"
Import a directory from a remote Plan 9
.I machine
and make it appear on directory
.IR dir .
Options
.BR a ,
.BR b ,
.BR c
and
.B i
are the same as for
.BR mount .
By default,
.I remotedir
is assumed to be the same name as
.IR dir .
The default service is
.BR exportfs .
(Currently this operation works only under native Inferno and Plan 9.)
.TP
.B new
Create a new name space in which the current directory
becomes the root directory;
typically used after
.BR cd .
This is equivalent to passing a value of
.B Sys->NEWNS
to
.IR sys-pctl (2).
.TP
.B nodev
Disallow device attaches.
This is equivalent to passing a value of
.B Sys->NODEVS
to
.IR sys-pctl (2).
.TP
.B unmount [-i] [\f2name\fP] \f2from\fP
If two arguments are given, undo a
.B bind
or
.B mount
with the same arguments.
If only one argument is given, everything bound to or mounted on
.I from
is unmounted.
The
.B -i
option means ignore errors.
.TP
.BI "\&." " path"
Include the name space description file
.IR path .
.SH SEE ALSO
.IR nsbuild (1),
.IR wm (1),
.IR newns (2)