[OpenAFS-Doc] small manpage updates

Lars Wilke lw@lwilke.de
Fri, 1 Jun 2007 23:36:23 +0200


--Qxx1br4bt0+wmkIi
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline

Hi,

i just added a few missing arguments, which are visible via -help,
to the pod8/fileserver.pod file. I am going to check the other libexec
stuff, too, as time permits. I also did take a look into the src file
src/viced/viced.c, and found a few more arguments, i.e. -syslog and
-saneacls, with which i do not know what to do. Are the args not listed
on purpose or are these just forgotten and should they be added to the
pod file?

Another patch is to the help output from fs, which IMHO makes it more
clear what type of server is meant in setserverprefs.

Any comment is welcome, thanks

   --lars

--Qxx1br4bt0+wmkIi
Content-Type: text/x-diff; charset=iso-8859-1
Content-Disposition: attachment; filename="fs_help.patch"

Index: src/WINNT/afsd/fs.c
===================================================================
RCS file: /cvs/openafs/src/WINNT/afsd/fs.c,v
retrieving revision 1.41
diff -u -p -r1.41 fs.c
--- src/WINNT/afsd/fs.c	15 May 2007 20:19:37 -0000	1.41
+++ src/WINNT/afsd/fs.c	1 Jun 2007 19:46:18 -0000
@@ -4356,7 +4356,7 @@ main(int argc, char **argv)
     cmd_CreateAlias(ts, "sc");
 #endif /* WIN32 */
 
-    ts = cmd_CreateSyntax("setserverprefs", SetPrefCmd, 0, "set server ranks");
+    ts = cmd_CreateSyntax("setserverprefs", SetPrefCmd, 0, "set afs db server ranks");
     cmd_AddParm(ts, "-servers", CMD_LIST, CMD_OPTIONAL|CMD_EXPANDS, "fileserver names and ranks");
     cmd_AddParm(ts, "-vlservers", CMD_LIST, CMD_OPTIONAL|CMD_EXPANDS, "VL server names and ranks");
     cmd_AddParm(ts, "-file", CMD_SINGLE, CMD_OPTIONAL, "input from named file");
Index: src/venus/fs.c
===================================================================
RCS file: /cvs/openafs/src/venus/fs.c,v
retrieving revision 1.37
diff -u -p -r1.37 fs.c
--- src/venus/fs.c	10 Apr 2007 18:36:24 -0000	1.37
+++ src/venus/fs.c	1 Jun 2007 19:46:19 -0000
@@ -3332,7 +3332,7 @@ main(int argc, char **argv)
     cmd_CreateAlias(ts, "sc");
 
     ts = cmd_CreateSyntax("setserverprefs", SetPrefCmd, 0,
-			  "set server ranks");
+			  "set afs db server ranks");
     cmd_AddParm(ts, "-servers", CMD_LIST, CMD_OPTIONAL | CMD_EXPANDS,
 		"fileserver names and ranks");
     cmd_AddParm(ts, "-vlservers", CMD_LIST, CMD_OPTIONAL | CMD_EXPANDS,

--Qxx1br4bt0+wmkIi
Content-Type: text/x-diff; charset=iso-8859-1
Content-Disposition: attachment; filename="fileservers_pod.patch"

Index: pod8/fileserver.pod
===================================================================
RCS file: /cvs/openafs/doc/man-pages/pod8/fileserver.pod,v
retrieving revision 1.5
diff -u -p -r1.5 fileserver.pod
--- pod8/fileserver.pod	1 Mar 2006 05:02:31 -0000	1.5
+++ pod8/fileserver.pod	1 Jun 2007 21:19:05 -0000
@@ -7,20 +7,31 @@ fileserver - Initializes the File Server
 =for html
 <div class="synopsis">
 
-B<fileserver> S<<< [B<-d> <I<debug level>>] >>> S<<< [B<-p> <I<number of processes>>] >>>
+B<fileserver> S<<< [B<-auditlog> <I<log path>>] >>>
+    S<<< [B<-d> <I<debug level>>] >>>
+    S<<< [B<-p> <I<number of processes>>] >>>
     S<<< [B<-spare> <I<number of spare blocks>>] >>>
     S<<< [B<-pctspare> <I<percentage spare>>] >>> S<<< [B<-b> <I<buffers>>] >>>
     S<<< [B<-l> <I<large vnodes>>] >>> S<<< [B<-s> <I<small nodes>>] >>>
     S<<< [B<-vc> <I<volume cachesize>>] >>> S<<< [B<-w> <I<call back wait interval>>] >>>
     S<<< [B<-cb> <I<number of call backs>>] >>> [B<-banner>] [B<-novbc>]
     S<<< [B<-implicit> <I<admin mode bits: rlidwka>>] >>>
+    S<<< [B<-readonly> <I<read only fileserver>>] >>>
     S<<< [B<-hr> <I<number of hours between refreshing the host cps>>] >>>
     [B<-busyat> <I<< redirect clients when queue > n >>>]
+    S<<< [B<-nobusy> <I<no VBUSY before a volume is attached>>] >>>
     S<<< [B<-rxpck> <I<number of rx extra packets>>] >>>
-    [B<-rxdbg>] [B<-rxdbge>] S<<< [B<-m> <I<min percentage spare in partition>>] >>>
+    S<<< [B<-rxdbg> <I<enable rx debugging>>] >>>
+    S<<< [B<-rxdbge> <I<enable rx event debugging>>] >>>
+    S<<< [B<-rxmaxmtu> <I<bytes>>] >>>
+    S<<< [B<-rxbind> <I<bind the Rx socket to one address>>] >>>
+    S<<< [B<-vattachpar> <I<number of volume attach threads>>] >>>
+    S<<< [B<-m> <I<min percentage spare in partition>>] >>>
     [B<-lock>] [B<-L>] [B<-S>] S<<< [B<-k> <I<stack size>>] >>>
     S<<< [B<-realm> <I<Kerberos realm name>>] >>>
     S<<< [B<-udpsize> <I<size of socket buffer in bytes>>] >>>
+    S<<< [B<-sendsize> <I<size of send buffer in bytes>>] >>>
+    S<<< [B<-abortthreshold> <I<abort threshold>>] >>>
     [B<-enable_peer_stats>] [B<-enable_process_stats>] [B<-help>]
 
 =for html
@@ -189,6 +200,10 @@ option only on the relevant system type.
 
 =over 4
 
+=item B<-auditlog> <I<log path>>
+
+Set and enable auditing.
+
 =item B<-d> <I<debug level>>
 
 Sets the detail level for the debugging trace written to the

--Qxx1br4bt0+wmkIi--