Update vos suite manpages
authorDavor Ocelic <docelic@spinlocksolutions.com>
Thu, 8 Oct 2009 17:31:00 +0000 (19:31 +0200)
committerDerrick Brashear <shadow|account-1000005@unknown>
Thu, 8 Oct 2009 17:59:20 +0000 (10:59 -0700)
Larger collection of all vos suite commands, including but
not limited to:

 -- documented all commands / options, verified against both 1.4 and 1.5 tree
    (including the common -encrypt/-noresolve options)

 -- correct order, POD formatting and synopsis for all commands' options

 -- shorthand synopsis provided for all commands that missed it, with proper
    non-ambiguous command abbreviations of all options

 -- POD synopsis formatted to 80-columns in commands where it was running over

 -- for newer options, documented which OpenAFS version they became available

 -- proper manpage links using L<> in vos.pod

Reviewed-on: http://gerrit.openafs.org/609
Tested-by: Derrick Brashear <shadow@dementia.org>
Reviewed-by: Derrick Brashear <shadow@dementia.org>

36 files changed:
doc/man-pages/pod1/vos.pod
doc/man-pages/pod1/vos_addsite.pod
doc/man-pages/pod1/vos_backup.pod
doc/man-pages/pod1/vos_backupsys.pod
doc/man-pages/pod1/vos_changeaddr.pod
doc/man-pages/pod1/vos_changeloc.pod
doc/man-pages/pod1/vos_clone.pod
doc/man-pages/pod1/vos_convertROtoRW.pod
doc/man-pages/pod1/vos_copy.pod
doc/man-pages/pod1/vos_create.pod
doc/man-pages/pod1/vos_delentry.pod
doc/man-pages/pod1/vos_dump.pod
doc/man-pages/pod1/vos_examine.pod
doc/man-pages/pod1/vos_listaddrs.pod
doc/man-pages/pod1/vos_listpart.pod
doc/man-pages/pod1/vos_listvldb.pod
doc/man-pages/pod1/vos_listvol.pod
doc/man-pages/pod1/vos_lock.pod
doc/man-pages/pod1/vos_move.pod
doc/man-pages/pod1/vos_offline.pod
doc/man-pages/pod1/vos_online.pod
doc/man-pages/pod1/vos_partinfo.pod
doc/man-pages/pod1/vos_release.pod
doc/man-pages/pod1/vos_remove.pod
doc/man-pages/pod1/vos_remsite.pod
doc/man-pages/pod1/vos_rename.pod
doc/man-pages/pod1/vos_restore.pod
doc/man-pages/pod1/vos_setfields.pod
doc/man-pages/pod1/vos_shadow.pod
doc/man-pages/pod1/vos_size.pod
doc/man-pages/pod1/vos_status.pod
doc/man-pages/pod1/vos_syncserv.pod
doc/man-pages/pod1/vos_syncvldb.pod
doc/man-pages/pod1/vos_unlock.pod
doc/man-pages/pod1/vos_unlockvldb.pod
doc/man-pages/pod1/vos_zap.pod

index 11b6984..3d83191 100644 (file)
@@ -22,8 +22,8 @@ intermediate state), there is no need to repeat the internal steps that
 brought them there. Idempotency does not apply if the command issuer
 explicitly interrupts the operation with the Ctrl-C command or another
 interrupt signal. In that case, the volume is left locked and the
-administrator must use the B<vos unlock> command to unlock it before
-proceeding.
+administrator must use the L<B<vos unlock>|vos_unlock(1)> command to
+unlock it before proceeding.
 
 It is important that the VLDB accurately indicate the status of the
 volumes on file server machines at all times. L<vldb.DB0(5)> and
@@ -32,7 +32,8 @@ volume headers, respectively. If a B<vos> command changes volume status,
 it automatically records the change in the corresponding VLDB entry. The
 most common cause of discrepancies between the VLDB and volume status on
 file server machines is interrupted operations; to restore consistency,
-use the B<vos syncserv> and B<vos syncvldb> commands.
+use the L<B<vos syncserv>|vos_syncserv(1)> and
+L<B<vos syncvldb>|vos_syncvldb(1)> commands.
 
 There are several categories of commands in the vos command suite:
 
@@ -40,61 +41,82 @@ There are several categories of commands in the vos command suite:
 
 =item *
 
-Commands to create, move, and rename volumes: B<vos backup>, B<vos
-backupsys>, B<vos changeloc>, B<vos create>, B<vos move>, and B<vos
-rename>.
+Commands to create, move, and rename volumes:
+L<B<vos backup>|vos_backup(1)>,
+L<B<vos backupsys>|vos_backupsys(1)>,
+L<B<vos changeloc>|vos_changeloc(1)>,
+L<B<vos create>|vos_create(1)>,
+L<B<vos move>|vos_move(1)>,
+and L<B<vos rename>|vos_rename(1)>.
 
 =item *
 
-Commands to remove VLDB volume records or volumes or both: B<vos
-delentry>, B<vos remove>, and B<vos zap>.
+Commands to remove VLDB volume records or volumes or both:
+L<B<vos delentry>|vos_delentry(1)>,
+L<B<vos remove>|vos_remove(1)>,
+and L<B<vos zap>|vos_zap(1)>.
 
 =item *
 
-Commands to edit or display VLDB server entries: B<vos changeaddr> and
-B<vos listaddrs>.
+Commands to edit or display VLDB server entries:
+L<B<vos changeaddr>|vos_changeaddr(1)>
+and L<B<vos listaddrs>|vos_listaddrs(1)>.
 
 =item *
 
-Commands to create, size, and restore dump files: B<vos dump>, B<vos
-restore>, and B<vos size>.
+Commands to create, size, and restore dump files:
+L<B<vos dump>|vos_dump(1)>,
+L<B<vos restore>|vos_restore(1)>,
+and L<B<vos size>|vos_size(1)>.
 
 =item *
 
-Commands to administer replicated volumes: B<vos addsite>, B<vos release>,
-and B<vos remsite>.
+Commands to administer replicated volumes:
+L<B<vos addsite>|vos_addsite(1)>,
+L<B<vos release>|vos_release(1)>,
+and L<B<vos remsite>|vos_remsite(1)>.
 
 =item *
 
-Commands to display VLDB records, volume headers, or both: B<vos examine>,
-B<vos listvldb>, and B<vos listvol>.
+Commands to display VLDB records, volume headers, or both:
+L<B<vos examine>|vos_examine(1)>,
+L<B<vos listvldb>|vos_listvldb(1)>,
+and L<B<vos listvol>|vos_listvol(1)>.
 
 =item *
 
