]> git.michaelhowe.org Git - packages/o/openafs.git/commitdiff
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 11b69840cb7d02b3da3018be9ee0a3701961e2c9..3d831917ac0a46d2c513824977ec1a681b2c9f1b 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 ac6a9cf0c6d2f94f2d21bc410720e4ff42d9c975..9b98eef6a438c4aec49511822afeb16658aa6aa5 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 19312dbe7bd74bf276f3da2512e1dab0fd79ca2f..f35c6e6d1ad77dc2d4c537c781ea33baf6ea4b91 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 8a12c5a61b2d5dfe46b26defac4c8b7c10f45eea..9c98586c8fd294bf4130d0b0c448ccffff95abd1 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 02d9fb816f69c28a89dd47aa2037fbc0db9e57c4..432705ab163f5050fecbfd575347b913330c3fcd 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 a4b02860b200634fcc5f6482da1606c66fb5c0b8..341e89eb92e60871b7b1293e49d91235afdf4ea1 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 51264d1521eb5a250d16b09e27ed592abd9fffe3..36df86fc9b65b074fb9793922ee1d8bec71ae5d7 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 bc8b3063510e889d58f1f51818c0b7b31652e69e..580993cd65be5c77edfdf57e8c8eaf774f8bca1f 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 6d291457fc4448074a307efe28191366423e8be2..b0c3bd97749b905fdafd23a527e6c7db55b9694d 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 0c329ada7aa498d082bf93453425e44ca665c04a..89dad2c110114856058cef4cfab373efd33994da 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 b28bb8c3c12c15a3ae8533a750cbeee6e8816dda..c5d36df2b70a0ae9d5a3ee3ddbdb4d1c4ce4f50f 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 76b028f9246d991f54a3dcdaa2111ed3037fef99..a11e5ed41364655a58742db79f9d3ce4d799a3d7 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 4f5d00a7668f40a5bad5d6b9c6bad7bc1bbde976..16161f19202828fe86b05fc2b07468152b3ad14f 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 3e4fbae61cb9ab72e0f49dacce78a03cfa66d280..b7712a7144eca8c6ee7542673eebdbe315d594e8 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 e924bd55ffef8db5a0166f171c75d79c53771773..23ad61fb1cce4c989f729736320bf8f23240ae75 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 f9947c62b2a2683f349be9da1180f7b2f74cb006..343ed965fbcad73eed49d81dedd9f12bab5f55d5 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 32d57d57d3147119e3a8502aed2ec2ce66cb0694..f3383e8497fbfa91c6d2024ab5122c96bf2bdd90 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 ef84a5ff193ff579f0d91a86feb65deb2e731212..5deff0aade9f3428a563e987a10491d39e532b58 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 fa9233317443590d7ed2dec9e4ae5e8605e65df0..4787196e3d6551ae598f658f9b4f205763539d84 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 b00a039a6f5024e7d0040accd78d06f325d79c3e..84b7b9786cbe1df03a11e35d97069e7e1c234f0a 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 e430a188dfcd8fa1c8127af2cb667007c29baa33..2f9b0cf1e39ec56109e3887ee5a5a4d46acf1169 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 543906428d9ae9a0793bb60c3647d34251117797..483a9427560e68350a38e391f1f7a3ea629ee8d7 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 37a4345ff9782d60980a7cd657fb102882ed6ced..0115dff108d95eb1c18e1039a6c3fb2f387f5867 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 820006eddaea150387b30008a67bcef8ad5fb325..8c36b4d3a78db472c2969de7565487c296968740 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 e455f8eed1bc2048bfa8b9d7cf3483ca4a0a6b28..691bacc1e1f65e144e51a4749cb6b5500491b130 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 5480acaf06df3396303d33792b2ea268edbb5513..589c44d93549c481c59f8bd7c35f89b923d23c20 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 c5005c1616a4bdecd6c4d37e6dd397d1ced5706d..669120ffde25ee8cf89c84a37a14c95d334be593 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 a65dfba6be63b3eb19832bfc67f8a156b1e6500e..a80a3ea59da820f5f0158c428284b1d8fe4dabee 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 ee7598154cac81e7f454b046cc11f79e4941d68a..4987ba298f4a05f7ab343517bfb0fb730ed2f682 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 9bcf6f0f9e386db2e755628fd08552568651296f..07ccb7f555a4190c5da77c4c5fa62257a82c7350 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 61bacef3a94f98fea7b72ebb95043e87c93bdf05..12baada9dbbab44c9655afd68802706013fabd45 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 a2c274cfac4f3ee0e323696fa378a9affad24215..793a13edab6c2abb705e4f199aa55c6babc547f3 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 ab225c498e4787f091a98000901c5929f8dc731a..4f0db35d297ddfc91b1661d9e8ec3b73326b8e1a 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 47b856f7a3116aef90d8aa57eba8be84b1f9de6f..be7e549a3daeb963c1e53ce0ea4d86fcb96b267f 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 5c9f8763f7c9db3918984d57bcc96cecac86aa2a..ac93a2d8b29e5e34f10090ceea28473a56c46ed6 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 2026a3f6ef00f4832458173700e166ecba1abb73..ae31fefce4b691065376c4e2279066140fe2a208 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