Index: openafs/doc/LICENSE diff -c openafs/doc/LICENSE:1.1.20.2 openafs/doc/LICENSE:1.1.20.3 *** openafs/doc/LICENSE:1.1.20.2 Mon Feb 27 15:18:33 2006 --- openafs/doc/LICENSE Tue Dec 25 17:32:09 2007 *************** *** 692,694 **** --- 692,737 ---- */ src/afs/LINUX/osi_flush.s included code under IBM Public License with permission of the author, Paul MacKerras. + + =========================================================== + + Personal contributions made by Jason Edgecombe + that refer to the "BSD license" are subject + to the following license: + + + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + * Redistributions of source code must retain the above + copyright notice, this list of conditions and the following + disclaimer. + + * Redistributions in binary form must reproduce the above + copyright notice, this list of conditions and the following + disclaimer in the documentation and/or other materials + provided with the distribution. + + * Neither the name of OpenAFS nor the names of its + contributors may be used to endorse or promote products + derived from this software without specific prior written + permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND + CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, + INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS + BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR + TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF + THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + SUCH DAMAGE. + + ==================================================== \ No newline at end of file Index: openafs/doc/man-pages/README diff -c openafs/doc/man-pages/README:1.4.2.20 openafs/doc/man-pages/README:1.4.2.26 *** openafs/doc/man-pages/README:1.4.2.20 Sun Aug 19 18:27:02 2007 --- openafs/doc/man-pages/README Tue Feb 19 10:31:02 2008 *************** *** 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,218 ---- * The following installed commands have no man pages: copyauth + fs cscpolicy + fs memdump + fs monitor fs rxstatpeer 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. --- 224,229 ---- Index: openafs/doc/man-pages/pod1/cmdebug.pod diff -c openafs/doc/man-pages/pod1/cmdebug.pod:1.1.2.3 openafs/doc/man-pages/pod1/cmdebug.pod:1.1.2.4 *** openafs/doc/man-pages/pod1/cmdebug.pod:1.1.2.3 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/cmdebug.pod Mon Jan 14 00:03:53 2008 *************** *** 8,27 ****
B S<<< B<-servers> > >>> S<<< [B<-port> >] >>> ! [B<-long>] [B<-refcounts>] [B<-callbacks>] [B<-addrs>] [B<-cache>] ! B S<<< B<-s> > >>> S<<< [B<-p> >] >>> [B<-l>] [B<-r>] [B<-c>] ! [B<-a>] [B<-h>] =for html
=head1 DESCRIPTION ! The B command displays information about the Cache Manager and ! client cache status on an AFS client machine. By default, it displays all ! locked cache entries, but other information can be requested via various ! options. =head1 OPTIONS --- 8,40 ----
B S<<< B<-servers> > >>> S<<< [B<-port> >] >>> ! [B<-long>] [B<-refcounts>] [B<-callbacks>] [B<-ctime>] [B<-addrs>] ! [B<-cache>] [B<-cellservdb>] [B<-help>] ! B S<<< B<-s> > >>> S<<< [B<-p> >] >>> [B<-l>] [B<-r>] [B<-cal>] ! [B<-ct>] [B<-a>] [B<-cac>] B<-ce>] [B<-h>] =for html
=head1 DESCRIPTION ! The B command displays information about the Cache Manager ! and client cache status on a local or remote AFS client machine. By ! default, it displays all locked cache entries, but other information ! can be requested via various options. ! ! =head1 CAUTIONS ! ! The B<-ctime> option is only available with OpenAFS version 1.4.7 and ! later or version 1.5.28 or later. This option can be used to gather ! information from any version of the Unix OpenAFS client, but can only ! query Windows clients running OpenAFS version 1.5.28 or later. ! ! The B<-cellservdb> option is only available with OpenAFS version 1.4.7 ! and later or version 1.5.31 or later. This option can be used to gather ! information from any version of the Unix OpenAFS client, but can only ! query Windows clients running OpenAFS version 1.5.31 or later. =head1 OPTIONS *************** *** 31,41 **** Names the client machine for which to display Cache Manager status. Provide the machine's IP address in dotted decimal format, its fully ! qualified host name (for example, B), or the shortest abbreviated form of its host name that distinguishes it from other machines. Successful use of an abbreviated form depends on the ! availability of a name resolution service (such as the Domain Name Service ! or a local host table) at the time the command is issued. =item B<-port> > --- 44,54 ---- Names the client machine for which to display Cache Manager status. Provide the machine's IP address in dotted decimal format, its fully ! qualified host name (for example, B), or the shortest abbreviated form of its host name that distinguishes it from other machines. Successful use of an abbreviated form depends on the ! availability of a name resolution service (such as the Domain Name ! Service or a local host table) at the time the command is issued. =item B<-port> > *************** *** 46,52 **** Reports on all lock statuses and all cache entries, rather than only locked cache entries. Do not use this option with B<-refcounts>, ! B<-callbacks>, B<-addrs>, or B<-cache>. =item B<-refcounts> --- 59,65 ---- Reports on all lock statuses and all cache entries, rather than only locked cache entries. Do not use this option with B<-refcounts>, ! B<-callbacks>, B<-addrs>, B<-cache>, or B<-cellservdb>. =item B<-refcounts> *************** *** 58,63 **** --- 71,81 ---- Reports only those cache entries with callbacks. Do not use this option with B<-long>, B<-refcounts>, B<-addrs>, or B<-cache>. + =item B<-ctime> + + Causes entry expiration times to be shown in human-readable format. Do + not use this option with B<-addrs> or B<-cache>. + =item B<-addrs> Rather than showing any cache entries, displays the interfaces the Cache *************** *** 73,78 **** --- 91,105 ---- information that can be configured via parameters to B. Do not use this option with B<-long>, B<-refcounts>, B<-callbacks>, or B<-addrs>. + =item B<-cellservdb> + + Lists all known volume location database records in a + CellServDB-compatible format. This includes all records in memory, + including those from the CellServDB file, AFSDB DNS records, and the + B command. This option could be used to see if a client + has the latest copy of the CellServDB file. Do not use this option + with B<-long>, B<-refcounts>, B<-callbacks>, or B<-cache>. + =item B<-help> Prints the online help for this command. All other valid options are *************** *** 86,98 **** % cmdebug client1 ! Displays the cache configuration for C: ! % cmdebug client1.abc.com -cache ! Displays all cache entries for C: ! % cmdebug client2.abc.com -long =head1 PRIVILEGE REQUIRED --- 113,125 ---- % cmdebug client1 ! Displays the cache configuration for C: ! % cmdebug client1.example.com -cache ! Displays all cache entries for C: ! % cmdebug client2.example.com -long =head1 PRIVILEGE REQUIRED *************** *** 100,106 **** =head1 SEE ALSO ! L =head1 COPYRIGHT --- 127,135 ---- =head1 SEE ALSO ! L, ! L, ! L =head1 COPYRIGHT Index: openafs/doc/man-pages/pod1/fs.pod diff -c openafs/doc/man-pages/pod1/fs.pod:1.3.2.8 openafs/doc/man-pages/pod1/fs.pod:1.3.2.9 *** openafs/doc/man-pages/pod1/fs.pod:1.3.2.8 Fri Aug 17 21:58:24 2007 --- openafs/doc/man-pages/pod1/fs.pod Tue Dec 25 17:28:16 2007 *************** *** 27,32 **** --- 27,33 ---- L|fs_setcrypt(1)>, L|fs_setserverprefs(1)>, L|fs_sysname(1)>, + L|fs_uuid(1)>, and L|fs_wscell(1)>. =item * Index: openafs/doc/man-pages/pod1/fs_apropos.pod diff -c openafs/doc/man-pages/pod1/fs_apropos.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_apropos.pod:1.2.2.4 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/fs_apropos.pod Sun Nov 11 19:18:19 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.3.2.5 openafs/doc/man-pages/pod1/fs_checkservers.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_checkservers.pod:1.3.2.5 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/fs_checkservers.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_checkvolumes.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_checkvolumes.pod:1.2.2.4 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/fs_checkvolumes.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_cleanacl.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_cleanacl.pod:1.3.2.5 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/fs_cleanacl.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_copyacl.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_copyacl.pod:1.3.2.5 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/fs_copyacl.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_diskfree.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_diskfree.pod:1.3.2.5 Wed Mar 1 00:11:18 2006 --- openafs/doc/man-pages/pod1/fs_diskfree.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_examine.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_examine.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_examine.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_exportafs.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_exportafs.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_exportafs.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_flush.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_flush.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_flush.pod Sun Nov 11 18:52:53 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.4.2 openafs/doc/man-pages/pod1/fs_flushall.pod:1.1.4.4 *** openafs/doc/man-pages/pod1/fs_flushall.pod:1.1.4.2 Fri Aug 17 21:58:25 2007 --- openafs/doc/man-pages/pod1/fs_flushall.pod Tue Dec 25 17:32:10 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 *************** *** 58,62 **** 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. --- 58,63 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_flushmount.pod diff -c openafs/doc/man-pages/pod1/fs_flushmount.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_flushmount.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_flushmount.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_flushmount.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_flushvolume.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_flushvolume.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_flushvolume.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_getcacheparms.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_getcacheparms.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_getcacheparms.pod Sun Nov 11 18:52:53 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.4.2 openafs/doc/man-pages/pod1/fs_getcalleraccess.pod:1.1.4.4 *** openafs/doc/man-pages/pod1/fs_getcalleraccess.pod:1.1.4.2 Fri Aug 17 21:58:25 2007 --- openafs/doc/man-pages/pod1/fs_getcalleraccess.pod Tue Dec 25 17:32:10 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 *************** *** 69,73 **** 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. --- 69,74 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_getcellstatus.pod diff -c openafs/doc/man-pages/pod1/fs_getcellstatus.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_getcellstatus.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_getcellstatus.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_getcellstatus.pod Sun Nov 11 18:52:53 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.2.2.5 openafs/doc/man-pages/pod1/fs_getclientaddrs.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/fs_getclientaddrs.pod:1.2.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_getclientaddrs.pod Sun Nov 11 18:52:53 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.2.5 openafs/doc/man-pages/pod1/fs_getcrypt.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/fs_getcrypt.pod:1.3.2.5 Fri Aug 17 21:48:13 2007 --- openafs/doc/man-pages/pod1/fs_getcrypt.pod Tue Dec 25 17:32:10 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 *************** *** 73,77 **** 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. --- 73,78 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_getserverprefs.pod diff -c openafs/doc/man-pages/pod1/fs_getserverprefs.pod:1.3.2.5 openafs/doc/man-pages/pod1/fs_getserverprefs.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_getserverprefs.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_getserverprefs.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_help.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_help.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_listacl.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_listacl.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_listacl.pod Sun Nov 11 18:52:53 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.2.4 openafs/doc/man-pages/pod1/fs_listaliases.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/fs_listaliases.pod:1.2.2.4 Fri Aug 17 21:48:13 2007 --- openafs/doc/man-pages/pod1/fs_listaliases.pod Tue Dec 25 17:32:10 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 *************** *** 57,61 **** 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. --- 57,62 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_listcells.pod diff -c openafs/doc/man-pages/pod1/fs_listcells.pod:1.3.2.5 openafs/doc/man-pages/pod1/fs_listcells.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_listcells.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_listcells.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_listquota.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/fs_listquota.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_listquota.pod Tue Feb 19 10:31:05 2008 *************** *** 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 *************** *** 28,33 **** --- 28,44 ---- To set volume quota, use the B or B command. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/fs_lsmount.pod diff -c openafs/doc/man-pages/pod1/fs_lsmount.pod:1.3.2.5 openafs/doc/man-pages/pod1/fs_lsmount.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_lsmount.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_lsmount.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_messages.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_messages.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_messages.pod Sun Nov 11 18:52:53 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_minidump.pod diff -c /dev/null openafs/doc/man-pages/pod1/fs_minidump.pod:1.1.4.2 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/fs_minidump.pod Tue Feb 19 10:31:05 2008 *************** *** 0 **** --- 1,47 ---- + =head1 NAME + + fs_minidump - Generate a minidump from the current afsd service + + =head1 SYNOPSIS + + =for html +
+ + B [B<-help>] + + =for html +
+ + =head1 DESCRIPTION + + B generates a mini dump file containing the current stack + of the afsd_service.exe process. This output can be very helpful when + debugging the AFS Client Service when it is unresponsive to SMB/CIFS + requests. + + =head1 CAUTIONS + + This command is only available in OpenAFS for Windows version 1.4 and later. + + =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 + + =head1 COPYRIGHT + + Copyright 2007 Jason Edgecombe + + This documentation is covered by the BSD License as written in the + doc/LICENSE file. This man page was written by Jason Edgecombe for + OpenAFS. Index: openafs/doc/man-pages/pod1/fs_mkmount.pod diff -c openafs/doc/man-pages/pod1/fs_mkmount.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_mkmount.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_mkmount.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_mkmount.pod Sun Nov 11 18:52:53 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.2.2 openafs/doc/man-pages/pod1/fs_newalias.pod:1.1.2.4 *** openafs/doc/man-pages/pod1/fs_newalias.pod:1.1.2.2 Sun Aug 5 19:37:14 2007 --- openafs/doc/man-pages/pod1/fs_newalias.pod Tue Dec 25 17:32:10 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 *************** *** 92,96 **** 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. --- 92,97 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_newcell.pod diff -c openafs/doc/man-pages/pod1/fs_newcell.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_newcell.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_newcell.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_newcell.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_quota.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/fs_quota.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_quota.pod Tue Feb 19 10:31:05 2008 *************** *** 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 *************** *** 24,29 **** --- 24,40 ---- To set volume quota, use the B or B command. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/fs_rmmount.pod diff -c openafs/doc/man-pages/pod1/fs_rmmount.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_rmmount.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_rmmount.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_rmmount.pod Sun Nov 11 18:52:53 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.4.3 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/fs_rxstatpeer.pod Tue Dec 25 17:32:10 2007 *************** *** 0 **** --- 1,68 ---- + =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 BSD License as written in the + doc/LICENSE file. 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.3.2.6 openafs/doc/man-pages/pod1/fs_setacl.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/fs_setacl.pod:1.3.2.6 Mon Jan 29 14:32:02 2007 --- openafs/doc/man-pages/pod1/fs_setacl.pod Sun Nov 11 18:52:53 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.3.2.6 openafs/doc/man-pages/pod1/fs_setcachesize.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/fs_setcachesize.pod:1.3.2.6 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_setcachesize.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_setcell.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_setcell.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_setcell.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_setclientaddrs.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_setclientaddrs.pod:1.2.2.4 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_setclientaddrs.pod Sun Nov 11 18:52:53 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.2.4 openafs/doc/man-pages/pod1/fs_setcrypt.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_setcrypt.pod:1.3.2.4 Sun Aug 5 19:37:14 2007 --- openafs/doc/man-pages/pod1/fs_setcrypt.pod Tue Dec 25 17:32:10 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 *************** *** 94,98 **** 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. --- 94,99 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_setquota.pod diff -c openafs/doc/man-pages/pod1/fs_setquota.pod:1.3.2.5 openafs/doc/man-pages/pod1/fs_setquota.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/fs_setquota.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_setquota.pod Tue Feb 19 10:31:05 2008 *************** *** 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 *************** *** 29,34 **** --- 29,45 ---- To display a volume's quota, use the B, B, or B command. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/fs_setserverprefs.pod diff -c openafs/doc/man-pages/pod1/fs_setserverprefs.pod:1.3.2.5 openafs/doc/man-pages/pod1/fs_setserverprefs.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_setserverprefs.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_setserverprefs.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/fs_setvol.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/fs_setvol.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_setvol.pod Tue Feb 19 10:31:05 2008 *************** *** 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 *************** *** 36,41 **** --- 36,52 ---- To set quota on one volume at a time, use the B command. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/fs_storebehind.pod diff -c openafs/doc/man-pages/pod1/fs_storebehind.pod:1.3.2.5 openafs/doc/man-pages/pod1/fs_storebehind.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/fs_storebehind.pod:1.3.2.5 Wed Mar 1 00:11:19 2006 --- openafs/doc/man-pages/pod1/fs_storebehind.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_sysname.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/fs_sysname.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/fs_sysname.pod Thu Nov 29 00:49:27 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.4.2 openafs/doc/man-pages/pod1/fs_uuid.pod:1.1.4.5 *** openafs/doc/man-pages/pod1/fs_uuid.pod:1.1.4.2 Tue Oct 23 13:04:23 2007 --- openafs/doc/man-pages/pod1/fs_uuid.pod Tue Dec 25 17:32:10 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 ---- *************** *** 78,82 **** 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. --- 77,82 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/fs_whereis.pod diff -c openafs/doc/man-pages/pod1/fs_whereis.pod:1.2.2.4 openafs/doc/man-pages/pod1/fs_whereis.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_whereis.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/fs_whereis.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_whichcell.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_whichcell.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/fs_whichcell.pod Sun Nov 11 18:52:53 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.2.2.4 openafs/doc/man-pages/pod1/fs_wscell.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/fs_wscell.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/fs_wscell.pod Sun Nov 11 18:52:53 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.pod diff -c openafs/doc/man-pages/pod1/pts.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/pts.pod:1.2.2.4 Fri Aug 17 21:48:14 2007 --- openafs/doc/man-pages/pod1/pts.pod Mon Feb 4 12:53:58 2008 *************** *** 91,96 **** --- 91,102 ---- The local F file. + Do not combine the B<-cell> and B<-localauth> options. A command on which + the B<-localauth> flag is included always runs in the local cell (as + defined in the server machine's local F file), + whereas a command on which the B<-cell> argument is included runs in the + specified foreign cell. + =back =item B<-force> *************** *** 123,128 **** --- 129,157 ---- and refuses to perform such an action even if the B<-noauth> flag is provided. + =item B<-localauth> + + Constructs a server ticket using the server encryption key with the + highest key version number in the local F file. The + B command interpreter presents the ticket, which never expires, to + the BOS Server during mutual authentication. + + Use this flag only when issuing a command on a server machine; client + machines do not usually have a F file. The issuer + of a command that includes this flag must be logged on to the server + machine as the local superuser C. The flag is useful for commands + invoked by an unattended application program, such as a process controlled + by the UNIX B utility. It is also useful if an administrator is + unable to authenticate to AFS but is logged in as the local superuser + C. + + Do not combine the B<-cell> and B<-localauth> options. A command on which + the B<-localauth> flag is included always runs in the local cell (as + defined in the server machine's local F file), + whereas a command on which the B<-cell> argument is included runs in the + specified foreign cell. Also, do not combine the B<-localauth> and + B<-noauth> flags. + =back =head1 PRIVILEGE REQUIRED Index: openafs/doc/man-pages/pod1/pts_adduser.pod diff -c openafs/doc/man-pages/pod1/pts_adduser.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_adduser.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_adduser.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_adduser.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< B<-user> >+ >>> S<<< B<-group> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-u> >+ >>> S<<< B<-g> >+ >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-f>] [B<-h>] =for html
--- 8,17 ----
B S<<< B<-user> >+ >>> S<<< B<-group> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] B S<<< B<-u> >+ >>> S<<< B<-g> >+ >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 60,65 **** --- 60,73 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. The B command interpreter presents the + ticket to the Protection Server during mutual authentication. Do not combine + this flag with the B<-cell> or B<-noauth> options. For more details, see + L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_apropos.pod diff -c openafs/doc/man-pages/pod1/pts_apropos.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/pts_apropos.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_apropos.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/pts_chown.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_chown.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_chown.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< B<-name> > >>> S<<< B<-owner> > >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> > >>> S<<< B<-o> > >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-f>] [B<-h>] =for html
--- 8,17 ----
B S<<< B<-name> > >>> S<<< B<-owner> > >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] B S<<< B<-na> > >>> S<<< B<-o> > >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 62,67 **** --- 62,73 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the B<-cell> + or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_creategroup.pod diff -c openafs/doc/man-pages/pod1/pts_creategroup.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_creategroup.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_creategroup.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_creategroup.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 10,24 **** B S<<< B<-name> >+ >>> S<<< [B<-owner> >] >>> S<<< [B<-id> >+] >>> S<<< [B<-cell> >] >>> ! [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-o> >] >>> S<<< [B<-i> >+] >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-o> >] >>> S<<< [B<-i> >+] >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] =for html --- 10,24 ---- B S<<< B<-name> >+ >>> S<<< [B<-owner> >] >>> S<<< [B<-id> >+] >>> S<<< [B<-cell> >] >>> ! [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-o> >] >>> S<<< [B<-i> >+] >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-o> >] >>> S<<< [B<-i> >+] >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html *************** *** 154,159 **** --- 154,165 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_createuser.pod diff -c openafs/doc/man-pages/pod1/pts_createuser.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_createuser.pod:1.3.2.8 *** openafs/doc/man-pages/pod1/pts_createuser.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_createuser.pod Mon Feb 4 14:42:15 2008 *************** *** 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 *************** *** 8,20 ****
B S<<< B<-name> >+ >>> S<<< [B<-id> >+] >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-i> >+] >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-i> >+] >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-f>] [B<-h>] =for html
--- 8,21 ----
B S<<< B<-name> >+ >>> S<<< [B<-id> >+] >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-force>] ! [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-i> >+] >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-i> >+] >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 137,142 **** --- 138,149 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_delete.pod diff -c openafs/doc/man-pages/pod1/pts_delete.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts_delete.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/pts_delete.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_delete.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< B<-nameorid> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-f>] [-h] =for html
--- 8,18 ----
B S<<< B<-nameorid> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] ! [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> ! S<<< [B<-c> >] >>> [B<-no>] [B<-l>] [B<-f>] [-h] =for html
*************** *** 71,76 **** --- 72,83 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_examine.pod diff -c openafs/doc/man-pages/pod1/pts_examine.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_examine.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_examine.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_examine.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,23 ****
B S<<< B<-nameorid> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] =for html
--- 8,24 ----
B S<<< B<-nameorid> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] ! [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 51,56 **** --- 52,63 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_help.pod diff -c openafs/doc/man-pages/pod1/pts_help.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/pts_help.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_help.pod Sun Nov 11 18:52:53 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.2.2 openafs/doc/man-pages/pod1/pts_interactive.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/pts_interactive.pod:1.2.2.2 Fri Aug 17 22:47:28 2007 --- openafs/doc/man-pages/pod1/pts_interactive.pod Mon Feb 4 12:53:58 2008 *************** *** 1,6 **** =head1 NAME ! pts interactive - Enters interactive mode =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! pts_interactive - Enters interactive mode =head1 SYNOPSIS *************** *** 8,14 ****
B S<<< [B<-cell>] > >>> [B<-noauth>] ! [B<-force>] B S<<< [B<-c>] > >>> [B<-n>] [B<-f>] --- 8,14 ----
B S<<< [B<-cell>] > >>> [B<-noauth>] ! [B<-auth>] [B<-localauth>] [B<-force>] B S<<< [B<-c>] > >>> [B<-n>] [B<-f>] *************** *** 20,25 **** --- 20,31 ---- The B command allows the user to enter an interactive mode, useful for running bulk commands like creating new users or groups. + B uses the authentication state supplied on its command + line to run all bulk commands. However, if a bulk command is supplied + with authentication options such as B<-cell>, B<-localauth>, B<-auth> + or B<-noauth> then it, and all subsequent bulk commands, will be run with + those options. + =head1 CAUTIONS Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the B command *************** *** 56,61 **** --- 62,73 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =back =head1 OUTPUT *************** *** 115,119 **** 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. --- 127,132 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/pts_listentries.pod diff -c openafs/doc/man-pages/pod1/pts_listentries.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_listentries.pod:1.3.2.8 *** openafs/doc/man-pages/pod1/pts_listentries.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_listentries.pod Mon Feb 4 14:42:15 2008 *************** *** 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 *************** *** 8,16 ****
B [B<-users>] [B<-groups>] S<<< [B<-cell> >] >>> ! [B<-noauth>] [B<-force>] [B<-help>] ! B [B<-u>] [B<-g>] S<<< [B<-c> >] >>> [B<-n>] [B<-f>] [B<-h>] =for html
--- 8,17 ----
B [B<-users>] [B<-groups>] S<<< [B<-cell> >] >>> ! [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] ! B [B<-u>] [B<-g>] S<<< [B<-c> >] >>> [B<-n>] [B<-l>] ! [B<-f>] [B<-h>] =for html
*************** *** 47,52 **** --- 48,59 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_listmax.pod diff -c openafs/doc/man-pages/pod1/pts_listmax.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts_listmax.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/pts_listmax.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_listmax.pod Mon Feb 4 12:53:58 2008 *************** *** 1,15 **** =head1 NAME ! pts listmax - Displays the max user id and max group id counters =head1 SYNOPSIS =for html
! B S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] ! B S<<< [B<-c> >] >>> [B<-n>] [B<-f>] [B<-h>] =for html
--- 1,16 ---- =head1 NAME ! pts_listmax - Displays the max user id and max group id counters =head1 SYNOPSIS =for html
! B S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] ! [B<-force>] [B<-help>] ! B S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 44,49 **** --- 45,56 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_listowned.pod diff -c openafs/doc/man-pages/pod1/pts_listowned.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts_listowned.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/pts_listowned.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_listowned.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< B<-nameorid> >+ >>> ! [-cell >] [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> ! [-c >] [B<-no>] [B<-f>] [B<-h>] =for html
--- 8,17 ----
B S<<< B<-nameorid> >+ >>> ! [-cell >] [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> ! [-c >] [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 51,56 **** --- 51,62 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_membership.pod diff -c openafs/doc/man-pages/pod1/pts_membership.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_membership.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_membership.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_membership.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,23 ****
B S<<< B<-nameorid> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> [-c >] ! [B<-no>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] =for html
--- 8,24 ----
B S<<< B<-nameorid> >+ >>> ! S<<< [B<-cell> >] >>> [B<-localauth>] [B<-noauth>] ! [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> [-c >] ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] B S<<< B<-na> >+ >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 59,64 **** --- 60,71 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_quit.pod diff -c openafs/doc/man-pages/pod1/pts_quit.pod:1.1.4.2 openafs/doc/man-pages/pod1/pts_quit.pod:1.1.4.5 *** openafs/doc/man-pages/pod1/pts_quit.pod:1.1.4.2 Fri Aug 17 21:48:14 2007 --- openafs/doc/man-pages/pod1/pts_quit.pod Mon Feb 4 12:53:58 2008 *************** *** 1,15 **** =head1 NAME ! pts quit - Exit from pts interactive mode =head1 SYNOPSIS =for html
! B S<<< [B<-cell>] > >>> [B<-noauth>] [B<-force>] ! B S<<< [B<-c>] > >>> [B<-n>] [B<-f>] =for html
--- 1,16 ---- =head1 NAME ! pts_quit - Exit from pts interactive mode =head1 SYNOPSIS =for html
! B S<<< [B<-cell>] > >>> [B<-noauth>] [B<-localauth>] ! [B<-force>] ! B S<<< [B<-c>] > >>> [B<-n>] [B<-l>] [B<-f>] =for html
*************** *** 44,49 **** --- 45,56 ---- Enables the command to continue executing as far as possible when errors or other problems occur, rather than halting execution at the first error. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-noauth> Assigns the unprivileged identity anonymous to the issuer. For more *************** *** 72,76 **** 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. --- 79,84 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/pts_removeuser.pod diff -c openafs/doc/man-pages/pod1/pts_removeuser.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts_removeuser.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/pts_removeuser.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_removeuser.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< B<-user> >+ >>> S<<< B<-group> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-u> >+ >>> S<<< B<-g> >+ >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-f>] [B<-h>] =for html
--- 8,18 ----
B S<<< B<-user> >+ >>> S<<< B<-group> >+ >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-force>] ! [B<-help>] B S<<< B<-u> >+ >>> S<<< B<-g> >+ >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 56,61 **** --- 57,68 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_rename.pod diff -c openafs/doc/man-pages/pod1/pts_rename.pod:1.2.2.4 openafs/doc/man-pages/pod1/pts_rename.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/pts_rename.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_rename.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< B<-oldname> > >>> S<<< B<-newname> > >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-o> > >>> S<<< B<-ne> > >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] =for html
--- 8,18 ----
B S<<< B<-oldname> > >>> S<<< B<-newname> > >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] ! [B<-force>] [B<-help>] B S<<< B<-o> > >>> S<<< B<-ne> > >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 69,74 **** --- 70,81 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_setfields.pod diff -c openafs/doc/man-pages/pod1/pts_setfields.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_setfields.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_setfields.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_setfields.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 10,21 **** B S<<< B<-nameorid> >+ >>> S<<< [B<-access> >] >>> S<<< [B<-groupquota> >] >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-a> >] >>> S<<< [B<-g> >] >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-f>] [B<-h>] =for html
--- 10,22 ---- B S<<< B<-nameorid> >+ >>> S<<< [B<-access> >] >>> S<<< [B<-groupquota> >] >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] ! [B<-force>] [B<-help>] B S<<< B<-na> >+ >>> S<<< [B<-a> >] >>> S<<< [B<-g> >] >>> S<<< [B<-c> >] >>> ! [B<-no>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 203,208 **** --- 204,215 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_setmax.pod diff -c openafs/doc/man-pages/pod1/pts_setmax.pod:1.3.2.5 openafs/doc/man-pages/pod1/pts_setmax.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/pts_setmax.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/pts_setmax.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< [B<-group> >] >>> S<<< [B<-user> >] >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-force>] [B<-help>] B [B<-g> I>] S<<< [B<-u> >] >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-f>] [B<-h>] =for html
--- 8,17 ----
B S<<< [B<-group> >] >>> S<<< [B<-user> >] >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] B [B<-g> I>] S<<< [B<-u> >] >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>] =for html
*************** *** 56,61 **** --- 56,67 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =item B<-force> Enables the command to continue executing as far as possible when errors Index: openafs/doc/man-pages/pod1/pts_sleep.pod diff -c openafs/doc/man-pages/pod1/pts_sleep.pod:1.2.2.2 openafs/doc/man-pages/pod1/pts_sleep.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/pts_sleep.pod:1.2.2.2 Fri Aug 17 22:47:28 2007 --- openafs/doc/man-pages/pod1/pts_sleep.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< [B<-delay>] > >>> ! S<<< [B<-cell>] > >>> [B<-noauth>] [B<-force>] B S<<< [B<-d>] > >>> S<<< [B<-c>] > >>> ! [B<-n>] [B<-f>] =for html
--- 8,17 ----
B S<<< [B<-delay>] > >>> ! S<<< [B<-cell>] > >>> [B<-noauth>] [B<-localauth>] [B<-force>] B S<<< [B<-d>] > >>> S<<< [B<-c>] > >>> ! [B<-n>] [B<-l>] [B<-f>] =for html
*************** *** 33,39 **** =head1 OPTIONS ! Although they have no effect, B takes the following standard B options: =over 4 --- 33,39 ---- =head1 OPTIONS ! Although they have no effect, B takes the following standard B options: =over 4 *************** *** 53,58 **** --- 53,64 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =back =head1 OUTPUT *************** *** 77,81 **** 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. --- 83,88 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/pts_source.pod diff -c openafs/doc/man-pages/pod1/pts_source.pod:1.3.2.2 openafs/doc/man-pages/pod1/pts_source.pod:1.3.2.5 *** openafs/doc/man-pages/pod1/pts_source.pod:1.3.2.2 Fri Aug 17 22:47:28 2007 --- openafs/doc/man-pages/pod1/pts_source.pod Mon Feb 4 12:53:58 2008 *************** *** 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 *************** *** 8,17 ****
B S<<< [B<-file>] > >>> S<<< [B<-cell>] > >>> ! [B<-noauth>] [B<-force>] B S<<< [B<-f>] > >>> S<<< [B<-c>] > >>> ! [B<-n>] [B<-f>] =for html
--- 8,17 ----
B S<<< [B<-file>] > >>> S<<< [B<-cell>] > >>> ! [B<-noauth>] [B<-localauth>] [B<-force>] B S<<< [B<-f>] > >>> S<<< [B<-c>] > >>> ! [B<-n>] [B<-l>] [B<-f>] =for html
*************** *** 56,61 **** --- 56,67 ---- Assigns the unprivileged identity anonymous to the issuer. For more details, see L. + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. Do not combine this flag with the + B<-cell> or B<-noauth> options. For more details, see L. + =back =head1 OUTPUT *************** *** 86,90 **** 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. --- 92,97 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/rxdebug.pod diff -c openafs/doc/man-pages/pod1/rxdebug.pod:1.3.2.6 openafs/doc/man-pages/pod1/rxdebug.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/rxdebug.pod:1.3.2.6 Fri Aug 4 00:08:26 2006 --- openafs/doc/man-pages/pod1/rxdebug.pod Tue Dec 25 17:28:17 2007 *************** *** 183,188 **** --- 183,207 ---- for debugging purposes and is meaningful to someone familiar with the implementation of Rx. + =head1 EXAMPLES + + The following command shows Rx statistics on the server 192.168.1.100: + + % rxdebug 192.168.1.100 + Trying 192.168.1.100 (port 7000): + Free packets: 265, packet reclaims: 0, calls: 0, used FDs: 34 + not waiting for packets. + 0 calls waiting for a thread + 11 threads are idle + Done. + + The following command shows the OpenAFS version running on the server + 192.168.1.100: + + % rxdebug 192.168.1.100 -version + Trying 192.168.1.100 (port 7000): + AFS version: OpenAFS 1.4.2fc2 built 2006-08-31 + =head1 PRIVILEGE REQUIRED None. Index: openafs/doc/man-pages/pod1/symlink.pod diff -c /dev/null openafs/doc/man-pages/pod1/symlink.pod:1.1.4.3 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/symlink.pod Tue Dec 25 17:32:11 2007 *************** *** 0 **** --- 1,41 ---- + =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 BSD License as written in the + doc/LICENSE file. 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.4.3 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/symlink_list.pod Tue Dec 25 17:32:11 2007 *************** *** 0 **** --- 1,80 ---- + =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 BSD License as written in the + doc/LICENSE file. 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.4.3 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/symlink_make.pod Tue Dec 25 17:32:11 2007 *************** *** 0 **** --- 1,77 ---- + =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 BSD License as written in the + doc/LICENSE file. 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.4.3 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/symlink_remove.pod Tue Dec 25 17:32:11 2007 *************** *** 0 **** --- 1,71 ---- + =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 BSD License as written in the + doc/LICENSE file. This man page was written by Jason Edgecombe for + OpenAFS. Index: openafs/doc/man-pages/pod1/sys.pod diff -c openafs/doc/man-pages/pod1/sys.pod:1.3.2.5 openafs/doc/man-pages/pod1/sys.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/sys.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/sys.pod Tue Dec 25 17:28:17 2007 *************** *** 60,68 **** L, L ! I ! I =head1 COPYRIGHT --- 60,68 ---- L, L ! I ! I =head1 COPYRIGHT Index: openafs/doc/man-pages/pod1/vos.pod diff -c openafs/doc/man-pages/pod1/vos.pod:1.3.2.6 openafs/doc/man-pages/pod1/vos.pod:1.3.2.8 *** openafs/doc/man-pages/pod1/vos.pod:1.3.2.6 Fri Aug 17 22:38:14 2007 --- openafs/doc/man-pages/pod1/vos.pod Sat Jan 19 19:19:45 2008 *************** *** 94,99 **** --- 94,110 ---- =back + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS The following arguments and flags are available on many commands in the *************** *** 237,243 **** L, L, L, ! L, L, L, L, --- 248,255 ---- 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.3.2.5 openafs/doc/man-pages/pod1/vos_addsite.pod:1.3.2.8 *** openafs/doc/man-pages/pod1/vos_addsite.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/vos_addsite.pod Wed Feb 20 15:21:19 2008 *************** *** 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 *************** *** 9,21 **** B S<<< B<-server> > >>> S<<< B<-partition> > >>> ! S<<< B<-id> > >>> S<<< [B<-cell> >] >>> ! [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>] B S<<< B<-s> > >>> S<<< B<-p> > >>> ! S<<< B<-i> > >>> S<<< [B<-c> >] >>> ! [B<-n>] [B<-l>] [B<-v>] [B<-h>] =for html --- 9,22 ---- B S<<< B<-server> > >>> S<<< B<-partition> > >>> ! S<<< B<-id> > >>> S<<< B<-valid> > >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] ! [B<-verbose>] [B<-help>] B S<<< B<-s> > >>> S<<< B<-p> > >>> ! S<<< B<-i> > >>> S<<< B<-valid> > >>> ! S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] =for html *************** *** 68,73 **** --- 69,83 ---- Specifies either the complete name or volume ID number of the read/write source volume. + =item B<-valid> > + + Specifies the volume ID number of the existing release-equivalent + volume that is not already marked as a replica. This is useful when an + existing read-only volume is dumped and restored with the B<-readonly> + flag at the new site. This option is available in OpenAFS clients + 1.4.7 or later and 1.5.31 and later. This option can be used with + OpenAFS server versions later than 1.4.1 or 1.5.0. + =item B<-cell> > Names the cell in which to run the command. Do not combine this argument Index: openafs/doc/man-pages/pod1/vos_apropos.pod diff -c openafs/doc/man-pages/pod1/vos_apropos.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_apropos.pod:1.2.2.4 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/vos_apropos.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/vos_backup.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_backup.pod:1.3.2.5 Wed Mar 1 00:11:20 2006 --- openafs/doc/man-pages/pod1/vos_backup.pod Sun Nov 11 18:52:53 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.3.2.7 openafs/doc/man-pages/pod1/vos_backupsys.pod:1.3.2.8 *** openafs/doc/man-pages/pod1/vos_backupsys.pod:1.3.2.7 Fri Aug 17 21:48:14 2007 --- openafs/doc/man-pages/pod1/vos_backupsys.pod Sun Nov 11 18:52:53 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.3.2.5 openafs/doc/man-pages/pod1/vos_changeaddr.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_changeaddr.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_changeaddr.pod Sun Nov 11 18:52:53 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.4.3 openafs/doc/man-pages/pod1/vos_changeloc.pod:1.1.4.5 *** openafs/doc/man-pages/pod1/vos_changeloc.pod:1.1.4.3 Sun Aug 19 18:27:03 2007 --- openafs/doc/man-pages/pod1/vos_changeloc.pod Tue Dec 25 17:32:11 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 *************** *** 146,150 **** 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. --- 146,151 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/vos_convertROtoRW.pod diff -c /dev/null openafs/doc/man-pages/pod1/vos_convertROtoRW.pod:1.2.4.4 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/vos_convertROtoRW.pod Tue Dec 25 17:32:11 2007 *************** *** 0 **** --- 1,123 ---- + =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 +
+ + =head1 DESCRIPTION + + B converts a Read-Only volume into a Read/Write volume + when the original Read/Write volume is no longer available. It's normal use + is to recover the Read/Write volume from a replica after a failed disk, + failed server, or accidental deletion. + + =head1 CAUTIONS + + This command can only be used with namei AFS file servers. If used on an + inode AFS file server, it will fail with an error. + + The command name is case-sensitive. It must be issued with the capital "RO" + and "RW". + + =head1 OPTIONS + + =over 4 + + =item B<-server> > + + Identifies the file server machine that houses the Read-Only volume which + will be converted. Provide the machine's IP address or its host name + (either fully qualified or using an unambiguous abbreviation). For details, + see L. + + =item B<-partition> > + + Identifies the partition on the file server machine that houses the + Read-Only volume which will be converted. Provide the full partition name + (for, example, B) or one of the abbreviated forms described in + L. + + =item B<-id> > + + Specifies either the complete name or volume ID number of a Read/Write + volume. + + =item B<-force> + + Don't ask for confirmation. + + =item B<-cell> > + + Names the cell in which to run the command. Do not combine this argument + with the B<-localauth> flag. For more details, see L. + + =item B<-noauth> + + Assigns the unprivileged identity C to the issuer. Do not + combine this flag with the B<-localauth> flag. For more details, see + L. + + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. The B command interpreter presents it + to the Volume Server and Volume Location Server during mutual + authentication. Do not combine this flag with the B<-cell> argument or + B<-noauth> flag. For more details, see L. + + =item B<-verbose> + + Produces on the standard output stream a detailed trace of the command's + execution. If this argument is omitted, only warnings and error messages + appear. + + =item B<-encrypt> + + Encrypts the command so that the operation's results are not transmitted + across the network in clear text. + + =item B<-help> + + Prints the online help for this command. All other valid options are + ignored. + + =back + + =head1 EXAMPLES + + The following example converts the read-only volume test3.readonly in + partition vicepb on server1 to a read-write volume: + + % vos convertROtoRW server1 b test3.readonly + + =head1 PRIVILEGE REQUIRED + + The issuer must be listed in the F file on the + machines specified with the B<-toserver> and B<-fromserver> arguments and + on each database server machine. If the B<-localauth> flag is included, + the issuer must instead be logged on to a server machine as the local + superuser C. + + =head1 SEE ALSO + + L + + =head1 COPYRIGHT + + Copyright 2007 Jason Edgecombe + + This documentation is covered by the BSD License as written in the + doc/LICENSE file. This man page was written by Jason Edgecombe for + OpenAFS. Index: openafs/doc/man-pages/pod1/vos_copy.pod diff -c /dev/null openafs/doc/man-pages/pod1/vos_copy.pod:1.1.4.4 *** /dev/null Sun Mar 23 21:55:02 2008 --- openafs/doc/man-pages/pod1/vos_copy.pod Sat Jan 19 19:19:45 2008 *************** *** 0 **** --- 1,170 ---- + =head1 NAME + + vos_copy - Make a copy of a volume + + =head1 SYNOPSIS + + =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 +
+ + =head1 DESCRIPTION + + The B command makes a copy of a volume with a new name. It is + equivalent to B followed by B, but doesn't require + the volume be stored locally by the client. + + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + + =head1 OPTIONS + + =over 4 + + =item [B<-id>] > + + Specifies either the complete name or volume ID number of a read/write + volume. + + =item [B<-fromserver>] > + + Identifies the file server machine where the source volume resides. Provide + the machine's IP address or its host name (either fully qualified or using + an unambiguous abbreviation). For details, see L. + + =item [B<-frompartition>] > + + Names the partition where the source volume resides. Provide the full + partition name (for, example, B) or one of the abbreviated forms + described in L. + + =item [B<-toname>] > + + The complete name of the new volume to create. + + =item [B<-toserver>] > + + Identifies the file server machine to which to copy the volume. Provide + the machine's IP address or its host name (either fully qualified or using + an unambiguous abbreviation). For details, see L. + + =item [B<-topartition>] > + + Names the partition to which to copy the volume. Provide the full partition + name (for, example, B) or one of the abbreviated forms described in + L. + + =item B<-offline> + + Leaves the new volume flagged as off-line in the volume database. + + =item B<-readonly> + + Flags the new volume as read-only in the volume database. + + =item B<-live> + + Copies the live volume without cloning. This is normally not necessary and + causes the volume to be kept locked for longer than the normal copy + mechanism. + + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. The B command interpreter presents it to + the Volume Server and Volume Location Server during mutual + authentication. Do not combine this flag with the B<-cell> argument or + B<-noauth> flag. For more details, see L. + + =item B<-verbose> + + Produces on the standard output stream a detailed trace of the command's + execution. If this argument is omitted, only warnings and error messages + appear. + + =item B<-encrypt> + + Encrypts the command so that the operation's results are not transmitted + across the network in clear text. + + =item B<-help> + + Prints the online help for this command. All other valid options are + ignored. + + =back + + =head1 OUTPUT + + This command has no output unless C<-verbose> is specified or there is + an error. + + =head1 EXAMPLES + + The following example makes a verbose copy of the C volume named + C in the cell C. The volume and copy both reside on + C of C. + + % vos copy test server1 a test2 server1 a -cell localcell -verbose + Starting transaction on source volume 536870921 ... done + Allocating new volume id for clone of volume 536870921 ... done + Allocating new volume id for copy of volume 536870921 ... done + Cloning source volume 536870921 ... done + Ending the transaction on the source volume 536870921 ... done + Starting transaction on the cloned volume 536870926 ... done + Setting flags on cloned volume 536870926 ... done + Getting status of cloned volume 536870926 ... done + Creating the destination volume 536870927 ... done + Setting volume flags on destination volume 536870927 ... done + Dumping from clone 536870926 on source to volume 536870927 on destination ... done + Ending transaction on cloned volume 536870926 ... done + Starting transaction on source volume 536870921 ... done + Doing the incremental dump from source to destination for volume 536870921 ... done + Setting volume flags on destination volume 536870927 ... done + Ending transaction on destination volume 536870927 ... done + Ending transaction on source volume 536870921 ... done + Starting transaction on the cloned volume 536870926 ... done + Deleting the cloned volume 536870926 ... done + Ending transaction on cloned volume 536870926 ... done + Created the VLDB entry for the volume test2 536870927 + Volume 536870921 copied from server1 /vicepa to test2 on server1 /vicepa + + =head1 PRIVILEGE REQUIRED + + The issuer must be listed in the F file on the + machine specified with the B<-server> argument and on each database server + machine. If the B<-localauth> flag is included, the issuer must instead be + logged on to a server machine as the local superuser C. + + =head1 SEE ALSO + + L, + L, + L + + =head1 COPYRIGHT + + Copyright 2007 Jason Edgecombe + + This documentation is covered by the BSD License as written in the + doc/LICENSE file. This man page was written by Jason Edgecombe for + OpenAFS. Index: openafs/doc/man-pages/pod1/vos_create.pod diff -c openafs/doc/man-pages/pod1/vos_create.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_create.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/vos_create.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_create.pod Sat Jan 19 19:19:45 2008 *************** *** 1,6 **** =head1 NAME ! vos create - Creates a read/write volume and associated VLDB entry =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_create - Creates a read/write volume and associated VLDB entry =head1 SYNOPSIS *************** *** 60,65 **** --- 60,76 ---- The volume is empty when created. To access it via the Cache Manager, mount it in the file space by using the B command. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/vos_delentry.pod diff -c openafs/doc/man-pages/pod1/vos_delentry.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_delentry.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_delentry.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_delentry.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos delentry - Removes a volume entry from the VLDB. =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_delentry - Removes a volume entry from the VLDB. =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_dump.pod diff -c openafs/doc/man-pages/pod1/vos_dump.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_dump.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_dump.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_dump.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos dump - Converts a volume into ASCII format and writes it to a file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_dump - Converts a volume into ASCII format and writes it to a file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_examine.pod diff -c openafs/doc/man-pages/pod1/vos_examine.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_examine.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/vos_examine.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_examine.pod Tue Feb 19 10:31:08 2008 *************** *** 1,6 **** =head1 NAME ! vos examine - Shows volume header and VLDB entry information for a volume =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_examine - Shows volume header and VLDB entry information for a volume =head1 SYNOPSIS *************** *** 32,37 **** --- 32,48 ---- To display the volume header only, use the B command. To display information from the VLDB only, use the B command. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/vos_help.pod diff -c openafs/doc/man-pages/pod1/vos_help.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_help.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_help.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos help - Displays help for vos commands =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_help - Displays help for vos commands =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_listaddrs.pod diff -c openafs/doc/man-pages/pod1/vos_listaddrs.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_listaddrs.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_listaddrs.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_listaddrs.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos listaddrs - Displays all VLDB server entries =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_listaddrs - Displays all VLDB server entries =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_listpart.pod diff -c openafs/doc/man-pages/pod1/vos_listpart.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_listpart.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_listpart.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_listpart.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos listpart - Displays all AFS partitions on a file server machine =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_listpart - Displays all AFS partitions on a file server machine =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_listvldb.pod diff -c openafs/doc/man-pages/pod1/vos_listvldb.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_listvldb.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_listvldb.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_listvldb.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos listvldb - Displays a volume's VLDB entry =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_listvldb - Displays a volume's VLDB entry =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_listvol.pod diff -c openafs/doc/man-pages/pod1/vos_listvol.pod:1.3.2.6 openafs/doc/man-pages/pod1/vos_listvol.pod:1.3.2.7 *** openafs/doc/man-pages/pod1/vos_listvol.pod:1.3.2.6 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_listvol.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos listvol - Displays information from a volume header =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_listvol - Displays information from a volume header =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_lock.pod diff -c openafs/doc/man-pages/pod1/vos_lock.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_lock.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_lock.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_lock.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos lock - Locks a VLDB volume entry =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_lock - Locks a VLDB volume entry =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_move.pod diff -c openafs/doc/man-pages/pod1/vos_move.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_move.pod:1.3.2.8 *** openafs/doc/man-pages/pod1/vos_move.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_move.pod Sat Jan 19 19:19:45 2008 *************** *** 1,6 **** =head1 NAME ! vos move - Moves a read/write volume to another site =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_move - Moves a read/write volume to another site =head1 SYNOPSIS *************** *** 12,25 **** S<<< B<-frompartition> > >>> S<<< B<-toserver> > >>> S<<< B<-topartition> > >>> ! S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] ! [B<-help>] B S<<< B<-i> > >>> S<<< B<-froms> > >>> S<<< B<-fromp> > >>> S<<< B<-tos> > >>> ! S<<< B<-top> > >>> S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] =for html --- 12,25 ---- S<<< B<-frompartition> > >>> S<<< B<-toserver> > >>> S<<< B<-topartition> > >>> ! [B<-live>] S<<< [B<-cell> >] >>> [B<-noauth>] ! [B<-localauth>] [B<-verbose>] [B<-help>] B S<<< B<-i> > >>> S<<< B<-froms> > >>> S<<< B<-fromp> > >>> S<<< B<-tos> > >>> ! S<<< B<-top> > >>> [B<-li>] S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>] =for html *************** *** 86,91 **** --- 86,100 ---- To confirm termination of the operation, press Ctrl-C a second time; press any other key to continue the operation. + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 *************** *** 120,125 **** --- 129,142 ---- partition name (for, example, B) or one of the abbreviated forms described in L. + =item B<-live> + + Avoids making a temporary copy of the volume during the move. This is + useful if the partition is full, but the administrator needs to move + volumes to a another partition or server to free up disk space. The + caveat is that the volume is locked during the entire operation + instead of the short time that is needed to make the temporary clone. + =item B<-cell> > Names the cell in which to run the command. Do not combine this argument *************** *** 174,179 **** --- 191,197 ---- L, L, L, + L, L, L, L Index: openafs/doc/man-pages/pod1/vos_offline.pod diff -c openafs/doc/man-pages/pod1/vos_offline.pod:1.1.2.2 openafs/doc/man-pages/pod1/vos_offline.pod:1.1.2.3 *** openafs/doc/man-pages/pod1/vos_offline.pod:1.1.2.2 Tue Jun 12 00:00:18 2007 --- openafs/doc/man-pages/pod1/vos_offline.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos offline - Takes a volume offline =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_offline - Takes a volume offline =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_online.pod diff -c openafs/doc/man-pages/pod1/vos_online.pod:1.1.2.2 openafs/doc/man-pages/pod1/vos_online.pod:1.1.2.3 *** openafs/doc/man-pages/pod1/vos_online.pod:1.1.2.2 Tue Jun 12 00:00:18 2007 --- openafs/doc/man-pages/pod1/vos_online.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos online - Brings a volume online =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_online - Brings a volume online =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_partinfo.pod diff -c openafs/doc/man-pages/pod1/vos_partinfo.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_partinfo.pod:1.2.2.6 *** openafs/doc/man-pages/pod1/vos_partinfo.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_partinfo.pod Tue Feb 19 10:31:08 2008 *************** *** 1,6 **** =head1 NAME ! vos partinfo - Reports the available and total space on a partition =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_partinfo - Reports the available and total space on a partition =head1 SYNOPSIS *************** *** 25,30 **** --- 25,41 ---- that file server machine. The Volume Location Database (VLDB) is not consulted. + =head1 CAUTIONS + + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + =head1 OPTIONS =over 4 Index: openafs/doc/man-pages/pod1/vos_release.pod diff -c openafs/doc/man-pages/pod1/vos_release.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_release.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_release.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_release.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos release - Updates read-only volumes to match the read/write source volume =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_release - Updates read-only volumes to match the read/write source volume =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_remove.pod diff -c openafs/doc/man-pages/pod1/vos_remove.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_remove.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_remove.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_remove.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos remove - Removes a volume from a site =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_remove - Removes a volume from a site =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_remsite.pod diff -c openafs/doc/man-pages/pod1/vos_remsite.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_remsite.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_remsite.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_remsite.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos remsite - Removes a read-only site definition from a VLDB entry =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_remsite - Removes a read-only site definition from a VLDB entry =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_rename.pod diff -c openafs/doc/man-pages/pod1/vos_rename.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_rename.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_rename.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_rename.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos rename - Renames a volume =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_rename - Renames a volume =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_restore.pod diff -c openafs/doc/man-pages/pod1/vos_restore.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_restore.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_restore.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_restore.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos restore - Converts an ASCII dump file into an AFS volume =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_restore - Converts an ASCII dump file into an AFS volume =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_size.pod diff -c openafs/doc/man-pages/pod1/vos_size.pod:1.1.2.3 openafs/doc/man-pages/pod1/vos_size.pod:1.1.2.5 *** openafs/doc/man-pages/pod1/vos_size.pod:1.1.2.3 Fri Aug 17 21:48:14 2007 --- openafs/doc/man-pages/pod1/vos_size.pod Tue Dec 25 17:32:11 2007 *************** *** 1,6 **** =head1 NAME ! vos size - Computes the size of a volume dump =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_size - Computes the size of a volume dump =head1 SYNOPSIS *************** *** 143,147 **** 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. --- 143,148 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod1/vos_status.pod diff -c openafs/doc/man-pages/pod1/vos_status.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_status.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_status.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_status.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos status - Reports a Volume Server's status =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_status - Reports a Volume Server's status =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_syncserv.pod diff -c openafs/doc/man-pages/pod1/vos_syncserv.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_syncserv.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_syncserv.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_syncserv.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos syncserv - Verifies VLDB entries that mention a specified site =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_syncserv - Verifies VLDB entries that mention a specified site =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_syncvldb.pod diff -c openafs/doc/man-pages/pod1/vos_syncvldb.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_syncvldb.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_syncvldb.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_syncvldb.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos syncvldb - Verifies VLDB entries for volumes residing at specified site =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_syncvldb - Verifies VLDB entries for volumes residing at specified site =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_unlock.pod diff -c openafs/doc/man-pages/pod1/vos_unlock.pod:1.2.2.4 openafs/doc/man-pages/pod1/vos_unlock.pod:1.2.2.5 *** openafs/doc/man-pages/pod1/vos_unlock.pod:1.2.2.4 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_unlock.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos unlock - Unlocks a single VLDB entry =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_unlock - Unlocks a single VLDB entry =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_unlockvldb.pod diff -c openafs/doc/man-pages/pod1/vos_unlockvldb.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_unlockvldb.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_unlockvldb.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_unlockvldb.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos unlockvldb - Unlocks several locked VLDB entries =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_unlockvldb - Unlocks several locked VLDB entries =head1 SYNOPSIS Index: openafs/doc/man-pages/pod1/vos_zap.pod diff -c openafs/doc/man-pages/pod1/vos_zap.pod:1.3.2.5 openafs/doc/man-pages/pod1/vos_zap.pod:1.3.2.6 *** openafs/doc/man-pages/pod1/vos_zap.pod:1.3.2.5 Wed Mar 1 00:11:21 2006 --- openafs/doc/man-pages/pod1/vos_zap.pod Sun Nov 11 18:52:53 2007 *************** *** 1,6 **** =head1 NAME ! vos zap - Removes a volume from its site without writing to the VLDB =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! vos_zap - Removes a volume from its site without writing to the VLDB =head1 SYNOPSIS Index: openafs/doc/man-pages/pod5/CellAlias.pod diff -c openafs/doc/man-pages/pod5/CellAlias.pod:1.3.2.4 openafs/doc/man-pages/pod5/CellAlias.pod:1.3.2.5 *** openafs/doc/man-pages/pod5/CellAlias.pod:1.3.2.4 Sun Aug 5 19:37:16 2007 --- openafs/doc/man-pages/pod5/CellAlias.pod Tue Dec 25 17:32:11 2007 *************** *** 51,55 **** 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. --- 51,56 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod8/afsd.pod diff -c openafs/doc/man-pages/pod8/afsd.pod:1.5.2.11 openafs/doc/man-pages/pod8/afsd.pod:1.5.2.13 *** openafs/doc/man-pages/pod8/afsd.pod:1.5.2.11 Sun Aug 5 18:12:23 2007 --- openafs/doc/man-pages/pod8/afsd.pod Sun Mar 9 01:10:27 2008 *************** *** 393,404 **** =item B<-afsdb> ! Enable afsdb support. This will use DNS to lookup the AFSDB record and use ! that for the database servers for each cell instead of the values in the ! F file. This has the advantage of only needing to update one ! DNS record to reconfigure the AFS clients for a new database server as ! opposed to touching all of the clients, and also allows one to access a ! cell without preconfiguring its database servers in F. =item B<-backuptree> --- 393,406 ---- =item B<-afsdb> ! Enable afsdb support. This will use DNS to lookup the AFSDB record and ! use that for the database servers for each cell instead of the values ! in the F file. This has the advantage of only needing to ! update one DNS record to reconfigure the AFS clients for a new ! database server as opposed to touching all of the clients, and also ! allows one to access a cell without preconfiguring its database ! servers in F. The format of AFSDB records is defined in ! RFC 1183. =item B<-backuptree> *************** *** 627,633 **** =item B<-rxpck> > ! Set rx_extraPackets to this value. =item B<-settime> --- 629,639 ---- =item B<-rxpck> > ! Set rx_extraPackets to this value. This sets the number of extra Rx ! packet structures that are available to handle Rx connections. This ! value should be increased if the "rxdebug 127.0.0.1 -port 7001 ! -rxstats" command shows no free Rx packets. Increasing this value may ! improve OpenAFS client performance in some circumstances. =item B<-settime> *************** *** 701,706 **** --- 707,714 ---- L, L + RFC 1183 L + =head1 COPYRIGHT IBM Corporation 2000. All Rights Reserved. Index: openafs/doc/man-pages/pod8/backup_adddump.pod diff -c openafs/doc/man-pages/pod8/backup_adddump.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_adddump.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_adddump.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_adddump.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup adddump - Defines a dump level in the dump hierarchy =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_adddump - Defines a dump level in the dump hierarchy =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_addhost.pod diff -c openafs/doc/man-pages/pod8/backup_addhost.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_addhost.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_addhost.pod:1.2.2.4 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_addhost.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup addhost - Adds a Tape Coordinator entry to the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_addhost - Adds a Tape Coordinator entry to the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_addvolentry.pod diff -c openafs/doc/man-pages/pod8/backup_addvolentry.pod:1.4.2.6 openafs/doc/man-pages/pod8/backup_addvolentry.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/backup_addvolentry.pod:1.4.2.6 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_addvolentry.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup addvolentry - Defines a volume entry in a volume set =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_addvolentry - Defines a volume entry in a volume set =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_addvolset.pod diff -c openafs/doc/man-pages/pod8/backup_addvolset.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_addvolset.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_addvolset.pod:1.2.2.4 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_addvolset.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup addvolset - Creates a new (empty) volume set =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_addvolset - Creates a new (empty) volume set =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_apropos.pod diff -c openafs/doc/man-pages/pod8/backup_apropos.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_apropos.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_apropos.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_apropos.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup apropos - Displays each help entry containing a keyword string =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_apropos - Displays each help entry containing a keyword string =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_dbverify.pod diff -c openafs/doc/man-pages/pod8/backup_dbverify.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_dbverify.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_dbverify.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_dbverify.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup dbverify - Checks the integrity of the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_dbverify - Checks the integrity of the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_deldump.pod diff -c openafs/doc/man-pages/pod8/backup_deldump.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_deldump.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_deldump.pod:1.2.2.4 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_deldump.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup deldump - Deletes a dump level from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_deldump - Deletes a dump level from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_deletedump.pod diff -c openafs/doc/man-pages/pod8/backup_deletedump.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_deletedump.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_deletedump.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_deletedump.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup deletedump - Deletes one or more dump records from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_deletedump - Deletes one or more dump records from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_delhost.pod diff -c openafs/doc/man-pages/pod8/backup_delhost.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_delhost.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_delhost.pod:1.2.2.4 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_delhost.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup delhost - Deletes a Tape Coordinator entry from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_delhost - Deletes a Tape Coordinator entry from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_delvolentry.pod diff -c openafs/doc/man-pages/pod8/backup_delvolentry.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_delvolentry.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_delvolentry.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_delvolentry.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup delvolentry - Deletes a volume entry from a volume set =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_delvolentry - Deletes a volume entry from a volume set =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_delvolset.pod diff -c openafs/doc/man-pages/pod8/backup_delvolset.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_delvolset.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_delvolset.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_delvolset.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup delvolset - Deletes one or more volume sets from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_delvolset - Deletes one or more volume sets from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_diskrestore.pod diff -c openafs/doc/man-pages/pod8/backup_diskrestore.pod:1.5.2.7 openafs/doc/man-pages/pod8/backup_diskrestore.pod:1.5.2.8 *** openafs/doc/man-pages/pod8/backup_diskrestore.pod:1.5.2.7 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_diskrestore.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup diskrestore - Restores the entire contents of a partition =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_diskrestore - Restores the entire contents of a partition =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_dump.pod diff -c openafs/doc/man-pages/pod8/backup_dump.pod:1.5.2.7 openafs/doc/man-pages/pod8/backup_dump.pod:1.5.2.8 *** openafs/doc/man-pages/pod8/backup_dump.pod:1.5.2.7 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_dump.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup dump - Creates a dump (dumps a volume set at a particular dump level) =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_dump - Creates a dump (dumps a volume set at a particular dump level) =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_dumpinfo.pod diff -c openafs/doc/man-pages/pod8/backup_dumpinfo.pod:1.4.2.6 openafs/doc/man-pages/pod8/backup_dumpinfo.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/backup_dumpinfo.pod:1.4.2.6 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_dumpinfo.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup dumpinfo - Displays a dump record from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_dumpinfo - Displays a dump record from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_help.pod diff -c openafs/doc/man-pages/pod8/backup_help.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_help.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_help.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup help - Displays help for backup commands =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_help - Displays help for backup commands =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_interactive.pod diff -c openafs/doc/man-pages/pod8/backup_interactive.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_interactive.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_interactive.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_interactive.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup interactive - Enters interactive mode =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_interactive - Enters interactive mode =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_jobs.pod diff -c openafs/doc/man-pages/pod8/backup_jobs.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_jobs.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_jobs.pod:1.2.2.4 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_jobs.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup jobs - Lists pending and running operations in interactive mode =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_jobs - Lists pending and running operations in interactive mode =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_kill.pod diff -c openafs/doc/man-pages/pod8/backup_kill.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_kill.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_kill.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_kill.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup kill - Terminates a pending or running operation =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_kill - Terminates a pending or running operation =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_labeltape.pod diff -c openafs/doc/man-pages/pod8/backup_labeltape.pod:1.3.2.6 openafs/doc/man-pages/pod8/backup_labeltape.pod:1.3.2.7 *** openafs/doc/man-pages/pod8/backup_labeltape.pod:1.3.2.6 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_labeltape.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup labeltape - Creates the magnetic label on a tape =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_labeltape - Creates the magnetic label on a tape =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_listdumps.pod diff -c openafs/doc/man-pages/pod8/backup_listdumps.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_listdumps.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_listdumps.pod:1.3.2.5 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_listdumps.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup listdumps - Displays the dump hierarchy from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_listdumps - Displays the dump hierarchy from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_listhosts.pod diff -c openafs/doc/man-pages/pod8/backup_listhosts.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_listhosts.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_listhosts.pod:1.2.2.4 Wed Mar 1 00:11:22 2006 --- openafs/doc/man-pages/pod8/backup_listhosts.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup listhosts - Lists Tape Coordinators registered in the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_listhosts - Lists Tape Coordinators registered in the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_listvolsets.pod diff -c openafs/doc/man-pages/pod8/backup_listvolsets.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_listvolsets.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_listvolsets.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_listvolsets.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup listvolsets - Lists volume set entries from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_listvolsets - Lists volume set entries from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_quit.pod diff -c openafs/doc/man-pages/pod8/backup_quit.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_quit.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_quit.pod:1.3.2.5 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_quit.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup quit - Leaves interactive mode =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_quit - Leaves interactive mode =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_readlabel.pod diff -c openafs/doc/man-pages/pod8/backup_readlabel.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_readlabel.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_readlabel.pod:1.3.2.5 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_readlabel.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup readlabel - Reads and displays a tape's label =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_readlabel - Reads and displays a tape's label =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_restoredb.pod diff -c openafs/doc/man-pages/pod8/backup_restoredb.pod:1.4.2.6 openafs/doc/man-pages/pod8/backup_restoredb.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/backup_restoredb.pod:1.4.2.6 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_restoredb.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup restoredb - Restores a saved copy of the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_restoredb - Restores a saved copy of the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_savedb.pod diff -c openafs/doc/man-pages/pod8/backup_savedb.pod:1.4.2.6 openafs/doc/man-pages/pod8/backup_savedb.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/backup_savedb.pod:1.4.2.6 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_savedb.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup savedb - Creates a saved copy of the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_savedb - Creates a saved copy of the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_scantape.pod diff -c openafs/doc/man-pages/pod8/backup_scantape.pod:1.4.2.7 openafs/doc/man-pages/pod8/backup_scantape.pod:1.4.2.8 *** openafs/doc/man-pages/pod8/backup_scantape.pod:1.4.2.7 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_scantape.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup scantape - Extracts dump information from a tape =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_scantape - Extracts dump information from a tape =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_setexp.pod diff -c openafs/doc/man-pages/pod8/backup_setexp.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_setexp.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_setexp.pod:1.3.2.5 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_setexp.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup setexp - Sets the expiration date for existing dump levels. =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_setexp - Sets the expiration date for existing dump levels. =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_status.pod diff -c openafs/doc/man-pages/pod8/backup_status.pod:1.2.2.4 openafs/doc/man-pages/pod8/backup_status.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/backup_status.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_status.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup status - Reports a Tape Coordinator's status =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_status - Reports a Tape Coordinator's status =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_volinfo.pod diff -c openafs/doc/man-pages/pod8/backup_volinfo.pod:1.3.2.5 openafs/doc/man-pages/pod8/backup_volinfo.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/backup_volinfo.pod:1.3.2.5 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_volinfo.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup volinfo - Displays a volume's dump history from the Backup Database =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_volinfo - Displays a volume's dump history from the Backup Database =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_volrestore.pod diff -c openafs/doc/man-pages/pod8/backup_volrestore.pod:1.4.2.6 openafs/doc/man-pages/pod8/backup_volrestore.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/backup_volrestore.pod:1.4.2.6 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_volrestore.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup volrestore - Restores one or more volumes =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_volrestore - Restores one or more volumes =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/backup_volsetrestore.pod diff -c openafs/doc/man-pages/pod8/backup_volsetrestore.pod:1.4.2.6 openafs/doc/man-pages/pod8/backup_volsetrestore.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/backup_volsetrestore.pod:1.4.2.6 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/backup_volsetrestore.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! backup volsetrestore - Restores all volumes in a volume set =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! backup_volsetrestore - Restores all volumes in a volume set =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_addhost.pod diff -c openafs/doc/man-pages/pod8/bos_addhost.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_addhost.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_addhost.pod:1.3.2.5 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/bos_addhost.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos addhost - Adds a database server machine to the CellServDB file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_addhost - Adds a database server machine to the CellServDB file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_addkey.pod diff -c openafs/doc/man-pages/pod8/bos_addkey.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_addkey.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_addkey.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/bos_addkey.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos addkey - Adds a new server encryption key to the KeyFile file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_addkey - Adds a new server encryption key to the KeyFile file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_adduser.pod diff -c openafs/doc/man-pages/pod8/bos_adduser.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_adduser.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_adduser.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/bos_adduser.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos adduser - Adds a privileged user to the UserList file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_adduser - Adds a privileged user to the UserList file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_apropos.pod diff -c openafs/doc/man-pages/pod8/bos_apropos.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_apropos.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/bos_apropos.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos apropos - Displays each help entry containing a keyword string =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_apropos - Displays each help entry containing a keyword string =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_create.pod diff -c openafs/doc/man-pages/pod8/bos_create.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_create.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_create.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/bos_create.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos create - Defines a new process in the BosConfig file and starts it =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_create - Defines a new process in the BosConfig file and starts it =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_delete.pod diff -c openafs/doc/man-pages/pod8/bos_delete.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_delete.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_delete.pod:1.2.2.4 Wed Mar 1 00:11:23 2006 --- openafs/doc/man-pages/pod8/bos_delete.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos delete - Deletes a server process from the BosConfig file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_delete - Deletes a server process from the BosConfig file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_exec.pod diff -c openafs/doc/man-pages/pod8/bos_exec.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_exec.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_exec.pod:1.2.2.4 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_exec.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos exec - Executes a command on a remote server machine =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_exec - Executes a command on a remote server machine =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_getdate.pod diff -c openafs/doc/man-pages/pod8/bos_getdate.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_getdate.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_getdate.pod:1.2.2.4 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_getdate.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos getdate - Displays the time stamps on an AFS binary file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_getdate - Displays the time stamps on an AFS binary file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_getlog.pod diff -c openafs/doc/man-pages/pod8/bos_getlog.pod:1.4.2.6 openafs/doc/man-pages/pod8/bos_getlog.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/bos_getlog.pod:1.4.2.6 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_getlog.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos getlog - Prints a server process's log file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_getlog - Prints a server process's log file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_getrestart.pod diff -c openafs/doc/man-pages/pod8/bos_getrestart.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_getrestart.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_getrestart.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_getrestart.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos getrestart - Displays the automatic restart times for server processes =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_getrestart - Displays the automatic restart times for server processes =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_help.pod diff -c openafs/doc/man-pages/pod8/bos_help.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_help.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_help.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos help - Displays help for bos commands =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_help - Displays help for bos commands =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_install.pod diff -c openafs/doc/man-pages/pod8/bos_install.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_install.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_install.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_install.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos install - Installs a new version of a binary file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_install - Installs a new version of a binary file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_listhosts.pod diff -c openafs/doc/man-pages/pod8/bos_listhosts.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_listhosts.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_listhosts.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_listhosts.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos listhosts - Displays the contents of the CellServDB file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_listhosts - Displays the contents of the CellServDB file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_listkeys.pod diff -c openafs/doc/man-pages/pod8/bos_listkeys.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_listkeys.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_listkeys.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_listkeys.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos listkeys - Displays the server encryption keys from the KeyFile file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_listkeys - Displays the server encryption keys from the KeyFile file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_listusers.pod diff -c openafs/doc/man-pages/pod8/bos_listusers.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_listusers.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_listusers.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_listusers.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos listusers - Lists the privileged users from the UserList file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_listusers - Lists the privileged users from the UserList file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_prune.pod diff -c openafs/doc/man-pages/pod8/bos_prune.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_prune.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_prune.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_prune.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos prune - Removes obsolete files from /usr/afs/bin and /usr/afs/logs =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_prune - Removes obsolete files from /usr/afs/bin and /usr/afs/logs =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_removehost.pod diff -c openafs/doc/man-pages/pod8/bos_removehost.pod:1.4.2.6 openafs/doc/man-pages/pod8/bos_removehost.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/bos_removehost.pod:1.4.2.6 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_removehost.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos removehost - Removes a database server machine from the CellServDB file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_removehost - Removes a database server machine from the CellServDB file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_removekey.pod diff -c openafs/doc/man-pages/pod8/bos_removekey.pod:1.4.2.6 openafs/doc/man-pages/pod8/bos_removekey.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/bos_removekey.pod:1.4.2.6 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_removekey.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos removekey - Removes a server encryption key from the KeyFile file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_removekey - Removes a server encryption key from the KeyFile file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_removeuser.pod diff -c openafs/doc/man-pages/pod8/bos_removeuser.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_removeuser.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_removeuser.pod:1.3.2.5 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_removeuser.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos removeuser - Removes a privileged user from the UserList file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_removeuser - Removes a privileged user from the UserList file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_restart.pod diff -c openafs/doc/man-pages/pod8/bos_restart.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_restart.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_restart.pod:1.2.2.4 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_restart.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos restart - Restarts a server process =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_restart - Restarts a server process =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_salvage.pod diff -c openafs/doc/man-pages/pod8/bos_salvage.pod:1.4.2.6 openafs/doc/man-pages/pod8/bos_salvage.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/bos_salvage.pod:1.4.2.6 Wed Mar 1 00:11:24 2006 --- openafs/doc/man-pages/pod8/bos_salvage.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos salvage - Restores internal consistency to a file system or volume =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_salvage - Restores internal consistency to a file system or volume =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_setauth.pod diff -c openafs/doc/man-pages/pod8/bos_setauth.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_setauth.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_setauth.pod:1.3.2.5 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_setauth.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos setauth - Sets authorization checking requirements for all server processes =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_setauth - Sets authorization checking requirements for all server processes =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_setcellname.pod diff -c openafs/doc/man-pages/pod8/bos_setcellname.pod:1.4.2.6 openafs/doc/man-pages/pod8/bos_setcellname.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/bos_setcellname.pod:1.4.2.6 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_setcellname.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos setcellname - Sets the cell's name in ThisCell and CellServDB =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_setcellname - Sets the cell's name in ThisCell and CellServDB =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_setrestart.pod diff -c openafs/doc/man-pages/pod8/bos_setrestart.pod:1.4.2.6 openafs/doc/man-pages/pod8/bos_setrestart.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/bos_setrestart.pod:1.4.2.6 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_setrestart.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos setrestart - Sets when the BOS Server restarts processes =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_setrestart - Sets when the BOS Server restarts processes =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_shutdown.pod diff -c openafs/doc/man-pages/pod8/bos_shutdown.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_shutdown.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_shutdown.pod:1.2.2.4 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_shutdown.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos shutdown - Stops a process without changing its status flag =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_shutdown - Stops a process without changing its status flag =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_start.pod diff -c openafs/doc/man-pages/pod8/bos_start.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_start.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_start.pod:1.3.2.5 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_start.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos start - Starts a process after setting its status flag =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_start - Starts a process after setting its status flag =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_startup.pod diff -c openafs/doc/man-pages/pod8/bos_startup.pod:1.3.2.5 openafs/doc/man-pages/pod8/bos_startup.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/bos_startup.pod:1.3.2.5 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_startup.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos startup - Starts a process without changing its status flag =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_startup - Starts a process without changing its status flag =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_status.pod diff -c openafs/doc/man-pages/pod8/bos_status.pod:1.3.2.6 openafs/doc/man-pages/pod8/bos_status.pod:1.3.2.7 *** openafs/doc/man-pages/pod8/bos_status.pod:1.3.2.6 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_status.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos status - Displays the status of server processes =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_status - Displays the status of server processes =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_stop.pod diff -c openafs/doc/man-pages/pod8/bos_stop.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_stop.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_stop.pod:1.2.2.4 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_stop.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos stop - Stops a process after changing its status flag =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_stop - Stops a process after changing its status flag =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_uninstall.pod diff -c openafs/doc/man-pages/pod8/bos_uninstall.pod:1.2.2.4 openafs/doc/man-pages/pod8/bos_uninstall.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/bos_uninstall.pod:1.2.2.4 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bos_uninstall.pod Sun Nov 11 18:52:55 2007 *************** *** 1,6 **** =head1 NAME ! bos uninstall - Reverts to the former version of a process's binary file =head1 SYNOPSIS --- 1,6 ---- =head1 NAME ! bos_uninstall - Reverts to the former version of a process's binary file =head1 SYNOPSIS Index: openafs/doc/man-pages/pod8/bos_util.pod diff -c openafs/doc/man-pages/pod8/bos_util.pod:1.1.4.2 openafs/doc/man-pages/pod8/bos_util.pod:1.1.4.3 *** openafs/doc/man-pages/pod8/bos_util.pod:1.1.4.2 Fri Aug 17 21:53:10 2007 --- openafs/doc/man-pages/pod8/bos_util.pod Tue Dec 25 17:32:13 2007 *************** *** 114,118 **** 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. --- 114,119 ---- Copyright 2007 Jason Edgecombe ! This documentation is covered by the BSD License as written in the ! doc/LICENSE file. This man page was written by Jason Edgecombe for ! OpenAFS. Index: openafs/doc/man-pages/pod8/bosserver.pod diff -c openafs/doc/man-pages/pod8/bosserver.pod:1.2.2.4 openafs/doc/man-pages/pod8/bosserver.pod:1.2.2.8 *** openafs/doc/man-pages/pod8/bosserver.pod:1.2.2.4 Wed Mar 1 00:11:25 2006 --- openafs/doc/man-pages/pod8/bosserver.pod Mon Feb 4 14:42:16 2008 *************** *** 8,14 ****
B [B<-noauth>] [B<-log>] [B<-enable_peer_stats>] ! [B<-enable_process_stats>] [B<-help>] =for html
--- 8,14 ----
B [B<-noauth>] [B<-log>] [B<-enable_peer_stats>] ! [B<-enable_process_stats>] [B<-allow-dotted-principal>] [B<-help>] =for html
*************** *** 108,113 **** --- 108,122 ---- other machines. To display or otherwise access the records, use the Rx Monitoring API. + =item B<-allow-dotted-principal> + + By default, the RXKAD security layer will disallow access by Kerberos + principals with a dot in the first component of their name. This is to avoid + the confusion where principals user/admin and user.admin are both mapped to the + user.admin PTS entry. Sites whose Kerberos realms don't have these collisions + between principal names may disable this check by starting the server + with this option. + =item B<-help> Prints the online help for this command. All other valid options are Index: openafs/doc/man-pages/pod8/fileserver.pod diff -c openafs/doc/man-pages/pod8/fileserver.pod:1.4.2.7 openafs/doc/man-pages/pod8/fileserver.pod:1.4.2.15 *** openafs/doc/man-pages/pod8/fileserver.pod:1.4.2.7 Mon Jun 11 23:55:39 2007 --- openafs/doc/man-pages/pod8/fileserver.pod Mon Feb 4 14:42:16 2008 *************** *** 7,25 **** =for html
! B S<<< [B<-auditlog> >] >>> S<<< [B<-d> >] >>> S<<< [B<-p> >] >>> S<<< [B<-spare> >] >>> S<<< [B<-pctspare> >] >>> S<<< [B<-b> >] >>> ! S<<< [B<-l> >] >>> S<<< [B<-s> >] >>> S<<< [B<-vc> >] >>> S<<< [B<-w> >] >>> 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> >] >>> S<<< [B<-vattachpar> >] >>> S<<< [B<-m> >] >>> --- 7,26 ---- =for html
! B S<<< [B<-auditlog> >] >>> S<<< [B<-d> >] >>> S<<< [B<-p> >] >>> S<<< [B<-spare> >] >>> S<<< [B<-pctspare> >] >>> S<<< [B<-b> >] >>> ! S<<< [B<-l> >] >>> S<<< [B<-s> >] >>> S<<< [B<-vc> >] >>> S<<< [B<-w> >] >>> 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> >] >>> + [B<-allow-dotted-principal>] S<<< [B<-rxbind> >] >>> S<<< [B<-vattachpar> >] >>> S<<< [B<-m> >] >>> *************** *** 28,34 **** S<<< [B<-udpsize> >] >>> S<<< [B<-sendsize> >] >>> S<<< [B<-abortthreshold> >] >>> - S<<< [B<-auditlog> >] >>> [B<-enable_peer_stats>] [B<-enable_process_stats>] [B<-help>] =for html --- 29,34 ---- *************** *** 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 --- 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 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 * --- 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 of memory for these processes. =item * *************** *** 168,173 **** --- 168,183 ---- 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 --- 188,199 ---- =head1 CAUTIONS ! Do not use the B<-k> and B<-w> arguments, which are intended for use ! by the OpenAFS developers 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 *************** *** 193,198 **** --- 203,229 ---- and B<-lock> options, appear in the output generated by the B<-help> option only on the relevant system type. + Currently, the maximum size of a volume is 2 terabytes (2^31 bytes) + and the maximum size of a /vicepX partition on a fileserver is also 2 + terabytes. The fileserver will not report an error when it has access + to a partition larger than 2 terabytes, but it will probably fail if + the administrator attempts to use more than 2 terabytes of space. In + addition, there are reports of erroneous disk usage numbers when + B or other OpenAFS disk reporting tools are used with + partitions larger than 2 terabytes. + + The maximum number of directory entries is 64,000 if all of the + entries have names that are 15 characters or less in length. A name + that is 15 characters long requires the use of only one block in the + directory. Additional sequential blocks are required to store entries + with names that are longer than 15 characters. Each additional block + provides an additional length of 32 characters for the name of the + entry. + + In real world use, the maximum number of objects in an AFS directory + is usually between 16,000 and 25,000, depending on the average name + length. + =head1 OPTIONS =over 4 *************** *** 321,326 **** --- 352,366 ---- Writes a trace of the File Server's operations on Rx events (such as retransmissions) to the file F. + =item B<-allow-dotted-principal> + + By default, the RXKAD security layer will disallow access by Kerberos + principals with a dot in the first component of their name. This is to avoid + the confusion where principals user/admin and user.admin are both mapped to the + user.admin PTS entry. Sites whose Kerberos realms don't have these collisions + between principal names may disabled this check by starting the server + with this option. + =item F<-m> > Specifies the percentage of each AFS server partition that the AIX version *************** *** 380,385 **** --- 420,443 ---- other machines. To display or otherwise access the records, use the Rx Monitoring API. + =item B<-abortthreshold> > + + Sets the abort threshold, which is triggered when an AFS client sends + a number of FetchStatus requests in a row and all of them fail due to + access control or some other error. When the abort threshold is + reached, the file server starts to slow down the responses to the + problem client in order to reduce the load on the file server. + + The throttling behaviour can cause issues especially for some versions + of the Windows OpenAFS client. When using Windows Explorer to navigate + the AFS directory tree, directories with only "look" access for the + current user may load more slowly because of the throttling. This is + because the Windows OpenAFS client sends FetchStatus calls one at a + time instead of in bulk like the Unix Open AFS client. + + Setting the threshold to 0 disables the throttling behavior. This + option is available in OpenAFS versions 1.4.1 and later. + =item B<-help> Prints the online help for this command. All other valid options are *************** *** 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. --- 456,615 ---- -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 + -d 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 --- 621,628 ---- 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.2.2.4 openafs/doc/man-pages/pod8/fstrace_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/fstrace_apropos.pod:1.2.2.4 Wed Mar 1 00:11:27 2006 --- openafs/doc/man-pages/pod8/fstrace_apropos.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/fstrace_clear.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/fstrace_clear.pod:1.3.2.5 Wed Mar 1 00:11:27 2006 --- openafs/doc/man-pages/pod8/fstrace_clear.pod Sun Nov 11 18:52:55 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.4.2.7 openafs/doc/man-pages/pod8/fstrace_dump.pod:1.4.2.8 *** openafs/doc/man-pages/pod8/fstrace_dump.pod:1.4.2.7 Wed Mar 1 00:11:27 2006 --- openafs/doc/man-pages/pod8/fstrace_dump.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/fstrace_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/fstrace_help.pod:1.3.2.5 Wed Mar 1 00:11:27 2006 --- openafs/doc/man-pages/pod8/fstrace_help.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/fstrace_lslog.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/fstrace_lslog.pod:1.3.2.5 Wed Mar 1 00:11:27 2006 --- openafs/doc/man-pages/pod8/fstrace_lslog.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/fstrace_lsset.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/fstrace_lsset.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/fstrace_lsset.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/fstrace_setlog.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/fstrace_setlog.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/fstrace_setlog.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/fstrace_setset.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/fstrace_setset.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/fstrace_setset.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/kas_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/kas_apropos.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_apropos.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_create.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_create.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_create.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_delete.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_delete.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_delete.pod Sun Nov 11 18:52:55 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.4.2.6 openafs/doc/man-pages/pod8/kas_examine.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/kas_examine.pod:1.4.2.6 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_examine.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/kas_forgetticket.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/kas_forgetticket.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_forgetticket.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_help.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_help.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_interactive.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_interactive.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_interactive.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_list.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_list.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_list.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/kas_listtickets.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/kas_listtickets.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_listtickets.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/kas_noauthentication.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/kas_noauthentication.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_noauthentication.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/kas_quit.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/kas_quit.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_quit.pod Sun Nov 11 18:52:55 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.4.2.6 openafs/doc/man-pages/pod8/kas_setfields.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/kas_setfields.pod:1.4.2.6 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_setfields.pod Sun Nov 11 18:52:55 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.3.2.6 openafs/doc/man-pages/pod8/kas_setpassword.pod:1.3.2.7 *** openafs/doc/man-pages/pod8/kas_setpassword.pod:1.3.2.6 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_setpassword.pod Sun Nov 11 18:52:55 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.4.2.6 openafs/doc/man-pages/pod8/kas_statistics.pod:1.4.2.7 *** openafs/doc/man-pages/pod8/kas_statistics.pod:1.4.2.6 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_statistics.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_stringtokey.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_stringtokey.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_stringtokey.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/kas_unlock.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/kas_unlock.pod:1.3.2.5 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/kas_unlock.pod Sun Nov 11 18:52:55 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/ptserver.pod diff -c openafs/doc/man-pages/pod8/ptserver.pod:1.2.2.4 openafs/doc/man-pages/pod8/ptserver.pod:1.2.2.8 *** openafs/doc/man-pages/pod8/ptserver.pod:1.2.2.4 Wed Mar 1 00:11:28 2006 --- openafs/doc/man-pages/pod8/ptserver.pod Mon Feb 4 14:42:16 2008 *************** *** 9,15 **** B S<<< [B<-database> >] >>> S<<< [B<-p> >] >>> [B<-rebuildDB>] [B<-enable_peer_stats>] [B<-enable_process_stats>] ! [B<-help>] =for html
--- 9,15 ---- B S<<< [B<-database> >] >>> S<<< [B<-p> >] >>> [B<-rebuildDB>] [B<-enable_peer_stats>] [B<-enable_process_stats>] ! [B<-allow-dotted-principal>] [B<-help>] =for html
*************** *** 90,95 **** --- 90,104 ---- other machines. To display or otherwise access the records, use the Rx Monitoring API. + =item B<-allow-dotted-principal> + + By default, the RXKAD security layer will disallow access by Kerberos + principals with a dot in the first component of their name. This is to avoid + the confusion where principals user/admin and user.admin are both mapped to the + user.admin PTS entry. Sites whose Kerberos realms don't have these collisions + between principal names may disabled this check by starting the server + with this option. + =item B<-help> Prints the online help for this command. All other valid options are Index: openafs/doc/man-pages/pod8/read_tape.pod diff -c /dev/null openafs/doc/man-pages/pod8/read_tape.pod:1.1.4.3 *** /dev/null Sun Mar 23 21:55:03 2008 --- openafs/doc/man-pages/pod8/read_tape.pod Tue Dec 25 17:32:13 2007 *************** *** 0 **** --- 1,108 ---- + + =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 BSD License as written in the + doc/LICENSE file. 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.3.2.5 openafs/doc/man-pages/pod8/uss_add.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/uss_add.pod:1.3.2.5 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/uss_add.pod Sun Nov 11 18:52:55 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.2.2.4 openafs/doc/man-pages/pod8/uss_apropos.pod:1.2.2.5 *** openafs/doc/man-pages/pod8/uss_apropos.pod:1.2.2.4 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/uss_apropos.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/uss_bulk.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/uss_bulk.pod:1.3.2.5 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/uss_bulk.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/uss_delete.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/uss_delete.pod:1.3.2.5 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/uss_delete.pod Sun Nov 11 18:52:55 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.3.2.5 openafs/doc/man-pages/pod8/uss_help.pod:1.3.2.6 *** openafs/doc/man-pages/pod8/uss_help.pod:1.3.2.5 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/uss_help.pod Sun Nov 11 18:52:55 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/man-pages/pod8/vlserver.pod diff -c openafs/doc/man-pages/pod8/vlserver.pod:1.2.2.4 openafs/doc/man-pages/pod8/vlserver.pod:1.2.2.8 *** openafs/doc/man-pages/pod8/vlserver.pod:1.2.2.4 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/vlserver.pod Mon Feb 4 14:42:16 2008 *************** *** 8,14 ****
B S<<< [B<-p> >] >>> [B<-nojumbo>] ! [B<-enable_peer_stats>] [B<-enable_process_stats>] [B<-help>] =for html
--- 8,15 ----
B S<<< [B<-p> >] >>> [B<-nojumbo>] ! [B<-allow-dotted-principal>] [B<-enable_peer_stats>] [B<-enable_process_stats>] ! [B<-help>] =for html
*************** *** 83,88 **** --- 84,98 ---- other machines. To display or otherwise access the records, use the Rx Monitoring API. + =item B<-allow-dotted-principal> + + By default, the RXKAD security layer will disallow access by Kerberos + principals with a dot in the first component of their name. This is to avoid + the confusion where principals user/admin and user.admin are both mapped to the + user.admin PTS entry. Sites whose Kerberos realms don't have these collisions + between principal names may disabled this check by starting the server + with this option. + =item B<-help> Prints the online help for this command. All other valid options are Index: openafs/doc/man-pages/pod8/volserver.pod diff -c openafs/doc/man-pages/pod8/volserver.pod:1.3.2.5 openafs/doc/man-pages/pod8/volserver.pod:1.3.2.9 *** openafs/doc/man-pages/pod8/volserver.pod:1.3.2.5 Wed Mar 1 00:11:29 2006 --- openafs/doc/man-pages/pod8/volserver.pod Mon Feb 4 14:42:16 2008 *************** *** 9,15 **** B [B<-log>] S<<< [B<-p> >] >>> S<<< [B<-udpsize> >] >>> ! [B<-enable_peer_stats>] [B<-enable_process_stats>] [B<-help>] =for html --- 9,16 ---- B [B<-log>] S<<< [B<-p> >] >>> S<<< [B<-udpsize> >] >>> ! [B<-enable_peer_stats>] [B<-enable_process_stats>] ! [B<-allow-dotted-principal>] [B<-help>] =for html *************** *** 77,82 **** --- 78,92 ---- other machines. To display or otherwise access the records, use the Rx Monitoring API. + =item B<-allow-dotted-principal> + + By default, the RXKAD security layer will disallow access by Kerberos + principals with a dot in the first component of their name. This is to avoid + the confusion where principals user/admin and user.admin are both mapped to the + user.admin PTS entry. Sites whose Kerberos realms don't have these collisions + between principal names may disabled this check by starting the server + with this option. + =item B<-help> Prints the online help for this command. All other valid options are