-Commands to display information about partitions that house volumes: B<vos
-listpart> and B<vos partinfo>.
+Commands to display information about partitions that house volumes:
+L<B<vos listpart>|vos_listpart(1)>
+and L<B<vos partinfo>|vos_partinfo(1)>.
 
 =item *
 
-Commands to restore consistency between the VLDB and volume headers: B<vos
-syncserv> and B<vos syncvldb>.
+Commands to restore consistency between the VLDB and volume headers:
+L<B<vos syncserv>|vos_syncserv(1)>
+and L<B<vos syncvldb>|vos_syncvldb(1)>.
 
 =item *
 
-Commands to lock and unlock VLDB entries: B<vos lock>, B<vos unlock>, and
-B<vos unlockvldb>.
+Commands to lock and unlock VLDB entries:
+L<B<vos lock>|vos_lock(1)>,
+L<B<vos unlock>|vos_unlock(1)>,
+and L<B<vos unlockvldb>|vos_unlockvldb(1)>.
 
 =item *
 
-A command to report Volume Server status: B<vos status>.
+A command to report Volume Server status:
+L<B<vos status>|vos_status(1)>.
 
 =item *
 
-A command to change volume fields: B<vos setfields>.
+A command to change volume fields:
+L<B<vos setfields>|vos_setfields(1)>.
 
 =item *
 
-Commands to obtain help: B<vos apropos> and B<vos help>.
+Commands to obtain help:
+L<B<vos apropos>|vos_apropos(1)>
+and L<B<vos help>|vos_help(1)>.
 
 =back
 
@@ -173,11 +195,12 @@ Establishes an unauthenticated connection to the Volume Server and VL
 Server, in which the servers treat the issuer as the unprivileged user
 C<anonymous>. It is useful only when authorization checking is disabled on
 the server machine (during the installation of a file server machine or
-when the B<bos setauth> command has been used during other unusual
-circumstances). In normal circumstances, the servers allow only privileged
-users to issue commands that change the status of a volume or VLDB record,
-and refuses to perform such an action even if the B<-noauth> flag is
-provided. Do not combine the B<-noauth> and B<-localauth> flags.
+when the L<B<bos setauth>|bos_setauth(8)> command has been used during
+other unusual circumstances). In normal circumstances, the servers allow
+only privileged users to issue commands that change the status of a volume
+or VLDB record, and refuses to perform such an action even if the
+B<-noauth> flag is provided. Do not combine the B<-noauth> and
+B<-localauth> flags.
 
 =item B<-partition> <I<partition name>>
 
@@ -198,8 +221,8 @@ and so on through
 
    /vicepiv    =     vicepiv     =      iv     =      255
 
-The B<-frompartition> and B<-topartition> arguments to the B<vos move>
-command also accept this notation.
+The B<-frompartition> and B<-topartition> arguments to the
+L<B<vos move>|vos_move(1)> command also accept this notation.
 
 =item B<-server> <I<machine name>>
 
@@ -212,8 +235,8 @@ abbreviated form depends on the availability of a name resolution service
 (such as the Domain Name Service or a local host table) at the time the
 command is issued.
 
-The B<-fromserver> and B<-toserver> arguments to the B<vos move> command
-also accept these name formats.
+The B<-fromserver> and B<-toserver> arguments to the
+L<B<vos move>|vos_move(1)> command also accept these name formats.
 
 =item B<-noresolve>
 
index ac6a9cf..9b98eef 100644 (file)
@@ -13,13 +13,14 @@ B<vos addsite> S<<< B<-server> <I<machine name for new site>> >>>
     S<<< [B<-roid> <I<readonly volume name or ID>>] >>>
     [B<-valid>] S<<< [B<-cell> <I<cell name>>] >>>
     [B<-noauth>] [B<-localauth>]
