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.8.0_pre1^2~1665 X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=7dbb35a89f42743ff0a29bc9822b94141a2a8323;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. Change-Id: I947edd30d510c7cc6840bc2cc74d0ef07b692afb Reviewed-on: http://gerrit.openafs.org/8739 Tested-by: BuildBot Reviewed-by: Chas Williams - CONTRACTOR Reviewed-by: Derrick Brashear Reviewed-by: Ken Dreyer --- diff --git a/doc/man-pages/pod8/afsd.pod b/doc/man-pages/pod8/afsd.pod index 9616ac16a..391a5ad46 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 ba4faa30f..901080f0a 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 b2e2a4682..6892fd3d3 100644 --- a/doc/xml/AdminGuide/auagd010.xml +++ b/doc/xml/AdminGuide/auagd010.xml @@ -2773,6 +2773,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: