From c717fcd32cabbc9651b81ef3d0cea11d3a6ecd57 Mon Sep 17 00:00:00 2001 From: Davor Ocelic Date: Thu, 8 Oct 2009 19:31:00 +0200 Subject: [PATCH] Update vos suite manpages 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 Reviewed-by: Derrick Brashear --- doc/man-pages/pod1/vos.pod | 91 +++++++++++++++--------- doc/man-pages/pod1/vos_addsite.pod | 23 ++++-- doc/man-pages/pod1/vos_backup.pod | 23 ++++-- doc/man-pages/pod1/vos_backupsys.pod | 28 ++++++-- doc/man-pages/pod1/vos_changeaddr.pod | 21 +++++- doc/man-pages/pod1/vos_changeloc.pod | 16 ++++- doc/man-pages/pod1/vos_clone.pod | 25 +++++-- doc/man-pages/pod1/vos_convertROtoRW.pod | 18 ++++- doc/man-pages/pod1/vos_copy.pod | 23 +++++- doc/man-pages/pod1/vos_create.pod | 32 ++++++--- doc/man-pages/pod1/vos_delentry.pod | 25 +++++-- doc/man-pages/pod1/vos_dump.pod | 28 ++++++-- doc/man-pages/pod1/vos_examine.pod | 38 +++++++--- doc/man-pages/pod1/vos_listaddrs.pod | 37 +++++++++- doc/man-pages/pod1/vos_listpart.pod | 23 ++++-- doc/man-pages/pod1/vos_listvldb.pod | 31 ++++++-- doc/man-pages/pod1/vos_listvol.pod | 35 +++++++-- doc/man-pages/pod1/vos_lock.pod | 24 +++++-- doc/man-pages/pod1/vos_move.pod | 22 ++++-- doc/man-pages/pod1/vos_offline.pod | 32 +++++++-- doc/man-pages/pod1/vos_online.pod | 27 +++++-- doc/man-pages/pod1/vos_partinfo.pod | 29 ++++++-- doc/man-pages/pod1/vos_release.pod | 29 ++++++-- doc/man-pages/pod1/vos_remove.pod | 27 +++++-- doc/man-pages/pod1/vos_remsite.pod | 33 ++++++--- doc/man-pages/pod1/vos_rename.pod | 24 +++++-- doc/man-pages/pod1/vos_restore.pod | 61 +++++++++++++--- doc/man-pages/pod1/vos_setfields.pod | 38 ++++++---- doc/man-pages/pod1/vos_shadow.pod | 29 ++++++-- doc/man-pages/pod1/vos_size.pod | 80 +++++++++++++-------- doc/man-pages/pod1/vos_status.pod | 24 +++++-- doc/man-pages/pod1/vos_syncserv.pod | 26 +++++-- doc/man-pages/pod1/vos_syncvldb.pod | 31 ++++++-- doc/man-pages/pod1/vos_unlock.pod | 24 +++++-- doc/man-pages/pod1/vos_unlockvldb.pod | 25 +++++-- doc/man-pages/pod1/vos_zap.pod | 34 ++++++--- 36 files changed, 889 insertions(+), 247 deletions(-) diff --git a/doc/man-pages/pod1/vos.pod b/doc/man-pages/pod1/vos.pod index 11b69840c..3d831917a 100644 --- a/doc/man-pages/pod1/vos.pod +++ b/doc/man-pages/pod1/vos.pod @@ -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 command to unlock it before -proceeding. +administrator must use the L|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 and @@ -32,7 +32,8 @@ volume headers, respectively. If a B 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 and B commands. +use the L|vos_syncserv(1)> and +L|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, B, B, B, B, and B. +Commands to create, move, and rename volumes: +L|vos_backup(1)>, +L|vos_backupsys(1)>, +L|vos_changeloc(1)>, +L|vos_create(1)>, +L|vos_move(1)>, +and L|vos_rename(1)>. =item * -Commands to remove VLDB volume records or volumes or both: B, B, and B. +Commands to remove VLDB volume records or volumes or both: +L|vos_delentry(1)>, +L|vos_remove(1)>, +and L|vos_zap(1)>. =item * -Commands to edit or display VLDB server entries: B and -B. +Commands to edit or display VLDB server entries: +L|vos_changeaddr(1)> +and L|vos_listaddrs(1)>. =item * -Commands to create, size, and restore dump files: B, B, and B. +Commands to create, size, and restore dump files: +L|vos_dump(1)>, +L|vos_restore(1)>, +and L|vos_size(1)>. =item * -Commands to administer replicated volumes: B, B, -and B. +Commands to administer replicated volumes: +L|vos_addsite(1)>, +L|vos_release(1)>, +and L|vos_remsite(1)>. =item * -Commands to display VLDB records, volume headers, or both: B, -B, and B. +Commands to display VLDB records, volume headers, or both: +L|vos_examine(1)>, +L|vos_listvldb(1)>, +and L|vos_listvol(1)>. =item * -Commands to display information about partitions that house volumes: B and B. +Commands to display information about partitions that house volumes: +L|vos_listpart(1)> +and L|vos_partinfo(1)>. =item * -Commands to restore consistency between the VLDB and volume headers: B and B. +Commands to restore consistency between the VLDB and volume headers: +L|vos_syncserv(1)> +and L|vos_syncvldb(1)>. =item * -Commands to lock and unlock VLDB entries: B, B, and -B. +Commands to lock and unlock VLDB entries: +L|vos_lock(1)>, +L|vos_unlock(1)>, +and L|vos_unlockvldb(1)>. =item * -A command to report Volume Server status: B. +A command to report Volume Server status: +L|vos_status(1)>. =item * -A command to change volume fields: B. +A command to change volume fields: +L|vos_setfields(1)>. =item * -Commands to obtain help: B and B. +Commands to obtain help: +L|vos_apropos(1)> +and L|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. 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 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|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> > @@ -198,8 +221,8 @@ and so on through /vicepiv = vicepiv = iv = 255 -The B<-frompartition> and B<-topartition> arguments to the B -command also accept this notation. +The B<-frompartition> and B<-topartition> arguments to the +L|vos_move(1)> command also accept this notation. =item B<-server> > @@ -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 command -also accept these name formats. +The B<-fromserver> and B<-toserver> arguments to the +L|vos_move(1)> command also accept these name formats. =item B<-noresolve> diff --git a/doc/man-pages/pod1/vos_addsite.pod b/doc/man-pages/pod1/vos_addsite.pod index ac6a9cf0c..9b98eef6a 100644 --- a/doc/man-pages/pod1/vos_addsite.pod +++ b/doc/man-pages/pod1/vos_addsite.pod @@ -13,13 +13,14 @@ B S<<< B<-server> > >>> S<<< [B<-roid> >] >>> [B<-valid>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-help>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< B<-s> > >>> S<<< B<-p> > >>> S<<< B<-i> > >>> S<<< [B<-r> >] >>> - [B<-va>] [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] + [B<-va>] [B<-c> >] >>> [B<-noa>] [B<-l>] + [B<-ve>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -85,7 +86,8 @@ have a readonly volume ID, a volume ID for the readonly volume will be allocated for it when the B 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> > @@ -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 diff --git a/doc/man-pages/pod1/vos_backup.pod b/doc/man-pages/pod1/vos_backup.pod index 19312dbe7..f35c6e6d1 100644 --- a/doc/man-pages/pod1/vos_backup.pod +++ b/doc/man-pages/pod1/vos_backup.pod @@ -7,11 +7,13 @@ vos_backup - Creates a backup volume for a single read/write volume =for html
-B S<<< B<-id> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] +B S<<< B<-id> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] [B<-verbose>] + [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> [B<-c>>] - [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-i> > >>> [B<-c> >] + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_backupsys.pod b/doc/man-pages/pod1/vos_backupsys.pod index 8a12c5a61..9c98586c8 100644 --- a/doc/man-pages/pod1/vos_backupsys.pod +++ b/doc/man-pages/pod1/vos_backupsys.pod @@ -8,15 +8,18 @@ vos_backupsys - Creates a backup volume for several read/write volumes
B S<<< [B<-prefix> >+] >>> - S<<< [B<-server> >] >>> S<<< [B<-partition> >] >>> + S<<< [B<-server> >] >>> + S<<< [B<-partition> >] >>> [B<-exclude>] S<<< [B<-xprefix> >+] >>> - [B<-dryrun>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-help>] + [B<-dryrun>] S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< [B<-pr> >+] >>> - S<<< [B<-s> >] >>> S<<< [B<-pa> >] >>> [B<-e>] - S<<< [B<-x> >+] >>> [B<-d>] - S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] + S<<< [B<-s> >] >>> S<<< [B<-pa> >] >>> + [B<-ex>] S<<< [B<-x> >+] >>> [B<-d>] + S<<< [B<-c> >] >>> [B<-noa>] [B<-l>] [B<-v>] + [B<-en>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_changeaddr.pod b/doc/man-pages/pod1/vos_changeaddr.pod index 02d9fb816..432705ab1 100644 --- a/doc/man-pages/pod1/vos_changeaddr.pod +++ b/doc/man-pages/pod1/vos_changeaddr.pod @@ -10,10 +10,12 @@ vos_changeaddr - Changes or removes a file server machine's entry in the VLDB B S<<< B<-oldaddr> > >>> S<<< [B<-newaddr> >] >>> [B<-remove>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-help>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-o> > >>> S<<< [B<-ne> >] >>> - [B<-r>] S<<< [B<-c> >] >>> [B<-no>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-o> > >>> + S<<< [B<-ne> >] >>> [B<-r>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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 diff --git a/doc/man-pages/pod1/vos_changeloc.pod b/doc/man-pages/pod1/vos_changeloc.pod index a4b02860b..341e89eb9 100644 --- a/doc/man-pages/pod1/vos_changeloc.pod +++ b/doc/man-pages/pod1/vos_changeloc.pod @@ -11,12 +11,13 @@ B S<<< [B<-server>] > >>> S<<< [B<-partition>] > >>> S<<< [B<-id>] > >>> S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-encrypt>] [B<-help>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< [B<-s>] > >>> S<<< [B<-p>] > >>> S<<< [B<-i>] > >>> - S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-e>] [B<-h>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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> diff --git a/doc/man-pages/pod1/vos_clone.pod b/doc/man-pages/pod1/vos_clone.pod index 51264d152..36df86fc9 100644 --- a/doc/man-pages/pod1/vos_clone.pod +++ b/doc/man-pages/pod1/vos_clone.pod @@ -11,9 +11,18 @@ B S<<< [B<-id>] > >>> S<<< [B<-server>] > >>> S<<< [B<-partition>] > >>> S<<< [B<-toname> >] >>> - S<<< [B<-toid> >] >>> [B<-offline>] [B<-readonly>] - S<<< [B<-cell> >] >>> [B<-noauth>] - [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>] + S<<< [B<-toid> >] >>> + [B<-offline>] [B<-readonly>] + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< [B<-i>] > >>> + S<<< [B<-s>] > >>> + S<<< [B<-p>] > >>> + S<<< [B<-ton> >] >>> + S<<< [B<-toi> >] >>> [B<-o>] [B<-r>] + S<<< [B<-c> >] >>> [B<-noa>] + [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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> diff --git a/doc/man-pages/pod1/vos_convertROtoRW.pod b/doc/man-pages/pod1/vos_convertROtoRW.pod index bc8b30635..580993cd6 100644 --- a/doc/man-pages/pod1/vos_convertROtoRW.pod +++ b/doc/man-pages/pod1/vos_convertROtoRW.pod @@ -11,7 +11,13 @@ B S<<< [B<-server>] > >>> S<<< [B<-partition>] > >>> S<<< [B<-id>] > >>> [B<-force>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-encrypt>] [B<-help>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< [B<-s>] > >>> + S<<< [B<-p>] > >>> + S<<< [B<-i>] > >>> [B<-f>] + S<<< [B<-c> >] >>> [B<-noa>] [B<-l>] + [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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> diff --git a/doc/man-pages/pod1/vos_copy.pod b/doc/man-pages/pod1/vos_copy.pod index 6d291457f..b0c3bd977 100644 --- a/doc/man-pages/pod1/vos_copy.pod +++ b/doc/man-pages/pod1/vos_copy.pod @@ -14,7 +14,18 @@ B S<<< [B<-id>] > >>> S<<< [B<-toserver>] > >>> S<<< [B<-topartition>] > >>> [B<-offline>] [B<-readonly>] [B<-live>] S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>] + [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-noresolve>] + [B<-help>] + +B S<<< [B<-i>] > >>> + S<<< [B<-froms>] > >>> + S<<< [B<-fromp>] > >>> + S<<< [B<-ton>] > >>> + S<<< [B<-tos>] > >>> + S<<< [B<-top>] > >>> + [B<-o>] [B<-r>] [B<-li>] S<<< [B<-c> >] >>> + [B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] + [B<-h>] =for html @@ -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> diff --git a/doc/man-pages/pod1/vos_create.pod b/doc/man-pages/pod1/vos_create.pod index 0c329ada7..89dad2c11 100644 --- a/doc/man-pages/pod1/vos_create.pod +++ b/doc/man-pages/pod1/vos_create.pod @@ -7,16 +7,18 @@ vos_create - Creates a read/write volume and associated VLDB entry =for html
-B S<<< B<-server> > >>> S<<< B<-partition> > >>> - S<<< B<-name> > >>> S<<< [B<-maxquota> >] >>> - S<<< [B<-id> >] >>> S<<< [B<-roid> >] >>> - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] +B S<<< B<-server> > >>> + S<<< B<-partition> > >>> + S<<< B<-name> > >>> + S<<< [B<-maxquota> >] >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] [B<-verbose>] + [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< B<-s> > >>> S<<< B<-p> > >>> S<<< B<-na> > >>> S<<< [B<-m> >] >>> - S<<< [B<-i> >] >>> S<<< [B<-r> >] >>> - S<<< [B<-c> >] >>> [B<-no>] [B<-l>] [B<-v>] [B<-h>] + S<<< [B<-c> >] >>> [B<-noa>] [B<-l>] [B<-v>] + [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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> > @@ -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 diff --git a/doc/man-pages/pod1/vos_delentry.pod b/doc/man-pages/pod1/vos_delentry.pod index b28bb8c3c..c5d36df2b 100644 --- a/doc/man-pages/pod1/vos_delentry.pod +++ b/doc/man-pages/pod1/vos_delentry.pod @@ -8,15 +8,17 @@ vos_delentry - Removes a volume entry from the VLDB.
B S<<< [B<-id> >+] >>> - S<<< [B<-prefix> >] >>> - S<<< [B<-server> >] >>> S<<< [B<-partition> >] >>> - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] + S<<< [B<-prefix> >] >>> + S<<< [B<-server> >] >>> + S<<< [B<-partition> >] >>> + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< [B<-i> >+] >>> S<<< [B<-pr> >] >>> S<<< [B<-s> >] >>> S<<< [B<-pa> >] >>> - S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] + S<<< [B<-c> >] >>> [B<-noa>] [B<-l>] + [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_dump.pod b/doc/man-pages/pod1/vos_dump.pod index 76b028f92..a11e5ed41 100644 --- a/doc/man-pages/pod1/vos_dump.pod +++ b/doc/man-pages/pod1/vos_dump.pod @@ -7,16 +7,19 @@ vos_dump - Converts a volume into ASCII format and writes it to a file =for html
-B S<<< B<-id> > >>> S<<< [B<-time> >] >>> +B S<<< B<-id> > >>> + S<<< [B<-time> >] >>> S<<< [B<-file> >] >>> S<<< [B<-server> >] >>> S<<< [B<-partition> >] >>> [B<-clone>] [B<-omitdirs>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-help>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> S<<< [B<-t> >] >>> - S<<< [B<-f> >] >>> S<<< [B<-s> >] >>> S<<< [B<-p> >] >>> - [B<-cl>] [B<-o>] S<<< [B<-ce> >] >>> [B<-n>] [B<-l>] - [B<-v>] [B<-h>] +B S<<< B<-i> > >>> + S<<< [B<-t> >] >>> + S<<< [B<-f> >] >>> S<<< [B<-s> >] >>> + S<<< [B<-p> >] >>> + [B<-cl>] [B<-o>] S<<< [B<-ce> >] >>> [B<-noa>] [B<-l>] + [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_examine.pod b/doc/man-pages/pod1/vos_examine.pod index 4f5d00a76..16161f192 100644 --- a/doc/man-pages/pod1/vos_examine.pod +++ b/doc/man-pages/pod1/vos_examine.pod @@ -8,17 +8,22 @@ vos_examine - Shows volume header and VLDB entry information for a volume
B S<<< B<-id> > >>> [B<-extended>] - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] + [B<-format>] S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] [B<-verbose>] + [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> [B<-e>] S<<< [B<-c> >] >>> - [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-i> > >>> [B<-ex>] [B<-f>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] -B S<<< B<-i> > >>> [B<-e>] [-c >] - [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-id> > >>> [B<-extended>] + [B<-format>] S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] [B<-verbose>] + [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> [B<-e>] S<<< [B<-c> >] >>> - [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-i> > >>> [B<-ex>] [B<-f>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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> > 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 diff --git a/doc/man-pages/pod1/vos_listaddrs.pod b/doc/man-pages/pod1/vos_listaddrs.pod index 3e4fbae61..b7712a714 100644 --- a/doc/man-pages/pod1/vos_listaddrs.pod +++ b/doc/man-pages/pod1/vos_listaddrs.pod @@ -7,10 +7,15 @@ vos_listaddrs - Displays all VLDB server entries =for html
-B S<<< [B<-cell> >] >>> [B<-noauth>] - [B<-localauth>] [B<-verbose>] [B<-help>] +B S<<< [B<-uuid> >] >>> + S<<< [B<-host> >] >>> [B<-printuuid>] + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B [B<-u> >] >>> + S<<< [B<-h> >] >>> [B<-p>] + S<<< [B<-c> >] >>> [B<-noa>] [B<-l>] + [B<-v>] [B<-e>] [B<-nor>] [B<-he>] =for html
@@ -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> > 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, L, L, L, diff --git a/doc/man-pages/pod1/vos_listpart.pod b/doc/man-pages/pod1/vos_listpart.pod index e924bd55f..23ad61fb1 100644 --- a/doc/man-pages/pod1/vos_listpart.pod +++ b/doc/man-pages/pod1/vos_listpart.pod @@ -7,11 +7,13 @@ vos_listpart - Displays all AFS partitions on a file server machine =for html
-B S<<< B<-server> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] +B S<<< B<-server> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-s> > >>> S<<< [B<-c> >] >>> [B<-n>] - [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-s> > >>> S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_listvldb.pod b/doc/man-pages/pod1/vos_listvldb.pod index f9947c62b..343ed965f 100644 --- a/doc/man-pages/pod1/vos_listvldb.pod +++ b/doc/man-pages/pod1/vos_listvldb.pod @@ -8,13 +8,17 @@ vos_listvldb - Displays a volume's VLDB entry
B S<<< [B<-name> >] >>> - S<<< [B<-server> >] >>> S<<< [B<-partition> >] >>> - [B<-locked>] [B<-quiet>] [B<-nosort>] S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] - -B S<<< [B<-na> >] >>> S<<< [B<-s> >] >>> - S<<< [B<-p> >] >>> [B<-lock>] [B<-q>] [B<-nos>] - S<<< [B<-c> >] >>> [B<-noa>] [B<-loca>] [B<-v>] [B<-h>] + S<<< [B<-server> >] >>> + S<<< [B<-partition> >] >>> + [B<-locked>] [B<-quiet>] [B<-nosort>] + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< [B<-na> >] >>> + S<<< [B<-s> >] >>> + S<<< [B<-p> >] >>> + [B<-lock>] [B<-q>] [B<-nos>] S<<< [B<-c> >] >>> + [B<-noa>] [B<-loca>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_listvol.pod b/doc/man-pages/pod1/vos_listvol.pod index 32d57d57d..f3383e849 100644 --- a/doc/man-pages/pod1/vos_listvol.pod +++ b/doc/man-pages/pod1/vos_listvol.pod @@ -8,13 +8,17 @@ vos_listvol - Displays information from a volume header
B S<<< B<-server> > >>> - S<<< [B<-partition> >] >>> [B<-fast>] [B<-long>] [B<-quiet>] - [B<-extended>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-help>] - -B S<<< B<-s> > >>> S<<< [B<-p> >] >>> [B<-f>] - [-lon] [B<-q>] [B<-e>] S<<< [B<-c> >] >>> [B<-n>] [B<-loc>] - [B<-v>] [B<-h>] + S<<< [B<-partition> >] >>> + [B<-fast>] [B<-long>] [B<-quiet>] + [B<-extended>] [B<-format>] + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< B<-s> > >>> + S<<< [B<-p> >] >>> + [B<-fa>] [-lon] [B<-q>] [B<-ex>] [B<-fo>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-loc>] [B<-v>] [B<-en>] [B<-nor>] [B<-h>] =for html
@@ -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> > 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 diff --git a/doc/man-pages/pod1/vos_lock.pod b/doc/man-pages/pod1/vos_lock.pod index ef84a5ff1..5deff0aad 100644 --- a/doc/man-pages/pod1/vos_lock.pod +++ b/doc/man-pages/pod1/vos_lock.pod @@ -7,11 +7,14 @@ vos_lock - Locks a VLDB volume entry =for html
-B S<<< B<-id> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] +B S<<< B<-id> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> S<<< [B<-c> >] >>> [B<-n>] - [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-i> > >>> + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_move.pod b/doc/man-pages/pod1/vos_move.pod index fa9233317..4787196e3 100644 --- a/doc/man-pages/pod1/vos_move.pod +++ b/doc/man-pages/pod1/vos_move.pod @@ -12,15 +12,16 @@ B S<<< B<-id> > >>> S<<< B<-frompartition> > >>> S<<< B<-toserver> > >>> S<<< B<-topartition> > >>> - [B<-live>] S<<< [B<-cell> >] >>> [B<-noauth>] - [B<-localauth>] [B<-verbose>] [B<-help>] + [B<-live>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< B<-i> > >>> S<<< B<-froms> > >>> S<<< B<-fromp> > >>> S<<< B<-tos> > >>> - S<<< B<-top> > >>> [B<-li>] - S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] + S<<< B<-top> > >>> + [B<-li>] S<<< [B<-c> >] >>> [B<-noa>] + [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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 diff --git a/doc/man-pages/pod1/vos_offline.pod b/doc/man-pages/pod1/vos_offline.pod index b00a039a6..84b7b9786 100644 --- a/doc/man-pages/pod1/vos_offline.pod +++ b/doc/man-pages/pod1/vos_offline.pod @@ -7,9 +7,21 @@ vos_offline - Takes a volume offline =for html
-B S<<< B<-server> > >>> S<<< B<-partition> > >>> - S<<< B<-id> > >>> S<<< [B<-unbless>] >>> S<<< [B<-cell> >] >>> - S<<< [B<-noauth>] | B<-localauth>] >>> S<<< [B<-verbose>] >>> S<<< [B<-encrypt>] >>> S<<< [B<-help>] >>> +B S<<< B<-server> > >>> + S<<< B<-partition> > >>> + S<<< B<-id> > >>> + S<<< [B<-sleep> >] >>> + [B<-busy>] S<<< [B<-cell> >] >>> + [B<-noauth>] B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< B<-se> > >>> + S<<< B<-p> > >>> + S<<< B<-i> > >>> + S<<< [B<-sl> >] >>> + [B<-b>] S<<< [B<-c> >] >>> + [B<-noa>] B<-l>] + [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 without B<-bless> will not bring it online: % vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs \ - -unbless + -unbless =head1 PRIVILEGE REQUIRED diff --git a/doc/man-pages/pod1/vos_online.pod b/doc/man-pages/pod1/vos_online.pod index e430a188d..2f9b0cf1e 100644 --- a/doc/man-pages/pod1/vos_online.pod +++ b/doc/man-pages/pod1/vos_online.pod @@ -7,9 +7,18 @@ vos_online - Brings a volume online =for html
-B S<<< B<-server> > >>> S<<< B<-partition> > >>> - S<<< B<-id> > >>> S<<< [B<-bless>] >>> S<<< [B<-cell> >] >>> - S<<< [B<-noauth>] | B<-localauth>] >>> S<<< [B<-verbose>] >>> S<<< [B<-encrypt>] >>> S<<< [B<-help>] >>> +B S<<< B<-server> > >>> + S<<< B<-partition> > >>> + S<<< B<-id> > >>> + [B<-bless>] S<<< [B<-cell> >] >>> + [B<-noauth>] B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< B<-s> > >>> + S<<< B<-p> > >>> + S<<< B<-i> > >>> + [B<-b>] S<<< [B<-c> >] >>> + [B<-noa>] B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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> diff --git a/doc/man-pages/pod1/vos_partinfo.pod b/doc/man-pages/pod1/vos_partinfo.pod index 543906428..483a94275 100644 --- a/doc/man-pages/pod1/vos_partinfo.pod +++ b/doc/man-pages/pod1/vos_partinfo.pod @@ -8,11 +8,15 @@ vos_partinfo - Reports the available and total space on a partition
B S<<< B<-server> > >>> - S<<< [B<-partition> >] >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] + S<<< [B<-partition> >] >>> [B<-summary>] + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-s> > >>> S<<< [B<-p> >] >>> - S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-se> > >>> + S<<< [B<-p> >] >>> [B<-su>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -48,6 +52,10 @@ partition's complete name with preceding slash (for example, C) or use one of the three acceptable abbreviated forms. For details, see L. +=item B<-summary> + +Prints storage summary. + =item B<-cell> > 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 diff --git a/doc/man-pages/pod1/vos_release.pod b/doc/man-pages/pod1/vos_release.pod index 37a4345ff..0115dff10 100644 --- a/doc/man-pages/pod1/vos_release.pod +++ b/doc/man-pages/pod1/vos_release.pod @@ -7,12 +7,14 @@ vos_release - Updates read-only volumes to match the read/write source volume =for html
-B S<<< B<-id> > >>> [B<-f>] - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] +B S<<< B<-id> > >>> [B<-force>] + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> [B<-f>] S<<< [B<-c> >] >>> - [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-i> > >>> + [B<-f>] S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_remove.pod b/doc/man-pages/pod1/vos_remove.pod index 820006edd..8c36b4d3a 100644 --- a/doc/man-pages/pod1/vos_remove.pod +++ b/doc/man-pages/pod1/vos_remove.pod @@ -9,12 +9,16 @@ vos_remove - Removes a volume from a site B S<<< [B<-server> >] >>> S<<< [B<-partition> >] >>> - S<<< B<-id> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] + S<<< B<-id> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< [B<-s> >] >>> S<<< [B<-p> >] >>> - S<<< B<-i> > >>> S<<< [B<-c> >] >>> [B<-n>] [B<-l>] - [B<-v>] [B<-h>] +B S<<< [B<-s> >] >>> + S<<< [B<-p> >] >>> + S<<< B<-i> > >>> + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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 diff --git a/doc/man-pages/pod1/vos_remsite.pod b/doc/man-pages/pod1/vos_remsite.pod index e455f8eed..691bacc1e 100644 --- a/doc/man-pages/pod1/vos_remsite.pod +++ b/doc/man-pages/pod1/vos_remsite.pod @@ -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
B S<<< B<-server> > >>> - S<<< B<-partition> > >>> S<<< B<-id> > >>> - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] - -B S<<< B<-s> > >>> S<<< B<-p> > >>> - S<<< B<-i> > >>> S<<< [B<-c> >] >>> [B<-n>] [B<-l>] - [B<-v>] [B<-h>] + S<<< B<-partition> > >>> + S<<< B<-id> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< B<-s> > >>> + S<<< B<-p> > >>> + S<<< B<-i> > >>> + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_rename.pod b/doc/man-pages/pod1/vos_rename.pod index 5480acaf0..589c44d93 100644 --- a/doc/man-pages/pod1/vos_rename.pod +++ b/doc/man-pages/pod1/vos_rename.pod @@ -8,11 +8,14 @@ vos_rename - Renames a volume
B S<<< B<-oldname> > >>> - S<<< B<-newname> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] + S<<< B<-newname> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-o> > >>> S<<< B<-ne> > >>> - [-c >] [B<-no>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-o> > >>> + S<<< B<-ne> > >>> + [-c >] [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_restore.pod b/doc/man-pages/pod1/vos_restore.pod index c5005c161..669120ffd 100644 --- a/doc/man-pages/pod1/vos_restore.pod +++ b/doc/man-pages/pod1/vos_restore.pod @@ -7,16 +7,30 @@ vos_restore - Converts an ASCII dump file into an AFS volume =for html
-B S<<< B<-server> > >>> S<<< B<-partition> > >>> - S<<< B<-name> > >>> S<<< [B<-file> >] >>> - S<<< [B<-id> >] >>> S<<< [B<-overwrite> (abort | full | incremental)] >>> - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [-verbose] - [B<-help>] - -B S<<< B<-s> > >>> S<<< B<-p> > >>> - S<<< B<-na> > >>> S<<< [B<-f> >] >>> - S<<< [B<-i> >] >>> S<<< [B<-o> (a | f | i)] >>> S<<< [B<-c> >] >>> - [B<-no>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-server> > >>> + S<<< B<-partition> > >>> + S<<< B<-name> > >>> + S<<< [B<-file> >] >>> + S<<< [B<-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> >] >>> + [B<-noauth>] [B<-localauth>] + [-verbose] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< B<-s> > >>> + S<<< B<-p> > >>> + S<<< B<-na> > >>> + S<<< [B<-f> >] >>> + S<<< [B<-i> >] >>> + 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> >] >>> + [B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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> > 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 diff --git a/doc/man-pages/pod1/vos_setfields.pod b/doc/man-pages/pod1/vos_setfields.pod index a65dfba6b..a80a3ea59 100644 --- a/doc/man-pages/pod1/vos_setfields.pod +++ b/doc/man-pages/pod1/vos_setfields.pod @@ -8,14 +8,16 @@ vos_setfields - Sets the quota or clear the access counter on a volume.
B S<<< B<-id> > >>> - S<<< B<-maxquota> > >>> [B<-clearuse>] - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + S<<< B<-maxquota> > >>> + [B<-clearuse>] [B<-clearVolUpCounter>] + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] B S<<< B<-id> > >>> - S<<< B<-maxquota> > >>> [B<-clearuse>] - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] - [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + S<<< B<-m> > >>> [B<-cl>] + S<<< [B<-ce> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -55,9 +57,16 @@ the volume's size. =item B<-clearuse> -Clears the access counter on a volumes, which is shown as C in the B 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> > 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. +=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 diff --git a/doc/man-pages/pod1/vos_shadow.pod b/doc/man-pages/pod1/vos_shadow.pod index ee7598154..4987ba298 100644 --- a/doc/man-pages/pod1/vos_shadow.pod +++ b/doc/man-pages/pod1/vos_shadow.pod @@ -13,9 +13,22 @@ B S<<< [B<-id>] > >>> S<<< [B<-toserver>] > >>> S<<< [B<-topartition>] > >>> S<<< [B<-toname> >] >>> - S<<< [B<-toid> >] >>> [B<-offline>] [B<-readonly>] - [B<-live>] [B<-incremental>] S<<< [B<-cell> >] >>> [B<-noauth>] - [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>] + S<<< [B<-toid> >] >>> + [B<-offline>] [B<-readonly>] [B<-live>] [B<-incremental>] + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< [B<-id>] > >>> + S<<< [B<-froms>] > >>> + S<<< [B<-fromp>] > >>> + S<<< [B<-tos>] > >>> + S<<< [B<-top>] > >>> + S<<< [B<-ton> >] >>> + S<<< [B<-toi> >] >>> + [B<-o>] [B<-r>] [B<-l>] [B<-in>] + S<<< [B<-c> >] >>> + [B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html @@ -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> diff --git a/doc/man-pages/pod1/vos_size.pod b/doc/man-pages/pod1/vos_size.pod index 9bcf6f0f9..07ccb7f55 100644 --- a/doc/man-pages/pod1/vos_size.pod +++ b/doc/man-pages/pod1/vos_size.pod @@ -7,12 +7,21 @@ vos_size - Computes the size of a volume dump =for html
-B S<<< [B<-cell> >] >>> [B<-dump>] - [B<-encrypt>] [B<-help>] [B<-id>] > - [B<-localauth>] [B<-noauth>] +B S<<< [B<-id>] > >>> S<<< [B<-partition> >] >>> S<<< [B<-server> >] >>> - S<<< [B<-time> >] >>> [B<-verbose>] + [B<-dump>] S<<< [B<-time> >] >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< [B<-i>] > >>> + S<<< [B<-p> >] >>> + S<<< [B<-s> >] >>> + [B<-d>] S<<< [B<-t> >] >>> + S<<< [B<-c> >] >>> + [B<-no>] [B<-l>] + [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -31,9 +40,20 @@ for example). =over 4 -=item B<-cell> > +=item B<-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> > + +Specifies the partition on which the volume resides. Provide the +B<-server> argument along with this one. + +=item B<-server> > + +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 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> > -Encrypt the command. +Specifies whether the dump is full or incremental. Omit this argument to +size a full dump. See L for the valid values for this +option. -=item B<-help> +=item B<-cell> > -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> > +=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. =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. -=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. - -=item B<-partition> > +=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> > +=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> > +=item B<-noresolve> -Specifies whether the dump is full or incremental. Omit this argument to -size a full dump. See L 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 diff --git a/doc/man-pages/pod1/vos_status.pod b/doc/man-pages/pod1/vos_status.pod index 61bacef3a..12baada9d 100644 --- a/doc/man-pages/pod1/vos_status.pod +++ b/doc/man-pages/pod1/vos_status.pod @@ -7,11 +7,14 @@ vos_status - Reports a Volume Server's status =for html
-B S<<< B<-server> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] +B S<<< B<-server> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-s> > >>> S<<< [B<-c> >] >>> [B<-n>] [B<-l>] - [B<-v>] [B<-h>] +B S<<< B<-s> > >>> + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_syncserv.pod b/doc/man-pages/pod1/vos_syncserv.pod index a2c274cfa..793a13eda 100644 --- a/doc/man-pages/pod1/vos_syncserv.pod +++ b/doc/man-pages/pod1/vos_syncserv.pod @@ -8,11 +8,16 @@ vos_syncserv - Verifies VLDB entries that mention a specified site
B S<<< B<-server> > >>> - S<<< [B<-partition> >] >>> S<<< [B<-cell> >] >>> - [B<-dryrun>] [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] + S<<< [B<-partition> >] >>> + S<<< [B<-cell> >] >>> + [B<-dryrun>] + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-s> > >>> S<<< [B<-p> >] >>> - S<<< [B<-c> >] >>> [B<-d>] [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-s> > >>> + S<<< [B<-p> >] >>> + S<<< [B<-c> >] >>> [B<-d>] + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_syncvldb.pod b/doc/man-pages/pod1/vos_syncvldb.pod index ab225c498..4f0db35d2 100644 --- a/doc/man-pages/pod1/vos_syncvldb.pod +++ b/doc/man-pages/pod1/vos_syncvldb.pod @@ -8,13 +8,17 @@ vos_syncvldb - Verifies VLDB entries for volumes residing at specified site
B S<<< [B<-server> >] >>> - S<<< [B<-partition> >] >>> S<<< [B<-volume> >] >>> - S<<< [B<-cell> >] >>> [B<-dryrun>] [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] - -B S<<< [B<-s> >] >>> S<<< [B<-p> >] >>> - S<<< [B<-vo> >] >>> S<<< [B<-c> >] >>> [B<-d>] [B<-n>] [B<-l>] - [B<-ve>] [B<-h>] + S<<< [B<-partition> >] >>> + S<<< [B<-volume> >] >>> + [B<-dryrun>] S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< [B<-s> >] >>> + S<<< [B<-p> >] >>> + S<<< [B<-vo> >] >>> + [B<-d>] S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-ve>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_unlock.pod b/doc/man-pages/pod1/vos_unlock.pod index 47b856f7a..be7e549a3 100644 --- a/doc/man-pages/pod1/vos_unlock.pod +++ b/doc/man-pages/pod1/vos_unlock.pod @@ -7,11 +7,14 @@ vos_unlock - Unlocks a single VLDB entry =for html
-B S<<< B<-id> > >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] +B S<<< B<-id> > >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< B<-i> > >>> S<<< [B<-c> >] >>> [B<-n>] - [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-i> > >>> + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_unlockvldb.pod b/doc/man-pages/pod1/vos_unlockvldb.pod index 5c9f8763f..ac93a2d8b 100644 --- a/doc/man-pages/pod1/vos_unlockvldb.pod +++ b/doc/man-pages/pod1/vos_unlockvldb.pod @@ -8,11 +8,15 @@ vos_unlockvldb - Unlocks several locked VLDB entries
B S<<< [B<-server> >] >>> - S<<< [B<-partition> >] >>> S<<< [B<-cell> >] >>> - [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] + S<<< [B<-partition> >] >>> + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] -B S<<< [B<-s> >] >>> S<<< [B<-p> >] >>> - S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] +B S<<< [B<-s> >] >>> + S<<< [B<-p> >] >>> + S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 diff --git a/doc/man-pages/pod1/vos_zap.pod b/doc/man-pages/pod1/vos_zap.pod index 2026a3f6e..ae31fefce 100644 --- a/doc/man-pages/pod1/vos_zap.pod +++ b/doc/man-pages/pod1/vos_zap.pod @@ -7,14 +7,19 @@ vos_zap - Removes a volume from its site without writing to the VLDB =for html
-B S<<< B<-server> > >>> S<<< B<-partition> > >>> - S<<< B<-id> > >>> [B<-force>] [B<-backup>] - S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] - [B<-help>] - -B S<<< B<-s> > >>> S<<< B<-p> > >>> - S<<< B<-i> > >>> [B<-f>] [B<-b>] S<<< [B<-c> >] >>> [B<-n>] - [B<-l>] [B<-v>] [B<-h>] +B S<<< B<-server> > >>> + S<<< B<-partition> > >>> + S<<< B<-id> > >>> + [B<-force>] [B<-backup>] + S<<< [B<-cell> >] >>> + [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>] + +B S<<< B<-s> > >>> + S<<< B<-p> > >>> + S<<< B<-i> > >>> + [B<-f>] [B<-b>] S<<< [B<-c> >] >>> + [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>] =for html
@@ -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 -- 2.39.5