-    [B<-verbose>] [B<-help>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos ad> S<<< B<-s> <I<machine name for new site>> >>>
     S<<< B<-p> <I<partition name for new site>> >>>
     S<<< B<-i> <I<volume name or ID>> >>>
     S<<< [B<-r> <I<readonly volume name or ID>>] >>>
-    [B<-va>] [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+    [B<-va>] [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>]
+    [B<-ve>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -85,7 +86,8 @@ have a readonly volume ID, a volume ID for the readonly volume will be
 allocated for it when the B<vos release> command is run.
 
 The automatically allocated readonly volume IDs should be fine for almost
-all cases, so you should almost never need to specify this option.
+all cases, so you should almost never need to specify them explicitly.
+This option is available in OpenAFS versions 1.5.61 or later.
 
 =item B<-valid>
 
@@ -94,7 +96,7 @@ new site already has a current readonly replica of the volume, but for
 some reason it is not in the VLDB as a replica site. This is useful when
 an existing read-only volume is dumped and restored with the B<-readonly>
 flag at the new site. This option is available in OpenAFS clients 1.4.7 or
-later and 1.5.31 and later. This option can be used with OpenAFS server
+later and 1.5.31 or later. This option can be used with OpenAFS server
 versions later than 1.4.1 or 1.5.0.
 
 =item B<-cell> <I<cell name>>
@@ -121,6 +123,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 19312db..f35c6e6 100644 (file)
@@ -7,11 +7,13 @@ vos_backup - Creates a backup volume for a single read/write volume
 =for html
 <div class="synopsis">
 
-B<vos backup> S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+B<vos backup> S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>] [B<-verbose>]
+    [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos backup> S<<< B<-i> <I<volume name or ID>> >>> [B<-c><I<cell name>>]
-    [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos backup> S<<< B<-i> <I<volume name or ID>> >>> [B<-c> <I<cell name>>]
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -62,6 +64,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 8a12c5a..9c98586 100644 (file)
@@ -8,15 +8,18 @@ vos_backupsys - Creates a backup volume for several read/write volumes
 <div class="synopsis">
 
 B<vos backupsys> S<<< [B<-prefix> <I<common prefix on volume(s)>>+] >>>
-    S<<< [B<-server> <I<machine name>>] >>> S<<< [B<-partition> <I<partition name>>] >>>
+    S<<< [B<-server> <I<machine name>>] >>>
+    S<<< [B<-partition> <I<partition name>>] >>>
     [B<-exclude>] S<<< [B<-xprefix> <I<negative prefix on volume(s)>>+] >>>
-    [B<-dryrun>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-    [B<-verbose>] [B<-help>]
+    [B<-dryrun>] S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos backups> S<<< [B<-pr> <I<common prefix on volume(s)>>+] >>>
-    S<<< [B<-s> <I<machine name>>] >>> S<<< [B<-pa> <I<partition name>>] >>> [B<-e>]
-    S<<< [B<-x> <I<negative prefix on volume(s)>>+] >>> [B<-d>]
-    S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+    S<<< [B<-s> <I<machine name>>] >>> S<<< [B<-pa> <I<partition name>>] >>>
+    [B<-ex>] S<<< [B<-x> <I<negative prefix on volume(s)>>+] >>> [B<-d>]
+    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>] [B<-v>]
+    [B<-en>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -196,6 +199,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 02d9fb8..432705a 100644 (file)
@@ -10,10 +10,12 @@ vos_changeaddr - Changes or removes a file server machine's entry in the VLDB
 B<vos changeaddr> S<<< B<-oldaddr> <I<original IP address>> >>>
     S<<< [B<-newaddr> <I<new IP address>>] >>> [B<-remove>]
     S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-    [B<-verbose>] [B<-help>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos ch> S<<< B<-o> <I<original IP address>> >>> S<<< [B<-ne> <I<new IP address>>] >>>
-    [B<-r>] S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-v>] [B<-h>]
+B<vos changea> S<<< B<-o> <I<original IP address>> >>>
+    S<<< [B<-ne> <I<new IP address>>] >>> [B<-r>]
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -102,6 +104,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index a4b0286..341e89e 100644 (file)
@@ -11,12 +11,13 @@ B<vos changeloc> S<<< [B<-server>] <I<new server name>> >>>
    S<<< [B<-partition>] <I<new partition location>> >>>
    S<<< [B<-id>] <I<volume name or ID>> >>>
    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-   [B<-verbose>] [B<-encrypt>] [B<-help>]
+   [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos changel> S<<< [B<-s>] <I<new server name>> >>>
    S<<< [B<-p>] <I<new partition location>> >>>
    S<<< [B<-i>] <I<volume name or ID>> >>>
-   S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-e>] [B<-h>]
+   S<<< [B<-c> <I<cell name>>] >>>
+   [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -98,7 +99,16 @@ appear.
 
 =item B<-encrypt>
 
-Encrypts the commands that are sent to the server.
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
index 51264d1..36df86f 100644 (file)
@@ -11,9 +11,18 @@ B<vos clone> S<<< [B<-id>] <I<volume name or ID>> >>>
     S<<< [B<-server>] <I<server name>> >>>
     S<<< [B<-partition>] <I<partition name>> >>>
     S<<< [B<-toname> <I<volume name on destination>>] >>>
-    S<<< [B<-toid> <I<volume ID on destination>>] >>> [B<-offline>] [B<-readonly>]
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>]
-    [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>]
+    S<<< [B<-toid> <I<volume ID on destination>>] >>>
+    [B<-offline>] [B<-readonly>]
+    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos cl> S<<< [B<-i>] <I<volume name or ID>> >>>
+    S<<< [B<-s>] <I<server name>> >>>
+    S<<< [B<-p>] <I<partition name>> >>>
+    S<<< [B<-ton> <I<volume name on destination>>] >>>
+    S<<< [B<-toi> <I<volume ID on destination>>] >>> [B<-o>] [B<-r>]
+    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>]
+    [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -116,7 +125,15 @@ appear.
 =item B<-encrypt>
 
 Encrypts the command so that the operation's results are not transmitted
-across the network in clear text.
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
index bc8b306..580993c 100644 (file)
@@ -11,7 +11,13 @@ B<vos convertROtoRW> S<<< [B<-server>] <I<machine name>> >>>
    S<<< [B<-partition>] <I<partition name>> >>>
    S<<< [B<-id>] <I<volume name or ID>> >>> [B<-force>]
    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-   [B<-verbose>] [B<-encrypt>] [B<-help>]
+   [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos con> S<<< [B<-s>] <I<machine name>> >>>
+   S<<< [B<-p>] <I<partition name>> >>>
+   S<<< [B<-i>] <I<volume name or ID>> >>> [B<-f>]
+   S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>]
+   [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -83,7 +89,15 @@ appear.
 =item B<-encrypt>
 
 Encrypts the command so that the operation's results are not transmitted
-across the network in clear text.
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
index 6d29145..b0c3bd9 100644 (file)
@@ -14,7 +14,18 @@ B<vos copy> S<<< [B<-id>] <I<volume name or ID of source>> >>>
    S<<< [B<-toserver>] <I<machine name for destination>> >>>
    S<<< [B<-topartition>] <I<partition name for destination>> >>>
    [B<-offline>] [B<-readonly>] [B<-live>] S<<< [B<-cell> <I<cell name>>] >>>
-   [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>]
+   [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
+   [B<-help>]
+
+B<vos cop> S<<< [B<-i>] <I<volume name or ID of source>> >>>
+   S<<< [B<-froms>] <I<machine name for source>> >>>
+   S<<< [B<-fromp>] <I<partition name for source>> >>>
+   S<<< [B<-ton>] <I<volume name for new copy>> >>>
+   S<<< [B<-tos>] <I<machine name for destination>> >>>
+   S<<< [B<-top>] <I<partition name for destination>> >>>
+   [B<-o>] [B<-r>] [B<-li>] S<<< [B<-c> <I<cell name>>] >>>
+   [B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>]
+   [B<-h>]
 
 =for html
 </div>
@@ -97,7 +108,15 @@ appear.
 =item B<-encrypt>
 
 Encrypts the command so that the operation's results are not transmitted
-across the network in clear text.
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
index 0c329ad..89dad2c 100644 (file)
@@ -7,16 +7,18 @@ vos_create - Creates a read/write volume and associated VLDB entry
 =for html
 <div class="synopsis">
 
-B<vos create> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>>
-    S<<< B<-name> <I<volume name>> >>> S<<< [B<-maxquota> <I<initial quota>>] >>>
-    S<<< [B<-id> <I<volume ID>>] >>> S<<< [B<-roid> <I<readonly volume ID>>] >>>
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
+B<vos create> S<<< B<-server> <I<machine name>> >>>
+    S<<< B<-partition> <I<partition name>> >>>
+    S<<< B<-name> <I<volume name>> >>>
+    S<<< [B<-maxquota> <I<initial quota (KB)>>] >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>] [B<-verbose>]
+    [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos cr> S<<< B<-s> <I<machine name>> >>> S<<< B<-p> <I<partition name>> >>>
     S<<< B<-na> <I<volume name>> >>> S<<< [B<-m> <I<initial quota>>] >>>
-    S<<< [B<-i> <I<volume ID>>] >>> S<<< [B<-r> <I<readonly volume ID>>] >>>
-    S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-v>] [B<-h>]
+    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>] [B<-v>]
+    [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -128,7 +130,8 @@ manually specified.
 
 As with the B<-id> option, the default allocated volume IDs should be
 sufficient for almost all cases, so you should almost never need to
-specify this option.
+specify them explicitly. This option is available in OpenAFS
+versions 1.5.61 or later.
 
 =item B<-cell> <I<cell name>>
 
@@ -155,6 +158,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index b28bb8c..c5d36df 100644 (file)
@@ -8,15 +8,17 @@ vos_delentry - Removes a volume entry from the VLDB.
 <div class="synopsis">
 
 B<vos delentry> S<<< [B<-id> <I<volume name or ID>>+] >>>
-    S<<< [B<-prefix> <I<prefix of volume whose VLDB entry is to be deleted>>] >>>
-    S<<< [B<-server> <I<machine name>>] >>> S<<< [B<-partition> <I<partition name>>] >>>
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
+   S<<< [B<-prefix> <I<prefix of volume whose VLDB entry is to be deleted>>] >>>
+    S<<< [B<-server> <I<machine name>>] >>>
+    S<<< [B<-partition> <I<partition name>>] >>>
+    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos de> S<<< [B<-i> <I<volume name or ID>>+] >>>
     S<<< [B<-pr> <I<prefix of volume whose VLDB entry is to be deleted>>] >>>
     S<<< [B<-s> <I<machine name>>] >>> S<<< [B<-pa> <I<partition name>>] >>>
-    S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>]
+    [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -145,6 +147,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 76b028f..a11e5ed 100644 (file)
@@ -7,16 +7,19 @@ vos_dump - Converts a volume into ASCII format and writes it to a file
 =for html
 <div class="synopsis">
 
-B<vos dump> S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-time> <I<dump from time>>] >>>
+B<vos dump> S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-time> <I<dump from time>>] >>>
     S<<< [B<-file> <I<dump file>>] >>> S<<< [B<-server> <I<server>>] >>>
     S<<< [B<-partition> <I<partition>>] >>> [B<-clone>] [B<-omitdirs>]
     S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-    [B<-verbose>] [B<-help>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos du> S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-t> <I<dump from time>>] >>>
-    S<<< [B<-f> <I<dump file>>] >>> S<<< [B<-s> <I<server>>] >>> S<<< [B<-p> <I<partition>>] >>>
-    [B<-cl>] [B<-o>] S<<< [B<-ce> <I<cell name>>] >>> [B<-n>] [B<-l>]
-    [B<-v>] [B<-h>]
+B<vos du> S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< [B<-t> <I<dump from time>>] >>>
+    S<<< [B<-f> <I<dump file>>] >>> S<<< [B<-s> <I<server>>] >>>
+    S<<< [B<-p> <I<partition>>] >>>
+    [B<-cl>] [B<-o>] S<<< [B<-ce> <I<cell name>>] >>> [B<-noa>] [B<-l>]
+    [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -173,6 +176,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 4f5d00a..16161f1 100644 (file)
@@ -8,17 +8,22 @@ vos_examine - Shows volume header and VLDB entry information for a volume
 <div class="synopsis">
 
 B<vos examine> S<<< B<-id> <I<volume name or ID>> >>> [B<-extended>]
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
+    [B<-format>] S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>] [B<-verbose>]
+    [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos e> S<<< B<-i> <I<volume name or ID>> >>> [B<-e>] S<<< [B<-c> <I<cell name>>] >>>
-    [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos e> S<<< B<-i> <I<volume name or ID>> >>> [B<-ex>] [B<-f>]
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
-B<vos volinfo> S<<< B<-i> <I<volume name or ID>> >>> [B<-e>] [-c <I<cell name>>]
-    [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos volinfo> S<<< B<-id> <I<volume name or ID>> >>> [B<-extended>]
+    [B<-format>] S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>] [B<-verbose>]
+    [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos v> S<<< B<-i> <I<volume name or ID>> >>> [B<-e>] S<<< [B<-c> <I<cell name>>] >>>
-    [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos v> S<<< B<-i> <I<volume name or ID>> >>> [B<-ex>] [B<-f>]
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -50,6 +55,10 @@ which can be read/write, read-only, or backup.
 Display statistics about read and write operations on files and
 directories in the volume.
 
+=item B<-format>
+
+Show information in a format suitable for machine parsing.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -75,6 +84,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 3e4fbae..b7712a7 100644 (file)
@@ -7,10 +7,15 @@ vos_listaddrs - Displays all VLDB server entries
 =for html
 <div class="synopsis">
 
-B<vos listaddrs> S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>]
-    [B<-localauth>] [B<-verbose>] [B<-help>]
+B<vos listaddrs> S<<< [B<-uuid> <I<uuid of server>>] >>>
+    S<<< [B<-host> <I<address of host>>] >>> [B<-printuuid>]
+    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos lista> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos lista> [B<-u> <I<uuid of server>>] >>>
+    S<<< [B<-h> <I<address of host>>] >>> [B<-p>]
+    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>]
+    [B<-v>] [B<-e>] [B<-nor>] [B<-he>]
 
 =for html
 </div>
@@ -26,6 +31,11 @@ in the VLDB.
 
 =over 4
 
+=item B<-printuuid>
+
+Prints UUID of hosts. The B<-printuuid> option is available in OpenAFS
+versions 1.4.5 or later and 1.5.8 or later.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -50,6 +60,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
@@ -85,12 +108,20 @@ Corporation cell:
    sv2.abc.com  afs2.abc.com
    sv6.abc.com
 
+The following command displays the VLDB server entry and uuid for
+host sv5.abc.com in the ABC Corporation cell:
+
+   % vos listaddrs -p -ho sv5.abc.com
+   UUID: 000c5aff-8246-1699-96-c4-437b5a45aa77
+   sv5.abc.com
+
 =head1 PRIVILEGE REQUIRED
 
 None
 
 =head1 SEE ALSO
 
+L<fs_uuid(1)>,
 L<sysid(5)>,
 L<vos(1)>,
 L<vos_changeaddr(1)>,
index e924bd5..23ad61f 100644 (file)
@@ -7,11 +7,13 @@ vos_listpart - Displays all AFS partitions on a file server machine
 =for html
 <div class="synopsis">
 
-B<vos listpart> S<<< B<-server> <I<machine name>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+B<vos listpart> S<<< B<-server> <I<machine name>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos listp> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
-    [B<-l>] [B<-v>] [B<-h>]
+B<vos listp> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -57,6 +59,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index f9947c6..343ed96 100644 (file)
@@ -8,13 +8,17 @@ vos_listvldb - Displays a volume's VLDB entry
 <div class="synopsis">
 
 B<vos listvldb> S<<< [B<-name> <I<volume name or ID>>] >>>
-    S<<< [B<-server> <I<machine name>>] >>> S<<< [B<-partition> <I<partition name>>] >>>
-    [B<-locked>] [B<-quiet>] [B<-nosort>] S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
-
-B<vos listvl> S<<< [B<-na> <I<volume name or ID>>] >>> S<<< [B<-s> <I<machine name>>] >>>
-    S<<< [B<-p> <I<partition name>>] >>> [B<-lock>] [B<-q>] [B<-nos>]
-    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-loca>] [B<-v>] [B<-h>]
+    S<<< [B<-server> <I<machine name>>] >>>
+    S<<< [B<-partition> <I<partition name>>] >>>
+    [B<-locked>] [B<-quiet>] [B<-nosort>]
+    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos listvl> S<<< [B<-na> <I<volume name or ID>>] >>>
+    S<<< [B<-s> <I<machine name>>] >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    [B<-lock>] [B<-q>] [B<-nos>] S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-loca>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -134,6 +138,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 32d57d5..f3383e8 100644 (file)
@@ -8,13 +8,17 @@ vos_listvol - Displays information from a volume header
 <div class="synopsis">
 
 B<vos listvol> S<<< B<-server> <I<machine name>> >>>
-    S<<< [B<-partition> <I<partition name>>] >>> [B<-fast>] [B<-long>] [B<-quiet>]
-    [B<-extended>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-    [B<-verbose>] [B<-help>]
-
-B<vos listvo> S<<< B<-s> <I<machine name>> >>> S<<< [B<-p> <I<partition name>>] >>> [B<-f>]
-    [-lon] [B<-q>] [B<-e>] S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-loc>]
-    [B<-v>] [B<-h>]
+    S<<< [B<-partition> <I<partition name>>] >>>
+    [B<-fast>] [B<-long>] [B<-quiet>]
+    [B<-extended>] [B<-format>]
+    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos listvo> S<<< B<-s> <I<machine name>> >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    [B<-fa>] [-lon] [B<-q>] [B<-ex>] [B<-fo>]
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-loc>] [B<-v>] [B<-en>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -97,6 +101,10 @@ in the volume, and how recently files and directories have been updated by
 their owners or other users. Do not combine this flag with the B<-fast>
 flag.
 
+=item B<-format>
+
+Show information in a format suitable for machine parsing.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -122,6 +130,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index ef84a5f..5deff0a 100644 (file)
@@ -7,11 +7,14 @@ vos_lock - Locks a VLDB volume entry
 =for html
 <div class="synopsis">
 
-B<vos lock> S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+B<vos lock> S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos lo> S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
-    [B<-l>] [B<-v>] [B<-h>]
+B<vos lo> S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -68,6 +71,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index fa92333..4787196 100644 (file)
@@ -12,15 +12,16 @@ B<vos move> S<<< B<-id> <I<volume name or ID>> >>>
     S<<< B<-frompartition> <I<partition name on source>> >>>
     S<<< B<-toserver> <I<machine name on destination>> >>>
     S<<< B<-topartition> <I<partition name on destination>> >>>
-    [B<-live>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>]
-    [B<-localauth>] [B<-verbose>] [B<-help>]
+    [B<-live>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos m> S<<< B<-i> <I<volume name or ID>> >>>
     S<<< B<-froms> <I<machine name on source>> >>>
     S<<< B<-fromp> <I<partition name on source>> >>>
     S<<< B<-tos> <I<machine name on destination>> >>>
-    S<<< B<-top> <I<partition name on destination>> >>> [B<-li>]
-    S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+    S<<< B<-top> <I<partition name on destination>> >>>
+    [B<-li>] S<<< [B<-c> <I<cell name>>] >>> [B<-noa>]
+    [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -155,6 +156,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index b00a039..84b7b97 100644 (file)
@@ -7,9 +7,21 @@ vos_offline - Takes a volume offline
 =for html
 <div class="synopsis">
 
-B<vos offline> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>> 
-    S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-unbless>] >>> S<<< [B<-cell> <I<cell name>>] >>> 
-    S<<< [B<-noauth>] | B<-localauth>] >>> S<<< [B<-verbose>] >>> S<<< [B<-encrypt>] >>> S<<< [B<-help>] >>>
+B<vos offline> S<<< B<-server> <I<machine name>> >>>
+    S<<< B<-partition> <I<partition name>> >>> 
+    S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-sleep> <I<seconds to sleep>>] >>> 
+    [B<-busy>] S<<< [B<-cell> <I<cell name>>] >>> 
+    [B<-noauth>] B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos of> S<<< B<-se> <I<machine name>> >>>
+    S<<< B<-p> <I<partition name>> >>> 
+    S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< [B<-sl> <I<seconds to sleep>>] >>> 
+    [B<-b>] S<<< [B<-c> <I<cell name>>] >>> 
+    [B<-noa>] B<-l>]
+    [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -82,8 +94,16 @@ appear.
 
 =item B<-encrypt>
 
-Encrypts the command so that the operation's results are
-not transmitted across the network in clear text.
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
@@ -102,7 +122,7 @@ The following example takes an online volume offline and marks it
 so that a B<vos online> without B<-bless> will not bring it online:
 
    % vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs \
-       -unbless
+  -unbless
 
 =head1 PRIVILEGE REQUIRED
 
index e430a18..2f9b0cf 100644 (file)
@@ -7,9 +7,18 @@ vos_online - Brings a volume online
 =for html
 <div class="synopsis">
 
-B<vos online> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>> 
-    S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-bless>] >>> S<<< [B<-cell> <I<cell name>>] >>> 
-    S<<< [B<-noauth>] | B<-localauth>] >>> S<<< [B<-verbose>] >>> S<<< [B<-encrypt>] >>> S<<< [B<-help>] >>>
+B<vos online> S<<< B<-server> <I<machine name>> >>>
+    S<<< B<-partition> <I<partition name>> >>> 
+    S<<< B<-id> <I<volume name or ID>> >>>
+    [B<-bless>] S<<< [B<-cell> <I<cell name>>] >>> 
+    [B<-noauth>] B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos on> S<<< B<-s> <I<machine name>> >>>
+    S<<< B<-p> <I<partition name>> >>> 
+    S<<< B<-i> <I<volume name or ID>> >>>
+    [B<-b>] S<<< [B<-c> <I<cell name>>] >>> 
+    [B<-noa>] B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -80,8 +89,16 @@ appear.
 
 =item B<-encrypt>
 
-Encrypts the command so that the operation's results are
-not transmitted across the network in clear text.
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
index 5439064..483a942 100644 (file)
@@ -8,11 +8,15 @@ vos_partinfo - Reports the available and total space on a partition
 <div class="synopsis">
 
 B<vos partinfo> S<<< B<-server> <I<machine name>> >>>
-    S<<< [B<-partition> <I<partition name>>] >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+    S<<< [B<-partition> <I<partition name>>] >>> [B<-summary>]
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos p> S<<< B<-s> <I<machine name>> >>> S<<< [B<-p> <I<partition name>>] >>>
-    S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos p> S<<< B<-se> <I<machine name>> >>>
+    S<<< [B<-p> <I<partition name>>] >>> [B<-su>]
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -48,6 +52,10 @@ partition's complete name with preceding slash (for example, C</vicepa>)
 or use one of the three acceptable abbreviated forms. For details, see
 L<vos(1)>.
 
+=item B<-summary>
+
+Prints storage summary.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -73,6 +81,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 37a4345..0115dff 100644 (file)
@@ -7,12 +7,14 @@ vos_release - Updates read-only volumes to match the read/write source volume
 =for html
 <div class="synopsis">
 
-B<vos release> S<<< B<-id> <I<volume name or ID>> >>> [B<-f>]
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
+B<vos release> S<<< B<-id> <I<volume name or ID>> >>> [B<-force>]
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos rel> S<<< B<-i> <I<volume name or ID>> >>> [B<-f>] S<<< [B<-c> <I<cell name>>] >>>
-    [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos rel> S<<< B<-i> <I<volume name or ID>> >>>
+    [B<-f>] S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -118,7 +120,7 @@ clears all flags after all sites successfully receive it.
 =back
 
 To override the default behavior, forcing the Volume Server to create and
-release a new ReleaseClone to the read-only sites, include the B<-f>
+release a new ReleaseClone to the read-only sites, include the B<-force>
 flag. This is appropriate if, for example, the data at the read/write site
 has changed since the existing ReleaseClone was created during the
 previous release operation.
@@ -132,7 +134,7 @@ previous release operation.
 Specifies either the complete name or volume ID number of a read/write
 volume.
 
-=item B<-f>
+=item B<-force>
 
 Creates a new ReleaseClone and distributes it all read-only sites
 regardless of whether or not any site definitions in the VLDB entry are
@@ -163,6 +165,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 820006e..8c36b4d 100644 (file)
@@ -9,12 +9,16 @@ vos_remove - Removes a volume from a site
 
 B<vos remove> S<<< [B<-server> <I<machine name>>] >>>
     S<<< [B<-partition> <I<partition name>>] >>>
-    S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+    S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos remo> S<<< [B<-s> <I<machine name>>] >>> S<<< [B<-p> <I<partition name>>] >>>
-    S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>]
-    [B<-v>] [B<-h>]
+B<vos remo> S<<< [B<-s> <I<machine name>>] >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -134,6 +138,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index e455f8e..691bacc 100644 (file)
@@ -1,4 +1,4 @@
-=head1 NAME
+head1 NAME
 
 vos_remsite - Removes a read-only site definition from a VLDB entry
 
@@ -8,13 +8,17 @@ vos_remsite - Removes a read-only site definition from a VLDB entry
 <div class="synopsis">
 
 B<vos remsite> S<<< B<-server> <I<machine name>> >>>
-    S<<< B<-partition> <I<partition name>> >>> S<<< B<-id> <I<volume name or ID>> >>>
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
-
-B<vos rems> S<<< B<-s> <I<machine name>> >>> S<<< B<-p> <I<partition name>> >>>
-    S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>]
-    [B<-v>] [B<-h>]
+    S<<< B<-partition> <I<partition name>> >>>
+    S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos rems> S<<< B<-s> <I<machine name>> >>>
+    S<<< B<-p> <I<partition name>> >>>
+    S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -89,6 +93,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 5480aca..589c44d 100644 (file)
@@ -8,11 +8,14 @@ vos_rename - Renames a volume
 <div class="synopsis">
 
 B<vos rename> S<<< B<-oldname> <I<old volume name>> >>>
-    S<<< B<-newname> <I<new volume name>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+    S<<< B<-newname> <I<new volume name>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos ren> S<<< B<-o> <I<old volume name>> >>> S<<< B<-ne> <I<new volume name>> >>>
-    [-c <I<cell name>>] [B<-no>] [B<-l>] [B<-v>] [B<-h>]
+B<vos ren> S<<< B<-o> <I<old volume name>> >>>
+    S<<< B<-ne> <I<new volume name>> >>>
+    [-c <I<cell name>>] [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -66,6 +69,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index c5005c1..669120f 100644 (file)
@@ -7,16 +7,30 @@ vos_restore - Converts an ASCII dump file into an AFS volume
 =for html
 <div class="synopsis">
 
-B<vos restore> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>>
-    S<<< B<-name> <I<name of volume to be restored>> >>> S<<< [B<-file> <I<dump file>>] >>>
-    S<<< [B<-id> <I<volume ID>>] >>> S<<< [B<-overwrite> (abort | full | incremental)] >>>
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [-verbose]
-    [B<-help>]
-
-B<vos res> S<<< B<-s> <I<machine name>> >>> S<<< B<-p> <I<partition name>> >>>
-    S<<< B<-na> <I<name of volume to be restored>> >>> S<<< [B<-f> <I<dump file>>] >>>
-    S<<< [B<-i> <I<volume ID>>] >>> S<<< [B<-o> (a | f | i)] >>> S<<< [B<-c> <I<cell name>>] >>>
-    [B<-no>] [B<-l>] [B<-v>] [B<-h>]
+B<vos restore> S<<< B<-server> <I<machine name>> >>>
+    S<<< B<-partition> <I<partition name>> >>>
+    S<<< B<-name> <I<name of volume to be restored>> >>>
+    S<<< [B<-file> <I<dump file>>] >>>
+    S<<< [B<-id> <I<volume ID>>] >>>
+    S<<< [B<-overwrite> (abort | full | incremental)] >>>
+    [B<-offline>] [B<-readonly>]
+    S<<< [B<-creation> (dump | keep | new)] >>>
+    S<<< [B<-lastupdate> (dump | keep | new)] >>>
+    [B<-nodelete>] S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [-verbose] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos res> S<<< B<-s> <I<machine name>> >>>
+    S<<< B<-p> <I<partition name>> >>>
+    S<<< B<-na> <I<name of volume to be restored>> >>>
+    S<<< [B<-f> <I<dump file>>] >>>
+    S<<< [B<-i> <I<volume ID>>] >>>
+    S<<< [B<-ov> (a | f | i)] >>>
+    [B<-of>] [B<-r>]
+    S<<< [B<-cr> (d | k | n)] >>>
+    S<<< [B<-la> (d | k | n)] >>>
+    [B<-nod>] S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -169,6 +183,20 @@ current site.
 
 This argument is mandatory if the B<-file> argument is not provided.
 
+=item B<-offline>
+
+Leaves the new volume flagged as off-line in the volume database.
+
+=item B<-readonly>
+
+Flags the new volume as read-only in the volume database.
+
+=item B<-nodelete>
+
+This option is available in OpenAFS clients 1.4.7 or
+later and 1.5.31 or later. This option can be used with OpenAFS server
+versions 1.4.1 or later and 1.5.0 or later.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -194,6 +222,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index a65dfba..a80a3ea 100644 (file)
@@ -8,14 +8,16 @@ vos_setfields - Sets the quota or clear the access counter on a volume.
 <div class="synopsis">
 
 B<vos setfields> S<<< B<-id> <I<volume name or ID>> >>>
-    S<<< B<-maxquota> <I<quota>> >>> [B<-clearuse>]
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
+    S<<< B<-maxquota> <I<quota (KB)>> >>>
+    [B<-clearuse>] [B<-clearVolUpCounter>]
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
     [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos se> S<<< B<-id> <I<volume name or ID>> >>>
-    S<<< B<-maxquota> <I<quota>> >>> [B<-clearuse>]
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
-    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+    S<<< B<-m> <I<quota (KB)>> >>> [B<-cl>]
+    S<<< [B<-ce> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -55,9 +57,16 @@ the volume's size.
 
 =item B<-clearuse>
 
-Clears the access counter on a volumes, which is shown as C<X accesses in
+Clears the access counter on a volume, which is shown as C<X accesses in
 the past day (i.e., vnode references)> in the B<vos examine> output.
 
+=item B<-clearVolUpCounter>
+
+Clears the modification counter on a volume. The modification counter
+will increment with time and stop updating when it reaches the maximum
+value. This option will reset it to 0. This option is available in OpenAFS
+version 1.5.0 or later.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -77,24 +86,25 @@ to the Volume Server and Volume Location Server during mutual
 authentication. Do not combine this flag with the B<-cell> argument or
 B<-noauth> flag. For more details, see L<vos(1)>.
 
+=item B<-verbose>
+
+Produces on the standard output stream a detailed trace of the command's
+execution. If this argument is omitted, only warnings and error messages
+appear.
+
 =item B<-encrypt>
 
 Encrypts the command so that the operation's results are not transmitted
-across the network in clear text.
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
 
 =item B<-noresolve>
 
 Shows all servers as IP addresses instead of the DNS name. This is very
 useful when the server address is registered as 127.0.0.1 or when dealing
-with multi-homed servers. The B<-noresolve> option is available in OpenAFS
+with multi-homed servers. This option is available in OpenAFS
 versions 1.4.8 or later and 1.5.35 or later.
 
-=item B<-verbose>
-
-Produces on the standard output stream a detailed trace of the command's
-execution. If this argument is omitted, only warnings and error messages
-appear.
-
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index ee75981..4987ba2 100644 (file)
@@ -13,9 +13,22 @@ B<vos shadow> S<<< [B<-id>] <I<volume name or ID on source>> >>>
     S<<< [B<-toserver>] <I<machine name on destination>> >>>
     S<<< [B<-topartition>] <I<partition name on destination>> >>>
     S<<< [B<-toname> <I<volume name on destination>>] >>>
-    S<<< [B<-toid> <I<volume ID on destination>>] >>> [B<-offline>] [B<-readonly>]
-    [B<-live>] [B<-incremental>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>]
-    [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>]
+    S<<< [B<-toid> <I<volume ID on destination>>] >>>
+    [B<-offline>] [B<-readonly>] [B<-live>] [B<-incremental>]
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos sh> S<<< [B<-id>] <I<volume name or ID on source>> >>>
+    S<<< [B<-froms>] <I<machine name on source>> >>>
+    S<<< [B<-fromp>] <I<partition name on source>> >>>
+    S<<< [B<-tos>] <I<machine name on destination>> >>>
+    S<<< [B<-top>] <I<partition name on destination>> >>>
+    S<<< [B<-ton> <I<volume name on destination>>] >>>
+    S<<< [B<-toi> <I<volume ID on destination>>] >>>
+    [B<-o>] [B<-r>] [B<-l>] [B<-in>]
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -130,7 +143,15 @@ appear.
 =item B<-encrypt>
 
 Encrypts the command so that the operation's results are not transmitted
-across the network in clear text.
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
 =item B<-help>
 
index 9bcf6f0..07ccb7f 100644 (file)
@@ -7,12 +7,21 @@ vos_size - Computes the size of a volume dump
 =for html
 <div class="synopsis">
 
-B<vos size> S<<< [B<-cell> <I<cell name>>] >>> [B<-dump>]
-    [B<-encrypt>] [B<-help>] [B<-id>] <I<volume name or id>>
-    [B<-localauth>] [B<-noauth>]
+B<vos size> S<<< [B<-id>] <I<volume name or id>> >>>
     S<<< [B<-partition> <I<partition name>>] >>>
     S<<< [B<-server> <I<machine name>>] >>>
-    S<<< [B<-time> <I<dump from time>>] >>> [B<-verbose>]
+    [B<-dump>] S<<< [B<-time> <I<dump from time>>] >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>] 
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] 
+
+B<vos si> S<<< [B<-i>] <I<volume name or id>> >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    S<<< [B<-s> <I<machine name>>] >>>
+    [B<-d>] S<<< [B<-t> <I<dump from time>>] >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-no>] [B<-l>] 
+    [B<-v>] [B<-e>] [B<-nor>] [B<-h>] 
 
 =for html
 </div>
@@ -31,9 +40,20 @@ for example).
 
 =over 4
 
