]> git.michaelhowe.org Git - packages/o/openafs.git/commitdiff
doc: document the version subcommand
authorMichael Meffie <mmeffie@sinenomine.net>
Wed, 21 May 2014 21:27:47 +0000 (17:27 -0400)
committerStephan Wiesand <stephan.wiesand@desy.de>
Wed, 18 Nov 2015 15:22:36 +0000 (10:22 -0500)
Document the built-in version sub-command which displays
the OpenAFS version string. This sub-command is provided
by the cmd library.

Document the switch style -version option provided by the cmd
library for the initcmd based commands: afsmonitor, scout,
xstat_fs_test, and xstat_cm_test.

Reviewed-on: http://gerrit.openafs.org/11161
Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
Tested-by: BuildBot <buildbot@rampaginggeek.com>
(cherry picked from commit ed52ea68c661a7428baeddeca2d95972fe3fe618)

Change-Id: Ie7a5194b8c407c8899ae71f168dfbaf5b47a3ae5
Reviewed-on: http://gerrit.openafs.org/12096
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Mark Vitale <mvitale@sinenomine.net>
Reviewed-by: Stephan Wiesand <stephan.wiesand@desy.de>
doc/man-pages/pod1/afsmonitor.pod
doc/man-pages/pod1/fs.pod
doc/man-pages/pod1/pts.pod
doc/man-pages/pod1/scout.pod
doc/man-pages/pod1/xstat_cm_test.pod
doc/man-pages/pod1/xstat_fs_test.pod
doc/man-pages/pod5/afsmonitor.pod
doc/man-pages/pod8/backup.pod
doc/man-pages/pod8/bos.pod
doc/man-pages/pod8/kas.pod

index 23d9ed1798471ff10ac4976f6c504deec6a420a3..2efb6bef32292908d0d38585d9de238ed3ba1f0f 100644 (file)
@@ -13,7 +13,7 @@ B<afsmonitor> [B<initcmd>] [-config <I<configuration file>>]
     S<<< [B<-debug> <I<debug output file>>] >>>
     S<<< [B<-fshosts> <I<list of file servers to monitor>>+] >>>
     S<<< [B<-cmhosts> <I<list of cache managers to monitor>>+] >>>
-    S<<< [B<-buffers> <I<number of buffer slots>>] >>> [B<-help>]
+    S<<< [B<-buffers> <I<number of buffer slots>>] >>> [B<-version>] [B<-help>]
 
 B<afsmonitor> [B<i>]  [-co <I<configuration file>>]
     S<<< [B<-fr> <I<poll frequency, in seconds>>] >>>
@@ -21,7 +21,7 @@ B<afsmonitor> [B<i>]  [-co <I<configuration file>>]
     S<<< [B<-deb> <I<debug output file>>] >>>
     S<<< [B<-fs> <I<list of file servers to monitor>>+] >>>
     S<<< [B<-cm> <I<list of cache managers to monitor>>+] >>>
-    S<<< [B<-b> <I<number of buffer slots>>] >>> [B<-h>]
+    S<<< [B<-b> <I<number of buffer slots>>] >>> [B<-version>] [B<-h>]
 
 =for html
 </div>
@@ -168,6 +168,11 @@ enhancements to the program.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 OUTPUT
index 266505b58941635b27cd8c933eaf3e87ea025008..6364796617cd5cf05df59da53819262ddf9441b9 100644 (file)
@@ -99,6 +99,10 @@ Commands to obtain help:
 L<B<fs apropos>|fs_apropos(1)>
 and L<B<fs help>|fs_help(1)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<fs version>.
+
 =back
 
 The Cache Manager and the fs commands use and maintain the following
index aa9d1ea38b7619728d45b836a3bc15b271b18754..6979f8d6ef7619c4aee2c8fa188ec0fd3a0211e7 100644 (file)
@@ -79,6 +79,10 @@ Commands to obtain help:
 L<B<pts apropos>|pts_apropos(1)>
 and L<B<pts help>|pts_help(1)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<pts version>.
+
 =back
 
 =head1 OPTIONS
index e4370e1f218ad7763c127a0960a945c4bd7b776a..6e27f6cbbdca74575087e5fda431c7f00129d809 100644 (file)
@@ -13,13 +13,13 @@ B<scout> [B<initcmd>] S<<< B<-server> <I<servers to monitor>>+ >>>
       S<<< [B<-attention> <I<specify attention (highlighting) level>>+] >>>
       S<<< [B<-columnwidths> <I<number of characters>>+] >>>
       S<<< [B<-debug> <I<turn debugging output on to the named file>>] >>>
