]> git.lizzy.rs Git - plan9front.git/blob - sys/man/6/namespace
merge
[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 .BR import \ [ -abc ]\ \fIhost\fR\ "[\fIremotepath\fR\^\^] \fImountpoint\fR
49 Import
50 .I remotepath
51 from machine
52 .I server
53 and attach it to
54 .IR mountpoint .
55 .TP
56 .BI cd \ dir
57 Change the working directory to
58 .IR dir .
59 .TP
60 .BR unmount \ [ \fInew\fR ]\ \fIold
61 Unmount
62 .I new
63 from
64 .IR old ,
65 or everything mounted on
66 .I old
67 if
68 .I new
69 is missing.
70 .TP
71 .BR clear
72 Clear the name space with
73 .BR rfork(RFCNAMEG) .
74 .TP
75 .BI . \ path
76 Execute the namespace file 
77 .IR path .
78 Note that
79 .I path
80 must be present in the name space being built.
81 .PD
82 .PP
83 The options for
84 .IR bind ,
85 .IR mount ,
86 and
87 .I import
88 are interpreted as in
89 .IR bind (1)
90 and
91 .IR import (4).
92 .SH "SEE ALSO"
93 .IR bind (1),
94 .IR namespace (4),
95 .IR init (8)