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/w