Index: openafs/doc/man-pages/README
diff -c openafs/doc/man-pages/README:1.8.2.11 openafs/doc/man-pages/README:1.8.2.15
*** openafs/doc/man-pages/README:1.8.2.11 Sun Aug 19 18:20:43 2007
--- openafs/doc/man-pages/README Thu Nov 29 00:47:48 2007
***************
*** 78,84 ****
documents common options, and discusses the general use of the suite.
Then, each operation code in the suite should have a separate man page,
named after the command with the space between the command suite and the
! operation code replaced with an underscore.
All man pages must follow the standard layout for man page sections and
formatting. The best general reference is the pod2man man page,
--- 78,87 ----
documents common options, and discusses the general use of the suite.
Then, each operation code in the suite should have a separate man page,
named after the command with the space between the command suite and the
! operation code replaced with an underscore. The NAME section of the
! operation man page must also use an underscore (fs_listacl, not fs
! listacl) for compatibility with some man programs. The SYNOPSIS section
! should, of course, use a space, since that's what the user must type.
All man pages must follow the standard layout for man page sections and
formatting. The best general reference is the pod2man man page,
***************
*** 199,215 ****
* The following installed commands have no man pages:
copyauth
- fs rxstatpeer
fs rxstatproc
fs setcbaddr
- kseal
- read_tape
restorevol
rmtsysd
vldb_convert
vos clone
! vos convertROtoRW
! vos copy
vos shadow
vsys
--- 202,214 ----
* The following installed commands have no man pages:
copyauth
fs rxstatproc
fs setcbaddr
restorevol
rmtsysd
vldb_convert
vos clone
! vos setfields
vos shadow
vsys
***************
*** 221,229 ****
* Some of the documentation in fs getserverprefs needs minor updates to
reflect what happens in the dynroot case.
- * fs sysname documentation needs to include the possibility of setting
- multiple sysnames and the resulting behavior.
-
* bos listkeys and the KeyFile man page assume that you're using the
kaserver.
--- 220,225 ----
Index: openafs/doc/man-pages/pod1/fs_apropos.pod
diff -c openafs/doc/man-pages/pod1/fs_apropos.pod:1.3 openafs/doc/man-pages/pod1/fs_apropos.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_apropos.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_apropos.pod Sun Nov 11 19:15:20 2007
***************
*** 1,6 ****
=head1 NAME
! fs apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_checkservers.pod
diff -c openafs/doc/man-pages/pod1/fs_checkservers.pod:1.4 openafs/doc/man-pages/pod1/fs_checkservers.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_checkservers.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_checkservers.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs checkservers - Displays the status of server machines
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_checkservers - Displays the status of server machines
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_checkvolumes.pod
diff -c openafs/doc/man-pages/pod1/fs_checkvolumes.pod:1.3 openafs/doc/man-pages/pod1/fs_checkvolumes.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_checkvolumes.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_checkvolumes.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs checkvolumes - Forces the Cache Manager to update volume information
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_checkvolumes - Forces the Cache Manager to update volume information
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_cleanacl.pod
diff -c openafs/doc/man-pages/pod1/fs_cleanacl.pod:1.4 openafs/doc/man-pages/pod1/fs_cleanacl.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_cleanacl.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_cleanacl.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs cleanacl - Remove obsolete entries from an ACL
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_cleanacl - Remove obsolete entries from an ACL
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_copyacl.pod
diff -c openafs/doc/man-pages/pod1/fs_copyacl.pod:1.4 openafs/doc/man-pages/pod1/fs_copyacl.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_copyacl.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_copyacl.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs copyacl - Copies an ACL from a directory to one or more other directories
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_copyacl - Copies an ACL from a directory to one or more other directories
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_diskfree.pod
diff -c openafs/doc/man-pages/pod1/fs_diskfree.pod:1.4 openafs/doc/man-pages/pod1/fs_diskfree.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_diskfree.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_diskfree.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs diskfree - Shows data about the partition housing a directory or file
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_diskfree - Shows data about the partition housing a directory or file
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_examine.pod
diff -c openafs/doc/man-pages/pod1/fs_examine.pod:1.4 openafs/doc/man-pages/pod1/fs_examine.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_examine.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_examine.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs examine - Shows data about the volume containing a directory or file
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_examine - Shows data about the volume containing a directory or file
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_exportafs.pod
diff -c openafs/doc/man-pages/pod1/fs_exportafs.pod:1.4 openafs/doc/man-pages/pod1/fs_exportafs.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_exportafs.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_exportafs.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs exportafs - Configures export of AFS to clients of other file systems
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_exportafs - Configures export of AFS to clients of other file systems
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_flush.pod
diff -c openafs/doc/man-pages/pod1/fs_flush.pod:1.3 openafs/doc/man-pages/pod1/fs_flush.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_flush.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_flush.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs flush - Forces the Cache Manager to discard a cached file or directory
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_flush - Forces the Cache Manager to discard a cached file or directory
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_flushall.pod
diff -c openafs/doc/man-pages/pod1/fs_flushall.pod:1.1.2.2 openafs/doc/man-pages/pod1/fs_flushall.pod:1.1.2.3
*** openafs/doc/man-pages/pod1/fs_flushall.pod:1.1.2.2 Fri Aug 17 21:55:33 2007
--- openafs/doc/man-pages/pod1/fs_flushall.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs flushall - Force the AFS Cache Manager to discard all data
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_flushall - Force the AFS Cache Manager to discard all data
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_flushmount.pod
diff -c openafs/doc/man-pages/pod1/fs_flushmount.pod:1.3 openafs/doc/man-pages/pod1/fs_flushmount.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_flushmount.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_flushmount.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs flushmount - Forces the Cache Manager to discard a mount point
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_flushmount - Forces the Cache Manager to discard a mount point
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_flushvolume.pod
diff -c openafs/doc/man-pages/pod1/fs_flushvolume.pod:1.4 openafs/doc/man-pages/pod1/fs_flushvolume.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_flushvolume.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_flushvolume.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs flushvolume - Forces the Cache Manager to discard cached data from a volume
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_flushvolume - Forces the Cache Manager to discard cached data from a volume
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_getcacheparms.pod
diff -c openafs/doc/man-pages/pod1/fs_getcacheparms.pod:1.3 openafs/doc/man-pages/pod1/fs_getcacheparms.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_getcacheparms.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_getcacheparms.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs getcacheparms - Displays the current size and usage of the cache
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_getcacheparms - Displays the current size and usage of the cache
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_getcalleraccess.pod
diff -c openafs/doc/man-pages/pod1/fs_getcalleraccess.pod:1.1.2.2 openafs/doc/man-pages/pod1/fs_getcalleraccess.pod:1.1.2.3
*** openafs/doc/man-pages/pod1/fs_getcalleraccess.pod:1.1.2.2 Fri Aug 17 21:55:33 2007
--- openafs/doc/man-pages/pod1/fs_getcalleraccess.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs getcalleraccess - Show the current user's access to a file or directory
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_getcalleraccess - Show the current user's access to a file or directory
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_getcellstatus.pod
diff -c openafs/doc/man-pages/pod1/fs_getcellstatus.pod:1.3 openafs/doc/man-pages/pod1/fs_getcellstatus.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_getcellstatus.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_getcellstatus.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs getcellstatus - Reports whether setuid programs are honored in a cell
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_getcellstatus - Reports whether setuid programs are honored in a cell
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_getclientaddrs.pod
diff -c openafs/doc/man-pages/pod1/fs_getclientaddrs.pod:1.4 openafs/doc/man-pages/pod1/fs_getclientaddrs.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_getclientaddrs.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_getclientaddrs.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs getclientaddrs - Displays the client interfaces to register
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_getclientaddrs - Displays the client interfaces to register
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_getcrypt.pod
diff -c openafs/doc/man-pages/pod1/fs_getcrypt.pod:1.3.4.5 openafs/doc/man-pages/pod1/fs_getcrypt.pod:1.3.4.6
*** openafs/doc/man-pages/pod1/fs_getcrypt.pod:1.3.4.5 Fri Aug 17 21:46:25 2007
--- openafs/doc/man-pages/pod1/fs_getcrypt.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs getcrypt - Displays the state of encryption for AFS file transfers
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_getcrypt - Displays the state of encryption for AFS file transfers
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_getserverprefs.pod
diff -c openafs/doc/man-pages/pod1/fs_getserverprefs.pod:1.4 openafs/doc/man-pages/pod1/fs_getserverprefs.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_getserverprefs.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_getserverprefs.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs getserverprefs - Displays preference ranks for file servers or VL servers
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_getserverprefs - Displays preference ranks for file servers or VL servers
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_help.pod
diff -c openafs/doc/man-pages/pod1/fs_help.pod:1.4 openafs/doc/man-pages/pod1/fs_help.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_help.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_help.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs help - Displays help for fs commands
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_help - Displays help for fs commands
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_listacl.pod
diff -c openafs/doc/man-pages/pod1/fs_listacl.pod:1.4 openafs/doc/man-pages/pod1/fs_listacl.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_listacl.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_listacl.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs listacl - Displays ACLs
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_listacl - Displays ACLs
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_listaliases.pod
diff -c openafs/doc/man-pages/pod1/fs_listaliases.pod:1.2.4.4 openafs/doc/man-pages/pod1/fs_listaliases.pod:1.2.4.5
*** openafs/doc/man-pages/pod1/fs_listaliases.pod:1.2.4.4 Fri Aug 17 21:46:25 2007
--- openafs/doc/man-pages/pod1/fs_listaliases.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs listaliases - Displays the current list of aliases for AFS cells
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_listaliases - Displays the current list of aliases for AFS cells
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_listcells.pod
diff -c openafs/doc/man-pages/pod1/fs_listcells.pod:1.4 openafs/doc/man-pages/pod1/fs_listcells.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_listcells.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_listcells.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs listcells - Displays the database server machines known to the Cache Manager
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_listcells - Displays the database server machines known to the Cache Manager
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_listquota.pod
diff -c openafs/doc/man-pages/pod1/fs_listquota.pod:1.5 openafs/doc/man-pages/pod1/fs_listquota.pod:1.5.2.1
*** openafs/doc/man-pages/pod1/fs_listquota.pod:1.5 Mon Apr 10 12:41:22 2006
--- openafs/doc/man-pages/pod1/fs_listquota.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs listquota - Displays quota information for a volume
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_listquota - Displays quota information for a volume
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_lsmount.pod
diff -c openafs/doc/man-pages/pod1/fs_lsmount.pod:1.4 openafs/doc/man-pages/pod1/fs_lsmount.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_lsmount.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_lsmount.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs lsmount - Reports the volume for which a directory is the mount point.
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_lsmount - Reports the volume for which a directory is the mount point.
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_messages.pod
diff -c openafs/doc/man-pages/pod1/fs_messages.pod:1.3 openafs/doc/man-pages/pod1/fs_messages.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_messages.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_messages.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs messages - Sets whether the Cache Manager writes log messages
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_messages - Sets whether the Cache Manager writes log messages
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_mkmount.pod
diff -c openafs/doc/man-pages/pod1/fs_mkmount.pod:1.3 openafs/doc/man-pages/pod1/fs_mkmount.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_mkmount.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_mkmount.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs mkmount - Creates a mount point for a volume
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_mkmount - Creates a mount point for a volume
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_newalias.pod
diff -c openafs/doc/man-pages/pod1/fs_newalias.pod:1.1.4.2 openafs/doc/man-pages/pod1/fs_newalias.pod:1.1.4.3
*** openafs/doc/man-pages/pod1/fs_newalias.pod:1.1.4.2 Sun Aug 5 19:38:43 2007
--- openafs/doc/man-pages/pod1/fs_newalias.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs newalias - Creates a new alias for a cell
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_newalias - Creates a new alias for a cell
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_newcell.pod
diff -c openafs/doc/man-pages/pod1/fs_newcell.pod:1.3 openafs/doc/man-pages/pod1/fs_newcell.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_newcell.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_newcell.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs newcell - Changes the kernel-resident list of a cell's database servers
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_newcell - Changes the kernel-resident list of a cell's database servers
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_quota.pod
diff -c openafs/doc/man-pages/pod1/fs_quota.pod:1.3 openafs/doc/man-pages/pod1/fs_quota.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_quota.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_quota.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs quota - Displays the quota used in the volume containing a directory or file
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_quota - Displays the quota used in the volume containing a directory or file
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_rmmount.pod
diff -c openafs/doc/man-pages/pod1/fs_rmmount.pod:1.3 openafs/doc/man-pages/pod1/fs_rmmount.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_rmmount.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_rmmount.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs rmmount - Removes a mount point
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_rmmount - Removes a mount point
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_rxstatpeer.pod
diff -c /dev/null openafs/doc/man-pages/pod1/fs_rxstatpeer.pod:1.1.2.2
*** /dev/null Sun Dec 9 18:54:47 2007
--- openafs/doc/man-pages/pod1/fs_rxstatpeer.pod Thu Nov 29 00:44:12 2007
***************
*** 0 ****
--- 1,67 ----
+ =head1 NAME
+
+ fs_rxstatpeer - Enables Rx packet logging in the OpenAFS kernel module
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B [B<-clear>] [B<-disable>] [B<-enable>] [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ B manipulates some of the Rx protocol counters in the
+ OpenAFS kernel interface.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item B<-clear>
+
+ Clear the Rx stats for peers in the kernel module.
+
+ =item B<-disable>
+
+ Disable logging of Rx stats for peers in the kernel module.
+
+ =item B<-enable>
+
+ Enable logging of Rx stats for peers in the kernel module.
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 OUTPUT
+
+ This command produces no output other than error messages.
+
+ =head1 EXAMPLES
+
+ Enable Rx Stats for peers:
+
+ % fs rxstatpeer -enable
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must be logged in as the local superuser root.
+
+ =head1 SEE ALSO
+
+ L,
+ L
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/fs_setacl.pod
diff -c openafs/doc/man-pages/pod1/fs_setacl.pod:1.4.2.1 openafs/doc/man-pages/pod1/fs_setacl.pod:1.4.2.2
*** openafs/doc/man-pages/pod1/fs_setacl.pod:1.4.2.1 Mon Jan 29 14:33:40 2007
--- openafs/doc/man-pages/pod1/fs_setacl.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setacl - Sets the ACL for a directory
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setacl - Sets the ACL for a directory
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setcachesize.pod
diff -c openafs/doc/man-pages/pod1/fs_setcachesize.pod:1.5 openafs/doc/man-pages/pod1/fs_setcachesize.pod:1.5.2.1
*** openafs/doc/man-pages/pod1/fs_setcachesize.pod:1.5 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_setcachesize.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setcachesize - Sets the size of the disk cache
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setcachesize - Sets the size of the disk cache
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setcell.pod
diff -c openafs/doc/man-pages/pod1/fs_setcell.pod:1.3 openafs/doc/man-pages/pod1/fs_setcell.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_setcell.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_setcell.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setcell - Configures permissions for setuid programs from specified cells
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setcell - Configures permissions for setuid programs from specified cells
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setclientaddrs.pod
diff -c openafs/doc/man-pages/pod1/fs_setclientaddrs.pod:1.3 openafs/doc/man-pages/pod1/fs_setclientaddrs.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_setclientaddrs.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_setclientaddrs.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setclientaddrs - Sets the client interfaces to register with the File Server
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setclientaddrs - Sets the client interfaces to register with the File Server
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setcrypt.pod
diff -c openafs/doc/man-pages/pod1/fs_setcrypt.pod:1.3.4.4 openafs/doc/man-pages/pod1/fs_setcrypt.pod:1.3.4.5
*** openafs/doc/man-pages/pod1/fs_setcrypt.pod:1.3.4.4 Sun Aug 5 19:38:43 2007
--- openafs/doc/man-pages/pod1/fs_setcrypt.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setcrypt - Enables of disables the encryption of AFS file transfers
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setcrypt - Enables of disables the encryption of AFS file transfers
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setquota.pod
diff -c openafs/doc/man-pages/pod1/fs_setquota.pod:1.4 openafs/doc/man-pages/pod1/fs_setquota.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_setquota.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_setquota.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setquota - Sets the quota for the volume containing a file or directory
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setquota - Sets the quota for the volume containing a file or directory
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setserverprefs.pod
diff -c openafs/doc/man-pages/pod1/fs_setserverprefs.pod:1.4 openafs/doc/man-pages/pod1/fs_setserverprefs.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_setserverprefs.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_setserverprefs.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setserverprefs - Sets the preference ranks for file servers or VL servers
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setserverprefs - Sets the preference ranks for file servers or VL servers
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_setvol.pod
diff -c openafs/doc/man-pages/pod1/fs_setvol.pod:1.4 openafs/doc/man-pages/pod1/fs_setvol.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_setvol.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_setvol.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs setvol - Set quota and messages for a volume containing a file or directory
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_setvol - Set quota and messages for a volume containing a file or directory
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_storebehind.pod
diff -c openafs/doc/man-pages/pod1/fs_storebehind.pod:1.4 openafs/doc/man-pages/pod1/fs_storebehind.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/fs_storebehind.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_storebehind.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs storebehind - Enables asynchronous writes to the file server
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_storebehind - Enables asynchronous writes to the file server
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_sysname.pod
diff -c openafs/doc/man-pages/pod1/fs_sysname.pod:1.3 openafs/doc/man-pages/pod1/fs_sysname.pod:1.3.2.2
*** openafs/doc/man-pages/pod1/fs_sysname.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_sysname.pod Thu Nov 29 00:47:49 2007
***************
*** 1,15 ****
=head1 NAME
! fs sysname - Reports or sets the CPU/operating system type
=head1 SYNOPSIS
=for html
! B S<<< [B<-newsys> >] >>> [B<-help>]
! B S<<< [B<-n> >] >>> [B<-h>]
=for html
--- 1,15 ----
=head1 NAME
! fs_sysname - Reports or sets the CPU/operating system type
=head1 SYNOPSIS
=for html
! B S<<< [B<-newsys> >]+ >>> [B<-help>]
! B S<<< [B<-n> >]+ >>> [B<-h>]
=for html
***************
*** 19,25 ****
The B command sets or displays the local machine's
CPU/operating system type as recorded in kernel memory. The Cache Manager
substitutes the string for the I<@sys> variable which can occur in AFS
! pathnames; the I and I explain how using I<@sys> can simplify cell configuration. It is
best to use it sparingly, however, because it can make the effect of
changing directories unpredictable.
--- 19,25 ----
The B command sets or displays the local machine's
CPU/operating system type as recorded in kernel memory. The Cache Manager
substitutes the string for the I<@sys> variable which can occur in AFS
! pathnames; the I and I explain how using I<@sys> can simplify cell configuration. It is
best to use it sparingly, however, because it can make the effect of
changing directories unpredictable.
***************
*** 42,51 ****
=item B<-newsys> >
! Sets the CPU/operating system indicator string for the local machine. If
! this argument is omitted, the output displays the current setting
! instead. AFS uses a standardized set of strings; consult the I or I.
=item B<-help>
--- 42,55 ----
=item B<-newsys> >
! Sets the CPU/operating system indicator string for the local machine. This
! option may be used multiple times in the same invocation, which sets I<@sys>
! to an array of values. When I<@sys> contains an array of values, the first
! value that matches a path is used.
!
! If this argument is omitted, the output displays the current setting
! instead. AFS uses a standardized set of strings; consult the I or I.
=item B<-help>
***************
*** 61,66 ****
--- 65,74 ----
Current sysname is ''
+ When the B<-newsys> argument is included, the output is the following:
+
+ fs: new sysname list set.
+
=head1 EXAMPLES
The following example shows the output produced on a Sun SPARCStation
***************
*** 74,79 ****
--- 82,99 ----
% fs sysname -newsys rs_aix42
+ The following command defines a machine to be Mac OS X PPC and a
+ custom type 'foo'. The second command queries the new sysname:
+
+ % fs sysname -newsys ppc_darwin_80 -newsys foo
+ fs: new sysname list set.
+ % fs sysname
+ Current sysname list is 'ppc_darwin_80' 'foo'
+
+ If I<@sys> is C, then C will try to change
+ to the C directory. If the C directory
+ doesn't exist, then the C directory is tried.
+
=head1 PRIVILEGE REQUIRED
To display the current setting, no privilege is required. To include the
***************
*** 85,93 ****
L,
L
! I
! I
=head1 COPYRIGHT
--- 105,118 ----
L,
L
! I
! L
!
! I
! L
! For the list of assigned standard sysname values, see
! L
=head1 COPYRIGHT
Index: openafs/doc/man-pages/pod1/fs_uuid.pod
diff -c openafs/doc/man-pages/pod1/fs_uuid.pod:1.1.2.2 openafs/doc/man-pages/pod1/fs_uuid.pod:1.1.2.4
*** openafs/doc/man-pages/pod1/fs_uuid.pod:1.1.2.2 Tue Oct 23 13:01:15 2007
--- openafs/doc/man-pages/pod1/fs_uuid.pod Thu Nov 29 00:17:29 2007
***************
*** 1,6 ****
=head1 NAME
! fs uuid - Prints the uuid of the client or generates a new one
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_uuid - Prints the uuid of the client or generates a new one
=head1 SYNOPSIS
***************
*** 14,31 ****
=head1 DESCRIPTION
! B prints the current uuid of an OpenAFS client. It can
! optionally force the generation of a new uuid, if needed. The client
! uuid is used by the B to differentiate clients with the
! same IP address.
=head1 CAUTIONS
! The B command is only available in OpenAFS versions after
! 1.4.5 and 1.5.8. The behavior differs slightly between versions. In
! OpenAFS 1.4.5 and later, the B<-generate> option is required and the
! uuid for the client machine is never printed. OpenAFS versions 1.5.8
! and later will print the uuid.
=head1 OPTIONS
--- 14,31 ----
=head1 DESCRIPTION
! B prints the current UUID of an OpenAFS client. It can
! optionally force the generation of a new UUID, if needed. The client UUID
! is used by the B to differentiate clients with the same IP
! address.
=head1 CAUTIONS
! The B command is only available in OpenAFS versions after 1.4.5
! and 1.5.8. The behavior differs slightly between versions. In OpenAFS
! 1.4.5 and later, the B<-generate> option is required and the UUID for the
! client machine is never printed. OpenAFS versions 1.5.8 and later will
! print the UUID.
=head1 OPTIONS
***************
*** 33,53 ****
=item B<-generate>
! Generates a new uuid for the cache manager. This is useful if two
! clients share the same uuid. B<-generate> is optional in OpenAFS
! versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5
! and later.
=item B<-help>
! Prints the online help for this command. All other valid options are
ignored.
=back
=head1 OUTPUT
! B prints out the current uuid for the client or the new uuid
if the B<-generate> option is passed to it.
=head1 EXAMPLES
--- 33,53 ----
=item B<-generate>
! Generates a new UUID for the cache manager. This is useful if two clients
! share the same UUID (if systems were cloned incorrectly, for example).
! B<-generate> is optional in OpenAFS versions 1.5.8 and later, but it is
! required in OpenAFS versions 1.4.5 and later.
=item B<-help>
! Prints the online help for this command. All other valid options are
ignored.
=back
=head1 OUTPUT
! B prints out the current UUID for the client or the new UUID
if the B<-generate> option is passed to it.
=head1 EXAMPLES
***************
*** 65,71 ****
% fs uuid -generate
New uuid generated.
-
=head1 PRIVILEGE REQUIRED
The issuer must be logged on as the local superuser C.
--- 65,70 ----
Index: openafs/doc/man-pages/pod1/fs_whereis.pod
diff -c openafs/doc/man-pages/pod1/fs_whereis.pod:1.3 openafs/doc/man-pages/pod1/fs_whereis.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_whereis.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_whereis.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs whereis - Reports each file server housing a file or directory
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_whereis - Reports each file server housing a file or directory
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_whichcell.pod
diff -c openafs/doc/man-pages/pod1/fs_whichcell.pod:1.3 openafs/doc/man-pages/pod1/fs_whichcell.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_whichcell.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_whichcell.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs whichcell - Returns the cell to which a file or directory belongs
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_whichcell - Returns the cell to which a file or directory belongs
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/fs_wscell.pod
diff -c openafs/doc/man-pages/pod1/fs_wscell.pod:1.3 openafs/doc/man-pages/pod1/fs_wscell.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/fs_wscell.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/fs_wscell.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! fs wscell - Returns the name of the cell to which a machine belongs
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fs_wscell - Returns the name of the cell to which a machine belongs
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_adduser.pod
diff -c openafs/doc/man-pages/pod1/pts_adduser.pod:1.4 openafs/doc/man-pages/pod1/pts_adduser.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_adduser.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_adduser.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts adduser - Adds a user or machine to a Protection Database group
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_adduser - Adds a user or machine to a Protection Database group
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_apropos.pod
diff -c openafs/doc/man-pages/pod1/pts_apropos.pod:1.3 openafs/doc/man-pages/pod1/pts_apropos.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/pts_apropos.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_apropos.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_chown.pod
diff -c openafs/doc/man-pages/pod1/pts_chown.pod:1.4 openafs/doc/man-pages/pod1/pts_chown.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_chown.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_chown.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts chown - Changes the owner of a Protection Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_chown - Changes the owner of a Protection Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_creategroup.pod
diff -c openafs/doc/man-pages/pod1/pts_creategroup.pod:1.4 openafs/doc/man-pages/pod1/pts_creategroup.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_creategroup.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_creategroup.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts creategroup - Creates an (empty) Protection Database group entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_creategroup - Creates an (empty) Protection Database group entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_createuser.pod
diff -c openafs/doc/man-pages/pod1/pts_createuser.pod:1.4 openafs/doc/man-pages/pod1/pts_createuser.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_createuser.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_createuser.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts createuser - Creates a user or machine entry in the Protection Database
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_createuser - Creates a user or machine entry in the Protection Database
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_delete.pod
diff -c openafs/doc/man-pages/pod1/pts_delete.pod:1.3 openafs/doc/man-pages/pod1/pts_delete.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/pts_delete.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_delete.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts delete - Deletes a Protection Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_delete - Deletes a Protection Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_examine.pod
diff -c openafs/doc/man-pages/pod1/pts_examine.pod:1.4 openafs/doc/man-pages/pod1/pts_examine.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_examine.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_examine.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts examine - Displays a Protection Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_examine - Displays a Protection Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_help.pod
diff -c openafs/doc/man-pages/pod1/pts_help.pod:1.4 openafs/doc/man-pages/pod1/pts_help.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_help.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_help.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts help - Displays help for pts commands
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_help - Displays help for pts commands
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_interactive.pod
diff -c openafs/doc/man-pages/pod1/pts_interactive.pod:1.2.4.2 openafs/doc/man-pages/pod1/pts_interactive.pod:1.2.4.3
*** openafs/doc/man-pages/pod1/pts_interactive.pod:1.2.4.2 Fri Aug 17 22:50:20 2007
--- openafs/doc/man-pages/pod1/pts_interactive.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts interactive - Enters interactive mode
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_interactive - Enters interactive mode
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_listentries.pod
diff -c openafs/doc/man-pages/pod1/pts_listentries.pod:1.4 openafs/doc/man-pages/pod1/pts_listentries.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_listentries.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_listentries.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts listentries - Displays all users or groups in the Protection Database
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_listentries - Displays all users or groups in the Protection Database
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_listmax.pod
diff -c openafs/doc/man-pages/pod1/pts_listmax.pod:1.3 openafs/doc/man-pages/pod1/pts_listmax.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/pts_listmax.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_listmax.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts listmax - Displays the max user id and max group id counters
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_listmax - Displays the max user id and max group id counters
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_listowned.pod
diff -c openafs/doc/man-pages/pod1/pts_listowned.pod:1.3 openafs/doc/man-pages/pod1/pts_listowned.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/pts_listowned.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_listowned.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts listowned - Show the Protection Database groups owned by a user or group
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_listowned - Show the Protection Database groups owned by a user or group
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_membership.pod
diff -c openafs/doc/man-pages/pod1/pts_membership.pod:1.4 openafs/doc/man-pages/pod1/pts_membership.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_membership.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_membership.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts membership - Displays the membership list for a user or group
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_membership - Displays the membership list for a user or group
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_quit.pod
diff -c openafs/doc/man-pages/pod1/pts_quit.pod:1.1.2.2 openafs/doc/man-pages/pod1/pts_quit.pod:1.1.2.3
*** openafs/doc/man-pages/pod1/pts_quit.pod:1.1.2.2 Fri Aug 17 21:46:25 2007
--- openafs/doc/man-pages/pod1/pts_quit.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts quit - Exit from pts interactive mode
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_quit - Exit from pts interactive mode
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_removeuser.pod
diff -c openafs/doc/man-pages/pod1/pts_removeuser.pod:1.3 openafs/doc/man-pages/pod1/pts_removeuser.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/pts_removeuser.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_removeuser.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts removeuser - Removes a user from a Protection Database group
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_removeuser - Removes a user from a Protection Database group
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_rename.pod
diff -c openafs/doc/man-pages/pod1/pts_rename.pod:1.3 openafs/doc/man-pages/pod1/pts_rename.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/pts_rename.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_rename.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts rename - Changes the name of a Protection Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_rename - Changes the name of a Protection Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_setfields.pod
diff -c openafs/doc/man-pages/pod1/pts_setfields.pod:1.4 openafs/doc/man-pages/pod1/pts_setfields.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_setfields.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_setfields.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts setfields - Sets privacy flags or quota for a Protection Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_setfields - Sets privacy flags or quota for a Protection Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_setmax.pod
diff -c openafs/doc/man-pages/pod1/pts_setmax.pod:1.4 openafs/doc/man-pages/pod1/pts_setmax.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/pts_setmax.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/pts_setmax.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts setmax - Sets the value of the max group id or max user id counter
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_setmax - Sets the value of the max group id or max user id counter
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_sleep.pod
diff -c openafs/doc/man-pages/pod1/pts_sleep.pod:1.2.4.2 openafs/doc/man-pages/pod1/pts_sleep.pod:1.2.4.3
*** openafs/doc/man-pages/pod1/pts_sleep.pod:1.2.4.2 Fri Aug 17 22:50:20 2007
--- openafs/doc/man-pages/pod1/pts_sleep.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts sleep - Pauses for a few seconds
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_sleep - Pauses for a few seconds
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/pts_source.pod
diff -c openafs/doc/man-pages/pod1/pts_source.pod:1.3.4.2 openafs/doc/man-pages/pod1/pts_source.pod:1.3.4.3
*** openafs/doc/man-pages/pod1/pts_source.pod:1.3.4.2 Fri Aug 17 22:50:20 2007
--- openafs/doc/man-pages/pod1/pts_source.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! pts source - Read pts commands from a file
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! pts_source - Read pts commands from a file
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/symlink.pod
diff -c /dev/null openafs/doc/man-pages/pod1/symlink.pod:1.1.2.2
*** /dev/null Sun Dec 9 18:54:47 2007
--- openafs/doc/man-pages/pod1/symlink.pod Thu Nov 29 00:54:15 2007
***************
*** 0 ****
--- 1,40 ----
+ =head1 NAME
+
+ symlink - Introduction to the symlink command suite
+
+ =head1 DESCRIPTION
+
+ The B command creates, lists and removes Unix-style symbolic links
+ (symlinks) in OpenAFS filespace from a platform that does not support
+ symlinks, like Windows. The B command is equivalent to
+ C on a Unix platform. B can manipulate symlinks created
+ by C on Unix and vice versa.
+
+ =head1 CAUTIONS
+
+ The B commands are only available on Windows platforms. On
+ other platforms, use the C command.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 SEE ALSO
+
+ L,
+ L,
+ L
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/symlink_list.pod
diff -c /dev/null openafs/doc/man-pages/pod1/symlink_list.pod:1.1.2.2
*** /dev/null Sun Dec 9 18:54:47 2007
--- openafs/doc/man-pages/pod1/symlink_list.pod Thu Nov 29 00:54:15 2007
***************
*** 0 ****
--- 1,79 ----
+ =head1 NAME
+
+ symlink_list - Show the file to which a symlink points
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B S<<< [B<-name>] > >>> [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ The B command shows if a file is a symbolic link and, if so,
+ shows to which file the link points.
+
+ =head1 CAUTIONS
+
+ The B commands are only available on Windows platforms. On other
+ platforms, use the B command.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item [B<-name>] >
+
+ Specify one or more symbolic links to list. The C<-name> is optional, but
+ the file name is not.
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 OUTPUT
+
+ This command prints "'file' is a symlink to 'otherfile'" or "'file' is
+ not a symlink."
+
+ =head1 EXAMPLES
+
+ Given that file C is a link pointing to file C, the
+ following commands will list the files:
+
+ % symlink list -name mylink
+ 'mylink' is a symlink to 'myfile'
+
+ % symlink list mylink
+ 'mylink' is a symlink to 'myfile'
+
+ % symlink list -name myfile
+ 'myfile' is not a symlink.
+
+ % symlink list myfile
+ 'myfile' is not a symlink.
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must have the C (look) and C (read) permissions on the ACL
+ of the directory that houses the symlink.
+
+ =head1 SEE ALSO
+
+ L,
+ L,
+ L
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/symlink_make.pod
diff -c /dev/null openafs/doc/man-pages/pod1/symlink_make.pod:1.1.2.2
*** /dev/null Sun Dec 9 18:54:47 2007
--- openafs/doc/man-pages/pod1/symlink_make.pod Thu Nov 29 00:54:15 2007
***************
*** 0 ****
--- 1,76 ----
+ =head1 NAME
+
+ symlink_make - Create a symbolic link
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B S<<< [B<-name>] > >>>
+ S<<< [B<-to>] > >>> [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ The B command creates a new symbolic link to a file. The file
+ to which the link points does not have to exist when the link is created.
+
+ =head1 CAUTIONS
+
+ The B commands are only available on Windows platforms. On other
+ platforms, use the C command.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item [B<-name>] >
+
+ Specify the name of the new link. B<-name> is optional, but the file name
+ is not.
+
+ =item [B<-to>] >
+
+ Specify the file to which the new link points. B<-to> is optional, but the
+ file name is not.
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 OUTPUT
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =head1 EXAMPLES
+
+ In order to create a link named C pointing to the file C,
+ use one of the following commands:
+
+ % symlink make -name mylink -to myfile
+ % symlink make mylink myfile
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must have the C (look) and C (insert) permissions on the
+ ACL of the directory that houses the symlink.
+
+ =head1 SEE ALSO
+
+ L,
+ L,
+ L
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/symlink_remove.pod
diff -c /dev/null openafs/doc/man-pages/pod1/symlink_remove.pod:1.1.2.2
*** /dev/null Sun Dec 9 18:54:47 2007
--- openafs/doc/man-pages/pod1/symlink_remove.pod Thu Nov 29 00:54:15 2007
***************
*** 0 ****
--- 1,70 ----
+ =head1 NAME
+
+ symlink_remove - Remove a symbolic link.
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B S<<< [B<-name>] > >>> [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ The B command removes a symbolic link to a file.
+
+ =head1 CAUTIONS
+
+ The B commands are only available on Windows platforms. On other
+ platforms, use the B command.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item [B<-name>] >
+
+ Specify one or more symbolic links to remove. The B<-name> is optional, but
+ the file name is not.
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 OUTPUT
+
+ This command has no output except error and help messages. If the command
+ is passed a real file instead of a symlink, it prints "symlink: 'file name'
+ is not a symlink" instead of removing the file.
+
+ =head1 EXAMPLES
+
+ Given that file C is a link pointing to file C, the
+ following commands will remove the link C:
+
+ % symlink remove -name mylink
+ % symlink remove mylink
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must have the C (look) and C (delete) permissions on
+ the ACL of the directory that houses the symlink.
+
+ =head1 SEE ALSO
+
+ L,
+ L,
+ L
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/vos.pod
diff -c openafs/doc/man-pages/pod1/vos.pod:1.3.6.2 openafs/doc/man-pages/pod1/vos.pod:1.3.6.3
*** openafs/doc/man-pages/pod1/vos.pod:1.3.6.2 Fri Aug 17 22:36:20 2007
--- openafs/doc/man-pages/pod1/vos.pod Thu Nov 29 00:35:33 2007
***************
*** 237,243 ****
L,
L,
L,
! L,
L,
L,
L,
--- 237,244 ----
L,
L,
L,
! L,
! L,
L,
L,
L,
Index: openafs/doc/man-pages/pod1/vos_addsite.pod
diff -c openafs/doc/man-pages/pod1/vos_addsite.pod:1.4 openafs/doc/man-pages/pod1/vos_addsite.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/vos_addsite.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/vos_addsite.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! vos addsite - Adds a read-only site definition to a volume's VLDB entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! vos_addsite - Adds a read-only site definition to a volume's VLDB entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/vos_apropos.pod
diff -c openafs/doc/man-pages/pod1/vos_apropos.pod:1.3 openafs/doc/man-pages/pod1/vos_apropos.pod:1.3.2.1
*** openafs/doc/man-pages/pod1/vos_apropos.pod:1.3 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/vos_apropos.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! vos apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! vos_apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/vos_backup.pod
diff -c openafs/doc/man-pages/pod1/vos_backup.pod:1.4 openafs/doc/man-pages/pod1/vos_backup.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/vos_backup.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/vos_backup.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! vos backup - Creates a backup volume for a single read/write volume
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! vos_backup - Creates a backup volume for a single read/write volume
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/vos_backupsys.pod
diff -c openafs/doc/man-pages/pod1/vos_backupsys.pod:1.5.2.1 openafs/doc/man-pages/pod1/vos_backupsys.pod:1.5.2.2
*** openafs/doc/man-pages/pod1/vos_backupsys.pod:1.5.2.1 Fri Aug 17 21:46:26 2007
--- openafs/doc/man-pages/pod1/vos_backupsys.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! vos backupsys - Creates a backup volume for several read/write volumes
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! vos_backupsys - Creates a backup volume for several read/write volumes
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/vos_changeaddr.pod
diff -c openafs/doc/man-pages/pod1/vos_changeaddr.pod:1.4 openafs/doc/man-pages/pod1/vos_changeaddr.pod:1.4.2.1
*** openafs/doc/man-pages/pod1/vos_changeaddr.pod:1.4 Wed Mar 1 00:02:30 2006
--- openafs/doc/man-pages/pod1/vos_changeaddr.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! vos changeaddr - Changes or removes a file server machine's entry in the VLDB
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! vos_changeaddr - Changes or removes a file server machine's entry in the VLDB
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/vos_changeloc.pod
diff -c openafs/doc/man-pages/pod1/vos_changeloc.pod:1.1.2.3 openafs/doc/man-pages/pod1/vos_changeloc.pod:1.1.2.4
*** openafs/doc/man-pages/pod1/vos_changeloc.pod:1.1.2.3 Sun Aug 19 18:20:46 2007
--- openafs/doc/man-pages/pod1/vos_changeloc.pod Sun Nov 11 18:51:05 2007
***************
*** 1,6 ****
=head1 NAME
! vos changeloc - Change a volume's entry in the VLDB
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! vos_changeloc - Change a volume's entry in the VLDB
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod1/vos_convertROtoRW.pod
diff -c /dev/null openafs/doc/man-pages/pod1/vos_convertROtoRW.pod:1.2.2.3
*** /dev/null Sun Dec 9 18:54:47 2007
--- openafs/doc/man-pages/pod1/vos_convertROtoRW.pod Thu Nov 29 00:51:03 2007
***************
*** 0 ****
--- 1,122 ----
+ =head1 NAME
+
+ vos_convertROtoRW - Converts a Read-Only volume into a Read/Write volume
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ 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>]
+
+ =for html
+
+
+ B
S<<< [B<-id>] > >>>
+ S<<< [B<-fromserver>] > >>>
+ S<<< [B<-frompartition>] > >>>
+ S<<< [B<-toname>] > >>>
+ 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>]
+
+ =for html
+
! B
S<<< [B<-auditlog> >] >>>
! S<<< [B<-d> >] >>>
S<<< [B<-p> >] >>>
S<<< [B<-spare> >] >>>
S<<< [B<-pctspare> >] >>> S<<< [B<-b> >] >>>
--- 7,13 ----
=for html
! B
S<<< [B<-d> >] >>>
S<<< [B<-p> >] >>>
S<<< [B<-spare> >] >>>
S<<< [B<-pctspare> >] >>> S<<< [B<-b> >] >>>
***************
*** 17,23 ****
S<<< [B<-cb> >] >>> [B<-banner>] [B<-novbc>]
S<<< [B<-implicit> >] >>> [B<-readonly>]
S<<< [B<-hr> >] >>>
! [B<-busyat> n >>>]
[B<-nobusy>] S<<< [B<-rxpck> >] >>>
[B<-rxdbg>] [B<-rxdbge>] S<<< [B<-rxmaxmtu> >] >>>
S<<< [B<-rxbind> >] >>>
--- 16,22 ----
S<<< [B<-cb> >] >>> [B<-banner>] [B<-novbc>]
S<<< [B<-implicit> >] >>> [B<-readonly>]
S<<< [B<-hr> >] >>>
! S<<< [B<-busyat> n >>>] >>>
[B<-nobusy>] S<<< [B<-rxpck> >] >>>
[B<-rxdbg>] [B<-rxdbge>] S<<< [B<-rxmaxmtu> >] >>>
S<<< [B<-rxbind> >] >>>
***************
*** 48,56 ****
The File Server creates the F log file as it
initializes, if the file does not already exist. It does not write a
! detailed trace by default, but use the B<-d> option to increase the amount
! of detail. Use the B command to display the contents of the
! log file.
The command's arguments enable the administrator to control many aspects
of the File Server's performance, as detailed in L. By default
--- 47,55 ----
The File Server creates the F log file as it
initializes, if the file does not already exist. It does not write a
! detailed trace by default, but the B<-d> option may be used to
! increase the amount of detail. Use the B command to
! display the contents of the log file.
The command's arguments enable the administrator to control many aspects
of the File Server's performance, as detailed in L. By default
***************
*** 68,74 ****
The maximum number of lightweight processes (LWPs) the File Server uses to
handle requests for data; corresponds to the B<-p> argument. The File
! Server always uses a minimum of 32 KB for these processes.
=item *
--- 67,73 ----
The maximum number of lightweight processes (LWPs) the File Server uses to
handle requests for data; corresponds to the B<-p> argument. The File
! Server always uses a minimum of 32 KB of memory for these processes.
=item *
***************
*** 168,173 ****
--- 167,182 ----
that it can take that long for changed group memberships to become
effective. To change this frequency, use the B<-hr> argument.
+ The File Server stores volumes in partitions. A partition is a
+ filesystem or directory on the server machine that is named C
+ or C where XX is "a" through "z" or "aa" though "zz". The
+ File Server expects that the /vicepXX directories are each on a
+ dedicated filesystem. The File Server will only use a /vicepXX if it's
+ a mountpoint for another filesystem, unless the file
+ C exists. The data in the partition is a
+ special format that can only be access using OpenAFS commands or an
+ OpenAFS client.
+
The File Server generates the following message when a partition is nearly
full:
***************
*** 178,189 ****
=head1 CAUTIONS
! Do not use the B<-k> and -w arguments, which are intended for use by the
! AFS Development group only. Changing them from their default values can
! result in unpredictable File Server behavior. In any case, on many
! operating systems the File Server uses native threads rather than the LWP
! threads, so using the B<-k> argument to set the number of LWP threads has
! no effect.
Do not specify both the B<-spare> and B<-pctspare> arguments. Doing so
causes the File Server to exit, leaving an error message in the
--- 187,198 ----
=head1 CAUTIONS
! Do not use the B<-k> and B<-w> arguments, which are intended for use
! by the AFS Development group only. Changing them from their default
! values can result in unpredictable File Server behavior. In any case,
! on many operating systems the File Server uses native threads rather
! than the LWP threads, so using the B<-k> argument to set the number of
! LWP threads has no effect.
Do not specify both the B<-spare> and B<-pctspare> arguments. Doing so
causes the File Server to exit, leaving an error message in the
***************
*** 398,407 ****
-cmd "/usr/afs/bin/fileserver -pctspare 10 \
-L" /usr/afs/bin/volserver /usr/afs/bin/salvager
=head1 PRIVILEGE REQUIRED
The issuer must be logged in as the superuser C on a file server
! machine to issue the command at a command shell prompt. It is conventional
instead to create and start the process by issuing the B
command.
--- 407,566 ----
-cmd "/usr/afs/bin/fileserver -pctspare 10 \
-L" /usr/afs/bin/volserver /usr/afs/bin/salvager
+
+ =head1 TROUBLESHOOTING
+
+ Sending process signals to the File Server Process can change its
+ behavior in the following ways:
+
+ Process Signal OS Result
+ ---------------------------------------------------------------------
+
+ File Server XCPU Unix Prints a list of client IP
+ Addresses.
+
+ File Server USR2 Windows Prints a list of client IP
+ Addresses.
+
+ File Server POLL HPUX Prints a list of client IP
+ Addresses.
+
+ Any server TSTP Any Increases Debug level by a power
+ of 5 -- 1,5,25,125, etc.
+ This has the same effect as the
+ -debug XXX command-line option.
+
+ Any Server HUP Any Resets Debug level to 0
+
+ File Server TERM Any Run minor instrumentation over
+ the list of descriptors.
+
+ Other Servers TERM Any Causes the process to quit.
+
+ File Server QUIT Any Causes the File Server to Quit.
+ Bos Server knows this.
+
+ The basic metric of whether an AFS file server is doing well is the number
+ of connections waiting for a thread,
+ which can be found by running the following command:
+
+ % rxdebug | grep waiting_for | wc -l
+
+ Each line returned by C that contains the text "waiting_for"
+ represents a connection that's waiting for a file server thread.
+
+ If the blocked connection count is ever above 0, the server is having
+ problems replying to clients in a timely fashion. If it gets above 10,
+ roughly, there will be noticable slowness by the user. The total number of
+ connections is a mostly irrelevant number that goes essentially
+ monotonically for as long as the server has been running and then goes back
+ down to zero when it's restarted.
+
+ The most common cause of blocked connections rising on a server is some
+ process somewhere performing an abnormal number of accesses to that server
+ and its volumes. If multiple servers have a blocked connection count, the
+ most likely explanation is that there is a volume replicated between those
+ servers that is absorbing an abnormally high access rate.
+
+ To get an access count on all the volumes on a server, run:
+
+ % vos listvol -long
+
+ and save the output in a file. The results will look like a bunch of B output for each volume on the server. Look for lines like:
+
+ 40065 accesses in the past day (i.e., vnode references)
+
+ and look for volumes with an abnormally high number of accesses. Anything
+ over 10,000 is fairly high, but some volumes like root.cell and other
+ volumes close to the root of the cell will have that many hits routinely.
+ Anything over 100,000 is generally abnormally high. The count resets about
+ once a day.
+
+ Another approach that can be used to narrow the possibilities for a
+ replicated volume, when multiple servers are having trouble, is to find all
+ replicated volumes for that server. Run:
+
+ % vos listvldb -server
+
+ where is one of the servers having problems to refresh the VLDB
+ cache, and then run:
+
+ % vos listvldb -server -part
+
+ to get a list of all volumes on that server and partition, including every
+ other server with replicas.
+
+ Once the volume causing the problem has been identified, the best way to
+ deal with the problem is to move that volume to another server with a low
+ load or to stop any runaway programs that are accessing that volume
+ unnecessarily. Often the volume will be enough information to tell what's
+ going on.
+
+ If you still need additional information about who's hitting that server,
+ sometimes you can guess at that information from the failed callbacks in the
+ F log in F on the server, or from the output of:
+
+ % /usr/afsws/etc/rxdebug -rxstats
+
+ but the best way is to turn on debugging output from the file server.
+ (Warning: This generates a lot of output into FileLog on the AFS server.)
+ To do this, log on to the AFS server, find the PID of the fileserver
+ process, and do:
+
+ kill -TSTP
+
+ where is the PID of the file server process. This will raise the
+ debugging level so that you'll start seeing what people are actually doing
+ on the server. You can do this up to three more times to get even more
+ output if needed. To reset the debugging level back to normal, use (The
+ following command will NOT terminate the file server):
+
+ kill -HUP
+
+ The debugging setting on the File Server should be reset back to normal when
+ debugging is no longer needed. Otherwise, the AFS server may well fill its
+ disks with debugging output.
+
+ The lines of the debugging output that are most useful for debugging load
+ problems are:
+
+ SAFS_FetchStatus, Fid = 2003828163.77154.82248, Host 171.64.15.76
+ SRXAFS_FetchData, Fid = 2003828163.77154.82248
+
+ (The example above is partly truncated to highlight the interesting
+ information). The Fid identifies the volume and inode within the volume;
+ the volume is the first long number. So, for example, this was:
+
+ % vos examine 2003828163
+ pubsw.matlab61 2003828163 RW 1040060 K On-line
+ afssvr5.Stanford.EDU /vicepa
+ RWrite 2003828163 ROnly 2003828164 Backup 2003828165
+ MaxQuota 3000000 K
+ Creation Mon Aug 6 16:40:55 2001
+ Last Update Tue Jul 30 19:00:25 2002
+ 86181 accesses in the past day (i.e., vnode references)
+
+ RWrite: 2003828163 ROnly: 2003828164 Backup: 2003828165
+ number of sites -> 3
+ server afssvr5.Stanford.EDU partition /vicepa RW Site
+ server afssvr11.Stanford.EDU partition /vicepd RO Site
+ server afssvr5.Stanford.EDU partition /vicepa RO Site
+
+ and from the Host information one can tell what system is accessing that
+ volume.
+
+ Note that the output of L also includes the access count, so
+ once the problem has been identified, vos examine can be used to see if the
+ access count is still increasing. Also remember that you can run vos
+ examine on the read-only replica (e.g., pubsw.matlab61.readonly) to see the
+ access counts on the read-only replica on all of the servers that it's
+ located on.
+
=head1 PRIVILEGE REQUIRED
The issuer must be logged in as the superuser C on a file server
! machine to issue the command at a command shell prompt. It is conventional
instead to create and start the process by issuing the B
command.
***************
*** 413,419 ****
L,
L,
L,
! L
=head1 COPYRIGHT
--- 572,579 ----
L,
L,
L,
! L,
! L
=head1 COPYRIGHT
Index: openafs/doc/man-pages/pod8/fstrace_apropos.pod
diff -c openafs/doc/man-pages/pod8/fstrace_apropos.