Charles.Forsyth20060303-partialeea662d19 years agoHistory
181 lines · 3.4 KB · Text
RawDownload
.TH MKFS 8.SH NAMEmkfs, mkext \- archive or update a file system.SH SYNOPSIS.B disk/mkfs.RB [ -aprvx ].RB [ -n.IR name ].RB [ -s.IR source ].RB [ -u.IR users ].RB [ -z.IR n ].I proto ....PP.B disk/mkext.RB [ -d.IR name ].RB [ -u ].RB [ -h ].RB [ -v ].I file ....SH DESCRIPTION.I Mkfscopies files from the file tree.I source(default.BR / )to a.B kfsfile system (see.IR kfs (4)).The kfs service is mounted on.BR /n/kfs ,and.BR /adm/users ,if it exists, is copied to.BR /n/kfs/adm/users .The.I protofiles are read,and any files specified in them that are out of date are copied to.BR /n/kfs .See.IR proto (6)for the description of file system prototype files..PP.I Mkfscopies only those files that are out of date.Such a file is first copied into a temporaryfile in the appropriate destination directoryand then moved to the destination file.Files in the.I kfsfile system that are not specified in the.I protofileare not updated and not removed..PPThe options to.I mkfsare:.TF "s source".TP.B aInstead of writing to a.B kfsfile system, write an archive file to standard output, suitable for.IR mkext .All files in.IR proto ,not just those out of date, are archived..TP.B xFor use with.BR -a ,this option writes a list of file names, dates, and sizes to standard outputrather than producing an archive file..TP.BI "n " nameUse.RI kfs. nameas the name of the kfs service (default.BR kfs )..TP.B pUpdate the permissions of a file even if it is up to date..TP.B rCopy all files..TP.BI "s " sourceCopy from files rooted at the tree.IR source ..TP.BI "u " usersCopy file.I usersinto.B /adm/usersin the new system..TP.B vPrint the names of all of the files as they are copied..TP.BI "z " nCopy files assuming kfs block.I n(default 1024)bytes long.If a block contains only 0-valued bytes, it is not copied..PD.PP.I Mkextunpacks archive files made by the.B -aoption of.IR mkfs .The.B -doption specifies a directory (default.BR /n/kfs )to serve as the root of the unpacked file system.The.B -uoption, to be used only when initializing a new.IR kfs (4)file system, sets the owners of the files created to correspond tothose in the archive and restores the modification times of the files.(This is only permitted at the initial load of the files into a filesystem.)Each file on the command line is unpacked in one pass through the archive.If the 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 itdoes not exist.If no files are specified, the entire archive is unpacked;in this case, missing intermediate directories are not created.The.B -voption prints the names and sizes of files as they are extracted;.B -hprints headers for the files on standard outputinstead of unpacking the files..SH EXAMPLES.PPMake an archive to establish a new file system(assuming that the output file.B archis not referenced by.BR proto ):.IP.EXbind '#U' /n/localdisk/mkfs -a -u files/adm.users -s /n/local proto > arch.EE.PPUnpack that archive on another machine:.IP.EXmount tcp!server /n/remotedisk/mkext -u -d /n/remote < arch.EE.SH FILES.TF /lib/proto/portproto.TP.B /lib/protodirectory of prototype files..TP.B /lib/proto/portprotogeneric prototype file..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)