-=item B<-cell> <I<cell name>>
+=item B<-id> <I<volume name or id>>
 
-The cell in which the volume resides, if it's not in the current cell.
+Specifies either the complete name or volume ID number of the read/write,
+read-only, or backup volume to size.
+
+=item B<-partition> <I<partition name>>
+
+Specifies the partition on which the volume resides. Provide the
+B<-server> argument along with this one.
+
+=item B<-server> <I<machine name>>
+
+Specifies the file server machine on which the volume resides.  Provide
+the B<-partition> argument along with this one.
 
 =item B<-dump>
 
@@ -42,19 +62,20 @@ flag should always be given for B<vos size> to give useful information.
 It is present to allow this command to provide other size estimates in the
 future.
 
-=item B<-encrypt>
+=item B<-time> <I<dump from time>>
 
-Encrypt the command.
+Specifies whether the dump is full or incremental. Omit this argument to
+size a full dump. See L<vos_dump(1)> for the valid values for this
+option.
 
-=item B<-help>
+=item B<-cell> <I<cell name>>
 
-Prints the online help for this command. All other valid options are
-ignored.
+The cell in which the volume resides, if it's not in the current cell.
 
-=item B<-id> <I<volume name or id>>
+=item B<-noauth>
 
-Specifies either the complete name or volume ID number of the read/write,
-read-only, or backup volume to size.
+Assigns the unprivileged identity anonymous to the issuer. Do not combine
+this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
 
 =item B<-localauth>
 
