.TH FS 8.SH NAMEfs \- file server maintenance.SH SYNOPSIS.PD 0.B help[.I command ...].PP.B arp.I subcommand.PP.B cfs.I filesystem.PP.B check.RI [ options ].PP.B clean.I file[.I bno[.I addr] ].PP.B clri.RI [ file ...].PP.B cpu.RI [ proc ].PP.B create.I path uid gid perm.RB [ lad ].PP.B cwcmd.I subcommand.PP.B date.RB [[ +- ].IR seconds ].PP.B duallow.RI [ uid ].PP.B dump[.I filesystem].PP.B dumpctl.RB [ 01 ].PP.B files.PP.B flag.I flag[.I channel].PP.B fstat[.I files].PP.B halt.PP.B hangup.I channel.PP.B newuser.I name.RI [ options ].PP.B noattach.PP.B passwd.PP.B printconf.PP.B profile.RB [ 01 ].PP.B remove.RI [ files ...].PP.B route.I subcommand.PP.B "sntp kick".PP.BR stat [ admieswqr ].PP.B stats.RB [[ - ].IR flags ...].PP.B sync.PP.B time.I command.PP.B trace.RI [ number ].PP.B users.RI [ file ].PP.B version.PP.B who.RI [ user ...].SH DESCRIPTIONThese commands are available only on the console of an.IR fs (4)file server..PP.I Helpprints a `usage string' for the named.IR commands ,by default all commands.Also, many commands print menus of their options if givenincorrect or incomplete parameters..PP.BR wstat .This may help in initializing a file system.Use this with caution..PP.I Arphas two.IR subcommands :.B printprints the contents of the ARP cache and.B flushflushes it..PP.I Cfschanges the current file system, that is, the file tree to whichcommands.RB ( check ,.BR clean ,.BR clri ,.BR create ,.BR cwcmd ,.BR dump ,.BR newuser ,.BR profile ,.BR remove ,and.BR users )apply.The initial.I filesystemis.BR main ..PP.I Checkverifies the consistency of the current file system.With no options it checks and reports the status.It suspends service while running.Options are:.TF touch.PD.TP.B rdallRead every block in the file system (can take a.I longtime).Normally,.I checkwill stop short of the actual contentsof a file and just verify the block addresses..TP.B tagFix bad.IR tags ;each block has a tag that acts as a backwards pointer forconsistency checking..TP.B reamFix bad tagsand also clear the contentsof blocks that have bad tags..TP.B pfilePrint every file name..TP.B pdirPrint every directory name..TP.B freeRebuild the list of free blockswith all blocks that are not referenced.This option is only useful on non-cache/WORMfile systems.If the filesystem was modified, the summary printedat the conclusion of the check may not reflect the truestate of the freelist and may also print a list of.I missingblocks.These.I missingblocks are actually on the free list and the truestate of the filesystem can be determined by running.I checkwith no arguments..TP.B badEach block address that is out of range or duplicate is cleared.Note that only the second and subsequentuse of a block is cleared.Often the problems in a file system arecaused by one bad file that has a lot ofgarbage block addresses.In such a case,it is wiser to use.I checkto find the bad file(by number of diagnostic messages)and then use.I clrito clear the addresses in that file.After that,.I checkcan be used to reclaim the free list..TP.B touchCause every directory and indirect block not on the current WORM diskto be advanced to the current WORM on the next dump.This is a discredited idea to try to keep operatingon the knee of the cache working set.Buy more cache disk..TP.B trimreduces the file system's.I fsizeto fit the device containing the file system.This is useful after copying a partially-full file systeminto a slightly smaller device.Running.B "check free"afterward will construct a new free list that contains noblocks outside the new, smaller file system..PP.I Cleanprints the block numbers in.IR file 'sdirectory entry (direct, indirect and doubly indirect)and checks the tags of the blocks cited.If.I bnois supplied, the.IR bno 'thblock number (using zero origin)is set to.I addr(defaults to zero).Note that only the block numbers in the directory entry itselfare examined;.I cleandoes not recur through indirect blocks..PP.I Clriclears the internal directory entry and abandons storageassociated with.IR files .It ignores the usual rules for sanity, such as checking againstremoving a non-empty directory.A subsequent.B check.B freewill place the abandoned storage in the free list..PP.I Cpuprints the CPU utilization and state of the processes in the file server.If the name of a process type argument is given,then CPU utilization for only those processes is printed..PP.I Createcreates a file on the current file system..I Uidand.I gidare names or numbers from.BR /adm/users ..I Permis the low 9 bits of the permission mode of the file, in octal.An optional final.BR l ,.BR a ,or.BR dcreates a locked file, append-only file, or directory..PP.I Cwcmdcontrols the cached WORM file systems,specifically the current file system.The subcommands are:.TP.BI mvstate " state1 state2 " [ platter ]States are.BR none ,.BR dirty ,.BR dump ,.BR dump1 ,.BR error ,.BR read ,and.BR write .A.B mvstate.B dump1.B dumpwill cause I/O errors in the last dump to be retried.A.B mvstate.B dump1.B writewill cause I/O errors in the last dump to be retried inreallocated slots in the next dump.A.B mvstate.B read.B nonewill flush the cache associated with the WORM.A.B mvstate.B dump.B writeaborts the background process dumping to WORM; as a consequence itleaves holes in the dump file system.Other uses are possible but arcane.The optional.I platterlimits affected blocks to those on that platter..TP.BR prchain " [\fIstart\fP] [\fIback-flag\fP]Print the chain of superblocks for the directory containing theroots of the dumped file systems, starting at block number.I start(default 0) going forward (backwards if.I back-flagis supplied and is non-zero)..TP.BR searchtag " [\fIstart\fP] [\fItag\fP] [\fIblocks\fP]Reads the WORM device starting at block.I startand proceeding for.I blocksblocks (default 1000)until it finds a block with numeric tag.IR tag ..TP.BR savecache " [\fIpercent\fP]Copy the block numbers, in native endian longwords, of blocks in the.B readstate to the file.BR /adm/cachefor use by.BR disk/exsort .If an argument is given,then that percent (most recently used) of each cache bucketis copied..TP.BR loadcache " [\fIdskno\fP]Read.B /adm/cacheand for every block there on WORM disk side.I dskno(zero-origin),read the block from WORM to the cache.If.I dsknois not supplied, all blocks in.B /adm/cacheare read..TP.BR morecache " dskno [\fIcount\fP]Read.I countblocks from the beginning of WORM disk side.I dsknoto the cache.If no count is given,read all of side.IR dsknointo the cache..TP.BR startdump \ [ 01 ]Suspend.RB ( 0 )or restart.RB ( 1 )the background dump process..TP.B touchsbVerify that the superblock on the WORM is readable, ignoring the cached copy..TP.BR blockcmp " [\fIwbno\fP] [\fIcbno\fP]Compares the WORM block.I wbnowith the cache block.I cbnoand prints the first 10 differences, if any..TP.B acctPrints how many times each user has caused the system to allocate new space on the WORM;the units are megabytes..TP.B clearacctClears the accounting records for.BR acct ..PP.I Dateprints the current date. It may be adjustedusing.BI +- seconds\f1.With no sign, it sets the date to the absolute number of secondssince 00:00 Jan 1, 1970 GMT; with a sign it trims the currenttime..PP.I Duallowsets permissions such thatthe named.I usercan read and search any directories.This is the permission necessary to do a.IR du (1)command anywhere in the file system to discover disk usage..PP.I Dumpstarts a dump to WORM immediately forthe named filesystem,or the current filesystem if none is named.File service is suspended while the cache is scanned;service resumes when the copy to WORM starts..PP.I Dumpctlprints the current state of automatic dumps.With an argument of ``on'' or ``off'' (0 or 1)automatic dumps are turned on or off..PP.I Filesprints for every connection the number of allocated fids..PP.I Fstatprints the current status of each named.IR file ,including uid, gid, wuid (uid of the last user to modify the file),size, qid, and disk addresses..PP.I Flagtoggles flags, initially all off:.TF authdisablexx.TP.B allchansPrint channels in.I whooutput..TP.B allowAllow arbitrary wstat changes..TP.B aoeVerbose AoE chat..TP.B aoerttVerbose AoE RTT adjustments..TP.B aoesnoopyPrint AoE packets..TP.B arpReport ARP activity..TP.B attachReport as connections are made to the file server..TP.B authdebugReport authentications..TP.B authdisableDisable authentication..TP.B chat(Very noisy.) Print all 9P messages to and from the server..TP.B errorReport 9P errors..TP.B ilReport IL errors..TP.B routeReport received RIP packets..TP.B roLines 1–500 of 782. Load more
.TH FS 8 .SH NAME fs \- file server maintenance .SH SYNOPSIS .PD 0 .B help [ .I command ... ] .PP .B arp .I subcommand .PP .B cfs .I filesystem .PP .B check .RI [ options ] .PP .B clean .I file [ .I bno [ .I addr ] ] .PP .B clri .RI [ file ...] .PP .B cpu .RI [ proc ] .PP .B create .I path uid gid perm .RB [ lad ] .PP .B cwcmd .I subcommand .PP .B date .RB [[ +- ] .IR seconds ] .PP .B duallow .RI [ uid ] .PP .B dump [ .I filesystem ] .PP .B dumpctl .RB [ 01 ] .PP .B files .PP .B flag .I flag [ .I channel ] .PP .B fstat [ .I files ] .PP .B halt .PP .B hangup .I channel .PP .B newuser .I name .RI [ options ] .PP .B noattach .PP .B passwd .PP .B printconf .PP .B profile .RB [ 01 ] .PP .B remove .RI [ files ...] .PP .B route .I subcommand .PP .B "sntp kick" .PP .BR stat [ admieswqr ] .PP .B stats .RB [[ - ] .IR flags ...] .PP .B sync .PP .B time .I command .PP .B trace .RI [ number ] .PP .B users .RI [ file ] .PP .B version .PP .B who .RI [ user ...] .SH DESCRIPTION These commands are available only on the console of an .IR fs (4) file server. .PP .I Help prints a `usage string' for the named .IR commands , by default all commands. Also, many commands print menus of their options if given incorrect or incomplete parameters. .PP .BR wstat . This may help in initializing a file system. Use this with caution. .PP .I Arp has two .IR subcommands : .B print prints the contents of the ARP cache and .B flush flushes it. .PP .I Cfs changes the current file system, that is, the file tree to which commands .RB ( check , .BR clean , .BR clri , .BR create , .BR cwcmd , .BR dump , .BR newuser , .BR profile , .BR remove , and .BR users ) apply. The initial .I filesystem is .BR main . .PP .I Check verifies the consistency of the current file system. With no options it checks and reports the status. It suspends service while running. Options are: .TF touch .PD .TP .B rdall Read every block in the file system (can take a .I long time). Normally, .I check will stop short of the actual contents of a file and just verify the block addresses. .TP .B tag Fix bad .IR tags ; each block has a tag that acts as a backwards pointer for consistency checking. .TP .B ream Fix bad tags and also clear the contents of blocks that have bad tags. .TP .B pfile Print every file name. .TP .B pdir Print every directory name. .TP .B free Rebuild the list of free blocks with all blocks that are not referenced. This option is only useful on non-cache/WORM file systems. If the filesystem was modified, the summary printed at the conclusion of the check may not reflect the true state of the freelist and may also print a list of .I missing blocks. These .I missing blocks are actually on the free list and the true state of the filesystem can be determined by running .I check with no arguments. .TP .B bad Each block address that is out of range or duplicate is cleared. Note that only the second and subsequent use of a block is cleared. Often the problems in a file system are caused by one bad file that has a lot of garbage block addresses. In such a case, it is wiser to use .I check to find the bad file (by number of diagnostic messages) and then use .I clri to clear the addresses in that file. After that, .I check can be used to reclaim the free list. .TP .B touch Cause every directory and indirect block not on the current WORM disk to be advanced to the current WORM on the next dump. This is a discredited idea to try to keep operating on the knee of the cache working set. Buy more cache disk. .TP .B trim reduces the file system's .I fsize to fit the device containing the file system. This is useful after copying a partially-full file system into a slightly smaller device. Running .B "check free" afterward will construct a new free list that contains no blocks outside the new, smaller file system. .PP .I Clean prints the block numbers in .IR file 's directory entry (direct, indirect and doubly indirect) and checks the tags of the blocks cited. If .I bno is supplied, the .IR bno 'th block number (using zero origin) is set to .I addr (defaults to zero). Note that only the block numbers in the directory entry itself are examined; .I clean does not recur through indirect blocks. .PP .I Clri clears the internal directory entry and abandons storage associated with .IR files . It ignores the usual rules for sanity, such as checking against removing a non-empty directory. A subsequent .B check .B free will place the abandoned storage in the free list. .PP .I Cpu prints the CPU utilization and state of the processes in the file server. If the name of a process type argument is given, then CPU utilization for only those processes is printed. .PP .I Create creates a file on the current file system. .I Uid and .I gid are names or numbers from .BR /adm/users . .I Perm is the low 9 bits of the permission mode of the file, in octal. An optional final .BR l , .BR a , or .BR d creates a locked file, append-only file, or directory. .PP .I Cwcmd controls the cached WORM file systems, specifically the current file system. The subcommands are: .TP .BI mvstate " state1 state2 " [ platter ] States are .BR none , .BR dirty , .BR dump , .BR dump1 , .BR error , .BR read , and .BR write . A .B mvstate .B dump1 .B dump will cause I/O errors in the last dump to be retried. A .B mvstate .B dump1 .B write will cause I/O errors in the last dump to be retried in reallocated slots in the next dump. A .B mvstate .B read .B none will flush the cache associated with the WORM. A .B mvstate .B dump .B write aborts the background process dumping to WORM; as a consequence it leaves holes in the dump file system. Other uses are possible but arcane. The optional .I platter limits affected blocks to those on that platter. .TP .BR prchain " [\fIstart\fP] [\fIback-flag\fP] Print the chain of superblocks for the directory containing the roots of the dumped file systems, starting at block number .I start (default 0) going forward (backwards if .I back-flag is supplied and is non-zero). .TP .BR searchtag " [\fIstart\fP] [\fItag\fP] [\fIblocks\fP] Reads the WORM device starting at block .I start and proceeding for .I blocks blocks (default 1000) until it finds a block with numeric tag .IR tag . .TP .BR savecache " [\fIpercent\fP] Copy the block numbers, in native endian longwords, of blocks in the .B read state to the file .BR /adm/cache for use by .BR disk/exsort . If an argument is given, then that percent (most recently used) of each cache bucket is copied. .TP .BR loadcache " [\fIdskno\fP] Read .B /adm/cache and for every block there on WORM disk side .I dskno (zero-origin), read the block from WORM to the cache. If .I dskno is not supplied, all blocks in .B /adm/cache are read. .TP .BR morecache " dskno [\fIcount\fP] Read .I count blocks from the beginning of WORM disk side .I dskno to the cache. If no count is given, read all of side .IR dskno into the cache. .TP .BR startdump \ [ 01 ] Suspend .RB ( 0 ) or restart .RB ( 1 ) the background dump process. .TP .B touchsb Verify that the superblock on the WORM is readable, ignoring the cached copy. .TP .BR blockcmp " [\fIwbno\fP] [\fIcbno\fP] Compares the WORM block .I wbno with the cache block .I cbno and prints the first 10 differences, if any. .TP .B acct Prints how many times each user has caused the system to allocate new space on the WORM; the units are megabytes. .TP .B clearacct Clears the accounting records for .BR acct . .PP .I Date prints the current date. It may be adjusted using .BI +- seconds\f1. With no sign, it sets the date to the absolute number of seconds since 00:00 Jan 1, 1970 GMT; with a sign it trims the current time. .PP .I Duallow sets permissions such that the named .I user can read and search any directories. This is the permission necessary to do a .IR du (1) command anywhere in the file system to discover disk usage. .PP .I Dump starts a dump to WORM immediately for the named filesystem, or the current filesystem if none is named. File service is suspended while the cache is scanned; service resumes when the copy to WORM starts. .PP .I Dumpctl prints the current state of automatic dumps. With an argument of ``on'' or ``off'' (0 or 1) automatic dumps are turned on or off. .PP .I Files prints for every connection the number of allocated fids. .PP .I Fstat prints the current status of each named .IR file , including uid, gid, wuid (uid of the last user to modify the file), size, qid, and disk addresses. .PP .I Flag toggles flags, initially all off: .TF authdisablexx .TP .B allchans Print channels in .I who output. .TP .B allow Allow arbitrary wstat changes. .TP .B aoe Verbose AoE chat. .TP .B aoertt Verbose AoE RTT adjustments. .TP .B aoesnoopy Print AoE packets. .TP .B arp Report ARP activity. .TP .B attach Report as connections are made to the file server. .TP .B authdebug Report authentications. .TP .B authdisable Disable authentication. .TP .B chat (Very noisy.) Print all 9P messages to and from the server. .TP .B error Report 9P errors. .TP .B il Report IL errors. .TP .B route Report received RIP packets. .TP .B ro