From: Barry Naujok Date: Thu, 4 Oct 2007 16:03:10 +0000 (+0000) Subject: Fix minor errors and some clarification of man pages X-Git-Tag: v2.10.0~26 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=967d4e13dcf67b847642570401271a563c004565;p=thirdparty%2Fxfsprogs-dev.git Fix minor errors and some clarification of man pages Merge of master-melb:xfs-cmds:29836a by kenmcd. Fix minor errors and some clarifications in man pages --- diff --git a/doc/CHANGES b/doc/CHANGES index 8d818556c..1858a87a3 100644 --- a/doc/CHANGES +++ b/doc/CHANGES @@ -1,3 +1,11 @@ +xfsprogs-2.9.x + - Changed mkfs.xfs -f to wipe all old AG headers, not just the ones + up to the end of the new filesystem size. + - Purged the end of device whack buffer in mkfs.xfs to prevent a + warning in certain device sizes. + - Man page fixes. Thanks to Utako Kusaka + for this. + xfsprogs-2.9.4 (7 Sep 2007) - Fixed xfs_repair segfaulting with directory block size different to the filesystem blocksize. diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index 0b91b613b..0d2790153 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -567,7 +567,7 @@ syntax on line 7. This syntax directs the command to terminate the branch of the filesystem it is currently on and then continue from the directory specified by -the next line,in this case line 8 +the next line, in this case line 8. It must be the last character on a line. The colon @@ -610,13 +610,13 @@ The third character of the mode string is used to specify the setgroupID mode, in which case it is .BR g . -If setgroupID mode is not specified, the second character is +If setgroupID mode is not specified, the third character is .BR \- . The remaining characters of the mode string are a three digit octal number. This octal number defines the owner, group, and other read, write, and execute permissions for the file, respectively. -Form more information on file permissions, see the +For more information on file permissions, see the .BR chmod (1) command. .IP diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8 index 2b8a24a2c..9171b9156 100644 --- a/man/man8/xfs_db.8 +++ b/man/man8/xfs_db.8 @@ -153,30 +153,30 @@ See the command. .TP .BI ablock " filoff" -Set current address to the offset . -I filoff +Set current address to the offset +.I filoff (a filesystem block number) in the attribute area of the current inode. .TP .BI "addr [" field-expression ] Set current address to the value of the .IR field-expression . This is used to "follow" a reference in one structure to the object -being referred to. If no argument is given the current address is printed. +being referred to. If no argument is given, the current address is printed. .TP .BI "agf [" agno ] Set current address to the AGF block for allocation group .IR agno . -If no argument is given use the current allocation group. +If no argument is given, use the current allocation group. .TP .BI "agfl [" agno ] Set current address to the AGFL block for allocation group .IR agno . -If no argument is given use the current allocation group. +If no argument is given, use the current allocation group. .TP .BI "agi [" agno ] Set current address to the AGI block for allocation group .IR agno . -If no argument is given use the current allocation group. +If no argument is given, use the current allocation group. .TP .B b See the @@ -413,8 +413,8 @@ Set current address to the daddr (512 byte block) given by .IR d . If no value for .I d -is given the current address is printed, expressed as a daddr. -The type is set to . +is given, the current address is printed, expressed as a daddr. +The type is set to .B data (uninterpreted). .TP @@ -641,7 +641,7 @@ Set current address to SB header in allocation group .IR agno . If no .I agno -is given use the current allocation group number. +is given, use the current allocation group number. .TP .BI "source " source-file Process commands from @@ -789,7 +789,7 @@ number of blocks held in the AGF Btrees. .PD .RE .TP -.B agf +.B agfl The AGFL block contains block numbers for use of the block allocator; it is in the fourth 512-byte block of each allocation group. Each entry in the active list is a block number within the allocation group diff --git a/man/man8/xfs_freeze.8 b/man/man8/xfs_freeze.8 index ebe092577..ef5d1ec9f 100644 --- a/man/man8/xfs_freeze.8 +++ b/man/man8/xfs_freeze.8 @@ -43,7 +43,7 @@ or a clean mount of the snapshot is complete. .PP The .B \-u -flagq is used to un-freeze the filesystem and allow +flag is used to un-freeze the filesystem and allow operations to continue. Any filesystem modifications that were blocked by the freeze are unblocked and allowed to complete. diff --git a/man/man8/xfs_logprint.8 b/man/man8/xfs_logprint.8 index 163a99e2b..c1a8077c3 100644 --- a/man/man8/xfs_logprint.8 +++ b/man/man8/xfs_logprint.8 @@ -76,7 +76,7 @@ This might happen if an image copy of a filesystem has been made into an ordinary file with .BR xfs_copy (8). .TP -.B \-l +.BI \-l " logdev" External log device. Only for those filesystems which use an external log. .TP .B \-i diff --git a/man/man8/xfs_metadump.8 b/man/man8/xfs_metadump.8 index 402bfaf54..f0ff1aeef 100644 --- a/man/man8/xfs_metadump.8 +++ b/man/man8/xfs_metadump.8 @@ -39,11 +39,12 @@ filesystem's metadata and indexes to where the blocks were copied from. .PP By default, .B xfs_metadump -obfuscates most directory names and extended attribute names to allow the dumps -to be sent without revealing confidential information. Extended attribute -values are zeroed and no data is copied. The only exceptions are directory -or attribute names that are 4 or less characters in length. Also directory -names that span extents (this can only occur with the +obfuscates most file (regular file, directory and symbolic link) names +and extended attribute names to allow the dumps to be sent without +revealing confidential information. Extended attribute values are zeroed +and no data is copied. The only exceptions are file or attribute names +that are 4 or less characters in length. Also file names that span extents +(this can only occur with the .BR mkfs.xfs (8) options where .B \-n @@ -128,4 +129,4 @@ command. .BR xfs (5) .SH BUGS Email bug reports to -.BR xfs@oss.sgi.com . \ No newline at end of file +.BR xfs@oss.sgi.com . diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8 index b4d02c551..4bd705127 100644 --- a/man/man8/xfs_repair.8 +++ b/man/man8/xfs_repair.8 @@ -110,8 +110,7 @@ is 1024 (for a total of 8192 entries). overrides the default buffer cache hash size. The total number of buffer cache entries are limited to 8 times this amount. The default size is set to use up the remainder of 75% of the system's physical -RAM. -size +RAM size. .TP .BI ag_stride= ags_per_concat_unit This creates additional processing threads to parallel process