diff options
Diffstat (limited to 'static/inferno/man8/mkfs.8')
| -rw-r--r-- | static/inferno/man8/mkfs.8 | 223 |
1 files changed, 223 insertions, 0 deletions
diff --git a/static/inferno/man8/mkfs.8 b/static/inferno/man8/mkfs.8 new file mode 100644 index 00000000..77a6fb8e --- /dev/null +++ b/static/inferno/man8/mkfs.8 @@ -0,0 +1,223 @@ +.TH MKFS 8 +.SH NAME +mkfs, mkext \- archive or update a file system +.SH SYNOPSIS +.B disk/mkfs +.RB [ -aprvxS ] +.RB [ -d +.IR dest ] +.RB [ -n +.IR name ] +.RB [ -s +.IR source ] +.RB [ -u +.IR users ] +.RB [ -z +.IR n ] +.RB [ -G +.IR group ] +.RB [ -U +.IR user ] +.I proto ... +.PP +.B disk/mkext +.RB [ -d +.IR name ] +.RB [ -f ] +.RB [ -h ] +.RB [ -T ] +.RB [ -u ] +.RB [ -v ] +[ +.I file ... +] +.SH DESCRIPTION +.I Mkfs +copies files from the file tree +.I source +(default +.BR / ) +to a +.B kfs +file system (see +.IR kfs (4)) +assumed to be mounted on +.I dest +(default: +.BR /n/kfs ). +The +.I proto +files are read, +and any files specified in them that are out of date are copied to +.IR dest . +See +.IR proto (6) +for the description of file system prototype files. +.PP +.I Mkfs +by default copies only those files that are out of date. +Such a file is first copied into a temporary +file in the appropriate destination directory +and then moved to the destination file. +Files in the +.I kfs +file system that are not specified in the +.I proto +file +are not updated and not removed. +.PP +The options to +.I mkfs +are: +.TF "-s source" +.TP +.B -a +Instead of writing to a +.B kfs +file system, write an archive file to standard output, suitable for +.IR mkext . +All files in +.I proto +are archived, +not just those out of date. +.TP +.B -x +For use with +.BR -a , +this option writes a list of file names, dates, and sizes to standard output +rather than producing an archive file. +.TP +.BI -n " name" +Use +.BI kfs. name .cmd +as the name of the command file for the +.IR kfs (4) +assumed to be mounted on +.IR dest . +.TP +.B -p +Update the permissions of a file even if it is up to date. +.TP +.B -r +Copy all files. +.TP +.BI -s " source" +Copy from files rooted at the tree +.IR source . +.TP +.BI -u " users" +Before copying any other file, copy file +.I users +into +.IB dest /adm/users , +and if the +.B -n +option was given, also issue the +.IR kfs (4) +command +.B users +to update +.IR kfs 's +own user list. +.TP +.B -v +Print the names of all of the files as they are copied. +.TP +.BI -z " n" +Copy files assuming +.I kfs +is using a block size of +.I n +bytes +(default 1024). +If a block contains only 0-valued bytes, it is not copied. +.TP +.B -S +For use with the +.B -d +option, +make owner and group of each file copied match the original. +.TP +.BI -G " group" +Force all files copied to have the given +.IR group . +.TP +.BI -U " user" +Force all files copied to be owned by the given +.IR user . +.PD +.PP +.I Mkext +unpacks an archive created by the +.B -a +option of +.IR mkfs , +read from the standard input. +If one or more files are specified on the command line, +only those files are unpacked. +If a +.I file +is a directory, +all files and subdirectories of that directory are also unpacked. +When a file is unpacked, the entire path is created if it +does not exist. +If no files are specified, the entire archive is unpacked; +in this case, missing intermediate directories are not created. +The options are: +.TP +.BI -d " dir" +Treat +.I dir +(default +.LR / ) +as the root directory when unpacking the archive. +.TP +.B -h +Print headers for the files on standard output +instead of unpacking the files. +.TP +.B -T +Restore the modification times of the files. +.TP +.B -u +Set the owners of the files created to correspond to +those in the archive and restore the modification times of the files. +.TP +.B -v +Print the names and sizes of files as they are extracted. +.SH EXAMPLES +.PP +Make an archive to establish a new file system +(assuming that the output file +.B arch +is not referenced by +.BR proto ): +.IP +.EX +bind '#U' /n/local +disk/mkfs -a -s /n/local proto > arch +.EE +.PP +Unpack that archive on another machine: +.IP +.EX +mount tcp!server /n/remote +disk/mkext -u -d /n/remote < arch +.EE +.SH FILES +.TF /lib/proto/portproto +.TP +.B /lib/proto +directory of prototype files. +.TP +.B /lib/proto/all +contains a single + (archive any directory structure) +.SH SOURCE +.B /appl/cmd/disk/mkfs.b +.br +.B /appl/cmd/disk/mkext.b +.SH "SEE ALSO" +.IR fs (1), +.IR kfs (4), +.IR proto (6), +.IR kfscmd (8) |