* [PATCH 0/3] xfsprogs: manpage & usage string fixups
@ 2013-04-22 22:37 Eric Sandeen
2013-04-22 22:39 ` [PATCH 1/3] xfsprogs: manpage spelling fixes Eric Sandeen
` (2 more replies)
0 siblings, 3 replies; 22+ messages in thread
From: Eric Sandeen @ 2013-04-22 22:37 UTC (permalink / raw)
To: xfs-oss
The helpful QE elves at Red Hat wrote scripts to check
manpages, usage strings, and actual accepted arguments,
and found lots of inconsistencies in xfsprogs, as well
as spelling errors. Fixups follow.
_______________________________________________
xfs mailing list
xfs@oss.sgi.com
http://oss.sgi.com/mailman/listinfo/xfs
^ permalink raw reply [flat|nested] 22+ messages in thread* [PATCH 1/3] xfsprogs: manpage spelling fixes 2013-04-22 22:37 [PATCH 0/3] xfsprogs: manpage & usage string fixups Eric Sandeen @ 2013-04-22 22:39 ` Eric Sandeen 2013-04-23 15:18 ` Rich Johnston 2013-04-25 14:12 ` [PATCH 1/3 V2] " Eric Sandeen 2013-04-22 22:40 ` [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options Eric Sandeen 2013-04-22 22:42 ` [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions Eric Sandeen 2 siblings, 2 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-22 22:39 UTC (permalink / raw) To: xfs-oss Fix several spelling errors in xfsprogs manpages. Signed-off-by: Eric Sandeen <sandeen@redhat.com> --- diff --git a/man/man5/projects.5 b/man/man5/projects.5 index d8fb56d..6845540 100644 --- a/man/man5/projects.5 +++ b/man/man5/projects.5 @@ -1,6 +1,6 @@ .TH projects 5 .SH NAME -projects \- persistent project root defintion +projects \- persistent project root definition .SH DESCRIPTION The .I /etc/projects diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index fa52152..7f3a4b4 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -279,7 +279,7 @@ with .BR log= , or as the number fitting in a filesystem block with .BR perblock= . -The mininum (and default) +The minimum (and default) .I value is 256 bytes. The maximum @@ -297,7 +297,7 @@ so if no inode size is given on the command line, .B mkfs.xfs will attempt to choose a size such that inode numbers will be < 32 bits. If an inode size -is specified, or if a filesystem is sufficently large, +is specified, or if a filesystem is sufficiently large, .B mkfs.xfs will warn if this will create inode numbers > 32 significant bits. diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8 index 17ac601..646380c 100644 --- a/man/man8/xfs_db.8 +++ b/man/man8/xfs_db.8 @@ -960,12 +960,12 @@ and (1 if the extent is unwritten). .TP .B keys -[nonleaf blocks only] array of key records. These are the first key +[non-leaf blocks only] array of key records. These are the first key value of each block in the level below this one. Each record contains .BR startoff . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. +[non-leaf blocks only] array of child block pointers. Each pointer is a filesystem block number to the next level in the Btree. .PD .RE @@ -975,7 +975,7 @@ There is one set of filesystem blocks forming the by-block-number allocation Btree for each allocation group. The root block of this Btree is designated by the .B bnoroot -field in the coresponding AGF block. +field in the corresponding AGF block. The blocks are linked to sibling left and right blocks at each level, as well as by pointers from parent to child blocks. Each block has the following fields: @@ -1004,14 +1004,14 @@ and .BR blockcount . .TP .B keys -[nonleaf blocks only] array of key records. These are the first value +[non-leaf blocks only] array of key records. These are the first value of each block in the level below this one. Each record contains .B startblock and .BR blockcount . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. Each pointer is a +[non-leaf blocks only] array of child block pointers. Each pointer is a block number within the allocation group to the next level in the Btree. .PD .RE @@ -1021,7 +1021,7 @@ There is one set of filesystem blocks forming the by-block-count allocation Btree for each allocation group. The root block of this Btree is designated by the .B cntroot -field in the coresponding AGF block. The blocks are linked to sibling +field in the corresponding AGF block. The blocks are linked to sibling left and right blocks at each level, as well as by pointers from parent to child blocks. Each block has the following fields: .RS 1.4i @@ -1049,14 +1049,14 @@ and .BR blockcount . .TP .B keys -[nonleaf blocks only] array of key records. These are the first value +[non-leaf blocks only] array of key records. These are the first value of each block in the level below this one. Each record contains .B blockcount and .BR startblock . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. Each pointer is a +[non-leaf blocks only] array of child block pointers. Each pointer is a block number within the allocation group to the next level in the Btree. .PD .RE @@ -1368,7 +1368,7 @@ number of warnings issued about realtime block limit violations. There is one set of filesystem blocks forming the inode allocation Btree for each allocation group. The root block of this Btree is designated by the .B root -field in the coresponding AGI block. +field in the corresponding AGI block. The blocks are linked to sibling left and right blocks at each level, as well as by pointers from parent to child blocks. Each block has the following fields: @@ -1400,12 +1400,12 @@ count of free inodes in this chunk, and bitmap, LSB corresponds to inode 0. .TP .B keys -[nonleaf blocks only] array of key records. These are the first value of each +[non-leaf blocks only] array of key records. These are the first value of each block in the level below this one. Each record contains .BR startino . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. Each pointer is a +[non-leaf blocks only] array of child block pointers. Each pointer is a block number within the allocation group to the next level in the Btree. .PD .RE diff --git a/man/man8/xfs_mdrestore.8 b/man/man8/xfs_mdrestore.8 index a7d2b68..7b9ba89 100644 --- a/man/man8/xfs_mdrestore.8 +++ b/man/man8/xfs_mdrestore.8 @@ -16,7 +16,7 @@ to a filesystem. The .I source argument specifies the location of the metadump image and the .I target -argument specifies the destination for the filsystem image. +argument specifies the destination for the filesystem image. If the .I source is \-, then the metadata image is read from stdin. This allows the output of diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 index f3b54cc..9327feb 100644 --- a/man/man8/xfs_quota.8 +++ b/man/man8/xfs_quota.8 @@ -623,7 +623,7 @@ can be used to limit recursion level (\-1 is infinite, 0 is top level only, 1 is first level ... ). Option .B \-p -adds posibility to specify project paths in command line without a need +adds possibility to specify project paths in command line without a need for .I /etc/projects to exist. Note that if projects file exists then it is also used. diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8 index 57c97da..7b296ba 100644 --- a/man/man8/xfs_repair.8 +++ b/man/man8/xfs_repair.8 @@ -170,7 +170,7 @@ Verbose output. Repair dangerously. Allow .B xfs_repair to repair an XFS filesystem mounted read only. This is typically done -on a root fileystem from single user mode, immediately followed by a reboot. +on a root filesystem from single user mode, immediately followed by a reboot. .TP .B \-V Prints out the current version number and exits. @@ -239,7 +239,7 @@ The name assigned is the inode number. aborts on most disk I/O errors. Therefore, if you are trying to repair a filesystem that was damaged due to a disk drive failure, steps should be taken to ensure that all blocks in the filesystem are -readable and writeable before attempting to use +readable and writable before attempting to use .B xfs_repair to repair the filesystem. A possible method is using .BR dd (8) _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3] xfsprogs: manpage spelling fixes 2013-04-22 22:39 ` [PATCH 1/3] xfsprogs: manpage spelling fixes Eric Sandeen @ 2013-04-23 15:18 ` Rich Johnston 2013-04-23 15:43 ` Dave Howorth 2013-04-23 19:36 ` Eric Sandeen 2013-04-25 14:12 ` [PATCH 1/3 V2] " Eric Sandeen 1 sibling, 2 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-23 15:18 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss On 04/22/2013 05:39 PM, Eric Sandeen wrote: > Fix several spelling errors in xfsprogs manpages. > > Signed-off-by: Eric Sandeen <sandeen@redhat.com> > --- > > diff --git a/man/man5/projects.5 b/man/man5/projects.5 #rcj OK > diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 #rcj serialisation is misspelled, should be serialization. > diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8 #rcj guarenteed should be guaranteed #rcj Nonleaf to Non-leaf ???? not sure about that one :) > diff --git a/man/man8/xfs_mdrestore.8 b/man/man8/xfs_mdrestore.8 #rcj OK > diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 #rcj OK > diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8 #rcj OK _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3] xfsprogs: manpage spelling fixes 2013-04-23 15:18 ` Rich Johnston @ 2013-04-23 15:43 ` Dave Howorth 2013-04-23 15:59 ` Rich Johnston 2013-04-23 19:36 ` Eric Sandeen 1 sibling, 1 reply; 22+ messages in thread From: Dave Howorth @ 2013-04-23 15:43 UTC (permalink / raw) To: xfs Rich Johnston wrote: >> diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 > #rcj serialisation is misspelled, should be serialization. That depends on where you live, of course. It is derived from a Latin root, I think, so should have an 's'. At least, where I live. Do manpages have a policy as regards spelling? _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3] xfsprogs: manpage spelling fixes 2013-04-23 15:43 ` Dave Howorth @ 2013-04-23 15:59 ` Rich Johnston 2013-04-23 16:20 ` Stefan Ring 0 siblings, 1 reply; 22+ messages in thread From: Rich Johnston @ 2013-04-23 15:59 UTC (permalink / raw) To: Dave Howorth; +Cc: xfs On 04/23/2013 10:43 AM, Dave Howorth wrote: > Rich Johnston wrote: >>> diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 >> #rcj serialisation is misspelled, should be serialization. > > That depends on where you live, of course. It is derived from a Latin > root, I think, so should have an 's'. At least, where I live. Good point Dave, I did not think to look that one up online, my bad for trusting my spell checker and my locale. ;) Was unaware that that one is spelled two ways (darn British have to spell it differently, or is it those darn colonists don't know how to spell i.e. color colour) > > Do manpages have a policy as regards spelling? Not to my knowledge. _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3] xfsprogs: manpage spelling fixes 2013-04-23 15:59 ` Rich Johnston @ 2013-04-23 16:20 ` Stefan Ring 0 siblings, 0 replies; 22+ messages in thread From: Stefan Ring @ 2013-04-23 16:20 UTC (permalink / raw) To: Rich Johnston; +Cc: Dave Howorth, Linux fs XFS >> Do manpages have a policy as regards spelling? > > Not to my knowledge. But if the rest of the man page / package is en_US, as is likely the case, it would make sense to stick to this locale. _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3] xfsprogs: manpage spelling fixes 2013-04-23 15:18 ` Rich Johnston 2013-04-23 15:43 ` Dave Howorth @ 2013-04-23 19:36 ` Eric Sandeen 1 sibling, 0 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-23 19:36 UTC (permalink / raw) To: Rich Johnston; +Cc: xfs-oss On 4/23/13 10:18 AM, Rich Johnston wrote: > On 04/22/2013 05:39 PM, Eric Sandeen wrote: >> Fix several spelling errors in xfsprogs manpages. >> >> Signed-off-by: Eric Sandeen <sandeen@redhat.com> >> --- >> >> diff --git a/man/man5/projects.5 b/man/man5/projects.5 > #rcj OK > >> diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 > #rcj serialisation is misspelled, should be serialization. > >> diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8 > #rcj guarenteed should be guaranteed whoops I missed that, didn't introduce it, did I? > #rcj Nonleaf to Non-leaf ???? not sure about that one :) $ aspell -a @(#) International Ispell Version 3.1.20 (but really Aspell 0.60.6) nonleaf & nonleaf 11 0: non leaf, non-leaf, ... *shrug* -Eric >> diff --git a/man/man8/xfs_mdrestore.8 b/man/man8/xfs_mdrestore.8 > #rcj OK > >> diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 > #rcj OK > >> diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8 > #rcj OK > > _______________________________________________ > xfs mailing list > xfs@oss.sgi.com > http://oss.sgi.com/mailman/listinfo/xfs > _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* [PATCH 1/3 V2] xfsprogs: manpage spelling fixes 2013-04-22 22:39 ` [PATCH 1/3] xfsprogs: manpage spelling fixes Eric Sandeen 2013-04-23 15:18 ` Rich Johnston @ 2013-04-25 14:12 ` Eric Sandeen 2013-04-25 14:59 ` Rich Johnston 2013-04-25 20:43 ` Rich Johnston 1 sibling, 2 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-25 14:12 UTC (permalink / raw) To: xfs-oss Fix several spelling errors in xfsprogs manpages. Signed-off-by: Eric Sandeen <sandeen@redhat.com> --- V2: fix serialization, guaranteed diff --git a/man/man5/projects.5 b/man/man5/projects.5 index d8fb56d..6845540 100644 --- a/man/man5/projects.5 +++ b/man/man5/projects.5 @@ -1,6 +1,6 @@ .TH projects 5 .SH NAME -projects \- persistent project root defintion +projects \- persistent project root definition .SH DESCRIPTION The .I /etc/projects diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index fa52152..f707881 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -279,7 +279,7 @@ with .BR log= , or as the number fitting in a filesystem block with .BR perblock= . -The mininum (and default) +The minimum (and default) .I value is 256 bytes. The maximum @@ -297,7 +297,7 @@ so if no inode size is given on the command line, .B mkfs.xfs will attempt to choose a size such that inode numbers will be < 32 bits. If an inode size -is specified, or if a filesystem is sufficently large, +is specified, or if a filesystem is sufficiently large, .B mkfs.xfs will warn if this will create inode numbers > 32 significant bits. @@ -450,7 +450,7 @@ suboption is specified. This changes the method of logging various persistent counters in the superblock. Under metadata intensive workloads, these counters are updated and logged frequently enough that the superblock -updates become a serialisation point in the filesystem. The +updates become a serialization point in the filesystem. The .I value can be either 0 or 1. .IP diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8 index 17ac601..0558671 100644 --- a/man/man8/xfs_db.8 +++ b/man/man8/xfs_db.8 @@ -64,7 +64,7 @@ and Allows execution on a mounted filesystem, provided it is mounted read-only. Useful for shell scripts such as .BR xfs_check (8), -which must only operate on filesystems in a guarenteed consistent state +which must only operate on filesystems in a guaranteed consistent state (either unmounted or mounted read-only). These semantics are slightly different to that of the .B -r @@ -960,12 +960,12 @@ and (1 if the extent is unwritten). .TP .B keys -[nonleaf blocks only] array of key records. These are the first key +[non-leaf blocks only] array of key records. These are the first key value of each block in the level below this one. Each record contains .BR startoff . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. +[non-leaf blocks only] array of child block pointers. Each pointer is a filesystem block number to the next level in the Btree. .PD .RE @@ -975,7 +975,7 @@ There is one set of filesystem blocks forming the by-block-number allocation Btree for each allocation group. The root block of this Btree is designated by the .B bnoroot -field in the coresponding AGF block. +field in the corresponding AGF block. The blocks are linked to sibling left and right blocks at each level, as well as by pointers from parent to child blocks. Each block has the following fields: @@ -1004,14 +1004,14 @@ and .BR blockcount . .TP .B keys -[nonleaf blocks only] array of key records. These are the first value +[non-leaf blocks only] array of key records. These are the first value of each block in the level below this one. Each record contains .B startblock and .BR blockcount . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. Each pointer is a +[non-leaf blocks only] array of child block pointers. Each pointer is a block number within the allocation group to the next level in the Btree. .PD .RE @@ -1021,7 +1021,7 @@ There is one set of filesystem blocks forming the by-block-count allocation Btree for each allocation group. The root block of this Btree is designated by the .B cntroot -field in the coresponding AGF block. The blocks are linked to sibling +field in the corresponding AGF block. The blocks are linked to sibling left and right blocks at each level, as well as by pointers from parent to child blocks. Each block has the following fields: .RS 1.4i @@ -1049,14 +1049,14 @@ and .BR blockcount . .TP .B keys -[nonleaf blocks only] array of key records. These are the first value +[non-leaf blocks only] array of key records. These are the first value of each block in the level below this one. Each record contains .B blockcount and .BR startblock . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. Each pointer is a +[non-leaf blocks only] array of child block pointers. Each pointer is a block number within the allocation group to the next level in the Btree. .PD .RE @@ -1368,7 +1368,7 @@ number of warnings issued about realtime block limit violations. There is one set of filesystem blocks forming the inode allocation Btree for each allocation group. The root block of this Btree is designated by the .B root -field in the coresponding AGI block. +field in the corresponding AGI block. The blocks are linked to sibling left and right blocks at each level, as well as by pointers from parent to child blocks. Each block has the following fields: @@ -1400,12 +1400,12 @@ count of free inodes in this chunk, and bitmap, LSB corresponds to inode 0. .TP .B keys -[nonleaf blocks only] array of key records. These are the first value of each +[non-leaf blocks only] array of key records. These are the first value of each block in the level below this one. Each record contains .BR startino . .TP .B ptrs -[nonleaf blocks only] array of child block pointers. Each pointer is a +[non-leaf blocks only] array of child block pointers. Each pointer is a block number within the allocation group to the next level in the Btree. .PD .RE diff --git a/man/man8/xfs_mdrestore.8 b/man/man8/xfs_mdrestore.8 index a7d2b68..7b9ba89 100644 --- a/man/man8/xfs_mdrestore.8 +++ b/man/man8/xfs_mdrestore.8 @@ -16,7 +16,7 @@ to a filesystem. The .I source argument specifies the location of the metadump image and the .I target -argument specifies the destination for the filsystem image. +argument specifies the destination for the filesystem image. If the .I source is \-, then the metadata image is read from stdin. This allows the output of diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 index f3b54cc..9327feb 100644 --- a/man/man8/xfs_quota.8 +++ b/man/man8/xfs_quota.8 @@ -623,7 +623,7 @@ can be used to limit recursion level (\-1 is infinite, 0 is top level only, 1 is first level ... ). Option .B \-p -adds posibility to specify project paths in command line without a need +adds possibility to specify project paths in command line without a need for .I /etc/projects to exist. Note that if projects file exists then it is also used. diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8 index 57c97da..7b296ba 100644 --- a/man/man8/xfs_repair.8 +++ b/man/man8/xfs_repair.8 @@ -170,7 +170,7 @@ Verbose output. Repair dangerously. Allow .B xfs_repair to repair an XFS filesystem mounted read only. This is typically done -on a root fileystem from single user mode, immediately followed by a reboot. +on a root filesystem from single user mode, immediately followed by a reboot. .TP .B \-V Prints out the current version number and exits. @@ -239,7 +239,7 @@ The name assigned is the inode number. aborts on most disk I/O errors. Therefore, if you are trying to repair a filesystem that was damaged due to a disk drive failure, steps should be taken to ensure that all blocks in the filesystem are -readable and writeable before attempting to use +readable and writable before attempting to use .B xfs_repair to repair the filesystem. A possible method is using .BR dd (8) _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3 V2] xfsprogs: manpage spelling fixes 2013-04-25 14:12 ` [PATCH 1/3 V2] " Eric Sandeen @ 2013-04-25 14:59 ` Rich Johnston 2013-04-25 20:43 ` Rich Johnston 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-25 14:59 UTC (permalink / raw) To: xfs Sorry for being so picky. Thanks for V2! Looks good. Reviewed-by: Rich Johnston <rjohnston@sgi.com> _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 1/3 V2] xfsprogs: manpage spelling fixes 2013-04-25 14:12 ` [PATCH 1/3 V2] " Eric Sandeen 2013-04-25 14:59 ` Rich Johnston @ 2013-04-25 20:43 ` Rich Johnston 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-25 20:43 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss Thanks Eric, V2 has been committed. --Rich commit 87342c3a5dcb5d6812e93c201ecd3e51d971e6d6 Author: Eric Sandeen <sandeen@sandeen.net> Date: Thu Apr 25 14:12:08 2013 +0000 xfsprogs: manpage spelling fixes _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options 2013-04-22 22:37 [PATCH 0/3] xfsprogs: manpage & usage string fixups Eric Sandeen 2013-04-22 22:39 ` [PATCH 1/3] xfsprogs: manpage spelling fixes Eric Sandeen @ 2013-04-22 22:40 ` Eric Sandeen 2013-04-23 18:35 ` Rich Johnston 2013-04-25 15:03 ` [PATCH 2/3 V2] " Eric Sandeen 2013-04-22 22:42 ` [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions Eric Sandeen 2 siblings, 2 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-22 22:40 UTC (permalink / raw) To: xfs-oss Add valid options which aren't in manpages, and remove invalid options which are in manpages: * Document -V (show version and exit) for many manpages. * Remove -? option from xfs_estimate.8 * Document -p passes, -d (debug) and -g (syslog) in xfs_fsr.8 * Document -n (O_NONBLOCK) in xfs_io.8 * Document -v (print overwrite) in xfs_logprint.8 * Document -m max_extents in xfs_metadump.8 * Document -p (preallocate) in xfs_mkfile.8 Signed-off-by: Eric Sandeeen <sandeen@redhat.com> --- diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index 7f3a4b4..add48cb 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -38,6 +38,8 @@ mkfs.xfs \- construct an XFS filesystem .B \-N ] [ .B \-K +] [ +.B \-V ] .I device .SH DESCRIPTION @@ -728,6 +730,9 @@ creating the file system. .TP .B \-K Do not attempt to discard blocks at mkfs time. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR xfs (5), .BR mkfs (8), diff --git a/man/man8/xfs_admin.8 b/man/man8/xfs_admin.8 index 2de907b..4b476f5 100644 --- a/man/man8/xfs_admin.8 +++ b/man/man8/xfs_admin.8 @@ -4,7 +4,7 @@ xfs_admin \- change parameters of an XFS filesystem .SH SYNOPSIS .B xfs_admin [ -.B \-eflpu +.B \-eflpuV ] [ .BR "\-c 0" | 1 ] [ @@ -97,6 +97,9 @@ The may also be .BR generate , which will generate a new UUID for the filesystem. +.TP +.B \-V +Prints the version number and exits. .PP The .BR mount (8) diff --git a/man/man8/xfs_bmap.8 b/man/man8/xfs_bmap.8 index ccaa79b..7a1e948 100644 --- a/man/man8/xfs_bmap.8 +++ b/man/man8/xfs_bmap.8 @@ -4,7 +4,7 @@ xfs_bmap \- print block mapping for an XFS file .SH SYNOPSIS .B xfs_bmap [ -.B \-adlpv +.B \-adlpvV ] [ .B \-n .I num_extents @@ -91,6 +91,9 @@ A second option will print out the .I flags legend. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR xfs_fsr (8), .BR xfs (5). diff --git a/man/man8/xfs_check.8 b/man/man8/xfs_check.8 index 1654532..6168f2e 100644 --- a/man/man8/xfs_check.8 +++ b/man/man8/xfs_check.8 @@ -16,6 +16,8 @@ xfs_check \- check XFS filesystem consistency ] [ .B \-v ] [ +.B \-V +] [ .B \-l .I logdev ] @@ -73,6 +75,9 @@ Specifies verbose output; it is impossibly long for a reasonably-sized filesystem. This option is intended for internal use only. .TP +.B \-V +Prints the version number and exits. +.TP .BI \-i " ino" Specifies verbose behavior for the specified inode .IR ino . diff --git a/man/man8/xfs_copy.8 b/man/man8/xfs_copy.8 index 3028db8..35edace 100644 --- a/man/man8/xfs_copy.8 +++ b/man/man8/xfs_copy.8 @@ -4,7 +4,7 @@ xfs_copy \- copy the contents of an XFS filesystem .SH SYNOPSIS .B xfs_copy [ -.B \-bd +.B \-bdV ] [ .B \-L .I log @@ -81,6 +81,9 @@ The buffered option can be used to ensure direct IO is not attempted to any of the target files. This is useful when the filesystem holding the target file does not support direct IO. .TP +.B \-V +Prints the version number and exits. +.TP .BI \-L " log" Specifies the location of the .I log diff --git a/man/man8/xfs_estimate.8 b/man/man8/xfs_estimate.8 index bb458ec..ca86d46 100644 --- a/man/man8/xfs_estimate.8 +++ b/man/man8/xfs_estimate.8 @@ -3,7 +3,7 @@ xfs_estimate \- estimate the space that an XFS filesystem will take .SH SYNOPSIS .nf -\f3xfs_estimate\f1 [ \f3\-h?\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ] +\f3xfs_estimate\f1 [ \f3\-h\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ] [ \f3\-e\f1 logsize ] [ \f3\-v\f1 ] directory ... .fi .SH DESCRIPTION @@ -51,9 +51,6 @@ Display more information, formatted. .B \-h Display usage message. .TP -.B \-? -Display usage message. -.TP \f3\-i, \-e\f1 \f2logsize\f1 Use .I logsize diff --git a/man/man8/xfs_freeze.8 b/man/man8/xfs_freeze.8 index 97c7911..d36eb60 100644 --- a/man/man8/xfs_freeze.8 +++ b/man/man8/xfs_freeze.8 @@ -2,9 +2,14 @@ .SH NAME xfs_freeze \- suspend access to an XFS filesystem .SH SYNOPSIS -.B xfs_freeze \-f +.B xfs_freeze +[ +.B \-V +] [ +.B \-f | .B \-u +] .I mount-point .fi .SH DESCRIPTION @@ -26,6 +31,10 @@ The filesystem must be mounted to be frozen (see .BR mount (8)). .PP The +.B \-V +flag prints the version number and exits. +.PP +The .B \-f flag requests the specified XFS filesystem to be frozen from new modifications. @@ -48,7 +57,9 @@ operations to continue. Any filesystem modifications that were blocked by the freeze are unblocked and allowed to complete. .PP -One of +Unless +.B \-V +is specified, one of .B \-f or .B \-u diff --git a/man/man8/xfs_fsr.8 b/man/man8/xfs_fsr.8 index bf5e942..f365274 100644 --- a/man/man8/xfs_fsr.8 +++ b/man/man8/xfs_fsr.8 @@ -3,9 +3,9 @@ xfs_fsr \- filesystem reorganizer for XFS .SH SYNOPSIS .nf -\f3xfs_fsr\f1 [\f3\-v\f1] \c -[\f3\-t\f1 seconds] [\f3\-f\f1 leftoff] [\f3\-m\f1 mtab] -\f3xfs_fsr\f1 [\f3\-v\f1] \c +\f3xfs_fsr\f1 [\f3\-vdg\f1] \c +[\f3\-t\f1 seconds] [\f3\-p\f1 passes] [\f3\-f\f1 leftoff] [\f3\-m\f1 mtab] +\f3xfs_fsr\f1 [\f3\-vdg\f1] \c [xfsdev | file] ... .fi .SH DESCRIPTION @@ -35,7 +35,11 @@ The default is to use .TP .BI \-t " seconds" How long to reorganize. -The default is 7200 (2 hours). +The default is 7200 seconds (2 hours). +.TP +.BI \-p " passes" +Number of passes before terminating global re-org. +The default is 10 passes. .TP .BI \-f " leftoff" Use this file instead of @@ -47,6 +51,12 @@ to store the state of where reorganization left off. Verbose. Print cryptic information about each file being reorganized. +.TP +.B \-d +Debug. Print even more cryptic information. +.TP +.B \-g +Print to syslog (default if stdout not a tty). .PP When invoked with no arguments .I xfs_fsr diff --git a/man/man8/xfs_growfs.8 b/man/man8/xfs_growfs.8 index b55438b..f7a82e9 100644 --- a/man/man8/xfs_growfs.8 +++ b/man/man8/xfs_growfs.8 @@ -39,6 +39,8 @@ xfs_growfs, xfs_info \- expand an XFS filesystem .br .B xfs_info [ +.B \-V +] [ .B \-t .I mtab ] diff --git a/man/man8/xfs_io.8 b/man/man8/xfs_io.8 index 33a5944..0d572c7 100644 --- a/man/man8/xfs_io.8 +++ b/man/man8/xfs_io.8 @@ -4,7 +4,7 @@ xfs_io \- debug the I/O path of an XFS filesystem .SH SYNOPSIS .B xfs_io [ -.B \-adfmrRstx +.B \-adfmrRstxV ] [ .B \-c .I cmd @@ -52,6 +52,9 @@ is immutable or append-only. .B \-x Expert mode. Dangerous commands are only available in this mode. These commands also tend to require additional privileges. +.TP +.B \-V +Prints the version number and exits. .PP The other .BR open (2) @@ -111,6 +114,9 @@ opens for synchronous I/O (O_SYNC). .B \-t truncates on open (O_TRUNC). .TP +.B \-n +opens in non-blocking mode if possible (O_NONBLOCK). +.TP .B \-R marks the file as a realtime XFS file after opening it, if it is not already marked as such. diff --git a/man/man8/xfs_logprint.8 b/man/man8/xfs_logprint.8 index c1a8077..16e881e 100644 --- a/man/man8/xfs_logprint.8 +++ b/man/man8/xfs_logprint.8 @@ -97,6 +97,12 @@ Override any notion of where to start printing. .TP .B \-t Print out the transactional view. +.TP +.B \-v +Print "overwrite" data. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR mkfs.xfs (8), .BR mount (8). diff --git a/man/man8/xfs_metadump.8 b/man/man8/xfs_metadump.8 index 9672713..b2c718a 100644 --- a/man/man8/xfs_metadump.8 +++ b/man/man8/xfs_metadump.8 @@ -6,6 +6,10 @@ xfs_metadump \- copy XFS filesystem metadata to a file [ .B \-efgow ] [ +.B \-m +.I max_extents +] +] [ .B \-l .I logdev ] @@ -94,6 +98,11 @@ For filesystems which use an external log, this specifies the device where the external log resides. The external log is not copied, only internal logs are copied. .TP +.B \-m +Set the maximum size of an allowed metadata extent. Extremely large metadata +extents are likely to be corrupt, and will be skipped if they exceed +this value. The default size is 1000 blocks. +.TP .B \-o Disables obfuscation of file names and extended attributes. .TP diff --git a/man/man8/xfs_mkfile.8 b/man/man8/xfs_mkfile.8 index 96f443f..1d2c501 100644 --- a/man/man8/xfs_mkfile.8 +++ b/man/man8/xfs_mkfile.8 @@ -7,6 +7,10 @@ xfs_mkfile \- create an XFS file .B \-v ] [ .B \-n +] [ +.B \-p +] [ +.B \-V ] .I size\c .RB [ k | b | m | g ] @@ -30,3 +34,10 @@ Verbose. Report the names and sizes of created files. .B \-n No bytes. Create a holey file - that is, do not write out any data, just seek to end of file and write a block. +.TP +.B \-p +Preallocate. The file is preallocated, then overwritten with zeroes, +then truncated to the desired size. +.TP +.B \-V +Prints the version number and exits. diff --git a/man/man8/xfs_ncheck.8 b/man/man8/xfs_ncheck.8 index 408919d..dfaed6a 100644 --- a/man/man8/xfs_ncheck.8 +++ b/man/man8/xfs_ncheck.8 @@ -11,6 +11,8 @@ xfs_ncheck \- generate pathnames from i-numbers for XFS ] [ .B \-s ] [ +.B \-V +] [ .B \-l .I logdev ] @@ -53,6 +55,9 @@ for a detailed description of the XFS log. Limits the report to special files and files with setuserid mode. This option may be used to detect violations of security policy. .TP +.B \-V +Prints the version number and exits. +.TP .BI \-i " ino" Limits the report to only those files whose inode numbers follow. May be given multiple times to select multiple inode numbers. diff --git a/man/man8/xfs_rtcp.8 b/man/man8/xfs_rtcp.8 index be81cb3..22ba12d 100644 --- a/man/man8/xfs_rtcp.8 +++ b/man/man8/xfs_rtcp.8 @@ -8,6 +8,8 @@ xfs_rtcp \- XFS realtime copy command .I extsize ] [ .B -p +] [ +.B -V ] .IR source " ... " target .SH DESCRIPTION @@ -35,6 +37,9 @@ will pad the destination file to a size which is an even multiple of the filesystem block size. This is necessary since the realtime file is created using direct I/O and the minimum I/O is the filesystem block size. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR xfs (5), .BR mkfs.xfs (8), _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options 2013-04-22 22:40 ` [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options Eric Sandeen @ 2013-04-23 18:35 ` Rich Johnston 2013-04-23 19:36 ` Eric Sandeen 2013-04-25 15:03 ` [PATCH 2/3 V2] " Eric Sandeen 1 sibling, 1 reply; 22+ messages in thread From: Rich Johnston @ 2013-04-23 18:35 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss Hey Eric, Couple of comments. 1. The OPTIONS are listed in several ways, (alphabetical order, same order as they appear in the SYNOPSIS, ...). I don't really have a preference, but as long as we are cleaning up the manpages, I suggest we be consistent. (case insensitive alpha order maybe???) 2. How about making the -V option wording the same also? xfs_db and xfs_repair are: Prints out the current version number and exits. ^^^^^^^^ The others: man/man8/mkfs.xfs.8:Prints the version number and exits. man/man8/xfs_admin.8:Prints the version number and exits. man/man8/xfs_bmap.8:Prints the version number and exits. man/man8/xfs_check.8:Prints the version number and exits. man/man8/xfs_copy.8:Prints the version number and exits. man/man8/xfs_growfs.8:Prints the version number and exits. The man/man8/xfs_io.8:Prints the version number and exits. man/man8/xfs_logprint.8:Prints the version number and exits. man/man8/xfs_mkfile.8:Prints the version number and exits. man/man8/xfs_ncheck.8:Prints the version number and exits. man/man8/xfs_rtcp.8:Prints the version number and exits. 3. The following are missing the -V option in both the SYNOPSIS and OPTIONS sections. (I did verify the -V option works for all commands) man/man8/xfs_estimate.8 man/man8/xfs_freeze.8 man/man8/xfs_fsr.8 man/man8/xfs_mdrestore.8 man/man8/xfs_metadump.8 man/man8/xfs_quota.8 man/man8/xfs_repair.8 4. The -V prints the version and exits, shouldn't all the SYNOPSIS look like this for the -V option? SYNOPSIS xfs_db [ -c cmd ] ... [ -i|r|x|F ] [ -f ] [ -l logdev ] ... xfs_db -V Regards --Rich _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options 2013-04-23 18:35 ` Rich Johnston @ 2013-04-23 19:36 ` Eric Sandeen 2013-04-23 19:45 ` Rich Johnston 0 siblings, 1 reply; 22+ messages in thread From: Eric Sandeen @ 2013-04-23 19:36 UTC (permalink / raw) To: Rich Johnston; +Cc: xfs-oss On 4/23/13 1:35 PM, Rich Johnston wrote: > Hey Eric, > > Couple of comments. > > 1. The OPTIONS are listed in several ways, (alphabetical order, same > order as they appear in the SYNOPSIS, ...). I don't really have a > preference, but as long as we are cleaning up the manpages, I suggest > we be consistent. (case insensitive alpha order maybe???) That'd make a fine followup patch, I agree! ;) Re-ordering every manpage won't really be on my todo list soon, though. > 2. How about making the -V option wording the same also? > xfs_db and xfs_repair are: > Prints out the current version number and exits. > ^^^^^^^^ I suppose. I'm not really sure anyone would care? > The others: > man/man8/mkfs.xfs.8:Prints the version number and exits. > man/man8/xfs_admin.8:Prints the version number and exits. > man/man8/xfs_bmap.8:Prints the version number and exits. > man/man8/xfs_check.8:Prints the version number and exits. > man/man8/xfs_copy.8:Prints the version number and exits. > man/man8/xfs_growfs.8:Prints the version number and exits. The > man/man8/xfs_io.8:Prints the version number and exits. > man/man8/xfs_logprint.8:Prints the version number and exits. > man/man8/xfs_mkfile.8:Prints the version number and exits. > man/man8/xfs_ncheck.8:Prints the version number and exits. > man/man8/xfs_rtcp.8:Prints the version number and exits. > > 3. The following are missing the -V option in both the SYNOPSIS and OPTIONS sections. > (I did verify the -V option works for all commands) > man/man8/xfs_estimate.8 > man/man8/xfs_freeze.8 > man/man8/xfs_fsr.8 > man/man8/xfs_mdrestore.8 > man/man8/xfs_metadump.8 > man/man8/xfs_quota.8 > man/man8/xfs_repair.8 not sure how I missed those, sorry. > > 4. The -V prints the version and exits, shouldn't all the SYNOPSIS look like this for the -V option? > > SYNOPSIS > xfs_db [ -c cmd ] ... [ -i|r|x|F ] [ -f ] [ -l logdev ] ... > xfs_db -V Probably. -V is least important of the fixes; I'd be more inclined to just drop the -V changes and not spend a couple more hours rearranging manpages. This was fine work on a plane, but there are more pressing things to do now :( Maybe some list-reader who wants some changelog glory could take this further? :) -Eric > Regards > --Rich > > _______________________________________________ > xfs mailing list > xfs@oss.sgi.com > http://oss.sgi.com/mailman/listinfo/xfs > _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options 2013-04-23 19:36 ` Eric Sandeen @ 2013-04-23 19:45 ` Rich Johnston 0 siblings, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-23 19:45 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss On 04/23/2013 02:36 PM, Eric Sandeen wrote: > On 4/23/13 1:35 PM, Rich Johnston wrote: >> Hey Eric, >> >> Couple of comments. >> >> 1. The OPTIONS are listed in several ways, (alphabetical order, same >> order as they appear in the SYNOPSIS, ...). I don't really have a >> preference, but as long as we are cleaning up the manpages, I suggest >> we be consistent. (case insensitive alpha order maybe???) > > That'd make a fine followup patch, I agree! ;) Re-ordering every > manpage won't really be on my todo list soon, though. > Sounds good. >> 2. How about making the -V option wording the same also? >> xfs_db and xfs_repair are: >> Prints out the current version number and exits. >> ^^^^^^^^ > > I suppose. I'm not really sure anyone would care? > Not important just noting it ;) >> The others: >> man/man8/mkfs.xfs.8:Prints the version number and exits. >> man/man8/xfs_admin.8:Prints the version number and exits. >> man/man8/xfs_bmap.8:Prints the version number and exits. >> man/man8/xfs_check.8:Prints the version number and exits. >> man/man8/xfs_copy.8:Prints the version number and exits. >> man/man8/xfs_growfs.8:Prints the version number and exits. The >> man/man8/xfs_io.8:Prints the version number and exits. >> man/man8/xfs_logprint.8:Prints the version number and exits. >> man/man8/xfs_mkfile.8:Prints the version number and exits. >> man/man8/xfs_ncheck.8:Prints the version number and exits. >> man/man8/xfs_rtcp.8:Prints the version number and exits. >> >> 3. The following are missing the -V option in both the SYNOPSIS and OPTIONS sections. >> (I did verify the -V option works for all commands) >> man/man8/xfs_estimate.8 >> man/man8/xfs_freeze.8 >> man/man8/xfs_fsr.8 >> man/man8/xfs_mdrestore.8 >> man/man8/xfs_metadump.8 >> man/man8/xfs_quota.8 >> man/man8/xfs_repair.8 > > not sure how I missed those, sorry. Do you have time to add these? This really the only todo for now I think. > >> >> 4. The -V prints the version and exits, shouldn't all the SYNOPSIS look like this for the -V option? >> >> SYNOPSIS >> xfs_db [ -c cmd ] ... [ -i|r|x|F ] [ -f ] [ -l logdev ] ... >> xfs_db -V > > Probably. -V is least important of the fixes; I'd be more inclined to just drop > the -V changes and not spend a couple more hours rearranging manpages. > > This was fine work on a plane, but there are more pressing things to do now :( Agreed > > Maybe some list-reader who wants some changelog glory could take this further? :) > Yes a follow up patch works for me, any volunteers? > -Eric > >> Regards >> --Rich >> >> _______________________________________________ >> xfs mailing list >> xfs@oss.sgi.com >> http://oss.sgi.com/mailman/listinfo/xfs >> > _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* [PATCH 2/3 V2] xfsprogs: Fix manpages for missing or incorrect options 2013-04-22 22:40 ` [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options Eric Sandeen 2013-04-23 18:35 ` Rich Johnston @ 2013-04-25 15:03 ` Eric Sandeen 2013-04-25 15:26 ` Rich Johnston 2013-04-25 15:52 ` Rich Johnston 1 sibling, 2 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-25 15:03 UTC (permalink / raw) To: xfs-oss Add valid options which aren't in manpages, and remove invalid options which are in manpages: * Document -V (show version and exit) for many manpages. * Remove -? option from xfs_estimate.8 * Document -p passes, -d (debug) and -g (syslog) in xfs_fsr.8 * Document -n (O_NONBLOCK) in xfs_io.8 * Document -v (print overwrite) in xfs_logprint.8 * Document -m max_extents in xfs_metadump.8 * Document -p (preallocate) in xfs_mkfile.8 Signed-off-by: Eric Sandeeen <sandeen@redhat.com> --- V2: move "-V" SYNOPSIS to their own line, move -V documentation to end of option documentation list diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index f707881..04c19b4 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -40,6 +40,8 @@ mkfs.xfs \- construct an XFS filesystem .B \-K ] .I device +.br +.B mkfs.xfs \-V .SH DESCRIPTION .B mkfs.xfs constructs an XFS filesystem by writing on a special @@ -728,6 +730,9 @@ creating the file system. .TP .B \-K Do not attempt to discard blocks at mkfs time. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR xfs (5), .BR mkfs (8), diff --git a/man/man8/xfs_admin.8 b/man/man8/xfs_admin.8 index 2de907b..b393d74 100644 --- a/man/man8/xfs_admin.8 +++ b/man/man8/xfs_admin.8 @@ -15,6 +15,8 @@ xfs_admin \- change parameters of an XFS filesystem .I uuid ] .I device +.br +.B xfs_admin \-V .SH DESCRIPTION .B xfs_admin uses the @@ -97,6 +99,9 @@ The may also be .BR generate , which will generate a new UUID for the filesystem. +.TP +.B \-V +Prints the version number and exits. .PP The .BR mount (8) diff --git a/man/man8/xfs_bmap.8 b/man/man8/xfs_bmap.8 index ccaa79b..e196559 100644 --- a/man/man8/xfs_bmap.8 +++ b/man/man8/xfs_bmap.8 @@ -10,6 +10,8 @@ xfs_bmap \- print block mapping for an XFS file .I num_extents ] .I file +.br +.B xfs_bmap \-V .SH DESCRIPTION .B xfs_bmap prints the map of disk blocks used by files in an XFS filesystem. @@ -91,6 +93,9 @@ A second option will print out the .I flags legend. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR xfs_fsr (8), .BR xfs (5). diff --git a/man/man8/xfs_check.8 b/man/man8/xfs_check.8 index 1654532..23027ca 100644 --- a/man/man8/xfs_check.8 +++ b/man/man8/xfs_check.8 @@ -20,6 +20,8 @@ xfs_check \- check XFS filesystem consistency .I logdev ] .I device +.br +.B xfs_check \-V .SH DESCRIPTION .B xfs_check checks whether an XFS filesystem is consistent. @@ -89,6 +91,9 @@ Conversion between disk addresses (i.e. addresses reported by and file system blocks may be accomplished using .BR xfs_db "(8)'s " convert command. +.TP +.B \-V +Prints the version number and exits. .PP Any output that is produced when .B xfs_check diff --git a/man/man8/xfs_copy.8 b/man/man8/xfs_copy.8 index 3028db8..1eaf85d 100644 --- a/man/man8/xfs_copy.8 +++ b/man/man8/xfs_copy.8 @@ -13,6 +13,8 @@ xfs_copy \- copy the contents of an XFS filesystem [ .I target2 \&... ] +.br +.B xfs_copy \-V .SH DESCRIPTION .B xfs_copy copies an XFS filesystem to one or more targets in parallel (see @@ -87,6 +89,9 @@ Specifies the location of the if the default location of .I /var/tmp/xfs_copy.log.XXXXXX is not desired. +.TP +.B \-V +Prints the version number and exits. .SH DIAGNOSTICS .B xfs_copy reports errors to both diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8 index 0558671..7a43a2c 100644 --- a/man/man8/xfs_db.8 +++ b/man/man8/xfs_db.8 @@ -103,7 +103,7 @@ and commands. .TP .B \-V -Prints out the current version number and exits. +Prints the version number and exits. .SH CONCEPTS .B xfs_db commands can be broken up into two classes. Most commands are for diff --git a/man/man8/xfs_estimate.8 b/man/man8/xfs_estimate.8 index bb458ec..2594eb8 100644 --- a/man/man8/xfs_estimate.8 +++ b/man/man8/xfs_estimate.8 @@ -3,8 +3,10 @@ xfs_estimate \- estimate the space that an XFS filesystem will take .SH SYNOPSIS .nf -\f3xfs_estimate\f1 [ \f3\-h?\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ] +\f3xfs_estimate\f1 [ \f3\-h\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ] [ \f3\-e\f1 logsize ] [ \f3\-v\f1 ] directory ... +.br +.B xfs_estimate \-V .fi .SH DESCRIPTION For each \f2directory\f1 argument, @@ -51,9 +53,6 @@ Display more information, formatted. .B \-h Display usage message. .TP -.B \-? -Display usage message. -.TP \f3\-i, \-e\f1 \f2logsize\f1 Use .I logsize @@ -77,6 +76,9 @@ For example, .IP requests an estimate of the space required by the directory / on an XFS filesystem using an internal log of 1 megabyte. +.TP +.B \-V +Print the version number and exits. .SH EXAMPLES .nf .sp 8v diff --git a/man/man8/xfs_freeze.8 b/man/man8/xfs_freeze.8 index 97c7911..c581ad7 100644 --- a/man/man8/xfs_freeze.8 +++ b/man/man8/xfs_freeze.8 @@ -2,10 +2,15 @@ .SH NAME xfs_freeze \- suspend access to an XFS filesystem .SH SYNOPSIS -.B xfs_freeze \-f +.B xfs_freeze +[ +.B \-f | .B \-u +] .I mount-point +.br +.B xfs_freeze \-V .fi .SH DESCRIPTION .B xfs_freeze @@ -25,6 +30,7 @@ is mounted. The filesystem must be mounted to be frozen (see .BR mount (8)). .PP +.PP The .B \-f flag requests the specified XFS filesystem to be @@ -48,7 +54,13 @@ operations to continue. Any filesystem modifications that were blocked by the freeze are unblocked and allowed to complete. .PP -One of +The +.B \-V +flag prints the version number and exits. +.PP +Unless +.B \-V +is specified, one of .B \-f or .B \-u diff --git a/man/man8/xfs_fsr.8 b/man/man8/xfs_fsr.8 index bf5e942..0a162b6 100644 --- a/man/man8/xfs_fsr.8 +++ b/man/man8/xfs_fsr.8 @@ -3,10 +3,12 @@ xfs_fsr \- filesystem reorganizer for XFS .SH SYNOPSIS .nf -\f3xfs_fsr\f1 [\f3\-v\f1] \c -[\f3\-t\f1 seconds] [\f3\-f\f1 leftoff] [\f3\-m\f1 mtab] -\f3xfs_fsr\f1 [\f3\-v\f1] \c +\f3xfs_fsr\f1 [\f3\-vdg\f1] \c +[\f3\-t\f1 seconds] [\f3\-p\f1 passes] [\f3\-f\f1 leftoff] [\f3\-m\f1 mtab] +\f3xfs_fsr\f1 [\f3\-vdg\f1] \c [xfsdev | file] ... +.br +.B xfs_fsr \-V .fi .SH DESCRIPTION .I xfs_fsr @@ -35,7 +37,11 @@ The default is to use .TP .BI \-t " seconds" How long to reorganize. -The default is 7200 (2 hours). +The default is 7200 seconds (2 hours). +.TP +.BI \-p " passes" +Number of passes before terminating global re-org. +The default is 10 passes. .TP .BI \-f " leftoff" Use this file instead of @@ -47,6 +53,16 @@ to store the state of where reorganization left off. Verbose. Print cryptic information about each file being reorganized. +.TP +.B \-d +Debug. Print even more cryptic information. +.TP +.B \-g +Print to syslog (default if stdout not a tty). +.TP +.B \-V +Prints the version number and exits. + .PP When invoked with no arguments .I xfs_fsr diff --git a/man/man8/xfs_growfs.8 b/man/man8/xfs_growfs.8 index b55438b..e23d30e 100644 --- a/man/man8/xfs_growfs.8 +++ b/man/man8/xfs_growfs.8 @@ -15,7 +15,7 @@ xfs_growfs, xfs_info \- expand an XFS filesystem .SH SYNOPSIS .B xfs_growfs [ -.B \-dilnrxV +.B \-dilnrx ] [ .B \-D .I size @@ -37,12 +37,17 @@ xfs_growfs, xfs_info \- expand an XFS filesystem ] .I mount-point .br +.B xfs_growfs \-V +.PP +.br .B xfs_info [ .B \-t .I mtab ] .I mount-point +.br +.B xfs_info \-V .SH DESCRIPTION .B xfs_growfs expands an existing XFS filesystem (see diff --git a/man/man8/xfs_io.8 b/man/man8/xfs_io.8 index 33a5944..5e3535b 100644 --- a/man/man8/xfs_io.8 +++ b/man/man8/xfs_io.8 @@ -13,6 +13,8 @@ xfs_io \- debug the I/O path of an XFS filesystem .I prog ] .I file +.br +.B xfs_io \-V .SH DESCRIPTION .B xfs_io is a debugging tool like @@ -52,6 +54,9 @@ is immutable or append-only. .B \-x Expert mode. Dangerous commands are only available in this mode. These commands also tend to require additional privileges. +.TP +.B \-V +Prints the version number and exits. .PP The other .BR open (2) @@ -111,6 +116,9 @@ opens for synchronous I/O (O_SYNC). .B \-t truncates on open (O_TRUNC). .TP +.B \-n +opens in non-blocking mode if possible (O_NONBLOCK). +.TP .B \-R marks the file as a realtime XFS file after opening it, if it is not already marked as such. diff --git a/man/man8/xfs_logprint.8 b/man/man8/xfs_logprint.8 index c1a8077..16e881e 100644 --- a/man/man8/xfs_logprint.8 +++ b/man/man8/xfs_logprint.8 @@ -97,6 +97,12 @@ Override any notion of where to start printing. .TP .B \-t Print out the transactional view. +.TP +.B \-v +Print "overwrite" data. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR mkfs.xfs (8), .BR mount (8). diff --git a/man/man8/xfs_mdrestore.8 b/man/man8/xfs_mdrestore.8 index 7b9ba89..51297c4 100644 --- a/man/man8/xfs_mdrestore.8 +++ b/man/man8/xfs_mdrestore.8 @@ -8,6 +8,8 @@ xfs_mdrestore \- restores an XFS metadump image to a filesystem image ] .I source .I target +.br +.B xfs_mdrestore \-V .SH DESCRIPTION .B xfs_mdrestore is a debugging tool that restores a metadata image generated by @@ -36,6 +38,9 @@ can be destroyed. .TP .B \-g Shows restore progress on stdout. +.TP +.B \-V +Prints the version number and exits. .SH DIAGNOSTICS .B xfs_mdrestore returns an exit code of 0 if all the metadata is successfully restored or diff --git a/man/man8/xfs_metadump.8 b/man/man8/xfs_metadump.8 index 9672713..26cea97 100644 --- a/man/man8/xfs_metadump.8 +++ b/man/man8/xfs_metadump.8 @@ -6,11 +6,17 @@ xfs_metadump \- copy XFS filesystem metadata to a file [ .B \-efgow ] [ +.B \-m +.I max_extents +] +] [ .B \-l .I logdev ] .I source .I target +.br +.B xfs_metadump \-V .SH DESCRIPTION .B xfs_metadump is a debugging tool that copies the metadata from an XFS filesystem to a file. @@ -94,12 +100,20 @@ For filesystems which use an external log, this specifies the device where the external log resides. The external log is not copied, only internal logs are copied. .TP +.B \-m +Set the maximum size of an allowed metadata extent. Extremely large metadata +extents are likely to be corrupt, and will be skipped if they exceed +this value. The default size is 1000 blocks. +.TP .B \-o Disables obfuscation of file names and extended attributes. .TP .B \-w Prints warnings of inconsistent metadata encountered to stderr. Bad metadata is still copied. +.TP +.B \-V +Prints the version number and exits. .SH DIAGNOSTICS .B xfs_metadump returns an exit code of 0 if all readable metadata is successfully copied or diff --git a/man/man8/xfs_mkfile.8 b/man/man8/xfs_mkfile.8 index 96f443f..abaa4e6 100644 --- a/man/man8/xfs_mkfile.8 +++ b/man/man8/xfs_mkfile.8 @@ -7,10 +7,14 @@ xfs_mkfile \- create an XFS file .B \-v ] [ .B \-n +] [ +.B \-p ] .I size\c .RB [ k | b | m | g ] .IR filename " ..." +.br +.B xfs_mkfile \-V .SH DESCRIPTION .B xfs_mkfile creates one or more files. The file is padded with zeroes by default. @@ -30,3 +34,10 @@ Verbose. Report the names and sizes of created files. .B \-n No bytes. Create a holey file - that is, do not write out any data, just seek to end of file and write a block. +.TP +.B \-p +Preallocate. The file is preallocated, then overwritten with zeroes, +then truncated to the desired size. +.TP +.B \-V +Prints the version number and exits. diff --git a/man/man8/xfs_ncheck.8 b/man/man8/xfs_ncheck.8 index 408919d..4099772 100644 --- a/man/man8/xfs_ncheck.8 +++ b/man/man8/xfs_ncheck.8 @@ -15,6 +15,8 @@ xfs_ncheck \- generate pathnames from i-numbers for XFS .I logdev ] .I device +.br +.B xfs_ncheck \-V .SH DESCRIPTION .B xfs_ncheck with no @@ -56,6 +58,9 @@ This option may be used to detect violations of security policy. .BI \-i " ino" Limits the report to only those files whose inode numbers follow. May be given multiple times to select multiple inode numbers. +.TP +.B \-V +Prints the version number and exits. .PP If the filesystem is seriously corrupted, or very busy and looks like it is corrupt, a message of the form that would be generated by diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8 index 9327feb..8cc8ab7 100644 --- a/man/man8/xfs_quota.8 +++ b/man/man8/xfs_quota.8 @@ -16,6 +16,8 @@ xfs_quota \- manage use of quota on XFS filesystems .I project ] ... [ .IR path " ... ]" +.br +.B xfs_quota \-V .SH DESCRIPTION .B xfs_quota is a utility for reporting and editing various aspects of filesystem quota. @@ -50,6 +52,9 @@ which restricts the output of the individual commands to the set of projects specified. Multiple .B \-d arguments may be given. +.TP +.B \-V +Prints the version number and exits. .PP The optional .I path diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8 index 7b296ba..96adb29 100644 --- a/man/man8/xfs_repair.8 +++ b/man/man8/xfs_repair.8 @@ -173,7 +173,7 @@ to repair an XFS filesystem mounted read only. This is typically done on a root filesystem from single user mode, immediately followed by a reboot. .TP .B \-V -Prints out the current version number and exits. +Prints the version number and exits. .SS Checks Performed Inconsistencies corrected include the following: .IP 1. diff --git a/man/man8/xfs_rtcp.8 b/man/man8/xfs_rtcp.8 index be81cb3..40e9097 100644 --- a/man/man8/xfs_rtcp.8 +++ b/man/man8/xfs_rtcp.8 @@ -10,6 +10,8 @@ xfs_rtcp \- XFS realtime copy command .B -p ] .IR source " ... " target +.br +.B xfs_rtcp \-V .SH DESCRIPTION .B xfs_rtcp copies a file to the realtime partition on an XFS filesystem. @@ -35,6 +37,9 @@ will pad the destination file to a size which is an even multiple of the filesystem block size. This is necessary since the realtime file is created using direct I/O and the minimum I/O is the filesystem block size. +.TP +.B \-V +Prints the version number and exits. .SH SEE ALSO .BR xfs (5), .BR mkfs.xfs (8), _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: [PATCH 2/3 V2] xfsprogs: Fix manpages for missing or incorrect options 2013-04-25 15:03 ` [PATCH 2/3 V2] " Eric Sandeen @ 2013-04-25 15:26 ` Rich Johnston 2013-04-25 15:52 ` Rich Johnston 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-25 15:26 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss Thanks Eric for posing V2. Looks good. Reviewed-by: Rich Johnston <rjohnston@sgi.com> _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 2/3 V2] xfsprogs: Fix manpages for missing or incorrect options 2013-04-25 15:03 ` [PATCH 2/3 V2] " Eric Sandeen 2013-04-25 15:26 ` Rich Johnston @ 2013-04-25 15:52 ` Rich Johnston 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-25 15:52 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss Thanks Eric for V2, it has been committed. --Rich commit eaa6a2bf5940dfa5e7a295834e68f317d4686218 Author: Eric Sandeen <sandeen@sandeen.net> Date: Thu Apr 25 15:03:47 2013 +0000 xfsprogs: Fix manpages for missing or incorrect options _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions 2013-04-22 22:37 [PATCH 0/3] xfsprogs: manpage & usage string fixups Eric Sandeen 2013-04-22 22:39 ` [PATCH 1/3] xfsprogs: manpage spelling fixes Eric Sandeen 2013-04-22 22:40 ` [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options Eric Sandeen @ 2013-04-22 22:42 ` Eric Sandeen 2013-04-23 19:37 ` Rich Johnston 2013-04-25 15:16 ` [PATCH 3/3 V2] " Eric Sandeen 2 siblings, 2 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-22 22:42 UTC (permalink / raw) To: xfs-oss Add missing options and remove invalid options in usage() output strings. * Add -V to several usage() strings * Remove deprecated/invalid -n and -s otions from xfs_fsr's usage * Remove invalid -I option from xfs_growfs's usage * Add -n (O_NONBLOCK) option to xfs_io's usage * Add -e (exit on error) option to xfs_logprint's usage * Remove invalid -b option from xfs_mdrestore's usage * Add -N (no-op), -K (no discard), and -f (force) to mkfs.xfs's usage * Add -x (expert) option to xfs_quota's usage Signed-off-by: Eric Sandeen <sandeen@redhat.com> --- diff --git a/copy/xfs_copy.c b/copy/xfs_copy.c index c01e0b9..7f65de3 100644 --- a/copy/xfs_copy.c +++ b/copy/xfs_copy.c @@ -301,7 +301,7 @@ void usage(void) { fprintf(stderr, - _("Usage: %s [-bd] [-L logfile] source target [target ...]\n"), + _("Usage: %s [-bdV] [-L logfile] source target [target ...]\n"), progname); exit(1); } diff --git a/db/init.c b/db/init.c index 2a31cb8..0e9e1a2 100644 --- a/db/init.c +++ b/db/init.c @@ -43,7 +43,7 @@ static void usage(void) { fprintf(stderr, _( - "Usage: %s [-fFrxV] [-p prog] [-l logdev] [-c cmd]... device\n" + "Usage: %s [-ifFrxV] [-p prog] [-l logdev] [-c cmd]... device\n" ), progname); exit(1); } diff --git a/fsr/xfs_fsr.c b/fsr/xfs_fsr.c index 3d017ca..2440bab 100644 --- a/fsr/xfs_fsr.c +++ b/fsr/xfs_fsr.c @@ -386,12 +386,9 @@ void usage(int ret) { fprintf(stderr, _( -"Usage: %s [-d] [-v] [-n] [-s] [-g] [-t time] [-p passes] [-f leftf] [-m mtab]\n" -" %s [-d] [-v] [-n] [-s] [-g] xfsdev | dir | file ...\n\n" +"Usage: %s [-d] [-v] [-g] [-t time] [-p passes] [-f leftf] [-m mtab]\n" +" %s [-d] [-v] [-g] xfsdev | dir | file ...\n\n" "Options:\n" -" -n Do nothing, only interesting with -v. Not\n" -" effective with in mtab mode.\n" -" -s Print statistics only.\n" " -g Print to syslog (default if stdout not a tty).\n" " -t time How long to run in seconds.\n" " -p passes Number of passes before terminating global re-org.\n" diff --git a/growfs/xfs_growfs.c b/growfs/xfs_growfs.c index a6d298b..5d544da 100644 --- a/growfs/xfs_growfs.c +++ b/growfs/xfs_growfs.c @@ -19,14 +19,6 @@ #include <xfs/libxfs.h> #include <xfs/path.h> -/* - * When growing a filesystem, this is the most significant - * bits we'll accept in the resulting inode numbers - * without warning the user. - */ - -#define XFS_MAX_INODE_SIG_BITS 32 - static void usage(void) { @@ -37,7 +29,6 @@ Options:\n\ -l grow log section\n\ -r grow realtime section\n\ -n don't change anything, just show geometry\n\ - -I allow inode numbers to exceed %d significant bits\n\ -i convert log from external to internal format\n\ -t alternate location for mount table (/etc/mtab)\n\ -x convert log from internal to external format\n\ @@ -47,7 +38,7 @@ Options:\n\ -e size set realtime extent size to size blks\n\ -m imaxpct set inode max percent to imaxpct\n\ -V print version information\n"), - progname, XFS_MAX_INODE_SIG_BITS); + progname); exit(2); } diff --git a/io/init.c b/io/init.c index fb93082..ca3055a 100644 --- a/io/init.c +++ b/io/init.c @@ -32,7 +32,7 @@ void usage(void) { fprintf(stderr, - _("Usage: %s [-adfmrRstx] [-p prog] [-c cmd]... file\n"), + _("Usage: %s [-adfmnrRstVx] [-p prog] [-c cmd]... file\n"), progname); exit(1); } diff --git a/io/xfs_freeze.sh b/io/xfs_freeze.sh index 45e20d2..647aa96 100644 --- a/io/xfs_freeze.sh +++ b/io/xfs_freeze.sh @@ -4,7 +4,7 @@ # OPTS="" -USAGE="Usage: xfs_freeze -f | -u <mountpoint>" +USAGE="Usage: xfs_freeze [-V] [-f | -u] <mountpoint>" DIRNAME=`dirname $0` VERSION=false FREEZE=false diff --git a/logprint/logprint.c b/logprint/logprint.c index 482fd4e..0923b0a 100644 --- a/logprint/logprint.c +++ b/logprint/logprint.c @@ -44,6 +44,7 @@ Options:\n\ -c try to continue if error found in log\n\ -C <filename> copy the log from the filesystem to filename\n\ -d dump the log in log-record format\n\ + -e exit when an error is found in the log\n\ -f specified device is actually a file\n\ -l <device> filename of external log\n\ -n don't try and interpret log data\n\ diff --git a/mdrestore/xfs_mdrestore.c b/mdrestore/xfs_mdrestore.c index 509a3ed..479e677 100644 --- a/mdrestore/xfs_mdrestore.c +++ b/mdrestore/xfs_mdrestore.c @@ -178,7 +178,7 @@ perform_restore( static void usage(void) { - fprintf(stderr, "Usage: %s [-bg] source target\n", progname); + fprintf(stderr, "Usage: %s [-V] [-g] source target\n", progname); exit(1); } diff --git a/mkfs/xfs_mkfs.c b/mkfs/xfs_mkfs.c index c57a855..09b5d5b 100644 --- a/mkfs/xfs_mkfs.c +++ b/mkfs/xfs_mkfs.c @@ -2911,6 +2911,9 @@ usage( void ) /* realtime subvol */ [-r extsize=num,size=num,rtdev=xxx]\n\ /* sectorsize */ [-s log=n|size=num]\n\ /* version */ [-V]\n\ +/* no-op info only */ [-N]\n\ +/* no discard */ [-K]\n\ +/* force overwrite */ [-f]\n\ devicename\n\ <devicename> is required unless -d name=xxx is given.\n\ <num> is xxx (bytes), xxxs (sectors), xxxb (fs blocks), xxxk (xxx KiB),\n\ diff --git a/quota/init.c b/quota/init.c index 0b481f7..aa99b1b 100644 --- a/quota/init.c +++ b/quota/init.c @@ -45,7 +45,7 @@ static void usage(void) { fprintf(stderr, - _("Usage: %s [-p prog] [-c cmd]... [-d project]... [path]\n"), + _("Usage: %s [-x] [-p prog] [-c cmd]... [-d project]... [path]\n"), progname); exit(1); } diff --git a/rtcp/xfs_rtcp.c b/rtcp/xfs_rtcp.c index 6ea7ab9..f0b5936 100644 --- a/rtcp/xfs_rtcp.c +++ b/rtcp/xfs_rtcp.c @@ -27,7 +27,7 @@ char *progname; void usage() { - fprintf(stderr, _("%s [-e extsize] [-p] source target\n"), progname); + fprintf(stderr, _("%s [-e extsize] [-p] [-V] source target\n"), progname); exit(2); } _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions 2013-04-22 22:42 ` [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions Eric Sandeen @ 2013-04-23 19:37 ` Rich Johnston 2013-04-25 15:16 ` [PATCH 3/3 V2] " Eric Sandeen 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-23 19:37 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss On 04/22/2013 05:42 PM, Eric Sandeen wrote: > Add missing options and remove invalid options in usage() output > strings. > > * Add -V to several usage() strings Need to add it for xfs_estimate xfs_fsr xfs_quota I ran this. MYCMDS="mkfs.xfs xfs_admin xfs_bmap xfs_check xfs_copy xfs_db xfs_estimate xfs_freeze xfs_fsr xfs_growfs xfs_info xfs_io xfs_logprint xfs_mdrestore xfs_metadump xfs_mkfile xfs_ncheck xfs_quota xfs_rtcp" for i in $MYCMDS; do $i -h echo done Here are the cmds that are missing -V: > mkfs.xfs: invalid option -- 'h' > unknown option -h > Usage: mkfs.xfs > /* blocksize */ [-b log=n|size=num] > /* data subvol */ [-d agcount=n,agsize=n,file,name=xxx,size=num, > (sunit=value,swidth=value|su=num,sw=num), > sectlog=n|sectsize=num > /* inode size */ [-i log=n|perblock=n|size=num,maxpct=n,attr=0|1|2, > projid32bit=0|1] > /* log subvol */ [-l agnum=n,internal,size=num,logdev=xxx,version=n > sunit=value|su=num,sectlog=n|sectsize=num, > lazy-count=0|1] > /* label */ [-L label (maximum 12 characters)] > /* naming */ [-n log=n|size=num,version=2|ci] > /* prototype file */ [-p fname] > /* quiet */ [-q] > /* realtime subvol */ [-r extsize=num,size=num,rtdev=xxx] > /* sectorsize */ [-s log=n|size=num] > /* version */ [-V] > /* no-op info only */ [-N] > /* no discard */ [-K] > /* force overwrite */ [-f] > devicename > <devicename> is required unless -d name=xxx is given. > <num> is xxx (bytes), xxxs (sectors), xxxb (fs blocks), xxxk (xxx KiB), > xxxm (xxx MiB), xxxg (xxx GiB), xxxt (xxx TiB) or xxxp (xxx PiB). > <value> is xxx (512 byte blocks). > #rcj mkfs.xfs missing -V > Usage: xfs_estimate [opts] directory [directory ...] > -b blocksize (fundamental filesystem blocksize) > -i logsize (internal log size) > -e logsize (external log size) > -v prints more verbose messages > -h prints this usage message > > Note: blocksize may have 'k' appended to indicate x1024 > logsize may also have 'm' appended to indicate (1024 x 1024) #rcj xfs_estimate missing -V > xfs_fsr: invalid option -- 'h' > Usage: xfs_fsr [-d] [-v] [-g] [-t time] [-p passes] [-f leftf] [-m mtab] > xfs_fsr [-d] [-v] [-g] xfsdev | dir | file ... > > Options: > -g Print to syslog (default if stdout not a tty). > -t time How long to run in seconds. > -p passes Number of passes before terminating global re-org. > -f leftoff Use this instead of /var/tmp/.fsrlast_xfs. > -m mtab Use something other than /etc/mtab. > -d Debug, print even more. > -v Verbose, more -v's more verbose. > #rcj xfs_fsr missing -V > xfs_quota: invalid option -- 'h' > Usage: xfs_quota [-x] [-p prog] [-c cmd]... [-d project]... [path] #rcj missing -V _______________________________________________________________________ All commands report the version. MYCMDS="mkfs.xfs xfs_admin xfs_bmap xfs_check xfs_copy xfs_db xfs_estimate xfs_freeze xfs_fsr xfs_growfs xfs_info xfs_io xfs_logprint xfs_mdrestore xfs_metadump xfs_mkfile xfs_ncheck xfs_quota xfs_rtcp" for i in $MYCMDS; do $i -V done mkfs.xfs version 3.1.10 xfs_admin version 3.1.10 xfs_bmap version 3.1.10 xfs_check is deprecated and scheduled for removal in June 2014. Please use xfs_repair -n <dev> instead. xfs_check version 3.1.10 xfs_copy version 3.1.10 xfs_db version 3.1.10 xfs_estimate version 3.1.10 xfs_freeze version 3.1.10 xfs_fsr version 3.1.10 xfs_growfs version 3.1.10 xfs_info version 3.1.10 xfs_io version 3.1.10 xfs_logprint version 3.1.10 xfs_mdrestore version 3.1.10 xfs_metadump version 3.1.10 xfs_mkfile version 3.1.10 xfs_ncheck version 3.1.10 xfs_quota version 3.1.10 xfs_rtcp version 3.1.10 > * Remove deprecated/invalid -n and -s otions from xfs_fsr's usage #rcj OK > * Remove invalid -I option from xfs_growfs's usage #rcj OK > * Add -n (O_NONBLOCK) option to xfs_io's usage #rcj OK > * Add -e (exit on error) option to xfs_logprint's usage #rcj OK > * Remove invalid -b option from xfs_mdrestore's usage #rcj OK > * Add -N (no-op), -K (no discard), and -f (force) to mkfs.xfs's usage Usage: mkfs.xfs /* blocksize */ [-b log=n|size=num] /* data subvol */ [-d agcount=n,agsize=n,file,name=xxx,size=num, (sunit=value,swidth=value|su=num,sw=num), sectlog=n|sectsize=num /* force overwrite */ [-f] devicename #rcj move to here ????? /* inode size */ [-i log=n|perblock=n|size=num,maxpct=n,attr=0|1|2, projid32bit=0|1] /* no discard */ [-K] #rcj move to here ???? /* log subvol */ [-l agnum=n,internal,size=num,logdev=xxx,version=n sunit=value|su=num,sectlog=n|sectsize=num, lazy-count=0|1] /* label */ [-L label (maximum 12 characters)] /* naming */ [-n log=n|size=num,version=2|ci] /* no-op info only */ [-N] #rcj move to here ???? /* prototype file */ [-p fname] /* quiet */ [-q] /* realtime subvol */ [-r extsize=num,size=num,rtdev=xxx] /* sectorsize */ [-s log=n|size=num] /* version */ [-V] > * Add -x (expert) option to xfs_quota's usage #rcj OK Regards --Rich _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* [PATCH 3/3 V2] xfsprogs: Fix up usage() errors and omissions 2013-04-22 22:42 ` [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions Eric Sandeen 2013-04-23 19:37 ` Rich Johnston @ 2013-04-25 15:16 ` Eric Sandeen 2013-04-25 16:13 ` Rich Johnston 2013-04-25 16:15 ` Rich Johnston 1 sibling, 2 replies; 22+ messages in thread From: Eric Sandeen @ 2013-04-25 15:16 UTC (permalink / raw) To: xfs-oss Add missing options and remove invalid options in usage() output strings. * Add -V to several usage() strings * Remove deprecated/invalid -n and -s otions from xfs_fsr's usage * Remove invalid -I option from xfs_growfs's usage * Add -n (O_NONBLOCK) option to xfs_io's usage * Add -e (exit on error) option to xfs_logprint's usage * Remove invalid -b option from xfs_mdrestore's usage * Add -N (no-op), -K (no discard), and -f (force) to mkfs.xfs's usage * Add -x (expert) option to xfs_quota's usage Signed-off-by: Eric Sandeen <sandeen@redhat.com> --- V2: address Rich's nitpicky review ;) (i.e. fix good stuff) diff --git a/copy/xfs_copy.c b/copy/xfs_copy.c index c01e0b9..7f65de3 100644 --- a/copy/xfs_copy.c +++ b/copy/xfs_copy.c @@ -301,7 +301,7 @@ void usage(void) { fprintf(stderr, - _("Usage: %s [-bd] [-L logfile] source target [target ...]\n"), + _("Usage: %s [-bdV] [-L logfile] source target [target ...]\n"), progname); exit(1); } diff --git a/db/init.c b/db/init.c index 2a31cb8..0e9e1a2 100644 --- a/db/init.c +++ b/db/init.c @@ -43,7 +43,7 @@ static void usage(void) { fprintf(stderr, _( - "Usage: %s [-fFrxV] [-p prog] [-l logdev] [-c cmd]... device\n" + "Usage: %s [-ifFrxV] [-p prog] [-l logdev] [-c cmd]... device\n" ), progname); exit(1); } diff --git a/estimate/xfs_estimate.c b/estimate/xfs_estimate.c index 54a72e9..ddc6f62 100644 --- a/estimate/xfs_estimate.c +++ b/estimate/xfs_estimate.c @@ -78,6 +78,7 @@ usage(char *progname) "\t-i logsize (internal log size)\n" "\t-e logsize (external log size)\n" "\t-v prints more verbose messages\n" + "\t-V prints version and exits\n" "\t-h prints this usage message\n\n" "Note:\tblocksize may have 'k' appended to indicate x1024\n" "\tlogsize may also have 'm' appended to indicate (1024 x 1024)\n"), diff --git a/fsr/xfs_fsr.c b/fsr/xfs_fsr.c index 3d017ca..6852b3f 100644 --- a/fsr/xfs_fsr.c +++ b/fsr/xfs_fsr.c @@ -386,20 +386,19 @@ void usage(int ret) { fprintf(stderr, _( -"Usage: %s [-d] [-v] [-n] [-s] [-g] [-t time] [-p passes] [-f leftf] [-m mtab]\n" -" %s [-d] [-v] [-n] [-s] [-g] xfsdev | dir | file ...\n\n" +"Usage: %s [-d] [-v] [-g] [-t time] [-p passes] [-f leftf] [-m mtab]\n" +" %s [-d] [-v] [-g] xfsdev | dir | file ...\n" +" %s -V\n\n" "Options:\n" -" -n Do nothing, only interesting with -v. Not\n" -" effective with in mtab mode.\n" -" -s Print statistics only.\n" " -g Print to syslog (default if stdout not a tty).\n" " -t time How long to run in seconds.\n" -" -p passes Number of passes before terminating global re-org.\n" +" -p passes Number of passes before terminating global re-org.\n" " -f leftoff Use this instead of %s.\n" " -m mtab Use something other than /etc/mtab.\n" " -d Debug, print even more.\n" -" -v Verbose, more -v's more verbose.\n" - ), progname, progname, _PATH_FSRLAST); +" -v Verbose, more -v's more verbose.\n" +" -V Print version number and exit.\n" + ), progname, progname, progname, _PATH_FSRLAST); exit(ret); } diff --git a/growfs/xfs_growfs.c b/growfs/xfs_growfs.c index a6d298b..5d544da 100644 --- a/growfs/xfs_growfs.c +++ b/growfs/xfs_growfs.c @@ -19,14 +19,6 @@ #include <xfs/libxfs.h> #include <xfs/path.h> -/* - * When growing a filesystem, this is the most significant - * bits we'll accept in the resulting inode numbers - * without warning the user. - */ - -#define XFS_MAX_INODE_SIG_BITS 32 - static void usage(void) { @@ -37,7 +29,6 @@ Options:\n\ -l grow log section\n\ -r grow realtime section\n\ -n don't change anything, just show geometry\n\ - -I allow inode numbers to exceed %d significant bits\n\ -i convert log from external to internal format\n\ -t alternate location for mount table (/etc/mtab)\n\ -x convert log from internal to external format\n\ @@ -47,7 +38,7 @@ Options:\n\ -e size set realtime extent size to size blks\n\ -m imaxpct set inode max percent to imaxpct\n\ -V print version information\n"), - progname, XFS_MAX_INODE_SIG_BITS); + progname); exit(2); } diff --git a/io/init.c b/io/init.c index fb93082..ca3055a 100644 --- a/io/init.c +++ b/io/init.c @@ -32,7 +32,7 @@ void usage(void) { fprintf(stderr, - _("Usage: %s [-adfmrRstx] [-p prog] [-c cmd]... file\n"), + _("Usage: %s [-adfmnrRstVx] [-p prog] [-c cmd]... file\n"), progname); exit(1); } diff --git a/io/xfs_freeze.sh b/io/xfs_freeze.sh index 45e20d2..647aa96 100644 --- a/io/xfs_freeze.sh +++ b/io/xfs_freeze.sh @@ -4,7 +4,7 @@ # OPTS="" -USAGE="Usage: xfs_freeze -f | -u <mountpoint>" +USAGE="Usage: xfs_freeze [-V] [-f | -u] <mountpoint>" DIRNAME=`dirname $0` VERSION=false FREEZE=false diff --git a/logprint/logprint.c b/logprint/logprint.c index 482fd4e..0923b0a 100644 --- a/logprint/logprint.c +++ b/logprint/logprint.c @@ -44,6 +44,7 @@ Options:\n\ -c try to continue if error found in log\n\ -C <filename> copy the log from the filesystem to filename\n\ -d dump the log in log-record format\n\ + -e exit when an error is found in the log\n\ -f specified device is actually a file\n\ -l <device> filename of external log\n\ -n don't try and interpret log data\n\ diff --git a/mdrestore/xfs_mdrestore.c b/mdrestore/xfs_mdrestore.c index 509a3ed..479e677 100644 --- a/mdrestore/xfs_mdrestore.c +++ b/mdrestore/xfs_mdrestore.c @@ -178,7 +178,7 @@ perform_restore( static void usage(void) { - fprintf(stderr, "Usage: %s [-bg] source target\n", progname); + fprintf(stderr, "Usage: %s [-V] [-g] source target\n", progname); exit(1); } diff --git a/mkfs/xfs_mkfs.c b/mkfs/xfs_mkfs.c index c57a855..a393607 100644 --- a/mkfs/xfs_mkfs.c +++ b/mkfs/xfs_mkfs.c @@ -2899,13 +2899,16 @@ usage( void ) /* data subvol */ [-d agcount=n,agsize=n,file,name=xxx,size=num,\n\ (sunit=value,swidth=value|su=num,sw=num),\n\ sectlog=n|sectsize=num\n\ +/* force overwrite */ [-f]\n\ /* inode size */ [-i log=n|perblock=n|size=num,maxpct=n,attr=0|1|2,\n\ projid32bit=0|1]\n\ +/* no discard */ [-K]\n\ /* log subvol */ [-l agnum=n,internal,size=num,logdev=xxx,version=n\n\ sunit=value|su=num,sectlog=n|sectsize=num,\n\ lazy-count=0|1]\n\ /* label */ [-L label (maximum 12 characters)]\n\ /* naming */ [-n log=n|size=num,version=2|ci]\n\ +/* no-op info only */ [-N]\n\ /* prototype file */ [-p fname]\n\ /* quiet */ [-q]\n\ /* realtime subvol */ [-r extsize=num,size=num,rtdev=xxx]\n\ diff --git a/quota/init.c b/quota/init.c index 0b481f7..639e9e7 100644 --- a/quota/init.c +++ b/quota/init.c @@ -45,7 +45,7 @@ static void usage(void) { fprintf(stderr, - _("Usage: %s [-p prog] [-c cmd]... [-d project]... [path]\n"), + _("Usage: %s [-V] [-x] [-p prog] [-c cmd]... [-d project]... [path]\n"), progname); exit(1); } diff --git a/rtcp/xfs_rtcp.c b/rtcp/xfs_rtcp.c index 6ea7ab9..f0b5936 100644 --- a/rtcp/xfs_rtcp.c +++ b/rtcp/xfs_rtcp.c @@ -27,7 +27,7 @@ char *progname; void usage() { - fprintf(stderr, _("%s [-e extsize] [-p] source target\n"), progname); + fprintf(stderr, _("%s [-e extsize] [-p] [-V] source target\n"), progname); exit(2); } _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: [PATCH 3/3 V2] xfsprogs: Fix up usage() errors and omissions 2013-04-25 15:16 ` [PATCH 3/3 V2] " Eric Sandeen @ 2013-04-25 16:13 ` Rich Johnston 2013-04-25 16:15 ` Rich Johnston 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-25 16:13 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss On 04/25/2013 10:16 AM, Eric Sandeen wrote: > Add missing options and remove invalid options in usage() output > strings. > > * Add -V to several usage() strings > * Remove deprecated/invalid -n and -s otions from xfs_fsr's usage > * Remove invalid -I option from xfs_growfs's usage > * Add -n (O_NONBLOCK) option to xfs_io's usage > * Add -e (exit on error) option to xfs_logprint's usage > * Remove invalid -b option from xfs_mdrestore's usage > * Add -N (no-op), -K (no discard), and -f (force) to mkfs.xfs's usage > * Add -x (expert) option to xfs_quota's usage > > Signed-off-by: Eric Sandeen <sandeen@redhat.com> > --- > > V2: address Rich's nitpicky review ;) (i.e. fix good stuff) Thanks again for V2. Looks good. Reviewed-by: Rich Johnston <rjohnston@sgi.com> _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: [PATCH 3/3 V2] xfsprogs: Fix up usage() errors and omissions 2013-04-25 15:16 ` [PATCH 3/3 V2] " Eric Sandeen 2013-04-25 16:13 ` Rich Johnston @ 2013-04-25 16:15 ` Rich Johnston 1 sibling, 0 replies; 22+ messages in thread From: Rich Johnston @ 2013-04-25 16:15 UTC (permalink / raw) To: Eric Sandeen; +Cc: xfs-oss Thanks Eric, this has been committed. --Rich commit 30626ef667746c51a6b93e21fc95eb5607c0002a Author: Eric Sandeen <sandeen@sandeen.net> Date: Thu Apr 25 15:16:34 2013 +0000 xfsprogs: Fix up usage() errors and omissions _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs ^ permalink raw reply [flat|nested] 22+ messages in thread
end of thread, other threads:[~2013-04-25 20:43 UTC | newest] Thread overview: 22+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2013-04-22 22:37 [PATCH 0/3] xfsprogs: manpage & usage string fixups Eric Sandeen 2013-04-22 22:39 ` [PATCH 1/3] xfsprogs: manpage spelling fixes Eric Sandeen 2013-04-23 15:18 ` Rich Johnston 2013-04-23 15:43 ` Dave Howorth 2013-04-23 15:59 ` Rich Johnston 2013-04-23 16:20 ` Stefan Ring 2013-04-23 19:36 ` Eric Sandeen 2013-04-25 14:12 ` [PATCH 1/3 V2] " Eric Sandeen 2013-04-25 14:59 ` Rich Johnston 2013-04-25 20:43 ` Rich Johnston 2013-04-22 22:40 ` [PATCH 2/3] xfsprogs: Fix manpages for missing or incorrect options Eric Sandeen 2013-04-23 18:35 ` Rich Johnston 2013-04-23 19:36 ` Eric Sandeen 2013-04-23 19:45 ` Rich Johnston 2013-04-25 15:03 ` [PATCH 2/3 V2] " Eric Sandeen 2013-04-25 15:26 ` Rich Johnston 2013-04-25 15:52 ` Rich Johnston 2013-04-22 22:42 ` [PATCH 3/3] xfsprogs: Fix up usage() errors and omissions Eric Sandeen 2013-04-23 19:37 ` Rich Johnston 2013-04-25 15:16 ` [PATCH 3/3 V2] " Eric Sandeen 2013-04-25 16:13 ` Rich Johnston 2013-04-25 16:15 ` Rich Johnston
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.