shithub: riscv

ref: 4bcde1a30b3d22c959d27887cf20fe8bb72ed02c
dir: /sys/man/6/namespace/

View raw version
.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;
no quotes or escapes are recognized.
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)