@@ -64,30 +85,27 @@ to the Volume Server and Volume Location Server during mutual
 authentication. Do not combine this flag with the B<-cell> argument or
 B<-noauth> flag. For more details, see L<vos(1)>.
 
-=item B<-noauth>
-
-Assigns the unprivileged identity anonymous to the issuer. Do not combine
-this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
-
-=item B<-partition> <I<partition name>>
+=item B<-verbose>
 
-Specifies the partition on which the volume resides. Provide the
-B<-server> argument along with this one.
+Show more output about what's going on.
 
-=item B<-server> <I<machine name>>
+=item B<-encrypt>
 
-Specifies the file server machine on which the volume resides.  Provide
-the B<-partition> argument along with this one.
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
 
-=item B<-time> <I<dump from time>>
+=item B<-noresolve>
 
-Specifies whether the dump is full or incremental. Omit this argument to
-size a full dump. See L<vos_dump(1)> for the valid values for this
-option.
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
 
-=item B<-verbose>
+=item B<-help>
 
-Show more output about what's going on.
+Prints the online help for this command. All other valid options are
+ignored.
 
 =back
 
index 61bacef..12baada 100644 (file)
@@ -7,11 +7,14 @@ vos_status - Reports a Volume Server's status
 =for html
 <div class="synopsis">
 
