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.pod:1.3 openafs/doc/man-pages/pod8/fstrace_apropos.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/fstrace_apropos.pod:1.3 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_apropos.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_clear.pod
diff -c openafs/doc/man-pages/pod8/fstrace_clear.pod:1.4 openafs/doc/man-pages/pod8/fstrace_clear.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/fstrace_clear.pod:1.4 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_clear.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace clear - Clears the trace log
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_clear - Clears the trace log
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_dump.pod
diff -c openafs/doc/man-pages/pod8/fstrace_dump.pod:1.6 openafs/doc/man-pages/pod8/fstrace_dump.pod:1.6.2.1
*** openafs/doc/man-pages/pod8/fstrace_dump.pod:1.6 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_dump.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace dump - Dumps a trace log
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_dump - Dumps a trace log
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_help.pod
diff -c openafs/doc/man-pages/pod8/fstrace_help.pod:1.4 openafs/doc/man-pages/pod8/fstrace_help.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/fstrace_help.pod:1.4 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_help.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace help - Displays help for fstrace commands
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_help - Displays help for fstrace commands
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_lslog.pod
diff -c openafs/doc/man-pages/pod8/fstrace_lslog.pod:1.4 openafs/doc/man-pages/pod8/fstrace_lslog.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/fstrace_lslog.pod:1.4 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_lslog.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace lslog - Displays information about a log
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_lslog - Displays information about a log
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_lsset.pod
diff -c openafs/doc/man-pages/pod8/fstrace_lsset.pod:1.3 openafs/doc/man-pages/pod8/fstrace_lsset.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/fstrace_lsset.pod:1.3 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_lsset.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace lsset - Reports the status of an event set
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_lsset - Reports the status of an event set
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_setlog.pod
diff -c openafs/doc/man-pages/pod8/fstrace_setlog.pod:1.3 openafs/doc/man-pages/pod8/fstrace_setlog.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/fstrace_setlog.pod:1.3 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_setlog.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace setlog - Sets the size of a trace log
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_setlog - Sets the size of a trace log
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/fstrace_setset.pod
diff -c openafs/doc/man-pages/pod8/fstrace_setset.pod:1.4 openafs/doc/man-pages/pod8/fstrace_setset.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/fstrace_setset.pod:1.4 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/fstrace_setset.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! fstrace setset - Sets the status of an event set
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! fstrace_setset - Sets the status of an event set
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_apropos.pod
diff -c openafs/doc/man-pages/pod8/kas_apropos.pod:1.3 openafs/doc/man-pages/pod8/kas_apropos.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/kas_apropos.pod:1.3 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/kas_apropos.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_apropos - Displays each help entry containing a keyword string
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_create.pod
diff -c openafs/doc/man-pages/pod8/kas_create.pod:1.4 openafs/doc/man-pages/pod8/kas_create.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_create.pod:1.4 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/kas_create.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas create - Creates an entry in the Authentication Database
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_create - Creates an entry in the Authentication Database
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_delete.pod
diff -c openafs/doc/man-pages/pod8/kas_delete.pod:1.4 openafs/doc/man-pages/pod8/kas_delete.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_delete.pod:1.4 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/kas_delete.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas delete - Deletes an entry from the Authentication Database
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_delete - Deletes an entry from the Authentication Database
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_examine.pod
diff -c openafs/doc/man-pages/pod8/kas_examine.pod:1.5 openafs/doc/man-pages/pod8/kas_examine.pod:1.5.2.1
*** openafs/doc/man-pages/pod8/kas_examine.pod:1.5 Wed Mar 1 00:02:31 2006
--- openafs/doc/man-pages/pod8/kas_examine.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas examine - Displays information from an Authentication Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_examine - Displays information from an Authentication Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_forgetticket.pod
diff -c openafs/doc/man-pages/pod8/kas_forgetticket.pod:1.3 openafs/doc/man-pages/pod8/kas_forgetticket.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/kas_forgetticket.pod:1.3 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_forgetticket.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas forgetticket - Discards all tickets for the issuer
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_forgetticket - Discards all tickets for the issuer
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_help.pod
diff -c openafs/doc/man-pages/pod8/kas_help.pod:1.4 openafs/doc/man-pages/pod8/kas_help.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_help.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_help.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas help - Displays help for kas commands
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_help - Displays help for kas commands
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_interactive.pod
diff -c openafs/doc/man-pages/pod8/kas_interactive.pod:1.4 openafs/doc/man-pages/pod8/kas_interactive.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_interactive.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_interactive.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas interactive - Enters interactive mode
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_interactive - Enters interactive mode
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_list.pod
diff -c openafs/doc/man-pages/pod8/kas_list.pod:1.4 openafs/doc/man-pages/pod8/kas_list.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_list.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_list.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas list - Displays all entries in the Authentication Database
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_list - Displays all entries in the Authentication Database
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_listtickets.pod
diff -c openafs/doc/man-pages/pod8/kas_listtickets.pod:1.3 openafs/doc/man-pages/pod8/kas_listtickets.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/kas_listtickets.pod:1.3 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_listtickets.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas listtickets - Displays all of the issuer's tickets (tokens)
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_listtickets - Displays all of the issuer's tickets (tokens)
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_noauthentication.pod
diff -c openafs/doc/man-pages/pod8/kas_noauthentication.pod:1.3 openafs/doc/man-pages/pod8/kas_noauthentication.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/kas_noauthentication.pod:1.3 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_noauthentication.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas noauthentication - Discards an authenticated identity in interactive mode
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_noauthentication - Discards an authenticated identity in interactive mode
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_quit.pod
diff -c openafs/doc/man-pages/pod8/kas_quit.pod:1.3 openafs/doc/man-pages/pod8/kas_quit.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/kas_quit.pod:1.3 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_quit.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas quit - Leaves interactive mode
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_quit - Leaves interactive mode
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_setfields.pod
diff -c openafs/doc/man-pages/pod8/kas_setfields.pod:1.5 openafs/doc/man-pages/pod8/kas_setfields.pod:1.5.2.1
*** openafs/doc/man-pages/pod8/kas_setfields.pod:1.5 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_setfields.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas setfields - Sets fields in an Authentication Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_setfields - Sets fields in an Authentication Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_setpassword.pod
diff -c openafs/doc/man-pages/pod8/kas_setpassword.pod:1.5 openafs/doc/man-pages/pod8/kas_setpassword.pod:1.5.2.1
*** openafs/doc/man-pages/pod8/kas_setpassword.pod:1.5 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_setpassword.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas setpassword - Changes the key field in an Authentication Database entry
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_setpassword - Changes the key field in an Authentication Database entry
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_statistics.pod
diff -c openafs/doc/man-pages/pod8/kas_statistics.pod:1.5 openafs/doc/man-pages/pod8/kas_statistics.pod:1.5.2.1
*** openafs/doc/man-pages/pod8/kas_statistics.pod:1.5 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_statistics.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas statistics - Displays statistics from an Authentication Server process
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_statistics - Displays statistics from an Authentication Server process
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_stringtokey.pod
diff -c openafs/doc/man-pages/pod8/kas_stringtokey.pod:1.4 openafs/doc/man-pages/pod8/kas_stringtokey.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_stringtokey.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_stringtokey.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas stringtokey - Converts a character string into an octal key
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_stringtokey - Converts a character string into an octal key
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/kas_unlock.pod
diff -c openafs/doc/man-pages/pod8/kas_unlock.pod:1.4 openafs/doc/man-pages/pod8/kas_unlock.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/kas_unlock.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/kas_unlock.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! kas unlock - Unlocks a locked user account
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! kas_unlock - Unlocks a locked user account
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/read_tape.pod
diff -c /dev/null openafs/doc/man-pages/pod8/read_tape.pod:1.1.2.2
*** /dev/null Sun Dec 9 18:54:48 2007
--- openafs/doc/man-pages/pod8/read_tape.pod Thu Nov 29 00:35:36 2007
***************
*** 0 ****
--- 1,106 ----
+ =head1 NAME
+
+ read_tape - Reads volume dumps from a backup tape to a file
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B S<<< B<-tape> > >>>
+ S<<< B<-restore> > >>>
+ S<<< B<-skip> > >>>
+ S<<< B<-file> > >>> [B<-scan>] [B<-noask>] [B<-label>]
+ [B<-vheaders>] [B<-verbose>] [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ B reads an OpenAFS backup tape and prompts for each dump file to
+ save. This command does not require any OpenAFS infrastructure. This
+ command does not need an OpenAFS client or server to be available, which is
+ not the case with the L command.
+
+ The dump files will be named for the Read/Write name of the volume restored.
+ After saving each dump file, B or B can be used to
+ restore the volume into AFS and non-AFS space respectively.
+
+ B reads the tape while skipping the specified number of volumes.
+ After that, it restores the specified number of volumes. B
+ doesn't rewind the tape so that it may be used multiple times in succession.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item B<-tape> >
+
+ Specifies the tape device from which to restore.
+
+ =item B<-restore> >
+
+ Specifies the number of volumes to restore from tape.
+
+ =item B<-skip> >
+
+ Specifies the number of volumes to skip before starting the restore.
+
+ =item B<-file> >
+
+ Specifies an alternate name for the restored volume dump file rather than
+ the default of the volume name.
+
+ =item B<-scan>
+
+ Scans the tape.
+
+ =item B<-noask>
+
+ Doesn't prompt for each volume.
+
+ =item B<-label>
+
+ Displays the full dump label.
+
+ =item B<-vheaders>
+
+ Displays the full volume headers.
+
+ =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
+ ignored.
+
+ =back
+
+ =head1 EXAMPLES
+
+ The following command will read the third through fifth volumes from
+ the tape device /dev/tape without prompting:
+
+ % read_tape -tape /dev/tape -skip 2 -restore 3 -noask
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must have access to read and write to the specified tape device.
+
+ =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/pod8/uss_add.pod
diff -c openafs/doc/man-pages/pod8/uss_add.pod:1.4 openafs/doc/man-pages/pod8/uss_add.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/uss_add.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/uss_add.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! uss add - Creates a user account
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! uss_add - Creates a user account
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/uss_apropos.pod
diff -c openafs/doc/man-pages/pod8/uss_apropos.pod:1.3 openafs/doc/man-pages/pod8/uss_apropos.pod:1.3.2.1
*** openafs/doc/man-pages/pod8/uss_apropos.pod:1.3 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/uss_apropos.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! uss apropos - Displays each help entry containing a keyword string.
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! uss_apropos - Displays each help entry containing a keyword string.
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/uss_bulk.pod
diff -c openafs/doc/man-pages/pod8/uss_bulk.pod:1.4 openafs/doc/man-pages/pod8/uss_bulk.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/uss_bulk.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/uss_bulk.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! uss bulk - Executes multiple uss commands listed in a file
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! uss_bulk - Executes multiple uss commands listed in a file
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/uss_delete.pod
diff -c openafs/doc/man-pages/pod8/uss_delete.pod:1.4 openafs/doc/man-pages/pod8/uss_delete.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/uss_delete.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/uss_delete.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! uss delete - Deletes a user account
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! uss_delete - Deletes a user account
=head1 SYNOPSIS
Index: openafs/doc/man-pages/pod8/uss_help.pod
diff -c openafs/doc/man-pages/pod8/uss_help.pod:1.4 openafs/doc/man-pages/pod8/uss_help.pod:1.4.2.1
*** openafs/doc/man-pages/pod8/uss_help.pod:1.4 Wed Mar 1 00:02:32 2006
--- openafs/doc/man-pages/pod8/uss_help.pod Sun Nov 11 18:51:06 2007
***************
*** 1,6 ****
=head1 NAME
! uss help - Displays help for uss commands
=head1 SYNOPSIS
--- 1,6 ----
=head1 NAME
! uss_help - Displays help for uss commands
=head1 SYNOPSIS
Index: openafs/doc/txt/winnotes/afs-changes-since-1.2.txt
diff -c openafs/doc/txt/winnotes/afs-changes-since-1.2.txt:1.72.2.37 openafs/doc/txt/winnotes/afs-changes-since-1.2.txt:1.72.2.39
*** openafs/doc/txt/winnotes/afs-changes-since-1.2.txt:1.72.2.37 Tue Nov 6 23:09:13 2007
--- openafs/doc/txt/winnotes/afs-changes-since-1.2.txt Fri Dec 7 10:54:21 2007
***************
*** 1,3 ****
--- 1,44 ----
+ Since 1.5.27
+ * The GiveUpAllCallBacks functionality that was added in 1.5.21
+ has been disabled. It has been disabled because it turns out
+ that the RPC is improperly implemented in all file servers
+ previous to 1.4.6. The RPC is executed without the proper
+ locks being held resulting in data corruption and eventual file
+ server failure. The functionality will be re-enabled in a
+ a few months.
+
+ * a couple of .readonly Volume Callback optimizations were
+ implemented:
+ - Apply most recent volume callback to all stat cache objects
+ in the volume. This avoids premature callback expirations
+ and unnecessary FetchStatus calls.
+ - Add option to permit attempts to renew .readonly Volume
+ Callbacks on a periodic basis to avoid invalidation of stat
+ cache data. [Requires daemonCheckVolCBInterval be set to
+ non-zero number of seconds. 1800 (30 minutes) is suggested.]
+
+ * Adds support for 64-bit data version values. Previous releases
+ only supported 32-bit values. Larger values sent by the file server
+ would result in rollover.
+
+ * aklog and asetkey no longer generate an exception if Kerberos for
+ Windows is not installed.
+
+ * If the LSA authentication functions report a temporary out of memory
+ condition, fail the current authentication and do not cause the AFS
+ client service to terminate unexpectedly.
+
+ * When the AFS client service is shutting down, prevent the daemon check
+ thread from executing additional checks which might attempt to access
+ discarded locks or unmapped memory.
+
+ * Correct a double free condition in the NIM AFS credentials provider.
+
+ * Add "FollowBackupPath" service parameter registry value.
+ This provides equivalent functionality to the UNIX afsd -backuptree
+ option. When set to a non-zero value, normal mount points originating
+ in a .backup volume will prefer a .backup volume.
+
Since 1.5.26
* Fix NSIS uninstall from the .MSI installer.