From: Jeff Trawick <trawick@apache.org>
Date: Fri, 3 Dec 2010 18:10:10 +0000 (+0000)
Subject: Merge r1041937 from trunk:
X-Git-Tag: 2.2.18~270
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=345ce1f2088badf3dbd32398fa008ab7f5abb036;p=thirdparty%2Fapache%2Fhttpd.git

Merge r1041937 from trunk:

describe UNC paths vs mapped drive letters


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@1041941 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/platform/windows.xml b/docs/manual/platform/windows.xml
index 7c818bf4d45..9966c565bc6 100644
--- a/docs/manual/platform/windows.xml
+++ b/docs/manual/platform/windows.xml
@@ -692,4 +692,46 @@
     80 to attempt to bypass firewall issues.</p>
   </section>
 
+  <section id="windrivemap">
+    <title>Configuring Access to Network Resources</title>
+
+  <p>Access to files over the network can be specified using two
+  mechanisms provided by Windows:</p>
+
+  <dl>
+    <dt>Mapped drive letters</dt>
+    <dd>e.g., <code>Alias /images/ Z:/</code></dd>
+
+    <dt>UNC paths</dt>
+    <dd>e.g., <code>Alias /images/ //imagehost/www/images/</code></dd>
+  </dl>
+
+  <p>Mapped drive letters allow the administrator to maintain the
+  mapping to a specific machine and path outside of the Apache httpd
+  configuration.  However, these mappings are associated only with
+  interactive sessions and are not directly available to Apache httpd
+  when it is started as a service.  <strong>Use only UNC paths for
+  network resources in httpd.conf</strong> so that the resources can
+  be accessed consistently regardless of how Apache httpd is started.
+  (Arcane and error prone procedures may work around the restriction
+  on mapped drive letters, but this is not recommended.)</p>
+
+  <example><title>Example directives with UNC paths</title>
+
+  DocumentRoot //dochost/www/html/<br />
+  <br />
+  DocumentRoot //192.168.1.50/docs/<br />
+  <br />
+  Alias /images/ //imagehost/www/images/<br />
+  <br />
+  &lt;Directory //imagehost/www/images/&gt;<br />
+  ...<br />
+  &lt;Directory&gt;<br />
+  </example>
+
+  <p>When running Apache httpd as a service, you must create a
+  separate account in order to access network resources, as described
+  above.</p>
+  </section>
+
 </manualpage>