Remove references to IBM AFS
authorRuss Allbery <rra@stanford.edu>
Wed, 26 May 2010 17:20:57 +0000 (12:20 -0500)
committerDerrick Brashear <shadow@dementia.org>
Wed, 26 May 2010 19:05:45 +0000 (12:05 -0700)
Change references to the documentation sets that we still ship to
reference the OpenAFS manuals instead of the IBM AFS manuals.  Remove
references to the IBM AFS/DFS Migration documentation, since that
doesn't appear to be available anywhere any more, replacing them where
relevant to more generic references to the DFS documentation.  Add
links to docs.openafs.org for mentions of the manuals in SEE ALSO, and
standardize on one link format.  Replace a few references to the IBM
AFS Release Notes with the actual information in those notes, or drop
the reference if it doesn't seem particularly useful.

Change-Id: Ie9666842f1315891c6a9c37c0424200f4b78bff7
Reviewed-on: http://gerrit.openafs.org/2031
Reviewed-by: Derrick Brashear <shadow@dementia.org>
Tested-by: Derrick Brashear <shadow@dementia.org>

43 files changed:
doc/man-pages/README
doc/man-pages/pod1/afs.pod
doc/man-pages/pod1/afsmonitor.pod
doc/man-pages/pod1/fs_copyacl.pod
doc/man-pages/pod1/fs_listacl.pod
doc/man-pages/pod1/fs_mkmount.pod
doc/man-pages/pod1/fs_newcell.pod
doc/man-pages/pod1/fs_setacl.pod
doc/man-pages/pod1/fs_setserverprefs.pod
doc/man-pages/pod1/fs_sysname.pod
doc/man-pages/pod1/livesys.pod
doc/man-pages/pod1/pts.pod
doc/man-pages/pod1/pts_rename.pod
doc/man-pages/pod1/scout.pod
doc/man-pages/pod1/sys.pod
doc/man-pages/pod1/vos_addsite.pod
doc/man-pages/pod5/AuthLog.dir.pod
doc/man-pages/pod5/KeyFile.pod
doc/man-pages/pod5/NoAuth.pod
doc/man-pages/pod5/ThisCell.pod
doc/man-pages/pod5/afsmonitor.pod
doc/man-pages/pod5/sysid.pod
doc/man-pages/pod5/tapeconfig.pod
doc/man-pages/pod5/uss.pod
doc/man-pages/pod8/backup.pod
doc/man-pages/pod8/backup_addvolentry.pod
doc/man-pages/pod8/backup_dbverify.pod
doc/man-pages/pod8/backup_diskrestore.pod
doc/man-pages/pod8/backup_dump.pod
doc/man-pages/pod8/backup_restoredb.pod
doc/man-pages/pod8/backup_volrestore.pod
doc/man-pages/pod8/backup_volsetrestore.pod
doc/man-pages/pod8/bos_addhost.pod
doc/man-pages/pod8/bos_removehost.pod
doc/man-pages/pod8/bos_salvage.pod
doc/man-pages/pod8/bos_setcellname.pod
doc/man-pages/pod8/butc.pod
doc/man-pages/pod8/fms.pod
doc/man-pages/pod8/fstrace.pod
doc/man-pages/pod8/kas_examine.pod
doc/man-pages/pod8/kas_setpassword.pod
doc/man-pages/pod8/kdb.pod
doc/man-pages/pod8/uss_add.pod

index fb1f017..dbf7675 100644 (file)
@@ -230,16 +230,9 @@ Known Problems
   don't just report the deficiency again, but any contributions towards
   fixing it are greatly appreciated.
 
-   * All of the manual references refer to the "IBM" manual.  We should
-     decide how to handle this terminology-wise.
-
    * The salvager actually creates a bunch of SalvageLog files and then
      combines them, but the SalvageLog man page doesn't reflect this.
 
-   * The references to the other OpenAFS manuals, such as the Quick Start
-     guide and the Admin Guide, should be links, probably to the documents
-     on openafs.org.
-
    * There's no mention of the Kerberos v5 support.  At least, we need
      some disclaimers under klog and friends talking about sites without
      kaserver (and possibly without fakeka), and deprecation warnings
index 764366f..c991c78 100644 (file)
@@ -73,7 +73,7 @@ I<operation_code> portion of the command name.
 The I<operation_code> tells the command interpreter and server process
 which action to perform. Most command suites include several operation
 codes. The man pages for each command name describe each operation code in
