1 .TH MKFS 8
2 .SH NAME
3 mkfs, mkext \- archive or update a file system
4 .SH SYNOPSIS
5 .B disk/mkfs
6 .RB [ -aprvxU ]
7 .RB [ -d
8 .IR root ]
9 .RB [ -n
10 .IR name ]
11 .RB [ -s
12 .IR source ]
13 .RB [ -u
14 .IR users ]
15 .RB [ -z
16 .IR n ]
17 .I proto ...
18 .PP
19 .B disk/mkext
20 .RB [ -d
21 .IR name ]
22 .RB [ -u ]
23 .RB [ -h ]
24 .RB [ -v ]
25 .RB [ -x ]
26 .RB [ -T ]
27 .I file ...
28 .SH DESCRIPTION
29 .I Mkfs
30 copies files from the file tree
31 .I source
32 (default
33 .BR / )
34 to a
35 .B kfs
36 file system (see
37 .MR kfs (4) ).
38 The kfs service is mounted on
39 .I root
40 (default
41 .BR /n/kfs ),
42 and
43 .B /adm/users
44 is copied to
45 .IB root /adm/users\f1.
46 The
47 .I proto
48 files are read
49 (see
50 .MR proto (2)
51 for their format)
52 and any files specified in them that are out of date are copied to
53 .BR /n/kfs .
54 .PP
55 .I Mkfs
56 copies only those files that are out of date.
57 Such a file is first copied into a temporary
58 file in the appropriate destination directory
59 and then moved to the destination file.
60 Files in the
61 .I kfs
62 file system that are not specified in the
63 .I proto
64 file
65 are not updated and not removed.
66 .PP
67 The options to
68 .I mkfs
69 are:
70 .TF "s source"
71 .TP
72 .B a
73 Instead of writing to a
74 .B kfs
75 file system, write an archive file to standard output, suitable for
76 .IR mkext .
77 All files in
78 .IR proto ,
79 not just those out of date, are archived.
80 .TP
81 .B x
82 For use with
83 .BR -a ,
84 this option writes a list of file names, dates, and sizes to standard output
85 rather than producing an archive file.
86 .TP
87 .BI "d " root
88 Copy files into the tree rooted at
89 .I root 
90 (default
91 .BR /n/kfs ).
92 This option suppresses setting the
93 .B uid
94 and
95 .B gid
96 fields when copying files.
97 Use
98 .B -U
99 to reenable it. 
100 .TP
101 .BI "n " name
102 Use
103 .RI kfs. name
104 as the name of the kfs service (default
105 .BR kfs ).
106 .TP
107 .B p
108 Update the permissions of a file even if it is up to date.
109 .TP
110 .B r
111 Copy all files.
112 .TP
113 .BI "s " source
114 Copy from files rooted at the tree
115 .IR source .
116 .TP
117 .BI "u " users
118 Copy file
119 .I users
120 into
121 .B /adm/users
122 in the new system.
123 .TP
124 .B v
125 Print the names of all of the files as they are copied.
126 .TP
127 .BI "z " n
128 Copy files assuming kfs block
129 .I n
130 (default 1024)
131 bytes long.
132 If a block contains only 0-valued bytes, it is not copied.
133 .PD
134 .PP
135 .I Mkext
136 unpacks archive files made by the
137 .B -a
138 option of
139 .IR mkfs .
140 Each file on the command line is unpacked in one pass through the archive.
141 If the file is a directory,
142 all files and subdirectories of that directory are also unpacked.
143 When a file is unpacked, the entire path is created if it
144 does not exist.
145 If no files are specified, the entire archive is unpacked;
146 in this case, missing intermediate directories are not created.
147 The options are:
148 .TP
149 .B d
150 specifies a directory (default
151 .BR / )
152 to serve as the root of the unpacked file system.
153 .TP
154 .B u
155 sets the owners of the files created to correspond to
156 those in the archive and restores the modification times of the files.
157 .TP
158 .B T
159 restores only the modification times of the files.
160 .TP
161 .B v
162 prints the names and sizes of files as they are extracted.
163 .TP
164 .B h
165 prints headers for the files on standard output
166 instead of unpacking the files.
167 .PD
168 .SH EXAMPLES
169 .PP
170 Make an archive to establish a new file system:
171 .IP
172 .EX
173 disk/mkfs -a -u files/adm.users -s dist proto > arch
174 .EE
175 .PP
176 Unpack that archive onto a new file system:
177 .IP
178 .EX
179 disk/mkext -u -d /n/newfs < arch
180 .EE
181 .SH SOURCE
182 .B \*9/src/cmd/disk/mkfs.c
183 .br
184 .B \*9/src/cmd/disk/mkext.c
185 .SH "SEE ALSO"
186 .MR prep (8) ,
187 .MR tar (1)