-B<vos status> S<<< B<-server> <I<machine name>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+B<vos status> S<<< B<-server> <I<machine name>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos st> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>]
-    [B<-v>] [B<-h>]
+B<vos st> S<<< B<-s> <I<machine name>> >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -63,6 +66,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index a2c274c..793a13e 100644 (file)
@@ -8,11 +8,16 @@ vos_syncserv - Verifies VLDB entries that mention a specified site
 <div class="synopsis">
 
 B<vos syncserv> S<<< B<-server> <I<machine name>> >>>
-    S<<< [B<-partition> <I<partition name>>] >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-dryrun>] [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+    S<<< [B<-partition> <I<partition name>>] >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-dryrun>]
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos syncs> S<<< B<-s> <I<machine name>> >>> S<<< [B<-p> <I<partition name>>] >>>
-    S<<< [B<-c> <I<cell name>>] >>> [B<-d>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos syncs> S<<< B<-s> <I<machine name>> >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    S<<< [B<-c> <I<cell name>>] >>> [B<-d>]
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -84,6 +89,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index ab225c4..4f0db35 100644 (file)
@@ -8,13 +8,17 @@ vos_syncvldb - Verifies VLDB entries for volumes residing at specified site
 <div class="synopsis">
 
 B<vos syncvldb> S<<< [B<-server> <I<machine name>>] >>>
-    S<<< [B<-partition> <I<partition name>>] >>> S<<< [B<-volume> <I<volume name or ID>>] >>>
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-dryrun>] [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
-
-B<vos syncv> S<<< [B<-s> <I<machine name>>] >>> S<<< [B<-p> <I<partition name>>] >>>
-    S<<< [B<-vo> <I<volume name or ID>>] >>> S<<< [B<-c> <I<cell name>>] >>> [B<-d>] [B<-n>] [B<-l>]
-    [B<-ve>] [B<-h>]
+    S<<< [B<-partition> <I<partition name>>] >>>
+    S<<< [B<-volume> <I<volume name or ID>>] >>>
+    [B<-dryrun>] S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos syncv> S<<< [B<-s> <I<machine name>>] >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    S<<< [B<-vo> <I<volume name or ID>>] >>>
+    [B<-d>] S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-ve>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -108,6 +112,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 47b856f..be7e549 100644 (file)
@@ -7,11 +7,14 @@ vos_unlock - Unlocks a single VLDB entry
 =for html
 <div class="synopsis">
 
-B<vos unlock> S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+B<vos unlock> S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos unlock> S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
-    [B<-l>] [B<-v>] [B<-h>]
+B<vos unlock> S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -68,6 +71,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 5c9f876..ac93a2d 100644 (file)
@@ -8,11 +8,15 @@ vos_unlockvldb - Unlocks several locked VLDB entries
 <div class="synopsis">
 
 B<vos unlockvldb> S<<< [B<-server> <I<machine name>>] >>>
-    S<<< [B<-partition> <I<partition name>>] >>> S<<< [B<-cell> <I<cell name>>] >>>
-    [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
+    S<<< [B<-partition> <I<partition name>>] >>>
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
-B<vos unlockv> S<<< [B<-s> <I<machine name>>] >>> S<<< [B<-p> <I<partition name>>] >>>
-    S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+B<vos unlockv> S<<< [B<-s> <I<machine name>>] >>>
+    S<<< [B<-p> <I<partition name>>] >>>
+    S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -105,6 +109,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are
index 2026a3f..ae31fef 100644 (file)
@@ -7,14 +7,19 @@ vos_zap - Removes a volume from its site without writing to the VLDB
 =for html
 <div class="synopsis">
 
-B<vos zap> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>>
-    S<<< B<-id> <I<volume ID>> >>> [B<-force>] [B<-backup>]
-    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
-
-B<vos z> S<<< B<-s> <I<machine name>> >>> S<<< B<-p> <I<partition name>> >>>
-    S<<< B<-i> <I<volume ID>> >>> [B<-f>] [B<-b>] S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
-    [B<-l>] [B<-v>] [B<-h>]
+B<vos zap> S<<< B<-server> <I<machine name>> >>>
+    S<<< B<-partition> <I<partition name>> >>>
+    S<<< B<-id> <I<volume ID>> >>>
+    [B<-force>] [B<-backup>]
+    S<<< [B<-cell> <I<cell name>>] >>>
+    [B<-noauth>] [B<-localauth>]
+    [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
+
+B<vos z> S<<< B<-s> <I<machine name>> >>>
+    S<<< B<-p> <I<partition name>> >>>
+    S<<< B<-i> <I<volume ID>> >>>
+    [B<-f>] [B<-b>] S<<< [B<-c> <I<cell name>>] >>>
+    [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
 </div>
@@ -124,6 +129,19 @@ Produces on the standard output stream a detailed trace of the command's
 execution. If this argument is omitted, only warnings and error messages
 appear.
 
+=item B<-encrypt>
+
+Encrypts the command so that the operation's results are not transmitted
+across the network in clear text. This option is available in OpenAFS
+versions 1.4.11 or later and 1.5.60 or later.
+
+=item B<-noresolve>
+
+Shows all servers as IP addresses instead of the DNS name. This is very
+useful when the server address is registered as 127.0.0.1 or when dealing
+with multi-homed servers. This option is available in OpenAFS
+versions 1.4.8 or later and 1.5.35 or later.
+
 =item B<-help>
 
 Prints the online help for this command. All other valid options are