-detail, and the I<IBM AFS Administration Guide> describes how to use them
+detail, and the I<OpenAFS Administration Guide> describes how to use them
 in the context of performing administrative tasks.
 
 Several AFS commands do not belong to a suite and so their names do not
index 63d02e2..23d9ed1 100644 (file)
@@ -36,7 +36,7 @@ local and foreign cells.
 
 There are 271 available File Server statistics and 571 available Cache
 Manager statistics, listed in the appendix about B<afsmonitor> statistics
-in the I<IBM AFS Administration Guide>. By default, the command displays
+in the I<OpenAFS Administration Guide>. By default, the command displays
 all of the relevant statistics for the file server machines named by the
 B<-fshosts> argument and the client machines named by the B<-cmhosts>
 argument. To limit the display to only the statistics of interest, list
@@ -115,7 +115,7 @@ interpreted relative to the current working directory. Provide this
 argument if not providing the B<-fshosts> argument, B<-cmhosts> argument,
 or neither. For instructions on creating this file, see the preceding
 B<DESCRIPTION> section, and the section on the B<afsmonitor> program in
-the I<IBM AFS Administration Guide>.
+the I<OpenAFS Administration Guide>.
 
 =item B<-frequency> <I<poll frequency>>
 
@@ -131,7 +131,7 @@ frequency plus the time required for all hosts to respond.
 
 Names the file to which the afsmonitor program writes all of the
 statistics that it collects. By default, no output file is created. See
-the section on the B<afsmonitor> command in the I<IBM AFS Administration
+the section on the B<afsmonitor> command in the I<OpenAFS Administration
 Guide> for information on this file.
 
 =item B<-detailed>
@@ -398,7 +398,7 @@ the B<-detail> flag formats the data in a more easily readable form.
 =head1 EXAMPLES
 
 For examples of commands, display screens, and configuration files, see
-the section about the B<afsmonitor> program in the I<IBM AFS
+the section about the B<afsmonitor> program in the I<OpenAFS
 Administration Guide>.
 
 =head1 PRIVILEGE REQUIRED
@@ -411,6 +411,9 @@ L<afsmonitor(5)>
 L<fstrace(8)>,
 L<scout(1)>
 
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
+
 =head1 COPYRIGHT
 
 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
index 6228ec2..bacf54e 100644 (file)
@@ -50,9 +50,7 @@ the source ACL completely replaces the destination ACL.
 When using this command to copy ACLs between objects in DFS filespace
 accessed via the AFS/DFS Migration Toolkit Protocol Translator, it is
 possible to specify files, as well as directories, with the B<-fromdir>
-and B<-todir> arguments. For more information on copying ACLs between DFS
-directories and files, refer to the I<IBM AFS/DFS Migration Toolkit
-Administration Guide and Reference>.
+and B<-todir> arguments.
 
 =head1 CAUTIONS
 
@@ -165,8 +163,6 @@ L<fs_listacl(1)>,
 L<fs_mkmount(1)>,
 L<fs_setacl(1)>
 
-I<IBM AFS/DFS Migration Toolkit Administration Guide and Reference>
-
 =head1 COPYRIGHT
 
 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
index b1d040f..8046f31 100644 (file)
@@ -150,8 +150,7 @@ permission, DFS C<c> (control) replaces AFS C<a> (administer), and there
 is no DFS equivalent to the AFS C<k> (lock) permission. The meanings of
 the various permissions also differ slightly, and DFS does not implement
 negative permissions. For a complete description of DFS permissions, see
-the DFS documentation and the I<IBM AFS/DFS Migration Toolkit
-Administration Guide and Reference>.
+the DFS documentation.
 
 =head1 EXAMPLES
 
@@ -202,8 +201,6 @@ L<fs_cleanacl(1)>,
 L<fs_copyacl(1)>,
 L<fs_setacl(1)>
 
-I<IBM AFS/DFS Migration Toolkit Administration Guide and Reference>
-
 =head1 COPYRIGHT
 
 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
index fd74d9b..8e747c8 100644 (file)
@@ -110,8 +110,8 @@ To create a read/write mount point, include the B<-rw> flag on the B<fs
 mkmount> command. It is conventional to create only one read/write mount
 point in a cell's filespace, using it to mount the cell's C<root.cell>
 volume just below the AFS filespace root (by convention,
-F</afs/.I<cellname>>). See the I<IBM AFS Quick Beginnings> for
-instructions and the chapter about volume management in the I<IBM AFS
+F</afs/.I<cellname>>). See the I<OpenAFS Quick Start Guide> for
+instructions and the chapter about volume management in the I<OpenAFS
 Administration Guide> for further discussion.
 
 Creating a read/write mount point for a read-only or backup volume is
