From 67bcc19c754e7bfd55d098e9fe17723340c275ba Mon Sep 17 00:00:00 2001
From: Jason Edgecombe <jason@rampaginggeek.com>
Date: Sun, 30 Aug 2009 18:13:06 -0400
Subject: [PATCH] Updated Chapter 2, Section 3.3 of the Admin Guide

Added text about Freelance Mode and Dynamric Root Mode and the changes they
cause when dealing with mounts to foreign cells in /afs and \\AFS

Reviewed-on: http://gerrit.openafs.org/380
Reviewed-by: Jeffrey Altman <jaltman@openafs.org>
Reviewed-by: Derrick Brashear <shadow@dementia.org>
Tested-by: Derrick Brashear <shadow@dementia.org>
---
 doc/xml/AdminGuide/auagd007.xml | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/doc/xml/AdminGuide/auagd007.xml b/doc/xml/AdminGuide/auagd007.xml
index 5b8927ef17..01d011df20 100644
--- a/doc/xml/AdminGuide/auagd007.xml
+++ b/doc/xml/AdminGuide/auagd007.xml
@@ -916,7 +916,11 @@ user receives an AFS token when
     <sect2 id="HDRWQ39">
       <title>Making Other Cells Visible in Your Cell</title>
 
-      <para>To make a foreign cell's filespace visible on a client machine in your cell, perform the following three steps:
+      <para>To make a foreign cell's filespace visible on a client machine
+      in your cell that is not configured
+      for <emphasis role="bold">Freelance Mode</emphasis>
+      or <emphasis role="bold">Dynamic Root</emphasis> mode, perform the
+      following three steps:
       <orderedlist>
           <listitem>
             <para>Mount the cell's <emphasis role="bold">root.cell</emphasis> volume at the second level in your cell's filespace
@@ -948,6 +952,30 @@ user receives an AFS token when
           </listitem>
         </orderedlist></para>
 
+      <para>Non-windows client machines may
+      enable <emphasis role="bold">Dynamic Root Mode</emphasis> by using
+      the <emphasis role="bold">-dynroot</emphasis> option
+      to <emphasis role="bold">afsd</emphasis>. When this option is
+      enabled, all cells listed in
+      the <emphasis role="bold">CellServDB</emphasis> file will appear in
+      the <emphasis role="bold">/afs</emphasis> directory. The contents of
+      the <emphasis role="bold">root.afs</emphasis> volume will be ignored.
+      </para>
+
+      <para>Windows client machines may
+      enable <emphasis role="bold">Freelance Mode</emphasis> during client
+      installation or by setting
+      the <emphasis role="bold">FreelanceClient</emphasis> setting
+      under <emphasis role="bold">Service Parameters</emphasis> in the
+      Windows Registry as mentioned in
+      the <ulink url="http://docs.openafs.org/ReleaseNotesWindows/">Release
+      Notes</ulink>.  When this option is enabled,
+      the <emphasis role="bold">root.afs</emphasis> volume is ignored and
+      a mounpoint for each cell is automatically created in the
+      the <emphasis role="bold">\\AFS</emphasis> directory when the
+      folder <emphasis role="bold">\\AFS\<replaceable>cellname</replaceable></emphasis>
+      is accessed and the foreign Volume Location servers can be reached.
+      </para>
       <para>Note that making a foreign cell visible to client machines does not guarantee that your users can access its filespace.
       The ACLs in the foreign cell must also grant them the necessary permissions.</para>