volser: preserve volume stats by default

[openafs.git] / doc / man-pages / pod8 / fragments / volserver-options.pod

diff --git a/doc/man-pages/pod8/fragments/volserver-options.pod b/doc/man-pages/pod8/fragments/volserver-options.pod
index acdfc89..87e5aae 100644 (file)
--- a/doc/man-pages/pod8/fragments/volserver-options.pod
+++ b/doc/man-pages/pod8/fragments/volserver-options.pod
@@ -14,6 +14,12 @@ successfully initiate a B<vos> command. The Volume Server also records any
 file removals that result from issuing the B<vos release> command with the
 B<-f> flag.
 
+=item B<-transarc-logs>
+
+Use Transarc style logging features. Rename the log file
+F</usr/afs/logs/VolserLog> to F</usr/afs/logs/VolserLog.old> when the volume server is
+restarted.  This option is provided for compatibility with older versions.
+
 =item B<-p> <I<number of processes>>
 
 Sets the number of server lightweight processes (LWPs) to run.  Provide an
@@ -74,11 +80,15 @@ user.admin PTS entry. Sites whose Kerberos realms don't have these collisions
 between principal names may disable this check by starting the server
 with this option.
 
-=item B<-preserve-vol-stats>
+=item B<-clear-vol-stats>
+
+Clear volume access statistics during volume restore and reclone operations.
+This includes clearing the volume access statistics of read-only volumes during
+a volume release.  By default, volume access statistics are preserved during
+volume restore and reclone operations.
 
-Preserve volume access statistics over volume restore and reclone operations.
-By default, volume access statistics are reset during volume restore and reclone
-operations.
+Volume access statistics were cleared by default in versions prior to OpenAFS
+1.8.0.  This flag is intended to provide compatible behaviour.
 
 =item B<-sync> <I<sync behavior>>
 
@@ -118,17 +128,39 @@ the log message should be sent.
 
 =item B<-sleep> <I<sleep_time>/I<run_time>>
 
-This option only applies to the LWP version of the volserver, and has no effect
-on the pthreaded version of the volserver. Note that OpenAFS no longer ships an
-LWP version of the volserver; the last version series where the LWP volserver
-was even built was the 1.6.x series of OpenAFS.
-
-For the LWP version of the volserver, specifying this option forces the
-volserver to sleep during certain volume operations, so the volserver does not
-become I/O bound. Approximately every I<run_time> seconds, the volserver is
-forced to sleep for I<sleep_time> seconds if any volume transactions are active
-that are performing certain operations. This includes operations involving
-deleting, cloning, moving, releasing, copying, or restoring a volume.
+This option is obsolete, and is now only accepted for compatibility with older
+releases. All it does now is log a warning message about how the option is
+obsolete.
+
+=item B<-restricted_query> (anyuser | admin)
+
+Restrict RPCs that query information about volumes to a specific group
+of users. You can use C<admin> to restrict to AFS administrators.  The
+C<anyuser> option doesn't restrict the RPCs and leaves it open for all
+users including unauthenticated users, this is the default.
+
+=item B<-s2scrypt> (never | always | inherit)
+
+Set the cryptographic disposition of inter-volserver traffic.
+
+=over 4
+
+=item B<never>
+
+All inter-volserver traffic is unencrypted.  This is the default behavior.
+
+=item B<always>
+
+All inter-volserver traffic is encrypted (using rxkad).
+
+=item B<inherit>
+
+Inter-volserver traffic will be encrypted if the client connection triggering
+the server-to-server traffic is encrypted.  This has the effect of encrypting
+inter-server traffic if the "-encrypt" option is provided to
+L<B<vos release>|vos_release(1)>, for example.
+
+=back
 
 =item B<-help>