index 3c56f56..44d2ecf 100644 (file)
@@ -41,10 +41,7 @@ the F<CellServDB> file and reboot the machine.
 If the B<-name> argument names a DCE cell, then the B<-servers> argument
 names DFS Fileset Location (FL) Server machines. The B<-linkedcell>
 argument specifies the name of the AFS cell to link to a DCE cell for the
-purpose of DFS fileset location.  Refer to the I<IBM AFS/DFS Migration
-Toolkit Administration Guide and Reference> for more information on
-linking AFS clients to DCE cells using this command or by editing the
-F</usr/vice/etc/CellServDB> file.
+purpose of DFS fileset location.
 
 =head1 CAUTIONS
 
@@ -105,11 +102,6 @@ The issuer must be logged in as the local superuser root.
 L<CellServDB(5)>,
 L<fs_listcells(1)>
 
-I<IBM AFS/DFS Migration Toolkit Administration Guide and Reference>
-
-I<IBM AFS/DFS Migration Toolkit Administration Installation and
-Configuration Guide>
-
 =head1 COPYRIGHT
 
 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
index fa0562e..17e8574 100644 (file)
@@ -28,8 +28,7 @@ the B<-dir> argument.
 If the B<-dir> argument designates a pathname in DFS filespace (accessed
 via the AFS/DFS Migration Toolkit Protocol Translator), it can be a file
 as well as a directory. The ACL must already include an entry for
-C<mask_obj>, however. For more details, refer to the I<IBM AFS/DFS
-Migration Toolkit Administration Guide and Reference>.
+C<mask_obj>, however.
 
 Only user and group entries are acceptable values for the B<-acl>
 argument. Do not place machine entries (IP addresses) directly on an ACL;
@@ -169,8 +168,8 @@ It is acceptable to mix entries that combine the individual letters with
 entries that use the shorthand words, but not use both types of notation
 within an individual pairing of user or group and permissions.
 
-To learn the proper format and acceptable values for DFS ACL entries, see
-the I<IBM AFS/DFS Migration Toolkit Administration Guide and Reference>.
+If setting ACLs on a pathname in DFS filespace, see the DFS documentation
+for the proper format and acceptable values for DFS ACL entries.
 
 =item B<-clear>
 
@@ -280,8 +279,6 @@ L<fs_copyacl(1)>,
 L<fs_listacl(1)>,
 L<fs_mkmount(1)>
 
-I<IBM AFS/DFS Migration Toolkit Administration Guide and Reference>
-
 =head1 COPYRIGHT
 
 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
index 299f840..4b06e2b 100644 (file)
@@ -44,10 +44,9 @@ defaults.
 The Cache Manager stores a preference rank in kernel memory as a paired IP
 address and numerical rank. If a file server machine is multihomed, the
 Cache Manager assigns a distinct rank to each of the machine's addresses
-(up to the number of addresses that the VLDB can store per machine, which
-is specified in the I<IBM AFS Release Notes>). Once calculated, a rank
-persists until the machine reboots, or until this command is used to
-change it.
+(up to the number of addresses that the VLDB can store per machine). Once
+calculated, a rank persists until the machine reboots, or until this
+command is used to change it.
 
 The Cache Manager sets default VL Server preference ranks as it
 initializes, randomly assigning a rank from the range 10,000 to 10,126 to
index b3026a6..47792cd 100644 (file)
@@ -105,11 +105,11 @@ as the local superuser C<root>.
 L<fs_exportafs(1)>,
 L<sys(1)>
 
-I<OpenAFS Quick Beginnings>
-L<http://www.openafs.org/pages/doc/QuickStartUnix/auqbg000.htm>
+The I<OpenAFS Quick Start Guide> at
+L<http://docs.openafs.org/QuickStartUnix/>.
 
-I<OpenAFS Administration Guide>
-L<http://www.openafs.org/pages/doc/AdminGuide/auagd000.htm>
+The I<OpenAFS Administration Guide>
+L<http://docs.openafs.org/AdminGuide/>.
 
 For the list of assigned standard sysname values, see
 L<http://grand.central.org/numbers/systypes.html>
index c70e131..80203dd 100644 (file)
@@ -18,7 +18,7 @@ The B<livesys> command displays the string stored in kernel memory that
 indicates the local machine's CPU/operating system (OS) type,
 conventionally called the I<sysname>.  The Cache Manager substitutes this
 string for the I<@sys> variable which can occur in AFS pathnames; the
