3 d2173bb5 2012-07-17 rsc mkfs, mkext \- archive or update a file system
6 d2173bb5 2012-07-17 rsc .RB [ -aprvxU ]
19 d2173bb5 2012-07-17 rsc .B disk/mkext
28 d2173bb5 2012-07-17 rsc .SH DESCRIPTION
30 d2173bb5 2012-07-17 rsc copies files from the file tree
36 d2173bb5 2012-07-17 rsc file system (see
37 d2173bb5 2012-07-17 rsc .IR kfs (4)).
38 d2173bb5 2012-07-17 rsc The kfs service is mounted on
41 d2173bb5 2012-07-17 rsc .BR /n/kfs ),
43 d2173bb5 2012-07-17 rsc .B /adm/users
45 d2173bb5 2012-07-17 rsc .IB root /adm/users\f1.
48 d2173bb5 2012-07-17 rsc files are read
50 d2173bb5 2012-07-17 rsc .IR proto (2)
51 d2173bb5 2012-07-17 rsc for their format)
52 d2173bb5 2012-07-17 rsc and any files specified in them that are out of date are copied to
56 d2173bb5 2012-07-17 rsc copies only those files that are out of date.
57 d2173bb5 2012-07-17 rsc Such a file is first copied into a temporary
58 d2173bb5 2012-07-17 rsc file in the appropriate destination directory
59 d2173bb5 2012-07-17 rsc and then moved to the destination file.
62 d2173bb5 2012-07-17 rsc file system that are not specified in the
65 d2173bb5 2012-07-17 rsc are not updated and not removed.
67 d2173bb5 2012-07-17 rsc The options to
70 d2173bb5 2012-07-17 rsc .TF "s source"
73 d2173bb5 2012-07-17 rsc Instead of writing to a
75 d2173bb5 2012-07-17 rsc file system, write an archive file to standard output, suitable for
79 d2173bb5 2012-07-17 rsc not just those out of date, are archived.
84 d2173bb5 2012-07-17 rsc this option writes a list of file names, dates, and sizes to standard output
85 d2173bb5 2012-07-17 rsc rather than producing an archive file.
87 d2173bb5 2012-07-17 rsc .BI "d " root
88 d2173bb5 2012-07-17 rsc Copy files into the tree rooted at
91 d2173bb5 2012-07-17 rsc .BR /n/kfs ).
92 d2173bb5 2012-07-17 rsc This option suppresses setting the
96 d2173bb5 2012-07-17 rsc fields when copying files.
99 d2173bb5 2012-07-17 rsc to reenable it.
101 d2173bb5 2012-07-17 rsc .BI "n " name
103 d2173bb5 2012-07-17 rsc .RI kfs. name
104 d2173bb5 2012-07-17 rsc as the name of the kfs service (default
108 d2173bb5 2012-07-17 rsc Update the permissions of a file even if it is up to date.
111 d2173bb5 2012-07-17 rsc Copy all files.
113 d2173bb5 2012-07-17 rsc .BI "s " source
114 d2173bb5 2012-07-17 rsc Copy from files rooted at the tree
115 d2173bb5 2012-07-17 rsc .IR source .
117 d2173bb5 2012-07-17 rsc .BI "u " users
121 d2173bb5 2012-07-17 rsc .B /adm/users
122 d2173bb5 2012-07-17 rsc in the new system.
125 d2173bb5 2012-07-17 rsc Print the names of all of the files as they are copied.
128 d2173bb5 2012-07-17 rsc Copy files assuming kfs block
130 d2173bb5 2012-07-17 rsc (default 1024)
132 d2173bb5 2012-07-17 rsc If a block contains only 0-valued bytes, it is not copied.
136 d2173bb5 2012-07-17 rsc unpacks archive files made by the
140 d2173bb5 2012-07-17 rsc Each file on the command line is unpacked in one pass through the archive.
141 d2173bb5 2012-07-17 rsc If the file is a directory,
142 d2173bb5 2012-07-17 rsc all files and subdirectories of that directory are also unpacked.
143 d2173bb5 2012-07-17 rsc When a file is unpacked, the entire path is created if it
144 d2173bb5 2012-07-17 rsc does not exist.
145 d2173bb5 2012-07-17 rsc If no files are specified, the entire archive is unpacked;
146 d2173bb5 2012-07-17 rsc in this case, missing intermediate directories are not created.
147 d2173bb5 2012-07-17 rsc The options are:
150 d2173bb5 2012-07-17 rsc specifies a directory (default
152 d2173bb5 2012-07-17 rsc to serve as the root of the unpacked file system.
155 d2173bb5 2012-07-17 rsc sets the owners of the files created to correspond to
156 d2173bb5 2012-07-17 rsc those in the archive and restores the modification times of the files.
159 d2173bb5 2012-07-17 rsc restores only the modification times of the files.
162 d2173bb5 2012-07-17 rsc prints the names and sizes of files as they are extracted.
165 d2173bb5 2012-07-17 rsc prints headers for the files on standard output
166 d2173bb5 2012-07-17 rsc instead of unpacking the files.
168 d2173bb5 2012-07-17 rsc .SH EXAMPLES
170 d2173bb5 2012-07-17 rsc Make an archive to establish a new file system:
173 d2173bb5 2012-07-17 rsc disk/mkfs -a -u files/adm.users -s dist proto > arch
176 d2173bb5 2012-07-17 rsc Unpack that archive onto a new file system:
179 d2173bb5 2012-07-17 rsc disk/mkext -u -d /n/newfs < arch
182 d2173bb5 2012-07-17 rsc .B \*9/src/cmd/disk/mkfs.c
184 d2173bb5 2012-07-17 rsc .B \*9/src/cmd/disk/mkext.c
185 d2173bb5 2012-07-17 rsc .SH "SEE ALSO"
186 d2173bb5 2012-07-17 rsc .IR prep (8),