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