-I<IBM AFS Quick Beginnings> and I<IBM AFS Administration Guide> explain
+I<OpenAFS Quick Start Guides> and I<OpenAFS Administration Guide> explain
 how using I<@sys> can simplify cell configuration.
 
 To set a new value in kernel memory, use the B<fs sysname> command, which
@@ -60,9 +60,10 @@ None
 L<fs_sysname(1)>,
 L<sys(1)>
 
-I<IBM AFS Quick Beginnings>
+The I<OpenAFS Quick Start Guides> at L<http://docs.openafs.org/>.
 
-I<IBM AFS Administration Guide>
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
 
 =head1 COPYRIGHT
 
index e213412..aa9d1ea 100644 (file)
@@ -16,7 +16,7 @@ directory. The ACL lists users and groups and specifies which of seven
 possible access permissions they have for the directory and the files it
 contains. (It is still possible to set a directory or file's mode bits,
 but AFS interprets them in its own way; see the chapter on protection in
-the I<IBM AFS Administration Guide> for details.)
+the I<OpenAFS Administration Guide> for details.)
 
 AFS enables users to define groups in the Protection Database and place
 them on ACLs to extend a set of rights to multiple users simultaneously.
@@ -209,6 +209,9 @@ L<pts_setmax(1)>,
 L<pts_sleep(1)>,
 L<pts_source(1)>
 
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
+
 =head1 COPYRIGHT
 
 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
index 3d461e8..83ed4b7 100644 (file)
@@ -44,7 +44,7 @@ the user's Protection Database entry, including the Authentication
 Database entry, volume, and mount point. When using this command to change
 a user name, also change the names of all related entities to maintain
 consistency. For instructions, see the chapter on user accounts in the
-I<IBM AFS Administration Guide>.
+I<OpenAFS Administration Guide>.
 
 =head1 OPTIONS
 
index 43d1dfd..e4370e1 100644 (file)
@@ -317,7 +317,7 @@ of 60 seconds.
 
 =head1 EXAMPLES
 
-See the chapter on monitoring tools in the I<IBM AFS Administration
+See the chapter on monitoring tools in the I<OpenAFS Administration
 Guide>, which illustrates the displays that result from different
 combinations of options.
 
index 7a094db..f9556ee 100644 (file)
@@ -18,9 +18,9 @@ The B<sys> command displays the string set at compile time that indicates
 the local machine's CPU/operating system (OS) type, conventionally called
 the I<sysname>.  This string is the default for the value stored in kernel
 memory.  The Cache Manager substitutes this string for the I<@sys>
-variable which can occur in AFS pathnames; the I<IBM AFS Quick Beginnings>
-and I<IBM AFS Administration Guide> explain how using I<@sys> can simplify
-cell configuration.
+variable which can occur in AFS pathnames; the I<OpenAFS Quick Start
+Guide> and I<OpenAFS Administration Guide> explain how using I<@sys> can
+simplify cell configuration.
 
 To set a new value in kernel memory, use the B<fs sysname> command.  To
 view the current value set in the kernel, use either B<fs sysname> or
@@ -60,9 +60,10 @@ None
 L<fs_sysname(1)>,
 L<livesys(1)>
 
-I<OpenAFS Quick Beginnings>
+The I<OpenAFS Quick Start Guides> at L<http://docs.openafs.org/>.
 
-I<OpenAFS Administration Guide>
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
 
 =head1 COPYRIGHT
 
index 9b98eef..5bc3973 100644 (file)
@@ -37,14 +37,15 @@ one.
 
 =head1 CAUTIONS
 
-A volume's VLDB entry accommodates a maximum number of site definitions,
-as defined in the I<IBM AFS Release Notes>. The site housing the
-read/write and backup versions of the volume counts as one site, and each
-read-only site counts as an additional site (even the read-only site
-defined on the same file server machine and partition as the read/write
-site counts as a separate site). The limit in the VLDB entry effectively
-determines the maximum number of copies of the volume that are available
-to AFS clients.
+A volume's VLDB entry accommodates a maximum number of 16 site
+definitions. The site housing the read/write and backup versions of the
+volume counts as one site, the backup snapshot counts as one site, and one
+site should be reserved for a transient clone for volume moves and similar
+operations. Each read-only site counts as an additional site (even the
+read-only site defined on the same file server machine and partition as
+the read/write site counts as a separate site). The limit in the VLDB
+entry effectively determines the maximum number of copies of the volume
+that are available to AFS clients.
 
 Attempts to create additional sites by using this command fail with an
 error.