-      [B<-help>]
+      [B<-version>] [B<-help>]
 
 B<scout> [B<i>] S<<< B<-s> <I<servers to monitor>>+ >>>
       S<<< [B<-b> <I<base server name>>] >>> S<<< [B<-f> <I<poll frequency, in seconds>>] >>>
       [B<-ho>] S<<< [B<-a> <I<specify attention (highlighting) level>>+] >>>
       S<<< [B<-c> <I<number of characters>+>] >>>
-      S<<< [B<-d> <I<turn debugging output on to the named file>>] >>> [B<-he>]
+      S<<< [B<-d> <I<turn debugging output on to the named file>>] >>> [B<-version>] [B<-he>]
 
 =for html
 </div>
@@ -176,6 +176,11 @@ directory.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 OUTPUT
index 06d67af248abd5e23dbcf87a1cadd4b067db9134..aaf886cb47c5b14de903a98d462e26f90a7a5b6f 100644 (file)
@@ -12,12 +12,12 @@ B<xstat_cm_test> [I<initcmd>]
     S<<< B<-collID> <I<collection(s) to fetch>>+ >>> [B<-onceonly>]
     S<<< [B<-frequency> <I<poll frequency, in seconds>>] >>>
     S<<< [B<-period> <I<data collection time, in minutes>>] >>> [B<-debug>]
-    [B<-help>]
+    [B<-version>] [B<-help>]
 
 B<xstat_cm_test> [I<i>] S<<< B<-cm> <I<cache manager name(s) to monitor>>+ >>>
     S<<< B<-co> <I<collection(s) to fetch>>+ >>> [B<-o>]
     S<<< [B<-f> <I<poll frequency, in seconds>>] >>>
-    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-h>]
+    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-version>] [B<-h>]
 
 =for html
 </div>
@@ -102,6 +102,11 @@ Displays a trace on the standard output stream as the command runs.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 SEE ALSO
index 7c2257d60ed4487699f73937fb15c800eaaa2cf2..b405cb7b11ac9e45eb85093ce84541d588f31486 100644 (file)
@@ -10,12 +10,12 @@ xstat_fs_test - Displays data collections from the File Server process
 B<xstat_fs_test> [I<initcmd>] S<<< B<-fsname> <I<file server name(s) to monitor>>+ >>>
     S<<< B<-collID> <I<collection(s) to fetch>>+ >>> [B<-onceonly>]
     S<<< [B<-frequency> <I<poll frequency, in seconds>>] >>>
-    S<<< [B<-period> <I<data collection time, in minutes>>] >>> [B<-debug>] [B<-help>]
+    S<<< [B<-period> <I<data collection time, in minutes>>] >>> [B<-debug>] [B<-version>] [B<-help>]
 
 B<xstat_fs_test> [B<initcmd>] S<<< B<-fs> <I<File Server name(s) to monitor>>+ >>>
     S<<< B<-c> <I<Collection(s) to fetch>>+ >>> [B<-o>]
     S<<< [B<-fr> <I<poll frequency, in seconds>>] >>>
-    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-h>]
+    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-version>] [B<-h>]
 
 =for html
 </div>
@@ -105,6 +105,11 @@ Displays a trace on the standard output stream as the command runs.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 SEE ALSO
index fff6263526f0e8c3419906e56b3f124d26b0036f..f5e0a607319fbc659d3edc50a968a5d42f495f4b 100644 (file)
@@ -97,6 +97,10 @@ Precedes a line of text that the afsmonitor program ignores because of the
 initial number (C<#>) sign, which must appear in the very first column of
 the line.
 
+=item B<version>
+
+Print the OpenAFS command suite version and then exit.
+
 =back
 
 For a list of the values that can appear in the I<field/group/section>
index 3f62b25b7fa8e1c3010b224c777d3bd1060221c6..d59be27504548d7e381a22f7b586078b3e7383df 100644 (file)
@@ -72,6 +72,10 @@ Commands to obtain help:
 L<B<backup apropos>|backup_apropos(8)>
 and L<B<backup help>|backup_help(8)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<backup version>.
+
 =back
 
 The backup command interpreter interacts with two other processes:
index 61200d53b615170c797b460db5d30ff31afc98dd..0b784b2fb6033e81e1308ec8c9af3e917b22699c 100644 (file)
@@ -47,6 +47,10 @@ A command to restore file system consistency: B<bos salvage>.
 
 Commands to obtain help: B<bos apropos> and B<bos help>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<bos version>.
+
 =back
 
 The BOS Server and the B<bos> commands use and maintain the following
index 7e8d599c55c472cc133d5d546f25aacc042742c4..0c4ef3bea4cd5265d2ad557f212c979b3d190750 100644 (file)
@@ -53,6 +53,10 @@ Commands to obtain help:
 L<B<kas apropos>|kas_apropos(8)>
 and L<B<kas help>|kas_help(8)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<kas version>.
+
 =back
 
 Because of the sensitivity of information in the Authentication Database,