ref: 76b565d8b219c8db94a882e93725b4ab735414de
dir: /man/8/mkfs/
.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)