index d618b86..fe366d6 100644 (file)
@@ -18,7 +18,7 @@ superuser C<root>.
 
 The Authentication Server is possibly unable to create these files on some
 operating systems that AFS otherwise supports, making the B<kdb> command
-inoperative. See the I<IBM AFS Release Notes> for details.
+inoperative.
 
 =head1 SEE ALSO
 
index 875be0e..b31f9a0 100644 (file)
@@ -85,7 +85,7 @@ L<upclient(8)>,
 L<upserver(8)>
 
 The I<OpenAFS Administration Guide> at
-L<http://docs.openafs.org/AdminGuide/index.html>.
+L<http://docs.openafs.org/AdminGuide/>.
 
 =head1 COPYRIGHT
 
index 94c3346..de2b988 100644 (file)
@@ -17,13 +17,13 @@ there are normally only two circumstances in which the file is present:
 
 =item *
 
-During installation of the machine, as instructed in the I<IBM AFS Quick
-Beginnings>.
+During installation of the machine, as instructed in the I<OpenAFS Quick
+Start Guide>.
 
 =item *
 
 During correction of a server encryption key emergency, as discussed in
-the I<IBM AFS Administration Guide>.
+the I<OpenAFS Administration Guide>.
 
 =back
 
index 1dc128c..1d7e7b9 100644 (file)
@@ -16,7 +16,7 @@ on every AFS client machine. To change a client machine's cell membership,
 edit the file and reboot the machine.
 
 The file is in ASCII format and contains a character string on a single
-line. The I<IBM AFS Quick Beginnings> instructs the administrator to
+line. The I<OpenAFS Quick Start Guide> instructs the administrator to
 create it during the installation of each client machine.
 
 The client machine's cell membership determines three defaults important
@@ -78,7 +78,7 @@ every AFS server machine.
 The file is in ASCII format and contains a character string on a single
 line. The initial version of the file is created with the B<bos
 setcellname> command during the installation of the cell's first file
-server machine, and the I<IBM AFS Quick Beginnings> includes instructions
+server machine, and the I<OpenAFS Quick Start Guide> includes instructions
 for copying it over to additional server machine during their
 installation.
 
index da00e43..fff6263 100644 (file)
@@ -77,7 +77,7 @@ line.
 Specifies which individual statistic, group of statistics, or section of
 statistics to display on the C<File Servers> screen (C<fs>) or C<Cache
 Managers> screen (C<cm>) and the order in which to display them. The
-appendix of B<afsmonitor> statistics in the I<IBM AFS Administration
+appendix of B<afsmonitor> statistics in the I<OpenAFS Administration
 Guide> specifies the group and section to which each statistic
 belongs. Include as many C<show> lines as necessary to customize the
 screen display as desired, and place them anywhere in the file. The
@@ -101,7 +101,7 @@ the line.
 
 For a list of the values that can appear in the I<field/group/section>
 field of a C<show> instruction, see the B<afsmonitor> statistics appendix
-to the I<IBM AFS Administration Guide>.
+to the I<OpenAFS Administration Guide>.
 
 =head1 SEE ALSO
 
index 0480276..7b30431 100644 (file)
@@ -32,8 +32,8 @@ file server machine to a newly installed one, be sure to remove the
 F<sysid> file from the new machine before starting the C<fs> trio of
 processes, which includes the B<fileserver> process.
 
-Some versions of AFS limit how many of a file server machine's interface
-addresses that can be registered. Consult the I<IBM AFS Release Notes>.
+A maximum of 15 file server interface addresses can be registered in the
+VLDB.
 
 =head1 SEE ALSO
 
index 7528ad7..2ece056 100644 (file)
@@ -46,7 +46,7 @@ The Tape Coordinator uses this capacity value or the one on the Backup
 System tape label to track how much space remains as it writes data to a
 tape or backup data file. The appropriate value to record for a tape
 depends on the size of the tapes usually used in the device and whether it
-has a compression mode; for suggested values, see the I<IBM AFS
+has a compression mode; for suggested values, see the I<OpenAFS
 Administration Guide> chapter on configuring the Backup System. If using a
 value obtained from the B<fms> command, reduce it by 10% to 15% before
 recording it in the file.
@@ -98,7 +98,7 @@ available for actual data.
 
 The appropriate value to record for a tape depends on the size of the
 tapes usually used in the device and whether it has a compression mode;
-for suggested values, see the I<IBM AFS Administration Guide> chapter on
+for suggested values, see the I<OpenAFS Administration Guide> chapter on
 configuring the Backup System. If using a value obtained from the B<fms>
 command, increase it by 10% to 15% before recording it in the file.
 
