]> git.lizzy.rs Git - plan9front.git/blob - sys/man/6/namespace
games/mix: document -g option, rename tests to examples as it is in the man page
[plan9front.git] / sys / man / 6 / namespace
1 .TH NAMESPACE 6
2 .SH NAME
3 namespace \- name space description file
4 .SH DESCRIPTION
5 Namespace files describe how to construct a name space from scratch,
6 an operation normally performed by the
7 .I newns
8 or
9 .I addns
10 subroutines
11 (see
12 .IR auth (2))
13 which is typically called by
14 .IR init (8).
15 Each line specifies one name space operation.
16 Spaces and tabs separate arguments to operations;
17 no quotes or escapes are recognized.
18 Blank lines and lines with
19 .B #
20 as the first non-space character are ignored.
21 Environment variables of the form
22 .BI $ name
23 are expanded within arguments,
24 where
25 .I name
26 is a
27 .SM UTF
28 string terminated by white space, a
29 .BR / ,
30 or a
31 .BR $ .
32 .PP
33 The known operations and their arguments are:
34 .TF 0
35 .TP
36 .BR mount \ [ -abcC ]\ \fIservename\  old " \fR[\fIspec\fR\^\^]
37 Mount
38 .I servename
39 on
40 .IR old .
41 .TP
42 .BR bind \ [ -abcC "]  \fInew old
43 Bind
44 .I new
45 on
46 .IR old .
47 .TP
48 .BI cd \ dir
49 Change the working directory to
50 .IR dir .
51 .TP
52 .BR unmount \ [ \fInew\fR ]\ \fIold
53 Unmount
54 .I new
55 from
56 .IR old ,
57 or everything mounted on
58 .I old
59 if
60 .I new
61 is missing.
62 .TP
63 .BR clear
64 Clear the name space with
65 .BR rfork(RFCNAMEG) .
66 .TP
67 .BI . \ path
68 Execute the namespace file 
69 .IR path .
70 Note that
71 .I path
72 must be present in the name space being built.
73 .PD
74 .PP
75 The options for
76 .I bind
77 and
78 .I mount
79 are interpreted as in
80 .IR bind (1).
81 .SH "SEE ALSO"
82 .IR bind (1),
83 .IR namespace (4),
84 .IR init (8)