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 <buildbot@rampaginggeek.com>
Reviewed-by: Chas Williams - CONTRACTOR <chas@cmf.nrl.navy.mil>
Reviewed-by: Derrick Brashear <shadow@your-file-system.com>
Reviewed-by: Ken Dreyer <ktdreyer@ktdreyer.com>
(cherry picked from commit 7dbb35a89f42743ff0a29bc9822b94141a2a8323)

Change-Id: Ia77835cd1830c7bc5dde573f2e890341aa06bc21
Reviewed-on: http://gerrit.openafs.org/9519
Reviewed-by: Derrick Brashear <shadow@your-file-system.com>
Reviewed-by: Andrew Deason <adeason@sinenomine.net>
Reviewed-by: Stephan Wiesand <stephan.wiesand@desy.de>
Tested-by: BuildBot <buildbot@rampaginggeek.com>

diff --git a/doc/man-pages/pod8/afsd.pod b/doc/man-pages/pod8/afsd.pod
index 9d763263c4ad0fac6fb6a56892e3a99f0cf64d71..932e8c6646c3b514acbb080b35fe8add03866a04 100644 (file)
--- a/doc/man-pages/pod8/afsd.pod
+++ b/doc/man-pages/pod8/afsd.pod
@@ -536,6 +536,16 @@ the F<CellAlias> 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</afs/.:mount> which allows access to
+volumes by volume name or ID.  The F</afs/.:mount> directory appears to be
+empty, but any name in the form of I<cell>:I<volume> 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 f32b91867675d63ca3c35ed321011760b87de637..55ad6058cc4749fbe5bdcad16730d26c301c8c1b 100644 (file)
--- 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 3ff309e4f191550d7403470cca81b8ed8dbd3fc3..63e8067ba7b42a22bb0866e82e681ce9427038de 100644 (file)
--- 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.</para>
+
+      <para>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.</para>
+
       <para>Examples:</para>
       <itemizedlist>
           <listitem>