index 87e7731..1e4ee4c 100644 (file)
@@ -69,7 +69,7 @@ input file C<add> instruction's I<username> field.
 The C<A> instruction in a uss template file enhances cell security by
 imposing the following restrictions on users' password choice and
 authentication attempts. For further information on these limits, see the
-I<IBM AFS Administration Guide> and the B<kas setfields> reference page.
+I<OpenAFS Administration Guide> and the B<kas setfields> reference page.
 
 =over 4
 
@@ -454,7 +454,7 @@ fashion is useful mainly in very large cells where storing all user home
 directories under a single parent directory potentially slows directory
 lookup, or where a workplace-based division results in unevenly sized
 directories such that some users consistently experience slower directory
-lookup than others. See the chapter on B<uss> in the I<IBM AFS
+lookup than others. See the chapter on B<uss> in the I<OpenAFS
 Administration Guide> for more information.
 
 Any number of C<G> instructions can appear in the template file. If the
index 4cb65af..3f62b25 100644 (file)
@@ -260,7 +260,7 @@ on every Backup Server machine, every Volume Location (VL) Server machine,
 and every file server machine that houses affected volumes. By convention,
 a common F<UserList> file is distributed to all database server and file
 server machines in the cell. See the chapter on privileged users in the
-I<IBM AFS Administration Guide> for more information on this type of
+I<OpenAFS Administration Guide> for more information on this type of
 privilege.
 
 If the B<-localauth> flag is included, the user must instead be logged on
index 7373d6b..c62ebed 100644 (file)
@@ -172,7 +172,7 @@ shown here on two lines only for legibility reasons.)
    % backup addvolentry -name fs2 -server fs2.abc.com \
                         -partition /vicepb -volumes ".*"
 
-The chapter in the I<IBM AFS Administration Guide> about configuring the
+The chapter in the I<OpenAFS Administration Guide> about configuring the
 AFS Backup System presents additional examples as well as advice on
 grouping volumes.
 
index 1592a23..ce76747 100644 (file)
@@ -76,7 +76,7 @@ The database is undamaged and can be used.
 
 The database is damaged. You can use the backup savedb command to repair
 many kinds of corruption as it creates a backup copy.  For more detailed
-instructions, see the I<IBM AFS Administration Guide> chapter about
+instructions, see the I<OpenAFS Administration Guide> chapter about
 performing backup operations.
 
 =back
index 27f5336..e20f682 100644 (file)
@@ -66,7 +66,7 @@ dumps to a type of tape the second Tape Coordinator can read, and so
 on. If dumps are on multiple incompatible tape types, use the B<backup
 volrestore> command to restore individual volumes, or the B<backup
 volsetrestore> command after defining groups of volumes that were dumped
-to compatible tape types. For further discussion, see the I<IBM AFS
+to compatible tape types. For further discussion, see the I<OpenAFS
 Administration Guide>.
 
 By default, the Backup System restores the contents of the specified
index b64ebc9..94a615b 100644 (file)
@@ -297,7 +297,7 @@ arrange to provide them.
 If a dump operation is interrupted or fails for any reason, data from all
 volumes written to tape before the interrupt are valid can be used in a
 restore operation. The Backup Database includes an entry for the failed
-dump and for each volume that was successfully dumped. See the I<IBM AFS
+dump and for each volume that was successfully dumped. See the I<OpenAFS
 Administration Guide> for information on dealing with interrupted dumps.
 
 If dumping to tape rather than a backup data file, it is best to use only
index 6ab75ef..093f913 100644 (file)
@@ -61,7 +61,7 @@ provide them.
 
 If the database is corrupted, do not attempt to restore a saved database
 on top of it. Instead, use the instructions for repairing a corrupted
-database in the I<IBM AFS Administration Guide> chapter about performing
+database in the I<OpenAFS Administration Guide> chapter about performing
 backup operations.
 
 =head1 OPTIONS
@@ -115,7 +115,8 @@ L<backup_dbverify(8)>,
 L<backup_savedb(8)>,
 L<butc(8)>
 
-I<IBM AFS Administration Guide>
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
 
 =head1 COPYRIGHT
 
index 8aecafa..19e88b6 100644 (file)
@@ -139,7 +139,7 @@ on). If restoring multiple volumes, the same ordered list of port offsets
 must apply to all of them. If not, either issue this command separately
 for each volume, or use the B<vos volsetrestore> command after defining
 groups of volumes that were dumped to compatible tape types. For further
