From: Michael Meffie Date: Mon, 10 Dec 2012 17:01:38 +0000 (-0500) Subject: doc: dynamic mount requires dynroot and fakestat X-Git-Tag: upstream/1.6.3^2~127 X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=36e1707ffbda22808cf5af23460dd05c38a6a87a;p=packages%2Fo%2Fopenafs.git doc: dynamic mount requires dynroot and fakestat Document that dynamic mount (/afs/.:mount) requires dynroot and fakestat on non-linux unix. Reviewed-on: http://gerrit.openafs.org/8739 Tested-by: BuildBot Reviewed-by: Chas Williams - CONTRACTOR Reviewed-by: Derrick Brashear Reviewed-by: Ken Dreyer (cherry picked from commit 7dbb35a89f42743ff0a29bc9822b94141a2a8323) Change-Id: Ia77835cd1830c7bc5dde573f2e890341aa06bc21 Reviewed-on: http://gerrit.openafs.org/9519 Reviewed-by: Derrick Brashear Reviewed-by: Andrew Deason Reviewed-by: Stephan Wiesand Tested-by: BuildBot --- diff --git a/doc/man-pages/pod8/afsd.pod b/doc/man-pages/pod8/afsd.pod index 9d763263c..932e8c664 100644 --- a/doc/man-pages/pod8/afsd.pod +++ b/doc/man-pages/pod8/afsd.pod @@ -536,6 +536,16 @@ the F file can be used to provide shortname for common AFS cells which provides equivalent functionality to the most commonly used symbolic links. +When the dynamic root (B<-dynroot>, B<-dynroot-sparse>) and the fake stat +(B<-fakestat>, B<-fakestat-all>) modes are in effect, the cache manager +provides a special directory named F which allows access to +volumes by volume name or ID. The F directory appears to be +empty, but any name in the form of I:I will be resolved as a +read-write mount point to the specified volume. This dynamic mount feature is +recommended only for temporary access to a volume. Linux-based cache managers +provide this dynamic mount feature even when dynamic root (B<-dynroot>, +B<-dynroot-sparse>) is not in effect. + =item B<-dynroot-sparse> In addition to operating in the manner described for dynroot above, diff --git a/doc/txt/README.linux-nfstrans b/doc/txt/README.linux-nfstrans index f32b91867..55ad6058c 100644 --- a/doc/txt/README.linux-nfstrans +++ b/doc/txt/README.linux-nfstrans @@ -193,7 +193,9 @@ a volume which is no longer in the cache (and thus has no known mount point), it will complete the path to the AFS root using the dynamic mount directory. -This feature is available whenever the dynamic AFS root is enabled. +On non-linux cache managers, this feature is available when dynamic +root and fake stat modes are enabled. + On Linux systems, it is also available even when dynroot is not enabled, to support the NFS translator. It is presently not possible to disable this feature, though that ability may be added in the future. It would diff --git a/doc/xml/AdminGuide/auagd010.xml b/doc/xml/AdminGuide/auagd010.xml index 3ff309e4f..63e8067ba 100644 --- a/doc/xml/AdminGuide/auagd010.xml +++ b/doc/xml/AdminGuide/auagd010.xml @@ -2777,6 +2777,12 @@ recommended for temporary access to a volume. For example, if you have recently restored a volume from a backup, you can use this syntax to quickly access the volume without mounting it. + + This feature is available with Windows and Linux based cache + managers by default. This feature is available with other Unix based + cache managers when the dynamic root (-dynroot) and fake stat + (-fakestat) modes are enabled. + Examples: