shithub: plan9front

ref: 85ffa283f67b4bd139a4e28e82f0d1c7f6c53b3b
dir: /sys/man/6/namespace/

.TH NAMESPACE 6
.SH NAME
namespace \- name space description file
.SH DESCRIPTION
Namespace files describe how to construct a name space from scratch,
an operation normally performed by the
.I newns
or
.I addns
subroutines
(see
.IR auth (2))
which is typically called by
.IR init (8).
Each line specifies one name space operation.
Spaces and tabs separate arguments to operations.
Blank 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
.SM UTF
string terminated by white space, a
.BR / ,
or a
.BR $ .
.PP
The known operations and their arguments are:
.TF 0
.TP
.BR mount \ [ -abcC ]\ \fIservename\  old " \fR[\fIspec\fR\^\^]
Mount
.I servename
on
.IR old .
.TP
.BR bind \ [ -abcC "]  \fInew old
Bind
.I new
on
.IR old .
.TP
.BI cd \ dir
Change the working directory to
.IR dir .
.TP
.BR unmount \ [ \fInew\fR ]\ \fIold
Unmount
.I new
from
.IR old ,
or everything mounted on
.I old
if
.I new
is missing.
.TP
.BR clear
Clear the name space with
.BR rfork(RFCNAMEG) .
.TP
.BI . \ path
Execute the namespace file 
.IR path .
Note that
.I path
must be present in the name space being built.
.PD
.PP
The options for
.I bind
and
.I mount
are interpreted as in
.IR bind (1).
.SH "SEE ALSO"
.IR bind (1),
.IR namespace (4),
.IR init (8)