home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2004 March / PCWMAR04.iso / Software / Resources / Apache / apache_2.0.48-win32-x86-no_ssl.exe / F254347_mod_mime_magic.xml < prev    next >
Encoding:
Text File  |  2003-04-15  |  10.1 KB  |  249 lines
  1. ill be rejected with a return value of <code>FALSE</code>, and a
  2.     <code>GetLastError</code> value of
  3.     <code>ERROR_INVALID_PARAMETER</code>.</p>
  4.  
  5.     <p><code>GetServerVariable</code> is supported, although extended server
  6.     variables do not exist (as defined by other servers.) All the
  7.     usual Apache CGI environment variables are available from
  8.     <code>GetServerVariable</code>, as well as the <code>ALL_HTTP</code>
  9.     and <code>ALL_RAW</code> values.</p>
  10.  
  11.     <p>Apache 2.0 <module>mod_isapi</module> supports additional
  12.     features introduced in later versions of the ISAPI specification,
  13.     as well as limited emulation of async I/O and the
  14.     <code>TransmitFile</code> semantics.  Apache also supports preloading
  15.     ISAPI .dlls for performance, neither of which were not available under
  16.     Apache 1.3 <code>mod_isapi</code>.</p>
  17. </section>
  18.  
  19. <directivesynopsis>
  20. <name>ISAPICacheFile</name>
  21. <description>ISAPI .dll files to be loaded at startup</description>
  22. <syntax>ISAPICacheFile <var>file-path</var> [<var>file-path</var>]
  23. ...</syntax>
  24. <contextlist><context>server config</context><context>virtual host</context>
  25. </contextlist>
  26.  
  27. <usage>
  28.     <p>Specifies a space-separated list of file names to be loaded
  29.     when the Apache server is launched, and remain loaded until the
  30.     server is shut down. This directive may be repeated for every
  31.     ISAPI .dll file desired. The full path name of each file should
  32.     be specified. If the path name is not absolute, it will be treated
  33.     relative to <directive module="core">ServerRoot</directive>.</p>
  34. </usage>
  35. </directivesynopsis>
  36.  
  37. <directivesynopsis>
  38. <name>ISAPIReadAheadBuffer</name>
  39. <description>Size of the Read Ahead Buffer sent to ISAPI
  40. extensions</description>
  41. <syntax>ISAPIReadAheadBuffer <var>size</var></syntax>
  42. <default>ISAPIReadAheadBuffer 49152</default>
  43. <contextlist><context>server config</context><context>virtual host</context>
  44. <context>directory</context><context>.htaccess</context></contextlist>
  45. <override>FileInfo</override>
  46.  
  47. <usage>
  48.     <p>Defines the maximum size of the Read Ahead Buffer sent to
  49.     ISAPI extensions when they are initially invoked. All remaining
  50.     data must be retrieved using the <code>ReadClient</code> callback; some
  51.     ISAPI extensions may not support the <code>ReadClient</code> function.
  52.     Refer questions to the ISAPI extension's author.</p>
  53. </usage>
  54. </directivesynopsis>
  55.  
  56. <directivesynopsis>
  57. <name>ISAPILogNotSupported</name>
  58. <description>Log unsupported feature requests from ISAPI
  59. extensions</description>
  60. <syntax>ISAPILogNotSupported on|off</syntax>
  61. <default>ISAPILogNotSupported off</default>
  62. <contextlist><context>server config</context><context>virtual host</context>
  63. <context>directory</context><context>.htaccess</context></contextlist>
  64. <override>FileInfo</override>
  65.  
  66. <usage>
  67.     <p>Logs all requests for unsupported features from ISAPI
  68.     extensions in the server error log. This may help administrators
  69.     to track down problems. Once set to on and all desired ISAPI modules
  70.     are functioning, it should be set back to off.</p>
  71. </usage>
  72. </directivesynopsis>
  73.  
  74. <directivesynopsis>
  75. <name>ISAPIAppendLogToErrors</name>
  76. <description>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from
  77. ISAPI extensions to the error log</description>
  78. <syntax>ISAPIAppendLogToErrors on|off</syntax>
  79. <default>ISAPIAppendLogToErrors off</default>
  80. <contextlist><context>server config</context><context>virtual host</context>
  81. <context>directory</context><context>.htaccess</context></contextlist>
  82. <override>FileInfo</override>
  83.  
  84. <usage>
  85.     <p>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from ISAPI
  86.     extensions to the server error log.</p>
  87. </usage>
  88. </directivesynopsis>
  89.  
  90. <directivesynopsis>
  91. <name>ISAPIAppendLogToQuery</name>
  92. <description>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from
  93. ISAPI extensions to the query field</description>
  94. <syntax>ISAPIAppendLogToQuery on|off</syntax>
  95. <default>ISAPIAppendLogToQuery on</default>
  96. <contextlist><context>server config</context><context>virtual host</context>
  97. <context>directory</context><context>.htaccess</context></contextlist>
  98. <override>FileInfo</override>
  99.  
  100. <usage>
  101.     <p>Record <code>HSE_APPEND_LOG_PARAMETER</code> requests from ISAPI
  102.     extensions to the query field (appended to the <directive
  103.     module="mod_log_config">CustomLog</directive> <code>%q</code>
  104.     component).</p>
  105. </usage>
  106. </directivesynopsis>
  107.  
  108. <directivesynopsis>
  109. <name>ISAPIFakeAsync</name>
  110. <description>Fake asynchronous support for ISAPI callbacks</description>
  111. <syntax>ISAPIFakeAsync on|off</syntax>
  112. <default>ISAPIFakeAsync off</default>
  113. <contextlist><context>server config</context><context>virtual host</context>
  114. <context>directory</context><context>.htaccess</context></contextlist>
  115. <override>FileInfo</override>
  116.  
  117. <usage>
  118.     <p>While set to on, asynchronous support for ISAPI callbacks is
  119.     simulated.</p>
  120. </usage>
  121. </directivesynopsis>
  122.  
  123. </modulesynopsis>
  124.  
  125. <?xml version="1.0" encoding="UTF-8" ?>
  126.  
  127. <metafile>
  128.   <basename>mod_isapi</basename>
  129.   <path>/mod/</path>
  130.   <relpath>..</relpath>
  131.  
  132.   <variants>
  133.     <variant>en</variant>
  134.   </variants>
  135. </metafile>
  136. <?xml version="1.0"?>
  137. <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
  138. <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
  139. <modulesynopsis metafile="mod_ldap.xml.meta">
  140.  
  141. <name>mod_ldap</name>
  142. <description>LDAP connection pooling and result caching services for use
  143. by other LDAP modules</description>
  144. <status>Experimental</status>
  145. <sourcefile>util_ldap.c</sourcefile>
  146. <identifier>ldap_module</identifier>
  147. <compatibility>Available in version 2.0.41 and later</compatibility>
  148.  
  149. <summary>
  150.     <p>This module was created to improve the performance of
  151.     websites relying on backend connections to LDAP servers. In
  152.     addition to the functions provided by the standard LDAP
  153.     libraries, this module adds an LDAP connection pool and an LDAP
  154.     shared memory cache.</p>
  155.  
  156.     <p>To enable this module, LDAP support must be compiled into
  157.     apr-util. This is achieved by adding the <code>--with-ldap</code>
  158.     flag to the <code>./configure</code> script when building
  159.     Apache.</p>
  160.  
  161.     <p>SSL support requires that <module>mod_ldap</module> be linked
  162.     with one of the following LDAP SDKs: <a href="http://www.openldap.org/">
  163.     OpenLDAP SDK</a> (both 1.x and 2.x), <a href="http://developer.novell.com/ndk/cldap.htm">
  164.     Novell LDAP SDK</a> or the <a href="http://www.iplanet.com/downloads/developer/">
  165.     iPlanet(Netscape)</a> SDK.</p>
  166.  
  167. </summary>
  168.  
  169. <section id="exampleconfig"><title>Example Configuration</title>
  170.     <p>The following is an example configuration that uses
  171.     <module>mod_ldap</module> to increase the performance of HTTP Basic
  172.     authentication provided by <module>mod_auth_ldap</module>.</p>
  173.  
  174.     <example>
  175.       # Enable the LDAP connection pool and shared<br />
  176.       # memory cache. Enable the LDAP cache status<br />
  177.       # handler. Requires that mod_ldap and mod_auth_ldap<br />
  178.       # be loaded. Change the "yourdomain.example.com" to<br />
  179.       # match your domain.<br />
  180.       <br />
  181.       LDAPSharedCacheSize 200000<br />
  182.       LDAPCacheEntries 1024<br />
  183.       LDAPCacheTTL 600<br />
  184.       LDAPOpCacheEntries 1024<br />
  185.       LDAPOpCacheTTL 600<br />
  186.       <br />
  187.       <Location /ldap-status><br />
  188.       <indent>
  189.         SetHandler ldap-status<br />
  190.         Order deny,allow<br />
  191.         Deny from all<br />
  192.         Allow from yourdomain.example.com<br />
  193.         AuthLDAPEnabled on<br />
  194.         AuthLDAPURL ldap://127.0.0.1/dc=example,dc=com?uid?one<br />
  195.         AuthLDAPAuthoritative on<br />
  196.         require valid-user<br />
  197.       </indent>
  198.       </Location>
  199.     </example>
  200. </section>
  201.  
  202. <section id="pool"><title>LDAP Connection Pool</title>
  203.  
  204.     <p>LDAP connections are pooled from request to request. This
  205.     allows the LDAP server to remain connected and bound ready for
  206.     the next request, without the need to unbind/connect/rebind.
  207.     The performance advantages are similar to the effect of HTTP
  208.     keepalives.</p>
  209.  
  210.     <p>On a busy server it is possible that many requests will try
  211.     and access the same LDAP server connection simultaneously.
  212.     Where an LDAP connection is in use, Apache will create a new
  213.     connection alongside the original one. This ensures that the
  214.     connection pool does not become a bottleneck.</p>
  215.  
  216.     <p>There is no need to manually enable connection pooling in
  217.     the Apache configuration. Any module using this module for
  218.     access to LDAP services will share the connection pool.</p>
  219. </section>
  220.  
  221. <section id="cache"><title>LDAP Cache</title>
  222.  
  223.     <p>For improved performance, <module>mod_ldap</module> uses an aggressive
  224.     caching strategy to minimize the number of times that the LDAP
  225.     server must be contacted. Caching can easily double or triple
  226.     the throughput of Apache when it is serving pages protected
  227.     with mod_auth_ldap. In addition, the load on the LDAP server
  228.     will be significantly decreased.</p>
  229.  
  230.     <p><module>mod_ldap</module> supports two types of LDAP caching during
  231.     the search/bind phase with a <em>search/bind cache</em> and
  232.     during the compare phase with two <em>operation
  233.     caches</em>. Each LDAP URL that is used by the server has
  234.     its own set of these three caches.</p>
  235.  
  236.     <section id="search-bind"><title>The Search/Bind Cache</title>
  237.       <p>The process of doing a search and then a bind is the
  238.       most time-consuming aspect of LDAP operation, especially if
  239.       the directory is large. The search/bind cache is used to
  240.       cache all searches that resulted in successful binds.
  241.       Negative results (<em>i.e.</em>, unsuccessful searches, or searches
  242.       that did not result in a successful bind) are not cached.
  243.       The rationale behind this decision is that connections with
  244.       invalid credentials are only a tiny percentage of the total
  245.       number of connections, so by not caching invalid
  246.       credentials, the size of the cache is reduced.</p>
  247.  
  248.       <p><module>mod_ldap</module> stores the username, the DN
  249.