From b6ed780e28ac2b5b398d4392985622fa37e26e4b Mon Sep 17 00:00:00 2001 From: Ken Dreyer Date: Mon, 16 May 2011 19:53:43 -0400 Subject: [PATCH] doc: -afsdb uses SRV records afsd's -afsdb option now uses DNS SRV records (RFC 5864). Update the manpages to reflect this. Reviewed-on: http://gerrit.openafs.org/4670 Tested-by: BuildBot Reviewed-by: Michael Meffie Reviewed-by: Derrick Brashear (cherry picked from commit 884d0b058cea4ad6c9338fc7842ea0c619cb263d) Change-Id: Ibcdb7c0564d9ac56fa9e50123950e7f758761111 Reviewed-on: http://gerrit.openafs.org/4701 Tested-by: Derrick Brashear Reviewed-by: Derrick Brashear --- doc/man-pages/pod1/cmdebug.pod | 4 ++-- doc/man-pages/pod1/fs_checkservers.pod | 2 +- doc/man-pages/pod5/CellServDB.pod | 12 ++++++------ doc/man-pages/pod8/afsd.pod | 13 +++++++------ 4 files changed, 16 insertions(+), 15 deletions(-) diff --git a/doc/man-pages/pod1/cmdebug.pod b/doc/man-pages/pod1/cmdebug.pod index c01cb312d..80061e36d 100644 --- a/doc/man-pages/pod1/cmdebug.pod +++ b/doc/man-pages/pod1/cmdebug.pod @@ -95,8 +95,8 @@ this option with B<-long>, B<-refcounts>, B<-callbacks>, or B<-addrs>. 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 +including those from the CellServDB file, DNS SRV or AFSDB 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>. diff --git a/doc/man-pages/pod1/fs_checkservers.pod b/doc/man-pages/pod1/fs_checkservers.pod index 9f6996f64..3a916dc63 100644 --- a/doc/man-pages/pod1/fs_checkservers.pod +++ b/doc/man-pages/pod1/fs_checkservers.pod @@ -27,7 +27,7 @@ memory: =item * -The database server machines in every cell listed in the local +The database server machines for every cell listed in the local F, plus any machines added to the memory list by the B command since the last reboot. diff --git a/doc/man-pages/pod5/CellServDB.pod b/doc/man-pages/pod5/CellServDB.pod index 5e0240f4f..0f33c3efd 100644 --- a/doc/man-pages/pod5/CellServDB.pod +++ b/doc/man-pages/pod5/CellServDB.pod @@ -13,8 +13,8 @@ configurations it can be a link to the same file the client uses. =head2 Client CellServDB -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 +Along with AFSDB and SRV 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 (optional), Protection Server, and Volume Location (VL) Server (the @@ -66,8 +66,8 @@ command. If the client attempts to access an AFS cell not listed in F and B was started with the B<-afsdb> option, the Cache Manager will -attempt an AFSDB DNS record lookup and dynamically add the database server -locations for that cell based on the result of the DNS query. If the +attempt a DNS SRV or AFSDB record lookup and dynamically add the database +server locations for that cell based on the result of the DNS query. If the B<-afsdb> option was not used, all AFS cells that will be accessed by a client machine must either be listed in F or added with the B command. @@ -189,8 +189,8 @@ of a cell (so that it's listed by default in F when the B<-dynroot> flag to B is in use, for instance) without specifying the database server machines for that cell. This can be done by including only the cell line (starting with C<< > >>) and omitting any following database -server machine lines. This only works if B is configured, with the -B<-afsdb> option, to use AFSDB record lookups to locate database server +server machine lines. B must be configured with the B<-afsdb> option +to use DNS SRV or AFSDB record lookups to locate database server machines. If the cell has such records and the client is configured to use them, this configuration won't require updates to the client F file when the IP addresses of the database server machines diff --git a/doc/man-pages/pod8/afsd.pod b/doc/man-pages/pod8/afsd.pod index d844bbfbb..9d763263c 100644 --- a/doc/man-pages/pod8/afsd.pod +++ b/doc/man-pages/pod8/afsd.pod @@ -71,7 +71,7 @@ machines, prevents the Cache Manager from accessing files in it. By default, the list of database server machines is transferred into the kernel from the F file. Alternatively, when the B<-afsdb> option is used, the list of database server machines is taken -from the AFSDB DNS records for each cell. After initialization, use the +from the DNS SRV or AFSDB records for each cell. After initialization, use the B command to change the kernel-resident list without having to reboot. @@ -411,14 +411,14 @@ It should be considered experimental. =item B<-afsdb> -Enable afsdb support. This will use DNS to lookup the AFSDB record and +Enable afsdb support. This will use DNS to lookup the SRV or AFSDB records and use that for the database servers for each cell instead of the values in the F file. This has the advantage of only needing to -update one DNS record to reconfigure the AFS clients for a new +update one set of DNS records to reconfigure the AFS clients for a new database server as opposed to touching all of the clients, and also allows one to access a cell without preconfiguring its database -servers in F. The format of AFSDB records is defined in -RFC 1183. +servers in F. The format of SRV records is defined in +RFC 5864, and the AFSDB record format is in RFC 1183. =item B<-backuptree> @@ -755,7 +755,8 @@ L, L, L -RFC 1183 L +RFC 5864 L +RFC 1183 L =head1 COPYRIGHT -- 2.39.5