From 298fb5ce52f3f5296c24ed1300287b5fa5870a3c Mon Sep 17 00:00:00 2001 From: Jason Edgecombe Date: Mon, 14 Jul 2008 00:51:35 +0000 Subject: [PATCH] docs-ticket-104110-20080713 LICENSE BSD FIXES 104110 add vos clone and vos shadow to overall list ==================== This delta was composed from multiple commits as part of the CVS->Git migration. The checkin message with each commit was inconsistent. The following are the additional commit messages. ==================== LICENSE BSD FIXES 104110 add krb.conf update CellServDB to discuss AFSDB DNS records --- doc/man-pages/pod1/vos.pod | 2 ++ doc/man-pages/pod5/CellServDB.pod | 49 ++++++++++++++++--------------- doc/man-pages/pod5/afs.pod | 2 ++ doc/man-pages/pod5/krb.conf.pod | 21 +++++++++++++ 4 files changed, 51 insertions(+), 23 deletions(-) create mode 100644 doc/man-pages/pod5/krb.conf.pod diff --git a/doc/man-pages/pod1/vos.pod b/doc/man-pages/pod1/vos.pod index 8d37408d8..b91eaff56 100644 --- a/doc/man-pages/pod1/vos.pod +++ b/doc/man-pages/pod1/vos.pod @@ -242,6 +242,7 @@ L, L, L, L, +L, L, L, L, @@ -260,6 +261,7 @@ L, L, L, L, +L, L, L, L, diff --git a/doc/man-pages/pod5/CellServDB.pod b/doc/man-pages/pod5/CellServDB.pod index 2cc7c1e8e..4e683754d 100644 --- a/doc/man-pages/pod5/CellServDB.pod +++ b/doc/man-pages/pod5/CellServDB.pod @@ -12,13 +12,13 @@ servers and lists only the database servers in the local cell. =head2 Client CellServDB -The client version of the CellServDB file lists the database server -machines in the local cell and any foreign cell that is to be accessible -from the local client machine. Database server machines run the -Authentication Server, Backup Server, Protection Server, and Volume -Location (VL) Server (the B, B, B, and -B) processes, which maintain the cell's administrative AFS -databases. +Along with AFSDB entries in DNS, the client version of the CellServDB file +lists the database server machines in the local cell and any foreign cell +that is to be accessible from the local client machine. Database server +machines run the Authentication Server (optional), Backup Server, +Protection Server, and Volume Location (VL) Server (the B, +B, B, and B) processes, which maintain the +cell's administrative AFS databases. The Cache Manager and other processes running on a client machine use the list of a cell's database server machines when performing several common @@ -47,11 +47,12 @@ information from the Protection Database. =back The Cache Manager reads the CellServDB file into kernel memory as it -initializes, and not again until the machine next reboots. To enable users -on the local machine to continue accessing the cell correctly, update the -file whenever a database server machine is added to or removed from a -cell. To update the kernel-resident list of database server machines -without rebooting, use the B command. +initializes, and not again until the machine next reboots or the client +service restarts. To enable users on the local machine to continue +accessing the cell correctly, update the file whenever a database server +machine is added to or removed from a cell. To update the kernel-resident +list of database server machines without rebooting, use the B +command. The F file is in ASCII format and must reside in the F directory on each AFS client machine. Use a text editor @@ -67,15 +68,16 @@ server machines. =head2 Server CellServDB The server version of the F file lists the local cell's -database server machines. These machines run the Authentication Server, -Backup Server, Protection Server, and Volume Location (VL) Server (the -B, B, B, and B) processes, which -maintain the cell's administrative AFS databases. The initial version of -the file is created with the B command during the -installation of the cell's server machine, which is automatically recorded -as the cell's first database server machine. When adding or removing -database server machines, be sure to update this file appropriately. It -must reside in the F directory on each AFS server machine. +database server machines. These machines run the Authentication Server +(optional), Backup Server, Protection Server, and Volume Location (VL) +Server (the B, B, B, and B) +processes, which maintain the cell's administrative AFS databases. The +initial version of the file is created with the B command +during the installation of the cell's server machine, which is +automatically recorded as the cell's first database server machine. When +adding or removing database server machines, be sure to update this file +appropriately. It must reside in the F directory on each AFS +server machine. The database server processes consult the F file to learn about their peers, with which they must maintain constant connections in @@ -109,7 +111,7 @@ In cells that use the Update Server to distribute the contents of the F directory, it is customary to edit only the copy of the file stored on the system control machine. Otherwise, edit the file on each server machine individually. For instructions on adding and removing -database server machine, see the I chapter on +database server machine, see the I chapter on installing additional server machines. =head2 CellServDB Format @@ -178,6 +180,7 @@ F file and illustrates the required format. =head1 SEE ALSO +L, L, L, L, @@ -191,7 +194,7 @@ L, L, L -I +I =head1 COPYRIGHT diff --git a/doc/man-pages/pod5/afs.pod b/doc/man-pages/pod5/afs.pod index 6d8ffb379..80fe15930 100644 --- a/doc/man-pages/pod5/afs.pod +++ b/doc/man-pages/pod5/afs.pod @@ -73,6 +73,8 @@ Configuration files: =item L +=item L + =item L =item L diff --git a/doc/man-pages/pod5/krb.conf.pod b/doc/man-pages/pod5/krb.conf.pod new file mode 100644 index 000000000..5afe29b04 --- /dev/null +++ b/doc/man-pages/pod5/krb.conf.pod @@ -0,0 +1,21 @@ +=head1 NAME + +krb.conf - Configures the kerberos realm to AFS cell mapping + +=head1 DESCRIPTION + +/usr/vice/etc/krb.conf is an optional file that resides on an OpenAFS +server and is used to specify which Kerberos5 realms are trusted to +authenticate to the local AFS cell. The format of the file is one realm +per line. If the Kerberos5 realm matches the AFS cell name +(case-insensitive), then this file can be omitted. krb.conf is only needed +when the Kerberos5 realm does not match the cell name or multiple +Kerberos5 realms authenticate to the same AFS cell. + +=head1 COPYRIGHT + +Copyright 2008 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. -- 2.39.5