-discussion, see the I<IBM AFS Administration Guide>.
+discussion, see the I<OpenAFS Administration Guide>.
 
 The Tape Coordinator's default response to this command is to access the
 first tape it needs by invoking the B<MOUNT> instruction in the local
index 0dcc242..24e8640 100644 (file)
@@ -102,7 +102,7 @@ Coordinator can read, and so on. If dumps are on multiple incompatible
 tape types, use the B<backup volrestore> command to restore individual
 volumes, or use this command after defining new volume sets that group
 together volumes that were dumped to compatible tape types. For further
-discussion, see the I<IBM AFS Administration Guide>.
+discussion, see the I<OpenAFS Administration Guide>.
 
 By default, the Backup System overwrites the contents of an existing
 volume with the restored data. To create a new volume to house the
@@ -341,7 +341,7 @@ The date and time when the volume was dumped.
 
 One way to generate a file for use as input to the B<-file> argument is to
 combine the B<-name> and B<-n> options, directing the output to a
-file. The I<IBM AFS Administration Guide> section on using the Backup
+file. The I<OpenAFS Administration Guide> section on using the Backup
 System to restore data explains how to edit the file as necessary before
 using it as input to the B<-file> argument.
 
index 00c540c..d275182 100644 (file)
@@ -28,7 +28,7 @@ After executing this command (and waiting for the Update Server to
 propagate the changes, if it is used), restart the database server
 processes on all database server machines to force election of a quorum
 that includes the new set of machines listed in the
-F</usr/afs/etc/CellServDB> file. The I<IBM AFS Quick Beginnings> explains
+F</usr/afs/etc/CellServDB> file. The I<OpenAFS Quick Start Guide> explains
 in more detail how to add and remove database server machines.
 
 It is best to maintain a one-to-one mapping between hostnames and IP
@@ -112,7 +112,8 @@ L<bos(8)>,
 L<bos_listhosts(8)>,
 L<bos_removehost(8)>
 
-I<IBM AFS Quick Beginnings>
+The I<OpenAFS Quick Start Guide> at
+L<http://docs.openafs.org/QuickStartUnix/>.
 
 =head1 COPYRIGHT
 
index eb1410d..a26bd0f 100644 (file)
@@ -29,7 +29,7 @@ After executing this command (and waiting for the Update Server to
 propagate the changes, if it is used), restart the database server
 processes on all database server machines to force election of a quorum
 that includes the new set of machines listed in the
-F</usr/afs/etc/CellServDB> file. The I<IBM AFS Quick Beginnings> explains
+F</usr/afs/etc/CellServDB> file. The I<OpenAFS Quick Start Guide> explains
 in more detail how to add and remove database server machines.
 
 =head1 OPTIONS
@@ -103,7 +103,8 @@ L<bos(8)>,
 L<bos_addhost(8)>,
 L<bos_listhosts(8)>
 
-I<IBM AFS Quick Beginnings>
+The I<OpenAFS Quick Start Guide> at
+L<http://docs.openafs.org/QuickStartUnix/>.
 
 =head1 COPYRIGHT
 
index c9ae4e8..4b73c5d 100644 (file)
@@ -139,8 +139,8 @@ partition, but do not count against the volume's quota.
 =head1 CAUTIONS
 
 Running this command can result in data loss if the Salvager process can
-repair corruption only by removing the offending data. Consult the I<IBM
-AFS Administration Guide> for more information.
+repair corruption only by removing the offending data. Consult the
+I<OpenAFS Administration Guide> for more information.
 
 =head1 OPTIONS
 
@@ -349,7 +349,8 @@ L<vos_release(1)>,
 L<vos_remove(1)>,
 L<vos_zap(1)>
 
-I<IBM AFS Administration Guide>
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
 
 =head1 COPYRIGHT
 
index 6d1faef..3591dc1 100644 (file)
@@ -42,14 +42,14 @@ machine is thus designated as the cell's first database server machine.
 =head1 CAUTIONS
 
 Issue this command only when the installing the cell's first AFS server
-machine. The I<IBM AFS Quick Beginnings> explains how to copy over the
+machine. The I<OpenAFS Quick Start Guide> explains how to copy over the
 F<ThisCell> and F<CellServDB> files from this or another appropriate
 machine during installation of additional server machines.
 
 Be sure to choose a satisfactory cell name when issuing this command,
 because changing a cell's name is very complicated; for one thing, it
 requires changing every password in the Authentication Database.  Consult
-the I<IBM AFS Administration Guide> for advice on choosing a cell name.
+the I<OpenAFS Administration Guide> for advice on choosing a cell name.
 
 =head1 OPTIONS
 
