doc: add section on direct volume access

Provide examples of the direct volume access syntax, using the
fictitious example.com cell.

Reviewed-on: http://gerrit.openafs.org/6691
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com>
Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
(cherry picked from commit e99224f2fe049bc339e87c8b6c195de67dca2f08)

Change-Id: I5b2ac3b6f255d5918eeea4a63d4c7bb6164961d5
Reviewed-on: http://gerrit.openafs.org/6755
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Derrick Brashear <shadow@dementix.org>

diff --git a/doc/xml/AdminGuide/auagd010.xml b/doc/xml/AdminGuide/auagd010.xml
index 9200b2bb01b1ebeb345877b3bb5a3d8f072fa395..083250e691382921c8b4fe21644472404b9291ce 100644 (file)
--- a/doc/xml/AdminGuide/auagd010.xml
+++ b/doc/xml/AdminGuide/auagd010.xml
@@ -2763,6 +2763,32 @@
         </listitem>
       </orderedlist>
     </sect2>
+
+    <sect2>
+      <title>To access volumes directly by volume ID</title>
+
+      <indexterm>
+        <primary>volume</primary>
+
+        <secondary>direct access</secondary>
+      </indexterm>
+
+      <para>You can directly access volumes by volume IDs. This is only
+      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>Examples:</para>
+      <itemizedlist>
+          <listitem>
+           <para><emphasis role="bold">Windows:</emphasis>
+            \\afs\example.com#root.cell</para>
+          <listitem>
+          <listitem>
+           <para><emphasis role="bold">Unix:</emphasis>
+            /afs/.:mount/example.com#root.cell</para>
+          <listitem>
+      </itemizedlist>
+    </sect2>
   </sect1>
 
   <sect1 id="HDRWQ216">