sync with style of other man pages Reference: /n/atom/patch/applied/θfsmannits Date: Sun Jan 3 01:31:52 CET 2016 Signed-off-by: quanstro@quanstro.net --- /sys/man/4/θfs Sun Jan 3 01:31:27 2016 +++ /sys/man/4/θfs Sun Jan 3 01:31:28 2016 @@ -33,40 +33,42 @@ .I θfs are definted as follows: .TP -.I -a +.B -a Disable AoE functionality, both the bock and object support. .TP -.I -n +.B -n Disable NFS functionality. .TP -.I -m +.B -m Set the number of blocks to keep in the in-memory cache. .TP -.I -p +.B -p Set the port number on which to listen for 9P connections. .TP -.I -r -Reame the file system on start up. +.B -r +Ream the file system on start up. .TP -.I -s +.B -s Read 9P messages from the standard input. This is used when a system takes its root from a local instance of .IR θfs . .TP -.I -A +.B -A Update access times on reads. .TP -.I -C +.B -C Post a console descriptor to .BR /srv . .TP -.I -D +.B -D Turn on 9P debugging. .PP .SH CONSOLE .PP When invoked with the -.IR -C option, θfs +.B -C +option, +.I θfs posts a file descriptor to .BR /srv/θfscons . This console can be accessed by connecting to the descriptor with @@ -78,85 +80,85 @@ .PP This interactive console supports the following commands: .TP -.I allow +.B allow Turns off permissions checking and allows .I wstat (see .IR stat (5)) messages to change file ownerships. .TP -.I blockuse +.B blockuse Looks up a specified block number and reports its role. This is intended primarily for debugging purposes. .TP -.I checkalloc +.B checkalloc Scans the file system looking for inconsistancies in the block allocation, reporting what it finds. It also rebuilds the free block map. .TP -.I cstat +.B cstat Reports on in-memory block cache statistics. .TP -.I disallow +.B disallow Reinstates permissions checking and prohibits file ownership changes. .TP -.I dumpusers +.B dumpusers Prints a list of all Plan 9 users and all NFS UID information loaded either at start-up or by the .I inituid command. .TP -.I fixfamilies +.B fixfamilies Scans the file system examining all parent/child/sibling relationships and removes entries with no valid metadata. .TP -.I fixpaths +.B fixpaths Removes path names in the path hash table that do not have valid metadata. .TP -.I halt +.B halt Flushes all modified blocks from the cache and terminates 9P and NFS service. .TP -.I help +.B help Prints a list of the commands supported in the console and the number of command arguments each uses. .TP -.I hstat +.B hstat Prints a summary of hash table statistics. In particular, it reports on the number of bucket collisions and maximum search depth encountered since start-up. .TP -.I inituid +.B inituid Reloads the Plan 9 user file .B /adm/users and the NFS UID mappings specified in .BR /adm/nfs . .TP -.I lcreate +.B lcreate Creates an AoE LUN with a specified AoE ID and size. .TP -.I lls +.B lls Prints a list of AoE LUNs. .TP -.I lmeta +.B lmeta Prints the metadata for the specified AoE LUN. .TP -.I lrm +.B lrm Removes the specified AoE LUN. .TP -.I mpred +.B mpred Locates the predecessor to the specified meatadatum in the metadata list of which it's a part. .TP -.I mprint +.B mprint Prints the details of the specified metadatum. .TP -.I mstat +.B mstat Prints a summary of metadata statistics. .TP -.I newroot +.B newroot Creates a new file tree within the file system storage space. The file tree named @@ -166,67 +168,67 @@ Named roots are accessible by way of the mount specifier in 9P and as top-level directories in a virtual root in NFS. .TP -.I nfsdebug +.B nfsdebug Prints the current debug level of NFS when invoked with no arguments. Otherwise, sets the NFS debug level to the specified value. .TP -.I p2q +.B p2q Looks up and prints the QID path value for the specified path name. .TP -.I p9debug +.B p9debug Sets the value of the .B chatty9p variable. .TP -.I phash +.B phash Shows the bucket number and the location of the hash list for the specified path name. .TP -.I pmeta +.B pmeta Prints the metadata list for the specified path name. .TP -.I q2m +.B q2m Looks up and prints the index of the first metadatum for the specified QID path. .TP -.I qmeta +.B qmeta Prints the metadata list for the specified QID path. .TP -.I recovermeta +.B recovermeta Scans the file system and rebuilds the free list of metadata entries. .TP -.I revert +.B revert Reverses the effect of changes made since a specified snapshot. The file system is rolled back in time to the point at which the specified snapshot was taken. .TP -.I rmp +.B rmp Removes the specified path name from the path hash table. .TP -.I rootallow +.B rootallow Gives UID 0 unchecked access over NFS according to traditional UNIX superuser privileges. .TP -.I rootdisallow +.B rootdisallow Treats UID 0 as though it were any normal user and enforces permissions checking for it as such. .TP -.I setmeta +.B setmeta Adds (or modifies) a metadatum for the specified QID path. Its arguments are QID path, metadata type, name, and value. .TP -.I setmstruct +.B setmstruct Explicitly sets the fields of a specified metadatum. Useful mostly to do very low-level repairs on a mangled file system. .TP -.I setqhash +.B setqhash Points a QID hash table entry to a specified metadatum. .TP -.I snap +.B snap Creates a file system snapshot when using .IR snap (3) and when using a dump file system. @@ -245,10 +247,10 @@ is the empty string. For subsequent snapsthots it takes on the values: 1, 2, ... 9. .TP -.I super +.B super Prints a summary of the file system super block. .TP -.I sync +.B sync Flushes any modified blocks in the cache. .SH EXAMPLES Create a file system listening on port 1992 and mount it on