@@ -121,9 +121,11 @@ L<ThisCell(5)>,
 L<UserList(5)>,
 L<bos(8)>
 
-I<IBM AFS Quick Beginnings>
+The I<OpenAFS Quick Start Guide> at
+L<http://docs.openafs.org/QuickStartUnix/>.
 
-I<IBM AFS Administration Guide>
+The I<OpenAFS Administration Guide> at
+L<http://docs.openafs.org/AdminGuide/>.
 
 =head1 COPYRIGHT
 
index 86b04a0..84efbf3 100644 (file)
@@ -116,7 +116,7 @@ If the Tape Coordinator machine is an AIX machine, use the SMIT utility to
 set the device's block size to 0 (zero), indicating variable block
 size. Otherwise, tape devices attached to machines running other operating
 systems sometimes cannot read tapes written on AIX machines.  For
-instructions, see the I<IBM AFS Administration Guide> chapter about
+instructions, see the I<OpenAFS Administration Guide> chapter about
 configuring the Backup System.
 
 =head1 OPTIONS
index 167c90b..668deb5 100644 (file)
@@ -32,7 +32,7 @@ The intended use of this command is to determine tape capacity and
 filemark size values that can be specified in a tape device's entry in the
 F</usr/afs/backup/tapeconfig> file. For certain types of tape drives, the
 Tape Coordinator operates more efficiently when the F<tapeconfig> file
-lists accurate values. For further discussion, see the I<IBM AFS
+lists accurate values. For further discussion, see the I<OpenAFS
 Administration Guide> chapter on configuring the Backup System.
 
 Insert a tape in the drive before issuing this command.
@@ -43,7 +43,7 @@ Do not use this command on compressing tape devices in compression mode or
 with tape devices that handle tapes of multigigabyte (or multiterabyte)
 capacity. It does not produce accurate results in those cases.  For
 alternate suggestions on the values to record in the B<tapeconfig> file
-for compressing drives, see the I<IBM AFS Administration Guide> chapter on
+for compressing drives, see the I<OpenAFS Administration Guide> chapter on
 configuring the Backup System.
 
 Running the command completely overwrites the tape, so use a blank one or
index 55459e2..a655fe4 100644 (file)
@@ -18,7 +18,7 @@ overwritten in a circular fashion (new trace messages overwrite the oldest
 ones). If an operation of particular interest occurs, the administrator
 can afterward display the log on the standard output stream or write it to
 a file for later study. For more specific procedural instructions, see the
-I<IBM AFS Administration Guide>.
+I<OpenAFS Administration Guide>.
 
 There are several categories of commands in the B<fstrace> command suite:
 
index ea62738..abc7728 100644 (file)
@@ -137,7 +137,7 @@ B<-showkey> flag is not included. The checksum is a decimal number derived
 by encrypting a constant with the key. In the case of the C<afs> entry,
 this number must match the checksum with the corresponding key version
 number in the output of the B<bos listkeys> command; if not, follow the
-instructions in the I<IBM AFS Administration Guide> for creating a new
+instructions in the I<OpenAFS Administration Guide> for creating a new
 server encryption key.
 
 =item *
index 62839d1..8052b7b 100644 (file)
@@ -49,7 +49,7 @@ echo the password visibly.
 
 When changing the B<afs> server key, also issue B<bos addkey> command to
 add the key (with the same key version number) to the
-F</usr/afs/etc/KeyFile> file. See the I<IBM AFS Administration Guide> for
+F</usr/afs/etc/KeyFile> file. See the I<OpenAFS Administration Guide> for
 instructions.
 
 The command interpreter checks the password string subject to the
index 2ce846a..ca039cf 100644 (file)
@@ -26,8 +26,7 @@ information on privileged actions performed by the Authentication Server.
 
 It is possible that on some operating systems that AFS otherwise supports,
 the Authentication Server cannot create the F</usr/afs/logs/AuthLog.dir>
-and F</usr/afs/logs/AuthLog.pag> files, making this command
-inoperative. See the I<IBM AFS Release Notes> for details.
+and F</usr/afs/logs/AuthLog.pag> files, making this command inoperative.
 
 =head1 OPTIONS
 
index 0724f95..b9027d8 100644 (file)
@@ -238,7 +238,7 @@ variable.
 
 =back
 
-See the chapter on uss in the I<IBM AFS Administration Guide> for further
+See the chapter on uss in the I<OpenAFS Administration Guide> for further
 explanation.
 
 =item B<-cell> <I<cell name>>