components/proftpd/patches/proftpd-configuration-html.patch
branchs11-update
changeset 3224 589e0e82672d
parent 2573 9506d3f4099e
equal deleted inserted replaced
3216:d8137835c0b4 3224:589e0e82672d
     1 --- proftpd-1.3.3e/doc/Configuration.html	Fri Oct  5 08:38:32 2007
     1 --- a/doc/Configuration.html
     2 +++ proftpd-1.3.3g/doc/Configuration.html	Fri Feb  1 22:32:57 2013
     2 +++ b/doc/Configuration.html
     3 @@ -3,9 +3,7 @@
     3 @@ -10805,7 +10805,7 @@ CLASS="SYNOPSIS"
     4  ><HEAD
       
     5  ><TITLE
       
     6  >Configuration Directive List</TITLE
       
     7 -><META
       
     8 -NAME="GENERATOR"
       
     9 -CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
       
    10 +><meta name="generator" content="Bluefish 2.0.2" ></HEAD
       
    11  ><BODY
       
    12  CLASS="BOOK"
       
    13  BGCOLOR="#FFFFFF"
       
    14 @@ -113,11 +111,6 @@
       
    15  >&nbsp;--&nbsp;User based allow rules</DT
       
    16  ><DT
       
    17  ><A
       
    18 -HREF="#ANONRATIO"
       
    19 ->&#13;AnonRatio</A
       
    20 ->&nbsp;--&nbsp;Ratio directive</DT
       
    21 -><DT
       
    22 -><A
       
    23  HREF="#ANONREJECTPASSWORDS"
       
    24  >&#13;AnonRejectPasswords</A
       
    25  >&nbsp;--&nbsp;Block certain anonymous user passwords</DT
       
    26 @@ -178,21 +171,6 @@
       
    27  >&nbsp;--&nbsp;Bind the server or Virtualhost to a specific IP address [deprecated]</DT
       
    28  ><DT
       
    29  ><A
       
    30 -HREF="#BYTERATIOERRMSG"
       
    31 ->&#13;ByteRatioErrMsg</A
       
    32 ->&nbsp;--&nbsp;Ratio directive</DT
       
    33 -><DT
       
    34 -><A
       
    35 -HREF="#CAPABILITIESENGINE"
       
    36 ->&#13;CapabilitiesEngine</A
       
    37 ->&nbsp;--&nbsp;Enable/disable mod_cap</DT
       
    38 -><DT
       
    39 -><A
       
    40 -HREF="#CAPABILITIESSET"
       
    41 ->&#13;CapabilitiesSet</A
       
    42 ->&nbsp;--&nbsp;Configure the set of Linux capabilities processed</DT
       
    43 -><DT
       
    44 -><A
       
    45  HREF="#CDPATH"
       
    46  >&#13;CDPath</A
       
    47  >&nbsp;--&nbsp;Sets "search paths" for the cd command</DT
       
    48 @@ -218,11 +196,6 @@
       
    49  >&nbsp;--&nbsp;Create and populate users' home directories as needed</DT
       
    50  ><DT
       
    51  ><A
       
    52 -HREF="#CWDRATIOMSG"
       
    53 ->&#13;CwdRatioMsg</A
       
    54 ->&nbsp;--&nbsp;Ratio directive</DT
       
    55 -><DT
       
    56 -><A
       
    57  HREF="#DEBUGLEVEL"
       
    58  >&#13;DebugLevel</A
       
    59  >&nbsp;--&nbsp;Set the debugging output level</DT
       
    60 @@ -364,21 +337,11 @@
       
    61  >&nbsp;--&nbsp;Set the file to display on quit</DT
       
    62  ><DT
       
    63  ><A
       
    64 -HREF="#DISPLAYREADME"
       
    65 ->&#13;DisplayReadme</A
       
    66 ->&nbsp;--&nbsp;Enable display of file modification times on a file pattern</DT
       
    67 -><DT
       
    68 -><A
       
    69  HREF="#EXTENDEDLOG"
       
    70  >&#13;ExtendedLog</A
       
    71  >&nbsp;--&nbsp;Specify custom logfiles</DT
       
    72  ><DT
       
    73  ><A
       
    74 -HREF="#FILERATIOERRMSG"
       
    75 ->&#13;FileRatioErrMsg</A
       
    76 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
    77 -><DT
       
    78 -><A
       
    79  HREF="#GLOBAL"
       
    80  >&#13;Global</A
       
    81  >&nbsp;--&nbsp;Set some directives to apply across the entire daemon</DT
       
    82 @@ -399,11 +362,6 @@
       
    83  >&nbsp;--&nbsp;Set a group-wide password</DT
       
    84  ><DT
       
    85  ><A
       
    86 -HREF="#GROUPRATIO"
       
    87 ->&#13;GroupRatio</A
       
    88 ->&nbsp;--&nbsp;Ratio directive</DT
       
    89 -><DT
       
    90 -><A
       
    91  HREF="#HIDDENSTOR"
       
    92  >&#13;HiddenStor</A
       
    93  >&nbsp;--&nbsp;Enables more safe file uploads [deprecated]</DT
       
    94 @@ -435,11 +393,6 @@
       
    95  >&nbsp;--&nbsp;Enable hiding of files based on user owner</DT
       
    96  ><DT
       
    97  ><A
       
    98 -HREF="#HOSTRATIO"
       
    99 ->&#13;HostRatio</A
       
   100 ->&nbsp;--&nbsp;Ratio directive</DT
       
   101 -><DT
       
   102 -><A
       
   103  HREF="#IDENTLOOKUPS"
       
   104  >&#13;IdentLookups</A
       
   105  >&nbsp;--&nbsp;Toggle ident lookups</DT
       
   106 @@ -465,170 +418,6 @@
       
   107  >&nbsp;--&nbsp;Load additional configuration directives from a file</DT
       
   108  ><DT
       
   109  ><A
       
   110 -HREF="#LDAPALIASDEREFERENCE"
       
   111 ->&#13;    LDAPAliasDereference</A
       
   112 ->&nbsp;--&nbsp;Specify how LDAP alias dereferencing is done</DT
       
   113 -><DT
       
   114 -><A
       
   115 -HREF="#LDAPATTR"
       
   116 ->&#13;LDAPAttr</A
       
   117 ->&nbsp;--&nbsp;Map LDAP Attributes to something non standard</DT
       
   118 -><DT
       
   119 -><A
       
   120 -HREF="#LDAPAUTHBINDS"
       
   121 ->&#13;			LDAPAuthBinds</A
       
   122 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   123 -><DT
       
   124 -><A
       
   125 -HREF="#LDAPDEFAULTAUTHSCHEME"
       
   126 ->&#13;			LDAPDefaultAuthScheme</A
       
   127 ->&nbsp;--&nbsp;			Set the authentication scheme/hash that is used when no leading
       
   128 -			{hashname} is present.
       
   129 -		</DT
       
   130 -><DT
       
   131 -><A
       
   132 -HREF="#LDAPDEFAULTGID"
       
   133 ->&#13;			LDAPDefaultGID</A
       
   134 ->&nbsp;--&nbsp;			Set the default GID to be assigned to users when no uidNumber
       
   135 -			attribute is found.
       
   136 -		</DT
       
   137 -><DT
       
   138 -><A
       
   139 -HREF="#LDAPDEFAULTUID"
       
   140 ->&#13;			LDAPDefaultUID</A
       
   141 ->&nbsp;--&nbsp;			Set the default UID to be assigned to users when no uidNumber
       
   142 -			attribute is found.
       
   143 -		</DT
       
   144 -><DT
       
   145 -><A
       
   146 -HREF="#LDAPDNINFO"
       
   147 ->&#13;			LDAPDNInfo</A
       
   148 ->&nbsp;--&nbsp;Set DN information to be used for initial bind</DT
       
   149 -><DT
       
   150 -><A
       
   151 -HREF="#LDAPDOAUTH"
       
   152 ->&#13;			LDAPDoAuth</A
       
   153 ->&nbsp;--&nbsp;Enable LDAP authentication</DT
       
   154 -><DT
       
   155 -><A
       
   156 -HREF="#LDAPDOGIDLOOKUPS"
       
   157 ->&#13;			LDAPDoGIDLookups</A
       
   158 ->&nbsp;--&nbsp;			Enable LDAP lookups for user group membership and GIDs in
       
   159 -			directory listings
       
   160 -		</DT
       
   161 -><DT
       
   162 -><A
       
   163 -HREF="#LDAPDOQUOTALOOKUPS"
       
   164 ->&#13;			LDAPDoQuotaLookups</A
       
   165 ->&nbsp;--&nbsp;Enable LDAP quota limit support</DT
       
   166 -><DT
       
   167 -><A
       
   168 -HREF="#LDAPDOUIDLOOKUPS"
       
   169 ->&#13;      LDAPDoUIDLookups</A
       
   170 ->&nbsp;--&nbsp;      Enable LDAP lookups for UIDs in directory listings
       
   171 -    </DT
       
   172 -><DT
       
   173 -><A
       
   174 -HREF="#LDAPFORCEDEFAULTGID"
       
   175 ->&#13;			LDAPForceDefaultGID</A
       
   176 ->&nbsp;--&nbsp;Force all LDAP-authenticated users to use the same GID.</DT
       
   177 -><DT
       
   178 -><A
       
   179 -HREF="#LDAPFORCEDEFAULTUID"
       
   180 ->&#13;			LDAPForceDefaultUID</A
       
   181 ->&nbsp;--&nbsp;Force all LDAP-authenticated users to use the same UID.</DT
       
   182 -><DT
       
   183 -><A
       
   184 -HREF="#LDAPFORCEGENERATEDHOMEDIR"
       
   185 ->&#13;      LDAPForceGeneratedHomedir</A
       
   186 ->&nbsp;--&nbsp;      Force all LDAP-authenticated users to use the default HomeDironDemand
       
   187 -      prefix/suffix.
       
   188 -    </DT
       
   189 -><DT
       
   190 -><A
       
   191 -HREF="#LDAPFORCEHOMEDIRONDEMAND"
       
   192 ->&#13;      LDAPForceHomedirOnDemand</A
       
   193 ->&nbsp;--&nbsp;      Force all LDAP-authenticated users to use the default HomeDironDemand
       
   194 -      prefix/suffix. [deprecated]
       
   195 -    </DT
       
   196 -><DT
       
   197 -><A
       
   198 -HREF="#LDAPGENERATEHOMEDIR"
       
   199 ->&#13;			LDAPGenerateHomedir</A
       
   200 ->&nbsp;--&nbsp;			Enable the creation of user home directories on demand
       
   201 -		</DT
       
   202 -><DT
       
   203 -><A
       
   204 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
   205 ->&#13;			LDAPGenerateHomedirPrefix</A
       
   206 ->&nbsp;--&nbsp;			Enable the creation of user home directories on demand
       
   207 -		</DT
       
   208 -><DT
       
   209 -><A
       
   210 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
   211 ->&#13;LDAPGenerateHomedirPrefixNoUsername</A
       
   212 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   213 -><DT
       
   214 -><A
       
   215 -HREF="#LDAPHOMEDIRONDEMAND"
       
   216 ->&#13;			LDAPHomedirOnDemand</A
       
   217 ->&nbsp;--&nbsp;			Enable the creation of user home directories on demand [deprecated]
       
   218 -		</DT
       
   219 -><DT
       
   220 -><A
       
   221 -HREF="#LDAPHOMEDIRONDEMANDPREFIX"
       
   222 ->&#13;			LDAPHomedirOnDemandPrefix</A
       
   223 ->&nbsp;--&nbsp;			Enable the creation of user home directories on demand [deprecated]
       
   224 -		</DT
       
   225 -><DT
       
   226 -><A
       
   227 -HREF="#LDAPHOMEDIRONDEMANDPREFIXNOUSERNAME"
       
   228 ->&#13;LDAPHomedirOnDemandPrefixNoUsername</A
       
   229 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   230 -><DT
       
   231 -><A
       
   232 -HREF="#LDAPHOMEDIRONDEMANDSUFFIX"
       
   233 ->&#13;			LDAPHomedirOnDemandSuffix</A
       
   234 ->&nbsp;--&nbsp;			Specify an additional directory to be created inside a user's
       
   235 -			home directory on demand. [deprecated]
       
   236 -		</DT
       
   237 -><DT
       
   238 -><A
       
   239 -HREF="#LDAPNEGATIVECACHE"
       
   240 ->&#13;			LDAPNegativeCache</A
       
   241 ->&nbsp;--&nbsp;Enable negative caching for LDAP lookups</DT
       
   242 -><DT
       
   243 -><A
       
   244 -HREF="#LDAPPROTOCOLVERSION"
       
   245 ->&#13;LDAPProtocolVersion</A
       
   246 ->&nbsp;--&nbsp;Set the LDAP protocol version</DT
       
   247 -><DT
       
   248 -><A
       
   249 -HREF="#LDAPQUERYTIMEOUT"
       
   250 ->&#13;			LDAPQueryTimeout</A
       
   251 ->&nbsp;--&nbsp;Set a timeout for LDAP queries</DT
       
   252 -><DT
       
   253 -><A
       
   254 -HREF="#LDAPSEARCHSCOPE"
       
   255 ->&#13;			LDAPSearchScope</A
       
   256 ->&nbsp;--&nbsp;Specify the search scope used in LDAP queries</DT
       
   257 -><DT
       
   258 -><A
       
   259 -HREF="#LDAPSERVER"
       
   260 ->&#13;			LDAPServer</A
       
   261 ->&nbsp;--&nbsp;Specify the LDAP server to use for lookups</DT
       
   262 -><DT
       
   263 -><A
       
   264 -HREF="#LDAPUSETLS"
       
   265 ->&#13;			LDAPUseTLS</A
       
   266 ->&nbsp;--&nbsp;Enable TLS/SSL connections to the LDAP server.</DT
       
   267 -><DT
       
   268 -><A
       
   269 -HREF="#LEECHRATIOMSG"
       
   270 ->&#13;LeechRatioMsg</A
       
   271 ->&nbsp;--&nbsp;Sets the 'over ratio' error message</DT
       
   272 -><DT
       
   273 -><A
       
   274  HREF="#LIMIT"
       
   275  >&#13;Limit</A
       
   276  >&nbsp;--&nbsp;Set the commands/actions to be controlled</DT
       
   277 @@ -749,86 +538,11 @@
       
   278  >&nbsp;--&nbsp;Set the port for the control socket</DT
       
   279  ><DT
       
   280  ><A
       
   281 -HREF="#RADIUSACCTSERVER"
       
   282 ->&#13;RadiusAcctServer</A
       
   283 ->&nbsp;--&nbsp;Setup RADIUS accounting details</DT
       
   284 -><DT
       
   285 -><A
       
   286 -HREF="#RADIUSAUTHSERVER"
       
   287 ->&#13;RadiusAuthServer</A
       
   288 ->&nbsp;--&nbsp;Setup RADIUS authenticator details</DT
       
   289 -><DT
       
   290 -><A
       
   291 -HREF="#RADIUSENGINE"
       
   292 ->&#13;RadiusEngine</A
       
   293 ->&nbsp;--&nbsp;Enable RADIUS support</DT
       
   294 -><DT
       
   295 -><A
       
   296 -HREF="#RADIUSLOG"
       
   297 ->&#13;RadiusLog</A
       
   298 ->&nbsp;--&nbsp;Specify the logfile for reporting / debugging</DT
       
   299 -><DT
       
   300 -><A
       
   301 -HREF="#RADIUSREALM"
       
   302 ->&#13;RadiusRealm</A
       
   303 ->&nbsp;--&nbsp;Setup the authentication realm</DT
       
   304 -><DT
       
   305 -><A
       
   306 -HREF="#RADIUSUSERINFO"
       
   307 ->&#13;RadiusUserInfo</A
       
   308 ->&nbsp;--&nbsp;Configure login information via RADIUS</DT
       
   309 -><DT
       
   310 -><A
       
   311 -HREF="#RATIOFILE"
       
   312 ->&#13;RatioFile</A
       
   313 ->&nbsp;--&nbsp;Ratio directive</DT
       
   314 -><DT
       
   315 -><A
       
   316 -HREF="#RATIOS"
       
   317 ->&#13;Ratios</A
       
   318 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   319 -><DT
       
   320 -><A
       
   321 -HREF="#RATIOTEMPFILE"
       
   322 ->&#13;RatioTempFile</A
       
   323 ->&nbsp;--&nbsp;Ratio directive</DT
       
   324 -><DT
       
   325 -><A
       
   326  HREF="#REQUIREVALIDSHELL"
       
   327  >&#13;RequireValidShell</A
       
   328  >&nbsp;--&nbsp;Allow connections based on /etc/shells</DT
       
   329  ><DT
       
   330  ><A
       
   331 -HREF="#REWRITECONDITION"
       
   332 ->&#13;RewriteCondition</A
       
   333 ->&nbsp;--&nbsp;Define a rule condition</DT
       
   334 -><DT
       
   335 -><A
       
   336 -HREF="#REWRITEENGINE"
       
   337 ->&#13;RewriteEngine</A
       
   338 ->&nbsp;--&nbsp;Enable/disable mod_rewrite</DT
       
   339 -><DT
       
   340 -><A
       
   341 -HREF="#REWRITELOCK"
       
   342 ->&#13;RewriteLock</A
       
   343 ->&nbsp;--&nbsp;Set the filename for synchronization lockfile</DT
       
   344 -><DT
       
   345 -><A
       
   346 -HREF="#REWRITELOG"
       
   347 ->&#13;RewriteLog</A
       
   348 ->&nbsp;--&nbsp;Specify a log file for mod_rewrite reporting</DT
       
   349 -><DT
       
   350 -><A
       
   351 -HREF="#REWRITEMAP"
       
   352 ->&#13;RewriteMap</A
       
   353 ->&nbsp;--&nbsp;Define a rewrite map</DT
       
   354 -><DT
       
   355 -><A
       
   356 -HREF="#REWRITERULE"
       
   357 ->&#13;RewriteRule</A
       
   358 ->&nbsp;--&nbsp;Define a rewrite rule</DT
       
   359 -><DT
       
   360 -><A
       
   361  HREF="#RLIMITCPU"
       
   362  >&#13;RLimitCPU</A
       
   363  >&nbsp;--&nbsp;Configure the maximum CPU time in seconds used by a process</DT
       
   364 @@ -854,11 +568,6 @@
       
   365  >&nbsp;--&nbsp;Drop root privileges completely</DT
       
   366  ><DT
       
   367  ><A
       
   368 -HREF="#SAVERATIOS"
       
   369 ->&#13;SaveRatios</A
       
   370 ->&nbsp;--&nbsp;FIXME FIXME</DT
       
   371 -><DT
       
   372 -><A
       
   373  HREF="#SCOREBOARDFILE"
       
   374  >&#13;ScoreboardFile</A
       
   375  >&nbsp;--&nbsp;Sets the name and path of the scoreboard file</DT
       
   376 @@ -891,7 +600,7 @@
       
   377  ><A
       
   378  HREF="#SETENV"
       
   379  >&#13;SetEnv</A
       
   380 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   381 +>&nbsp;--&nbsp;Set environment variable</DT
       
   382  ><DT
       
   383  ><A
       
   384  HREF="#SHOWSYMLINKS"
       
   385 @@ -909,131 +618,6 @@
       
   386  >&nbsp;--&nbsp;Tune socket-level options</DT
       
   387  ><DT
       
   388  ><A
       
   389 -HREF="#SQLAUTHENTICATE"
       
   390 ->&#13;    SQLAuthenticate</A
       
   391 ->&nbsp;--&nbsp;    Specify authentication methods and what to authenticate 
       
   392 -  </DT
       
   393 -><DD
       
   394 -><DL
       
   395 -><DT
       
   396 -><A
       
   397 -HREF="#AEN8505"
       
   398 ->Group Table Structure</A
       
   399 -></DT
       
   400 -></DL
       
   401 -></DD
       
   402 -><DT
       
   403 -><A
       
   404 -HREF="#SQLAUTHTYPES"
       
   405 ->&#13;SQLAuthTypes</A
       
   406 ->&nbsp;--&nbsp;Specify the allowed authentication types and their check order</DT
       
   407 -><DT
       
   408 -><A
       
   409 -HREF="#SQLBACKEND"
       
   410 ->&#13;SQLBackend</A
       
   411 ->&nbsp;--&nbsp;Set the SQL backend module</DT
       
   412 -><DT
       
   413 -><A
       
   414 -HREF="#SQLCONNECTINFO"
       
   415 ->&#13;SQLConnectInfo</A
       
   416 ->&nbsp;--&nbsp;Specify connection information for the backend</DT
       
   417 -><DT
       
   418 -><A
       
   419 -HREF="#SQLDEFAULTGID"
       
   420 ->&#13;SQLDefaultGID</A
       
   421 ->&nbsp;--&nbsp;Configure the default GID for users</DT
       
   422 -><DT
       
   423 -><A
       
   424 -HREF="#SQLDEFAULTHOMEDIR"
       
   425 ->&#13;SQLDefaultHomedir</A
       
   426 ->&nbsp;--&nbsp;Configure the default homedir</DT
       
   427 -><DT
       
   428 -><A
       
   429 -HREF="#SQLDEFAULTUID"
       
   430 ->&#13;SQLDefaultUID</A
       
   431 ->&nbsp;--&nbsp;Configure the default UID for users</DT
       
   432 -><DT
       
   433 -><A
       
   434 -HREF="#SQLENGINE"
       
   435 ->&#13;SQLEngine</A
       
   436 ->&nbsp;--&nbsp;Configure how mod_sql will operate</DT
       
   437 -><DT
       
   438 -><A
       
   439 -HREF="#SQLGROUPINFO"
       
   440 ->&#13;SQLGroupInfo</A
       
   441 ->&nbsp;--&nbsp;Configure the group table and fields that hold group information</DT
       
   442 -><DT
       
   443 -><A
       
   444 -HREF="#SQLGROUPWHERECLAUSE"
       
   445 ->&#13;SQLGroupWhereClause</A
       
   446 ->&nbsp;--&nbsp;Configure a WHERE clause for every group query</DT
       
   447 -><DT
       
   448 -><A
       
   449 -HREF="#SQLHOMEDIRONDEMAND"
       
   450 ->&#13;SQLHomedirOnDemand</A
       
   451 ->&nbsp;--&nbsp;Have mod_sql create home directories as needed [deprecated]</DT
       
   452 -><DT
       
   453 -><A
       
   454 -HREF="#SQLLOG"
       
   455 ->&#13;SQLLog</A
       
   456 ->&nbsp;--&nbsp;Log information to a database table</DT
       
   457 -><DT
       
   458 -><A
       
   459 -HREF="#SQLLOGFILE"
       
   460 ->&#13;SQLLogFile</A
       
   461 ->&nbsp;--&nbsp;Specify a log file for mod_sql reporting and debugging</DT
       
   462 -><DT
       
   463 -><A
       
   464 -HREF="#SQLMINID"
       
   465 ->&#13;SQLMinID</A
       
   466 ->&nbsp;--&nbsp;Set SQLMinUserGID and SQLMinUserID in one place</DT
       
   467 -><DT
       
   468 -><A
       
   469 -HREF="#SQLMINUSERGID"
       
   470 ->&#13;SQLMinUserGID</A
       
   471 ->&nbsp;--&nbsp;Set a minimum GID</DT
       
   472 -><DT
       
   473 -><A
       
   474 -HREF="#SQLMINUSERUID"
       
   475 ->&#13;SQLMinUserUID</A
       
   476 ->&nbsp;--&nbsp;Set a minimum UID</DT
       
   477 -><DT
       
   478 -><A
       
   479 -HREF="#SQLNAMEDQUERY"
       
   480 ->&#13;SQLNamedQuery</A
       
   481 ->&nbsp;--&nbsp;Specify a query and an identifier for SQLShowInfo and SQLLog</DT
       
   482 -><DT
       
   483 -><A
       
   484 -HREF="#SQLNEGATIVECACHE"
       
   485 ->&#13;			SQLNegativeCache</A
       
   486 ->&nbsp;--&nbsp;Enable negative caching for SQL lookups</DT
       
   487 -><DT
       
   488 -><A
       
   489 -HREF="#SQLRATIOS"
       
   490 ->&#13;SQLRatios</A
       
   491 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   492 -><DT
       
   493 -><A
       
   494 -HREF="#SQLRATIOSTATS"
       
   495 ->&#13;SQLRatioStats</A
       
   496 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   497 -><DT
       
   498 -><A
       
   499 -HREF="#SQLSHOWINFO"
       
   500 ->&#13;SQLShowInfo</A
       
   501 ->&nbsp;--&nbsp;Create a message to be sent to the user after any successful command</DT
       
   502 -><DT
       
   503 -><A
       
   504 -HREF="#SQLUSERINFO"
       
   505 ->&#13;SQLUserInfo</A
       
   506 ->&nbsp;--&nbsp;Configure the user table and fields that hold user information</DT
       
   507 -><DT
       
   508 -><A
       
   509 -HREF="#SQLUSERWHERECLAUSE"
       
   510 ->&#13;SQLUserWhereClause</A
       
   511 ->&nbsp;--&nbsp;Configure a WHERE clause for every user query&#60;</DT
       
   512 -><DT
       
   513 -><A
       
   514  HREF="#STOREUNIQUEPREFIX"
       
   515  >&#13;StoreUniquePrefix</A
       
   516  >&nbsp;--&nbsp;Set the prefix to be added to uniquely generated filenames</DT
       
   517 @@ -1186,7 +770,7 @@
       
   518  ><A
       
   519  HREF="#TLSPASSPHRASEPROVIDER"
       
   520  >&#13;TLSPassPhraseProvider</A
       
   521 ->&nbsp;--&nbsp;FIXFIXFIX</DT
       
   522 +>&nbsp;--&nbsp;Configure external provider for key</DT
       
   523  ><DT
       
   524  ><A
       
   525  HREF="#TLSPROTOCOL"
       
   526 @@ -1246,7 +830,7 @@
       
   527  ><A
       
   528  HREF="#UNSETENV"
       
   529  >&#13;UnsetEnv</A
       
   530 ->&nbsp;--&nbsp;(docs incomplete)</DT
       
   531 +>&nbsp;--&nbsp;Unset environment variable</DT
       
   532  ><DT
       
   533  ><A
       
   534  HREF="#USEFTPUSERS"
       
   535 @@ -1294,11 +878,6 @@
       
   536  >&nbsp;--&nbsp;Creates a hardcoded username/password pair</DT
       
   537  ><DT
       
   538  ><A
       
   539 -HREF="#USERRATIO"
       
   540 ->&#13;UserRatio</A
       
   541 ->&nbsp;--&nbsp;Ratio directive</DT
       
   542 -><DT
       
   543 -><A
       
   544  HREF="#USESENDFILE"
       
   545  >&#13;UseSendfile</A
       
   546  >&nbsp;--&nbsp;Toggles use of sendfile() functionality</DT
       
   547 @@ -1348,11 +927,6 @@
       
   548  >&nbsp;--&nbsp;Prevent information leak through timing attacks</DT
       
   549  ><DT
       
   550  ><A
       
   551 -HREF="#MOD-LDAP"
       
   552 ->&#13;			mod_ldap</A
       
   553 ->&nbsp;--&nbsp;LDAP authentication support</DT
       
   554 -><DT
       
   555 -><A
       
   556  HREF="#MOD-LOG"
       
   557  >&#13;mod_log</A
       
   558  >&nbsp;--&nbsp;Logging support</DT
       
   559 @@ -1363,31 +937,6 @@
       
   560  >&nbsp;--&nbsp;file listing functionality</DT
       
   561  ><DT
       
   562  ><A
       
   563 -HREF="#MOD-RADIUS"
       
   564 ->&#13;mod_radius</A
       
   565 ->&nbsp;--&nbsp;RADIUS based authentication support</DT
       
   566 -><DT
       
   567 -><A
       
   568 -HREF="#MOD-RATIO"
       
   569 ->&#13;mod_ratio</A
       
   570 ->&nbsp;--&nbsp;FIX ME FIX ME</DT
       
   571 -><DT
       
   572 -><A
       
   573 -HREF="#MOD-README"
       
   574 ->&#13;mod_readme</A
       
   575 ->&nbsp;--&nbsp;"README" file support</DT
       
   576 -><DT
       
   577 -><A
       
   578 -HREF="#AEN12975"
       
   579 -></A
       
   580 ->&nbsp;--&nbsp;</DT
       
   581 -><DT
       
   582 -><A
       
   583 -HREF="#MOD-SQL"
       
   584 ->&#13;mod_sql</A
       
   585 ->&nbsp;--&nbsp;SQL support module</DT
       
   586 -><DT
       
   587 -><A
       
   588  HREF="#MOD-TLS"
       
   589  >&#13;mod_tls</A
       
   590  >&nbsp;--&nbsp;TLS/SSL support module</DT
       
   591 @@ -1400,7 +949,7 @@
       
   592  ><A
       
   593  HREF="#MOD-XFER"
       
   594  >&#13;mod_xfer</A
       
   595 ->&nbsp;--&nbsp;FIX ME FIX ME</DT
       
   596 +>&nbsp;--&nbsp;control transfer</DT
       
   597  ></DL
       
   598  ></DD
       
   599  ><DT
       
   600 @@ -1465,26 +1014,6 @@
       
   601  ></DL
       
   602  ></DIV
       
   603  ><DIV
       
   604 -CLASS="LOT"
       
   605 -><DL
       
   606 -CLASS="LOT"
       
   607 -><DT
       
   608 -><B
       
   609 ->List of Examples</B
       
   610 -></DT
       
   611 -><DT
       
   612 ->1-1. <A
       
   613 -HREF="#EXAMPLE-USERMAP"
       
   614 ->Example Usermap</A
       
   615 -></DT
       
   616 -><DT
       
   617 ->1-2. <A
       
   618 -HREF="#EXAMPLE-FIFONAMEDPIPE"
       
   619 ->Example FIFO/Named Pipe 1:1 mapping</A
       
   620 -></DT
       
   621 -></DL
       
   622 -></DIV
       
   623 -><DIV
       
   624  CLASS="CHAPTER"
       
   625  ><HR><H1
       
   626  ><A
       
   627 @@ -3216,113 +2745,6 @@
       
   628  ></DIV
       
   629  ><H1
       
   630  ><A
       
   631 -NAME="ANONRATIO"
       
   632 -></A
       
   633 ->
       
   634 -AnonRatio</H1
       
   635 -><DIV
       
   636 -CLASS="REFNAMEDIV"
       
   637 -><A
       
   638 -NAME="AEN701"
       
   639 -></A
       
   640 -><H2
       
   641 ->Name</H2
       
   642 ->AnonRatio&nbsp;--&nbsp;Ratio directive</DIV
       
   643 -><DIV
       
   644 -CLASS="REFSYNOPSISDIV"
       
   645 -><A
       
   646 -NAME="AEN704"
       
   647 -></A
       
   648 -><H2
       
   649 ->Synopsis</H2
       
   650 -><P
       
   651 -><B
       
   652 -CLASS="COMMAND"
       
   653 ->AnonRatio</B
       
   654 ->  [  <CODE
       
   655 -CLASS="OPTION"
       
   656 ->foo1 foo2 foo3</CODE
       
   657 ->]</P
       
   658 -><P
       
   659 -></P
       
   660 -><DIV
       
   661 -CLASS="VARIABLELIST"
       
   662 -><P
       
   663 -><B
       
   664 -></B
       
   665 -></P
       
   666 -><DL
       
   667 -><DT
       
   668 -><PRE
       
   669 -CLASS="SYNOPSIS"
       
   670 ->Default</PRE
       
   671 -></DT
       
   672 -><DD
       
   673 -><P
       
   674 ->None known</P
       
   675 -></DD
       
   676 -><DT
       
   677 -><PRE
       
   678 -CLASS="SYNOPSIS"
       
   679 ->Context</PRE
       
   680 -></DT
       
   681 -><DD
       
   682 -><P
       
   683 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
   684 -></DD
       
   685 -><DT
       
   686 -><PRE
       
   687 -CLASS="SYNOPSIS"
       
   688 ->Module</PRE
       
   689 -></DT
       
   690 -><DD
       
   691 -><P
       
   692 ->mod_ratio</P
       
   693 -></DD
       
   694 -><DT
       
   695 -><PRE
       
   696 -CLASS="SYNOPSIS"
       
   697 ->Compatibility</PRE
       
   698 -></DT
       
   699 -><DD
       
   700 -><P
       
   701 ->at least 1.2.0 and later</P
       
   702 -></DD
       
   703 -></DL
       
   704 -></DIV
       
   705 -></DIV
       
   706 -><DIV
       
   707 -CLASS="REFSECT1"
       
   708 -><A
       
   709 -NAME="AEN731"
       
   710 -></A
       
   711 -><H2
       
   712 ->Description</H2
       
   713 -><P
       
   714 ->The AnonRatio directive ....</P
       
   715 -></DIV
       
   716 -><DIV
       
   717 -CLASS="REFSECT1"
       
   718 -><A
       
   719 -NAME="AEN734"
       
   720 -></A
       
   721 -><H2
       
   722 ->See also</H2
       
   723 -><P
       
   724 ->AnonRatio</P
       
   725 -></DIV
       
   726 -><DIV
       
   727 -CLASS="REFSECT1"
       
   728 -><A
       
   729 -NAME="AEN737"
       
   730 -></A
       
   731 -><H2
       
   732 ->Examples</H2
       
   733 -><P
       
   734 -></P
       
   735 -></DIV
       
   736 -><H1
       
   737 -><A
       
   738  NAME="ANONREJECTPASSWORDS"
       
   739  ></A
       
   740  >
       
   741 @@ -4845,320 +4267,6 @@
       
   742  ></DIV
       
   743  ><H1
       
   744  ><A
       
   745 -NAME="BYTERATIOERRMSG"
       
   746 -></A
       
   747 ->
       
   748 -ByteRatioErrMsg</H1
       
   749 -><DIV
       
   750 -CLASS="REFNAMEDIV"
       
   751 -><A
       
   752 -NAME="AEN1336"
       
   753 -></A
       
   754 -><H2
       
   755 ->Name</H2
       
   756 ->ByteRatioErrMsg&nbsp;--&nbsp;Ratio directive</DIV
       
   757 -><DIV
       
   758 -CLASS="REFSYNOPSISDIV"
       
   759 -><A
       
   760 -NAME="AEN1339"
       
   761 -></A
       
   762 -><H2
       
   763 ->Synopsis</H2
       
   764 -><P
       
   765 -><B
       
   766 -CLASS="COMMAND"
       
   767 ->ByteRatioErrMsg</B
       
   768 ->  [  <CODE
       
   769 -CLASS="OPTION"
       
   770 ->foo1 foo2 foo3</CODE
       
   771 ->]</P
       
   772 -><P
       
   773 -></P
       
   774 -><DIV
       
   775 -CLASS="VARIABLELIST"
       
   776 -><P
       
   777 -><B
       
   778 -></B
       
   779 -></P
       
   780 -><DL
       
   781 -><DT
       
   782 -><PRE
       
   783 -CLASS="SYNOPSIS"
       
   784 ->Default</PRE
       
   785 -></DT
       
   786 -><DD
       
   787 -><P
       
   788 ->None known</P
       
   789 -></DD
       
   790 -><DT
       
   791 -><PRE
       
   792 -CLASS="SYNOPSIS"
       
   793 ->Context</PRE
       
   794 -></DT
       
   795 -><DD
       
   796 -><P
       
   797 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
   798 -></DD
       
   799 -><DT
       
   800 -><PRE
       
   801 -CLASS="SYNOPSIS"
       
   802 ->Module</PRE
       
   803 -></DT
       
   804 -><DD
       
   805 -><P
       
   806 ->mod_ratio</P
       
   807 -></DD
       
   808 -><DT
       
   809 -><PRE
       
   810 -CLASS="SYNOPSIS"
       
   811 ->Compatibility</PRE
       
   812 -></DT
       
   813 -><DD
       
   814 -><P
       
   815 ->at least 1.2.0 and later</P
       
   816 -></DD
       
   817 -></DL
       
   818 -></DIV
       
   819 -></DIV
       
   820 -><DIV
       
   821 -CLASS="REFSECT1"
       
   822 -><A
       
   823 -NAME="AEN1366"
       
   824 -></A
       
   825 -><H2
       
   826 ->Description</H2
       
   827 -><P
       
   828 ->The ByteRatioErrMsg directive ....
       
   829 -Example:
       
   830 -ByteRatioErrMsg</P
       
   831 -></DIV
       
   832 -><DIV
       
   833 -CLASS="REFSECT1"
       
   834 -><A
       
   835 -NAME="AEN1369"
       
   836 -></A
       
   837 -><H2
       
   838 ->See also</H2
       
   839 -><P
       
   840 -></P
       
   841 -></DIV
       
   842 -><DIV
       
   843 -CLASS="REFSECT1"
       
   844 -><A
       
   845 -NAME="AEN1372"
       
   846 -></A
       
   847 -><H2
       
   848 ->Examples</H2
       
   849 -><P
       
   850 -></P
       
   851 -></DIV
       
   852 -><H1
       
   853 -><A
       
   854 -NAME="CAPABILITIESENGINE"
       
   855 -></A
       
   856 ->
       
   857 -CapabilitiesEngine</H1
       
   858 -><DIV
       
   859 -CLASS="REFNAMEDIV"
       
   860 -><A
       
   861 -NAME="AEN1383"
       
   862 -></A
       
   863 -><H2
       
   864 ->Name</H2
       
   865 ->CapabilitiesEngine&nbsp;--&nbsp;Enable/disable mod_cap</DIV
       
   866 -><DIV
       
   867 -CLASS="REFSYNOPSISDIV"
       
   868 -><A
       
   869 -NAME="AEN1386"
       
   870 -></A
       
   871 -><H2
       
   872 ->Synopsis</H2
       
   873 -><P
       
   874 -><B
       
   875 -CLASS="COMMAND"
       
   876 ->CapabilitiesEngine</B
       
   877 ->  [  <CODE
       
   878 -CLASS="OPTION"
       
   879 ->on</CODE
       
   880 ->
       
   881 -  <CODE
       
   882 -CLASS="OPTION"
       
   883 ->off</CODE
       
   884 ->]</P
       
   885 -><P
       
   886 -></P
       
   887 -><DIV
       
   888 -CLASS="VARIABLELIST"
       
   889 -><P
       
   890 -><B
       
   891 -></B
       
   892 -></P
       
   893 -><DL
       
   894 -><DT
       
   895 -><PRE
       
   896 -CLASS="SYNOPSIS"
       
   897 ->Default</PRE
       
   898 -></DT
       
   899 -><DD
       
   900 -><P
       
   901 ->CapabilitiesEngine On, if running on a Linux hosts that supports capabilities</P
       
   902 -></DD
       
   903 -><DT
       
   904 -><PRE
       
   905 -CLASS="SYNOPSIS"
       
   906 ->Context</PRE
       
   907 -></DT
       
   908 -><DD
       
   909 -><P
       
   910 ->server config, &lt;VirtualHost&gt;, &lt;Global&gt;</P
       
   911 -></DD
       
   912 -><DT
       
   913 -><PRE
       
   914 -CLASS="SYNOPSIS"
       
   915 ->Module</PRE
       
   916 -></DT
       
   917 -><DD
       
   918 -><P
       
   919 ->mod_cap</P
       
   920 -></DD
       
   921 -><DT
       
   922 -><PRE
       
   923 -CLASS="SYNOPSIS"
       
   924 ->Compatibility</PRE
       
   925 -></DT
       
   926 -><DD
       
   927 -><P
       
   928 ->1.2.8rc1 and later</P
       
   929 -></DD
       
   930 -></DL
       
   931 -></DIV
       
   932 -></DIV
       
   933 -><DIV
       
   934 -CLASS="REFSECT1"
       
   935 -><A
       
   936 -NAME="AEN1414"
       
   937 -></A
       
   938 -><H2
       
   939 ->Description</H2
       
   940 -><P
       
   941 ->The CapabilitiesEngine directive enables or disables the module's
       
   942 -  runtime capabilities engine. If set to off, this module does no runtime
       
   943 -  capabilities processing at all. Use this directive to disable the
       
   944 -  module.</P
       
   945 -></DIV
       
   946 -><H1
       
   947 -><A
       
   948 -NAME="CAPABILITIESSET"
       
   949 -></A
       
   950 ->
       
   951 -CapabilitiesSet</H1
       
   952 -><DIV
       
   953 -CLASS="REFNAMEDIV"
       
   954 -><A
       
   955 -NAME="AEN1425"
       
   956 -></A
       
   957 -><H2
       
   958 ->Name</H2
       
   959 ->CapabilitiesSet&nbsp;--&nbsp;Configure the set of Linux capabilities processed</DIV
       
   960 -><DIV
       
   961 -CLASS="REFSYNOPSISDIV"
       
   962 -><A
       
   963 -NAME="AEN1428"
       
   964 -></A
       
   965 -><H2
       
   966 ->Synopsis</H2
       
   967 -><P
       
   968 -><B
       
   969 -CLASS="COMMAND"
       
   970 ->CapabilitiesSet</B
       
   971 ->  [  <CODE
       
   972 -CLASS="OPTION"
       
   973 ->[+/-]capability</CODE
       
   974 ->...]</P
       
   975 -><P
       
   976 -></P
       
   977 -><DIV
       
   978 -CLASS="VARIABLELIST"
       
   979 -><P
       
   980 -><B
       
   981 -></B
       
   982 -></P
       
   983 -><DL
       
   984 -><DT
       
   985 -><PRE
       
   986 -CLASS="SYNOPSIS"
       
   987 ->Default</PRE
       
   988 -></DT
       
   989 -><DD
       
   990 -><P
       
   991 ->CapabilitiesSet +CAP_CHOWN</P
       
   992 -></DD
       
   993 -><DT
       
   994 -><PRE
       
   995 -CLASS="SYNOPSIS"
       
   996 ->Context</PRE
       
   997 -></DT
       
   998 -><DD
       
   999 -><P
       
  1000 ->server config, &lt;VirtualHost&gt;, &lt;Global&gt;</P
       
  1001 -></DD
       
  1002 -><DT
       
  1003 -><PRE
       
  1004 -CLASS="SYNOPSIS"
       
  1005 ->Module</PRE
       
  1006 -></DT
       
  1007 -><DD
       
  1008 -><P
       
  1009 ->mod_cap</P
       
  1010 -></DD
       
  1011 -><DT
       
  1012 -><PRE
       
  1013 -CLASS="SYNOPSIS"
       
  1014 ->Compatibility</PRE
       
  1015 -></DT
       
  1016 -><DD
       
  1017 -><P
       
  1018 ->1.2.8rc1 and later</P
       
  1019 -></DD
       
  1020 -></DL
       
  1021 -></DIV
       
  1022 -></DIV
       
  1023 -><DIV
       
  1024 -CLASS="REFSECT1"
       
  1025 -><A
       
  1026 -NAME="AEN1455"
       
  1027 -></A
       
  1028 -><H2
       
  1029 ->Description</H2
       
  1030 -><P
       
  1031 ->By default, mod_cap removes all but two capabilities from the
       
  1032 -  session-handling process: CAP_NET_BIND_SERVICE, for binding to ports lower
       
  1033 -  than 1024 (required for active data transfers), and CAP_CHOWN, for
       
  1034 -  allowing a process to change a file's ownership to a different user. The
       
  1035 -  latter capability is only strictly necessary if the UserOwner
       
  1036 -  configuration directive is in use; if not being used, the CAP_CHOWN
       
  1037 -  capability is best removed. The CapabilitiesSet directive is used to
       
  1038 -  manipulate the set of capabilities that mod_cap grants.</P
       
  1039 -><P
       
  1040 ->To remove a capability, prefix the name with a '-'; to enable a
       
  1041 -  capability, use '+'. At present, this directive only supports one
       
  1042 -  capability: CAP_CHOWN.</P
       
  1043 -></DIV
       
  1044 -><DIV
       
  1045 -CLASS="REFSECT1"
       
  1046 -><A
       
  1047 -NAME="AEN1459"
       
  1048 -></A
       
  1049 -><H2
       
  1050 ->Example</H2
       
  1051 -><P
       
  1052 ->  &lt;IfModule mod_cap.c&gt;
       
  1053 -    CapabilitiesEngine on
       
  1054 -    CapabilitiesSet -CAP_CHOWN
       
  1055 -  &lt;/IfModule&gt;</P
       
  1056 -></DIV
       
  1057 -><H1
       
  1058 -><A
       
  1059  NAME="CDPATH"
       
  1060  ></A
       
  1061  >
       
  1062 @@ -5781,115 +4889,6 @@
       
  1063  ></DIV
       
  1064  ><H1
       
  1065  ><A
       
  1066 -NAME="CWDRATIOMSG"
       
  1067 -></A
       
  1068 ->
       
  1069 -CwdRatioMsg</H1
       
  1070 -><DIV
       
  1071 -CLASS="REFNAMEDIV"
       
  1072 -><A
       
  1073 -NAME="AEN1720"
       
  1074 -></A
       
  1075 -><H2
       
  1076 ->Name</H2
       
  1077 ->CwdRatioMsg&nbsp;--&nbsp;Ratio directive</DIV
       
  1078 -><DIV
       
  1079 -CLASS="REFSYNOPSISDIV"
       
  1080 -><A
       
  1081 -NAME="AEN1723"
       
  1082 -></A
       
  1083 -><H2
       
  1084 ->Synopsis</H2
       
  1085 -><P
       
  1086 -><B
       
  1087 -CLASS="COMMAND"
       
  1088 ->CwdRatioMsg</B
       
  1089 ->  [  <CODE
       
  1090 -CLASS="OPTION"
       
  1091 ->foo1 foo2 foo3</CODE
       
  1092 ->]</P
       
  1093 -><P
       
  1094 -></P
       
  1095 -><DIV
       
  1096 -CLASS="VARIABLELIST"
       
  1097 -><P
       
  1098 -><B
       
  1099 -></B
       
  1100 -></P
       
  1101 -><DL
       
  1102 -><DT
       
  1103 -><PRE
       
  1104 -CLASS="SYNOPSIS"
       
  1105 ->Default</PRE
       
  1106 -></DT
       
  1107 -><DD
       
  1108 -><P
       
  1109 ->None known</P
       
  1110 -></DD
       
  1111 -><DT
       
  1112 -><PRE
       
  1113 -CLASS="SYNOPSIS"
       
  1114 ->Context</PRE
       
  1115 -></DT
       
  1116 -><DD
       
  1117 -><P
       
  1118 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  1119 -></DD
       
  1120 -><DT
       
  1121 -><PRE
       
  1122 -CLASS="SYNOPSIS"
       
  1123 ->Module</PRE
       
  1124 -></DT
       
  1125 -><DD
       
  1126 -><P
       
  1127 ->mod_ratio</P
       
  1128 -></DD
       
  1129 -><DT
       
  1130 -><PRE
       
  1131 -CLASS="SYNOPSIS"
       
  1132 ->Compatibility</PRE
       
  1133 -></DT
       
  1134 -><DD
       
  1135 -><P
       
  1136 ->at least 1.2.0 and later</P
       
  1137 -></DD
       
  1138 -></DL
       
  1139 -></DIV
       
  1140 -></DIV
       
  1141 -><DIV
       
  1142 -CLASS="REFSECT1"
       
  1143 -><A
       
  1144 -NAME="AEN1750"
       
  1145 -></A
       
  1146 -><H2
       
  1147 ->Description</H2
       
  1148 -><P
       
  1149 ->The CwdRatioMsg directive ....
       
  1150 -Example:
       
  1151 -CwdRatioMsg</P
       
  1152 -></DIV
       
  1153 -><DIV
       
  1154 -CLASS="REFSECT1"
       
  1155 -><A
       
  1156 -NAME="AEN1753"
       
  1157 -></A
       
  1158 -><H2
       
  1159 ->See also</H2
       
  1160 -><P
       
  1161 -></P
       
  1162 -></DIV
       
  1163 -><DIV
       
  1164 -CLASS="REFSECT1"
       
  1165 -><A
       
  1166 -NAME="AEN1756"
       
  1167 -></A
       
  1168 -><H2
       
  1169 ->Examples</H2
       
  1170 -><P
       
  1171 -></P
       
  1172 -></DIV
       
  1173 -><H1
       
  1174 -><A
       
  1175  NAME="DEBUGLEVEL"
       
  1176  ></A
       
  1177  >
       
  1178 @@ -9452,128 +8451,6 @@
       
  1179  ></DIV
       
  1180  ><H1
       
  1181  ><A
       
  1182 -NAME="DISPLAYREADME"
       
  1183 -></A
       
  1184 ->
       
  1185 -DisplayReadme</H1
       
  1186 -><DIV
       
  1187 -CLASS="REFNAMEDIV"
       
  1188 -><A
       
  1189 -NAME="AEN3148"
       
  1190 -></A
       
  1191 -><H2
       
  1192 ->Name</H2
       
  1193 ->DisplayReadme&nbsp;--&nbsp;Enable display of file modification times on a file pattern</DIV
       
  1194 -><DIV
       
  1195 -CLASS="REFSYNOPSISDIV"
       
  1196 -><A
       
  1197 -NAME="AEN3151"
       
  1198 -></A
       
  1199 -><H2
       
  1200 ->Synopsis</H2
       
  1201 -><P
       
  1202 -><B
       
  1203 -CLASS="COMMAND"
       
  1204 ->DisplayReadme</B
       
  1205 ->  [  <CODE
       
  1206 -CLASS="OPTION"
       
  1207 ->DisplayReadme filename or pattern</CODE
       
  1208 ->]</P
       
  1209 -><P
       
  1210 -></P
       
  1211 -><DIV
       
  1212 -CLASS="VARIABLELIST"
       
  1213 -><P
       
  1214 -><B
       
  1215 -></B
       
  1216 -></P
       
  1217 -><DL
       
  1218 -><DT
       
  1219 -><PRE
       
  1220 -CLASS="SYNOPSIS"
       
  1221 ->Default</PRE
       
  1222 -></DT
       
  1223 -><DD
       
  1224 -><P
       
  1225 ->None</P
       
  1226 -></DD
       
  1227 -><DT
       
  1228 -><PRE
       
  1229 -CLASS="SYNOPSIS"
       
  1230 ->Context</PRE
       
  1231 -></DT
       
  1232 -><DD
       
  1233 -><P
       
  1234 ->server config, &lt;VirtualHost&gt;, &lt;Anonymous&gt;, &lt;Global&gt;</P
       
  1235 -></DD
       
  1236 -><DT
       
  1237 -><PRE
       
  1238 -CLASS="SYNOPSIS"
       
  1239 ->Module</PRE
       
  1240 -></DT
       
  1241 -><DD
       
  1242 -><P
       
  1243 ->mod_readme</P
       
  1244 -></DD
       
  1245 -><DT
       
  1246 -><PRE
       
  1247 -CLASS="SYNOPSIS"
       
  1248 ->Compatibility</PRE
       
  1249 -></DT
       
  1250 -><DD
       
  1251 -><P
       
  1252 ->1.2.0pre8 and later</P
       
  1253 -></DD
       
  1254 -></DL
       
  1255 -></DIV
       
  1256 -></DIV
       
  1257 -><DIV
       
  1258 -CLASS="REFSECT1"
       
  1259 -><A
       
  1260 -NAME="AEN3178"
       
  1261 -></A
       
  1262 -><H2
       
  1263 ->Description</H2
       
  1264 -><P
       
  1265 ->Module: mod_readme
       
  1266 -The DisplayReadme directive notifies the user of the last change date of the 
       
  1267 -specified file or pattern. Only a single DisplayReadme directive is allowed per configuration 
       
  1268 -scope. 
       
  1269 -DisplayReadme README
       
  1270 -Will result in:
       
  1271 -Please read the file README it was last modified on Sun Oct 17 10:36:14 
       
  1272 -1999 - 0 days ago 
       
  1273 -Being displayed to the user on a cwd. 
       
  1274 -DisplayReadmePattern README*
       
  1275 -Will result in:
       
  1276 -Please read the file README
       
  1277 -it was last modified on Tue Jan 25 04:47:48 2000 - 0 days ago
       
  1278 -Please read the file README.first
       
  1279 -it was last modified on Tue Jan 25 04:48:04 2000 - 0 days ago
       
  1280 -Being displayed to the user on a cwd. </P
       
  1281 -></DIV
       
  1282 -><DIV
       
  1283 -CLASS="REFSECT1"
       
  1284 -><A
       
  1285 -NAME="AEN3181"
       
  1286 -></A
       
  1287 -><H2
       
  1288 ->See also</H2
       
  1289 -><P
       
  1290 -></P
       
  1291 -></DIV
       
  1292 -><DIV
       
  1293 -CLASS="REFSECT1"
       
  1294 -><A
       
  1295 -NAME="AEN3184"
       
  1296 -></A
       
  1297 -><H2
       
  1298 ->Examples</H2
       
  1299 -><P
       
  1300 -></P
       
  1301 -></DIV
       
  1302 -><H1
       
  1303 -><A
       
  1304  NAME="EXTENDEDLOG"
       
  1305  ></A
       
  1306  >
       
  1307 @@ -9733,115 +8610,6 @@
       
  1308  ></DIV
       
  1309  ><H1
       
  1310  ><A
       
  1311 -NAME="FILERATIOERRMSG"
       
  1312 -></A
       
  1313 ->
       
  1314 -FileRatioErrMsg</H1
       
  1315 -><DIV
       
  1316 -CLASS="REFNAMEDIV"
       
  1317 -><A
       
  1318 -NAME="AEN3249"
       
  1319 -></A
       
  1320 -><H2
       
  1321 ->Name</H2
       
  1322 ->FileRatioErrMsg&nbsp;--&nbsp;(docs incomplete)</DIV
       
  1323 -><DIV
       
  1324 -CLASS="REFSYNOPSISDIV"
       
  1325 -><A
       
  1326 -NAME="AEN3252"
       
  1327 -></A
       
  1328 -><H2
       
  1329 ->Synopsis</H2
       
  1330 -><P
       
  1331 -><B
       
  1332 -CLASS="COMMAND"
       
  1333 ->FileRatioErrMsg</B
       
  1334 ->  [  <CODE
       
  1335 -CLASS="OPTION"
       
  1336 ->FileRatioErrMsg foo1 foo2 foo3</CODE
       
  1337 ->]</P
       
  1338 -><P
       
  1339 -></P
       
  1340 -><DIV
       
  1341 -CLASS="VARIABLELIST"
       
  1342 -><P
       
  1343 -><B
       
  1344 -></B
       
  1345 -></P
       
  1346 -><DL
       
  1347 -><DT
       
  1348 -><PRE
       
  1349 -CLASS="SYNOPSIS"
       
  1350 ->Default</PRE
       
  1351 -></DT
       
  1352 -><DD
       
  1353 -><P
       
  1354 ->None known</P
       
  1355 -></DD
       
  1356 -><DT
       
  1357 -><PRE
       
  1358 -CLASS="SYNOPSIS"
       
  1359 ->Context</PRE
       
  1360 -></DT
       
  1361 -><DD
       
  1362 -><P
       
  1363 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  1364 -></DD
       
  1365 -><DT
       
  1366 -><PRE
       
  1367 -CLASS="SYNOPSIS"
       
  1368 ->Module</PRE
       
  1369 -></DT
       
  1370 -><DD
       
  1371 -><P
       
  1372 ->mod_ratio</P
       
  1373 -></DD
       
  1374 -><DT
       
  1375 -><PRE
       
  1376 -CLASS="SYNOPSIS"
       
  1377 ->Compatibility</PRE
       
  1378 -></DT
       
  1379 -><DD
       
  1380 -><P
       
  1381 ->at least 1.2.0 and later</P
       
  1382 -></DD
       
  1383 -></DL
       
  1384 -></DIV
       
  1385 -></DIV
       
  1386 -><DIV
       
  1387 -CLASS="REFSECT1"
       
  1388 -><A
       
  1389 -NAME="AEN3279"
       
  1390 -></A
       
  1391 -><H2
       
  1392 ->Description</H2
       
  1393 -><P
       
  1394 ->The FileRatioErrMsg directive ....
       
  1395 -Example:
       
  1396 -FileRatioErrMsg</P
       
  1397 -></DIV
       
  1398 -><DIV
       
  1399 -CLASS="REFSECT1"
       
  1400 -><A
       
  1401 -NAME="AEN3282"
       
  1402 -></A
       
  1403 -><H2
       
  1404 ->See also</H2
       
  1405 -><P
       
  1406 -></P
       
  1407 -></DIV
       
  1408 -><DIV
       
  1409 -CLASS="REFSECT1"
       
  1410 -><A
       
  1411 -NAME="AEN3285"
       
  1412 -></A
       
  1413 -><H2
       
  1414 ->Examples</H2
       
  1415 -><P
       
  1416 -></P
       
  1417 -></DIV
       
  1418 -><H1
       
  1419 -><A
       
  1420  NAME="GLOBAL"
       
  1421  ></A
       
  1422  >
       
  1423 @@ -10297,115 +9065,6 @@
       
  1424  ></DIV
       
  1425  ><H1
       
  1426  ><A
       
  1427 -NAME="GROUPRATIO"
       
  1428 -></A
       
  1429 ->
       
  1430 -GroupRatio</H1
       
  1431 -><DIV
       
  1432 -CLASS="REFNAMEDIV"
       
  1433 -><A
       
  1434 -NAME="AEN3486"
       
  1435 -></A
       
  1436 -><H2
       
  1437 ->Name</H2
       
  1438 ->GroupRatio&nbsp;--&nbsp;Ratio directive</DIV
       
  1439 -><DIV
       
  1440 -CLASS="REFSYNOPSISDIV"
       
  1441 -><A
       
  1442 -NAME="AEN3489"
       
  1443 -></A
       
  1444 -><H2
       
  1445 ->Synopsis</H2
       
  1446 -><P
       
  1447 -><B
       
  1448 -CLASS="COMMAND"
       
  1449 ->GroupRatio</B
       
  1450 ->  [  <CODE
       
  1451 -CLASS="OPTION"
       
  1452 ->GroupRatio foo1 foo2 foo3</CODE
       
  1453 ->]</P
       
  1454 -><P
       
  1455 -></P
       
  1456 -><DIV
       
  1457 -CLASS="VARIABLELIST"
       
  1458 -><P
       
  1459 -><B
       
  1460 -></B
       
  1461 -></P
       
  1462 -><DL
       
  1463 -><DT
       
  1464 -><PRE
       
  1465 -CLASS="SYNOPSIS"
       
  1466 ->Default</PRE
       
  1467 -></DT
       
  1468 -><DD
       
  1469 -><P
       
  1470 ->None known</P
       
  1471 -></DD
       
  1472 -><DT
       
  1473 -><PRE
       
  1474 -CLASS="SYNOPSIS"
       
  1475 ->Context</PRE
       
  1476 -></DT
       
  1477 -><DD
       
  1478 -><P
       
  1479 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  1480 -></DD
       
  1481 -><DT
       
  1482 -><PRE
       
  1483 -CLASS="SYNOPSIS"
       
  1484 ->Module</PRE
       
  1485 -></DT
       
  1486 -><DD
       
  1487 -><P
       
  1488 ->mod_ratio</P
       
  1489 -></DD
       
  1490 -><DT
       
  1491 -><PRE
       
  1492 -CLASS="SYNOPSIS"
       
  1493 ->Compatibility</PRE
       
  1494 -></DT
       
  1495 -><DD
       
  1496 -><P
       
  1497 ->at least 1.2.0 and later</P
       
  1498 -></DD
       
  1499 -></DL
       
  1500 -></DIV
       
  1501 -></DIV
       
  1502 -><DIV
       
  1503 -CLASS="REFSECT1"
       
  1504 -><A
       
  1505 -NAME="AEN3516"
       
  1506 -></A
       
  1507 -><H2
       
  1508 ->Description</H2
       
  1509 -><P
       
  1510 ->The GroupRatio directive ....
       
  1511 -Example:
       
  1512 -GroupRatio</P
       
  1513 -></DIV
       
  1514 -><DIV
       
  1515 -CLASS="REFSECT1"
       
  1516 -><A
       
  1517 -NAME="AEN3519"
       
  1518 -></A
       
  1519 -><H2
       
  1520 ->See also</H2
       
  1521 -><P
       
  1522 -></P
       
  1523 -></DIV
       
  1524 -><DIV
       
  1525 -CLASS="REFSECT1"
       
  1526 -><A
       
  1527 -NAME="AEN3522"
       
  1528 -></A
       
  1529 -><H2
       
  1530 ->Examples</H2
       
  1531 -><P
       
  1532 -></P
       
  1533 -></DIV
       
  1534 -><H1
       
  1535 -><A
       
  1536  NAME="HIDDENSTOR"
       
  1537  ></A
       
  1538  >
       
  1539 @@ -11103,115 +9762,6 @@
       
  1540  ></DIV
       
  1541  ><H1
       
  1542  ><A
       
  1543 -NAME="HOSTRATIO"
       
  1544 -></A
       
  1545 ->
       
  1546 -HostRatio</H1
       
  1547 -><DIV
       
  1548 -CLASS="REFNAMEDIV"
       
  1549 -><A
       
  1550 -NAME="AEN3817"
       
  1551 -></A
       
  1552 -><H2
       
  1553 ->Name</H2
       
  1554 ->HostRatio&nbsp;--&nbsp;Ratio directive</DIV
       
  1555 -><DIV
       
  1556 -CLASS="REFSYNOPSISDIV"
       
  1557 -><A
       
  1558 -NAME="AEN3820"
       
  1559 -></A
       
  1560 -><H2
       
  1561 ->Synopsis</H2
       
  1562 -><P
       
  1563 -><B
       
  1564 -CLASS="COMMAND"
       
  1565 ->HostRatio</B
       
  1566 ->  [  <CODE
       
  1567 -CLASS="OPTION"
       
  1568 ->HostRatio foo1 foo2 foo3</CODE
       
  1569 ->]</P
       
  1570 -><P
       
  1571 -></P
       
  1572 -><DIV
       
  1573 -CLASS="VARIABLELIST"
       
  1574 -><P
       
  1575 -><B
       
  1576 -></B
       
  1577 -></P
       
  1578 -><DL
       
  1579 -><DT
       
  1580 -><PRE
       
  1581 -CLASS="SYNOPSIS"
       
  1582 ->Default</PRE
       
  1583 -></DT
       
  1584 -><DD
       
  1585 -><P
       
  1586 ->None known</P
       
  1587 -></DD
       
  1588 -><DT
       
  1589 -><PRE
       
  1590 -CLASS="SYNOPSIS"
       
  1591 ->Context</PRE
       
  1592 -></DT
       
  1593 -><DD
       
  1594 -><P
       
  1595 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  1596 -></DD
       
  1597 -><DT
       
  1598 -><PRE
       
  1599 -CLASS="SYNOPSIS"
       
  1600 ->Module</PRE
       
  1601 -></DT
       
  1602 -><DD
       
  1603 -><P
       
  1604 ->mod_ratio</P
       
  1605 -></DD
       
  1606 -><DT
       
  1607 -><PRE
       
  1608 -CLASS="SYNOPSIS"
       
  1609 ->Compatibility</PRE
       
  1610 -></DT
       
  1611 -><DD
       
  1612 -><P
       
  1613 ->at least 1.2.0 and later</P
       
  1614 -></DD
       
  1615 -></DL
       
  1616 -></DIV
       
  1617 -></DIV
       
  1618 -><DIV
       
  1619 -CLASS="REFSECT1"
       
  1620 -><A
       
  1621 -NAME="AEN3847"
       
  1622 -></A
       
  1623 -><H2
       
  1624 ->Description</H2
       
  1625 -><P
       
  1626 ->The HostRatio directive ....
       
  1627 -Example:
       
  1628 -HostRatio</P
       
  1629 -></DIV
       
  1630 -><DIV
       
  1631 -CLASS="REFSECT1"
       
  1632 -><A
       
  1633 -NAME="AEN3850"
       
  1634 -></A
       
  1635 -><H2
       
  1636 ->See also</H2
       
  1637 -><P
       
  1638 -></P
       
  1639 -></DIV
       
  1640 -><DIV
       
  1641 -CLASS="REFSECT1"
       
  1642 -><A
       
  1643 -NAME="AEN3853"
       
  1644 -></A
       
  1645 -><H2
       
  1646 ->Examples</H2
       
  1647 -><P
       
  1648 -></P
       
  1649 -></DIV
       
  1650 -><H1
       
  1651 -><A
       
  1652  NAME="IDENTLOOKUPS"
       
  1653  ></A
       
  1654  >
       
  1655 @@ -11255,7 +9805,7 @@
       
  1656  ></DT
     4  ></DT
  1657  ><DD
     5  ><DD
  1658  ><P
     6  ><P
  1659 ->IdentLookups on</P
     7 ->IdentLookups on</P
  1660 +>IdentLookups off</P
     8 +>IdentLookups off</P
  1661  ></DD
     9  ></DD
  1662  ><DT
    10  ><DT
  1663  ><PRE
    11  ><PRE
  1664 @@ -11818,3747 +10368,6 @@
    12 
  1665  ></DIV
       
  1666  ><H1
       
  1667  ><A
       
  1668 -NAME="LDAPALIASDEREFERENCE"
       
  1669 -></A
       
  1670 ->
       
  1671 -    LDAPAliasDereference</H1
       
  1672 -><DIV
       
  1673 -CLASS="REFNAMEDIV"
       
  1674 -><A
       
  1675 -NAME="AEN4111"
       
  1676 -></A
       
  1677 -><H2
       
  1678 ->Name</H2
       
  1679 ->LDAPAliasDereference&nbsp;--&nbsp;Specify how LDAP alias dereferencing is done</DIV
       
  1680 -><DIV
       
  1681 -CLASS="REFSYNOPSISDIV"
       
  1682 -><A
       
  1683 -NAME="AEN4114"
       
  1684 -></A
       
  1685 -><H2
       
  1686 ->Synopsis</H2
       
  1687 -><P
       
  1688 -><B
       
  1689 -CLASS="COMMAND"
       
  1690 ->LDAPAliasDereference</B
       
  1691 ->  [      <CODE
       
  1692 -CLASS="OPTION"
       
  1693 ->never</CODE
       
  1694 ->
       
  1695 -      <CODE
       
  1696 -CLASS="OPTION"
       
  1697 ->find</CODE
       
  1698 ->
       
  1699 -      <CODE
       
  1700 -CLASS="OPTION"
       
  1701 ->search</CODE
       
  1702 ->
       
  1703 -      <CODE
       
  1704 -CLASS="OPTION"
       
  1705 ->always</CODE
       
  1706 ->
       
  1707 -    ]</P
       
  1708 -></DIV
       
  1709 -><DIV
       
  1710 -CLASS="REFSECT1"
       
  1711 -><A
       
  1712 -NAME="AEN4122"
       
  1713 -></A
       
  1714 -><H2
       
  1715 -></H2
       
  1716 -><P
       
  1717 -></P
       
  1718 -><DIV
       
  1719 -CLASS="VARIABLELIST"
       
  1720 -><DL
       
  1721 -><DT
       
  1722 -><PRE
       
  1723 -CLASS="SYNOPSIS"
       
  1724 ->Default</PRE
       
  1725 -></DT
       
  1726 -><DD
       
  1727 -><P
       
  1728 ->LDAPAliasDereference never</P
       
  1729 -></DD
       
  1730 -><DT
       
  1731 -><PRE
       
  1732 -CLASS="SYNOPSIS"
       
  1733 ->Context</PRE
       
  1734 -></DT
       
  1735 -><DD
       
  1736 -><P
       
  1737 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  1738 -></DD
       
  1739 -><DT
       
  1740 -><PRE
       
  1741 -CLASS="SYNOPSIS"
       
  1742 ->Module</PRE
       
  1743 -></DT
       
  1744 -><DD
       
  1745 -><P
       
  1746 ->mod_ldap</P
       
  1747 -></DD
       
  1748 -><DT
       
  1749 -><PRE
       
  1750 -CLASS="SYNOPSIS"
       
  1751 ->Compatibility</PRE
       
  1752 -></DT
       
  1753 -><DD
       
  1754 -><P
       
  1755 ->2.8.16 and later</P
       
  1756 -></DD
       
  1757 -></DL
       
  1758 -></DIV
       
  1759 -></DIV
       
  1760 -><DIV
       
  1761 -CLASS="REFSECT1"
       
  1762 -><A
       
  1763 -NAME="AEN4145"
       
  1764 -></A
       
  1765 -><H2
       
  1766 ->Description</H2
       
  1767 -><P
       
  1768 ->Should be one of never, always, search, or find to specify that
       
  1769 -  aliases are never dereferenced, always dereferenced, dereferenced when
       
  1770 -  searching, or dereferenced only when locating the base object for the
       
  1771 -  search.</P
       
  1772 -></DIV
       
  1773 -><DIV
       
  1774 -CLASS="REFSECT1"
       
  1775 -><A
       
  1776 -NAME="AEN4148"
       
  1777 -></A
       
  1778 -><H2
       
  1779 ->Examples</H2
       
  1780 -><P
       
  1781 ->LDAPAliasDereference always</P
       
  1782 -></DIV
       
  1783 -><H1
       
  1784 -><A
       
  1785 -NAME="LDAPATTR"
       
  1786 -></A
       
  1787 ->
       
  1788 -LDAPAttr</H1
       
  1789 -><DIV
       
  1790 -CLASS="REFNAMEDIV"
       
  1791 -><A
       
  1792 -NAME="AEN4159"
       
  1793 -></A
       
  1794 -><H2
       
  1795 ->Name</H2
       
  1796 ->LDAPAttr&nbsp;--&nbsp;Map LDAP Attributes to something non standard</DIV
       
  1797 -><DIV
       
  1798 -CLASS="REFSYNOPSISDIV"
       
  1799 -><A
       
  1800 -NAME="AEN4162"
       
  1801 -></A
       
  1802 -><H2
       
  1803 ->Synopsis</H2
       
  1804 -><P
       
  1805 -><B
       
  1806 -CLASS="COMMAND"
       
  1807 ->LDAPAttr</B
       
  1808 ->  [  <CODE
       
  1809 -CLASS="OPTION"
       
  1810 ->uid</CODE
       
  1811 ->
       
  1812 -  <CODE
       
  1813 -CLASS="OPTION"
       
  1814 ->uidNumber</CODE
       
  1815 ->
       
  1816 -  <CODE
       
  1817 -CLASS="OPTION"
       
  1818 ->gidNumber</CODE
       
  1819 ->
       
  1820 -  <CODE
       
  1821 -CLASS="OPTION"
       
  1822 ->homeDirectory</CODE
       
  1823 ->
       
  1824 -  <CODE
       
  1825 -CLASS="OPTION"
       
  1826 ->userPassword</CODE
       
  1827 ->
       
  1828 -  <CODE
       
  1829 -CLASS="OPTION"
       
  1830 ->loginShell</CODE
       
  1831 ->
       
  1832 -  <CODE
       
  1833 -CLASS="OPTION"
       
  1834 ->cn</CODE
       
  1835 ->
       
  1836 -  <CODE
       
  1837 -CLASS="OPTION"
       
  1838 ->memberUid</CODE
       
  1839 ->
       
  1840 -  <CODE
       
  1841 -CLASS="OPTION"
       
  1842 ->ftpQuota</CODE
       
  1843 ->] [  <CODE
       
  1844 -CLASS="OPTION"
       
  1845 ->"NewAttribute"</CODE
       
  1846 ->]</P
       
  1847 -><P
       
  1848 -></P
       
  1849 -><DIV
       
  1850 -CLASS="VARIABLELIST"
       
  1851 -><P
       
  1852 -><B
       
  1853 -></B
       
  1854 -></P
       
  1855 -><DL
       
  1856 -><DT
       
  1857 -><PRE
       
  1858 -CLASS="SYNOPSIS"
       
  1859 ->Default</PRE
       
  1860 -></DT
       
  1861 -><DD
       
  1862 -><P
       
  1863 -></P
       
  1864 -></DD
       
  1865 -><DT
       
  1866 -><PRE
       
  1867 -CLASS="SYNOPSIS"
       
  1868 ->Context</PRE
       
  1869 -></DT
       
  1870 -><DD
       
  1871 -><P
       
  1872 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  1873 -></DD
       
  1874 -><DT
       
  1875 -><PRE
       
  1876 -CLASS="SYNOPSIS"
       
  1877 ->Module</PRE
       
  1878 -></DT
       
  1879 -><DD
       
  1880 -><P
       
  1881 ->mod_ldap</P
       
  1882 -></DD
       
  1883 -><DT
       
  1884 -><PRE
       
  1885 -CLASS="SYNOPSIS"
       
  1886 ->Compatibility</PRE
       
  1887 -></DT
       
  1888 -><DD
       
  1889 -><P
       
  1890 ->2.8.13 and later</P
       
  1891 -></DD
       
  1892 -></DL
       
  1893 -></DIV
       
  1894 -></DIV
       
  1895 -><DIV
       
  1896 -CLASS="REFSECT1"
       
  1897 -><A
       
  1898 -NAME="AEN4199"
       
  1899 -></A
       
  1900 -><H2
       
  1901 ->Description</H2
       
  1902 -><P
       
  1903 ->FIXMEFIXMEFIXME</P
       
  1904 -><P
       
  1905 ->This dicrective has to be set before any of the LDAPDo* directives.</P
       
  1906 -></DIV
       
  1907 -><DIV
       
  1908 -CLASS="REFSECT1"
       
  1909 -><A
       
  1910 -NAME="AEN4203"
       
  1911 -></A
       
  1912 -><H2
       
  1913 ->See also</H2
       
  1914 -><P
       
  1915 -></P
       
  1916 -></DIV
       
  1917 -><DIV
       
  1918 -CLASS="REFSECT1"
       
  1919 -><A
       
  1920 -NAME="AEN4206"
       
  1921 -></A
       
  1922 -><H2
       
  1923 ->Examples</H2
       
  1924 -><P
       
  1925 -CLASS="LITERALLAYOUT"
       
  1926 ->FIXFIXFIX</P
       
  1927 -><P
       
  1928 ->FIXFIX</P
       
  1929 -></DIV
       
  1930 -><H1
       
  1931 -><A
       
  1932 -NAME="LDAPAUTHBINDS"
       
  1933 -></A
       
  1934 ->
       
  1935 -			LDAPAuthBinds</H1
       
  1936 -><DIV
       
  1937 -CLASS="REFNAMEDIV"
       
  1938 -><A
       
  1939 -NAME="AEN4218"
       
  1940 -></A
       
  1941 -><H2
       
  1942 ->Name</H2
       
  1943 ->LDAPAuthBinds&nbsp;--&nbsp;(docs incomplete)</DIV
       
  1944 -><DIV
       
  1945 -CLASS="REFSYNOPSISDIV"
       
  1946 -><A
       
  1947 -NAME="AEN4221"
       
  1948 -></A
       
  1949 -><H2
       
  1950 ->Synopsis</H2
       
  1951 -><P
       
  1952 -><B
       
  1953 -CLASS="COMMAND"
       
  1954 ->Syntax: LDAPAuthBinds</B
       
  1955 ->  [				<CODE
       
  1956 -CLASS="OPTION"
       
  1957 ->on</CODE
       
  1958 ->
       
  1959 -				<CODE
       
  1960 -CLASS="OPTION"
       
  1961 ->off</CODE
       
  1962 ->
       
  1963 -			]</P
       
  1964 -><P
       
  1965 -></P
       
  1966 -><DIV
       
  1967 -CLASS="VARIABLELIST"
       
  1968 -><P
       
  1969 -><B
       
  1970 ->(docs incomplete)</B
       
  1971 -></P
       
  1972 -><DL
       
  1973 -><DT
       
  1974 -><PRE
       
  1975 -CLASS="SYNOPSIS"
       
  1976 ->Default</PRE
       
  1977 -></DT
       
  1978 -><DD
       
  1979 -><P
       
  1980 ->				LDAPAuthBinds off in mod_ldap &#60;= 2.7.6,
       
  1981 -				LDAPAuthBinds on in mod_ldap &#62;= 2.8
       
  1982 -			</P
       
  1983 -></DD
       
  1984 -><DT
       
  1985 -><PRE
       
  1986 -CLASS="SYNOPSIS"
       
  1987 ->Context</PRE
       
  1988 -></DT
       
  1989 -><DD
       
  1990 -><P
       
  1991 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  1992 -			</P
       
  1993 -></DD
       
  1994 -><DT
       
  1995 -><PRE
       
  1996 -CLASS="SYNOPSIS"
       
  1997 ->Module</PRE
       
  1998 -></DT
       
  1999 -><DD
       
  2000 -><P
       
  2001 ->mod_ldap
       
  2002 -			</P
       
  2003 -></DD
       
  2004 -><DT
       
  2005 -><PRE
       
  2006 -CLASS="SYNOPSIS"
       
  2007 ->Compatibility</PRE
       
  2008 -></DT
       
  2009 -><DD
       
  2010 -><P
       
  2011 ->				mod_ldap v2.5 and later
       
  2012 -			</P
       
  2013 -></DD
       
  2014 -></DL
       
  2015 -></DIV
       
  2016 -></DIV
       
  2017 -><DIV
       
  2018 -CLASS="REFSECT1"
       
  2019 -><A
       
  2020 -NAME="AEN4249"
       
  2021 -></A
       
  2022 -><H2
       
  2023 ->Description</H2
       
  2024 -><P
       
  2025 ->By default, the DN specified by LDAPDNInfo will be used to
       
  2026 -		bind to the LDAP server to obtain user information, including the
       
  2027 -		userPassword attribute. If LDAPAuthBinds is set to on, the DN
       
  2028 -		specified by LDAPDNInfo will be used to fetch all user information
       
  2029 -		except the userPassword attribute. Then, mod_ldap will bind to the
       
  2030 -		LDAP server as the user who is logging in via FTP with the
       
  2031 -		user-supplied password. If this bind succeeds, the user is
       
  2032 -		considered authenticated and is allowed to log in. This method of
       
  2033 -		LDAP authentication has the added benefit of supporting any password
       
  2034 -		encryption scheme that your LDAP server supports.</P
       
  2035 -></DIV
       
  2036 -><DIV
       
  2037 -CLASS="REFSECT1"
       
  2038 -><A
       
  2039 -NAME="AEN4252"
       
  2040 -></A
       
  2041 -><H2
       
  2042 ->See also</H2
       
  2043 -><P
       
  2044 -></P
       
  2045 -></DIV
       
  2046 -><DIV
       
  2047 -CLASS="REFSECT1"
       
  2048 -><A
       
  2049 -NAME="AEN4255"
       
  2050 -></A
       
  2051 -><H2
       
  2052 ->Examples</H2
       
  2053 -><P
       
  2054 -></P
       
  2055 -></DIV
       
  2056 -><H1
       
  2057 -><A
       
  2058 -NAME="LDAPDEFAULTAUTHSCHEME"
       
  2059 -></A
       
  2060 ->
       
  2061 -			LDAPDefaultAuthScheme</H1
       
  2062 -><DIV
       
  2063 -CLASS="REFNAMEDIV"
       
  2064 -><A
       
  2065 -NAME="AEN4266"
       
  2066 -></A
       
  2067 -><H2
       
  2068 ->Name</H2
       
  2069 ->LDAPDefaultAuthScheme&nbsp;--&nbsp;			Set the authentication scheme/hash that is used when no leading
       
  2070 -			{hashname} is present.
       
  2071 -		</DIV
       
  2072 -><DIV
       
  2073 -CLASS="REFSYNOPSISDIV"
       
  2074 -><A
       
  2075 -NAME="AEN4269"
       
  2076 -></A
       
  2077 -><H2
       
  2078 ->Synopsis</H2
       
  2079 -><P
       
  2080 -><B
       
  2081 -CLASS="COMMAND"
       
  2082 ->LDAPDefaultAuthScheme</B
       
  2083 ->  [				<CODE
       
  2084 -CLASS="OPTION"
       
  2085 ->crypt</CODE
       
  2086 ->
       
  2087 -				<CODE
       
  2088 -CLASS="OPTION"
       
  2089 ->clear</CODE
       
  2090 ->
       
  2091 -			]</P
       
  2092 -><P
       
  2093 -></P
       
  2094 -><DIV
       
  2095 -CLASS="VARIABLELIST"
       
  2096 -><P
       
  2097 -><B
       
  2098 -></B
       
  2099 -></P
       
  2100 -><DL
       
  2101 -><DT
       
  2102 -><PRE
       
  2103 -CLASS="SYNOPSIS"
       
  2104 ->Default</PRE
       
  2105 -></DT
       
  2106 -><DD
       
  2107 -><P
       
  2108 ->				LDAPDefaultAuthScheme "crypt"
       
  2109 -			</P
       
  2110 -></DD
       
  2111 -><DT
       
  2112 -><PRE
       
  2113 -CLASS="SYNOPSIS"
       
  2114 ->Context</PRE
       
  2115 -></DT
       
  2116 -><DD
       
  2117 -><P
       
  2118 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2119 -			</P
       
  2120 -></DD
       
  2121 -><DT
       
  2122 -><PRE
       
  2123 -CLASS="SYNOPSIS"
       
  2124 ->Module</PRE
       
  2125 -></DT
       
  2126 -><DD
       
  2127 -><P
       
  2128 ->mod_ldap
       
  2129 -			</P
       
  2130 -></DD
       
  2131 -><DT
       
  2132 -><PRE
       
  2133 -CLASS="SYNOPSIS"
       
  2134 ->Compatibility</PRE
       
  2135 -></DT
       
  2136 -><DD
       
  2137 -><P
       
  2138 ->				mod_ldap v2.0 and later
       
  2139 -			</P
       
  2140 -></DD
       
  2141 -></DL
       
  2142 -></DIV
       
  2143 -></DIV
       
  2144 -><DIV
       
  2145 -CLASS="REFSECT1"
       
  2146 -><A
       
  2147 -NAME="AEN4297"
       
  2148 -></A
       
  2149 -><H2
       
  2150 ->Description</H2
       
  2151 -><P
       
  2152 ->Specifies the authentication scheme used for passwords with no
       
  2153 -		{prefix} in the LDAP database. For example, if you are using
       
  2154 -		something like userPassword: mypass in your LDAP database, you would
       
  2155 -		want to set LDAPDefaultAuthScheme to clear.</P
       
  2156 -></DIV
       
  2157 -><DIV
       
  2158 -CLASS="REFSECT1"
       
  2159 -><A
       
  2160 -NAME="AEN4300"
       
  2161 -></A
       
  2162 -><H2
       
  2163 ->See also</H2
       
  2164 -><P
       
  2165 -></P
       
  2166 -></DIV
       
  2167 -><DIV
       
  2168 -CLASS="REFSECT1"
       
  2169 -><A
       
  2170 -NAME="AEN4303"
       
  2171 -></A
       
  2172 -><H2
       
  2173 ->Examples</H2
       
  2174 -><P
       
  2175 -></P
       
  2176 -></DIV
       
  2177 -><H1
       
  2178 -><A
       
  2179 -NAME="LDAPDEFAULTGID"
       
  2180 -></A
       
  2181 ->
       
  2182 -			LDAPDefaultGID</H1
       
  2183 -><DIV
       
  2184 -CLASS="REFNAMEDIV"
       
  2185 -><A
       
  2186 -NAME="AEN4314"
       
  2187 -></A
       
  2188 -><H2
       
  2189 ->Name</H2
       
  2190 ->LDAPDefaultGID&nbsp;--&nbsp;			Set the default GID to be assigned to users when no uidNumber
       
  2191 -			attribute is found.
       
  2192 -		</DIV
       
  2193 -><DIV
       
  2194 -CLASS="REFSYNOPSISDIV"
       
  2195 -><A
       
  2196 -NAME="AEN4317"
       
  2197 -></A
       
  2198 -><H2
       
  2199 ->Synopsis</H2
       
  2200 -><P
       
  2201 -><B
       
  2202 -CLASS="COMMAND"
       
  2203 ->LDAPDefaultGID</B
       
  2204 ->  [				<CODE
       
  2205 -CLASS="OPTION"
       
  2206 ->default-gid</CODE
       
  2207 ->
       
  2208 -			]</P
       
  2209 -><P
       
  2210 -></P
       
  2211 -><DIV
       
  2212 -CLASS="VARIABLELIST"
       
  2213 -><P
       
  2214 -><B
       
  2215 -></B
       
  2216 -></P
       
  2217 -><DL
       
  2218 -><DT
       
  2219 -><PRE
       
  2220 -CLASS="SYNOPSIS"
       
  2221 ->Default</PRE
       
  2222 -></DT
       
  2223 -><DD
       
  2224 -><P
       
  2225 ->				None
       
  2226 -			</P
       
  2227 -></DD
       
  2228 -><DT
       
  2229 -><PRE
       
  2230 -CLASS="SYNOPSIS"
       
  2231 ->Context</PRE
       
  2232 -></DT
       
  2233 -><DD
       
  2234 -><P
       
  2235 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2236 -			</P
       
  2237 -></DD
       
  2238 -><DT
       
  2239 -><PRE
       
  2240 -CLASS="SYNOPSIS"
       
  2241 ->Module</PRE
       
  2242 -></DT
       
  2243 -><DD
       
  2244 -><P
       
  2245 ->mod_ldap
       
  2246 -			</P
       
  2247 -></DD
       
  2248 -><DT
       
  2249 -><PRE
       
  2250 -CLASS="SYNOPSIS"
       
  2251 ->Compatibility</PRE
       
  2252 -></DT
       
  2253 -><DD
       
  2254 -><P
       
  2255 ->				mod_ldap v2.0 and later
       
  2256 -			</P
       
  2257 -></DD
       
  2258 -></DL
       
  2259 -></DIV
       
  2260 -></DIV
       
  2261 -><DIV
       
  2262 -CLASS="REFSECT1"
       
  2263 -><A
       
  2264 -NAME="AEN4344"
       
  2265 -></A
       
  2266 -><H2
       
  2267 ->Description</H2
       
  2268 -><P
       
  2269 ->This directive is useful primarily in virtual-user
       
  2270 -		environments common in large-scale ISPs and hosting organizations.
       
  2271 -		If a user does not have a LDAP gidNumber attribute, the
       
  2272 -		LDAPDefaultGID is used. This allows one to have a large number of
       
  2273 -		users in an LDAP database without gidNumber attributes; setting this
       
  2274 -		configuration directive will automatically assign those users a
       
  2275 -		single GID.</P
       
  2276 -></DIV
       
  2277 -><DIV
       
  2278 -CLASS="REFSECT1"
       
  2279 -><A
       
  2280 -NAME="AEN4347"
       
  2281 -></A
       
  2282 -><H2
       
  2283 ->See also</H2
       
  2284 -><P
       
  2285 -></P
       
  2286 -></DIV
       
  2287 -><DIV
       
  2288 -CLASS="REFSECT1"
       
  2289 -><A
       
  2290 -NAME="AEN4350"
       
  2291 -></A
       
  2292 -><H2
       
  2293 ->Examples</H2
       
  2294 -><P
       
  2295 -></P
       
  2296 -></DIV
       
  2297 -><H1
       
  2298 -><A
       
  2299 -NAME="LDAPDEFAULTUID"
       
  2300 -></A
       
  2301 ->
       
  2302 -			LDAPDefaultUID</H1
       
  2303 -><DIV
       
  2304 -CLASS="REFNAMEDIV"
       
  2305 -><A
       
  2306 -NAME="AEN4361"
       
  2307 -></A
       
  2308 -><H2
       
  2309 ->Name</H2
       
  2310 ->LDAPDefaultUID&nbsp;--&nbsp;			Set the default UID to be assigned to users when no uidNumber
       
  2311 -			attribute is found.
       
  2312 -		</DIV
       
  2313 -><DIV
       
  2314 -CLASS="REFSYNOPSISDIV"
       
  2315 -><A
       
  2316 -NAME="AEN4364"
       
  2317 -></A
       
  2318 -><H2
       
  2319 ->Synopsis</H2
       
  2320 -><P
       
  2321 -><B
       
  2322 -CLASS="COMMAND"
       
  2323 ->LDAPDefaultUID</B
       
  2324 ->  [				<CODE
       
  2325 -CLASS="OPTION"
       
  2326 ->default-uid</CODE
       
  2327 ->
       
  2328 -			]</P
       
  2329 -><P
       
  2330 -></P
       
  2331 -><DIV
       
  2332 -CLASS="VARIABLELIST"
       
  2333 -><P
       
  2334 -><B
       
  2335 -></B
       
  2336 -></P
       
  2337 -><DL
       
  2338 -><DT
       
  2339 -><PRE
       
  2340 -CLASS="SYNOPSIS"
       
  2341 ->Default</PRE
       
  2342 -></DT
       
  2343 -><DD
       
  2344 -><P
       
  2345 ->				None
       
  2346 -			</P
       
  2347 -></DD
       
  2348 -><DT
       
  2349 -><PRE
       
  2350 -CLASS="SYNOPSIS"
       
  2351 ->Context</PRE
       
  2352 -></DT
       
  2353 -><DD
       
  2354 -><P
       
  2355 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2356 -			</P
       
  2357 -></DD
       
  2358 -><DT
       
  2359 -><PRE
       
  2360 -CLASS="SYNOPSIS"
       
  2361 ->Module</PRE
       
  2362 -></DT
       
  2363 -><DD
       
  2364 -><P
       
  2365 ->mod_ldap
       
  2366 -			</P
       
  2367 -></DD
       
  2368 -><DT
       
  2369 -><PRE
       
  2370 -CLASS="SYNOPSIS"
       
  2371 ->Compatibility</PRE
       
  2372 -></DT
       
  2373 -><DD
       
  2374 -><P
       
  2375 ->				mod_ldap v2.0 and later
       
  2376 -			</P
       
  2377 -></DD
       
  2378 -></DL
       
  2379 -></DIV
       
  2380 -></DIV
       
  2381 -><DIV
       
  2382 -CLASS="REFSECT1"
       
  2383 -><A
       
  2384 -NAME="AEN4391"
       
  2385 -></A
       
  2386 -><H2
       
  2387 ->Description</H2
       
  2388 -><P
       
  2389 ->This directive is useful primarily in virtual-user
       
  2390 -		environments common in large-scale ISPs and hosting organizations.
       
  2391 -		If a user does not have a LDAP uidNumber attribute, the
       
  2392 -		LDAPDefaultUID is used. This allows one to have a large number of
       
  2393 -		users in an LDAP database without uidNumber attributes; setting this
       
  2394 -		configuration directive will automatically assign those users a
       
  2395 -		single UID.</P
       
  2396 -></DIV
       
  2397 -><DIV
       
  2398 -CLASS="REFSECT1"
       
  2399 -><A
       
  2400 -NAME="AEN4394"
       
  2401 -></A
       
  2402 -><H2
       
  2403 ->See also</H2
       
  2404 -><P
       
  2405 -></P
       
  2406 -></DIV
       
  2407 -><DIV
       
  2408 -CLASS="REFSECT1"
       
  2409 -><A
       
  2410 -NAME="AEN4397"
       
  2411 -></A
       
  2412 -><H2
       
  2413 ->Examples</H2
       
  2414 -><P
       
  2415 -></P
       
  2416 -></DIV
       
  2417 -><H1
       
  2418 -><A
       
  2419 -NAME="LDAPDNINFO"
       
  2420 -></A
       
  2421 ->
       
  2422 -			LDAPDNInfo</H1
       
  2423 -><DIV
       
  2424 -CLASS="REFNAMEDIV"
       
  2425 -><A
       
  2426 -NAME="AEN4408"
       
  2427 -></A
       
  2428 -><H2
       
  2429 ->Name</H2
       
  2430 ->LDAPDNInfo&nbsp;--&nbsp;Set DN information to be used for initial bind</DIV
       
  2431 -><DIV
       
  2432 -CLASS="REFSYNOPSISDIV"
       
  2433 -><A
       
  2434 -NAME="AEN4411"
       
  2435 -></A
       
  2436 -><H2
       
  2437 ->Synopsis</H2
       
  2438 -><P
       
  2439 -><B
       
  2440 -CLASS="COMMAND"
       
  2441 ->LDAPDNInfo</B
       
  2442 ->  [				<CODE
       
  2443 -CLASS="OPTION"
       
  2444 ->LDAPDNInfo "ldap-dn" "dn-password"</CODE
       
  2445 ->
       
  2446 -			]</P
       
  2447 -><P
       
  2448 -></P
       
  2449 -><DIV
       
  2450 -CLASS="VARIABLELIST"
       
  2451 -><P
       
  2452 -><B
       
  2453 -></B
       
  2454 -></P
       
  2455 -><DL
       
  2456 -><DT
       
  2457 -><PRE
       
  2458 -CLASS="SYNOPSIS"
       
  2459 ->Default</PRE
       
  2460 -></DT
       
  2461 -><DD
       
  2462 -><P
       
  2463 ->				LDAPDNInfo "" "" (anonymous bind)
       
  2464 -			</P
       
  2465 -></DD
       
  2466 -><DT
       
  2467 -><PRE
       
  2468 -CLASS="SYNOPSIS"
       
  2469 ->Context</PRE
       
  2470 -></DT
       
  2471 -><DD
       
  2472 -><P
       
  2473 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2474 -			</P
       
  2475 -></DD
       
  2476 -><DT
       
  2477 -><PRE
       
  2478 -CLASS="SYNOPSIS"
       
  2479 ->Module</PRE
       
  2480 -></DT
       
  2481 -><DD
       
  2482 -><P
       
  2483 ->mod_ldap
       
  2484 -			</P
       
  2485 -></DD
       
  2486 -><DT
       
  2487 -><PRE
       
  2488 -CLASS="SYNOPSIS"
       
  2489 ->Compatibility</PRE
       
  2490 -></DT
       
  2491 -><DD
       
  2492 -><P
       
  2493 ->			mod_ldap v2.0 and later
       
  2494 -			</P
       
  2495 -></DD
       
  2496 -></DL
       
  2497 -></DIV
       
  2498 -></DIV
       
  2499 -><DIV
       
  2500 -CLASS="REFSECT1"
       
  2501 -><A
       
  2502 -NAME="AEN4438"
       
  2503 -></A
       
  2504 -><H2
       
  2505 ->Description</H2
       
  2506 -><P
       
  2507 ->This directive specifies the LDAP DN and password to use when
       
  2508 -		binding to the LDAP server. If this configuration directive is not
       
  2509 -		specified, anonymous binds are used.</P
       
  2510 -></DIV
       
  2511 -><DIV
       
  2512 -CLASS="REFSECT1"
       
  2513 -><A
       
  2514 -NAME="AEN4441"
       
  2515 -></A
       
  2516 -><H2
       
  2517 ->See also</H2
       
  2518 -><P
       
  2519 -></P
       
  2520 -></DIV
       
  2521 -><DIV
       
  2522 -CLASS="REFSECT1"
       
  2523 -><A
       
  2524 -NAME="AEN4444"
       
  2525 -></A
       
  2526 -><H2
       
  2527 ->Examples</H2
       
  2528 -><P
       
  2529 -></P
       
  2530 -></DIV
       
  2531 -><H1
       
  2532 -><A
       
  2533 -NAME="LDAPDOAUTH"
       
  2534 -></A
       
  2535 ->
       
  2536 -			LDAPDoAuth</H1
       
  2537 -><DIV
       
  2538 -CLASS="REFNAMEDIV"
       
  2539 -><A
       
  2540 -NAME="AEN4455"
       
  2541 -></A
       
  2542 -><H2
       
  2543 ->Name</H2
       
  2544 ->LDAPDoAuth&nbsp;--&nbsp;Enable LDAP authentication</DIV
       
  2545 -><DIV
       
  2546 -CLASS="REFSYNOPSISDIV"
       
  2547 -><A
       
  2548 -NAME="AEN4458"
       
  2549 -></A
       
  2550 -><H2
       
  2551 ->Synopsis</H2
       
  2552 -><P
       
  2553 -><B
       
  2554 -CLASS="COMMAND"
       
  2555 ->LDAPDoAuth</B
       
  2556 ->  [				<CODE
       
  2557 -CLASS="OPTION"
       
  2558 ->on</CODE
       
  2559 ->
       
  2560 -				<CODE
       
  2561 -CLASS="OPTION"
       
  2562 ->off</CODE
       
  2563 ->
       
  2564 -			] [				<CODE
       
  2565 -CLASS="OPTION"
       
  2566 ->"auth-base-dn"</CODE
       
  2567 ->
       
  2568 -			] [				<CODE
       
  2569 -CLASS="OPTION"
       
  2570 ->"search-filter-template"</CODE
       
  2571 ->
       
  2572 -			]</P
       
  2573 -><P
       
  2574 -></P
       
  2575 -><DIV
       
  2576 -CLASS="VARIABLELIST"
       
  2577 -><P
       
  2578 -><B
       
  2579 -></B
       
  2580 -></P
       
  2581 -><DL
       
  2582 -><DT
       
  2583 -><PRE
       
  2584 -CLASS="SYNOPSIS"
       
  2585 ->Default</PRE
       
  2586 -></DT
       
  2587 -><DD
       
  2588 -><P
       
  2589 ->				LDAPDoAuth off
       
  2590 -			</P
       
  2591 -></DD
       
  2592 -><DT
       
  2593 -><PRE
       
  2594 -CLASS="SYNOPSIS"
       
  2595 ->Context</PRE
       
  2596 -></DT
       
  2597 -><DD
       
  2598 -><P
       
  2599 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2600 -			</P
       
  2601 -></DD
       
  2602 -><DT
       
  2603 -><PRE
       
  2604 -CLASS="SYNOPSIS"
       
  2605 ->Module</PRE
       
  2606 -></DT
       
  2607 -><DD
       
  2608 -><P
       
  2609 ->mod_ldap
       
  2610 -			</P
       
  2611 -></DD
       
  2612 -><DT
       
  2613 -><PRE
       
  2614 -CLASS="SYNOPSIS"
       
  2615 ->Compatibility</PRE
       
  2616 -></DT
       
  2617 -><DD
       
  2618 -><P
       
  2619 ->				mod_ldap v2.0 and later
       
  2620 -			</P
       
  2621 -></DD
       
  2622 -></DL
       
  2623 -></DIV
       
  2624 -></DIV
       
  2625 -><DIV
       
  2626 -CLASS="REFSECT1"
       
  2627 -><A
       
  2628 -NAME="AEN4490"
       
  2629 -></A
       
  2630 -><H2
       
  2631 ->Description</H2
       
  2632 -><P
       
  2633 ->This configuration directive activates LDAP authentication.
       
  2634 -		The second argument to this directive is the LDAP base DN to use for
       
  2635 -		authentication.  The third argument is a template to be used for the
       
  2636 -		search filter; %v will be replaced with the username that is being
       
  2637 -		authenticated.
       
  2638 -		 By default, the search filter template
       
  2639 -		"(&amp;(uid=%v)(objectclass=posixAccount))" is used.
       
  2640 -		The uid for the the search filter is taken from the
       
  2641 -		<A
       
  2642 -HREF="#LDAPATTR"
       
  2643 ->LDAPAttr</A
       
  2644 -> directive.
       
  2645 -		Search filter
       
  2646 -		templates are only supported in mod_ldap v2.7 and later.</P
       
  2647 -></DIV
       
  2648 -><DIV
       
  2649 -CLASS="REFSECT1"
       
  2650 -><A
       
  2651 -NAME="AEN4494"
       
  2652 -></A
       
  2653 -><H2
       
  2654 ->See also</H2
       
  2655 -><P
       
  2656 ->			<A
       
  2657 -HREF="#LDAPATTR"
       
  2658 ->LDAPAttr</A
       
  2659 ->
       
  2660 -		</P
       
  2661 -></DIV
       
  2662 -><DIV
       
  2663 -CLASS="REFSECT1"
       
  2664 -><A
       
  2665 -NAME="AEN4498"
       
  2666 -></A
       
  2667 -><H2
       
  2668 ->Examples</H2
       
  2669 -><P
       
  2670 -></P
       
  2671 -></DIV
       
  2672 -><H1
       
  2673 -><A
       
  2674 -NAME="LDAPDOGIDLOOKUPS"
       
  2675 -></A
       
  2676 ->
       
  2677 -			LDAPDoGIDLookups</H1
       
  2678 -><DIV
       
  2679 -CLASS="REFNAMEDIV"
       
  2680 -><A
       
  2681 -NAME="AEN4509"
       
  2682 -></A
       
  2683 -><H2
       
  2684 ->Name</H2
       
  2685 ->LDAPDoGIDLookups&nbsp;--&nbsp;			Enable LDAP lookups for user group membership and GIDs in
       
  2686 -			directory listings
       
  2687 -		</DIV
       
  2688 -><DIV
       
  2689 -CLASS="REFSYNOPSISDIV"
       
  2690 -><A
       
  2691 -NAME="AEN4512"
       
  2692 -></A
       
  2693 -><H2
       
  2694 ->Synopsis</H2
       
  2695 -><P
       
  2696 -><B
       
  2697 -CLASS="COMMAND"
       
  2698 ->LDAPDoGIDLookups</B
       
  2699 ->  [				<CODE
       
  2700 -CLASS="OPTION"
       
  2701 ->on</CODE
       
  2702 ->
       
  2703 -				<CODE
       
  2704 -CLASS="OPTION"
       
  2705 ->off</CODE
       
  2706 ->
       
  2707 -			] [				<CODE
       
  2708 -CLASS="OPTION"
       
  2709 ->"gid-base-dn"</CODE
       
  2710 ->
       
  2711 -			] [				<CODE
       
  2712 -CLASS="OPTION"
       
  2713 ->"cn-filter-template"</CODE
       
  2714 ->
       
  2715 -			] [				<CODE
       
  2716 -CLASS="OPTION"
       
  2717 ->"gid-number-filter-template"</CODE
       
  2718 ->
       
  2719 -			] [				<CODE
       
  2720 -CLASS="OPTION"
       
  2721 ->"member-uid-filter-template"</CODE
       
  2722 ->
       
  2723 -			]</P
       
  2724 -><P
       
  2725 -></P
       
  2726 -><DIV
       
  2727 -CLASS="VARIABLELIST"
       
  2728 -><P
       
  2729 -><B
       
  2730 -></B
       
  2731 -></P
       
  2732 -><DL
       
  2733 -><DT
       
  2734 -><PRE
       
  2735 -CLASS="SYNOPSIS"
       
  2736 ->Default</PRE
       
  2737 -></DT
       
  2738 -><DD
       
  2739 -><P
       
  2740 ->				LDAPDoGIDLookups off
       
  2741 -			</P
       
  2742 -></DD
       
  2743 -><DT
       
  2744 -><PRE
       
  2745 -CLASS="SYNOPSIS"
       
  2746 ->Context</PRE
       
  2747 -></DT
       
  2748 -><DD
       
  2749 -><P
       
  2750 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2751 -			</P
       
  2752 -></DD
       
  2753 -><DT
       
  2754 -><PRE
       
  2755 -CLASS="SYNOPSIS"
       
  2756 ->Module</PRE
       
  2757 -></DT
       
  2758 -><DD
       
  2759 -><P
       
  2760 ->mod_ldap
       
  2761 -			</P
       
  2762 -></DD
       
  2763 -><DT
       
  2764 -><PRE
       
  2765 -CLASS="SYNOPSIS"
       
  2766 ->Compatibility</PRE
       
  2767 -></DT
       
  2768 -><DD
       
  2769 -><P
       
  2770 ->				mod_ldap v2.0 and later
       
  2771 -			</P
       
  2772 -></DD
       
  2773 -></DL
       
  2774 -></DIV
       
  2775 -></DIV
       
  2776 -><DIV
       
  2777 -CLASS="REFSECT1"
       
  2778 -><A
       
  2779 -NAME="AEN4548"
       
  2780 -></A
       
  2781 -><H2
       
  2782 ->Description</H2
       
  2783 -><P
       
  2784 ->This configuration directive activates LDAP GID-to-name
       
  2785 -		lookups in directory listings. The second argument to this directive
       
  2786 -		is the LDAP base DN to use for GID-to-name lookups. The third
       
  2787 -		through fifth arguments are templates to be used for the search
       
  2788 -		filter; %v will be replaced with the GID that is being looked
       
  2789 -		up.</P
       
  2790 -><P
       
  2791 ->By default, the search filter templates look like this:</P
       
  2792 -><P
       
  2793 ->		cn_filter:        "(cn=%v)(objectclass=posixGroup))",
       
  2794 -		gidnumber_filter: "(gidNumber=%v)(objectclass=posixGroup))",
       
  2795 -		memberuid_filter: "(memberUid=%v)(objectclass=posixGroup))".
       
  2796 -		</P
       
  2797 -><P
       
  2798 ->The attribute names used in the default search filters are
       
  2799 -		taken from the <A
       
  2800 -HREF="#LDAPATTR"
       
  2801 ->LDAPAttr</A
       
  2802 ->
       
  2803 -		directive.</P
       
  2804 -><P
       
  2805 ->Filter templates are only supported in mod_ldap v2.8.3 and
       
  2806 -		later.</P
       
  2807 -></DIV
       
  2808 -><DIV
       
  2809 -CLASS="REFSECT1"
       
  2810 -><A
       
  2811 -NAME="AEN4556"
       
  2812 -></A
       
  2813 -><H2
       
  2814 ->See also</H2
       
  2815 -><P
       
  2816 ->			<A
       
  2817 -HREF="#LDAPATTR"
       
  2818 ->LDAPAttr</A
       
  2819 ->
       
  2820 -		</P
       
  2821 -></DIV
       
  2822 -><DIV
       
  2823 -CLASS="REFSECT1"
       
  2824 -><A
       
  2825 -NAME="AEN4560"
       
  2826 -></A
       
  2827 -><H2
       
  2828 ->Examples</H2
       
  2829 -><P
       
  2830 -></P
       
  2831 -></DIV
       
  2832 -><H1
       
  2833 -><A
       
  2834 -NAME="LDAPDOQUOTALOOKUPS"
       
  2835 -></A
       
  2836 ->
       
  2837 -			LDAPDoQuotaLookups</H1
       
  2838 -><DIV
       
  2839 -CLASS="REFNAMEDIV"
       
  2840 -><A
       
  2841 -NAME="AEN4571"
       
  2842 -></A
       
  2843 -><H2
       
  2844 ->Name</H2
       
  2845 ->LDAPDoQuotaLookups&nbsp;--&nbsp;Enable LDAP quota limit support</DIV
       
  2846 -><DIV
       
  2847 -CLASS="REFSYNOPSISDIV"
       
  2848 -><A
       
  2849 -NAME="AEN4574"
       
  2850 -></A
       
  2851 -><H2
       
  2852 ->Synopsis</H2
       
  2853 -><P
       
  2854 -><B
       
  2855 -CLASS="COMMAND"
       
  2856 ->LDAPDoQuotaLookups</B
       
  2857 ->  [				<CODE
       
  2858 -CLASS="OPTION"
       
  2859 ->on</CODE
       
  2860 ->
       
  2861 -				<CODE
       
  2862 -CLASS="OPTION"
       
  2863 ->off</CODE
       
  2864 ->
       
  2865 -			] [				<CODE
       
  2866 -CLASS="OPTION"
       
  2867 ->"base-dn"</CODE
       
  2868 ->
       
  2869 -			] [				<CODE
       
  2870 -CLASS="OPTION"
       
  2871 ->"quota-filter-template"</CODE
       
  2872 ->
       
  2873 -			] [				<CODE
       
  2874 -CLASS="OPTION"
       
  2875 ->"default-quota"</CODE
       
  2876 ->
       
  2877 -			]</P
       
  2878 -><P
       
  2879 -></P
       
  2880 -><DIV
       
  2881 -CLASS="VARIABLELIST"
       
  2882 -><P
       
  2883 -><B
       
  2884 -></B
       
  2885 -></P
       
  2886 -><DL
       
  2887 -><DT
       
  2888 -><PRE
       
  2889 -CLASS="SYNOPSIS"
       
  2890 ->Default</PRE
       
  2891 -></DT
       
  2892 -><DD
       
  2893 -><P
       
  2894 ->				LDAPDoQuotaLookups off
       
  2895 -			</P
       
  2896 -></DD
       
  2897 -><DT
       
  2898 -><PRE
       
  2899 -CLASS="SYNOPSIS"
       
  2900 ->Context</PRE
       
  2901 -></DT
       
  2902 -><DD
       
  2903 -><P
       
  2904 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  2905 -			</P
       
  2906 -></DD
       
  2907 -><DT
       
  2908 -><PRE
       
  2909 -CLASS="SYNOPSIS"
       
  2910 ->Module</PRE
       
  2911 -></DT
       
  2912 -><DD
       
  2913 -><P
       
  2914 ->mod_ldap</P
       
  2915 -></DD
       
  2916 -><DT
       
  2917 -><PRE
       
  2918 -CLASS="SYNOPSIS"
       
  2919 ->Compatibility</PRE
       
  2920 -></DT
       
  2921 -><DD
       
  2922 -><P
       
  2923 ->				mod_ldap v2.8.12 and later
       
  2924 -			</P
       
  2925 -></DD
       
  2926 -></DL
       
  2927 -></DIV
       
  2928 -></DIV
       
  2929 -><DIV
       
  2930 -CLASS="REFSECT1"
       
  2931 -><A
       
  2932 -NAME="AEN4608"
       
  2933 -></A
       
  2934 -><H2
       
  2935 ->Description</H2
       
  2936 -><P
       
  2937 ->This configuration directive activates LDAP quota lookups. 
       
  2938 -		The second argument to this directive is the LDAP base DN to use for
       
  2939 -		quota limit search.  The third argument is a template to be used for
       
  2940 -		the search filter; %v will be replaced with the username that is
       
  2941 -		being authenticated. By default, the search filter template
       
  2942 -		"(&amp;(LDAPAttr_uid=%v)(objectclass=posixAccount))" is used.
       
  2943 -		
       
  2944 -		The uid for the the search filter is taken from the
       
  2945 -		<A
       
  2946 -HREF="#LDAPATTR"
       
  2947 ->LDAPAttr</A
       
  2948 -> directive	
       
  2949 -		Search filter
       
  2950 -		templates are only supported in mod_ldap v2.7 and later.</P
       
  2951 -><P
       
  2952 ->If specified, the <CODE
       
  2953 -CLASS="OPTION"
       
  2954 ->default-quota<CODE
       
  2955 -CLASS="OPTION"
       
  2956 -> argument
       
  2957 -		specifies the quota limits to use if a user does not have a ftpQuota
       
  2958 -		attribute. This argument is formatted the same way as the ftpQuota
       
  2959 -		LDAP attribute.</CODE
       
  2960 -></CODE
       
  2961 -></P
       
  2962 -></DIV
       
  2963 -><DIV
       
  2964 -CLASS="REFSECT1"
       
  2965 -><A
       
  2966 -NAME="AEN4615"
       
  2967 -></A
       
  2968 -><H2
       
  2969 ->See also</H2
       
  2970 -><P
       
  2971 ->			<A
       
  2972 -HREF="#LDAPATTR"
       
  2973 ->LDAPAttr</A
       
  2974 ->
       
  2975 -		</P
       
  2976 -></DIV
       
  2977 -><DIV
       
  2978 -CLASS="REFSECT1"
       
  2979 -><A
       
  2980 -NAME="AEN4619"
       
  2981 -></A
       
  2982 -><H2
       
  2983 ->Examples</H2
       
  2984 -><P
       
  2985 -></P
       
  2986 -></DIV
       
  2987 -><H1
       
  2988 -><A
       
  2989 -NAME="LDAPDOUIDLOOKUPS"
       
  2990 -></A
       
  2991 ->
       
  2992 -      LDAPDoUIDLookups</H1
       
  2993 -><DIV
       
  2994 -CLASS="REFNAMEDIV"
       
  2995 -><A
       
  2996 -NAME="AEN4630"
       
  2997 -></A
       
  2998 -><H2
       
  2999 ->Name</H2
       
  3000 ->LDAPDoUIDLookups&nbsp;--&nbsp;      Enable LDAP lookups for UIDs in directory listings
       
  3001 -    </DIV
       
  3002 -><DIV
       
  3003 -CLASS="REFSYNOPSISDIV"
       
  3004 -><A
       
  3005 -NAME="AEN4633"
       
  3006 -></A
       
  3007 -><H2
       
  3008 ->Synopsis</H2
       
  3009 -><P
       
  3010 -><B
       
  3011 -CLASS="COMMAND"
       
  3012 ->LDAPDoUIDLookups</B
       
  3013 ->  [        <CODE
       
  3014 -CLASS="OPTION"
       
  3015 ->on</CODE
       
  3016 ->
       
  3017 -        <CODE
       
  3018 -CLASS="OPTION"
       
  3019 ->off</CODE
       
  3020 ->
       
  3021 -      ] [        <CODE
       
  3022 -CLASS="OPTION"
       
  3023 ->"uid-base-dn"</CODE
       
  3024 ->
       
  3025 -      ] [        <CODE
       
  3026 -CLASS="OPTION"
       
  3027 ->"uid-filter-template"</CODE
       
  3028 ->
       
  3029 -      ]</P
       
  3030 -><P
       
  3031 -></P
       
  3032 -><DIV
       
  3033 -CLASS="VARIABLELIST"
       
  3034 -><P
       
  3035 -><B
       
  3036 -></B
       
  3037 -></P
       
  3038 -><DL
       
  3039 -><DT
       
  3040 -><PRE
       
  3041 -CLASS="SYNOPSIS"
       
  3042 ->Default</PRE
       
  3043 -></DT
       
  3044 -><DD
       
  3045 -><P
       
  3046 ->        LDAPDoUIDLookups off
       
  3047 -      </P
       
  3048 -></DD
       
  3049 -><DT
       
  3050 -><PRE
       
  3051 -CLASS="SYNOPSIS"
       
  3052 ->Context</PRE
       
  3053 -></DT
       
  3054 -><DD
       
  3055 -><P
       
  3056 ->        server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3057 -      </P
       
  3058 -></DD
       
  3059 -><DT
       
  3060 -><PRE
       
  3061 -CLASS="SYNOPSIS"
       
  3062 ->Module</PRE
       
  3063 -></DT
       
  3064 -><DD
       
  3065 -><P
       
  3066 ->mod_ldap
       
  3067 -      </P
       
  3068 -></DD
       
  3069 -><DT
       
  3070 -><PRE
       
  3071 -CLASS="SYNOPSIS"
       
  3072 ->Compatibility</PRE
       
  3073 -></DT
       
  3074 -><DD
       
  3075 -><P
       
  3076 ->        mod_ldap v2.0 and later
       
  3077 -      </P
       
  3078 -></DD
       
  3079 -></DL
       
  3080 -></DIV
       
  3081 -></DIV
       
  3082 -><DIV
       
  3083 -CLASS="REFSECT1"
       
  3084 -><A
       
  3085 -NAME="AEN4665"
       
  3086 -></A
       
  3087 -><H2
       
  3088 ->Description</H2
       
  3089 -><P
       
  3090 ->	This configuration directive activates LDAP UID-to-name
       
  3091 -	lookups in directory listings. The second argument to this directive
       
  3092 -	is the LDAP base DN to use for UID-to-name lookups. The third
       
  3093 -	argument is a template to be used for the search filter; %v will be
       
  3094 -	replaced with the UID that is being looked up. By default, the
       
  3095 -	search filter template
       
  3096 -	"(&amp;(LDAPAttr_uidNumber=%v)(objectclass=posixAccount))" is used.
       
  3097 -	The uid for the the search filter is taken from the
       
  3098 -	<A
       
  3099 -HREF="#LDAPATTR"
       
  3100 ->LDAPAttr</A
       
  3101 -> directive
       
  3102 -	Search
       
  3103 -	filter templates are only supported in mod_ldap v2.7 and
       
  3104 -	later.
       
  3105 -	</P
       
  3106 -></DIV
       
  3107 -><DIV
       
  3108 -CLASS="REFSECT1"
       
  3109 -><A
       
  3110 -NAME="AEN4669"
       
  3111 -></A
       
  3112 -><H2
       
  3113 ->See also</H2
       
  3114 -><P
       
  3115 ->		<A
       
  3116 -HREF="#LDAPATTR"
       
  3117 ->LDAPAttr</A
       
  3118 ->
       
  3119 -	</P
       
  3120 -></DIV
       
  3121 -><DIV
       
  3122 -CLASS="REFSECT1"
       
  3123 -><A
       
  3124 -NAME="AEN4673"
       
  3125 -></A
       
  3126 -><H2
       
  3127 ->Examples</H2
       
  3128 -><P
       
  3129 -></P
       
  3130 -></DIV
       
  3131 -><H1
       
  3132 -><A
       
  3133 -NAME="LDAPFORCEDEFAULTGID"
       
  3134 -></A
       
  3135 ->
       
  3136 -			LDAPForceDefaultGID</H1
       
  3137 -><DIV
       
  3138 -CLASS="REFNAMEDIV"
       
  3139 -><A
       
  3140 -NAME="AEN4684"
       
  3141 -></A
       
  3142 -><H2
       
  3143 ->Name</H2
       
  3144 ->LDAPForceDefaultGID&nbsp;--&nbsp;Force all LDAP-authenticated users to use the same GID.</DIV
       
  3145 -><DIV
       
  3146 -CLASS="REFSYNOPSISDIV"
       
  3147 -><A
       
  3148 -NAME="AEN4687"
       
  3149 -></A
       
  3150 -><H2
       
  3151 ->Synopsis</H2
       
  3152 -><P
       
  3153 -><B
       
  3154 -CLASS="COMMAND"
       
  3155 ->Syntax: LDAPForceDefaultGID</B
       
  3156 ->  [				<CODE
       
  3157 -CLASS="OPTION"
       
  3158 ->on</CODE
       
  3159 ->
       
  3160 -				<CODE
       
  3161 -CLASS="OPTION"
       
  3162 ->off</CODE
       
  3163 ->
       
  3164 -			]</P
       
  3165 -><P
       
  3166 -></P
       
  3167 -><DIV
       
  3168 -CLASS="VARIABLELIST"
       
  3169 -><P
       
  3170 -><B
       
  3171 -></B
       
  3172 -></P
       
  3173 -><DL
       
  3174 -><DT
       
  3175 -><PRE
       
  3176 -CLASS="SYNOPSIS"
       
  3177 ->Default</PRE
       
  3178 -></DT
       
  3179 -><DD
       
  3180 -><P
       
  3181 ->				LDAPForceDefaultGID off
       
  3182 -			</P
       
  3183 -></DD
       
  3184 -><DT
       
  3185 -><PRE
       
  3186 -CLASS="SYNOPSIS"
       
  3187 ->Context</PRE
       
  3188 -></DT
       
  3189 -><DD
       
  3190 -><P
       
  3191 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3192 -			</P
       
  3193 -></DD
       
  3194 -><DT
       
  3195 -><PRE
       
  3196 -CLASS="SYNOPSIS"
       
  3197 ->Module</PRE
       
  3198 -></DT
       
  3199 -><DD
       
  3200 -><P
       
  3201 ->mod_ldap
       
  3202 -			</P
       
  3203 -></DD
       
  3204 -><DT
       
  3205 -><PRE
       
  3206 -CLASS="SYNOPSIS"
       
  3207 ->Compatibility</PRE
       
  3208 -></DT
       
  3209 -><DD
       
  3210 -><P
       
  3211 ->				mod_ldap v2.8 and later
       
  3212 -			</P
       
  3213 -></DD
       
  3214 -></DL
       
  3215 -></DIV
       
  3216 -></DIV
       
  3217 -><DIV
       
  3218 -CLASS="REFSECT1"
       
  3219 -><A
       
  3220 -NAME="AEN4715"
       
  3221 -></A
       
  3222 -><H2
       
  3223 ->Description</H2
       
  3224 -><P
       
  3225 ->Even when a <A
       
  3226 -HREF="#LDAPDEFAULTGID"
       
  3227 ->LDAPDefaultGID</A
       
  3228 ->
       
  3229 -		is configured, mod_ldap will allow individual users to have
       
  3230 -		gidNumber attributes that will override this default GID. With
       
  3231 -		LDAPForceDefaultGID enabled, all LDAP-authenticated users are given
       
  3232 -		the default GID; GIDs may not be overridden by gidNumber
       
  3233 -		attributes.</P
       
  3234 -></DIV
       
  3235 -><DIV
       
  3236 -CLASS="REFSECT1"
       
  3237 -><A
       
  3238 -NAME="AEN4719"
       
  3239 -></A
       
  3240 -><H2
       
  3241 ->See also</H2
       
  3242 -><P
       
  3243 -></P
       
  3244 -></DIV
       
  3245 -><DIV
       
  3246 -CLASS="REFSECT1"
       
  3247 -><A
       
  3248 -NAME="AEN4722"
       
  3249 -></A
       
  3250 -><H2
       
  3251 ->Examples</H2
       
  3252 -><P
       
  3253 -></P
       
  3254 -></DIV
       
  3255 -><H1
       
  3256 -><A
       
  3257 -NAME="LDAPFORCEDEFAULTUID"
       
  3258 -></A
       
  3259 ->
       
  3260 -			LDAPForceDefaultUID</H1
       
  3261 -><DIV
       
  3262 -CLASS="REFNAMEDIV"
       
  3263 -><A
       
  3264 -NAME="AEN4733"
       
  3265 -></A
       
  3266 -><H2
       
  3267 ->Name</H2
       
  3268 ->LDAPForceDefaultUID&nbsp;--&nbsp;Force all LDAP-authenticated users to use the same UID.</DIV
       
  3269 -><DIV
       
  3270 -CLASS="REFSYNOPSISDIV"
       
  3271 -><A
       
  3272 -NAME="AEN4736"
       
  3273 -></A
       
  3274 -><H2
       
  3275 ->Synopsis</H2
       
  3276 -><P
       
  3277 -><B
       
  3278 -CLASS="COMMAND"
       
  3279 ->Syntax: LDAPForceDefaultUID</B
       
  3280 ->  [				<CODE
       
  3281 -CLASS="OPTION"
       
  3282 ->on</CODE
       
  3283 ->
       
  3284 -				<CODE
       
  3285 -CLASS="OPTION"
       
  3286 ->off</CODE
       
  3287 ->
       
  3288 -			]</P
       
  3289 -><P
       
  3290 -></P
       
  3291 -><DIV
       
  3292 -CLASS="VARIABLELIST"
       
  3293 -><P
       
  3294 -><B
       
  3295 -></B
       
  3296 -></P
       
  3297 -><DL
       
  3298 -><DT
       
  3299 -><PRE
       
  3300 -CLASS="SYNOPSIS"
       
  3301 ->Default</PRE
       
  3302 -></DT
       
  3303 -><DD
       
  3304 -><P
       
  3305 ->				LDAPForceDefaultUID off
       
  3306 -			</P
       
  3307 -></DD
       
  3308 -><DT
       
  3309 -><PRE
       
  3310 -CLASS="SYNOPSIS"
       
  3311 ->Context</PRE
       
  3312 -></DT
       
  3313 -><DD
       
  3314 -><P
       
  3315 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3316 -			</P
       
  3317 -></DD
       
  3318 -><DT
       
  3319 -><PRE
       
  3320 -CLASS="SYNOPSIS"
       
  3321 ->Module</PRE
       
  3322 -></DT
       
  3323 -><DD
       
  3324 -><P
       
  3325 ->mod_ldap
       
  3326 -			</P
       
  3327 -></DD
       
  3328 -><DT
       
  3329 -><PRE
       
  3330 -CLASS="SYNOPSIS"
       
  3331 ->Compatibility</PRE
       
  3332 -></DT
       
  3333 -><DD
       
  3334 -><P
       
  3335 ->				mod_ldap v2.8 and later
       
  3336 -			</P
       
  3337 -></DD
       
  3338 -></DL
       
  3339 -></DIV
       
  3340 -></DIV
       
  3341 -><DIV
       
  3342 -CLASS="REFSECT1"
       
  3343 -><A
       
  3344 -NAME="AEN4764"
       
  3345 -></A
       
  3346 -><H2
       
  3347 ->Description</H2
       
  3348 -><P
       
  3349 ->Even when a <A
       
  3350 -HREF="#LDAPDEFAULTUID"
       
  3351 ->LDAPDefaultUID</A
       
  3352 ->
       
  3353 -		is configured, mod_ldap will allow individual users to have
       
  3354 -		uidNumber attributes that will override this default UID. With
       
  3355 -		LDAPForceDefaultUID enabled, all LDAP-authenticated users are given
       
  3356 -		the default UID; UIDs may not be overridden by uidNumber
       
  3357 -		attributes.</P
       
  3358 -></DIV
       
  3359 -><DIV
       
  3360 -CLASS="REFSECT1"
       
  3361 -><A
       
  3362 -NAME="AEN4768"
       
  3363 -></A
       
  3364 -><H2
       
  3365 ->See also</H2
       
  3366 -><P
       
  3367 -></P
       
  3368 -></DIV
       
  3369 -><DIV
       
  3370 -CLASS="REFSECT1"
       
  3371 -><A
       
  3372 -NAME="AEN4771"
       
  3373 -></A
       
  3374 -><H2
       
  3375 ->Examples</H2
       
  3376 -><P
       
  3377 -></P
       
  3378 -></DIV
       
  3379 -><H1
       
  3380 -><A
       
  3381 -NAME="LDAPFORCEGENERATEDHOMEDIR"
       
  3382 -></A
       
  3383 ->
       
  3384 -      LDAPForceGeneratedHomedir</H1
       
  3385 -><DIV
       
  3386 -CLASS="REFNAMEDIV"
       
  3387 -><A
       
  3388 -NAME="AEN4782"
       
  3389 -></A
       
  3390 -><H2
       
  3391 ->Name</H2
       
  3392 ->LDAPForceGeneratedHomedir&nbsp;--&nbsp;      Force all LDAP-authenticated users to use the default HomeDironDemand
       
  3393 -      prefix/suffix.
       
  3394 -    </DIV
       
  3395 -><DIV
       
  3396 -CLASS="REFSYNOPSISDIV"
       
  3397 -><A
       
  3398 -NAME="AEN4785"
       
  3399 -></A
       
  3400 -><H2
       
  3401 ->Synopsis</H2
       
  3402 -><P
       
  3403 -><B
       
  3404 -CLASS="COMMAND"
       
  3405 ->LDAPForceGeneratedHomedir</B
       
  3406 ->  [        <CODE
       
  3407 -CLASS="OPTION"
       
  3408 ->on</CODE
       
  3409 ->
       
  3410 -        <CODE
       
  3411 -CLASS="OPTION"
       
  3412 ->off</CODE
       
  3413 ->
       
  3414 -      ] [        <CODE
       
  3415 -CLASS="OPTION"
       
  3416 ->directory-mode</CODE
       
  3417 ->
       
  3418 -      ]</P
       
  3419 -><P
       
  3420 -></P
       
  3421 -><DIV
       
  3422 -CLASS="VARIABLELIST"
       
  3423 -><P
       
  3424 -><B
       
  3425 -></B
       
  3426 -></P
       
  3427 -><DL
       
  3428 -><DT
       
  3429 -><PRE
       
  3430 -CLASS="SYNOPSIS"
       
  3431 ->Default</PRE
       
  3432 -></DT
       
  3433 -><DD
       
  3434 -><P
       
  3435 ->        LDAPForceGeneratedHomedir off
       
  3436 -      </P
       
  3437 -></DD
       
  3438 -><DT
       
  3439 -><PRE
       
  3440 -CLASS="SYNOPSIS"
       
  3441 ->Context</PRE
       
  3442 -></DT
       
  3443 -><DD
       
  3444 -><P
       
  3445 ->        server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3446 -      </P
       
  3447 -></DD
       
  3448 -><DT
       
  3449 -><PRE
       
  3450 -CLASS="SYNOPSIS"
       
  3451 ->Module</PRE
       
  3452 -></DT
       
  3453 -><DD
       
  3454 -><P
       
  3455 ->mod_ldap</P
       
  3456 -></DD
       
  3457 -><DT
       
  3458 -><PRE
       
  3459 -CLASS="SYNOPSIS"
       
  3460 ->Compatibility</PRE
       
  3461 -></DT
       
  3462 -><DD
       
  3463 -><P
       
  3464 ->        mod_ldap v2.8.13 and later
       
  3465 -      </P
       
  3466 -></DD
       
  3467 -></DL
       
  3468 -></DIV
       
  3469 -></DIV
       
  3470 -><DIV
       
  3471 -CLASS="REFSECT1"
       
  3472 -><A
       
  3473 -NAME="AEN4815"
       
  3474 -></A
       
  3475 -><H2
       
  3476 ->Description</H2
       
  3477 -><P
       
  3478 ->Even when a
       
  3479 -    <A
       
  3480 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
  3481 ->LDAPGenerateHomedirPrefix</A
       
  3482 ->
       
  3483 -    is configured, mod_ldap will allow individual users to have
       
  3484 -    homeDirectory attributes that will override the default. With
       
  3485 -    LDAPForceHomeDironDemand enabled, all LDAP-authenticated users are given
       
  3486 -    the default prefix and/or suffix; homedirs may not be overridden by LDAP
       
  3487 -    homeDirectory attributes.</P
       
  3488 -></DIV
       
  3489 -><DIV
       
  3490 -CLASS="REFSECT1"
       
  3491 -><A
       
  3492 -NAME="AEN4819"
       
  3493 -></A
       
  3494 -><H2
       
  3495 ->See also</H2
       
  3496 -><P
       
  3497 ->	<A
       
  3498 -HREF="#LDAPGENERATEHOMEDIR"
       
  3499 ->LDAPGenerateHomedir</A
       
  3500 ->
       
  3501 -	<A
       
  3502 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
  3503 ->LDAPGenerateHomedirPrefix</A
       
  3504 ->
       
  3505 -	<A
       
  3506 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
  3507 ->LDAPGenerateHomedirPrefixNoUsername</A
       
  3508 ->
       
  3509 -   </P
       
  3510 -></DIV
       
  3511 -><DIV
       
  3512 -CLASS="REFSECT1"
       
  3513 -><A
       
  3514 -NAME="AEN4825"
       
  3515 -></A
       
  3516 -><H2
       
  3517 ->Examples</H2
       
  3518 -><P
       
  3519 -></P
       
  3520 -></DIV
       
  3521 -><H1
       
  3522 -><A
       
  3523 -NAME="LDAPFORCEHOMEDIRONDEMAND"
       
  3524 -></A
       
  3525 ->
       
  3526 -      LDAPForceHomedirOnDemand</H1
       
  3527 -><DIV
       
  3528 -CLASS="REFNAMEDIV"
       
  3529 -><A
       
  3530 -NAME="AEN4836"
       
  3531 -></A
       
  3532 -><H2
       
  3533 ->Name</H2
       
  3534 ->LDAPForceHomedirOnDemand&nbsp;--&nbsp;      Force all LDAP-authenticated users to use the default HomeDironDemand
       
  3535 -      prefix/suffix. [deprecated]
       
  3536 -    </DIV
       
  3537 -><DIV
       
  3538 -CLASS="REFSYNOPSISDIV"
       
  3539 -><A
       
  3540 -NAME="AEN4839"
       
  3541 -></A
       
  3542 -><H2
       
  3543 ->Synopsis</H2
       
  3544 -><P
       
  3545 -><B
       
  3546 -CLASS="COMMAND"
       
  3547 ->LDAPForceHomedirOnDemand</B
       
  3548 ->  [        <CODE
       
  3549 -CLASS="OPTION"
       
  3550 ->on</CODE
       
  3551 ->
       
  3552 -        <CODE
       
  3553 -CLASS="OPTION"
       
  3554 ->off</CODE
       
  3555 ->
       
  3556 -      ] [        <CODE
       
  3557 -CLASS="OPTION"
       
  3558 ->directory-mode</CODE
       
  3559 ->
       
  3560 -      ]</P
       
  3561 -><P
       
  3562 -></P
       
  3563 -><DIV
       
  3564 -CLASS="VARIABLELIST"
       
  3565 -><P
       
  3566 -><B
       
  3567 -></B
       
  3568 -></P
       
  3569 -><DL
       
  3570 -><DT
       
  3571 -><PRE
       
  3572 -CLASS="SYNOPSIS"
       
  3573 ->Default</PRE
       
  3574 -></DT
       
  3575 -><DD
       
  3576 -><P
       
  3577 ->        LDAPForceHomedirOnDemand off
       
  3578 -      </P
       
  3579 -></DD
       
  3580 -><DT
       
  3581 -><PRE
       
  3582 -CLASS="SYNOPSIS"
       
  3583 ->Context</PRE
       
  3584 -></DT
       
  3585 -><DD
       
  3586 -><P
       
  3587 ->        server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3588 -      </P
       
  3589 -></DD
       
  3590 -><DT
       
  3591 -><PRE
       
  3592 -CLASS="SYNOPSIS"
       
  3593 ->Module</PRE
       
  3594 -></DT
       
  3595 -><DD
       
  3596 -><P
       
  3597 ->mod_ldap</P
       
  3598 -></DD
       
  3599 -><DT
       
  3600 -><PRE
       
  3601 -CLASS="SYNOPSIS"
       
  3602 ->Compatibility</PRE
       
  3603 -></DT
       
  3604 -><DD
       
  3605 -><P
       
  3606 ->        mod_ldap v2.8.11 and later
       
  3607 -      </P
       
  3608 -></DD
       
  3609 -></DL
       
  3610 -></DIV
       
  3611 -></DIV
       
  3612 -><DIV
       
  3613 -CLASS="REFSECT1"
       
  3614 -><A
       
  3615 -NAME="AEN4869"
       
  3616 -></A
       
  3617 -><H2
       
  3618 ->Description</H2
       
  3619 -><P
       
  3620 ->This directive has been deprecated with mod_ldap v2.8.13.
       
  3621 -	  Please take a look at LDAPForceGenerateHomedir
       
  3622 -    </P
       
  3623 -><P
       
  3624 ->Even when a
       
  3625 -    <A
       
  3626 -HREF="#LDAPHOMEDIRONDEMANDPREFIX"
       
  3627 ->LDAPHomeDironDemandPrefix</A
       
  3628 ->
       
  3629 -    is configured, mod_ldap will allow individual users to have
       
  3630 -    homeDirectory attributes that will override the default. With
       
  3631 -    LDAPForceHomeDironDemand enabled, all LDAP-authenticated users are given
       
  3632 -    the default prefix and/or suffix; homedirs may not be overridden by LDAP
       
  3633 -    homeDirectory attributes.</P
       
  3634 -></DIV
       
  3635 -><DIV
       
  3636 -CLASS="REFSECT1"
       
  3637 -><A
       
  3638 -NAME="AEN4875"
       
  3639 -></A
       
  3640 -><H2
       
  3641 ->See also</H2
       
  3642 -><P
       
  3643 ->LDAPForceGenerateHomedir</P
       
  3644 -></DIV
       
  3645 -><DIV
       
  3646 -CLASS="REFSECT1"
       
  3647 -><A
       
  3648 -NAME="AEN4879"
       
  3649 -></A
       
  3650 -><H2
       
  3651 ->Examples</H2
       
  3652 -><P
       
  3653 -></P
       
  3654 -></DIV
       
  3655 -><H1
       
  3656 -><A
       
  3657 -NAME="LDAPGENERATEHOMEDIR"
       
  3658 -></A
       
  3659 ->
       
  3660 -			LDAPGenerateHomedir</H1
       
  3661 -><DIV
       
  3662 -CLASS="REFNAMEDIV"
       
  3663 -><A
       
  3664 -NAME="AEN4890"
       
  3665 -></A
       
  3666 -><H2
       
  3667 ->Name</H2
       
  3668 ->LDAPGenerateHomedir&nbsp;--&nbsp;			Enable the creation of user home directories on demand
       
  3669 -		</DIV
       
  3670 -><DIV
       
  3671 -CLASS="REFSYNOPSISDIV"
       
  3672 -><A
       
  3673 -NAME="AEN4893"
       
  3674 -></A
       
  3675 -><H2
       
  3676 ->Synopsis</H2
       
  3677 -><P
       
  3678 -><B
       
  3679 -CLASS="COMMAND"
       
  3680 ->LDAPGenerateHomedir</B
       
  3681 ->  [				<CODE
       
  3682 -CLASS="OPTION"
       
  3683 ->on</CODE
       
  3684 ->
       
  3685 -				<CODE
       
  3686 -CLASS="OPTION"
       
  3687 ->off</CODE
       
  3688 ->
       
  3689 -			] [				<CODE
       
  3690 -CLASS="OPTION"
       
  3691 ->directory-mode</CODE
       
  3692 ->
       
  3693 -			]</P
       
  3694 -><P
       
  3695 -></P
       
  3696 -><DIV
       
  3697 -CLASS="VARIABLELIST"
       
  3698 -><P
       
  3699 -><B
       
  3700 -></B
       
  3701 -></P
       
  3702 -><DL
       
  3703 -><DT
       
  3704 -><PRE
       
  3705 -CLASS="SYNOPSIS"
       
  3706 ->Default</PRE
       
  3707 -></DT
       
  3708 -><DD
       
  3709 -><P
       
  3710 ->				LDAPGenerateHomedir off
       
  3711 -			</P
       
  3712 -></DD
       
  3713 -><DT
       
  3714 -><PRE
       
  3715 -CLASS="SYNOPSIS"
       
  3716 ->Context</PRE
       
  3717 -></DT
       
  3718 -><DD
       
  3719 -><P
       
  3720 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3721 -			</P
       
  3722 -></DD
       
  3723 -><DT
       
  3724 -><PRE
       
  3725 -CLASS="SYNOPSIS"
       
  3726 ->Module</PRE
       
  3727 -></DT
       
  3728 -><DD
       
  3729 -><P
       
  3730 ->mod_ldap
       
  3731 -			</P
       
  3732 -></DD
       
  3733 -><DT
       
  3734 -><PRE
       
  3735 -CLASS="SYNOPSIS"
       
  3736 ->Compatibility</PRE
       
  3737 -></DT
       
  3738 -><DD
       
  3739 -><P
       
  3740 ->				mod_ldap v2.8.13 and later
       
  3741 -			</P
       
  3742 -></DD
       
  3743 -></DL
       
  3744 -></DIV
       
  3745 -></DIV
       
  3746 -><DIV
       
  3747 -CLASS="REFSECT1"
       
  3748 -><A
       
  3749 -NAME="AEN4923"
       
  3750 -></A
       
  3751 -><H2
       
  3752 ->Description</H2
       
  3753 -><P
       
  3754 ->LDAPGenerateHomedir activates on-demand home directory creation.
       
  3755 -		If a user logs in and does not yet have a home directory, a home
       
  3756 -		directory is created automatically.</P
       
  3757 -><P
       
  3758 ->In mod_ldap &#60;= 2.7.6, the home directory will be owned by the
       
  3759 -		same user and group that ProFTPD runs as (see the User and Group
       
  3760 -		configuration directives). mod_ldap &#62;= 2.8 can create home
       
  3761 -		directories for users with any UID/GID, not just those with the same
       
  3762 -		UID/GID as the main ProFTPD server.</P
       
  3763 -><P
       
  3764 ->The second argument allows you to specify the mode (default
       
  3765 -		permissions) to use when creating home directories on demand,
       
  3766 -		subject to ProFTPD's umask (see the Umask directive). If no
       
  3767 -		directory mode is specified, the default of 0755 is used. Directory
       
  3768 -		mode setting is only supported in mod_ldap v2.7 or later.</P
       
  3769 -></DIV
       
  3770 -><DIV
       
  3771 -CLASS="REFSECT1"
       
  3772 -><A
       
  3773 -NAME="AEN4928"
       
  3774 -></A
       
  3775 -><H2
       
  3776 ->See also</H2
       
  3777 -><P
       
  3778 ->		<A
       
  3779 -HREF="#LDAPFORCEGENERATEDHOMEDIR"
       
  3780 ->LDAPForceGeneratedHomedir</A
       
  3781 ->
       
  3782 -		<A
       
  3783 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
  3784 ->LDAPGenerateHomedirPrefix</A
       
  3785 ->
       
  3786 -		<A
       
  3787 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
  3788 ->LDAPGenerateHomedirPrefixNoUsername</A
       
  3789 ->
       
  3790 -		</P
       
  3791 -></DIV
       
  3792 -><DIV
       
  3793 -CLASS="REFSECT1"
       
  3794 -><A
       
  3795 -NAME="AEN4934"
       
  3796 -></A
       
  3797 -><H2
       
  3798 ->Examples</H2
       
  3799 -><P
       
  3800 -></P
       
  3801 -></DIV
       
  3802 ->%<H1
       
  3803 -><A
       
  3804 -NAME="LDAPGENERATEHOMEDIRPREFIX"
       
  3805 -></A
       
  3806 ->
       
  3807 -			LDAPGenerateHomedirPrefix</H1
       
  3808 -><DIV
       
  3809 -CLASS="REFNAMEDIV"
       
  3810 -><A
       
  3811 -NAME="AEN4945"
       
  3812 -></A
       
  3813 -><H2
       
  3814 ->Name</H2
       
  3815 ->LDAPGenerateHomedirPrefix&nbsp;--&nbsp;			Enable the creation of user home directories on demand
       
  3816 -		</DIV
       
  3817 -><DIV
       
  3818 -CLASS="REFSYNOPSISDIV"
       
  3819 -><A
       
  3820 -NAME="AEN4948"
       
  3821 -></A
       
  3822 -><H2
       
  3823 ->Synopsis</H2
       
  3824 -><P
       
  3825 -><B
       
  3826 -CLASS="COMMAND"
       
  3827 ->LDAPGenerateHomedirPrefix</B
       
  3828 ->  [				<CODE
       
  3829 -CLASS="OPTION"
       
  3830 ->leading-path</CODE
       
  3831 ->
       
  3832 -			]</P
       
  3833 -><P
       
  3834 -></P
       
  3835 -><DIV
       
  3836 -CLASS="VARIABLELIST"
       
  3837 -><P
       
  3838 -><B
       
  3839 -></B
       
  3840 -></P
       
  3841 -><DL
       
  3842 -><DT
       
  3843 -><PRE
       
  3844 -CLASS="SYNOPSIS"
       
  3845 ->Default</PRE
       
  3846 -></DT
       
  3847 -><DD
       
  3848 -><P
       
  3849 ->				LDAPGenerateHomedirPrefix off
       
  3850 -			</P
       
  3851 -></DD
       
  3852 -><DT
       
  3853 -><PRE
       
  3854 -CLASS="SYNOPSIS"
       
  3855 ->Context</PRE
       
  3856 -></DT
       
  3857 -><DD
       
  3858 -><P
       
  3859 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  3860 -			</P
       
  3861 -></DD
       
  3862 -><DT
       
  3863 -><PRE
       
  3864 -CLASS="SYNOPSIS"
       
  3865 ->Module</PRE
       
  3866 -></DT
       
  3867 -><DD
       
  3868 -><P
       
  3869 ->mod_ldap
       
  3870 -			</P
       
  3871 -></DD
       
  3872 -><DT
       
  3873 -><PRE
       
  3874 -CLASS="SYNOPSIS"
       
  3875 ->Compatibility</PRE
       
  3876 -></DT
       
  3877 -><DD
       
  3878 -><P
       
  3879 ->				mod_ldap v2.8.13 and later
       
  3880 -			</P
       
  3881 -></DD
       
  3882 -></DL
       
  3883 -></DIV
       
  3884 -></DIV
       
  3885 -><DIV
       
  3886 -CLASS="REFSECT1"
       
  3887 -><A
       
  3888 -NAME="AEN4975"
       
  3889 -></A
       
  3890 -><H2
       
  3891 ->Description</H2
       
  3892 -><P
       
  3893 ->LDAPGenerateHomedirPrefix enables a prefix to be specified for
       
  3894 -		on-demand home directory creation. This is most useful if mod_ldap
       
  3895 -		is being used to authenticate against an LDAP directory that does
       
  3896 -		not return a homeDirectory attribute, either because it cannot
       
  3897 -		(Microsoft Active Directory, for example) or because you do not wish
       
  3898 -		to extend your existing directory schema.</P
       
  3899 -><P
       
  3900 ->For example, setting this directive to "/home" and logging in
       
  3901 -		as the user "joe" would result in his home directory being created
       
  3902 -		as "/home/joe". The directory will be created with the mode
       
  3903 -		specified in <A
       
  3904 -HREF="#LDAPGENERATEHOMEDIR"
       
  3905 ->LDAPGenerateHomedir</A
       
  3906 ->.  To use
       
  3907 -		this directive, <A
       
  3908 -HREF="#LDAPGENERATEHOMEDIR"
       
  3909 ->LDAPGenerateHomedir</A
       
  3910 -> must be
       
  3911 -		enabled.</P
       
  3912 -></DIV
       
  3913 -><DIV
       
  3914 -CLASS="REFSECT1"
       
  3915 -><A
       
  3916 -NAME="AEN4981"
       
  3917 -></A
       
  3918 -><H2
       
  3919 ->See also</H2
       
  3920 -><P
       
  3921 ->		<A
       
  3922 -HREF="#LDAPFORCEGENERATEDHOMEDIR"
       
  3923 ->LDAPForceGeneratedHomedir</A
       
  3924 ->
       
  3925 -		<A
       
  3926 -HREF="#LDAPGENERATEHOMEDIR"
       
  3927 ->LDAPGenerateHomedir</A
       
  3928 ->
       
  3929 -		<A
       
  3930 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
  3931 ->LDAPGenerateHomedirPrefixNoUsername</A
       
  3932 ->
       
  3933 -		</P
       
  3934 -></DIV
       
  3935 -><DIV
       
  3936 -CLASS="REFSECT1"
       
  3937 -><A
       
  3938 -NAME="AEN4987"
       
  3939 -></A
       
  3940 -><H2
       
  3941 ->Examples</H2
       
  3942 -><P
       
  3943 -></P
       
  3944 -></DIV
       
  3945 -><H1
       
  3946 -><A
       
  3947 -NAME="LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
  3948 -></A
       
  3949 ->
       
  3950 -LDAPGenerateHomedirPrefixNoUsername</H1
       
  3951 -><DIV
       
  3952 -CLASS="REFNAMEDIV"
       
  3953 -><A
       
  3954 -NAME="AEN4998"
       
  3955 -></A
       
  3956 -><H2
       
  3957 ->Name</H2
       
  3958 ->LDAPGenerateHomedirPrefixNoUsername&nbsp;--&nbsp;(docs incomplete)</DIV
       
  3959 -><DIV
       
  3960 -CLASS="REFSYNOPSISDIV"
       
  3961 -><A
       
  3962 -NAME="AEN5001"
       
  3963 -></A
       
  3964 -><H2
       
  3965 ->Synopsis</H2
       
  3966 -><P
       
  3967 -><B
       
  3968 -CLASS="COMMAND"
       
  3969 ->LDAPGenerateHomedirPrefixNoUsername</B
       
  3970 ->  [  <CODE
       
  3971 -CLASS="OPTION"
       
  3972 ->on</CODE
       
  3973 ->
       
  3974 -  <CODE
       
  3975 -CLASS="OPTION"
       
  3976 ->off</CODE
       
  3977 ->]</P
       
  3978 -><P
       
  3979 -></P
       
  3980 -><DIV
       
  3981 -CLASS="VARIABLELIST"
       
  3982 -><P
       
  3983 -><B
       
  3984 -></B
       
  3985 -></P
       
  3986 -><DL
       
  3987 -><DT
       
  3988 -><PRE
       
  3989 -CLASS="SYNOPSIS"
       
  3990 ->Default</PRE
       
  3991 -></DT
       
  3992 -><DD
       
  3993 -><P
       
  3994 ->(docs incomplete)</P
       
  3995 -></DD
       
  3996 -><DT
       
  3997 -><PRE
       
  3998 -CLASS="SYNOPSIS"
       
  3999 ->Context</PRE
       
  4000 -></DT
       
  4001 -><DD
       
  4002 -><P
       
  4003 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;, .ftpaccess</P
       
  4004 -></DD
       
  4005 -><DT
       
  4006 -><PRE
       
  4007 -CLASS="SYNOPSIS"
       
  4008 ->Module</PRE
       
  4009 -></DT
       
  4010 -><DD
       
  4011 -><P
       
  4012 ->mod_ldap</P
       
  4013 -></DD
       
  4014 -><DT
       
  4015 -><PRE
       
  4016 -CLASS="SYNOPSIS"
       
  4017 ->Compatibility</PRE
       
  4018 -></DT
       
  4019 -><DD
       
  4020 -><P
       
  4021 ->mod_ldap 2.8.13 and later</P
       
  4022 -></DD
       
  4023 -></DL
       
  4024 -></DIV
       
  4025 -></DIV
       
  4026 -><DIV
       
  4027 -CLASS="REFSECT1"
       
  4028 -><A
       
  4029 -NAME="AEN5029"
       
  4030 -></A
       
  4031 -><H2
       
  4032 ->Description</H2
       
  4033 -><P
       
  4034 ->(docs incomplete)</P
       
  4035 -></DIV
       
  4036 -><DIV
       
  4037 -CLASS="REFSECT1"
       
  4038 -><A
       
  4039 -NAME="AEN5032"
       
  4040 -></A
       
  4041 -><H2
       
  4042 ->See also</H2
       
  4043 -><P
       
  4044 ->		<A
       
  4045 -HREF="#LDAPFORCEGENERATEDHOMEDIR"
       
  4046 ->LDAPForceGeneratedHomedir</A
       
  4047 ->
       
  4048 -		<A
       
  4049 -HREF="#LDAPGENERATEHOMEDIR"
       
  4050 ->LDAPGenerateHomedir</A
       
  4051 ->
       
  4052 -		<A
       
  4053 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
  4054 ->LDAPGenerateHomedirPrefix</A
       
  4055 -></P
       
  4056 -></DIV
       
  4057 -><H1
       
  4058 -><A
       
  4059 -NAME="LDAPHOMEDIRONDEMAND"
       
  4060 -></A
       
  4061 ->
       
  4062 -			LDAPHomedirOnDemand</H1
       
  4063 -><DIV
       
  4064 -CLASS="REFNAMEDIV"
       
  4065 -><A
       
  4066 -NAME="AEN5046"
       
  4067 -></A
       
  4068 -><H2
       
  4069 ->Name</H2
       
  4070 ->LDAPHomedirOnDemand&nbsp;--&nbsp;			Enable the creation of user home directories on demand [deprecated]
       
  4071 -		</DIV
       
  4072 -><DIV
       
  4073 -CLASS="REFSYNOPSISDIV"
       
  4074 -><A
       
  4075 -NAME="AEN5049"
       
  4076 -></A
       
  4077 -><H2
       
  4078 ->Synopsis</H2
       
  4079 -><P
       
  4080 -><B
       
  4081 -CLASS="COMMAND"
       
  4082 ->LDAPHomedirOnDemand</B
       
  4083 ->  [				<CODE
       
  4084 -CLASS="OPTION"
       
  4085 ->on</CODE
       
  4086 ->
       
  4087 -				<CODE
       
  4088 -CLASS="OPTION"
       
  4089 ->off</CODE
       
  4090 ->
       
  4091 -			] [				<CODE
       
  4092 -CLASS="OPTION"
       
  4093 ->directory-mode</CODE
       
  4094 ->
       
  4095 -			]</P
       
  4096 -><P
       
  4097 -></P
       
  4098 -><DIV
       
  4099 -CLASS="VARIABLELIST"
       
  4100 -><P
       
  4101 -><B
       
  4102 -></B
       
  4103 -></P
       
  4104 -><DL
       
  4105 -><DT
       
  4106 -><PRE
       
  4107 -CLASS="SYNOPSIS"
       
  4108 ->Default</PRE
       
  4109 -></DT
       
  4110 -><DD
       
  4111 -><P
       
  4112 ->				LDAPHomedirOnDemand off
       
  4113 -			</P
       
  4114 -></DD
       
  4115 -><DT
       
  4116 -><PRE
       
  4117 -CLASS="SYNOPSIS"
       
  4118 ->Context</PRE
       
  4119 -></DT
       
  4120 -><DD
       
  4121 -><P
       
  4122 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  4123 -			</P
       
  4124 -></DD
       
  4125 -><DT
       
  4126 -><PRE
       
  4127 -CLASS="SYNOPSIS"
       
  4128 ->Module</PRE
       
  4129 -></DT
       
  4130 -><DD
       
  4131 -><P
       
  4132 ->mod_ldap
       
  4133 -			</P
       
  4134 -></DD
       
  4135 -><DT
       
  4136 -><PRE
       
  4137 -CLASS="SYNOPSIS"
       
  4138 ->Compatibility</PRE
       
  4139 -></DT
       
  4140 -><DD
       
  4141 -><P
       
  4142 ->				mod_ldap v2.0 and later
       
  4143 -			</P
       
  4144 -></DD
       
  4145 -></DL
       
  4146 -></DIV
       
  4147 -></DIV
       
  4148 -><DIV
       
  4149 -CLASS="REFSECT1"
       
  4150 -><A
       
  4151 -NAME="AEN5079"
       
  4152 -></A
       
  4153 -><H2
       
  4154 ->Description</H2
       
  4155 -><P
       
  4156 ->This directive has been deprecated with mod_ldap v2.8.13.
       
  4157 -	  	Please take a look at <A
       
  4158 -HREF="#LDAPGENERATEHOMEDIR"
       
  4159 ->LDAPGenerateHomedir</A
       
  4160 ->
       
  4161 -		</P
       
  4162 -><P
       
  4163 ->LDAPHomedirOnDemand activates on-demand home directory creation.
       
  4164 -		If a user logs in and does not yet have a home directory, a home
       
  4165 -		directory is created automatically.</P
       
  4166 -><P
       
  4167 ->In mod_ldap &#60;= 2.7.6, the home directory will be owned by the
       
  4168 -		same user and group that ProFTPD runs as (see the User and Group
       
  4169 -		configuration directives). mod_ldap &#62;= 2.8 can create home
       
  4170 -		directories for users with any UID/GID, not just those with the same
       
  4171 -		UID/GID as the main ProFTPD server.</P
       
  4172 -><P
       
  4173 ->The second argument allows you to specify the mode (default
       
  4174 -		permissions) to use when creating home directories on demand,
       
  4175 -		subject to ProFTPD's umask (see the Umask directive). If no
       
  4176 -		directory mode is specified, the default of 0755 is used. Directory
       
  4177 -		mode setting is only supported in mod_ldap v2.7 or later.</P
       
  4178 -></DIV
       
  4179 -><DIV
       
  4180 -CLASS="REFSECT1"
       
  4181 -><A
       
  4182 -NAME="AEN5086"
       
  4183 -></A
       
  4184 -><H2
       
  4185 ->See also</H2
       
  4186 -><P
       
  4187 -><A
       
  4188 -HREF="#LDAPGENERATEHOMEDIR"
       
  4189 ->LDAPGenerateHomedir</A
       
  4190 -></P
       
  4191 -></DIV
       
  4192 -><DIV
       
  4193 -CLASS="REFSECT1"
       
  4194 -><A
       
  4195 -NAME="AEN5090"
       
  4196 -></A
       
  4197 -><H2
       
  4198 ->Examples</H2
       
  4199 -><P
       
  4200 -></P
       
  4201 -></DIV
       
  4202 -><H1
       
  4203 -><A
       
  4204 -NAME="LDAPHOMEDIRONDEMANDPREFIX"
       
  4205 -></A
       
  4206 ->
       
  4207 -			LDAPHomedirOnDemandPrefix</H1
       
  4208 -><DIV
       
  4209 -CLASS="REFNAMEDIV"
       
  4210 -><A
       
  4211 -NAME="AEN5101"
       
  4212 -></A
       
  4213 -><H2
       
  4214 ->Name</H2
       
  4215 ->LDAPHomedirOnDemandPrefix&nbsp;--&nbsp;			Enable the creation of user home directories on demand [deprecated]
       
  4216 -		</DIV
       
  4217 -><DIV
       
  4218 -CLASS="REFSYNOPSISDIV"
       
  4219 -><A
       
  4220 -NAME="AEN5104"
       
  4221 -></A
       
  4222 -><H2
       
  4223 ->Synopsis</H2
       
  4224 -><P
       
  4225 -><B
       
  4226 -CLASS="COMMAND"
       
  4227 ->LDAPHomedirOnDemandPrefix</B
       
  4228 ->  [				<CODE
       
  4229 -CLASS="OPTION"
       
  4230 ->leading-path</CODE
       
  4231 ->
       
  4232 -			]</P
       
  4233 -><P
       
  4234 -></P
       
  4235 -><DIV
       
  4236 -CLASS="VARIABLELIST"
       
  4237 -><P
       
  4238 -><B
       
  4239 -></B
       
  4240 -></P
       
  4241 -><DL
       
  4242 -><DT
       
  4243 -><PRE
       
  4244 -CLASS="SYNOPSIS"
       
  4245 ->Default</PRE
       
  4246 -></DT
       
  4247 -><DD
       
  4248 -><P
       
  4249 ->				LDAPHomedirOnDemandPrefix off
       
  4250 -			</P
       
  4251 -></DD
       
  4252 -><DT
       
  4253 -><PRE
       
  4254 -CLASS="SYNOPSIS"
       
  4255 ->Context</PRE
       
  4256 -></DT
       
  4257 -><DD
       
  4258 -><P
       
  4259 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  4260 -			</P
       
  4261 -></DD
       
  4262 -><DT
       
  4263 -><PRE
       
  4264 -CLASS="SYNOPSIS"
       
  4265 ->Module</PRE
       
  4266 -></DT
       
  4267 -><DD
       
  4268 -><P
       
  4269 ->mod_ldap
       
  4270 -			</P
       
  4271 -></DD
       
  4272 -><DT
       
  4273 -><PRE
       
  4274 -CLASS="SYNOPSIS"
       
  4275 ->Compatibility</PRE
       
  4276 -></DT
       
  4277 -><DD
       
  4278 -><P
       
  4279 ->				mod_ldap v2.8 and later
       
  4280 -			</P
       
  4281 -></DD
       
  4282 -></DL
       
  4283 -></DIV
       
  4284 -></DIV
       
  4285 -><DIV
       
  4286 -CLASS="REFSECT1"
       
  4287 -><A
       
  4288 -NAME="AEN5131"
       
  4289 -></A
       
  4290 -><H2
       
  4291 ->Description</H2
       
  4292 -><P
       
  4293 ->This directive has been deprecated with mod_ldap v2.8.13.
       
  4294 -	  	Please take a look at <A
       
  4295 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
  4296 ->LDAPGenerateHomedirPrefix</A
       
  4297 ->
       
  4298 -		</P
       
  4299 -><P
       
  4300 ->LDAPHomedirOnDemandPrefix enables a prefix to be specified for
       
  4301 -		on-demand home directory creation. This is most useful if mod_ldap
       
  4302 -		is being used to authenticate against an LDAP directory that does
       
  4303 -		not return a homeDirectory attribute, either because it cannot
       
  4304 -		(Microsoft Active Directory, for example) or because you do not wish
       
  4305 -		to extend your existing directory schema.</P
       
  4306 -><P
       
  4307 ->For example, setting this directive to "/home" and logging in
       
  4308 -		as the user "joe" would result in his home directory being created
       
  4309 -		as "/home/joe". The directory will be created with the mode
       
  4310 -		specified in <A
       
  4311 -HREF="#LDAPHOMEDIRONDEMAND"
       
  4312 ->LDAPHomedirOnDemand</A
       
  4313 ->.  To use
       
  4314 -		this directive, <A
       
  4315 -HREF="#LDAPHOMEDIRONDEMAND"
       
  4316 ->LDAPHomedirOnDemand</A
       
  4317 -> must be
       
  4318 -		enabled.</P
       
  4319 -></DIV
       
  4320 -><DIV
       
  4321 -CLASS="REFSECT1"
       
  4322 -><A
       
  4323 -NAME="AEN5139"
       
  4324 -></A
       
  4325 -><H2
       
  4326 ->See also</H2
       
  4327 -><P
       
  4328 ->		<A
       
  4329 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
  4330 ->LDAPGenerateHomedirPrefix</A
       
  4331 ->
       
  4332 -		</P
       
  4333 -></DIV
       
  4334 -><DIV
       
  4335 -CLASS="REFSECT1"
       
  4336 -><A
       
  4337 -NAME="AEN5143"
       
  4338 -></A
       
  4339 -><H2
       
  4340 ->Examples</H2
       
  4341 -><P
       
  4342 -></P
       
  4343 -></DIV
       
  4344 -><H1
       
  4345 -><A
       
  4346 -NAME="LDAPHOMEDIRONDEMANDPREFIXNOUSERNAME"
       
  4347 -></A
       
  4348 ->
       
  4349 -LDAPHomedirOnDemandPrefixNoUsername</H1
       
  4350 -><DIV
       
  4351 -CLASS="REFNAMEDIV"
       
  4352 -><A
       
  4353 -NAME="AEN5154"
       
  4354 -></A
       
  4355 -><H2
       
  4356 ->Name</H2
       
  4357 ->LDAPHomedirOnDemandPrefixNoUsername&nbsp;--&nbsp;(docs incomplete)</DIV
       
  4358 -><DIV
       
  4359 -CLASS="REFSYNOPSISDIV"
       
  4360 -><A
       
  4361 -NAME="AEN5157"
       
  4362 -></A
       
  4363 -><H2
       
  4364 ->Synopsis</H2
       
  4365 -><P
       
  4366 -><B
       
  4367 -CLASS="COMMAND"
       
  4368 ->LDAPHomedirOnDemandPrefixNoUsername</B
       
  4369 ->  [  <CODE
       
  4370 -CLASS="OPTION"
       
  4371 ->"name" limit|regex|ip value</CODE
       
  4372 ->]</P
       
  4373 -><P
       
  4374 -></P
       
  4375 -><DIV
       
  4376 -CLASS="VARIABLELIST"
       
  4377 -><P
       
  4378 -><B
       
  4379 -></B
       
  4380 -></P
       
  4381 -><DL
       
  4382 -><DT
       
  4383 -><PRE
       
  4384 -CLASS="SYNOPSIS"
       
  4385 ->Default</PRE
       
  4386 -></DT
       
  4387 -><DD
       
  4388 -><P
       
  4389 ->(docs incomplete)</P
       
  4390 -></DD
       
  4391 -><DT
       
  4392 -><PRE
       
  4393 -CLASS="SYNOPSIS"
       
  4394 ->Context</PRE
       
  4395 -></DT
       
  4396 -><DD
       
  4397 -><P
       
  4398 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;, .ftpaccess</P
       
  4399 -></DD
       
  4400 -><DT
       
  4401 -><PRE
       
  4402 -CLASS="SYNOPSIS"
       
  4403 ->Module</PRE
       
  4404 -></DT
       
  4405 -><DD
       
  4406 -><P
       
  4407 ->mod_ldap</P
       
  4408 -></DD
       
  4409 -><DT
       
  4410 -><PRE
       
  4411 -CLASS="SYNOPSIS"
       
  4412 ->Compatibility</PRE
       
  4413 -></DT
       
  4414 -><DD
       
  4415 -><P
       
  4416 ->1.2.5rc1 and later</P
       
  4417 -></DD
       
  4418 -></DL
       
  4419 -></DIV
       
  4420 -></DIV
       
  4421 -><DIV
       
  4422 -CLASS="REFSECT1"
       
  4423 -><A
       
  4424 -NAME="AEN5184"
       
  4425 -></A
       
  4426 -><H2
       
  4427 ->Description</H2
       
  4428 -><P
       
  4429 ->This directive has been deprecated with mod_ldap v2.8.13.
       
  4430 -	Please take a look at <A
       
  4431 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
  4432 ->LDAPGenerateHomedirPrefixNoUsername</A
       
  4433 ->
       
  4434 -	</P
       
  4435 -><P
       
  4436 ->(docs incomplete)</P
       
  4437 -></DIV
       
  4438 -><DIV
       
  4439 -CLASS="REFSECT1"
       
  4440 -><A
       
  4441 -NAME="AEN5189"
       
  4442 -></A
       
  4443 -><H2
       
  4444 ->See also</H2
       
  4445 -><P
       
  4446 -><A
       
  4447 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
  4448 ->LDAPGenerateHomedirPrefixNoUsername</A
       
  4449 -></P
       
  4450 -></DIV
       
  4451 -><H1
       
  4452 -><A
       
  4453 -NAME="LDAPHOMEDIRONDEMANDSUFFIX"
       
  4454 -></A
       
  4455 ->
       
  4456 -			LDAPHomedirOnDemandSuffix</H1
       
  4457 -><DIV
       
  4458 -CLASS="REFNAMEDIV"
       
  4459 -><A
       
  4460 -NAME="AEN5201"
       
  4461 -></A
       
  4462 -><H2
       
  4463 ->Name</H2
       
  4464 ->LDAPHomedirOnDemandSuffix&nbsp;--&nbsp;			Specify an additional directory to be created inside a user's
       
  4465 -			home directory on demand. [deprecated]
       
  4466 -		</DIV
       
  4467 -><DIV
       
  4468 -CLASS="REFSYNOPSISDIV"
       
  4469 -><A
       
  4470 -NAME="AEN5204"
       
  4471 -></A
       
  4472 -><H2
       
  4473 ->Synopsis</H2
       
  4474 -><P
       
  4475 -><B
       
  4476 -CLASS="COMMAND"
       
  4477 ->LDAPHomedirOnDemandSuffix</B
       
  4478 ->  [				<CODE
       
  4479 -CLASS="OPTION"
       
  4480 ->additional-directory1</CODE
       
  4481 ->
       
  4482 -				<CODE
       
  4483 -CLASS="OPTION"
       
  4484 ->additional-directory2</CODE
       
  4485 ->
       
  4486 -				<CODE
       
  4487 -CLASS="OPTION"
       
  4488 ->additional-directory3</CODE
       
  4489 ->
       
  4490 -			]</P
       
  4491 -><P
       
  4492 -></P
       
  4493 -><DIV
       
  4494 -CLASS="VARIABLELIST"
       
  4495 -><P
       
  4496 -><B
       
  4497 -></B
       
  4498 -></P
       
  4499 -><DL
       
  4500 -><DT
       
  4501 -><PRE
       
  4502 -CLASS="SYNOPSIS"
       
  4503 ->Default</PRE
       
  4504 -></DT
       
  4505 -><DD
       
  4506 -><P
       
  4507 ->				LDAPHomedirOnDemandSuffix ""
       
  4508 -			</P
       
  4509 -></DD
       
  4510 -><DT
       
  4511 -><PRE
       
  4512 -CLASS="SYNOPSIS"
       
  4513 ->Context</PRE
       
  4514 -></DT
       
  4515 -><DD
       
  4516 -><P
       
  4517 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  4518 -			</P
       
  4519 -></DD
       
  4520 -><DT
       
  4521 -><PRE
       
  4522 -CLASS="SYNOPSIS"
       
  4523 ->Module</PRE
       
  4524 -></DT
       
  4525 -><DD
       
  4526 -><P
       
  4527 ->mod_ldap
       
  4528 -			</P
       
  4529 -></DD
       
  4530 -><DT
       
  4531 -><PRE
       
  4532 -CLASS="SYNOPSIS"
       
  4533 ->Compatibility</PRE
       
  4534 -></DT
       
  4535 -><DD
       
  4536 -><P
       
  4537 ->				mod_ldap v2.6 and later.
       
  4538 -			</P
       
  4539 -></DD
       
  4540 -></DL
       
  4541 -></DIV
       
  4542 -></DIV
       
  4543 -><DIV
       
  4544 -CLASS="REFSECT1"
       
  4545 -><A
       
  4546 -NAME="AEN5233"
       
  4547 -></A
       
  4548 -><H2
       
  4549 ->Description</H2
       
  4550 -><P
       
  4551 ->		This directive is deprecated and was removed from mod_ldap v2.8.13.
       
  4552 -		It has no replacement option.
       
  4553 -		</P
       
  4554 -><P
       
  4555 ->to be created within a user's home directory when it is
       
  4556 -		created on demand. For example, if a user's home directory is
       
  4557 -		"/home/user", setting this configuration directive to "public_html"
       
  4558 -		will also create "/home/user/public_html" on demand. In mod_ldap
       
  4559 -		v2.7.6 and earlier, you must also activate LDAPHomedirOnDemand in
       
  4560 -		your configuration.</P
       
  4561 -><P
       
  4562 ->mod_ldap &#62;= 2.8 supports multiple suffix arguments and does
       
  4563 -		not require LDAPHomedirOnDemand to be enabled.</P
       
  4564 -><P
       
  4565 ->mod_ldap &#62;= 2.8.11 supports additional mode information;
       
  4566 -		you can add ":octal-mode" to a directory argument to have it created
       
  4567 -		with that mode. For example,
       
  4568 -		LDAPHomedirOnDemandSuffix foo:700 will create the
       
  4569 -		suffix directory foo with the mode 700.</P
       
  4570 -></DIV
       
  4571 -><DIV
       
  4572 -CLASS="REFSECT1"
       
  4573 -><A
       
  4574 -NAME="AEN5239"
       
  4575 -></A
       
  4576 -><H2
       
  4577 ->See also</H2
       
  4578 -><P
       
  4579 -></P
       
  4580 -></DIV
       
  4581 -><DIV
       
  4582 -CLASS="REFSECT1"
       
  4583 -><A
       
  4584 -NAME="AEN5242"
       
  4585 -></A
       
  4586 -><H2
       
  4587 ->Examples</H2
       
  4588 -><P
       
  4589 -></P
       
  4590 -></DIV
       
  4591 -><H1
       
  4592 -><A
       
  4593 -NAME="LDAPNEGATIVECACHE"
       
  4594 -></A
       
  4595 ->
       
  4596 -			LDAPNegativeCache</H1
       
  4597 -><DIV
       
  4598 -CLASS="REFNAMEDIV"
       
  4599 -><A
       
  4600 -NAME="AEN5253"
       
  4601 -></A
       
  4602 -><H2
       
  4603 ->Name</H2
       
  4604 ->LDAPNegativeCache&nbsp;--&nbsp;Enable negative caching for LDAP lookups</DIV
       
  4605 -><DIV
       
  4606 -CLASS="REFSYNOPSISDIV"
       
  4607 -><A
       
  4608 -NAME="AEN5256"
       
  4609 -></A
       
  4610 -><H2
       
  4611 ->Synopsis</H2
       
  4612 -><P
       
  4613 -><B
       
  4614 -CLASS="COMMAND"
       
  4615 ->LDAPNegativeCache</B
       
  4616 ->  [				<CODE
       
  4617 -CLASS="OPTION"
       
  4618 ->on</CODE
       
  4619 ->
       
  4620 -				<CODE
       
  4621 -CLASS="OPTION"
       
  4622 ->off</CODE
       
  4623 ->
       
  4624 -			]</P
       
  4625 -><P
       
  4626 -></P
       
  4627 -><DIV
       
  4628 -CLASS="VARIABLELIST"
       
  4629 -><P
       
  4630 -><B
       
  4631 -></B
       
  4632 -></P
       
  4633 -><DL
       
  4634 -><DT
       
  4635 -><PRE
       
  4636 -CLASS="SYNOPSIS"
       
  4637 ->Default</PRE
       
  4638 -></DT
       
  4639 -><DD
       
  4640 -><P
       
  4641 ->				LDAPNegativeCache off
       
  4642 -			</P
       
  4643 -></DD
       
  4644 -><DT
       
  4645 -><PRE
       
  4646 -CLASS="SYNOPSIS"
       
  4647 ->Context</PRE
       
  4648 -></DT
       
  4649 -><DD
       
  4650 -><P
       
  4651 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  4652 -			</P
       
  4653 -></DD
       
  4654 -><DT
       
  4655 -><PRE
       
  4656 -CLASS="SYNOPSIS"
       
  4657 ->Module</PRE
       
  4658 -></DT
       
  4659 -><DD
       
  4660 -><P
       
  4661 ->mod_ldap
       
  4662 -			</P
       
  4663 -></DD
       
  4664 -><DT
       
  4665 -><PRE
       
  4666 -CLASS="SYNOPSIS"
       
  4667 ->Compatibility</PRE
       
  4668 -></DT
       
  4669 -><DD
       
  4670 -><P
       
  4671 ->				mod_ldap v1.1 and later
       
  4672 -			</P
       
  4673 -></DD
       
  4674 -></DL
       
  4675 -></DIV
       
  4676 -></DIV
       
  4677 -><DIV
       
  4678 -CLASS="REFSECT1"
       
  4679 -><A
       
  4680 -NAME="AEN5284"
       
  4681 -></A
       
  4682 -><H2
       
  4683 ->Description</H2
       
  4684 -><P
       
  4685 ->LDAPNegativeCache specifies whether or not to cache negative
       
  4686 -		responses from the LDAP server when using LDAP for UID/GID lookups.
       
  4687 -		This option is useful if you also use/are in transition from another
       
  4688 -		authentication system; if there are many users in your old
       
  4689 -		authentication system that aren't in the LDAP database, there can be
       
  4690 -		a significant delay when a directory listing is performed as the
       
  4691 -		UIDs not in the LDAP database are repeatedly looked up in an attempt
       
  4692 -		to present usernames instead of UIDs in directory listings. With
       
  4693 -		LDAPNegativeCache set to on, negative ("not found") responses from
       
  4694 -		the LDAP server will be cached and speed will improve on directory
       
  4695 -		listings that contain many users not present in the LDAP
       
  4696 -		database.</P
       
  4697 -></DIV
       
  4698 -><DIV
       
  4699 -CLASS="REFSECT1"
       
  4700 -><A
       
  4701 -NAME="AEN5287"
       
  4702 -></A
       
  4703 -><H2
       
  4704 ->See also</H2
       
  4705 -><P
       
  4706 -></P
       
  4707 -></DIV
       
  4708 -><DIV
       
  4709 -CLASS="REFSECT1"
       
  4710 -><A
       
  4711 -NAME="AEN5290"
       
  4712 -></A
       
  4713 -><H2
       
  4714 ->Examples</H2
       
  4715 -><P
       
  4716 -></P
       
  4717 -></DIV
       
  4718 -><H1
       
  4719 -><A
       
  4720 -NAME="LDAPPROTOCOLVERSION"
       
  4721 -></A
       
  4722 ->
       
  4723 -LDAPProtocolVersion</H1
       
  4724 -><DIV
       
  4725 -CLASS="REFNAMEDIV"
       
  4726 -><A
       
  4727 -NAME="AEN5301"
       
  4728 -></A
       
  4729 -><H2
       
  4730 ->Name</H2
       
  4731 ->LDAPProtocolVersion&nbsp;--&nbsp;Set the LDAP protocol version</DIV
       
  4732 -><DIV
       
  4733 -CLASS="REFSYNOPSISDIV"
       
  4734 -><A
       
  4735 -NAME="AEN5304"
       
  4736 -></A
       
  4737 -><H2
       
  4738 ->Synopsis</H2
       
  4739 -><P
       
  4740 -><B
       
  4741 -CLASS="COMMAND"
       
  4742 ->LDAPProtocolVersion</B
       
  4743 ->  [  <CODE
       
  4744 -CLASS="OPTION"
       
  4745 ->2 | 3</CODE
       
  4746 ->]</P
       
  4747 -><P
       
  4748 -></P
       
  4749 -><DIV
       
  4750 -CLASS="VARIABLELIST"
       
  4751 -><P
       
  4752 -><B
       
  4753 -></B
       
  4754 -></P
       
  4755 -><DL
       
  4756 -><DT
       
  4757 -><PRE
       
  4758 -CLASS="SYNOPSIS"
       
  4759 ->Default</PRE
       
  4760 -></DT
       
  4761 -><DD
       
  4762 -><P
       
  4763 ->3</P
       
  4764 -></DD
       
  4765 -><DT
       
  4766 -><PRE
       
  4767 -CLASS="SYNOPSIS"
       
  4768 ->Context</PRE
       
  4769 -></DT
       
  4770 -><DD
       
  4771 -><P
       
  4772 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  4773 -></DD
       
  4774 -><DT
       
  4775 -><PRE
       
  4776 -CLASS="SYNOPSIS"
       
  4777 ->Module</PRE
       
  4778 -></DT
       
  4779 -><DD
       
  4780 -><P
       
  4781 ->mod_ldap</P
       
  4782 -></DD
       
  4783 -><DT
       
  4784 -><PRE
       
  4785 -CLASS="SYNOPSIS"
       
  4786 ->Compatibility</PRE
       
  4787 -></DT
       
  4788 -><DD
       
  4789 -><P
       
  4790 ->2.8.13 and later</P
       
  4791 -></DD
       
  4792 -></DL
       
  4793 -></DIV
       
  4794 -></DIV
       
  4795 -><DIV
       
  4796 -CLASS="REFSECT1"
       
  4797 -><A
       
  4798 -NAME="AEN5331"
       
  4799 -></A
       
  4800 -><H2
       
  4801 ->Description</H2
       
  4802 -><P
       
  4803 ->FIX FIX FIX</P
       
  4804 -></DIV
       
  4805 -><DIV
       
  4806 -CLASS="REFSECT1"
       
  4807 -><A
       
  4808 -NAME="AEN5334"
       
  4809 -></A
       
  4810 -><H2
       
  4811 ->See also</H2
       
  4812 -><P
       
  4813 -></P
       
  4814 -></DIV
       
  4815 -><DIV
       
  4816 -CLASS="REFSECT1"
       
  4817 -><A
       
  4818 -NAME="AEN5337"
       
  4819 -></A
       
  4820 -><H2
       
  4821 ->Examples</H2
       
  4822 -><P
       
  4823 -CLASS="LITERALLAYOUT"
       
  4824 ->FIXFIXFIX</P
       
  4825 -><P
       
  4826 ->FIXFIX</P
       
  4827 -></DIV
       
  4828 -><H1
       
  4829 -><A
       
  4830 -NAME="LDAPQUERYTIMEOUT"
       
  4831 -></A
       
  4832 ->
       
  4833 -			LDAPQueryTimeout</H1
       
  4834 -><DIV
       
  4835 -CLASS="REFNAMEDIV"
       
  4836 -><A
       
  4837 -NAME="AEN5349"
       
  4838 -></A
       
  4839 -><H2
       
  4840 ->Name</H2
       
  4841 ->LDAPQueryTimeout&nbsp;--&nbsp;Set a timeout for LDAP queries</DIV
       
  4842 -><DIV
       
  4843 -CLASS="REFSYNOPSISDIV"
       
  4844 -><A
       
  4845 -NAME="AEN5352"
       
  4846 -></A
       
  4847 -><H2
       
  4848 ->Synopsis</H2
       
  4849 -><P
       
  4850 -><B
       
  4851 -CLASS="COMMAND"
       
  4852 ->LDAPQueryTimeout</B
       
  4853 ->  [				<CODE
       
  4854 -CLASS="OPTION"
       
  4855 ->timeout-seconds</CODE
       
  4856 ->
       
  4857 -			]</P
       
  4858 -><P
       
  4859 -></P
       
  4860 -><DIV
       
  4861 -CLASS="VARIABLELIST"
       
  4862 -><P
       
  4863 -><B
       
  4864 -></B
       
  4865 -></P
       
  4866 -><DL
       
  4867 -><DT
       
  4868 -><PRE
       
  4869 -CLASS="SYNOPSIS"
       
  4870 ->Default</PRE
       
  4871 -></DT
       
  4872 -><DD
       
  4873 -><P
       
  4874 ->				LDAPQueryTimeout default-api-timeout
       
  4875 -			</P
       
  4876 -></DD
       
  4877 -><DT
       
  4878 -><PRE
       
  4879 -CLASS="SYNOPSIS"
       
  4880 ->Context</PRE
       
  4881 -></DT
       
  4882 -><DD
       
  4883 -><P
       
  4884 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  4885 -			</P
       
  4886 -></DD
       
  4887 -><DT
       
  4888 -><PRE
       
  4889 -CLASS="SYNOPSIS"
       
  4890 ->Module</PRE
       
  4891 -></DT
       
  4892 -><DD
       
  4893 -><P
       
  4894 ->mod_ldap
       
  4895 -			</P
       
  4896 -></DD
       
  4897 -><DT
       
  4898 -><PRE
       
  4899 -CLASS="SYNOPSIS"
       
  4900 ->Compatibility</PRE
       
  4901 -></DT
       
  4902 -><DD
       
  4903 -><P
       
  4904 ->				mod_ldap v2.0 and later
       
  4905 -			</P
       
  4906 -></DD
       
  4907 -></DL
       
  4908 -></DIV
       
  4909 -></DIV
       
  4910 -><DIV
       
  4911 -CLASS="REFSECT1"
       
  4912 -><A
       
  4913 -NAME="AEN5379"
       
  4914 -></A
       
  4915 -><H2
       
  4916 ->Description</H2
       
  4917 -><P
       
  4918 ->Sets the timeout used for LDAP directory queries. The default
       
  4919 -		is the default timeout used by your LDAP API.</P
       
  4920 -></DIV
       
  4921 -><DIV
       
  4922 -CLASS="REFSECT1"
       
  4923 -><A
       
  4924 -NAME="AEN5382"
       
  4925 -></A
       
  4926 -><H2
       
  4927 ->See also</H2
       
  4928 -><P
       
  4929 -></P
       
  4930 -></DIV
       
  4931 -><DIV
       
  4932 -CLASS="REFSECT1"
       
  4933 -><A
       
  4934 -NAME="AEN5385"
       
  4935 -></A
       
  4936 -><H2
       
  4937 ->Examples</H2
       
  4938 -><P
       
  4939 -></P
       
  4940 -></DIV
       
  4941 -><H1
       
  4942 -><A
       
  4943 -NAME="LDAPSEARCHSCOPE"
       
  4944 -></A
       
  4945 ->
       
  4946 -			LDAPSearchScope</H1
       
  4947 -><DIV
       
  4948 -CLASS="REFNAMEDIV"
       
  4949 -><A
       
  4950 -NAME="AEN5396"
       
  4951 -></A
       
  4952 -><H2
       
  4953 ->Name</H2
       
  4954 ->LDAPSearchScope&nbsp;--&nbsp;Specify the search scope used in LDAP queries</DIV
       
  4955 -><DIV
       
  4956 -CLASS="REFSYNOPSISDIV"
       
  4957 -><A
       
  4958 -NAME="AEN5399"
       
  4959 -></A
       
  4960 -><H2
       
  4961 ->Synopsis</H2
       
  4962 -><P
       
  4963 -><B
       
  4964 -CLASS="COMMAND"
       
  4965 ->LDAPSearchScope</B
       
  4966 ->  [				<CODE
       
  4967 -CLASS="OPTION"
       
  4968 ->onelevel</CODE
       
  4969 ->
       
  4970 -				<CODE
       
  4971 -CLASS="OPTION"
       
  4972 ->subtree</CODE
       
  4973 ->
       
  4974 -			]</P
       
  4975 -><P
       
  4976 -></P
       
  4977 -><DIV
       
  4978 -CLASS="VARIABLELIST"
       
  4979 -><P
       
  4980 -><B
       
  4981 -></B
       
  4982 -></P
       
  4983 -><DL
       
  4984 -><DT
       
  4985 -><PRE
       
  4986 -CLASS="SYNOPSIS"
       
  4987 ->Default</PRE
       
  4988 -></DT
       
  4989 -><DD
       
  4990 -><P
       
  4991 ->				LDAPSearchScope subtree
       
  4992 -			</P
       
  4993 -></DD
       
  4994 -><DT
       
  4995 -><PRE
       
  4996 -CLASS="SYNOPSIS"
       
  4997 ->Context</PRE
       
  4998 -></DT
       
  4999 -><DD
       
  5000 -><P
       
  5001 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  5002 -			</P
       
  5003 -></DD
       
  5004 -><DT
       
  5005 -><PRE
       
  5006 -CLASS="SYNOPSIS"
       
  5007 ->Module</PRE
       
  5008 -></DT
       
  5009 -><DD
       
  5010 -><P
       
  5011 ->mod_ldap
       
  5012 -			</P
       
  5013 -></DD
       
  5014 -><DT
       
  5015 -><PRE
       
  5016 -CLASS="SYNOPSIS"
       
  5017 ->Compatibility</PRE
       
  5018 -></DT
       
  5019 -><DD
       
  5020 -><P
       
  5021 ->				mod_ldap v2.6 and later
       
  5022 -			</P
       
  5023 -></DD
       
  5024 -></DL
       
  5025 -></DIV
       
  5026 -></DIV
       
  5027 -><DIV
       
  5028 -CLASS="REFSECT1"
       
  5029 -><A
       
  5030 -NAME="AEN5427"
       
  5031 -></A
       
  5032 -><H2
       
  5033 ->Description</H2
       
  5034 -><P
       
  5035 ->Set the scope used for LDAP searches. The default setting,
       
  5036 -		subtree, searches for all entries in the tree from the current level
       
  5037 -		down. Setting this directive to onelevel searches only one level
       
  5038 -		deep in the LDAP tree.</P
       
  5039 -></DIV
       
  5040 -><DIV
       
  5041 -CLASS="REFSECT1"
       
  5042 -><A
       
  5043 -NAME="AEN5430"
       
  5044 -></A
       
  5045 -><H2
       
  5046 ->See also</H2
       
  5047 -><P
       
  5048 -></P
       
  5049 -></DIV
       
  5050 -><DIV
       
  5051 -CLASS="REFSECT1"
       
  5052 -><A
       
  5053 -NAME="AEN5433"
       
  5054 -></A
       
  5055 -><H2
       
  5056 ->Examples</H2
       
  5057 -><P
       
  5058 -></P
       
  5059 -></DIV
       
  5060 -><H1
       
  5061 -><A
       
  5062 -NAME="LDAPSERVER"
       
  5063 -></A
       
  5064 ->
       
  5065 -			LDAPServer</H1
       
  5066 -><DIV
       
  5067 -CLASS="REFNAMEDIV"
       
  5068 -><A
       
  5069 -NAME="AEN5444"
       
  5070 -></A
       
  5071 -><H2
       
  5072 ->Name</H2
       
  5073 ->LDAPServer&nbsp;--&nbsp;Specify the LDAP server to use for lookups</DIV
       
  5074 -><DIV
       
  5075 -CLASS="REFSYNOPSISDIV"
       
  5076 -><A
       
  5077 -NAME="AEN5447"
       
  5078 -></A
       
  5079 -><H2
       
  5080 ->Synopsis</H2
       
  5081 -><P
       
  5082 -><B
       
  5083 -CLASS="COMMAND"
       
  5084 ->LDAPServer</B
       
  5085 ->  [				<CODE
       
  5086 -CLASS="OPTION"
       
  5087 ->"hostname1:port1 hostname2:port2"</CODE
       
  5088 ->
       
  5089 -			]</P
       
  5090 -><P
       
  5091 -></P
       
  5092 -><DIV
       
  5093 -CLASS="VARIABLELIST"
       
  5094 -><P
       
  5095 -><B
       
  5096 -></B
       
  5097 -></P
       
  5098 -><DL
       
  5099 -><DT
       
  5100 -><PRE
       
  5101 -CLASS="SYNOPSIS"
       
  5102 ->Default</PRE
       
  5103 -></DT
       
  5104 -><DD
       
  5105 -><P
       
  5106 ->				LDAPServer "localhost"
       
  5107 -			</P
       
  5108 -></DD
       
  5109 -><DT
       
  5110 -><PRE
       
  5111 -CLASS="SYNOPSIS"
       
  5112 ->Context</PRE
       
  5113 -></DT
       
  5114 -><DD
       
  5115 -><P
       
  5116 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  5117 -			</P
       
  5118 -></DD
       
  5119 -><DT
       
  5120 -><PRE
       
  5121 -CLASS="SYNOPSIS"
       
  5122 ->Module</PRE
       
  5123 -></DT
       
  5124 -><DD
       
  5125 -><P
       
  5126 ->mod_ldap
       
  5127 -			</P
       
  5128 -></DD
       
  5129 -><DT
       
  5130 -><PRE
       
  5131 -CLASS="SYNOPSIS"
       
  5132 ->Compatibility</PRE
       
  5133 -></DT
       
  5134 -><DD
       
  5135 -><P
       
  5136 ->				mod_ldap v1.0 and later
       
  5137 -			</P
       
  5138 -></DD
       
  5139 -></DL
       
  5140 -></DIV
       
  5141 -></DIV
       
  5142 -><DIV
       
  5143 -CLASS="REFSECT1"
       
  5144 -><A
       
  5145 -NAME="AEN5474"
       
  5146 -></A
       
  5147 -><H2
       
  5148 ->Description</H2
       
  5149 -><P
       
  5150 ->LDAPServer allows you to to specify the hostname(s) and
       
  5151 -		port(s) of the LDAP server(s) to use for LDAP authentication. If no
       
  5152 -		LDAPServer configuration directive is present, the default LDAP
       
  5153 -		servers specified by your LDAP API will be used.</P
       
  5154 -></DIV
       
  5155 -><DIV
       
  5156 -CLASS="REFSECT1"
       
  5157 -><A
       
  5158 -NAME="AEN5477"
       
  5159 -></A
       
  5160 -><H2
       
  5161 ->See also</H2
       
  5162 -><P
       
  5163 -></P
       
  5164 -></DIV
       
  5165 -><DIV
       
  5166 -CLASS="REFSECT1"
       
  5167 -><A
       
  5168 -NAME="AEN5480"
       
  5169 -></A
       
  5170 -><H2
       
  5171 ->Examples</H2
       
  5172 -><P
       
  5173 -></P
       
  5174 -></DIV
       
  5175 -><H1
       
  5176 -><A
       
  5177 -NAME="LDAPUSETLS"
       
  5178 -></A
       
  5179 ->
       
  5180 -			LDAPUseTLS</H1
       
  5181 -><DIV
       
  5182 -CLASS="REFNAMEDIV"
       
  5183 -><A
       
  5184 -NAME="AEN5491"
       
  5185 -></A
       
  5186 -><H2
       
  5187 ->Name</H2
       
  5188 ->LDAPUseTLS&nbsp;--&nbsp;Enable TLS/SSL connections to the LDAP server.</DIV
       
  5189 -><DIV
       
  5190 -CLASS="REFSYNOPSISDIV"
       
  5191 -><A
       
  5192 -NAME="AEN5494"
       
  5193 -></A
       
  5194 -><H2
       
  5195 ->Synopsis</H2
       
  5196 -><P
       
  5197 -><B
       
  5198 -CLASS="COMMAND"
       
  5199 ->Syntax: LDAPUseTLS</B
       
  5200 ->  [				<CODE
       
  5201 -CLASS="OPTION"
       
  5202 ->on</CODE
       
  5203 ->
       
  5204 -				<CODE
       
  5205 -CLASS="OPTION"
       
  5206 ->off</CODE
       
  5207 ->
       
  5208 -			]</P
       
  5209 -><P
       
  5210 -></P
       
  5211 -><DIV
       
  5212 -CLASS="VARIABLELIST"
       
  5213 -><P
       
  5214 -><B
       
  5215 -></B
       
  5216 -></P
       
  5217 -><DL
       
  5218 -><DT
       
  5219 -><PRE
       
  5220 -CLASS="SYNOPSIS"
       
  5221 ->Default</PRE
       
  5222 -></DT
       
  5223 -><DD
       
  5224 -><P
       
  5225 ->				LDAPUseTLS off
       
  5226 -			</P
       
  5227 -></DD
       
  5228 -><DT
       
  5229 -><PRE
       
  5230 -CLASS="SYNOPSIS"
       
  5231 ->Context</PRE
       
  5232 -></DT
       
  5233 -><DD
       
  5234 -><P
       
  5235 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
  5236 -			</P
       
  5237 -></DD
       
  5238 -><DT
       
  5239 -><PRE
       
  5240 -CLASS="SYNOPSIS"
       
  5241 ->Module</PRE
       
  5242 -></DT
       
  5243 -><DD
       
  5244 -><P
       
  5245 ->mod_ldap
       
  5246 -			</P
       
  5247 -></DD
       
  5248 -><DT
       
  5249 -><PRE
       
  5250 -CLASS="SYNOPSIS"
       
  5251 ->Compatibility</PRE
       
  5252 -></DT
       
  5253 -><DD
       
  5254 -><P
       
  5255 ->				mod_ldap v2.8 and later
       
  5256 -			</P
       
  5257 -></DD
       
  5258 -></DL
       
  5259 -></DIV
       
  5260 -></DIV
       
  5261 -><DIV
       
  5262 -CLASS="REFSECT1"
       
  5263 -><A
       
  5264 -NAME="AEN5522"
       
  5265 -></A
       
  5266 -><H2
       
  5267 ->Description</H2
       
  5268 -><P
       
  5269 ->By default, mod_ldap connects to the LDAP server via a
       
  5270 -		non-encrypted connection. Enabling this option causes mod_ldap to
       
  5271 -		use an encrypted (TLS/SSL) connection to the LDAP server. If a
       
  5272 -		secure connection to the LDAP server fails, mod_ldap will not
       
  5273 -		authenticate users (mod_ldap will *not* fall back to an unsecure
       
  5274 -		connection).</P
       
  5275 -></DIV
       
  5276 -><DIV
       
  5277 -CLASS="REFSECT1"
       
  5278 -><A
       
  5279 -NAME="AEN5525"
       
  5280 -></A
       
  5281 -><H2
       
  5282 ->See also</H2
       
  5283 -><P
       
  5284 -></P
       
  5285 -></DIV
       
  5286 -><DIV
       
  5287 -CLASS="REFSECT1"
       
  5288 -><A
       
  5289 -NAME="AEN5528"
       
  5290 -></A
       
  5291 -><H2
       
  5292 ->Examples</H2
       
  5293 -><P
       
  5294 -></P
       
  5295 -></DIV
       
  5296 -><H1
       
  5297 -><A
       
  5298 -NAME="LEECHRATIOMSG"
       
  5299 -></A
       
  5300 ->
       
  5301 -LeechRatioMsg</H1
       
  5302 -><DIV
       
  5303 -CLASS="REFNAMEDIV"
       
  5304 -><A
       
  5305 -NAME="AEN5539"
       
  5306 -></A
       
  5307 -><H2
       
  5308 ->Name</H2
       
  5309 ->LeechRatioMsg&nbsp;--&nbsp;Sets the 'over ratio' error message</DIV
       
  5310 -><DIV
       
  5311 -CLASS="REFSYNOPSISDIV"
       
  5312 -><A
       
  5313 -NAME="AEN5542"
       
  5314 -></A
       
  5315 -><H2
       
  5316 ->Synopsis</H2
       
  5317 -><P
       
  5318 -><B
       
  5319 -CLASS="COMMAND"
       
  5320 ->LeechRatioMsg</B
       
  5321 ->  [  <CODE
       
  5322 -CLASS="OPTION"
       
  5323 ->LeechRatioMsg foo1 foo2 foo3</CODE
       
  5324 ->]</P
       
  5325 -><P
       
  5326 -></P
       
  5327 -><DIV
       
  5328 -CLASS="VARIABLELIST"
       
  5329 -><P
       
  5330 -><B
       
  5331 -></B
       
  5332 -></P
       
  5333 -><DL
       
  5334 -><DT
       
  5335 -><PRE
       
  5336 -CLASS="SYNOPSIS"
       
  5337 ->Default</PRE
       
  5338 -></DT
       
  5339 -><DD
       
  5340 -><P
       
  5341 ->None known</P
       
  5342 -></DD
       
  5343 -><DT
       
  5344 -><PRE
       
  5345 -CLASS="SYNOPSIS"
       
  5346 ->Context</PRE
       
  5347 -></DT
       
  5348 -><DD
       
  5349 -><P
       
  5350 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  5351 -></DD
       
  5352 -><DT
       
  5353 -><PRE
       
  5354 -CLASS="SYNOPSIS"
       
  5355 ->Module</PRE
       
  5356 -></DT
       
  5357 -><DD
       
  5358 -><P
       
  5359 ->mod_ratio</P
       
  5360 -></DD
       
  5361 -><DT
       
  5362 -><PRE
       
  5363 -CLASS="SYNOPSIS"
       
  5364 ->Compatibility</PRE
       
  5365 -></DT
       
  5366 -><DD
       
  5367 -><P
       
  5368 ->at least 1.2.0 and later</P
       
  5369 -></DD
       
  5370 -></DL
       
  5371 -></DIV
       
  5372 -></DIV
       
  5373 -><DIV
       
  5374 -CLASS="REFSECT1"
       
  5375 -><A
       
  5376 -NAME="AEN5569"
       
  5377 -></A
       
  5378 -><H2
       
  5379 ->Description</H2
       
  5380 -><P
       
  5381 ->The LeechRatioMsg directive defines the response message sent
       
  5382 -back to the client upon breaking their quota limits.</P
       
  5383 -></DIV
       
  5384 -><DIV
       
  5385 -CLASS="REFSECT1"
       
  5386 -><A
       
  5387 -NAME="AEN5572"
       
  5388 -></A
       
  5389 -><H2
       
  5390 ->See also</H2
       
  5391 -><P
       
  5392 -></P
       
  5393 -></DIV
       
  5394 -><DIV
       
  5395 -CLASS="REFSECT1"
       
  5396 -><A
       
  5397 -NAME="AEN5575"
       
  5398 -></A
       
  5399 -><H2
       
  5400 ->Examples</H2
       
  5401 -><PRE
       
  5402 -CLASS="PROGRAMLISTING"
       
  5403 ->LeechRatioMsg "please upload as well as download"</PRE
       
  5404 -><P
       
  5405 -></P
       
  5406 -></DIV
       
  5407 -><H1
       
  5408 -><A
       
  5409  NAME="LIMIT"
       
  5410  ></A
       
  5411  >
       
  5412 @@ -18584,967 +13393,6 @@
       
  5413  ></DIV
       
  5414  ><H1
       
  5415  ><A
       
  5416 -NAME="RADIUSACCTSERVER"
       
  5417 -></A
       
  5418 ->
       
  5419 -RadiusAcctServer</H1
       
  5420 -><DIV
       
  5421 -CLASS="REFNAMEDIV"
       
  5422 -><A
       
  5423 -NAME="AEN6758"
       
  5424 -></A
       
  5425 -><H2
       
  5426 ->Name</H2
       
  5427 ->RadiusAcctServer&nbsp;--&nbsp;Setup RADIUS accounting details</DIV
       
  5428 -><DIV
       
  5429 -CLASS="REFSYNOPSISDIV"
       
  5430 -><A
       
  5431 -NAME="AEN6761"
       
  5432 -></A
       
  5433 -><H2
       
  5434 ->Synopsis</H2
       
  5435 -><P
       
  5436 -><B
       
  5437 -CLASS="COMMAND"
       
  5438 ->RadiusAcctServer</B
       
  5439 ->  [  <CODE
       
  5440 -CLASS="OPTION"
       
  5441 ->server[:port] shared-secret [timeout]</CODE
       
  5442 ->]</P
       
  5443 -><P
       
  5444 -></P
       
  5445 -><DIV
       
  5446 -CLASS="VARIABLELIST"
       
  5447 -><P
       
  5448 -><B
       
  5449 -></B
       
  5450 -></P
       
  5451 -><DL
       
  5452 -><DT
       
  5453 -><PRE
       
  5454 -CLASS="SYNOPSIS"
       
  5455 ->Default</PRE
       
  5456 -></DT
       
  5457 -><DD
       
  5458 -><P
       
  5459 ->none</P
       
  5460 -></DD
       
  5461 -><DT
       
  5462 -><PRE
       
  5463 -CLASS="SYNOPSIS"
       
  5464 ->Context</PRE
       
  5465 -></DT
       
  5466 -><DD
       
  5467 -><P
       
  5468 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  5469 -></DD
       
  5470 -><DT
       
  5471 -><PRE
       
  5472 -CLASS="SYNOPSIS"
       
  5473 ->Module</PRE
       
  5474 -></DT
       
  5475 -><DD
       
  5476 -><P
       
  5477 ->mod_radius</P
       
  5478 -></DD
       
  5479 -><DT
       
  5480 -><PRE
       
  5481 -CLASS="SYNOPSIS"
       
  5482 ->Compatibility</PRE
       
  5483 -></DT
       
  5484 -><DD
       
  5485 -><P
       
  5486 ->1.2.7rc1 and later</P
       
  5487 -></DD
       
  5488 -></DL
       
  5489 -></DIV
       
  5490 -></DIV
       
  5491 -><DIV
       
  5492 -CLASS="REFSECT1"
       
  5493 -><A
       
  5494 -NAME="AEN6788"
       
  5495 -></A
       
  5496 -><H2
       
  5497 ->Description</H2
       
  5498 -><P
       
  5499 ->The RadiusAcctServer is used to specify a RADIUS server to be used for accounting. The server parameter may be either an IP address or a DNS hostname. If not specified, the port used will be the IANA-registered 1813. The optional timeout parameter is used to tell mod_radius how long to wait for a response from the server; it defaults to 30 seconds.</P
       
  5500 -><P
       
  5501 ->Multiple RadiusAcctServers may be configured; each will be tried, in order of appearance in the configuration file, until that server times out or mod_radius receives a response.</P
       
  5502 -><P
       
  5503 ->If no RadiusAcctServers are configured, mod_radius will not use RADIUS for accounting.</P
       
  5504 -></DIV
       
  5505 -><DIV
       
  5506 -CLASS="REFSECT1"
       
  5507 -><A
       
  5508 -NAME="AEN6793"
       
  5509 -></A
       
  5510 -><H2
       
  5511 ->See also</H2
       
  5512 -><P
       
  5513 -><A
       
  5514 -HREF="#RADIUSAUTHSERVER"
       
  5515 ->RadiusAuthServer</A
       
  5516 -></P
       
  5517 -></DIV
       
  5518 -><H1
       
  5519 -><A
       
  5520 -NAME="RADIUSAUTHSERVER"
       
  5521 -></A
       
  5522 ->
       
  5523 -RadiusAuthServer</H1
       
  5524 -><DIV
       
  5525 -CLASS="REFNAMEDIV"
       
  5526 -><A
       
  5527 -NAME="AEN6805"
       
  5528 -></A
       
  5529 -><H2
       
  5530 ->Name</H2
       
  5531 ->RadiusAuthServer&nbsp;--&nbsp;Setup RADIUS authenticator details</DIV
       
  5532 -><DIV
       
  5533 -CLASS="REFSYNOPSISDIV"
       
  5534 -><A
       
  5535 -NAME="AEN6808"
       
  5536 -></A
       
  5537 -><H2
       
  5538 ->Synopsis</H2
       
  5539 -><P
       
  5540 -><B
       
  5541 -CLASS="COMMAND"
       
  5542 ->RadiusAuthServer</B
       
  5543 ->  [  <CODE
       
  5544 -CLASS="OPTION"
       
  5545 ->server[:port] shared-secret [timeout]</CODE
       
  5546 ->]</P
       
  5547 -><P
       
  5548 -></P
       
  5549 -><DIV
       
  5550 -CLASS="VARIABLELIST"
       
  5551 -><P
       
  5552 -><B
       
  5553 -></B
       
  5554 -></P
       
  5555 -><DL
       
  5556 -><DT
       
  5557 -><PRE
       
  5558 -CLASS="SYNOPSIS"
       
  5559 ->Default</PRE
       
  5560 -></DT
       
  5561 -><DD
       
  5562 -><P
       
  5563 ->none</P
       
  5564 -></DD
       
  5565 -><DT
       
  5566 -><PRE
       
  5567 -CLASS="SYNOPSIS"
       
  5568 ->Context</PRE
       
  5569 -></DT
       
  5570 -><DD
       
  5571 -><P
       
  5572 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  5573 -></DD
       
  5574 -><DT
       
  5575 -><PRE
       
  5576 -CLASS="SYNOPSIS"
       
  5577 ->Module</PRE
       
  5578 -></DT
       
  5579 -><DD
       
  5580 -><P
       
  5581 ->mod_radius</P
       
  5582 -></DD
       
  5583 -><DT
       
  5584 -><PRE
       
  5585 -CLASS="SYNOPSIS"
       
  5586 ->Compatibility</PRE
       
  5587 -></DT
       
  5588 -><DD
       
  5589 -><P
       
  5590 ->1.2.7rc1 and later</P
       
  5591 -></DD
       
  5592 -></DL
       
  5593 -></DIV
       
  5594 -></DIV
       
  5595 -><DIV
       
  5596 -CLASS="REFSECT1"
       
  5597 -><A
       
  5598 -NAME="AEN6835"
       
  5599 -></A
       
  5600 -><H2
       
  5601 ->Description</H2
       
  5602 -><P
       
  5603 ->The RadiusAcctServer is used to specify a RADIUS server to be used for accounting. The server parameter may be either an IP address or a DNS hostname. If not specified, the port used will be the IANA-registered 1813. The optional timeout parameter is used to tell mod_radius how long to wait for a response from the server; it defaults to 30 seconds.</P
       
  5604 -><P
       
  5605 ->Multiple RadiusAcctServers may be configured; each will be tried, in order of appearance in the configuration file, until that server times out or mod_radius receives a response.</P
       
  5606 -><P
       
  5607 ->If no RadiusAcctServers are configured, mod_radius will not use RADIUS for accounting.</P
       
  5608 -></DIV
       
  5609 -><DIV
       
  5610 -CLASS="REFSECT1"
       
  5611 -><A
       
  5612 -NAME="AEN6840"
       
  5613 -></A
       
  5614 -><H2
       
  5615 ->See also</H2
       
  5616 -><P
       
  5617 -><A
       
  5618 -HREF="#RADIUSAUTHSERVER"
       
  5619 ->RadiusAuthServer</A
       
  5620 -></P
       
  5621 -></DIV
       
  5622 -><H1
       
  5623 -><A
       
  5624 -NAME="RADIUSENGINE"
       
  5625 -></A
       
  5626 ->
       
  5627 -RadiusEngine</H1
       
  5628 -><DIV
       
  5629 -CLASS="REFNAMEDIV"
       
  5630 -><A
       
  5631 -NAME="AEN6852"
       
  5632 -></A
       
  5633 -><H2
       
  5634 ->Name</H2
       
  5635 ->RadiusEngine&nbsp;--&nbsp;Enable RADIUS support</DIV
       
  5636 -><DIV
       
  5637 -CLASS="REFSYNOPSISDIV"
       
  5638 -><A
       
  5639 -NAME="AEN6855"
       
  5640 -></A
       
  5641 -><H2
       
  5642 ->Synopsis</H2
       
  5643 -><P
       
  5644 -><B
       
  5645 -CLASS="COMMAND"
       
  5646 ->RadiusEngine</B
       
  5647 ->  [  <CODE
       
  5648 -CLASS="OPTION"
       
  5649 ->on|off</CODE
       
  5650 ->]</P
       
  5651 -><P
       
  5652 -></P
       
  5653 -><DIV
       
  5654 -CLASS="VARIABLELIST"
       
  5655 -><P
       
  5656 -><B
       
  5657 -></B
       
  5658 -></P
       
  5659 -><DL
       
  5660 -><DT
       
  5661 -><PRE
       
  5662 -CLASS="SYNOPSIS"
       
  5663 ->Default</PRE
       
  5664 -></DT
       
  5665 -><DD
       
  5666 -><P
       
  5667 ->off</P
       
  5668 -></DD
       
  5669 -><DT
       
  5670 -><PRE
       
  5671 -CLASS="SYNOPSIS"
       
  5672 ->Context</PRE
       
  5673 -></DT
       
  5674 -><DD
       
  5675 -><P
       
  5676 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  5677 -></DD
       
  5678 -><DT
       
  5679 -><PRE
       
  5680 -CLASS="SYNOPSIS"
       
  5681 ->Module</PRE
       
  5682 -></DT
       
  5683 -><DD
       
  5684 -><P
       
  5685 ->mod_radius</P
       
  5686 -></DD
       
  5687 -><DT
       
  5688 -><PRE
       
  5689 -CLASS="SYNOPSIS"
       
  5690 ->Compatibility</PRE
       
  5691 -></DT
       
  5692 -><DD
       
  5693 -><P
       
  5694 ->1.2.7rc1 and later</P
       
  5695 -></DD
       
  5696 -></DL
       
  5697 -></DIV
       
  5698 -></DIV
       
  5699 -><DIV
       
  5700 -CLASS="REFSECT1"
       
  5701 -><A
       
  5702 -NAME="AEN6882"
       
  5703 -></A
       
  5704 -><H2
       
  5705 ->Description</H2
       
  5706 -><P
       
  5707 ->The RadiusEngine directive enables or disables the module's runtime RADIUS engine. If it is set to off this module does no RADIUS authentication or accounting at all. Use this directive to disable the module instead of commenting out all mod_radius directives. </P
       
  5708 -></DIV
       
  5709 -><DIV
       
  5710 -CLASS="REFSECT1"
       
  5711 -><A
       
  5712 -NAME="AEN6885"
       
  5713 -></A
       
  5714 -><H2
       
  5715 ->See also</H2
       
  5716 -><P
       
  5717 -></P
       
  5718 -></DIV
       
  5719 -><H1
       
  5720 -><A
       
  5721 -NAME="RADIUSLOG"
       
  5722 -></A
       
  5723 ->
       
  5724 -RadiusLog</H1
       
  5725 -><DIV
       
  5726 -CLASS="REFNAMEDIV"
       
  5727 -><A
       
  5728 -NAME="AEN6896"
       
  5729 -></A
       
  5730 -><H2
       
  5731 ->Name</H2
       
  5732 ->RadiusLog&nbsp;--&nbsp;Specify the logfile for reporting / debugging</DIV
       
  5733 -><DIV
       
  5734 -CLASS="REFSYNOPSISDIV"
       
  5735 -><A
       
  5736 -NAME="AEN6899"
       
  5737 -></A
       
  5738 -><H2
       
  5739 ->Synopsis</H2
       
  5740 -><P
       
  5741 -><B
       
  5742 -CLASS="COMMAND"
       
  5743 ->RadiusLog</B
       
  5744 ->  [  <CODE
       
  5745 -CLASS="OPTION"
       
  5746 ->"file"|none</CODE
       
  5747 ->]</P
       
  5748 -><P
       
  5749 -></P
       
  5750 -><DIV
       
  5751 -CLASS="VARIABLELIST"
       
  5752 -><P
       
  5753 -><B
       
  5754 -></B
       
  5755 -></P
       
  5756 -><DL
       
  5757 -><DT
       
  5758 -><PRE
       
  5759 -CLASS="SYNOPSIS"
       
  5760 ->Default</PRE
       
  5761 -></DT
       
  5762 -><DD
       
  5763 -><P
       
  5764 ->none</P
       
  5765 -></DD
       
  5766 -><DT
       
  5767 -><PRE
       
  5768 -CLASS="SYNOPSIS"
       
  5769 ->Context</PRE
       
  5770 -></DT
       
  5771 -><DD
       
  5772 -><P
       
  5773 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  5774 -></DD
       
  5775 -><DT
       
  5776 -><PRE
       
  5777 -CLASS="SYNOPSIS"
       
  5778 ->Module</PRE
       
  5779 -></DT
       
  5780 -><DD
       
  5781 -><P
       
  5782 ->mod_radius</P
       
  5783 -></DD
       
  5784 -><DT
       
  5785 -><PRE
       
  5786 -CLASS="SYNOPSIS"
       
  5787 ->Compatibility</PRE
       
  5788 -></DT
       
  5789 -><DD
       
  5790 -><P
       
  5791 ->1.2.7rc1 and later</P
       
  5792 -></DD
       
  5793 -></DL
       
  5794 -></DIV
       
  5795 -></DIV
       
  5796 -><DIV
       
  5797 -CLASS="REFSECT1"
       
  5798 -><A
       
  5799 -NAME="AEN6926"
       
  5800 -></A
       
  5801 -><H2
       
  5802 ->Description</H2
       
  5803 -><P
       
  5804 ->The RadiusLog directive is used to a specify a log file for mod_radius
       
  5805 -reporting and debugging, and can be done a per-server basis. The file
       
  5806 -parameter must be the full path to the file to use for logging. Note
       
  5807 -that this path must not be to a world-writeable directory and, unless
       
  5808 -AllowLogSymlinks is explicitly set to on (generally a bad idea), the
       
  5809 -path must not be a symbolic link.</P
       
  5810 -><P
       
  5811 ->If file is "none", no logging will be done at all; this setting can be
       
  5812 -used to override a RadiusLog setting inherited from a &lt;Global&gt; context.</P
       
  5813 -></DIV
       
  5814 -><DIV
       
  5815 -CLASS="REFSECT1"
       
  5816 -><A
       
  5817 -NAME="AEN6930"
       
  5818 -></A
       
  5819 -><H2
       
  5820 ->See also</H2
       
  5821 -><P
       
  5822 -></P
       
  5823 -></DIV
       
  5824 -><H1
       
  5825 -><A
       
  5826 -NAME="RADIUSREALM"
       
  5827 -></A
       
  5828 ->
       
  5829 -RadiusRealm</H1
       
  5830 -><DIV
       
  5831 -CLASS="REFNAMEDIV"
       
  5832 -><A
       
  5833 -NAME="AEN6941"
       
  5834 -></A
       
  5835 -><H2
       
  5836 ->Name</H2
       
  5837 ->RadiusRealm&nbsp;--&nbsp;Setup the authentication realm</DIV
       
  5838 -><DIV
       
  5839 -CLASS="REFSYNOPSISDIV"
       
  5840 -><A
       
  5841 -NAME="AEN6944"
       
  5842 -></A
       
  5843 -><H2
       
  5844 ->Synopsis</H2
       
  5845 -><P
       
  5846 -><B
       
  5847 -CLASS="COMMAND"
       
  5848 ->RadiusRealm</B
       
  5849 ->  [  <CODE
       
  5850 -CLASS="OPTION"
       
  5851 ->realm</CODE
       
  5852 ->]</P
       
  5853 -><P
       
  5854 -></P
       
  5855 -><DIV
       
  5856 -CLASS="VARIABLELIST"
       
  5857 -><P
       
  5858 -><B
       
  5859 -></B
       
  5860 -></P
       
  5861 -><DL
       
  5862 -><DT
       
  5863 -><PRE
       
  5864 -CLASS="SYNOPSIS"
       
  5865 ->Default</PRE
       
  5866 -></DT
       
  5867 -><DD
       
  5868 -><P
       
  5869 ->none</P
       
  5870 -></DD
       
  5871 -><DT
       
  5872 -><PRE
       
  5873 -CLASS="SYNOPSIS"
       
  5874 ->Context</PRE
       
  5875 -></DT
       
  5876 -><DD
       
  5877 -><P
       
  5878 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  5879 -></DD
       
  5880 -><DT
       
  5881 -><PRE
       
  5882 -CLASS="SYNOPSIS"
       
  5883 ->Module</PRE
       
  5884 -></DT
       
  5885 -><DD
       
  5886 -><P
       
  5887 ->mod_radius</P
       
  5888 -></DD
       
  5889 -><DT
       
  5890 -><PRE
       
  5891 -CLASS="SYNOPSIS"
       
  5892 ->Compatibility</PRE
       
  5893 -></DT
       
  5894 -><DD
       
  5895 -><P
       
  5896 ->1.2.7rc1 and later</P
       
  5897 -></DD
       
  5898 -></DL
       
  5899 -></DIV
       
  5900 -></DIV
       
  5901 -><DIV
       
  5902 -CLASS="REFSECT1"
       
  5903 -><A
       
  5904 -NAME="AEN6971"
       
  5905 -></A
       
  5906 -><H2
       
  5907 ->Description</H2
       
  5908 -><P
       
  5909 ->The RadiusRealm directive configures a realm string that will be added to the username in the constructed RADIUS packets.</P
       
  5910 -></DIV
       
  5911 -><DIV
       
  5912 -CLASS="REFSECT1"
       
  5913 -><A
       
  5914 -NAME="AEN6974"
       
  5915 -></A
       
  5916 -><H2
       
  5917 ->See also</H2
       
  5918 -><P
       
  5919 -></P
       
  5920 -></DIV
       
  5921 -><DIV
       
  5922 -CLASS="REFSECT1"
       
  5923 -><A
       
  5924 -NAME="AEN6977"
       
  5925 -></A
       
  5926 -><H2
       
  5927 ->Examples</H2
       
  5928 -><P
       
  5929 -CLASS="LITERALLAYOUT"
       
  5930 ->&nbsp;&nbsp;RadiusRealm&nbsp;.castaglia.org</P
       
  5931 -></DIV
       
  5932 -><H1
       
  5933 -><A
       
  5934 -NAME="RADIUSUSERINFO"
       
  5935 -></A
       
  5936 ->
       
  5937 -RadiusUserInfo</H1
       
  5938 -><DIV
       
  5939 -CLASS="REFNAMEDIV"
       
  5940 -><A
       
  5941 -NAME="AEN6988"
       
  5942 -></A
       
  5943 -><H2
       
  5944 ->Name</H2
       
  5945 ->RadiusUserInfo&nbsp;--&nbsp;Configure login information via RADIUS</DIV
       
  5946 -><DIV
       
  5947 -CLASS="REFSYNOPSISDIV"
       
  5948 -><A
       
  5949 -NAME="AEN6991"
       
  5950 -></A
       
  5951 -><H2
       
  5952 ->Synopsis</H2
       
  5953 -><P
       
  5954 -><B
       
  5955 -CLASS="COMMAND"
       
  5956 ->RadiusUserInfo</B
       
  5957 ->  [  <CODE
       
  5958 -CLASS="OPTION"
       
  5959 ->uid gid home shell [suppl-group-names suppl-group-ids]</CODE
       
  5960 ->]</P
       
  5961 -><P
       
  5962 -></P
       
  5963 -><DIV
       
  5964 -CLASS="VARIABLELIST"
       
  5965 -><P
       
  5966 -><B
       
  5967 -></B
       
  5968 -></P
       
  5969 -><DL
       
  5970 -><DT
       
  5971 -><PRE
       
  5972 -CLASS="SYNOPSIS"
       
  5973 ->Default</PRE
       
  5974 -></DT
       
  5975 -><DD
       
  5976 -><P
       
  5977 ->none</P
       
  5978 -></DD
       
  5979 -><DT
       
  5980 -><PRE
       
  5981 -CLASS="SYNOPSIS"
       
  5982 ->Context</PRE
       
  5983 -></DT
       
  5984 -><DD
       
  5985 -><P
       
  5986 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  5987 -></DD
       
  5988 -><DT
       
  5989 -><PRE
       
  5990 -CLASS="SYNOPSIS"
       
  5991 ->Module</PRE
       
  5992 -></DT
       
  5993 -><DD
       
  5994 -><P
       
  5995 ->mod_radius</P
       
  5996 -></DD
       
  5997 -><DT
       
  5998 -><PRE
       
  5999 -CLASS="SYNOPSIS"
       
  6000 ->Compatibility</PRE
       
  6001 -></DT
       
  6002 -><DD
       
  6003 -><P
       
  6004 ->1.2.7rc1 and later</P
       
  6005 -></DD
       
  6006 -></DL
       
  6007 -></DIV
       
  6008 -></DIV
       
  6009 -><DIV
       
  6010 -CLASS="REFSECT1"
       
  6011 -><A
       
  6012 -NAME="AEN7018"
       
  6013 -></A
       
  6014 -><H2
       
  6015 ->Description</H2
       
  6016 -><P
       
  6017 ->The RadiusUserInfo directive is used to configure login information used for every user authenticated via RADIUS. The optional suppl-group-names and suppl-group-ids parameters are used to specify supplemental group membership for each user; the number of names and IDs must match if these parameters are used.</P
       
  6018 -><P
       
  6019 ->In order to support RADIUS servers that may use custom attributes in their Access-Accept response packets to supply user information back to the RADIUS client (mod_radius in this case), this directive allows the following syntax for some of its parameters:</P
       
  6020 -><P
       
  6021 ->&#13;<P
       
  6022 -CLASS="LITERALLAYOUT"
       
  6023 ->&nbsp;&nbsp;$(attribute-id:default-value)</P
       
  6024 ->&#13;</P
       
  6025 -><P
       
  6026 ->where the enclosing $() signals that the parameter is to be supplied by
       
  6027 -the RADIUS server, attribute-id is the custom attribute ID for which to
       
  6028 -search in the response packet, and default-value is the value to use in
       
  6029 -case the requested attribute is not present in the response packet. This
       
  6030 -syntax is not supported for the suppl-group-names or suppl-group-ids
       
  6031 -parameters.</P
       
  6032 -><P
       
  6033 ->If RadiusUserInfo is not used, mod_radius will perform pure "yes/no"
       
  6034 -authentication only, in the style of PAM. The information that would
       
  6035 -have been configured via this directive will be pulled from other sources
       
  6036 -(e.g. /etc/passwd, AuthUserFiles, MySQL tables, etc).</P
       
  6037 -></DIV
       
  6038 -><DIV
       
  6039 -CLASS="REFSECT1"
       
  6040 -><A
       
  6041 -NAME="AEN7026"
       
  6042 -></A
       
  6043 -><H2
       
  6044 ->See also</H2
       
  6045 -><P
       
  6046 -></P
       
  6047 -></DIV
       
  6048 -><H1
       
  6049 -><A
       
  6050 -NAME="RATIOFILE"
       
  6051 -></A
       
  6052 ->
       
  6053 -RatioFile</H1
       
  6054 -><DIV
       
  6055 -CLASS="REFNAMEDIV"
       
  6056 -><A
       
  6057 -NAME="AEN7037"
       
  6058 -></A
       
  6059 -><H2
       
  6060 ->Name</H2
       
  6061 ->RatioFile&nbsp;--&nbsp;Ratio directive</DIV
       
  6062 -><DIV
       
  6063 -CLASS="REFSYNOPSISDIV"
       
  6064 -><A
       
  6065 -NAME="AEN7040"
       
  6066 -></A
       
  6067 -><H2
       
  6068 ->Synopsis</H2
       
  6069 -><P
       
  6070 -><B
       
  6071 -CLASS="COMMAND"
       
  6072 ->RatioFile</B
       
  6073 ->  [  <CODE
       
  6074 -CLASS="OPTION"
       
  6075 ->RatioFile foo1 foo2 foo3</CODE
       
  6076 ->]</P
       
  6077 -><P
       
  6078 -></P
       
  6079 -><DIV
       
  6080 -CLASS="VARIABLELIST"
       
  6081 -><P
       
  6082 -><B
       
  6083 -></B
       
  6084 -></P
       
  6085 -><DL
       
  6086 -><DT
       
  6087 -><PRE
       
  6088 -CLASS="SYNOPSIS"
       
  6089 ->Default</PRE
       
  6090 -></DT
       
  6091 -><DD
       
  6092 -><P
       
  6093 ->None known</P
       
  6094 -></DD
       
  6095 -><DT
       
  6096 -><PRE
       
  6097 -CLASS="SYNOPSIS"
       
  6098 ->Context</PRE
       
  6099 -></DT
       
  6100 -><DD
       
  6101 -><P
       
  6102 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  6103 -></DD
       
  6104 -><DT
       
  6105 -><PRE
       
  6106 -CLASS="SYNOPSIS"
       
  6107 ->Module</PRE
       
  6108 -></DT
       
  6109 -><DD
       
  6110 -><P
       
  6111 ->mod_ratio</P
       
  6112 -></DD
       
  6113 -><DT
       
  6114 -><PRE
       
  6115 -CLASS="SYNOPSIS"
       
  6116 ->Compatibility</PRE
       
  6117 -></DT
       
  6118 -><DD
       
  6119 -><P
       
  6120 ->at least 1.2.0 and later</P
       
  6121 -></DD
       
  6122 -></DL
       
  6123 -></DIV
       
  6124 -></DIV
       
  6125 -><DIV
       
  6126 -CLASS="REFSECT1"
       
  6127 -><A
       
  6128 -NAME="AEN7067"
       
  6129 -></A
       
  6130 -><H2
       
  6131 ->Description</H2
       
  6132 -><P
       
  6133 ->The RatioFile directive ....
       
  6134 -Example:
       
  6135 -RatioFile</P
       
  6136 -></DIV
       
  6137 -><DIV
       
  6138 -CLASS="REFSECT1"
       
  6139 -><A
       
  6140 -NAME="AEN7070"
       
  6141 -></A
       
  6142 -><H2
       
  6143 ->See also</H2
       
  6144 -><P
       
  6145 -></P
       
  6146 -></DIV
       
  6147 -><DIV
       
  6148 -CLASS="REFSECT1"
       
  6149 -><A
       
  6150 -NAME="AEN7073"
       
  6151 -></A
       
  6152 -><H2
       
  6153 ->Examples</H2
       
  6154 -><P
       
  6155 -></P
       
  6156 -></DIV
       
  6157 -><H1
       
  6158 -><A
       
  6159 -NAME="RATIOS"
       
  6160 -></A
       
  6161 ->
       
  6162 -Ratios</H1
       
  6163 -><DIV
       
  6164 -CLASS="REFNAMEDIV"
       
  6165 -><A
       
  6166 -NAME="AEN7084"
       
  6167 -></A
       
  6168 -><H2
       
  6169 ->Name</H2
       
  6170 ->Ratios&nbsp;--&nbsp;(docs incomplete)</DIV
       
  6171 -><DIV
       
  6172 -CLASS="REFSYNOPSISDIV"
       
  6173 -><A
       
  6174 -NAME="AEN7087"
       
  6175 -></A
       
  6176 -><H2
       
  6177 ->Synopsis</H2
       
  6178 -><P
       
  6179 -><B
       
  6180 -CLASS="COMMAND"
       
  6181 ->Ratios</B
       
  6182 ->  [  <CODE
       
  6183 -CLASS="OPTION"
       
  6184 ->Ratios foo1 foo2 foo3</CODE
       
  6185 ->]</P
       
  6186 -><P
       
  6187 -></P
       
  6188 -><DIV
       
  6189 -CLASS="VARIABLELIST"
       
  6190 -><P
       
  6191 -><B
       
  6192 -></B
       
  6193 -></P
       
  6194 -><DL
       
  6195 -><DT
       
  6196 -><PRE
       
  6197 -CLASS="SYNOPSIS"
       
  6198 ->Default</PRE
       
  6199 -></DT
       
  6200 -><DD
       
  6201 -><P
       
  6202 ->None known</P
       
  6203 -></DD
       
  6204 -><DT
       
  6205 -><PRE
       
  6206 -CLASS="SYNOPSIS"
       
  6207 ->Context</PRE
       
  6208 -></DT
       
  6209 -><DD
       
  6210 -><P
       
  6211 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  6212 -></DD
       
  6213 -><DT
       
  6214 -><PRE
       
  6215 -CLASS="SYNOPSIS"
       
  6216 ->Module</PRE
       
  6217 -></DT
       
  6218 -><DD
       
  6219 -><P
       
  6220 ->mod_ratio</P
       
  6221 -></DD
       
  6222 -><DT
       
  6223 -><PRE
       
  6224 -CLASS="SYNOPSIS"
       
  6225 ->Compatibility</PRE
       
  6226 -></DT
       
  6227 -><DD
       
  6228 -><P
       
  6229 ->at least 1.2.0 and later</P
       
  6230 -></DD
       
  6231 -></DL
       
  6232 -></DIV
       
  6233 -></DIV
       
  6234 -><DIV
       
  6235 -CLASS="REFSECT1"
       
  6236 -><A
       
  6237 -NAME="AEN7114"
       
  6238 -></A
       
  6239 -><H2
       
  6240 ->Description</H2
       
  6241 -><P
       
  6242 ->The Ratios directive ....
       
  6243 -Example:
       
  6244 -Ratios</P
       
  6245 -></DIV
       
  6246 -><DIV
       
  6247 -CLASS="REFSECT1"
       
  6248 -><A
       
  6249 -NAME="AEN7117"
       
  6250 -></A
       
  6251 -><H2
       
  6252 ->See also</H2
       
  6253 -><P
       
  6254 -></P
       
  6255 -></DIV
       
  6256 -><DIV
       
  6257 -CLASS="REFSECT1"
       
  6258 -><A
       
  6259 -NAME="AEN7120"
       
  6260 -></A
       
  6261 -><H2
       
  6262 ->Examples</H2
       
  6263 -><P
       
  6264 -></P
       
  6265 -></DIV
       
  6266 -><H1
       
  6267 -><A
       
  6268 -NAME="RATIOTEMPFILE"
       
  6269 -></A
       
  6270 ->
       
  6271 -RatioTempFile</H1
       
  6272 -><DIV
       
  6273 -CLASS="REFNAMEDIV"
       
  6274 -><A
       
  6275 -NAME="AEN7131"
       
  6276 -></A
       
  6277 -><H2
       
  6278 ->Name</H2
       
  6279 ->RatioTempFile&nbsp;--&nbsp;Ratio directive</DIV
       
  6280 -><DIV
       
  6281 -CLASS="REFSYNOPSISDIV"
       
  6282 -><A
       
  6283 -NAME="AEN7134"
       
  6284 -></A
       
  6285 -><H2
       
  6286 ->Synopsis</H2
       
  6287 -><P
       
  6288 -><B
       
  6289 -CLASS="COMMAND"
       
  6290 ->RatioTempFile</B
       
  6291 ->  [  <CODE
       
  6292 -CLASS="OPTION"
       
  6293 ->RatioTempFile foo1 foo2 foo3</CODE
       
  6294 ->]</P
       
  6295 -><P
       
  6296 -></P
       
  6297 -><DIV
       
  6298 -CLASS="VARIABLELIST"
       
  6299 -><P
       
  6300 -><B
       
  6301 -></B
       
  6302 -></P
       
  6303 -><DL
       
  6304 -><DT
       
  6305 -><PRE
       
  6306 -CLASS="SYNOPSIS"
       
  6307 ->Default</PRE
       
  6308 -></DT
       
  6309 -><DD
       
  6310 -><P
       
  6311 ->None known</P
       
  6312 -></DD
       
  6313 -><DT
       
  6314 -><PRE
       
  6315 -CLASS="SYNOPSIS"
       
  6316 ->Context</PRE
       
  6317 -></DT
       
  6318 -><DD
       
  6319 -><P
       
  6320 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  6321 -></DD
       
  6322 -><DT
       
  6323 -><PRE
       
  6324 -CLASS="SYNOPSIS"
       
  6325 ->Module</PRE
       
  6326 -></DT
       
  6327 -><DD
       
  6328 -><P
       
  6329 ->mod_ratio</P
       
  6330 -></DD
       
  6331 -><DT
       
  6332 -><PRE
       
  6333 -CLASS="SYNOPSIS"
       
  6334 ->Compatibility</PRE
       
  6335 -></DT
       
  6336 -><DD
       
  6337 -><P
       
  6338 ->at least 1.2.0 and later</P
       
  6339 -></DD
       
  6340 -></DL
       
  6341 -></DIV
       
  6342 -></DIV
       
  6343 -><DIV
       
  6344 -CLASS="REFSECT1"
       
  6345 -><A
       
  6346 -NAME="AEN7161"
       
  6347 -></A
       
  6348 -><H2
       
  6349 ->Description</H2
       
  6350 -><P
       
  6351 ->The RatioTempFile directive ....
       
  6352 -Example:
       
  6353 -RatioTempFile</P
       
  6354 -></DIV
       
  6355 -><DIV
       
  6356 -CLASS="REFSECT1"
       
  6357 -><A
       
  6358 -NAME="AEN7164"
       
  6359 -></A
       
  6360 -><H2
       
  6361 ->See also</H2
       
  6362 -><P
       
  6363 -></P
       
  6364 -></DIV
       
  6365 -><DIV
       
  6366 -CLASS="REFSECT1"
       
  6367 -><A
       
  6368 -NAME="AEN7167"
       
  6369 -></A
       
  6370 -><H2
       
  6371 ->Examples</H2
       
  6372 -><P
       
  6373 -></P
       
  6374 -></DIV
       
  6375 -><H1
       
  6376 -><A
       
  6377  NAME="REQUIREVALIDSHELL"
       
  6378  ></A
       
  6379  >
       
  6380 @@ -19656,1592 +13504,6 @@
       
  6381  ></DIV
       
  6382  ><H1
       
  6383  ><A
       
  6384 -NAME="REWRITECONDITION"
       
  6385 -></A
       
  6386 ->
       
  6387 -RewriteCondition</H1
       
  6388 -><DIV
       
  6389 -CLASS="REFNAMEDIV"
       
  6390 -><A
       
  6391 -NAME="AEN7225"
       
  6392 -></A
       
  6393 -><H2
       
  6394 ->Name</H2
       
  6395 ->RewriteCondition&nbsp;--&nbsp;Define a rule condition</DIV
       
  6396 -><DIV
       
  6397 -CLASS="REFSYNOPSISDIV"
       
  6398 -><A
       
  6399 -NAME="AEN7228"
       
  6400 -></A
       
  6401 -><H2
       
  6402 ->Synopsis</H2
       
  6403 -><P
       
  6404 -><B
       
  6405 -CLASS="COMMAND"
       
  6406 ->RewriteCondition</B
       
  6407 ->  [  <CODE
       
  6408 -CLASS="OPTION"
       
  6409 ->condition pattern</CODE
       
  6410 ->]</P
       
  6411 -><P
       
  6412 -></P
       
  6413 -><DIV
       
  6414 -CLASS="VARIABLELIST"
       
  6415 -><P
       
  6416 -><B
       
  6417 -></B
       
  6418 -></P
       
  6419 -><DL
       
  6420 -><DT
       
  6421 -><PRE
       
  6422 -CLASS="SYNOPSIS"
       
  6423 ->Default</PRE
       
  6424 -></DT
       
  6425 -><DD
       
  6426 -><P
       
  6427 ->None</P
       
  6428 -></DD
       
  6429 -><DT
       
  6430 -><PRE
       
  6431 -CLASS="SYNOPSIS"
       
  6432 ->Context</PRE
       
  6433 -></DT
       
  6434 -><DD
       
  6435 -><P
       
  6436 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;, &lt;Anonymous&gt;, &lt;Directory&gt;</P
       
  6437 -></DD
       
  6438 -><DT
       
  6439 -><PRE
       
  6440 -CLASS="SYNOPSIS"
       
  6441 ->Module</PRE
       
  6442 -></DT
       
  6443 -><DD
       
  6444 -><P
       
  6445 ->mod_rewrite</P
       
  6446 -></DD
       
  6447 -><DT
       
  6448 -><PRE
       
  6449 -CLASS="SYNOPSIS"
       
  6450 ->Compatibility</PRE
       
  6451 -></DT
       
  6452 -><DD
       
  6453 -><P
       
  6454 ->1.2.6rc1 and later</P
       
  6455 -></DD
       
  6456 -></DL
       
  6457 -></DIV
       
  6458 -></DIV
       
  6459 -><DIV
       
  6460 -CLASS="REFSECT1"
       
  6461 -><A
       
  6462 -NAME="AEN7255"
       
  6463 -></A
       
  6464 -><H2
       
  6465 ->Description</H2
       
  6466 -><P
       
  6467 ->The RewriteCondition directive defines a rule condition. Precede a
       
  6468 -<A
       
  6469 -HREF="#REWRITERULE"
       
  6470 ->RewriteRule</A
       
  6471 -> directive with one or more
       
  6472 -RewriteCondition directives. The following rewriting rule is only used if
       
  6473 -its pattern matches the current state of the FTP command and if these
       
  6474 -additional conditions apply too.</P
       
  6475 -><P
       
  6476 ->Condition is a string which can contain the following expanded constructs
       
  6477 -in addition to plain text:</P
       
  6478 -><P
       
  6479 -></P
       
  6480 -><UL
       
  6481 -><LI
       
  6482 -STYLE="list-style-type: disc"
       
  6483 -><P
       
  6484 ->		<SPAN
       
  6485 -CLASS="bold"
       
  6486 -><B
       
  6487 -CLASS="EMPHASIS"
       
  6488 ->RewriteRule backreferences</B
       
  6489 -></SPAN
       
  6490 ->
       
  6491 -	      </P
       
  6492 -><P
       
  6493 ->		These are backreferences of the form:
       
  6494 -	      </P
       
  6495 -><P
       
  6496 -><SPAN
       
  6497 -CLASS="bold"
       
  6498 -><B
       
  6499 -CLASS="EMPHASIS"
       
  6500 ->$N</B
       
  6501 -></SPAN
       
  6502 -></P
       
  6503 -><P
       
  6504 ->		(0 &#60;= N &#60;= 9) which provide access to the grouped
       
  6505 -	       	parts (parentheses!) of the pattern from the corresponding
       
  6506 -		RewriteRule directive (the one following the current bunch
       
  6507 -		of RewriteCondition directives). Note that $0 will refer
       
  6508 -		back to the entire original string being matched.
       
  6509 -              </P
       
  6510 -></LI
       
  6511 -><LI
       
  6512 -STYLE="list-style-type: disc"
       
  6513 -><P
       
  6514 ->		<SPAN
       
  6515 -CLASS="bold"
       
  6516 -><B
       
  6517 -CLASS="EMPHASIS"
       
  6518 ->RewriteCondition backreferences</B
       
  6519 -></SPAN
       
  6520 ->
       
  6521 -	      </P
       
  6522 -><P
       
  6523 ->		These are backreferences of the form:
       
  6524 -	      </P
       
  6525 -><P
       
  6526 -><SPAN
       
  6527 -CLASS="bold"
       
  6528 -><B
       
  6529 -CLASS="EMPHASIS"
       
  6530 ->%N</B
       
  6531 -></SPAN
       
  6532 -></P
       
  6533 -><P
       
  6534 ->		(0 &#60;= N &#60;= 9) which provide access to the grouped parts
       
  6535 -		(parentheses!) of the pattern from the previous
       
  6536 -		RewriteCondition attached to this RewriteRule.
       
  6537 -              </P
       
  6538 -></LI
       
  6539 -><LI
       
  6540 -STYLE="list-style-type: disc"
       
  6541 -><P
       
  6542 ->		<SPAN
       
  6543 -CLASS="bold"
       
  6544 -><B
       
  6545 -CLASS="EMPHASIS"
       
  6546 ->RewriteMap expansions:</B
       
  6547 -></SPAN
       
  6548 ->
       
  6549 -	      </P
       
  6550 -><P
       
  6551 ->		These are expansions of the form:
       
  6552 -	      </P
       
  6553 -><P
       
  6554 ->	      <SPAN
       
  6555 -CLASS="bold"
       
  6556 -><B
       
  6557 -CLASS="EMPHASIS"
       
  6558 ->${map-name:lookup-key|default-value}</B
       
  6559 -></SPAN
       
  6560 ->
       
  6561 -	      </P
       
  6562 -><P
       
  6563 ->		See the documentation for <A
       
  6564 -HREF="#REWRITEMAP"
       
  6565 ->RewriteMap
       
  6566 -		</A
       
  6567 -> for more details.
       
  6568 -              </P
       
  6569 -></LI
       
  6570 -><LI
       
  6571 -STYLE="list-style-type: disc"
       
  6572 -><P
       
  6573 ->		<SPAN
       
  6574 -CLASS="bold"
       
  6575 -><B
       
  6576 -CLASS="EMPHASIS"
       
  6577 ->Variable substitutions:</B
       
  6578 -></SPAN
       
  6579 ->
       
  6580 -	      </P
       
  6581 -><P
       
  6582 ->		These are substitutions of the form:
       
  6583 -              </P
       
  6584 -><P
       
  6585 -></P
       
  6586 -><UL
       
  6587 -><LI
       
  6588 -STYLE="list-style-type: disc"
       
  6589 -><P
       
  6590 ->			<SPAN
       
  6591 -CLASS="bold"
       
  6592 -><B
       
  6593 -CLASS="EMPHASIS"
       
  6594 ->%a</B
       
  6595 -></SPAN
       
  6596 ->
       
  6597 -			client IP address
       
  6598 -			</P
       
  6599 -></LI
       
  6600 -><LI
       
  6601 -STYLE="list-style-type: disc"
       
  6602 -><P
       
  6603 ->			<SPAN
       
  6604 -CLASS="bold"
       
  6605 -><B
       
  6606 -CLASS="EMPHASIS"
       
  6607 ->%c</B
       
  6608 -></SPAN
       
  6609 ->
       
  6610 -			name of Class for current session
       
  6611 -			</P
       
  6612 -></LI
       
  6613 -><LI
       
  6614 -STYLE="list-style-type: disc"
       
  6615 -><P
       
  6616 ->			<SPAN
       
  6617 -CLASS="bold"
       
  6618 -><B
       
  6619 -CLASS="EMPHASIS"
       
  6620 ->%f</B
       
  6621 -></SPAN
       
  6622 ->
       
  6623 -			filename
       
  6624 -			</P
       
  6625 -></LI
       
  6626 -><LI
       
  6627 -STYLE="list-style-type: disc"
       
  6628 -><P
       
  6629 ->			<SPAN
       
  6630 -CLASS="bold"
       
  6631 -><B
       
  6632 -CLASS="EMPHASIS"
       
  6633 ->%F</B
       
  6634 -></SPAN
       
  6635 ->
       
  6636 -			transfer path, as seen by the client (only useful
       
  6637 -			for upload/download commands)
       
  6638 -			</P
       
  6639 -></LI
       
  6640 -><LI
       
  6641 -STYLE="list-style-type: disc"
       
  6642 -><P
       
  6643 ->			<SPAN
       
  6644 -CLASS="bold"
       
  6645 -><B
       
  6646 -CLASS="EMPHASIS"
       
  6647 ->%g</B
       
  6648 -></SPAN
       
  6649 ->
       
  6650 -			primary group of authenticated user
       
  6651 -			</P
       
  6652 -></LI
       
  6653 -><LI
       
  6654 -STYLE="list-style-type: disc"
       
  6655 -><P
       
  6656 ->			<SPAN
       
  6657 -CLASS="bold"
       
  6658 -><B
       
  6659 -CLASS="EMPHASIS"
       
  6660 ->%G</B
       
  6661 -></SPAN
       
  6662 ->
       
  6663 -			supplemental groups of authenticated user
       
  6664 -			</P
       
  6665 -></LI
       
  6666 -><LI
       
  6667 -STYLE="list-style-type: disc"
       
  6668 -><P
       
  6669 ->			<SPAN
       
  6670 -CLASS="bold"
       
  6671 -><B
       
  6672 -CLASS="EMPHASIS"
       
  6673 ->%h</B
       
  6674 -></SPAN
       
  6675 ->
       
  6676 -			client DNS name
       
  6677 -			</P
       
  6678 -></LI
       
  6679 -><LI
       
  6680 -STYLE="list-style-type: disc"
       
  6681 -><P
       
  6682 ->			<SPAN
       
  6683 -CLASS="bold"
       
  6684 -><B
       
  6685 -CLASS="EMPHASIS"
       
  6686 ->%m</B
       
  6687 -></SPAN
       
  6688 ->
       
  6689 -			FTP command
       
  6690 -			</P
       
  6691 -></LI
       
  6692 -><LI
       
  6693 -STYLE="list-style-type: disc"
       
  6694 -><P
       
  6695 ->			<SPAN
       
  6696 -CLASS="bold"
       
  6697 -><B
       
  6698 -CLASS="EMPHASIS"
       
  6699 ->%p</B
       
  6700 -></SPAN
       
  6701 ->
       
  6702 -			port of server handling the session
       
  6703 -			</P
       
  6704 -></LI
       
  6705 -><LI
       
  6706 -STYLE="list-style-type: disc"
       
  6707 -><P
       
  6708 ->			<SPAN
       
  6709 -CLASS="bold"
       
  6710 -><B
       
  6711 -CLASS="EMPHASIS"
       
  6712 ->%u</B
       
  6713 -></SPAN
       
  6714 ->
       
  6715 -			name of authenticated user
       
  6716 -			</P
       
  6717 -></LI
       
  6718 -><LI
       
  6719 -STYLE="list-style-type: disc"
       
  6720 -><P
       
  6721 ->			<SPAN
       
  6722 -CLASS="bold"
       
  6723 -><B
       
  6724 -CLASS="EMPHASIS"
       
  6725 ->%U</B
       
  6726 -></SPAN
       
  6727 ->
       
  6728 -			name of user sent by client via USER
       
  6729 -			</P
       
  6730 -></LI
       
  6731 -><LI
       
  6732 -STYLE="list-style-type: disc"
       
  6733 -><P
       
  6734 ->			<SPAN
       
  6735 -CLASS="bold"
       
  6736 -><B
       
  6737 -CLASS="EMPHASIS"
       
  6738 ->%v</B
       
  6739 -></SPAN
       
  6740 ->
       
  6741 -			ServerName of server handling the session
       
  6742 -			</P
       
  6743 -></LI
       
  6744 -></UL
       
  6745 -></LI
       
  6746 -></UL
       
  6747 -><P
       
  6748 ->Pattern is the condition pattern, i.e., a regular expression which is
       
  6749 -applied to the current instance of the condition, i.e., condition is
       
  6750 -evaluated and then matched against pattern. You can prefix the pattern
       
  6751 -string with a '!' character (exclamation mark) to specify a non-matching
       
  6752 -pattern.</P
       
  6753 -></DIV
       
  6754 -><DIV
       
  6755 -CLASS="REFSECT1"
       
  6756 -><A
       
  6757 -NAME="AEN7325"
       
  6758 -></A
       
  6759 -><H2
       
  6760 ->See also</H2
       
  6761 -><P
       
  6762 -><A
       
  6763 -HREF="#REWRITERULE"
       
  6764 ->RewriteRule</A
       
  6765 ->
       
  6766 -<A
       
  6767 -HREF="#REWRITEMAP"
       
  6768 ->RewriteMap</A
       
  6769 -></P
       
  6770 -></DIV
       
  6771 -><DIV
       
  6772 -CLASS="REFSECT1"
       
  6773 -><A
       
  6774 -NAME="AEN7330"
       
  6775 -></A
       
  6776 -><H2
       
  6777 ->Examples</H2
       
  6778 -><P
       
  6779 -CLASS="LITERALLAYOUT"
       
  6780 -></P
       
  6781 -></DIV
       
  6782 -><H1
       
  6783 -><A
       
  6784 -NAME="REWRITEENGINE"
       
  6785 -></A
       
  6786 ->
       
  6787 -RewriteEngine</H1
       
  6788 -><DIV
       
  6789 -CLASS="REFNAMEDIV"
       
  6790 -><A
       
  6791 -NAME="AEN7341"
       
  6792 -></A
       
  6793 -><H2
       
  6794 ->Name</H2
       
  6795 ->RewriteEngine&nbsp;--&nbsp;Enable/disable mod_rewrite</DIV
       
  6796 -><DIV
       
  6797 -CLASS="REFSYNOPSISDIV"
       
  6798 -><A
       
  6799 -NAME="AEN7344"
       
  6800 -></A
       
  6801 -><H2
       
  6802 ->Synopsis</H2
       
  6803 -><P
       
  6804 -><B
       
  6805 -CLASS="COMMAND"
       
  6806 ->RewriteEngine</B
       
  6807 ->  [  <CODE
       
  6808 -CLASS="OPTION"
       
  6809 ->on|off</CODE
       
  6810 ->]</P
       
  6811 -><P
       
  6812 -></P
       
  6813 -><DIV
       
  6814 -CLASS="VARIABLELIST"
       
  6815 -><P
       
  6816 -><B
       
  6817 -></B
       
  6818 -></P
       
  6819 -><DL
       
  6820 -><DT
       
  6821 -><PRE
       
  6822 -CLASS="SYNOPSIS"
       
  6823 ->Default</PRE
       
  6824 -></DT
       
  6825 -><DD
       
  6826 -><P
       
  6827 ->off</P
       
  6828 -></DD
       
  6829 -><DT
       
  6830 -><PRE
       
  6831 -CLASS="SYNOPSIS"
       
  6832 ->Context</PRE
       
  6833 -></DT
       
  6834 -><DD
       
  6835 -><P
       
  6836 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  6837 -></DD
       
  6838 -><DT
       
  6839 -><PRE
       
  6840 -CLASS="SYNOPSIS"
       
  6841 ->Module</PRE
       
  6842 -></DT
       
  6843 -><DD
       
  6844 -><P
       
  6845 ->mod_rewrite</P
       
  6846 -></DD
       
  6847 -><DT
       
  6848 -><PRE
       
  6849 -CLASS="SYNOPSIS"
       
  6850 ->Compatibility</PRE
       
  6851 -></DT
       
  6852 -><DD
       
  6853 -><P
       
  6854 ->1.2.6rc1 and later</P
       
  6855 -></DD
       
  6856 -></DL
       
  6857 -></DIV
       
  6858 -></DIV
       
  6859 -><DIV
       
  6860 -CLASS="REFSECT1"
       
  6861 -><A
       
  6862 -NAME="AEN7371"
       
  6863 -></A
       
  6864 -><H2
       
  6865 ->Description</H2
       
  6866 -><P
       
  6867 ->The RewriteEngine directive enables or disables the module's runtime
       
  6868 -rewriting engine. If it is set to off this module does no parsing or
       
  6869 -rewriting at all. Use this directive to disable the module instead of
       
  6870 -commenting out all mod_rewrite directives.</P
       
  6871 -></DIV
       
  6872 -><DIV
       
  6873 -CLASS="REFSECT1"
       
  6874 -><A
       
  6875 -NAME="AEN7374"
       
  6876 -></A
       
  6877 -><H2
       
  6878 ->See also</H2
       
  6879 -><P
       
  6880 -></P
       
  6881 -></DIV
       
  6882 -><H1
       
  6883 -><A
       
  6884 -NAME="REWRITELOCK"
       
  6885 -></A
       
  6886 ->
       
  6887 -RewriteLock</H1
       
  6888 -><DIV
       
  6889 -CLASS="REFNAMEDIV"
       
  6890 -><A
       
  6891 -NAME="AEN7385"
       
  6892 -></A
       
  6893 -><H2
       
  6894 ->Name</H2
       
  6895 ->RewriteLock&nbsp;--&nbsp;Set the filename for synchronization lockfile</DIV
       
  6896 -><DIV
       
  6897 -CLASS="REFSYNOPSISDIV"
       
  6898 -><A
       
  6899 -NAME="AEN7388"
       
  6900 -></A
       
  6901 -><H2
       
  6902 ->Synopsis</H2
       
  6903 -><P
       
  6904 -><B
       
  6905 -CLASS="COMMAND"
       
  6906 ->RewriteLock</B
       
  6907 ->  [  <CODE
       
  6908 -CLASS="OPTION"
       
  6909 ->filename</CODE
       
  6910 ->]</P
       
  6911 -><P
       
  6912 -></P
       
  6913 -><DIV
       
  6914 -CLASS="VARIABLELIST"
       
  6915 -><P
       
  6916 -><B
       
  6917 -></B
       
  6918 -></P
       
  6919 -><DL
       
  6920 -><DT
       
  6921 -><PRE
       
  6922 -CLASS="SYNOPSIS"
       
  6923 ->Default</PRE
       
  6924 -></DT
       
  6925 -><DD
       
  6926 -><P
       
  6927 ->None</P
       
  6928 -></DD
       
  6929 -><DT
       
  6930 -><PRE
       
  6931 -CLASS="SYNOPSIS"
       
  6932 ->Context</PRE
       
  6933 -></DT
       
  6934 -><DD
       
  6935 -><P
       
  6936 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  6937 -></DD
       
  6938 -><DT
       
  6939 -><PRE
       
  6940 -CLASS="SYNOPSIS"
       
  6941 ->Module</PRE
       
  6942 -></DT
       
  6943 -><DD
       
  6944 -><P
       
  6945 ->mod_rewrite</P
       
  6946 -></DD
       
  6947 -><DT
       
  6948 -><PRE
       
  6949 -CLASS="SYNOPSIS"
       
  6950 ->Compatibility</PRE
       
  6951 -></DT
       
  6952 -><DD
       
  6953 -><P
       
  6954 ->1.2.6rc1 and later</P
       
  6955 -></DD
       
  6956 -></DL
       
  6957 -></DIV
       
  6958 -></DIV
       
  6959 -><DIV
       
  6960 -CLASS="REFSECT1"
       
  6961 -><A
       
  6962 -NAME="AEN7415"
       
  6963 -></A
       
  6964 -><H2
       
  6965 ->Description</H2
       
  6966 -><P
       
  6967 ->The RewriteLock directive sets the filename for a synchronization lockfile
       
  6968 -which mod_rewrite needs to communicate with RewriteMaps of type fifo. Set
       
  6969 -file to a local absolute path (not on a NFS-mounted device) when you want
       
  6970 -to use a rewriting FIFO. It is not required for other types of rewriting maps.</P
       
  6971 -></DIV
       
  6972 -><DIV
       
  6973 -CLASS="REFSECT1"
       
  6974 -><A
       
  6975 -NAME="AEN7418"
       
  6976 -></A
       
  6977 -><H2
       
  6978 ->See also</H2
       
  6979 -><P
       
  6980 -></P
       
  6981 -></DIV
       
  6982 -><H1
       
  6983 -><A
       
  6984 -NAME="REWRITELOG"
       
  6985 -></A
       
  6986 ->
       
  6987 -RewriteLog</H1
       
  6988 -><DIV
       
  6989 -CLASS="REFNAMEDIV"
       
  6990 -><A
       
  6991 -NAME="AEN7429"
       
  6992 -></A
       
  6993 -><H2
       
  6994 ->Name</H2
       
  6995 ->RewriteLog&nbsp;--&nbsp;Specify a log file for mod_rewrite reporting</DIV
       
  6996 -><DIV
       
  6997 -CLASS="REFSYNOPSISDIV"
       
  6998 -><A
       
  6999 -NAME="AEN7432"
       
  7000 -></A
       
  7001 -><H2
       
  7002 ->Synopsis</H2
       
  7003 -><P
       
  7004 -><B
       
  7005 -CLASS="COMMAND"
       
  7006 ->RewriteLog</B
       
  7007 ->  [  <CODE
       
  7008 -CLASS="OPTION"
       
  7009 ->file|"none"</CODE
       
  7010 ->]</P
       
  7011 -><P
       
  7012 -></P
       
  7013 -><DIV
       
  7014 -CLASS="VARIABLELIST"
       
  7015 -><P
       
  7016 -><B
       
  7017 -></B
       
  7018 -></P
       
  7019 -><DL
       
  7020 -><DT
       
  7021 -><PRE
       
  7022 -CLASS="SYNOPSIS"
       
  7023 ->Default</PRE
       
  7024 -></DT
       
  7025 -><DD
       
  7026 -><P
       
  7027 ->None</P
       
  7028 -></DD
       
  7029 -><DT
       
  7030 -><PRE
       
  7031 -CLASS="SYNOPSIS"
       
  7032 ->Context</PRE
       
  7033 -></DT
       
  7034 -><DD
       
  7035 -><P
       
  7036 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  7037 -></DD
       
  7038 -><DT
       
  7039 -><PRE
       
  7040 -CLASS="SYNOPSIS"
       
  7041 ->Module</PRE
       
  7042 -></DT
       
  7043 -><DD
       
  7044 -><P
       
  7045 ->mod_rewrite</P
       
  7046 -></DD
       
  7047 -><DT
       
  7048 -><PRE
       
  7049 -CLASS="SYNOPSIS"
       
  7050 ->Compatibility</PRE
       
  7051 -></DT
       
  7052 -><DD
       
  7053 -><P
       
  7054 ->1.2.6rc1 and later</P
       
  7055 -></DD
       
  7056 -></DL
       
  7057 -></DIV
       
  7058 -></DIV
       
  7059 -><DIV
       
  7060 -CLASS="REFSECT1"
       
  7061 -><A
       
  7062 -NAME="AEN7459"
       
  7063 -></A
       
  7064 -><H2
       
  7065 ->Description</H2
       
  7066 -><P
       
  7067 ->The RewriteLog directive is used to a specify a log file for mod_rewrite
       
  7068 -reporting and debugging, and can be done a per-server basis. The file
       
  7069 -parameter must be the full path to the file to use for logging. Note
       
  7070 -that this path must <SPAN
       
  7071 -CLASS="bold"
       
  7072 -><B
       
  7073 -CLASS="EMPHASIS"
       
  7074 ->not</B
       
  7075 -></SPAN
       
  7076 -> be to a
       
  7077 -world-writeable directory and, unless AllowLogSymlinks is explicitly
       
  7078 -set to on (generally a bad idea), the path must
       
  7079 -<SPAN
       
  7080 -CLASS="bold"
       
  7081 -><B
       
  7082 -CLASS="EMPHASIS"
       
  7083 ->not</B
       
  7084 -></SPAN
       
  7085 -> be a symbolic link. In general,
       
  7086 -this directive should only be used for debugging your mod_rewrite
       
  7087 -configuration, and should be removed once debugging is completed;
       
  7088 -<SPAN
       
  7089 -CLASS="bold"
       
  7090 -><B
       
  7091 -CLASS="EMPHASIS"
       
  7092 ->do not use this directive in a production
       
  7093 -configuration.</B
       
  7094 -></SPAN
       
  7095 -></P
       
  7096 -><P
       
  7097 ->If file is "none", no logging will be done at all; this setting can be
       
  7098 -used to override a RewriteLog setting inherited from a &lt;Global&gt; context. </P
       
  7099 -></DIV
       
  7100 -><DIV
       
  7101 -CLASS="REFSECT1"
       
  7102 -><A
       
  7103 -NAME="AEN7466"
       
  7104 -></A
       
  7105 -><H2
       
  7106 ->See also</H2
       
  7107 -><P
       
  7108 -></P
       
  7109 -></DIV
       
  7110 -><H1
       
  7111 -><A
       
  7112 -NAME="REWRITEMAP"
       
  7113 -></A
       
  7114 ->
       
  7115 -RewriteMap</H1
       
  7116 -><DIV
       
  7117 -CLASS="REFNAMEDIV"
       
  7118 -><A
       
  7119 -NAME="AEN7477"
       
  7120 -></A
       
  7121 -><H2
       
  7122 ->Name</H2
       
  7123 ->RewriteMap&nbsp;--&nbsp;Define a rewrite map</DIV
       
  7124 -><DIV
       
  7125 -CLASS="REFSYNOPSISDIV"
       
  7126 -><A
       
  7127 -NAME="AEN7480"
       
  7128 -></A
       
  7129 -><H2
       
  7130 ->Synopsis</H2
       
  7131 -><P
       
  7132 -><B
       
  7133 -CLASS="COMMAND"
       
  7134 ->RewriteMap</B
       
  7135 ->  [  <CODE
       
  7136 -CLASS="OPTION"
       
  7137 ->map-name map-type:map-soure</CODE
       
  7138 ->]</P
       
  7139 -><P
       
  7140 -></P
       
  7141 -><DIV
       
  7142 -CLASS="VARIABLELIST"
       
  7143 -><P
       
  7144 -><B
       
  7145 -></B
       
  7146 -></P
       
  7147 -><DL
       
  7148 -><DT
       
  7149 -><PRE
       
  7150 -CLASS="SYNOPSIS"
       
  7151 ->Default</PRE
       
  7152 -></DT
       
  7153 -><DD
       
  7154 -><P
       
  7155 ->None</P
       
  7156 -></DD
       
  7157 -><DT
       
  7158 -><PRE
       
  7159 -CLASS="SYNOPSIS"
       
  7160 ->Context</PRE
       
  7161 -></DT
       
  7162 -><DD
       
  7163 -><P
       
  7164 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  7165 -></DD
       
  7166 -><DT
       
  7167 -><PRE
       
  7168 -CLASS="SYNOPSIS"
       
  7169 ->Module</PRE
       
  7170 -></DT
       
  7171 -><DD
       
  7172 -><P
       
  7173 ->mod_rewrite</P
       
  7174 -></DD
       
  7175 -><DT
       
  7176 -><PRE
       
  7177 -CLASS="SYNOPSIS"
       
  7178 ->Compatibility</PRE
       
  7179 -></DT
       
  7180 -><DD
       
  7181 -><P
       
  7182 ->1.2.6rc1 and later</P
       
  7183 -></DD
       
  7184 -></DL
       
  7185 -></DIV
       
  7186 -></DIV
       
  7187 -><DIV
       
  7188 -CLASS="REFSECT1"
       
  7189 -><A
       
  7190 -NAME="AEN7507"
       
  7191 -></A
       
  7192 -><H2
       
  7193 ->Description</H2
       
  7194 -><P
       
  7195 ->The RewriteMap directive defines a rewriting map which can be used inside
       
  7196 -rule substitution strings by the mapping-functions to insert/substitute
       
  7197 -fields through a key lookup. The source of this lookup can be of various types.</P
       
  7198 -><P
       
  7199 ->The map-name is the name of the map and will be used to specify a
       
  7200 -mapping-function for the substitution strings of a rewriting rule via
       
  7201 -one of the following constructs:</P
       
  7202 -><P
       
  7203 -><SPAN
       
  7204 -CLASS="bold"
       
  7205 -><B
       
  7206 -CLASS="EMPHASIS"
       
  7207 ->${ map-name :  lookup-key }</B
       
  7208 -></SPAN
       
  7209 -></P
       
  7210 -><P
       
  7211 -><SPAN
       
  7212 -CLASS="bold"
       
  7213 -><B
       
  7214 -CLASS="EMPHASIS"
       
  7215 ->${ map-name :  lookup-key</B
       
  7216 -></SPAN
       
  7217 ->
       
  7218 - | 
       
  7219 -<SPAN
       
  7220 -CLASS="bold"
       
  7221 -><B
       
  7222 -CLASS="EMPHASIS"
       
  7223 ->default-value</B
       
  7224 -></SPAN
       
  7225 -></P
       
  7226 -><P
       
  7227 ->When such a construct occurs the map map-name is consulted and the key
       
  7228 -lookup-key is resolved. If the key is found, the map-function construct
       
  7229 -is substituted by subst-value. If the key is not found then it is
       
  7230 -substituted by default-value or by the empty string if no default-value
       
  7231 -was specified.</P
       
  7232 -><P
       
  7233 ->The following combinations for map-type and map-src can be used:</P
       
  7234 -><P
       
  7235 -></P
       
  7236 -><UL
       
  7237 -><LI
       
  7238 -STYLE="list-style-type: disc"
       
  7239 -><P
       
  7240 ->			<SPAN
       
  7241 -CLASS="bold"
       
  7242 -><B
       
  7243 -CLASS="EMPHASIS"
       
  7244 ->Standard Plain Text</B
       
  7245 -></SPAN
       
  7246 ->
       
  7247 -		</P
       
  7248 -><P
       
  7249 ->			map-type: txt, map-src: Unix filesystem path to
       
  7250 -			valid regular file.
       
  7251 -		</P
       
  7252 -><P
       
  7253 ->		This is the standard rewriting map feature where
       
  7254 -		the map-src is a plain ASCII file containing either blank
       
  7255 -		lines, comment lines (starting with a '#' character) or
       
  7256 -		pairs like the following - one per line.
       
  7257 -		</P
       
  7258 -><P
       
  7259 ->			<SPAN
       
  7260 -CLASS="bold"
       
  7261 -><B
       
  7262 -CLASS="EMPHASIS"
       
  7263 ->matching-key subst-value</B
       
  7264 -></SPAN
       
  7265 ->
       
  7266 -		</P
       
  7267 -><DIV
       
  7268 -CLASS="EXAMPLE"
       
  7269 -><A
       
  7270 -NAME="EXAMPLE-USERMAP"
       
  7271 -></A
       
  7272 -><P
       
  7273 -><B
       
  7274 ->Example 1-1. Example Usermap</B
       
  7275 -></P
       
  7276 -><PRE
       
  7277 -CLASS="PROGRAMLISTING"
       
  7278 ->		    # --------------------------------------------
       
  7279 -    		    # usermap.txt -- map for rewriting user names
       
  7280 -    		    # --------------------------------------------
       
  7281 -
       
  7282 -    		    Dave.Admin      dave       # The Uber-admin
       
  7283 -    		    root            anonymous  # no one should be logging in as root anyway
       
  7284 -		</PRE
       
  7285 -></DIV
       
  7286 -><P
       
  7287 ->			And, to configure this map to be used:
       
  7288 -		</P
       
  7289 -><PRE
       
  7290 -CLASS="PROGRAMLISTING"
       
  7291 ->			RewriteMap real-to-user txt:/path/to/file/usermap.txt
       
  7292 -		</PRE
       
  7293 -></LI
       
  7294 -><LI
       
  7295 -STYLE="list-style-type: disc"
       
  7296 -><P
       
  7297 -><SPAN
       
  7298 -CLASS="bold"
       
  7299 -><B
       
  7300 -CLASS="EMPHASIS"
       
  7301 ->FIFO/Named Pipe</B
       
  7302 -></SPAN
       
  7303 -></P
       
  7304 -><P
       
  7305 ->			map-type: fifo, map-src: Unix filesystem path
       
  7306 -			to valid FIFO.
       
  7307 -		</P
       
  7308 -><P
       
  7309 ->		For this rewriting map, map-src is a FIFO (a.k.a. named pipe).
       
  7310 -		To create it, you can use the mkfifo(1) command. An
       
  7311 -		external program that opens the FIFO for reading and
       
  7312 -		writing <SPAN
       
  7313 -CLASS="bold"
       
  7314 -><B
       
  7315 -CLASS="EMPHASIS"
       
  7316 ->must</B
       
  7317 -></SPAN
       
  7318 ->  be started
       
  7319 -		before proftpd is started. This program can communicate
       
  7320 -		with the rewriting engine via the FIFO. For each mapping
       
  7321 -		lookup, it can read the key to lookup as a newline-terminated
       
  7322 -		string from the FIFO. It then has to write back to the FIFO
       
  7323 -		the looked-up value as a newline-terminated string, or just
       
  7324 -		simply newline character (denoting an empty string) if there
       
  7325 -		is no corresponding value for the given key).
       
  7326 -		</P
       
  7327 -><P
       
  7328 ->		An example program which will implement a 1:1 mapping
       
  7329 -		(i.e., key == value) could be:
       
  7330 -		</P
       
  7331 -><DIV
       
  7332 -CLASS="EXAMPLE"
       
  7333 -><A
       
  7334 -NAME="EXAMPLE-FIFONAMEDPIPE"
       
  7335 -></A
       
  7336 -><P
       
  7337 -><B
       
  7338 ->Example 1-2. Example FIFO/Named Pipe 1:1 mapping</B
       
  7339 -></P
       
  7340 -><PRE
       
  7341 -CLASS="PROGRAMLISTING"
       
  7342 ->#!/usr/bin/perl
       
  7343 -    use strict;
       
  7344 -
       
  7345 -    use File::Basename qw(basename);
       
  7346 -    use Getopt::Long;
       
  7347 -    use IO::Handle;
       
  7348 -    use IO::Select;
       
  7349 -
       
  7350 -    my $default_delay = 0.5;
       
  7351 -    my $program = basename($0);
       
  7352 -    my %opts = ();
       
  7353 -
       
  7354 -    GetOptions(\%opts, 'delay=f', 'fifo=s', 'help', 'verbose');
       
  7355 -
       
  7356 -    usage() if $opts{'help'};
       
  7357 -
       
  7358 -    my $delay = $opts{'delay'} ? $opts{'delay'} : $default_delay;
       
  7359 -
       
  7360 -    die "$program: missing required --fifo parameter\n" unless $opts{'fifo'};
       
  7361 -    my $fifo = $opts{'fifo'};
       
  7362 -
       
  7363 -    my $verbose = $opts{'verbose'} ? 1 : 0;
       
  7364 -
       
  7365 -    open(my $fifo_fh, "+&#62; $fifo") or die "$program: unable to open $fifo: $!\n";
       
  7366 -
       
  7367 -    # Instantiate a Select object for knowing when to read from and write to
       
  7368 -    # the FIFO.
       
  7369 -    my $sel = IO::Select-&#62;new();
       
  7370 -
       
  7371 -    while (1) {
       
  7372 -
       
  7373 -      # Blocking select() for reading.
       
  7374 -      $sel-&#62;add($fifo_fh);
       
  7375 -
       
  7376 -      print STDERR "$program: selecting for reading\n" if $verbose;
       
  7377 -      my ($rfh) = $sel-&#62;can_read();
       
  7378 -
       
  7379 -      my $key = &lt;$rfh&gt;;
       
  7380 -      print STDERR "$program: read '$key'\n" if $verbose;
       
  7381 -
       
  7382 -      # Lookup a value for the given key.
       
  7383 -      my $value = lookup_value($key);
       
  7384 -
       
  7385 -      # Clear the Select object's filehandles.
       
  7386 -      $sel-&#62;remove();
       
  7387 -
       
  7388 -      print $fifo_fh "$value\n" if $verbose;
       
  7389 -      $fifo_fh-&#62;flush();
       
  7390 -
       
  7391 -      print STDERR "$program: wrote '$value'\n" if $verbose;
       
  7392 -
       
  7393 -      # Wait for the buffer's byte to be cleared before reading again.
       
  7394 -      wait_fifo($fifo_fh);
       
  7395 -    }
       
  7396 -
       
  7397 -    close($fifo_fh);
       
  7398 -    print STDOUT "$program: done\n" if $verbose;
       
  7399 -
       
  7400 -    exit 0;
       
  7401 -
       
  7402 -    # --------------------------------------------------------------------------
       
  7403 -    sub lookup_value {
       
  7404 -      my ($key) = @_;
       
  7405 -
       
  7406 -      # NOTE: do something to obtain a value for the given key here.
       
  7407 -      chomp(my $value = $key);
       
  7408 -
       
  7409 -      return $value;
       
  7410 -    }
       
  7411 -
       
  7412 -    # --------------------------------------------------------------------------
       
  7413 -    sub usage {
       
  7414 -      print STDOUT &lt;&lt;END_OF_USAGE;
       
  7415 -
       
  7416 -    usage: $program [options]
       
  7417 -
       
  7418 -      --delay         Configure the buffer check delay.
       
  7419 -                      The default is $default_delay seconds.
       
  7420 -
       
  7421 -      --fifo          Configure the path to the FIFO.  Required.
       
  7422 -
       
  7423 -      --help          Displays this message.
       
  7424 -
       
  7425 -      --verbose       Enables verbose output while $program runs.
       
  7426 -
       
  7427 -    END_OF_USAGE
       
  7428 -
       
  7429 -      exit 0;
       
  7430 -    }
       
  7431 -
       
  7432 -    # --------------------------------------------------------------------------
       
  7433 -    sub wait_fifo {
       
  7434 -      my ($fh) = @_;
       
  7435 -
       
  7436 -      # Now we get tricky.  Use ioctl(2) to poll the number of bytes to
       
  7437 -      # be read from the FIFO filehandle.  When the number drops to zero,
       
  7438 -      # it means that the data we just wrote has been read from the buffer
       
  7439 -      # by some other process, so we can go back to the top of this loop.
       
  7440 -      # Otherwise, if this program loops faster than the reader/writer on
       
  7441 -      # the other end of the FIFO, we'd end up reading the data we just
       
  7442 -      # wrote.  Quite annoying, actually.
       
  7443 -      #
       
  7444 -      # Note: this value must be manually extracted from the system header files
       
  7445 -      # using the following program:
       
  7446 -      #
       
  7447 -      # -------- fionread.c -------------------
       
  7448 -      #  #include &lt;sys/ioctl.h&gt;
       
  7449 -      #
       
  7450 -      #  int main(int argc, char *argv[]) {
       
  7451 -      #   printf("%#08x\n", FIONREAD);
       
  7452 -      #   return 0;
       
  7453 -      # }
       
  7454 -      # ---------------------------------------
       
  7455 -      #
       
  7456 -      # &#62; cc -o fionread fionread.c
       
  7457 -      # &#62; ./fionread
       
  7458 -
       
  7459 -      my $FIONREAD = 0x00541b;
       
  7460 -
       
  7461 -      my $size = pack('L', 0);
       
  7462 -      ioctl($fh, $FIONREAD, $size) or die "$program: unable to use ioctl: $!\n";
       
  7463 -      $size = unpack('L', $size);
       
  7464 -
       
  7465 -      while ($size != 0) {
       
  7466 -        print STDERR "$program: waiting for buffer to be read\n" if $verbose;
       
  7467 -        select(undef, undef, undef, $delay);
       
  7468 -
       
  7469 -        $size = pack('L', 0);
       
  7470 -        ioctl($fh, $FIONREAD, $size) or die "$program: unable to use ioctl: $!\n";
       
  7471 -        $size = unpack('L', $size);
       
  7472 -      }
       
  7473 -    }
       
  7474 -
       
  7475 -		</PRE
       
  7476 -></DIV
       
  7477 -><P
       
  7478 ->		To make use of this example script, simply implement your
       
  7479 -		lookup code in the lookup_value() subroutine. Be very
       
  7480 -		careful with such scripts, though:
       
  7481 -		</P
       
  7482 -><P
       
  7483 -></P
       
  7484 -><OL
       
  7485 -TYPE="1"
       
  7486 -><LI
       
  7487 -STYLE="list-style-type: disc"
       
  7488 -><P
       
  7489 ->			     "Keep it simple, stupid" (KISS), because if
       
  7490 -			      this program hangs it will hang proftpd when
       
  7491 -			      the rule occurs. Well, keep it as simple as
       
  7492 -			      possible...
       
  7493 -			     </P
       
  7494 -></LI
       
  7495 -><LI
       
  7496 -STYLE="list-style-type: disc"
       
  7497 -><P
       
  7498 ->			     Avoid one common mistake: avoid buffered I/O
       
  7499 -			     if possible. This can cause a deadloop. If
       
  7500 -			     necessary, be sure to flush the filehandle
       
  7501 -			     before reading, and after writing.
       
  7502 -			     </P
       
  7503 -></LI
       
  7504 -><LI
       
  7505 -STYLE="list-style-type: disc"
       
  7506 -><P
       
  7507 ->			     Use the RewriteLock directive to define a
       
  7508 -			     lockfile mod_rewrite can use to synchronize
       
  7509 -			     the communication to the FIFO program. By
       
  7510 -			     default no such synchronization takes place.
       
  7511 -			     </P
       
  7512 -></LI
       
  7513 -></OL
       
  7514 -></LI
       
  7515 -><LI
       
  7516 -STYLE="list-style-type: disc"
       
  7517 -><P
       
  7518 -><SPAN
       
  7519 -CLASS="bold"
       
  7520 -><B
       
  7521 -CLASS="EMPHASIS"
       
  7522 ->Internal Function</B
       
  7523 -></SPAN
       
  7524 -></P
       
  7525 -><P
       
  7526 ->			map-type: int, map-src: Internal mod_rewrite function.
       
  7527 -		</P
       
  7528 -><P
       
  7529 ->		Here the map-src is a mod_rewrite built-in function.
       
  7530 -		Currently you cannot create your own, but the following
       
  7531 -		functions already exist:
       
  7532 -		</P
       
  7533 -><P
       
  7534 -></P
       
  7535 -><UL
       
  7536 -><LI
       
  7537 -STYLE="list-style-type: disc"
       
  7538 -><P
       
  7539 -><SPAN
       
  7540 -CLASS="bold"
       
  7541 -><B
       
  7542 -CLASS="EMPHASIS"
       
  7543 ->toupper</B
       
  7544 -></SPAN
       
  7545 -></P
       
  7546 -><P
       
  7547 ->			Converts the looked up key to all upper case.
       
  7548 -			</P
       
  7549 -></LI
       
  7550 -><LI
       
  7551 -STYLE="list-style-type: disc"
       
  7552 -><P
       
  7553 -><SPAN
       
  7554 -CLASS="bold"
       
  7555 -><B
       
  7556 -CLASS="EMPHASIS"
       
  7557 ->tolower</B
       
  7558 -></SPAN
       
  7559 -></P
       
  7560 -><P
       
  7561 ->			Converts the looked up key to all lower case.
       
  7562 -			</P
       
  7563 -></LI
       
  7564 -><LI
       
  7565 -STYLE="list-style-type: disc"
       
  7566 -><P
       
  7567 -><SPAN
       
  7568 -CLASS="bold"
       
  7569 -><B
       
  7570 -CLASS="EMPHASIS"
       
  7571 ->unescape</B
       
  7572 -></SPAN
       
  7573 -></P
       
  7574 -><P
       
  7575 ->			Translates hex-encodings in the looked up key back
       
  7576 -			to special characters.
       
  7577 -			</P
       
  7578 -></LI
       
  7579 -><LI
       
  7580 -STYLE="list-style-type: disc"
       
  7581 -><P
       
  7582 -><SPAN
       
  7583 -CLASS="bold"
       
  7584 -><B
       
  7585 -CLASS="EMPHASIS"
       
  7586 ->utf8trans</B
       
  7587 -></SPAN
       
  7588 -></P
       
  7589 -><P
       
  7590 ->			Translates UTF-8 encodings in the lookup up key into
       
  7591 -			Latin-1 characters.
       
  7592 -			</P
       
  7593 -></LI
       
  7594 -></UL
       
  7595 -></LI
       
  7596 -></UL
       
  7597 -><P
       
  7598 ->The RewriteMap directive can occur more than once. For each mapping-function
       
  7599 -use one RewriteMap directive to declare its rewriting map name.</P
       
  7600 -><P
       
  7601 -><SPAN
       
  7602 -CLASS="bold"
       
  7603 -><B
       
  7604 -CLASS="EMPHASIS"
       
  7605 ->Note:</B
       
  7606 -></SPAN
       
  7607 -> For plain text files the looked-up
       
  7608 -keys are cached in-core until the mtime of the text map file changes or
       
  7609 -the server does a restart. This way you can have map-functions in rules
       
  7610 -which are used for <SPAN
       
  7611 -CLASS="bold"
       
  7612 -><B
       
  7613 -CLASS="EMPHASIS"
       
  7614 ->every</B
       
  7615 -></SPAN
       
  7616 -> request. This
       
  7617 -is no problem, because the parsing of the text files only happens once!</P
       
  7618 -></DIV
       
  7619 -><DIV
       
  7620 -CLASS="REFSECT1"
       
  7621 -><A
       
  7622 -NAME="AEN7575"
       
  7623 -></A
       
  7624 -><H2
       
  7625 ->See also</H2
       
  7626 -><P
       
  7627 -><A
       
  7628 -HREF="#REWRITECONDITION"
       
  7629 ->RewriteCondition</A
       
  7630 -></P
       
  7631 -></DIV
       
  7632 -><H1
       
  7633 -><A
       
  7634 -NAME="REWRITERULE"
       
  7635 -></A
       
  7636 ->
       
  7637 -RewriteRule</H1
       
  7638 -><DIV
       
  7639 -CLASS="REFNAMEDIV"
       
  7640 -><A
       
  7641 -NAME="AEN7587"
       
  7642 -></A
       
  7643 -><H2
       
  7644 ->Name</H2
       
  7645 ->RewriteRule&nbsp;--&nbsp;Define a rewrite rule</DIV
       
  7646 -><DIV
       
  7647 -CLASS="REFSYNOPSISDIV"
       
  7648 -><A
       
  7649 -NAME="AEN7590"
       
  7650 -></A
       
  7651 -><H2
       
  7652 ->Synopsis</H2
       
  7653 -><P
       
  7654 -><B
       
  7655 -CLASS="COMMAND"
       
  7656 ->RewriteRule</B
       
  7657 ->  [  <CODE
       
  7658 -CLASS="OPTION"
       
  7659 ->pattern substitution</CODE
       
  7660 ->]</P
       
  7661 -><P
       
  7662 -></P
       
  7663 -><DIV
       
  7664 -CLASS="VARIABLELIST"
       
  7665 -><P
       
  7666 -><B
       
  7667 -></B
       
  7668 -></P
       
  7669 -><DL
       
  7670 -><DT
       
  7671 -><PRE
       
  7672 -CLASS="SYNOPSIS"
       
  7673 ->Default</PRE
       
  7674 -></DT
       
  7675 -><DD
       
  7676 -><P
       
  7677 ->None</P
       
  7678 -></DD
       
  7679 -><DT
       
  7680 -><PRE
       
  7681 -CLASS="SYNOPSIS"
       
  7682 ->Context</PRE
       
  7683 -></DT
       
  7684 -><DD
       
  7685 -><P
       
  7686 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;, &lt;Anonymous&gt;, &lt;Directory&gt;</P
       
  7687 -></DD
       
  7688 -><DT
       
  7689 -><PRE
       
  7690 -CLASS="SYNOPSIS"
       
  7691 ->Module</PRE
       
  7692 -></DT
       
  7693 -><DD
       
  7694 -><P
       
  7695 ->mod_rewrite</P
       
  7696 -></DD
       
  7697 -><DT
       
  7698 -><PRE
       
  7699 -CLASS="SYNOPSIS"
       
  7700 ->Compatibility</PRE
       
  7701 -></DT
       
  7702 -><DD
       
  7703 -><P
       
  7704 ->1.2.6rc1 and later</P
       
  7705 -></DD
       
  7706 -></DL
       
  7707 -></DIV
       
  7708 -></DIV
       
  7709 -><DIV
       
  7710 -CLASS="REFSECT1"
       
  7711 -><A
       
  7712 -NAME="AEN7617"
       
  7713 -></A
       
  7714 -><H2
       
  7715 ->Description</H2
       
  7716 -><P
       
  7717 ->The RewriteRule directive is the real rewriting workhorse. The configuration
       
  7718 -directive can occur more than once. Each directive defines a single
       
  7719 -rewriting rule. The order of definition of these rules is important,
       
  7720 -because this order is used when applying the rules at run-time.</P
       
  7721 -><P
       
  7722 ->Pattern can be POSIX regular expression which gets applied to the current
       
  7723 -FTP command argument(s).</P
       
  7724 -><P
       
  7725 ->Some hints about the syntax of regular expressions:</P
       
  7726 -><P
       
  7727 -></P
       
  7728 -><UL
       
  7729 -><LI
       
  7730 -STYLE="list-style-type: disc"
       
  7731 -><P
       
  7732 -><SPAN
       
  7733 -CLASS="bold"
       
  7734 -><B
       
  7735 -CLASS="EMPHASIS"
       
  7736 ->Text:</B
       
  7737 -></SPAN
       
  7738 -></P
       
  7739 -><PRE
       
  7740 -CLASS="PROGRAMLISTING"
       
  7741 ->	        .           Any single character
       
  7742 -  		[chars]     Character class: one of chars
       
  7743 -		[^chars]    Character class: none of chars
       
  7744 -  		text1|text2 Alternative: text1 or text2
       
  7745 -	      </PRE
       
  7746 -></LI
       
  7747 -><LI
       
  7748 -STYLE="list-style-type: disc"
       
  7749 -><P
       
  7750 -><SPAN
       
  7751 -CLASS="bold"
       
  7752 -><B
       
  7753 -CLASS="EMPHASIS"
       
  7754 ->Quantifiers:</B
       
  7755 -></SPAN
       
  7756 -></P
       
  7757 -><PRE
       
  7758 -CLASS="PROGRAMLISTING"
       
  7759 ->	        ?           0 or 1 of the preceding text
       
  7760 -  		*           0 or N of the preceding text (N &#62; 0)
       
  7761 -  		+           1 or N of the preceding text (N &#62; 1)
       
  7762 -	      </PRE
       
  7763 -></LI
       
  7764 -><LI
       
  7765 -STYLE="list-style-type: disc"
       
  7766 -><P
       
  7767 -><SPAN
       
  7768 -CLASS="bold"
       
  7769 -><B
       
  7770 -CLASS="EMPHASIS"
       
  7771 ->Grouping:</B
       
  7772 -></SPAN
       
  7773 -></P
       
  7774 -><PRE
       
  7775 -CLASS="PROGRAMLISTING"
       
  7776 -> 	      (text)       Grouping of text
       
  7777 -              		   (either to set the borders of an alternative or
       
  7778 -              		   for making backreferences where the Nth group can 
       
  7779 -              		   be used on the RHS of a RewriteRule with $N)
       
  7780 -	      </PRE
       
  7781 -></LI
       
  7782 -><LI
       
  7783 -STYLE="list-style-type: disc"
       
  7784 -><P
       
  7785 -><SPAN
       
  7786 -CLASS="bold"
       
  7787 -><B
       
  7788 -CLASS="EMPHASIS"
       
  7789 ->Anchors:</B
       
  7790 -></SPAN
       
  7791 -></P
       
  7792 -><PRE
       
  7793 -CLASS="PROGRAMLISTING"
       
  7794 ->	        ^           Start of line anchor
       
  7795 -  		$           End of line anchor
       
  7796 -	      </PRE
       
  7797 -></LI
       
  7798 -><LI
       
  7799 -STYLE="list-style-type: disc"
       
  7800 -><P
       
  7801 -><SPAN
       
  7802 -CLASS="bold"
       
  7803 -><B
       
  7804 -CLASS="EMPHASIS"
       
  7805 ->Escaping:</B
       
  7806 -></SPAN
       
  7807 -></P
       
  7808 -><PRE
       
  7809 -CLASS="PROGRAMLISTING"
       
  7810 ->		\char       Escape that particular char
       
  7811 -              		    (for instance to specify the chars ".[]()" etc.)
       
  7812 -	      </PRE
       
  7813 -></LI
       
  7814 -></UL
       
  7815 -><P
       
  7816 ->For more information about regular expressions have a look at your local
       
  7817 -regex(3) manpage. If you are interested in more detailed information about
       
  7818 -regular expressions and their variants (POSIX regex, Perl regex, etc.) have
       
  7819 -a look at the following dedicated book on this topic:</P
       
  7820 -><P
       
  7821 ->Mastering Regular Expressions
       
  7822 -Jeffrey E.F. Friedl
       
  7823 -Nutshell Handbook Series
       
  7824 -O'Reilly &#38; Associates, Inc. 1997
       
  7825 -ISBN 1-56592-257-3</P
       
  7826 -><P
       
  7827 ->Additionally in mod_rewrite the NOT character ('!') is a possible pattern
       
  7828 -prefix. This gives you the ability to negate a pattern; to say, for instance:
       
  7829 -"if the current argument(s) does NOT match this pattern". This can be used
       
  7830 -for exceptional cases, where it is easier to match the negative pattern,
       
  7831 -or as a last default rule.</P
       
  7832 -><P
       
  7833 -><SPAN
       
  7834 -CLASS="bold"
       
  7835 -><B
       
  7836 -CLASS="EMPHASIS"
       
  7837 ->Notice:</B
       
  7838 -></SPAN
       
  7839 -> When using the NOT character to
       
  7840 -negate a pattern you cannot have grouped wildcard parts in the pattern.
       
  7841 -This is impossible because when the pattern does NOT match, there are no
       
  7842 -contents for the groups. In consequence, if negated patterns are used,
       
  7843 -you cannot use $N in the substitution string.</P
       
  7844 -><P
       
  7845 ->Substitution of a rewriting rule is the string which is substituted for
       
  7846 -(or replaces) the original argument(s) for which pattern matched. Beside
       
  7847 -plain text you can use:</P
       
  7848 -><P
       
  7849 -></P
       
  7850 -><OL
       
  7851 -TYPE="1"
       
  7852 -><LI
       
  7853 -><P
       
  7854 ->     $N backreferences to the RewriteRule pattern
       
  7855 -     </P
       
  7856 -></LI
       
  7857 -><LI
       
  7858 -><P
       
  7859 ->     %N backreferences to the last matched RewriteCondition pattern
       
  7860 -     </P
       
  7861 -></LI
       
  7862 -><LI
       
  7863 -><P
       
  7864 ->     variables as in RewriteCondition test strings
       
  7865 -     </P
       
  7866 -></LI
       
  7867 -><LI
       
  7868 -><P
       
  7869 ->     map function calls (${map-name:lookup-key|default-value}) 
       
  7870 -     </P
       
  7871 -></LI
       
  7872 -></OL
       
  7873 -><P
       
  7874 ->Backreferences are $<SPAN
       
  7875 -CLASS="bold"
       
  7876 -><B
       
  7877 -CLASS="EMPHASIS"
       
  7878 ->N</B
       
  7879 -></SPAN
       
  7880 ->
       
  7881 -(<SPAN
       
  7882 -CLASS="bold"
       
  7883 -><B
       
  7884 -CLASS="EMPHASIS"
       
  7885 ->N</B
       
  7886 -></SPAN
       
  7887 ->=0..9) identifiers which will be replaced
       
  7888 -by the contents of the <SPAN
       
  7889 -CLASS="bold"
       
  7890 -><B
       
  7891 -CLASS="EMPHASIS"
       
  7892 ->N</B
       
  7893 -></SPAN
       
  7894 ->th group of the
       
  7895 -matched pattern. The variables are the same as for the condition of a
       
  7896 -<A
       
  7897 -HREF="#REWRITECONDITION"
       
  7898 ->RewriteCondition</A
       
  7899 -> directive, with two
       
  7900 -additions:</P
       
  7901 -><P
       
  7902 -></P
       
  7903 -><UL
       
  7904 -><LI
       
  7905 -><P
       
  7906 ->	%<SPAN
       
  7907 -CLASS="bold"
       
  7908 -><B
       
  7909 -CLASS="EMPHASIS"
       
  7910 ->P</B
       
  7911 -></SPAN
       
  7912 ->
       
  7913 -	process ID
       
  7914 -	</P
       
  7915 -></LI
       
  7916 -><LI
       
  7917 -><P
       
  7918 ->	%<SPAN
       
  7919 -CLASS="bold"
       
  7920 -><B
       
  7921 -CLASS="EMPHASIS"
       
  7922 ->t</B
       
  7923 -></SPAN
       
  7924 ->
       
  7925 -	Unix time since the epoch, in seconds
       
  7926 -	</P
       
  7927 -></LI
       
  7928 -></UL
       
  7929 -><P
       
  7930 ->The map functions come from the <A
       
  7931 -HREF="#REWRITEMAP"
       
  7932 ->RewriteMap</A
       
  7933 ->
       
  7934 -directive and are explained there. These four types of variables are
       
  7935 -expanded in the order of the above list.</P
       
  7936 -><P
       
  7937 ->All of the rewriting rules are applied to substitution. The command
       
  7938 -argument(s) is completely replaced by the substitution.</P
       
  7939 -></DIV
       
  7940 -><DIV
       
  7941 -CLASS="REFSECT1"
       
  7942 -><A
       
  7943 -NAME="AEN7673"
       
  7944 -></A
       
  7945 -><H2
       
  7946 ->See also</H2
       
  7947 -><P
       
  7948 -><A
       
  7949 -HREF="#REWRITECONDITION"
       
  7950 ->RewriteCondition</A
       
  7951 ->
       
  7952 -<A
       
  7953 -HREF="#REWRITEMAP"
       
  7954 ->RewriteMap</A
       
  7955 -></P
       
  7956 -></DIV
       
  7957 -><DIV
       
  7958 -CLASS="REFSECT1"
       
  7959 -><A
       
  7960 -NAME="AEN7678"
       
  7961 -></A
       
  7962 -><H2
       
  7963 ->Examples</H2
       
  7964 -><P
       
  7965 -CLASS="LITERALLAYOUT"
       
  7966 -></P
       
  7967 -></DIV
       
  7968 -><H1
       
  7969 -><A
       
  7970  NAME="RLIMITCPU"
       
  7971  ></A
       
  7972  >
       
  7973 @@ -21815,115 +14077,6 @@
       
  7974  ></DIV
       
  7975  ><H1
       
  7976  ><A
       
  7977 -NAME="SAVERATIOS"
       
  7978 -></A
       
  7979 ->
       
  7980 -SaveRatios</H1
       
  7981 -><DIV
       
  7982 -CLASS="REFNAMEDIV"
       
  7983 -><A
       
  7984 -NAME="AEN7924"
       
  7985 -></A
       
  7986 -><H2
       
  7987 ->Name</H2
       
  7988 ->SaveRatios&nbsp;--&nbsp;FIXME FIXME</DIV
       
  7989 -><DIV
       
  7990 -CLASS="REFSYNOPSISDIV"
       
  7991 -><A
       
  7992 -NAME="AEN7927"
       
  7993 -></A
       
  7994 -><H2
       
  7995 ->Synopsis</H2
       
  7996 -><P
       
  7997 -><B
       
  7998 -CLASS="COMMAND"
       
  7999 ->SaveRatios</B
       
  8000 ->  [  <CODE
       
  8001 -CLASS="OPTION"
       
  8002 ->SaveRatios foo1 foo2 foo3</CODE
       
  8003 ->]</P
       
  8004 -><P
       
  8005 -></P
       
  8006 -><DIV
       
  8007 -CLASS="VARIABLELIST"
       
  8008 -><P
       
  8009 -><B
       
  8010 -></B
       
  8011 -></P
       
  8012 -><DL
       
  8013 -><DT
       
  8014 -><PRE
       
  8015 -CLASS="SYNOPSIS"
       
  8016 ->Default</PRE
       
  8017 -></DT
       
  8018 -><DD
       
  8019 -><P
       
  8020 ->None known</P
       
  8021 -></DD
       
  8022 -><DT
       
  8023 -><PRE
       
  8024 -CLASS="SYNOPSIS"
       
  8025 ->Context</PRE
       
  8026 -></DT
       
  8027 -><DD
       
  8028 -><P
       
  8029 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
  8030 -></DD
       
  8031 -><DT
       
  8032 -><PRE
       
  8033 -CLASS="SYNOPSIS"
       
  8034 ->Module</PRE
       
  8035 -></DT
       
  8036 -><DD
       
  8037 -><P
       
  8038 ->mod_ratio</P
       
  8039 -></DD
       
  8040 -><DT
       
  8041 -><PRE
       
  8042 -CLASS="SYNOPSIS"
       
  8043 ->Compatibility</PRE
       
  8044 -></DT
       
  8045 -><DD
       
  8046 -><P
       
  8047 ->at least 1.2.0 and later</P
       
  8048 -></DD
       
  8049 -></DL
       
  8050 -></DIV
       
  8051 -></DIV
       
  8052 -><DIV
       
  8053 -CLASS="REFSECT1"
       
  8054 -><A
       
  8055 -NAME="AEN7954"
       
  8056 -></A
       
  8057 -><H2
       
  8058 ->Description</H2
       
  8059 -><P
       
  8060 ->The SaveRatios directive ....
       
  8061 -Example:
       
  8062 -SaveRatios</P
       
  8063 -></DIV
       
  8064 -><DIV
       
  8065 -CLASS="REFSECT1"
       
  8066 -><A
       
  8067 -NAME="AEN7957"
       
  8068 -></A
       
  8069 -><H2
       
  8070 ->See also</H2
       
  8071 -><P
       
  8072 -></P
       
  8073 -></DIV
       
  8074 -><DIV
       
  8075 -CLASS="REFSECT1"
       
  8076 -><A
       
  8077 -NAME="AEN7960"
       
  8078 -></A
       
  8079 -><H2
       
  8080 ->Examples</H2
       
  8081 -><P
       
  8082 -></P
       
  8083 -></DIV
       
  8084 -><H1
       
  8085 -><A
       
  8086  NAME="SCOREBOARDFILE"
       
  8087  ></A
       
  8088  >
       
  8089 @@ -22585,7 +14738,7 @@
       
  8090  ></A
       
  8091  ><H2
       
  8092  >Name</H2
       
  8093 ->SetEnv&nbsp;--&nbsp;(docs incomplete)</DIV
       
  8094 +>SetEnv&nbsp;--&nbsp;Set environment variable</DIV
       
  8095  ><DIV
       
  8096  CLASS="REFSYNOPSISDIV"
       
  8097  ><A
       
  8098 @@ -23038,3443 +15191,6 @@
       
  8099  ></DIV
       
  8100  ><H1
       
  8101  ><A
       
  8102 -NAME="SQLAUTHENTICATE"
       
  8103 -></A
       
  8104 ->
       
  8105 -    SQLAuthenticate</H1
       
  8106 -><DIV
       
  8107 -CLASS="REFNAMEDIV"
       
  8108 -><A
       
  8109 -NAME="AEN8431"
       
  8110 -></A
       
  8111 -><H2
       
  8112 ->Name</H2
       
  8113 ->SQLAuthenticate&nbsp;--&nbsp;    Specify authentication methods and what to authenticate 
       
  8114 -  </DIV
       
  8115 -><DIV
       
  8116 -CLASS="REFSYNOPSISDIV"
       
  8117 -><A
       
  8118 -NAME="AEN8434"
       
  8119 -></A
       
  8120 -><H2
       
  8121 ->Synopsis</H2
       
  8122 -><P
       
  8123 -><B
       
  8124 -CLASS="COMMAND"
       
  8125 ->SQLAuthenticate</B
       
  8126 ->  {on | off}</P
       
  8127 -><P
       
  8128 ->&nbsp;&nbsp;or</P
       
  8129 -><P
       
  8130 -><B
       
  8131 -CLASS="COMMAND"
       
  8132 ->SQLAuthenticate</B
       
  8133 ->  [      users
       
  8134 -    ] [      groups
       
  8135 -    ] [      userset [fast]
       
  8136 -    ] [      groupset [fast]
       
  8137 -    ]</P
       
  8138 -><P
       
  8139 -></P
       
  8140 -><DIV
       
  8141 -CLASS="VARIABLELIST"
       
  8142 -><P
       
  8143 -><B
       
  8144 -></B
       
  8145 -></P
       
  8146 -><DL
       
  8147 -><DT
       
  8148 -><PRE
       
  8149 -CLASS="SYNOPSIS"
       
  8150 ->Default</PRE
       
  8151 -></DT
       
  8152 -><DD
       
  8153 -><P
       
  8154 ->          SQLAuthenticate <SAMP
       
  8155 -CLASS="COMPUTEROUTPUT"
       
  8156 ->on</SAMP
       
  8157 -> 
       
  8158 -        </P
       
  8159 -></DD
       
  8160 -><DT
       
  8161 -><PRE
       
  8162 -CLASS="SYNOPSIS"
       
  8163 ->Context</PRE
       
  8164 -></DT
       
  8165 -><DD
       
  8166 -><P
       
  8167 ->          server config, &lt;Global&gt;, &lt;VirtualHost&gt;
       
  8168 -        </P
       
  8169 -></DD
       
  8170 -><DT
       
  8171 -><PRE
       
  8172 -CLASS="SYNOPSIS"
       
  8173 ->Module</PRE
       
  8174 -></DT
       
  8175 -><DD
       
  8176 -><P
       
  8177 ->          mod_sql
       
  8178 -        </P
       
  8179 -></DD
       
  8180 -><DT
       
  8181 -><PRE
       
  8182 -CLASS="SYNOPSIS"
       
  8183 ->Compatibility</PRE
       
  8184 -></DT
       
  8185 -><DD
       
  8186 -><P
       
  8187 ->          1.2.5rc1 and later
       
  8188 -        </P
       
  8189 -></DD
       
  8190 -></DL
       
  8191 -></DIV
       
  8192 -></DIV
       
  8193 -><DIV
       
  8194 -CLASS="REFSECT1"
       
  8195 -><A
       
  8196 -NAME="AEN8472"
       
  8197 -></A
       
  8198 -><H2
       
  8199 ->Description</H2
       
  8200 -><P
       
  8201 ->The SQLAuthenticate directive configures mod_sql's authentication behavior,
       
  8202 -controlling whether to provide user and/or group information during
       
  8203 -authentication, and how that provisioning is performed. The parameters may
       
  8204 -appear in any order.</P
       
  8205 -><P
       
  8206 ->The available parameter values are:</P
       
  8207 -><P
       
  8208 -></P
       
  8209 -><UL
       
  8210 -><LI
       
  8211 -STYLE="list-style-type: disc"
       
  8212 -><P
       
  8213 -><SPAN
       
  8214 -CLASS="bold"
       
  8215 -><B
       
  8216 -CLASS="EMPHASIS"
       
  8217 ->on</B
       
  8218 -></SPAN
       
  8219 -></P
       
  8220 -><P
       
  8221 ->		Shorthand for SQLAuthenticate users groups userset groupset.
       
  8222 -	      </P
       
  8223 -></LI
       
  8224 -><LI
       
  8225 -STYLE="list-style-type: disc"
       
  8226 -><P
       
  8227 -><SPAN
       
  8228 -CLASS="bold"
       
  8229 -><B
       
  8230 -CLASS="EMPHASIS"
       
  8231 ->off</B
       
  8232 -></SPAN
       
  8233 -></P
       
  8234 -><P
       
  8235 ->		Disables all mod_sql authentication functions.
       
  8236 -	      </P
       
  8237 -></LI
       
  8238 -><LI
       
  8239 -STYLE="list-style-type: disc"
       
  8240 -><P
       
  8241 -><SPAN
       
  8242 -CLASS="bold"
       
  8243 -><B
       
  8244 -CLASS="EMPHASIS"
       
  8245 ->users</B
       
  8246 -></SPAN
       
  8247 -></P
       
  8248 -><P
       
  8249 ->		If present, mod_sql will do user lookups. If not present,
       
  8250 -		mod_sql will do no user lookups at all, including the
       
  8251 -		{set|get|end}pwent() calls (see below).
       
  8252 -	      </P
       
  8253 -></LI
       
  8254 -><LI
       
  8255 -STYLE="list-style-type: disc"
       
  8256 -><P
       
  8257 -><SPAN
       
  8258 -CLASS="bold"
       
  8259 -><B
       
  8260 -CLASS="EMPHASIS"
       
  8261 ->groups</B
       
  8262 -></SPAN
       
  8263 -></P
       
  8264 -><P
       
  8265 ->		If present, mod_sql will do group lookups. If not present,
       
  8266 -		mod_sql will do no group lookups at all, including the
       
  8267 -		{set|get|end}grent() calls (see below).
       
  8268 -	      </P
       
  8269 -></LI
       
  8270 -><LI
       
  8271 -STYLE="list-style-type: disc"
       
  8272 -><P
       
  8273 -><SPAN
       
  8274 -CLASS="bold"
       
  8275 -><B
       
  8276 -CLASS="EMPHASIS"
       
  8277 ->userset[fast]</B
       
  8278 -></SPAN
       
  8279 -></P
       
  8280 -><P
       
  8281 ->		If present, mod_sql will process the potentially expensive
       
  8282 -		{set|get|end}pwent() calls. If not present, mod_sql will
       
  8283 -		not process these calls. Adding the suffix "fast" tells
       
  8284 -		mod_sql to process the users as a single large query, rather
       
  8285 -		than making a query per user. This may significantly reduce
       
  8286 -		the number of queries against the database at the expense
       
  8287 -		of increased memory use. This parameter will have no effect
       
  8288 -		if "users" is not specified.
       
  8289 -	      </P
       
  8290 -></LI
       
  8291 -><LI
       
  8292 -STYLE="list-style-type: disc"
       
  8293 -><P
       
  8294 -><SPAN
       
  8295 -CLASS="bold"
       
  8296 -><B
       
  8297 -CLASS="EMPHASIS"
       
  8298 ->groupset[fast]</B
       
  8299 -></SPAN
       
  8300 -></P
       
  8301 -><P
       
  8302 ->		If present, mod_sql will process the potentially expensive
       
  8303 -		{set|get|end}grent() calls. If not present, mod_sql will
       
  8304 -		not process these calls. Adding the suffix "fast" tells
       
  8305 -		mod_sql to process the groups as a single large query, 
       
  8306 -		rather than making a query per group. This may significantly
       
  8307 -		reduce the number of queries against the database at the
       
  8308 -		expense of increased memory use. This parameter will have no
       
  8309 -		effect if "groups" is not specified.
       
  8310 -	      </P
       
  8311 -></LI
       
  8312 -></UL
       
  8313 -><P
       
  8314 ->The SQLLog and SQLShowInfo directives will always be processed by mod_sql.
       
  8315 -The SQLAuthenticate directive only affects the user and group
       
  8316 -lookup/authentication portions of the module.</P
       
  8317 -><P
       
  8318 ->Turning off (i.e. by not including) the userset or groupset parameters
       
  8319 -affects the functionality of mod_sql. Not allowing these lookups may remove
       
  8320 -the ability to control access or control functionality by group membership,
       
  8321 -depending on your other authentication handlers and the data available to
       
  8322 -them. At the same time, choosing not to do these lookups may dramatically
       
  8323 -speed login for many large sites.</P
       
  8324 -><P
       
  8325 ->The "fast" suffix is not appropriate for every site. Normally, mod_sql will
       
  8326 -retrieve a list of users and groups, and get information from the database
       
  8327 -on a per-user or per-group basis. This is query intensive: it requires
       
  8328 -(nn + 1) queries, where n is the number of users or groups to lookup. By 
       
  8329 -choosing "fast" lookups, mod_sql will make a single SELECT query to get
       
  8330 -information from the database.</P
       
  8331 -><P
       
  8332 ->In exchange for the radical reduction in the number of queries, the single
       
  8333 -query will increase the memory consumption of the process; all group or user
       
  8334 -information will be read at once rather than in discrete chunks.</P
       
  8335 -></DIV
       
  8336 -><DIV
       
  8337 -CLASS="REFSECT2"
       
  8338 -><A
       
  8339 -NAME="AEN8505"
       
  8340 -></A
       
  8341 -><H3
       
  8342 ->Group Table Structure</H3
       
  8343 -><P
       
  8344 ->Normally <SPAN
       
  8345 -CLASS="bold"
       
  8346 -><B
       
  8347 -CLASS="EMPHASIS"
       
  8348 ->mod_sql</B
       
  8349 -></SPAN
       
  8350 -> allows multiple group
       
  8351 -members per row, and multiple rows per group. If you use the "fast"
       
  8352 -option for groupset, you <SPAN
       
  8353 -CLASS="bold"
       
  8354 -><B
       
  8355 -CLASS="EMPHASIS"
       
  8356 ->must</B
       
  8357 -></SPAN
       
  8358 -> use only one
       
  8359 -row per group. For example, normally mod_sql treats the following three
       
  8360 -tables in exactly the same way:</P
       
  8361 -><P
       
  8362 -CLASS="LITERALLAYOUT"
       
  8363 ->|--------------------------------------------------|<br>
       
  8364 -|&nbsp;&nbsp;GROUPNAME&nbsp;&nbsp;|&nbsp;&nbsp;GID&nbsp;&nbsp;|&nbsp;&nbsp;MEMBERS&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8365 -|--------------------------------------------------|<br>
       
  8366 -|&nbsp;group1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;1000&nbsp;&nbsp;|&nbsp;naomi&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8367 -|&nbsp;group1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;1000&nbsp;&nbsp;|&nbsp;priscilla&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8368 -|&nbsp;group1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;1000&nbsp;&nbsp;|&nbsp;gertrude&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8369 -|--------------------------------------------------|<br>
       
  8370 -<br>
       
  8371 -|--------------------------------------------------|<br>
       
  8372 -|&nbsp;&nbsp;GROUPNAME&nbsp;&nbsp;|&nbsp;&nbsp;GID&nbsp;&nbsp;|&nbsp;&nbsp;MEMBERS&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8373 -|--------------------------------------------------|<br>
       
  8374 -|&nbsp;group1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;1000&nbsp;&nbsp;|&nbsp;naomi,&nbsp;priscilla&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8375 -|&nbsp;group1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;1000&nbsp;&nbsp;|&nbsp;gertrude&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8376 -|--------------------------------------------------|<br>
       
  8377 -<br>
       
  8378 -|--------------------------------------------------|<br>
       
  8379 -|&nbsp;&nbsp;GROUPNAME&nbsp;&nbsp;|&nbsp;&nbsp;GID&nbsp;&nbsp;|&nbsp;&nbsp;MEMBERS&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br>
       
  8380 -|--------------------------------------------------|<br>
       
  8381 -|&nbsp;group1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;1000&nbsp;&nbsp;|&nbsp;naomi,&nbsp;priscilla,&nbsp;gertrude&nbsp;|<br>
       
  8382 -|--------------------------------------------------|</P
       
  8383 -><P
       
  8384 ->If you use the "fast" option, mod_sql assumes that all entries are 
       
  8385 -structured like the last example.</P
       
  8386 -></DIV
       
  8387 -><DIV
       
  8388 -CLASS="REFSECT1"
       
  8389 -><A
       
  8390 -NAME="AEN8512"
       
  8391 -></A
       
  8392 -><H2
       
  8393 ->See also</H2
       
  8394 -><P
       
  8395 ->      <A
       
  8396 -HREF="#SQLUSERINFO"
       
  8397 ->SQLUserInfo</A
       
  8398 -> 
       
  8399 -      <A
       
  8400 -HREF="#SQLGROUPINFO"
       
  8401 ->SQLGroupInfo</A
       
  8402 ->
       
  8403 -    </P
       
  8404 -></DIV
       
  8405 -><DIV
       
  8406 -CLASS="REFSECT1"
       
  8407 -><A
       
  8408 -NAME="AEN8517"
       
  8409 -></A
       
  8410 -><H2
       
  8411 ->Examples</H2
       
  8412 -></DIV
       
  8413 -><H1
       
  8414 -><A
       
  8415 -NAME="SQLAUTHTYPES"
       
  8416 -></A
       
  8417 ->
       
  8418 -SQLAuthTypes</H1
       
  8419 -><DIV
       
  8420 -CLASS="REFNAMEDIV"
       
  8421 -><A
       
  8422 -NAME="AEN8527"
       
  8423 -></A
       
  8424 -><H2
       
  8425 ->Name</H2
       
  8426 ->SQLAuthTypes&nbsp;--&nbsp;Specify the allowed authentication types and their check order</DIV
       
  8427 -><DIV
       
  8428 -CLASS="REFSYNOPSISDIV"
       
  8429 -><A
       
  8430 -NAME="AEN8530"
       
  8431 -></A
       
  8432 -><H2
       
  8433 ->Synopsis</H2
       
  8434 -><P
       
  8435 -><B
       
  8436 -CLASS="COMMAND"
       
  8437 ->SQLAuthTypes</B
       
  8438 ->  [  <CODE
       
  8439 -CLASS="OPTION"
       
  8440 ->[OpenSSL]</CODE
       
  8441 ->] [  <CODE
       
  8442 -CLASS="OPTION"
       
  8443 ->[Crypt]</CODE
       
  8444 ->] [  <CODE
       
  8445 -CLASS="OPTION"
       
  8446 ->[Backend]</CODE
       
  8447 ->] [  <CODE
       
  8448 -CLASS="OPTION"
       
  8449 ->[Plaintext]</CODE
       
  8450 ->] [  <CODE
       
  8451 -CLASS="OPTION"
       
  8452 ->[Empty]</CODE
       
  8453 ->]</P
       
  8454 -><P
       
  8455 -></P
       
  8456 -><DIV
       
  8457 -CLASS="VARIABLELIST"
       
  8458 -><P
       
  8459 -><B
       
  8460 -></B
       
  8461 -></P
       
  8462 -><DL
       
  8463 -><DT
       
  8464 -><PRE
       
  8465 -CLASS="SYNOPSIS"
       
  8466 ->Default</PRE
       
  8467 -></DT
       
  8468 -><DD
       
  8469 -><P
       
  8470 ->none</P
       
  8471 -></DD
       
  8472 -><DT
       
  8473 -><PRE
       
  8474 -CLASS="SYNOPSIS"
       
  8475 ->Context</PRE
       
  8476 -></DT
       
  8477 -><DD
       
  8478 -><P
       
  8479 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  8480 -></DD
       
  8481 -><DT
       
  8482 -><PRE
       
  8483 -CLASS="SYNOPSIS"
       
  8484 ->Module</PRE
       
  8485 -></DT
       
  8486 -><DD
       
  8487 -><P
       
  8488 ->mod_sql</P
       
  8489 -></DD
       
  8490 -><DT
       
  8491 -><PRE
       
  8492 -CLASS="SYNOPSIS"
       
  8493 ->Compatibility</PRE
       
  8494 -></DT
       
  8495 -><DD
       
  8496 -><P
       
  8497 ->1.2.0 and later</P
       
  8498 -></DD
       
  8499 -></DL
       
  8500 -></DIV
       
  8501 -></DIV
       
  8502 -><DIV
       
  8503 -CLASS="REFSECT1"
       
  8504 -><A
       
  8505 -NAME="AEN8565"
       
  8506 -></A
       
  8507 -><H2
       
  8508 ->Description</H2
       
  8509 -><P
       
  8510 ->This directive deprecates 'SQLEmptyPasswords',
       
  8511 -'SQLScrambledPasswords', 'SQLSSLHashedPasswords',
       
  8512 -'SQLPlaintextPasswords', and 'SQLEncryptedPasswords'.</P
       
  8513 -><P
       
  8514 ->The SQLAuthTypes directive specifies which authentication method
       
  8515 -are to be allowed, and their order of use.
       
  8516 -<SPAN
       
  8517 -CLASS="bold"
       
  8518 -><B
       
  8519 -CLASS="EMPHASIS"
       
  8520 ->You must specify at least one authentication
       
  8521 -method.</B
       
  8522 -></SPAN
       
  8523 -></P
       
  8524 -><P
       
  8525 ->The current supported authentication methods are:</P
       
  8526 -><P
       
  8527 -></P
       
  8528 -><UL
       
  8529 -><LI
       
  8530 -STYLE="list-style-type: disc"
       
  8531 -><P
       
  8532 -><SPAN
       
  8533 -CLASS="bold"
       
  8534 -><B
       
  8535 -CLASS="EMPHASIS"
       
  8536 ->Backend</B
       
  8537 -></SPAN
       
  8538 -></P
       
  8539 -><P
       
  8540 ->		Allows database-specific backend passwords. Not all
       
  8541 -		backend databases support this option. For example,
       
  8542 -		MySQL datatabases use this option to authenticate MySQL
       
  8543 -		'PASSWORD()' encrypted passwords. The Postgres backend,
       
  8544 -		however, does nothing.<SPAN
       
  8545 -CLASS="bold"
       
  8546 -><B
       
  8547 -CLASS="EMPHASIS"
       
  8548 ->Caveat
       
  8549 -		</B
       
  8550 -></SPAN
       
  8551 ->: if your MySQL activity log is world-readable,
       
  8552 -		the user password <SPAN
       
  8553 -CLASS="bold"
       
  8554 -><B
       
  8555 -CLASS="EMPHASIS"
       
  8556 ->will be visible
       
  8557 -		</B
       
  8558 -></SPAN
       
  8559 ->. You have been warned.
       
  8560 -              </P
       
  8561 -></LI
       
  8562 -><LI
       
  8563 -STYLE="list-style-type: disc"
       
  8564 -><P
       
  8565 -><SPAN
       
  8566 -CLASS="bold"
       
  8567 -><B
       
  8568 -CLASS="EMPHASIS"
       
  8569 ->Crypt</B
       
  8570 -></SPAN
       
  8571 -></P
       
  8572 -><P
       
  8573 ->		Allows passwords in the database to be of Unix crypt(3) form.
       
  8574 -              </P
       
  8575 -></LI
       
  8576 -><LI
       
  8577 -STYLE="list-style-type: disc"
       
  8578 -><P
       
  8579 -><SPAN
       
  8580 -CLASS="bold"
       
  8581 -><B
       
  8582 -CLASS="EMPHASIS"
       
  8583 ->Empty</B
       
  8584 -></SPAN
       
  8585 -></P
       
  8586 -><P
       
  8587 ->		Allows empty passwords in the database, which match
       
  8588 -		against <SPAN
       
  8589 -CLASS="bold"
       
  8590 -><B
       
  8591 -CLASS="EMPHASIS"
       
  8592 ->any</B
       
  8593 -></SPAN
       
  8594 -> password
       
  8595 -		the user may give. The database field must be a truly
       
  8596 -		empty string; NULL values are not acceptable as empty
       
  8597 -		passwords. <SPAN
       
  8598 -CLASS="bold"
       
  8599 -><B
       
  8600 -CLASS="EMPHASIS"
       
  8601 ->Be very careful if using
       
  8602 -		this authentication method.</B
       
  8603 -></SPAN
       
  8604 ->
       
  8605 -              </P
       
  8606 -></LI
       
  8607 -><LI
       
  8608 -STYLE="list-style-type: disc"
       
  8609 -><P
       
  8610 -><SPAN
       
  8611 -CLASS="bold"
       
  8612 -><B
       
  8613 -CLASS="EMPHASIS"
       
  8614 ->OpenSSL</B
       
  8615 -></SPAN
       
  8616 -></P
       
  8617 -><P
       
  8618 ->		Allows passwords in the database to be of the form
       
  8619 -		'{digest-name}hashed-value', where hashed-value
       
  8620 -		is the base64-encoded digest of the passsword.
       
  8621 -		Only available if you define HAVE_OPENSSL when you
       
  8622 -		compile proftpd  and you link with OpenSSL's libcrypto
       
  8623 -		library.
       
  8624 -              </P
       
  8625 -></LI
       
  8626 -><LI
       
  8627 -STYLE="list-style-type: disc"
       
  8628 -><P
       
  8629 -><SPAN
       
  8630 -CLASS="bold"
       
  8631 -><B
       
  8632 -CLASS="EMPHASIS"
       
  8633 ->Plaintext</B
       
  8634 -></SPAN
       
  8635 -></P
       
  8636 -><P
       
  8637 ->		Allows passwords in the database to be in plaintext.
       
  8638 -              </P
       
  8639 -></LI
       
  8640 -></UL
       
  8641 -></DIV
       
  8642 -><DIV
       
  8643 -CLASS="REFSECT1"
       
  8644 -><A
       
  8645 -NAME="AEN8596"
       
  8646 -></A
       
  8647 -><H2
       
  8648 ->See also</H2
       
  8649 -><P
       
  8650 -></P
       
  8651 -></DIV
       
  8652 -><DIV
       
  8653 -CLASS="REFSECT1"
       
  8654 -><A
       
  8655 -NAME="AEN8599"
       
  8656 -></A
       
  8657 -><H2
       
  8658 ->Examples</H2
       
  8659 -><P
       
  8660 -CLASS="LITERALLAYOUT"
       
  8661 ->	SQLAuthTypes&nbsp;Crypt&nbsp;Empty</P
       
  8662 -><P
       
  8663 ->configures mod_sql to first attempt to verify the password using the
       
  8664 -Unix crypt(3) function, then, if that fails, determine if the password
       
  8665 -in the database is empty (thus matching any given password). If all of
       
  8666 -the configured authentication methods fail, mod_sql will fail to
       
  8667 -authenticate the user.</P
       
  8668 -></DIV
       
  8669 -><H1
       
  8670 -><A
       
  8671 -NAME="SQLBACKEND"
       
  8672 -></A
       
  8673 ->
       
  8674 -SQLBackend</H1
       
  8675 -><DIV
       
  8676 -CLASS="REFNAMEDIV"
       
  8677 -><A
       
  8678 -NAME="AEN8611"
       
  8679 -></A
       
  8680 -><H2
       
  8681 ->Name</H2
       
  8682 ->SQLBackend&nbsp;--&nbsp;Set the SQL backend module</DIV
       
  8683 -><DIV
       
  8684 -CLASS="REFSYNOPSISDIV"
       
  8685 -><A
       
  8686 -NAME="AEN8614"
       
  8687 -></A
       
  8688 -><H2
       
  8689 ->Synopsis</H2
       
  8690 -><P
       
  8691 -><B
       
  8692 -CLASS="COMMAND"
       
  8693 ->SQLBackend</B
       
  8694 ->  [  <CODE
       
  8695 -CLASS="OPTION"
       
  8696 ->backend</CODE
       
  8697 ->]</P
       
  8698 -><P
       
  8699 -></P
       
  8700 -><DIV
       
  8701 -CLASS="VARIABLELIST"
       
  8702 -><P
       
  8703 -><B
       
  8704 -></B
       
  8705 -></P
       
  8706 -><DL
       
  8707 -><DT
       
  8708 -><PRE
       
  8709 -CLASS="SYNOPSIS"
       
  8710 ->Default</PRE
       
  8711 -></DT
       
  8712 -><DD
       
  8713 -><P
       
  8714 ->Depends</P
       
  8715 -></DD
       
  8716 -><DT
       
  8717 -><PRE
       
  8718 -CLASS="SYNOPSIS"
       
  8719 ->Context</PRE
       
  8720 -></DT
       
  8721 -><DD
       
  8722 -><P
       
  8723 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  8724 -></DD
       
  8725 -><DT
       
  8726 -><PRE
       
  8727 -CLASS="SYNOPSIS"
       
  8728 ->Module</PRE
       
  8729 -></DT
       
  8730 -><DD
       
  8731 -><P
       
  8732 ->mod_sql</P
       
  8733 -></DD
       
  8734 -><DT
       
  8735 -><PRE
       
  8736 -CLASS="SYNOPSIS"
       
  8737 ->Compatibility</PRE
       
  8738 -></DT
       
  8739 -><DD
       
  8740 -><P
       
  8741 ->1.3.0rc1 and later</P
       
  8742 -></DD
       
  8743 -></DL
       
  8744 -></DIV
       
  8745 -></DIV
       
  8746 -><DIV
       
  8747 -CLASS="REFSECT1"
       
  8748 -><A
       
  8749 -NAME="AEN8641"
       
  8750 -></A
       
  8751 -><H2
       
  8752 ->Description</H2
       
  8753 -><P
       
  8754 ->In 1.3.0rc1, the mod_sql module gained the ability to be compiled with multiple
       
  8755 -backend modules supported, e.g. to have both mod_sql_mysql and mod_sql_postgres
       
  8756 -usable in the same proftpd daemon. The SQLBackend directive configures which of
       
  8757 -these different database backends should be used.</P
       
  8758 -><P
       
  8759 ->If there is only one backend module compiled in, the SQLBackend directive is not
       
  8760 -needed. If there are multiple backend modules compiled and no SQLBackend directive
       
  8761 -is specified, then mod_sql will default to using the first backend module listed.
       
  8762 -For instance, if you configured proftpd using a configure command such as:
       
  8763 -
       
  8764 -  ./configure --with-modules=mod_sql:mod_sql_postgres:mod_sql_mysql ...
       
  8765 -
       
  8766 -then mod_sql would default to using mod_sql_postgres as the backend module to use.</P
       
  8767 -><P
       
  8768 ->You might have multiple &lt;VirtualHost&gt; sections which use different SQL backends.
       
  8769 -Use "mysql" for the mod_sql_mysql module, and "postgres" for the mod_sql_postgres
       
  8770 -module.</P
       
  8771 -></DIV
       
  8772 -><DIV
       
  8773 -CLASS="REFSECT1"
       
  8774 -><A
       
  8775 -NAME="AEN8646"
       
  8776 -></A
       
  8777 -><H2
       
  8778 ->See also</H2
       
  8779 -><P
       
  8780 -></P
       
  8781 -></DIV
       
  8782 -><DIV
       
  8783 -CLASS="REFSECT1"
       
  8784 -><A
       
  8785 -NAME="AEN8649"
       
  8786 -></A
       
  8787 -><H2
       
  8788 ->Examples</H2
       
  8789 -><P
       
  8790 -CLASS="LITERALLAYOUT"
       
  8791 ->&nbsp;&nbsp;&lt;VirtualHost&nbsp;1.2.3.4&gt;<br>
       
  8792 -&nbsp;&nbsp;&nbsp;&nbsp;SQLBackend&nbsp;mysql<br>
       
  8793 -&nbsp;&nbsp;&nbsp;&nbsp;...<br>
       
  8794 -&nbsp;&nbsp;&lt;/VirtualHost&gt;<br>
       
  8795 -<br>
       
  8796 -&nbsp;&nbsp;&lt;VirtualHost&nbsp;5.6.7.8&gt;<br>
       
  8797 -&nbsp;&nbsp;&nbsp;&nbsp;SQLBackend&nbsp;postgres<br>
       
  8798 -&nbsp;&nbsp;&nbsp;&nbsp;...<br>
       
  8799 -&nbsp;&nbsp;&lt;/VirtualHost&gt;</P
       
  8800 -></DIV
       
  8801 -><H1
       
  8802 -><A
       
  8803 -NAME="SQLCONNECTINFO"
       
  8804 -></A
       
  8805 ->
       
  8806 -SQLConnectInfo</H1
       
  8807 -><DIV
       
  8808 -CLASS="REFNAMEDIV"
       
  8809 -><A
       
  8810 -NAME="AEN8660"
       
  8811 -></A
       
  8812 -><H2
       
  8813 ->Name</H2
       
  8814 ->SQLConnectInfo&nbsp;--&nbsp;Specify connection information for the backend</DIV
       
  8815 -><DIV
       
  8816 -CLASS="REFSYNOPSISDIV"
       
  8817 -><A
       
  8818 -NAME="AEN8663"
       
  8819 -></A
       
  8820 -><H2
       
  8821 ->Synopsis</H2
       
  8822 -><P
       
  8823 -><B
       
  8824 -CLASS="COMMAND"
       
  8825 ->SQLConnectInfo</B
       
  8826 ->  [  <CODE
       
  8827 -CLASS="OPTION"
       
  8828 ->connection-info</CODE
       
  8829 ->] [  <CODE
       
  8830 -CLASS="OPTION"
       
  8831 ->[username]</CODE
       
  8832 ->] [  <CODE
       
  8833 -CLASS="OPTION"
       
  8834 ->[password]</CODE
       
  8835 ->] [  <CODE
       
  8836 -CLASS="OPTION"
       
  8837 ->[policy]</CODE
       
  8838 ->]</P
       
  8839 -><P
       
  8840 -></P
       
  8841 -><DIV
       
  8842 -CLASS="VARIABLELIST"
       
  8843 -><P
       
  8844 -><B
       
  8845 -></B
       
  8846 -></P
       
  8847 -><DL
       
  8848 -><DT
       
  8849 -><PRE
       
  8850 -CLASS="SYNOPSIS"
       
  8851 ->Default</PRE
       
  8852 -></DT
       
  8853 -><DD
       
  8854 -><P
       
  8855 ->None</P
       
  8856 -></DD
       
  8857 -><DT
       
  8858 -><PRE
       
  8859 -CLASS="SYNOPSIS"
       
  8860 ->Context</PRE
       
  8861 -></DT
       
  8862 -><DD
       
  8863 -><P
       
  8864 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  8865 -></DD
       
  8866 -><DT
       
  8867 -><PRE
       
  8868 -CLASS="SYNOPSIS"
       
  8869 ->Module</PRE
       
  8870 -></DT
       
  8871 -><DD
       
  8872 -><P
       
  8873 ->mod_sql</P
       
  8874 -></DD
       
  8875 -><DT
       
  8876 -><PRE
       
  8877 -CLASS="SYNOPSIS"
       
  8878 ->Compatibility</PRE
       
  8879 -></DT
       
  8880 -><DD
       
  8881 -><P
       
  8882 ->1.2.0 and later</P
       
  8883 -></DD
       
  8884 -></DL
       
  8885 -></DIV
       
  8886 -></DIV
       
  8887 -><DIV
       
  8888 -CLASS="REFSECT1"
       
  8889 -><A
       
  8890 -NAME="AEN8696"
       
  8891 -></A
       
  8892 -><H2
       
  8893 ->Description</H2
       
  8894 -><P
       
  8895 ->This directive deprecates 'MySQLInfo', 'PostgresInfo', and
       
  8896 -'PostgresPort'.</P
       
  8897 -><P
       
  8898 ->The SQLConnectInfo directive configures the information necessary to
       
  8899 -connect to the backend database. The connection-info parameter specifies
       
  8900 -the database, host, port, and other backend-specific information. The
       
  8901 -optional username and password parameters specify a username and password
       
  8902 -to use when connecting to the database. Both default to NULL, which the
       
  8903 -backend will treat in some backend-specific manner. If you specify a
       
  8904 -password, you <SPAN
       
  8905 -CLASS="bold"
       
  8906 -><B
       
  8907 -CLASS="EMPHASIS"
       
  8908 ->must</B
       
  8909 -></SPAN
       
  8910 -> specify a username.
       
  8911 -If no SQLConnectInfo directive is specified, mod_sql will disable itself.</P
       
  8912 -><P
       
  8913 ->Any given database backend has the opportunity, though not necessarily
       
  8914 -the responsibility, to check for syntax errors in the connection-info
       
  8915 -field at server startup, but you should not expect semantic errors
       
  8916 -(i.e., cannot connect to the database) to be caught until mod_sql 
       
  8917 -attempts to connect for a given host.</P
       
  8918 -><P
       
  8919 ->A given database connection is governed by a connection policy that
       
  8920 -specifies when a connection should be opened and when it should be
       
  8921 -closed. There are three options:</P
       
  8922 -><P
       
  8923 -></P
       
  8924 -><UL
       
  8925 -><LI
       
  8926 -STYLE="list-style-type: disc"
       
  8927 -><P
       
  8928 -><SPAN
       
  8929 -CLASS="bold"
       
  8930 -><B
       
  8931 -CLASS="EMPHASIS"
       
  8932 ->PERSESSION</B
       
  8933 -></SPAN
       
  8934 -></P
       
  8935 -><P
       
  8936 ->		Open a database connection at the start of the session
       
  8937 -		and close the database connection at the end of the session.
       
  8938 -              </P
       
  8939 -></LI
       
  8940 -><LI
       
  8941 -STYLE="list-style-type: disc"
       
  8942 -><P
       
  8943 ->number (<SPAN
       
  8944 -CLASS="bold"
       
  8945 -><B
       
  8946 -CLASS="EMPHASIS"
       
  8947 ->TIMED</B
       
  8948 -></SPAN
       
  8949 ->)</P
       
  8950 -><P
       
  8951 ->		Timed database connections that close themselves
       
  8952 -		after number seconds of inactivity.
       
  8953 -              </P
       
  8954 -></LI
       
  8955 -></UL
       
  8956 -><P
       
  8957 ->If a connection policy is not specified, if the policy is not a number or
       
  8958 -is a number less than 1, or if the policy is the string "PERSESSION",
       
  8959 -the PERSESSION policy will be used.</P
       
  8960 -><P
       
  8961 ->If the connection policy is any number greater than 0, it specifies the
       
  8962 -number of seconds that a connection will be held open without activity.
       
  8963 -After that many seconds of database inactivity, the connection to the
       
  8964 -database will be closed. As soon as database activity starts again,
       
  8965 -the connection will be opened and the timer will restart.</P
       
  8966 -><P
       
  8967 ->The MySQL and Postgres backends' connection-info is expected to be of the form:</P
       
  8968 -><P
       
  8969 ->database[@hostname][:port]</P
       
  8970 -><P
       
  8971 ->hostname will default to a backend-specific hostname (which happens to be
       
  8972 -'localhost' for both the MySQL and Postgres backends), and port will default
       
  8973 -to a backend-specific default port (3306 for the MySQL backend, 5432 for
       
  8974 -the Postgres backend).</P
       
  8975 -><P
       
  8976 ->From the MySQL documentation:</P
       
  8977 -><P
       
  8978 ->the value of host may be either a hostname or an IP address. If host is
       
  8979 -NULL or the string "localhost", a connection to the local host is assumed.
       
  8980 -If the OS supports sockets (Unix) or named pipes (Windows), they are used
       
  8981 -instead of TCP/IP to connect to the server.</P
       
  8982 -><P
       
  8983 ->From the PostgreSQL documentation:</P
       
  8984 -><P
       
  8985 ->If [the hostname] begins with a slash, it specifies Unix-domain
       
  8986 -communication rather than TCP/IP communication; the value is the
       
  8987 -name of the directory in which the socket file is stored. The default
       
  8988 -is to connect to a Unix-domain socket in /tmp.</P
       
  8989 -><P
       
  8990 ->If you plan to use the TIMED connection policy, consider the effect of
       
  8991 -directives such as DefaultRoot on local socket communication: once a user
       
  8992 -has been chroot()ed, the local socket file will probably not be available
       
  8993 -within the chroot directory tree, and attempts to reopen communication will
       
  8994 -fail. One way around this may be to use hardlinks within the user's
       
  8995 -directory tree. PERSESSION connections are not affected by this because
       
  8996 -the database will be opened prior to the chroot() call, and held open
       
  8997 -for the life of the session. Network communications are not affected by
       
  8998 -this problem. For example, while localhost would not work for MySQL since
       
  8999 -the MySQL client library will try to use socket communications for that
       
  9000 -host, 127.0.0.1 will work (as long as your database is setup to accept
       
  9001 -these connections).</P
       
  9002 -></DIV
       
  9003 -><DIV
       
  9004 -CLASS="REFSECT1"
       
  9005 -><A
       
  9006 -NAME="AEN8722"
       
  9007 -></A
       
  9008 -><H2
       
  9009 ->See also</H2
       
  9010 -><P
       
  9011 -></P
       
  9012 -></DIV
       
  9013 -><DIV
       
  9014 -CLASS="REFSECT1"
       
  9015 -><A
       
  9016 -NAME="AEN8725"
       
  9017 -></A
       
  9018 -><H2
       
  9019 ->Examples</H2
       
  9020 -><P
       
  9021 -CLASS="LITERALLAYOUT"
       
  9022 ->&nbsp;&nbsp;#&nbsp;Connect&nbsp;to&nbsp;the&nbsp;database&nbsp;'ftpusers'&nbsp;via&nbsp;the&nbsp;default&nbsp;port&nbsp;at&nbsp;host<br>
       
  9023 -&nbsp;&nbsp;#&nbsp;'foo.com'.&nbsp;&nbsp;Use&nbsp;a&nbsp;NULL&nbsp;username&nbsp;and&nbsp;NULL&nbsp;password&nbsp;when&nbsp;connecting.<br>
       
  9024 -&nbsp;&nbsp;#&nbsp;A&nbsp;connection&nbsp;policy&nbsp;of&nbsp;PERSESSION&nbsp;is&nbsp;used.<br>
       
  9025 -&nbsp;&nbsp;SQLConnectInfo&nbsp;[email protected]<br>
       
  9026 -<br>
       
  9027 -&nbsp;&nbsp;#&nbsp;Connect&nbsp;to&nbsp;the&nbsp;database&nbsp;'ftpusers'&nbsp;via&nbsp;port&nbsp;3000&nbsp;at&nbsp;host&nbsp;'localhost'.<br>
       
  9028 -&nbsp;&nbsp;#&nbsp;Use&nbsp;the&nbsp;username&nbsp;'admin'&nbsp;and&nbsp;a&nbsp;NULL&nbsp;password&nbsp;when&nbsp;connecting.<br>
       
  9029 -&nbsp;&nbsp;#&nbsp;A&nbsp;connection&nbsp;policy&nbsp;of&nbsp;PERSESSION&nbsp;is&nbsp;used.<br>
       
  9030 -&nbsp;&nbsp;SQLConnectInfo&nbsp;ftpusers:3000&nbsp;admin<br>
       
  9031 -<br>
       
  9032 -&nbsp;&nbsp;#&nbsp;Connect&nbsp;to&nbsp;the&nbsp;database&nbsp;'ftpusers'&nbsp;via&nbsp;port&nbsp;3000&nbsp;at&nbsp;host&nbsp;'foo.com'.<br>
       
  9033 -&nbsp;&nbsp;#&nbsp;Use&nbsp;the&nbsp;username&nbsp;'admin'&nbsp;and&nbsp;password&nbsp;'mypassword'&nbsp;when&nbsp;connecting.<br>
       
  9034 -&nbsp;&nbsp;#&nbsp;A&nbsp;connection&nbsp;policy&nbsp;of&nbsp;PERSESSION&nbsp;is&nbsp;used.<br>
       
  9035 -&nbsp;&nbsp;SQLConnectInfo&nbsp;[email protected]:3000&nbsp;admin&nbsp;mypassword<br>
       
  9036 -<br>
       
  9037 -&nbsp;&nbsp;#&nbsp;Connect&nbsp;to&nbsp;the&nbsp;database&nbsp;'ftpusers'&nbsp;via&nbsp;port&nbsp;3000&nbsp;at&nbsp;host&nbsp;'foo.com'.<br>
       
  9038 -&nbsp;&nbsp;#&nbsp;Use&nbsp;a&nbsp;username&nbsp;of&nbsp;'admin'&nbsp;and&nbsp;a&nbsp;password&nbsp;of&nbsp;'mypassword'&nbsp;when<br>
       
  9039 -&nbsp;&nbsp;#&nbsp;connecting.&nbsp;&nbsp;A&nbsp;30&nbsp;second&nbsp;timer&nbsp;of&nbsp;connection&nbsp;inactivity&nbsp;is&nbsp;activated.<br>
       
  9040 -&nbsp;&nbsp;SQLConnectInfo&nbsp;[email protected]:3000&nbsp;admin&nbsp;mypassword&nbsp;30</P
       
  9041 -><P
       
  9042 ->Backends may require different information in the connection-info field;
       
  9043 -check your backend module for more detailed information.</P
       
  9044 -></DIV
       
  9045 -><H1
       
  9046 -><A
       
  9047 -NAME="SQLDEFAULTGID"
       
  9048 -></A
       
  9049 ->
       
  9050 -SQLDefaultGID</H1
       
  9051 -><DIV
       
  9052 -CLASS="REFNAMEDIV"
       
  9053 -><A
       
  9054 -NAME="AEN8737"
       
  9055 -></A
       
  9056 -><H2
       
  9057 ->Name</H2
       
  9058 ->SQLDefaultGID&nbsp;--&nbsp;Configure the default GID for users</DIV
       
  9059 -><DIV
       
  9060 -CLASS="REFSYNOPSISDIV"
       
  9061 -><A
       
  9062 -NAME="AEN8740"
       
  9063 -></A
       
  9064 -><H2
       
  9065 ->Synopsis</H2
       
  9066 -><P
       
  9067 -><B
       
  9068 -CLASS="COMMAND"
       
  9069 ->SQLDefaultGID</B
       
  9070 ->  [  <CODE
       
  9071 -CLASS="OPTION"
       
  9072 ->defaultgid</CODE
       
  9073 ->]</P
       
  9074 -><P
       
  9075 -></P
       
  9076 -><DIV
       
  9077 -CLASS="VARIABLELIST"
       
  9078 -><P
       
  9079 -><B
       
  9080 -></B
       
  9081 -></P
       
  9082 -><DL
       
  9083 -><DT
       
  9084 -><PRE
       
  9085 -CLASS="SYNOPSIS"
       
  9086 ->Default</PRE
       
  9087 -></DT
       
  9088 -><DD
       
  9089 -><P
       
  9090 ->65533</P
       
  9091 -></DD
       
  9092 -><DT
       
  9093 -><PRE
       
  9094 -CLASS="SYNOPSIS"
       
  9095 ->Context</PRE
       
  9096 -></DT
       
  9097 -><DD
       
  9098 -><P
       
  9099 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9100 -></DD
       
  9101 -><DT
       
  9102 -><PRE
       
  9103 -CLASS="SYNOPSIS"
       
  9104 ->Module</PRE
       
  9105 -></DT
       
  9106 -><DD
       
  9107 -><P
       
  9108 ->mod_sql</P
       
  9109 -></DD
       
  9110 -><DT
       
  9111 -><PRE
       
  9112 -CLASS="SYNOPSIS"
       
  9113 ->Compatibility</PRE
       
  9114 -></DT
       
  9115 -><DD
       
  9116 -><P
       
  9117 ->1.2.0 and later</P
       
  9118 -></DD
       
  9119 -></DL
       
  9120 -></DIV
       
  9121 -></DIV
       
  9122 -><DIV
       
  9123 -CLASS="REFSECT1"
       
  9124 -><A
       
  9125 -NAME="AEN8767"
       
  9126 -></A
       
  9127 -><H2
       
  9128 ->Description</H2
       
  9129 -><P
       
  9130 ->Sets the default GID for users.  Must be greater than SQLMinID.</P
       
  9131 -></DIV
       
  9132 -><DIV
       
  9133 -CLASS="REFSECT1"
       
  9134 -><A
       
  9135 -NAME="AEN8770"
       
  9136 -></A
       
  9137 -><H2
       
  9138 ->See also</H2
       
  9139 -><P
       
  9140 -><A
       
  9141 -HREF="#SQLMINID"
       
  9142 ->SQLMinID</A
       
  9143 ->
       
  9144 -<A
       
  9145 -HREF="#SQLMINUSERGID"
       
  9146 ->SQLMinUserGID</A
       
  9147 -></P
       
  9148 -></DIV
       
  9149 -><H1
       
  9150 -><A
       
  9151 -NAME="SQLDEFAULTHOMEDIR"
       
  9152 -></A
       
  9153 ->
       
  9154 -SQLDefaultHomedir</H1
       
  9155 -><DIV
       
  9156 -CLASS="REFNAMEDIV"
       
  9157 -><A
       
  9158 -NAME="AEN8783"
       
  9159 -></A
       
  9160 -><H2
       
  9161 ->Name</H2
       
  9162 ->SQLDefaultHomedir&nbsp;--&nbsp;Configure the default homedir</DIV
       
  9163 -><DIV
       
  9164 -CLASS="REFSYNOPSISDIV"
       
  9165 -><A
       
  9166 -NAME="AEN8786"
       
  9167 -></A
       
  9168 -><H2
       
  9169 ->Synopsis</H2
       
  9170 -><P
       
  9171 -><B
       
  9172 -CLASS="COMMAND"
       
  9173 ->SQLDefaultHomedir</B
       
  9174 ->  [  <CODE
       
  9175 -CLASS="OPTION"
       
  9176 ->path</CODE
       
  9177 ->]</P
       
  9178 -><P
       
  9179 -></P
       
  9180 -><DIV
       
  9181 -CLASS="VARIABLELIST"
       
  9182 -><P
       
  9183 -><B
       
  9184 -></B
       
  9185 -></P
       
  9186 -><DL
       
  9187 -><DT
       
  9188 -><PRE
       
  9189 -CLASS="SYNOPSIS"
       
  9190 ->Default</PRE
       
  9191 -></DT
       
  9192 -><DD
       
  9193 -><P
       
  9194 ->None</P
       
  9195 -></DD
       
  9196 -><DT
       
  9197 -><PRE
       
  9198 -CLASS="SYNOPSIS"
       
  9199 ->Context</PRE
       
  9200 -></DT
       
  9201 -><DD
       
  9202 -><P
       
  9203 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9204 -></DD
       
  9205 -><DT
       
  9206 -><PRE
       
  9207 -CLASS="SYNOPSIS"
       
  9208 ->Module</PRE
       
  9209 -></DT
       
  9210 -><DD
       
  9211 -><P
       
  9212 ->mod_sql</P
       
  9213 -></DD
       
  9214 -><DT
       
  9215 -><PRE
       
  9216 -CLASS="SYNOPSIS"
       
  9217 ->Compatibility</PRE
       
  9218 -></DT
       
  9219 -><DD
       
  9220 -><P
       
  9221 ->1.2.5rc1 and later</P
       
  9222 -></DD
       
  9223 -></DL
       
  9224 -></DIV
       
  9225 -></DIV
       
  9226 -><DIV
       
  9227 -CLASS="REFSECT1"
       
  9228 -><A
       
  9229 -NAME="AEN8813"
       
  9230 -></A
       
  9231 -><H2
       
  9232 ->Description</H2
       
  9233 -><P
       
  9234 ->The SQLDefaultHomedir directive configures a default home directory for all
       
  9235 -users authenticated with this module, overriding any (deprecated)
       
  9236 -SQLHomedirField directive. If no home directory is set with either directive,
       
  9237 -authentication fails. This directive does not change the data retrieved from
       
  9238 -the database: if you specify a home directory field to SQLUserInfo, that
       
  9239 -field's data will be returned as the user's home directory, whether that
       
  9240 -data is a legal directory, or an empty string, or NULL.</P
       
  9241 -></DIV
       
  9242 -><DIV
       
  9243 -CLASS="REFSECT1"
       
  9244 -><A
       
  9245 -NAME="AEN8816"
       
  9246 -></A
       
  9247 -><H2
       
  9248 ->See also</H2
       
  9249 -><P
       
  9250 -><A
       
  9251 -HREF="#SQLUSERINFO"
       
  9252 ->SQLUserInfo</A
       
  9253 -></P
       
  9254 -></DIV
       
  9255 -><DIV
       
  9256 -CLASS="REFSECT1"
       
  9257 -><A
       
  9258 -NAME="AEN8820"
       
  9259 -></A
       
  9260 -><H2
       
  9261 ->Examples</H2
       
  9262 -><P
       
  9263 -CLASS="LITERALLAYOUT"
       
  9264 -></P
       
  9265 -></DIV
       
  9266 -><H1
       
  9267 -><A
       
  9268 -NAME="SQLDEFAULTUID"
       
  9269 -></A
       
  9270 ->
       
  9271 -SQLDefaultUID</H1
       
  9272 -><DIV
       
  9273 -CLASS="REFNAMEDIV"
       
  9274 -><A
       
  9275 -NAME="AEN8831"
       
  9276 -></A
       
  9277 -><H2
       
  9278 ->Name</H2
       
  9279 ->SQLDefaultUID&nbsp;--&nbsp;Configure the default UID for users</DIV
       
  9280 -><DIV
       
  9281 -CLASS="REFSYNOPSISDIV"
       
  9282 -><A
       
  9283 -NAME="AEN8834"
       
  9284 -></A
       
  9285 -><H2
       
  9286 ->Synopsis</H2
       
  9287 -><P
       
  9288 -><B
       
  9289 -CLASS="COMMAND"
       
  9290 ->SQLDefaultUID</B
       
  9291 ->  [  <CODE
       
  9292 -CLASS="OPTION"
       
  9293 ->defaultuid</CODE
       
  9294 ->]</P
       
  9295 -><P
       
  9296 -></P
       
  9297 -><DIV
       
  9298 -CLASS="VARIABLELIST"
       
  9299 -><P
       
  9300 -><B
       
  9301 -></B
       
  9302 -></P
       
  9303 -><DL
       
  9304 -><DT
       
  9305 -><PRE
       
  9306 -CLASS="SYNOPSIS"
       
  9307 ->Default</PRE
       
  9308 -></DT
       
  9309 -><DD
       
  9310 -><P
       
  9311 ->65533</P
       
  9312 -></DD
       
  9313 -><DT
       
  9314 -><PRE
       
  9315 -CLASS="SYNOPSIS"
       
  9316 ->Context</PRE
       
  9317 -></DT
       
  9318 -><DD
       
  9319 -><P
       
  9320 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9321 -></DD
       
  9322 -><DT
       
  9323 -><PRE
       
  9324 -CLASS="SYNOPSIS"
       
  9325 ->Module</PRE
       
  9326 -></DT
       
  9327 -><DD
       
  9328 -><P
       
  9329 ->mod_sql</P
       
  9330 -></DD
       
  9331 -><DT
       
  9332 -><PRE
       
  9333 -CLASS="SYNOPSIS"
       
  9334 ->Compatibility</PRE
       
  9335 -></DT
       
  9336 -><DD
       
  9337 -><P
       
  9338 ->1.2.0 and later</P
       
  9339 -></DD
       
  9340 -></DL
       
  9341 -></DIV
       
  9342 -></DIV
       
  9343 -><DIV
       
  9344 -CLASS="REFSECT1"
       
  9345 -><A
       
  9346 -NAME="AEN8861"
       
  9347 -></A
       
  9348 -><H2
       
  9349 ->Description</H2
       
  9350 -><P
       
  9351 ->Sets the default UID for users.  Must be greater than SQLMinID.</P
       
  9352 -></DIV
       
  9353 -><DIV
       
  9354 -CLASS="REFSECT1"
       
  9355 -><A
       
  9356 -NAME="AEN8864"
       
  9357 -></A
       
  9358 -><H2
       
  9359 ->See also</H2
       
  9360 -><P
       
  9361 -><A
       
  9362 -HREF="#SQLMINID"
       
  9363 ->SQLMinID</A
       
  9364 ->
       
  9365 -<A
       
  9366 -HREF="#SQLMINUSERUID"
       
  9367 ->SQLMinUserUID</A
       
  9368 -></P
       
  9369 -></DIV
       
  9370 -><H1
       
  9371 -><A
       
  9372 -NAME="SQLENGINE"
       
  9373 -></A
       
  9374 ->
       
  9375 -SQLEngine</H1
       
  9376 -><DIV
       
  9377 -CLASS="REFNAMEDIV"
       
  9378 -><A
       
  9379 -NAME="AEN8877"
       
  9380 -></A
       
  9381 -><H2
       
  9382 ->Name</H2
       
  9383 ->SQLEngine&nbsp;--&nbsp;Configure how mod_sql will operate</DIV
       
  9384 -><DIV
       
  9385 -CLASS="REFSYNOPSISDIV"
       
  9386 -><A
       
  9387 -NAME="AEN8880"
       
  9388 -></A
       
  9389 -><H2
       
  9390 ->Synopsis</H2
       
  9391 -><P
       
  9392 -><B
       
  9393 -CLASS="COMMAND"
       
  9394 ->SQLEngine</B
       
  9395 ->  [  <CODE
       
  9396 -CLASS="OPTION"
       
  9397 ->on|off|auth|log</CODE
       
  9398 ->]</P
       
  9399 -><P
       
  9400 -></P
       
  9401 -><DIV
       
  9402 -CLASS="VARIABLELIST"
       
  9403 -><P
       
  9404 -><B
       
  9405 -></B
       
  9406 -></P
       
  9407 -><DL
       
  9408 -><DT
       
  9409 -><PRE
       
  9410 -CLASS="SYNOPSIS"
       
  9411 ->Default</PRE
       
  9412 -></DT
       
  9413 -><DD
       
  9414 -><P
       
  9415 ->SQLEngine on</P
       
  9416 -></DD
       
  9417 -><DT
       
  9418 -><PRE
       
  9419 -CLASS="SYNOPSIS"
       
  9420 ->Context</PRE
       
  9421 -></DT
       
  9422 -><DD
       
  9423 -><P
       
  9424 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;, &lt;Anonymous&gt;</P
       
  9425 -></DD
       
  9426 -><DT
       
  9427 -><PRE
       
  9428 -CLASS="SYNOPSIS"
       
  9429 ->Module</PRE
       
  9430 -></DT
       
  9431 -><DD
       
  9432 -><P
       
  9433 ->mod_sql</P
       
  9434 -></DD
       
  9435 -><DT
       
  9436 -><PRE
       
  9437 -CLASS="SYNOPSIS"
       
  9438 ->Compatibility</PRE
       
  9439 -></DT
       
  9440 -><DD
       
  9441 -><P
       
  9442 ->1.3.0rc1 and later</P
       
  9443 -></DD
       
  9444 -></DL
       
  9445 -></DIV
       
  9446 -></DIV
       
  9447 -><DIV
       
  9448 -CLASS="REFSECT1"
       
  9449 -><A
       
  9450 -NAME="AEN8907"
       
  9451 -></A
       
  9452 -><H2
       
  9453 ->Description</H2
       
  9454 -><P
       
  9455 ->The SQLEngine directive is used to specify how mod_sql will operate. By
       
  9456 -default, SQLEngine is on, and mod_sql will operate as normal. Setting
       
  9457 -SQLEngine to off will effectively disable the module.</P
       
  9458 -><P
       
  9459 ->In addition to on and off, SQLEngine accepts two other values: auth and
       
  9460 -log. If you wish to use mod_sql for authentication and not for logging
       
  9461 -(via SQLLog), use auth. Conversely, to do only SQLLog-type logging, and
       
  9462 -no authentication, use log.</P
       
  9463 -><P
       
  9464 ->This directive can be used to have &lt;Anonymous&gt; sections that do not use
       
  9465 -mod_sql (see the example below).</P
       
  9466 -></DIV
       
  9467 -><DIV
       
  9468 -CLASS="REFSECT1"
       
  9469 -><A
       
  9470 -NAME="AEN8912"
       
  9471 -></A
       
  9472 -><H2
       
  9473 ->See also</H2
       
  9474 -><P
       
  9475 -></P
       
  9476 -></DIV
       
  9477 -><DIV
       
  9478 -CLASS="REFSECT1"
       
  9479 -><A
       
  9480 -NAME="AEN8915"
       
  9481 -></A
       
  9482 -><H2
       
  9483 ->Examples</H2
       
  9484 -><P
       
  9485 -CLASS="LITERALLAYOUT"
       
  9486 ->&nbsp;&nbsp;&lt;Anonymous&nbsp;~ftp&gt;<br>
       
  9487 -&nbsp;&nbsp;&nbsp;&nbsp;...<br>
       
  9488 -&nbsp;&nbsp;&nbsp;&nbsp;SQLEngine&nbsp;off<br>
       
  9489 -&nbsp;&nbsp;&nbsp;&nbsp;...<br>
       
  9490 -&nbsp;&nbsp;&lt;/Anonymous&gt;</P
       
  9491 -></DIV
       
  9492 -><H1
       
  9493 -><A
       
  9494 -NAME="SQLGROUPINFO"
       
  9495 -></A
       
  9496 ->
       
  9497 -SQLGroupInfo</H1
       
  9498 -><DIV
       
  9499 -CLASS="REFNAMEDIV"
       
  9500 -><A
       
  9501 -NAME="AEN8926"
       
  9502 -></A
       
  9503 -><H2
       
  9504 ->Name</H2
       
  9505 ->SQLGroupInfo&nbsp;--&nbsp;Configure the group table and fields that hold group information</DIV
       
  9506 -><DIV
       
  9507 -CLASS="REFSYNOPSISDIV"
       
  9508 -><A
       
  9509 -NAME="AEN8929"
       
  9510 -></A
       
  9511 -><H2
       
  9512 ->Synopsis</H2
       
  9513 -><P
       
  9514 -><B
       
  9515 -CLASS="COMMAND"
       
  9516 ->SQLGroupInfo</B
       
  9517 ->  [  <CODE
       
  9518 -CLASS="OPTION"
       
  9519 ->group-table group-name gid members</CODE
       
  9520 ->]</P
       
  9521 -><P
       
  9522 -></P
       
  9523 -><DIV
       
  9524 -CLASS="VARIABLELIST"
       
  9525 -><P
       
  9526 -><B
       
  9527 -></B
       
  9528 -></P
       
  9529 -><DL
       
  9530 -><DT
       
  9531 -><PRE
       
  9532 -CLASS="SYNOPSIS"
       
  9533 ->Default</PRE
       
  9534 -></DT
       
  9535 -><DD
       
  9536 -><P
       
  9537 ->&quot;groups groupname gid members&quot;</P
       
  9538 -></DD
       
  9539 -><DT
       
  9540 -><PRE
       
  9541 -CLASS="SYNOPSIS"
       
  9542 ->Context</PRE
       
  9543 -></DT
       
  9544 -><DD
       
  9545 -><P
       
  9546 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9547 -></DD
       
  9548 -><DT
       
  9549 -><PRE
       
  9550 -CLASS="SYNOPSIS"
       
  9551 ->Module</PRE
       
  9552 -></DT
       
  9553 -><DD
       
  9554 -><P
       
  9555 ->mod_sql</P
       
  9556 -></DD
       
  9557 -><DT
       
  9558 -><PRE
       
  9559 -CLASS="SYNOPSIS"
       
  9560 ->Compatibility</PRE
       
  9561 -></DT
       
  9562 -><DD
       
  9563 -><P
       
  9564 ->1.2.5rc1 and later</P
       
  9565 -></DD
       
  9566 -></DL
       
  9567 -></DIV
       
  9568 -></DIV
       
  9569 -><DIV
       
  9570 -CLASS="REFSECT1"
       
  9571 -><A
       
  9572 -NAME="AEN8956"
       
  9573 -></A
       
  9574 -><H2
       
  9575 ->Description</H2
       
  9576 -><P
       
  9577 ->The SQLGroupInfo directive configures the group table and fields that hold group information. The parameters for this directive are described below:</P
       
  9578 -><P
       
  9579 -></P
       
  9580 -><UL
       
  9581 -><LI
       
  9582 -STYLE="list-style-type: disc"
       
  9583 -><P
       
  9584 ->grouptable</P
       
  9585 -><P
       
  9586 ->      Specifies the name of the table that holds group information.</P
       
  9587 -></LI
       
  9588 -><LI
       
  9589 -STYLE="list-style-type: disc"
       
  9590 -><P
       
  9591 ->groupname</P
       
  9592 -><P
       
  9593 ->      Specifies the field in the group table that holds the group name.</P
       
  9594 -></LI
       
  9595 -><LI
       
  9596 -STYLE="list-style-type: disc"
       
  9597 -><P
       
  9598 ->gid</P
       
  9599 -><P
       
  9600 ->      Specifies the field in the group table that holds the group's GID.</P
       
  9601 -></LI
       
  9602 -><LI
       
  9603 -STYLE="list-style-type: disc"
       
  9604 -><P
       
  9605 ->members</P
       
  9606 -><P
       
  9607 ->      Specifies the field in the group table that holds the group members.</P
       
  9608 -></LI
       
  9609 -></UL
       
  9610 -><P
       
  9611 ->If you need to change any of these field names from the default, you need
       
  9612 -to specify all of them.</P
       
  9613 -></DIV
       
  9614 -><DIV
       
  9615 -CLASS="REFSECT1"
       
  9616 -><A
       
  9617 -NAME="AEN8973"
       
  9618 -></A
       
  9619 -><H2
       
  9620 ->See also</H2
       
  9621 -><P
       
  9622 -></P
       
  9623 -></DIV
       
  9624 -><DIV
       
  9625 -CLASS="REFSECT1"
       
  9626 -><A
       
  9627 -NAME="AEN8976"
       
  9628 -></A
       
  9629 -><H2
       
  9630 ->Examples</H2
       
  9631 -><P
       
  9632 -CLASS="LITERALLAYOUT"
       
  9633 -></P
       
  9634 -></DIV
       
  9635 -><H1
       
  9636 -><A
       
  9637 -NAME="SQLGROUPWHERECLAUSE"
       
  9638 -></A
       
  9639 ->
       
  9640 -SQLGroupWhereClause</H1
       
  9641 -><DIV
       
  9642 -CLASS="REFNAMEDIV"
       
  9643 -><A
       
  9644 -NAME="AEN8987"
       
  9645 -></A
       
  9646 -><H2
       
  9647 ->Name</H2
       
  9648 ->SQLGroupWhereClause&nbsp;--&nbsp;Configure a WHERE clause for every group query</DIV
       
  9649 -><DIV
       
  9650 -CLASS="REFSYNOPSISDIV"
       
  9651 -><A
       
  9652 -NAME="AEN8990"
       
  9653 -></A
       
  9654 -><H2
       
  9655 ->Synopsis</H2
       
  9656 -><P
       
  9657 -><B
       
  9658 -CLASS="COMMAND"
       
  9659 ->SQLGroupWhereClause</B
       
  9660 ->  [  <CODE
       
  9661 -CLASS="OPTION"
       
  9662 ->where-clause</CODE
       
  9663 ->]</P
       
  9664 -><P
       
  9665 -></P
       
  9666 -><DIV
       
  9667 -CLASS="VARIABLELIST"
       
  9668 -><P
       
  9669 -><B
       
  9670 -></B
       
  9671 -></P
       
  9672 -><DL
       
  9673 -><DT
       
  9674 -><PRE
       
  9675 -CLASS="SYNOPSIS"
       
  9676 ->Default</PRE
       
  9677 -></DT
       
  9678 -><DD
       
  9679 -><P
       
  9680 ->off</P
       
  9681 -></DD
       
  9682 -><DT
       
  9683 -><PRE
       
  9684 -CLASS="SYNOPSIS"
       
  9685 ->Context</PRE
       
  9686 -></DT
       
  9687 -><DD
       
  9688 -><P
       
  9689 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9690 -></DD
       
  9691 -><DT
       
  9692 -><PRE
       
  9693 -CLASS="SYNOPSIS"
       
  9694 ->Module</PRE
       
  9695 -></DT
       
  9696 -><DD
       
  9697 -><P
       
  9698 ->mod_sql</P
       
  9699 -></DD
       
  9700 -><DT
       
  9701 -><PRE
       
  9702 -CLASS="SYNOPSIS"
       
  9703 ->Compatibility</PRE
       
  9704 -></DT
       
  9705 -><DD
       
  9706 -><P
       
  9707 ->1.2.5rc1 and later</P
       
  9708 -></DD
       
  9709 -></DL
       
  9710 -></DIV
       
  9711 -></DIV
       
  9712 -><DIV
       
  9713 -CLASS="REFSECT1"
       
  9714 -><A
       
  9715 -NAME="AEN9017"
       
  9716 -></A
       
  9717 -><H2
       
  9718 ->Description</H2
       
  9719 -><P
       
  9720 ->The directive is used to configure a WHERE clause that is added to every
       
  9721 -group query. The WHERE clause must contain all relevant punctuation, and
       
  9722 -must not contain a leading "and".</P
       
  9723 -><P
       
  9724 ->Starting with ProFTPD 1.3.1rc1 the SQLGroupWhereClause also supports the
       
  9725 -variables supported by <A
       
  9726 -HREF="#SQLNAMEDQUERY"
       
  9727 ->SQLNamedQuery</A
       
  9728 ->
       
  9729 -except for the &quot;%{n}&quot; variable</P
       
  9730 -></DIV
       
  9731 -><DIV
       
  9732 -CLASS="REFSECT1"
       
  9733 -><A
       
  9734 -NAME="AEN9022"
       
  9735 -></A
       
  9736 -><H2
       
  9737 ->See also</H2
       
  9738 -><P
       
  9739 -><A
       
  9740 -HREF="#SQLNAMEDQUERY"
       
  9741 ->SQLNamedQuery</A
       
  9742 -></P
       
  9743 -></DIV
       
  9744 -><DIV
       
  9745 -CLASS="REFSECT1"
       
  9746 -><A
       
  9747 -NAME="AEN9026"
       
  9748 -></A
       
  9749 -><H2
       
  9750 ->Examples</H2
       
  9751 -><P
       
  9752 ->As an example of a possible use for this directive, imagine if your group
       
  9753 -table included a "LoginAllowed" field:</P
       
  9754 -><P
       
  9755 -CLASS="LITERALLAYOUT"
       
  9756 ->&nbsp;&nbsp;SQLGroupWhereClause&nbsp;"LoginAllowed&nbsp;=&nbsp;'true'"</P
       
  9757 -><P
       
  9758 ->would be appended to every group-related query as the string:</P
       
  9759 -><P
       
  9760 -CLASS="LITERALLAYOUT"
       
  9761 ->&nbsp;&nbsp;"&nbsp;WHERE&nbsp;(LoginAllowed&nbsp;=&nbsp;'true')"</P
       
  9762 -></DIV
       
  9763 -><H1
       
  9764 -><A
       
  9765 -NAME="SQLHOMEDIRONDEMAND"
       
  9766 -></A
       
  9767 ->
       
  9768 -SQLHomedirOnDemand</H1
       
  9769 -><DIV
       
  9770 -CLASS="REFNAMEDIV"
       
  9771 -><A
       
  9772 -NAME="AEN9040"
       
  9773 -></A
       
  9774 -><H2
       
  9775 ->Name</H2
       
  9776 ->SQLHomedirOnDemand&nbsp;--&nbsp;Have mod_sql create home directories as needed [deprecated]</DIV
       
  9777 -><DIV
       
  9778 -CLASS="REFSYNOPSISDIV"
       
  9779 -><A
       
  9780 -NAME="AEN9043"
       
  9781 -></A
       
  9782 -><H2
       
  9783 ->Synopsis</H2
       
  9784 -><P
       
  9785 -><B
       
  9786 -CLASS="COMMAND"
       
  9787 ->SQLHomedirOnDemand</B
       
  9788 ->  [  <CODE
       
  9789 -CLASS="OPTION"
       
  9790 ->on|off</CODE
       
  9791 ->]</P
       
  9792 -><P
       
  9793 -></P
       
  9794 -><DIV
       
  9795 -CLASS="VARIABLELIST"
       
  9796 -><P
       
  9797 -><B
       
  9798 -></B
       
  9799 -></P
       
  9800 -><DL
       
  9801 -><DT
       
  9802 -><PRE
       
  9803 -CLASS="SYNOPSIS"
       
  9804 ->Default</PRE
       
  9805 -></DT
       
  9806 -><DD
       
  9807 -><P
       
  9808 ->off</P
       
  9809 -></DD
       
  9810 -><DT
       
  9811 -><PRE
       
  9812 -CLASS="SYNOPSIS"
       
  9813 ->Context</PRE
       
  9814 -></DT
       
  9815 -><DD
       
  9816 -><P
       
  9817 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9818 -></DD
       
  9819 -><DT
       
  9820 -><PRE
       
  9821 -CLASS="SYNOPSIS"
       
  9822 ->Module</PRE
       
  9823 -></DT
       
  9824 -><DD
       
  9825 -><P
       
  9826 ->mod_sql</P
       
  9827 -></DD
       
  9828 -><DT
       
  9829 -><PRE
       
  9830 -CLASS="SYNOPSIS"
       
  9831 ->Compatibility</PRE
       
  9832 -></DT
       
  9833 -><DD
       
  9834 -><P
       
  9835 ->1.2.0 up to 1.3.1rc1</P
       
  9836 -></DD
       
  9837 -></DL
       
  9838 -></DIV
       
  9839 -></DIV
       
  9840 -><DIV
       
  9841 -CLASS="REFSECT1"
       
  9842 -><A
       
  9843 -NAME="AEN9070"
       
  9844 -></A
       
  9845 -><H2
       
  9846 ->Description</H2
       
  9847 -><P
       
  9848 ->This directive has been deprecated with ProFTPD 1.3.1rc1.
       
  9849 -Please use <A
       
  9850 -HREF="#CREATEHOME"
       
  9851 ->CreateHome</A
       
  9852 -> instead.</P
       
  9853 -><P
       
  9854 ->The SQLHomedirOnDemand directive configures mod_sql to automatically
       
  9855 -create a user's home directory if that directory does not exist during
       
  9856 -the login process.</P
       
  9857 -></DIV
       
  9858 -><H1
       
  9859 -><A
       
  9860 -NAME="SQLLOG"
       
  9861 -></A
       
  9862 ->
       
  9863 -SQLLog</H1
       
  9864 -><DIV
       
  9865 -CLASS="REFNAMEDIV"
       
  9866 -><A
       
  9867 -NAME="AEN9083"
       
  9868 -></A
       
  9869 -><H2
       
  9870 ->Name</H2
       
  9871 ->SQLLog&nbsp;--&nbsp;Log information to a database table</DIV
       
  9872 -><DIV
       
  9873 -CLASS="REFSYNOPSISDIV"
       
  9874 -><A
       
  9875 -NAME="AEN9086"
       
  9876 -></A
       
  9877 -><H2
       
  9878 ->Synopsis</H2
       
  9879 -><P
       
  9880 -><B
       
  9881 -CLASS="COMMAND"
       
  9882 ->SQLLog</B
       
  9883 ->  [  <CODE
       
  9884 -CLASS="OPTION"
       
  9885 ->cmd-set query-name [&quot;IGNORE_ERRORS&quot;</CODE
       
  9886 ->]</P
       
  9887 -><P
       
  9888 -></P
       
  9889 -><DIV
       
  9890 -CLASS="VARIABLELIST"
       
  9891 -><P
       
  9892 -><B
       
  9893 -></B
       
  9894 -></P
       
  9895 -><DL
       
  9896 -><DT
       
  9897 -><PRE
       
  9898 -CLASS="SYNOPSIS"
       
  9899 ->Default</PRE
       
  9900 -></DT
       
  9901 -><DD
       
  9902 -><P
       
  9903 ->None</P
       
  9904 -></DD
       
  9905 -><DT
       
  9906 -><PRE
       
  9907 -CLASS="SYNOPSIS"
       
  9908 ->Context</PRE
       
  9909 -></DT
       
  9910 -><DD
       
  9911 -><P
       
  9912 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
  9913 -></DD
       
  9914 -><DT
       
  9915 -><PRE
       
  9916 -CLASS="SYNOPSIS"
       
  9917 ->Module</PRE
       
  9918 -></DT
       
  9919 -><DD
       
  9920 -><P
       
  9921 ->mod_sql</P
       
  9922 -></DD
       
  9923 -><DT
       
  9924 -><PRE
       
  9925 -CLASS="SYNOPSIS"
       
  9926 ->Compatibility</PRE
       
  9927 -></DT
       
  9928 -><DD
       
  9929 -><P
       
  9930 ->1.2.5rc1 and later</P
       
  9931 -></DD
       
  9932 -></DL
       
  9933 -></DIV
       
  9934 -></DIV
       
  9935 -><DIV
       
  9936 -CLASS="REFSECT1"
       
  9937 -><A
       
  9938 -NAME="AEN9113"
       
  9939 -></A
       
  9940 -><H2
       
  9941 ->Description</H2
       
  9942 -><P
       
  9943 ->This directive is used to log information to a database table. Multiple
       
  9944 -SQLLog directives can be in effect for any command; for example, a user
       
  9945 -changing directories can trigger multiple logging statements.</P
       
  9946 -><P
       
  9947 ->The first parameter to SQLLog, the cmd-set, is a comma-separated (no spaces)
       
  9948 -list of FTP commands for which this log command will trigger. The list of
       
  9949 -commands is too long to list in entirety; commands include CWD, DELE, HELP,
       
  9950 -LIST, MKD, MODE, NLST, PASS, PASV, PORT and many more. For the complete list
       
  9951 -check the FTP RFCs. Normally mod_sql will log events after they have
       
  9952 -completed successfully; in the case of the QUIT command, mod_sql logs prior
       
  9953 -to the server's processing of the command. (Note, however, that the client
       
  9954 -may not issue a QUIT before logging out; in this case, use a command of EXIT
       
  9955 -rather than QUIT. EXIT is not a real FTP command, but it is used here to
       
  9956 -provide a means for having SQLLog work whenever a session ends.)</P
       
  9957 -><P
       
  9958 ->FTP commands in the command set will only be logged if they complete
       
  9959 -successfully. Prefixing any command with "ERR_" will cause logging to occur
       
  9960 -only if there was an error in the command's processing. To log both errors
       
  9961 -and successful completion of a given command X, therefore, you'll need both
       
  9962 -"X" and "ERR_X" in your cmd-set.</P
       
  9963 -><P
       
  9964 ->The special command "*" matches all FTP commands, while "ERR_*" matches all
       
  9965 -errors.</P
       
  9966 -><P
       
  9967 ->The second parameter is the name of a query defined by a SQLNamedQuery
       
  9968 -directive. The query must be an UPDATE, INSERT, or FREEFORM type query;
       
  9969 -explicit SELECT queries will not be processed.</P
       
  9970 -><P
       
  9971 ->The third parameter is optional. If you add "IGNORE_ERRORS" as the third
       
  9972 -parameter, SQLLog will not check for errors in the processing of the named
       
  9973 -query. Any value for this parameter other than the string "IGNORE_ERRORS"
       
  9974 -(case-insensitive) will not cause errors to be ignored.</P
       
  9975 -><P
       
  9976 ->Normally, SQLLog directives are considered important enough that errors in
       
  9977 -their processing will cause mod_sql to abort the client session. References
       
  9978 -to non-existent named queries will not abort the client session, but may
       
  9979 -result in database corruption (in the sense that the expected database
       
  9980 -UPDATE or INSERT will not occur). Check your directives carefully.</P
       
  9981 -></DIV
       
  9982 -><DIV
       
  9983 -CLASS="REFSECT1"
       
  9984 -><A
       
  9985 -NAME="AEN9122"
       
  9986 -></A
       
  9987 -><H2
       
  9988 ->See also</H2
       
  9989 -><P
       
  9990 -></P
       
  9991 -></DIV
       
  9992 -><DIV
       
  9993 -CLASS="REFSECT1"
       
  9994 -><A
       
  9995 -NAME="AEN9125"
       
  9996 -></A
       
  9997 -><H2
       
  9998 ->Examples</H2
       
  9999 -><P
       
 10000 -CLASS="LITERALLAYOUT"
       
 10001 ->&nbsp;&nbsp;SQLLog&nbsp;PASS&nbsp;updatecount<br>
       
 10002 -&nbsp;&nbsp;SQLNamedQuery&nbsp;updatecount&nbsp;UPDATE&nbsp;"count=count+1&nbsp;WHERE&nbsp;userid='%u'"&nbsp;users</P
       
 10003 -><P
       
 10004 ->together, these replicate the deprecated "SQLLoginCountField count" directive;
       
 10005 -if the current user was "joe", this would translate into the query "UPDATE
       
 10006 -users SET count=count+1 WHERE userid='joe'". This query would run whenever a
       
 10007 -user was first authenticated.</P
       
 10008 -><P
       
 10009 -CLASS="LITERALLAYOUT"
       
 10010 ->&nbsp;&nbsp;SQLLog&nbsp;CWD&nbsp;updatedir<br>
       
 10011 -&nbsp;&nbsp;SQLNamedQuery&nbsp;updatedir&nbsp;UPDATE&nbsp;"cwd='%d'&nbsp;where&nbsp;userid='%u'"&nbsp;users</P
       
 10012 -><P
       
 10013 ->together these replicate the logging side of the deprecated "SQLLogDirs cwd"
       
 10014 -directive; if the current user was "joe" and the current working directory
       
 10015 -were /tmp, this would translate into the query "UPDATE users SET cwd='/tmp'
       
 10016 -WHERE userid='joe'". This query would run whenever a user changed directories.</P
       
 10017 -><P
       
 10018 -CLASS="LITERALLAYOUT"
       
 10019 ->&nbsp;&nbsp;SQLLog&nbsp;RETR,STOR&nbsp;insertfileinfo<br>
       
 10020 -&nbsp;&nbsp;SQLNamedQuery&nbsp;insertfileinfo&nbsp;INSERT&nbsp;"'%f',&nbsp;%b,&nbsp;'%u@%v',&nbsp;now()"&nbsp;filehistory</P
       
 10021 -><P
       
 10022 ->would log the name of any file stored or retrieved, the number of bytes
       
 10023 -transferred, the user and host doing the transfer, and the time of transfer
       
 10024 -(at least in MySQL). This would translate into a query like: "INSERT INTO
       
 10025 -filehistory VALUES ('somefile', 12345, '[email protected]', '21-05-2001 20:01:00')"</P
       
 10026 -></DIV
       
 10027 -><H1
       
 10028 -><A
       
 10029 -NAME="SQLLOGFILE"
       
 10030 -></A
       
 10031 ->
       
 10032 -SQLLogFile</H1
       
 10033 -><DIV
       
 10034 -CLASS="REFNAMEDIV"
       
 10035 -><A
       
 10036 -NAME="AEN9141"
       
 10037 -></A
       
 10038 -><H2
       
 10039 ->Name</H2
       
 10040 ->SQLLogFile&nbsp;--&nbsp;Specify a log file for mod_sql reporting and debugging</DIV
       
 10041 -><DIV
       
 10042 -CLASS="REFSYNOPSISDIV"
       
 10043 -><A
       
 10044 -NAME="AEN9144"
       
 10045 -></A
       
 10046 -><H2
       
 10047 ->Synopsis</H2
       
 10048 -><P
       
 10049 -><B
       
 10050 -CLASS="COMMAND"
       
 10051 ->SQLLogFile</B
       
 10052 ->  [  <CODE
       
 10053 -CLASS="OPTION"
       
 10054 ->file</CODE
       
 10055 ->]</P
       
 10056 -><P
       
 10057 -></P
       
 10058 -><DIV
       
 10059 -CLASS="VARIABLELIST"
       
 10060 -><P
       
 10061 -><B
       
 10062 -></B
       
 10063 -></P
       
 10064 -><DL
       
 10065 -><DT
       
 10066 -><PRE
       
 10067 -CLASS="SYNOPSIS"
       
 10068 ->Default</PRE
       
 10069 -></DT
       
 10070 -><DD
       
 10071 -><P
       
 10072 ->None</P
       
 10073 -></DD
       
 10074 -><DT
       
 10075 -><PRE
       
 10076 -CLASS="SYNOPSIS"
       
 10077 ->Context</PRE
       
 10078 -></DT
       
 10079 -><DD
       
 10080 -><P
       
 10081 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 10082 -></DD
       
 10083 -><DT
       
 10084 -><PRE
       
 10085 -CLASS="SYNOPSIS"
       
 10086 ->Module</PRE
       
 10087 -></DT
       
 10088 -><DD
       
 10089 -><P
       
 10090 ->mod_sql</P
       
 10091 -></DD
       
 10092 -><DT
       
 10093 -><PRE
       
 10094 -CLASS="SYNOPSIS"
       
 10095 ->Compatibility</PRE
       
 10096 -></DT
       
 10097 -><DD
       
 10098 -><P
       
 10099 ->1.2.8rc2 and later</P
       
 10100 -></DD
       
 10101 -></DL
       
 10102 -></DIV
       
 10103 -></DIV
       
 10104 -><DIV
       
 10105 -CLASS="REFSECT1"
       
 10106 -><A
       
 10107 -NAME="AEN9171"
       
 10108 -></A
       
 10109 -><H2
       
 10110 ->Description</H2
       
 10111 -><P
       
 10112 ->The SQLLogFile directive is used to a specify a log file for mod_sql
       
 10113 -reporting and debugging, and can be done a per-server basis. The file
       
 10114 -parameter must be the full path to the file to use for logging. Note
       
 10115 -that this path must not be to a world-writeable directory and, unless
       
 10116 -AllowLogSymlinks is explicitly set to on (generally a bad idea), the
       
 10117 -path must not be a symbolic link.</P
       
 10118 -><P
       
 10119 ->If file is "none", no logging will be done at all; this setting can be
       
 10120 -used to override a SQLLogFile setting inherited from a ;ltgt&#38; context. </P
       
 10121 -></DIV
       
 10122 -><DIV
       
 10123 -CLASS="REFSECT1"
       
 10124 -><A
       
 10125 -NAME="AEN9175"
       
 10126 -></A
       
 10127 -><H2
       
 10128 ->See also</H2
       
 10129 -><P
       
 10130 -></P
       
 10131 -></DIV
       
 10132 -><DIV
       
 10133 -CLASS="REFSECT1"
       
 10134 -><A
       
 10135 -NAME="AEN9178"
       
 10136 -></A
       
 10137 -><H2
       
 10138 ->Examples</H2
       
 10139 -><P
       
 10140 -CLASS="LITERALLAYOUT"
       
 10141 -></P
       
 10142 -></DIV
       
 10143 -><H1
       
 10144 -><A
       
 10145 -NAME="SQLMINID"
       
 10146 -></A
       
 10147 ->
       
 10148 -SQLMinID</H1
       
 10149 -><DIV
       
 10150 -CLASS="REFNAMEDIV"
       
 10151 -><A
       
 10152 -NAME="AEN9189"
       
 10153 -></A
       
 10154 -><H2
       
 10155 ->Name</H2
       
 10156 ->SQLMinID&nbsp;--&nbsp;Set SQLMinUserGID and SQLMinUserID in one place</DIV
       
 10157 -><DIV
       
 10158 -CLASS="REFSYNOPSISDIV"
       
 10159 -><A
       
 10160 -NAME="AEN9192"
       
 10161 -></A
       
 10162 -><H2
       
 10163 ->Synopsis</H2
       
 10164 -><P
       
 10165 -><B
       
 10166 -CLASS="COMMAND"
       
 10167 ->SQLMinID</B
       
 10168 ->  [  <CODE
       
 10169 -CLASS="OPTION"
       
 10170 ->minimum-id</CODE
       
 10171 ->]</P
       
 10172 -><P
       
 10173 -></P
       
 10174 -><DIV
       
 10175 -CLASS="VARIABLELIST"
       
 10176 -><P
       
 10177 -><B
       
 10178 -></B
       
 10179 -></P
       
 10180 -><DL
       
 10181 -><DT
       
 10182 -><PRE
       
 10183 -CLASS="SYNOPSIS"
       
 10184 ->Default</PRE
       
 10185 -></DT
       
 10186 -><DD
       
 10187 -><P
       
 10188 ->999</P
       
 10189 -></DD
       
 10190 -><DT
       
 10191 -><PRE
       
 10192 -CLASS="SYNOPSIS"
       
 10193 ->Context</PRE
       
 10194 -></DT
       
 10195 -><DD
       
 10196 -><P
       
 10197 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 10198 -></DD
       
 10199 -><DT
       
 10200 -><PRE
       
 10201 -CLASS="SYNOPSIS"
       
 10202 ->Module</PRE
       
 10203 -></DT
       
 10204 -><DD
       
 10205 -><P
       
 10206 ->mod_sql</P
       
 10207 -></DD
       
 10208 -><DT
       
 10209 -><PRE
       
 10210 -CLASS="SYNOPSIS"
       
 10211 ->Compatibility</PRE
       
 10212 -></DT
       
 10213 -><DD
       
 10214 -><P
       
 10215 ->1.2.0 and later</P
       
 10216 -></DD
       
 10217 -></DL
       
 10218 -></DIV
       
 10219 -></DIV
       
 10220 -><DIV
       
 10221 -CLASS="REFSECT1"
       
 10222 -><A
       
 10223 -NAME="AEN9219"
       
 10224 -></A
       
 10225 -><H2
       
 10226 ->Description</H2
       
 10227 -><P
       
 10228 ->SQLMinID is a quick way of setting both SQLMinUserGID and SQLMinUserUID.
       
 10229 -These values are checked whenever retrieving a user's GID or UID.</P
       
 10230 -></DIV
       
 10231 -><DIV
       
 10232 -CLASS="REFSECT1"
       
 10233 -><A
       
 10234 -NAME="AEN9222"
       
 10235 -></A
       
 10236 -><H2
       
 10237 ->See also</H2
       
 10238 -><P
       
 10239 -><A
       
 10240 -HREF="#SQLMINUSERGID"
       
 10241 ->SQLMinUserGID</A
       
 10242 ->
       
 10243 -<A
       
 10244 -HREF="#SQLMINUSERUID"
       
 10245 ->SQLMinUserUID</A
       
 10246 -></P
       
 10247 -></DIV
       
 10248 -><H1
       
 10249 -><A
       
 10250 -NAME="SQLMINUSERGID"
       
 10251 -></A
       
 10252 ->
       
 10253 -SQLMinUserGID</H1
       
 10254 -><DIV
       
 10255 -CLASS="REFNAMEDIV"
       
 10256 -><A
       
 10257 -NAME="AEN9235"
       
 10258 -></A
       
 10259 -><H2
       
 10260 ->Name</H2
       
 10261 ->SQLMinUserGID&nbsp;--&nbsp;Set a minimum GID</DIV
       
 10262 -><DIV
       
 10263 -CLASS="REFSYNOPSISDIV"
       
 10264 -><A
       
 10265 -NAME="AEN9238"
       
 10266 -></A
       
 10267 -><H2
       
 10268 ->Synopsis</H2
       
 10269 -><P
       
 10270 -><B
       
 10271 -CLASS="COMMAND"
       
 10272 ->SQLMinUserGID</B
       
 10273 ->  [  <CODE
       
 10274 -CLASS="OPTION"
       
 10275 ->minimum-gid</CODE
       
 10276 ->]</P
       
 10277 -><P
       
 10278 -></P
       
 10279 -><DIV
       
 10280 -CLASS="VARIABLELIST"
       
 10281 -><P
       
 10282 -><B
       
 10283 -></B
       
 10284 -></P
       
 10285 -><DL
       
 10286 -><DT
       
 10287 -><PRE
       
 10288 -CLASS="SYNOPSIS"
       
 10289 ->Default</PRE
       
 10290 -></DT
       
 10291 -><DD
       
 10292 -><P
       
 10293 ->999</P
       
 10294 -></DD
       
 10295 -><DT
       
 10296 -><PRE
       
 10297 -CLASS="SYNOPSIS"
       
 10298 ->Context</PRE
       
 10299 -></DT
       
 10300 -><DD
       
 10301 -><P
       
 10302 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 10303 -></DD
       
 10304 -><DT
       
 10305 -><PRE
       
 10306 -CLASS="SYNOPSIS"
       
 10307 ->Module</PRE
       
 10308 -></DT
       
 10309 -><DD
       
 10310 -><P
       
 10311 ->mod_sql</P
       
 10312 -></DD
       
 10313 -><DT
       
 10314 -><PRE
       
 10315 -CLASS="SYNOPSIS"
       
 10316 ->Compatibility</PRE
       
 10317 -></DT
       
 10318 -><DD
       
 10319 -><P
       
 10320 ->1.2.5rc1 and later</P
       
 10321 -></DD
       
 10322 -></DL
       
 10323 -></DIV
       
 10324 -></DIV
       
 10325 -><DIV
       
 10326 -CLASS="REFSECT1"
       
 10327 -><A
       
 10328 -NAME="AEN9265"
       
 10329 -></A
       
 10330 -><H2
       
 10331 ->Description</H2
       
 10332 -><P
       
 10333 ->SQLMinUserGID is checked whenever retrieving a user's GID. If the retrieved
       
 10334 -value for GID is less than the value of SQLMinUserGID, it is reported as the
       
 10335 -value of SQLDefaultGID.</P
       
 10336 -></DIV
       
 10337 -><DIV
       
 10338 -CLASS="REFSECT1"
       
 10339 -><A
       
 10340 -NAME="AEN9268"
       
 10341 -></A
       
 10342 -><H2
       
 10343 ->See also</H2
       
 10344 -><P
       
 10345 -></P
       
 10346 -></DIV
       
 10347 -><DIV
       
 10348 -CLASS="REFSECT1"
       
 10349 -><A
       
 10350 -NAME="AEN9271"
       
 10351 -></A
       
 10352 -><H2
       
 10353 ->Examples</H2
       
 10354 -><P
       
 10355 -CLASS="LITERALLAYOUT"
       
 10356 -></P
       
 10357 -></DIV
       
 10358 -><H1
       
 10359 -><A
       
 10360 -NAME="SQLMINUSERUID"
       
 10361 -></A
       
 10362 ->
       
 10363 -SQLMinUserUID</H1
       
 10364 -><DIV
       
 10365 -CLASS="REFNAMEDIV"
       
 10366 -><A
       
 10367 -NAME="AEN9282"
       
 10368 -></A
       
 10369 -><H2
       
 10370 ->Name</H2
       
 10371 ->SQLMinUserUID&nbsp;--&nbsp;Set a minimum UID</DIV
       
 10372 -><DIV
       
 10373 -CLASS="REFSYNOPSISDIV"
       
 10374 -><A
       
 10375 -NAME="AEN9285"
       
 10376 -></A
       
 10377 -><H2
       
 10378 ->Synopsis</H2
       
 10379 -><P
       
 10380 -><B
       
 10381 -CLASS="COMMAND"
       
 10382 ->SQLMinUserUID</B
       
 10383 ->  [  <CODE
       
 10384 -CLASS="OPTION"
       
 10385 ->minimum-uid</CODE
       
 10386 ->]</P
       
 10387 -><P
       
 10388 -></P
       
 10389 -><DIV
       
 10390 -CLASS="VARIABLELIST"
       
 10391 -><P
       
 10392 -><B
       
 10393 -></B
       
 10394 -></P
       
 10395 -><DL
       
 10396 -><DT
       
 10397 -><PRE
       
 10398 -CLASS="SYNOPSIS"
       
 10399 ->Default</PRE
       
 10400 -></DT
       
 10401 -><DD
       
 10402 -><P
       
 10403 ->999</P
       
 10404 -></DD
       
 10405 -><DT
       
 10406 -><PRE
       
 10407 -CLASS="SYNOPSIS"
       
 10408 ->Context</PRE
       
 10409 -></DT
       
 10410 -><DD
       
 10411 -><P
       
 10412 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 10413 -></DD
       
 10414 -><DT
       
 10415 -><PRE
       
 10416 -CLASS="SYNOPSIS"
       
 10417 ->Module</PRE
       
 10418 -></DT
       
 10419 -><DD
       
 10420 -><P
       
 10421 ->mod_sql</P
       
 10422 -></DD
       
 10423 -><DT
       
 10424 -><PRE
       
 10425 -CLASS="SYNOPSIS"
       
 10426 ->Compatibility</PRE
       
 10427 -></DT
       
 10428 -><DD
       
 10429 -><P
       
 10430 ->1.2.5rc1 and later</P
       
 10431 -></DD
       
 10432 -></DL
       
 10433 -></DIV
       
 10434 -></DIV
       
 10435 -><DIV
       
 10436 -CLASS="REFSECT1"
       
 10437 -><A
       
 10438 -NAME="AEN9312"
       
 10439 -></A
       
 10440 -><H2
       
 10441 ->Description</H2
       
 10442 -><P
       
 10443 ->SQLMinUserUID is checked whenever retrieving a user's UID. If the retrieved
       
 10444 -value for UID is less than the value of SQLMinUserUID, it is reported as the
       
 10445 -value of SQLDefaultUID.</P
       
 10446 -></DIV
       
 10447 -><DIV
       
 10448 -CLASS="REFSECT1"
       
 10449 -><A
       
 10450 -NAME="AEN9315"
       
 10451 -></A
       
 10452 -><H2
       
 10453 ->See also</H2
       
 10454 -><P
       
 10455 -></P
       
 10456 -></DIV
       
 10457 -><DIV
       
 10458 -CLASS="REFSECT1"
       
 10459 -><A
       
 10460 -NAME="AEN9318"
       
 10461 -></A
       
 10462 -><H2
       
 10463 ->Examples</H2
       
 10464 -><P
       
 10465 -CLASS="LITERALLAYOUT"
       
 10466 -></P
       
 10467 -></DIV
       
 10468 -><H1
       
 10469 -><A
       
 10470 -NAME="SQLNAMEDQUERY"
       
 10471 -></A
       
 10472 ->
       
 10473 -SQLNamedQuery</H1
       
 10474 -><DIV
       
 10475 -CLASS="REFNAMEDIV"
       
 10476 -><A
       
 10477 -NAME="AEN9329"
       
 10478 -></A
       
 10479 -><H2
       
 10480 ->Name</H2
       
 10481 ->SQLNamedQuery&nbsp;--&nbsp;Specify a query and an identifier for SQLShowInfo and SQLLog</DIV
       
 10482 -><DIV
       
 10483 -CLASS="REFSYNOPSISDIV"
       
 10484 -><A
       
 10485 -NAME="AEN9332"
       
 10486 -></A
       
 10487 -><H2
       
 10488 ->Synopsis</H2
       
 10489 -><P
       
 10490 -><B
       
 10491 -CLASS="COMMAND"
       
 10492 ->SQLNamedQuery</B
       
 10493 ->  [  <CODE
       
 10494 -CLASS="OPTION"
       
 10495 ->"name" limit|regex|ip value</CODE
       
 10496 ->]</P
       
 10497 -><P
       
 10498 -></P
       
 10499 -><DIV
       
 10500 -CLASS="VARIABLELIST"
       
 10501 -><P
       
 10502 -><B
       
 10503 -></B
       
 10504 -></P
       
 10505 -><DL
       
 10506 -><DT
       
 10507 -><PRE
       
 10508 -CLASS="SYNOPSIS"
       
 10509 ->Default</PRE
       
 10510 -></DT
       
 10511 -><DD
       
 10512 -><P
       
 10513 ->(docs incomplete)</P
       
 10514 -></DD
       
 10515 -><DT
       
 10516 -><PRE
       
 10517 -CLASS="SYNOPSIS"
       
 10518 ->Context</PRE
       
 10519 -></DT
       
 10520 -><DD
       
 10521 -><P
       
 10522 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;, .ftpaccess</P
       
 10523 -></DD
       
 10524 -><DT
       
 10525 -><PRE
       
 10526 -CLASS="SYNOPSIS"
       
 10527 ->Module</PRE
       
 10528 -></DT
       
 10529 -><DD
       
 10530 -><P
       
 10531 ->mod_sql</P
       
 10532 -></DD
       
 10533 -><DT
       
 10534 -><PRE
       
 10535 -CLASS="SYNOPSIS"
       
 10536 ->Compatibility</PRE
       
 10537 -></DT
       
 10538 -><DD
       
 10539 -><P
       
 10540 ->1.2.5rc1 and later</P
       
 10541 -></DD
       
 10542 -></DL
       
 10543 -></DIV
       
 10544 -></DIV
       
 10545 -><DIV
       
 10546 -CLASS="REFSECT1"
       
 10547 -><A
       
 10548 -NAME="AEN9359"
       
 10549 -></A
       
 10550 -><H2
       
 10551 ->Description</H2
       
 10552 -><P
       
 10553 ->SQLNamedQuery specifies a query and an identifier (name) for later use by
       
 10554 -SQLShowInfo and SQLLog.</P
       
 10555 -><P
       
 10556 ->It is strongly recommended that you read documentation on the LogFormat
       
 10557 -and ExtendedLog directives, as the meta-sequences available to SQLNamedQuery
       
 10558 -are largely equivalent.</P
       
 10559 -><P
       
 10560 ->The first parameter, name, should be unique across all named queries and
       
 10561 -must not contain spaces. The result of re-using a name is undefined.</P
       
 10562 -><P
       
 10563 ->The second parameter, type, is the type of query, either "SELECT", "UPDATE",
       
 10564 -"INSERT", or "FREEFORM". See the note below for information on FREEFORM type
       
 10565 -queries.</P
       
 10566 -><P
       
 10567 ->The third parameter is the substance of the database query itself; this
       
 10568 -should match the form of the second parameter. The meta-sequences accepted
       
 10569 -are exactly equivalent to the LogFormat directive except the following are
       
 10570 -not accepted:</P
       
 10571 -><P
       
 10572 -></P
       
 10573 -><UL
       
 10574 -><LI
       
 10575 -STYLE="list-style-type: disc"
       
 10576 -><P
       
 10577 ->%{FOOBAR}e</P
       
 10578 -><P
       
 10579 ->For LogFormat, this logs the content of environment variable "FOOBAR". This
       
 10580 -is not bavailable in mod_sql.</P
       
 10581 -></LI
       
 10582 -><LI
       
 10583 -STYLE="list-style-type: disc"
       
 10584 -><P
       
 10585 ->%{format}t and %t</P
       
 10586 -><P
       
 10587 ->These two meta-sequences logged the local server time; they are not available
       
 10588 -in mod_sql. Your database undoubtedly provides another way to get the time;
       
 10589 -for example, MySQL provides the now() function.</P
       
 10590 -></LI
       
 10591 -></UL
       
 10592 -><P
       
 10593 ->and the following is in addition to the LogFormat meta-sequences:</P
       
 10594 -><P
       
 10595 ->&#13;<P
       
 10596 -></P
       
 10597 -><UL
       
 10598 -><LI
       
 10599 -STYLE="list-style-type: disc"
       
 10600 -><P
       
 10601 ->%d</P
       
 10602 -><P
       
 10603 ->The current working directory or "-" if none.</P
       
 10604 -></LI
       
 10605 -><LI
       
 10606 -STYLE="list-style-type: disc"
       
 10607 -><P
       
 10608 ->%{n}</P
       
 10609 -><P
       
 10610 ->This meta-sequence is used internally by mod_sql and other third-party
       
 10611 -modules and patches to pass information to the database. Using this
       
 10612 -meta-sequence in anything other than an INSERT or UPDATE query is an
       
 10613 -error, and using this meta-sequence unless directed to by a third-party
       
 10614 -module or patch is also an error.</P
       
 10615 -></LI
       
 10616 -><LI
       
 10617 -STYLE="list-style-type: disc"
       
 10618 -><P
       
 10619 ->%{env:VAR}</P
       
 10620 -><P
       
 10621 ->Starting with ProFTPD 1.3.1rc1 the SQLNamedQuery directive is able to make
       
 10622 -use of environment variables in the format &quot;%{env:VAR}&quot;. The value
       
 10623 -of the environment variable VAR will be substituted into the SQL statement.</P
       
 10624 -></LI
       
 10625 -></UL
       
 10626 ->&#13;</P
       
 10627 -><P
       
 10628 ->The correct form of a query will be built from the directive arguments,
       
 10629 -except in the case of FREEFORM queries which will be sent directly to the
       
 10630 -database. The examples below show the way queries are built from the arguments.</P
       
 10631 -><P
       
 10632 ->The fourth parameter, table, is only necessary for UPDATE or INSERT type
       
 10633 -queries, but is required for those types.</P
       
 10634 -><P
       
 10635 ->Note: FREEFORM queries are a necessary evil; the simplistic query semantics
       
 10636 -of the UPDATE, INSERT, and SELECT type queries do not sufficiently expose
       
 10637 -the capabilities of most backend databases. At the same time, using a
       
 10638 -FREEFORM query makes it impossible for mod_sql to check whether the query
       
 10639 -type is appropriate, making sure that a SELECT query is not used in a SQLLog
       
 10640 -directive, for instance. Wherever possible, it is recommended that a specific
       
 10641 -query type be used.</P
       
 10642 -></DIV
       
 10643 -><DIV
       
 10644 -CLASS="REFSECT1"
       
 10645 -><A
       
 10646 -NAME="AEN9388"
       
 10647 -></A
       
 10648 -><H2
       
 10649 ->See also</H2
       
 10650 -><P
       
 10651 -><A
       
 10652 -HREF="#SQLSHOWINFO"
       
 10653 ->SQLShowInfo</A
       
 10654 ->
       
 10655 -<A
       
 10656 -HREF="#SQLLOG"
       
 10657 ->SQLLog</A
       
 10658 ->
       
 10659 -<A
       
 10660 -HREF="#LOGFORMAT"
       
 10661 ->LogFormat</A
       
 10662 ->
       
 10663 -<A
       
 10664 -HREF="#EXTENDEDLOG"
       
 10665 ->ExtendedLog</A
       
 10666 -></P
       
 10667 -></DIV
       
 10668 -><DIV
       
 10669 -CLASS="REFSECT1"
       
 10670 -><A
       
 10671 -NAME="AEN9395"
       
 10672 -></A
       
 10673 -><H2
       
 10674 ->Examples</H2
       
 10675 -><P
       
 10676 -CLASS="LITERALLAYOUT"
       
 10677 ->SQLNamedQuery&nbsp;count&nbsp;SELECT&nbsp;"count&nbsp;from&nbsp;users&nbsp;where&nbsp;userid='%u'"</P
       
 10678 -><P
       
 10679 ->creates a query named "count" which could be used by SQLShowInfo to inform
       
 10680 -a user of their login count. The actual query would look something like
       
 10681 -"SELECT count FROM users WHERE userid='matilda'" for user "matilda".</P
       
 10682 -><P
       
 10683 -CLASS="LITERALLAYOUT"
       
 10684 ->SQLNamedQuery&nbsp;updatecount&nbsp;UPDATE&nbsp;"count=count+1&nbsp;WHERE&nbsp;userid='%u'"&nbsp;users</P
       
 10685 -><P
       
 10686 ->creates a query named "updatecount" which could be used by SQLLog to update
       
 10687 -a user login counter in the table users. The actual query would look something
       
 10688 -like "UPDATE users SET count=count+1 WHERE userid='persephone'" for user
       
 10689 -"persephone".</P
       
 10690 -><P
       
 10691 -CLASS="LITERALLAYOUT"
       
 10692 ->SQLNamedQuery&nbsp;accesslog&nbsp;INSERT&nbsp;"now(),&nbsp;'%u'"&nbsp;accesslog</P
       
 10693 -><P
       
 10694 ->creates a query named "accesslog" which could be used by SQLLog to track
       
 10695 -access times by clients. The actual query would look something like "INSERT
       
 10696 -INTO accesslog VALUES (now(), 'pandora')" for user "pandora". Note that this
       
 10697 -may be too simplistic for your table structure, since most databases require
       
 10698 -data for all columns to be provided in an INSERT statement of this form. See
       
 10699 -the following FREEFORM query for an example of something which may suit your
       
 10700 -needs better.</P
       
 10701 -><P
       
 10702 -CLASS="LITERALLAYOUT"
       
 10703 ->SQLNamedQuery&nbsp;accesslog&nbsp;FREEFORM&nbsp;"INSERT&nbsp;INTO&nbsp;accesslog(date,&nbsp;user)&nbsp;VALUES&nbsp;(now(),&nbsp;'%u')"</P
       
 10704 -><P
       
 10705 ->creates a query named "accesslog" which could be used by SQLLog to track
       
 10706 -access times by clients. The actual query would look something like "INSERT
       
 10707 -INTO accesslog(date, user) VALUES (now(), 'tilda')" for user "tilda".</P
       
 10708 -></DIV
       
 10709 -><H1
       
 10710 -><A
       
 10711 -NAME="SQLNEGATIVECACHE"
       
 10712 -></A
       
 10713 ->
       
 10714 -			SQLNegativeCache</H1
       
 10715 -><DIV
       
 10716 -CLASS="REFNAMEDIV"
       
 10717 -><A
       
 10718 -NAME="AEN9413"
       
 10719 -></A
       
 10720 -><H2
       
 10721 ->Name</H2
       
 10722 ->SQLNegativeCache&nbsp;--&nbsp;Enable negative caching for SQL lookups</DIV
       
 10723 -><DIV
       
 10724 -CLASS="REFSYNOPSISDIV"
       
 10725 -><A
       
 10726 -NAME="AEN9416"
       
 10727 -></A
       
 10728 -><H2
       
 10729 ->Synopsis</H2
       
 10730 -><P
       
 10731 -><B
       
 10732 -CLASS="COMMAND"
       
 10733 ->SQLNegativeCache</B
       
 10734 ->  [				<CODE
       
 10735 -CLASS="OPTION"
       
 10736 ->on</CODE
       
 10737 ->
       
 10738 -				<CODE
       
 10739 -CLASS="OPTION"
       
 10740 ->off</CODE
       
 10741 ->
       
 10742 -			]</P
       
 10743 -><P
       
 10744 -></P
       
 10745 -><DIV
       
 10746 -CLASS="VARIABLELIST"
       
 10747 -><P
       
 10748 -><B
       
 10749 -></B
       
 10750 -></P
       
 10751 -><DL
       
 10752 -><DT
       
 10753 -><PRE
       
 10754 -CLASS="SYNOPSIS"
       
 10755 ->Default</PRE
       
 10756 -></DT
       
 10757 -><DD
       
 10758 -><P
       
 10759 ->				SQLNegativeCache off
       
 10760 -			</P
       
 10761 -></DD
       
 10762 -><DT
       
 10763 -><PRE
       
 10764 -CLASS="SYNOPSIS"
       
 10765 ->Context</PRE
       
 10766 -></DT
       
 10767 -><DD
       
 10768 -><P
       
 10769 ->				server config, &lt;VirtualHost&gt;, &lt;Global&gt;
       
 10770 -			</P
       
 10771 -></DD
       
 10772 -><DT
       
 10773 -><PRE
       
 10774 -CLASS="SYNOPSIS"
       
 10775 ->Module</PRE
       
 10776 -></DT
       
 10777 -><DD
       
 10778 -><P
       
 10779 ->mod_sql
       
 10780 -			</P
       
 10781 -></DD
       
 10782 -><DT
       
 10783 -><PRE
       
 10784 -CLASS="SYNOPSIS"
       
 10785 ->Compatibility</PRE
       
 10786 -></DT
       
 10787 -><DD
       
 10788 -><P
       
 10789 ->				mod_sql v4.10 and later
       
 10790 -			</P
       
 10791 -></DD
       
 10792 -></DL
       
 10793 -></DIV
       
 10794 -></DIV
       
 10795 -><DIV
       
 10796 -CLASS="REFSECT1"
       
 10797 -><A
       
 10798 -NAME="AEN9444"
       
 10799 -></A
       
 10800 -><H2
       
 10801 ->Description</H2
       
 10802 -><P
       
 10803 ->SQLNegativeCache specifies whether or not to cache negative
       
 10804 -		responses from SQL lookups when using SQL for UID/GID lookups.
       
 10805 -		Depending on your SQL tables, there can be a significant delay
       
 10806 -                when a directory listing is performed as the UIDs not in the
       
 10807 -                SQL database are repeatedly looked up in an attempt to present
       
 10808 -                usernames instead of UIDs in directory listings. With
       
 10809 -                SQLNegativeCache set to on, negative ("not found") responses from
       
 10810 -		SQL queries will be cached and speed will improve on directory
       
 10811 -		listings that contain many users not present in the SQL
       
 10812 -		database.</P
       
 10813 -></DIV
       
 10814 -><DIV
       
 10815 -CLASS="REFSECT1"
       
 10816 -><A
       
 10817 -NAME="AEN9447"
       
 10818 -></A
       
 10819 -><H2
       
 10820 ->See also</H2
       
 10821 -><P
       
 10822 -></P
       
 10823 -></DIV
       
 10824 -><DIV
       
 10825 -CLASS="REFSECT1"
       
 10826 -><A
       
 10827 -NAME="AEN9450"
       
 10828 -></A
       
 10829 -><H2
       
 10830 ->Examples</H2
       
 10831 -><P
       
 10832 -></P
       
 10833 -></DIV
       
 10834 -><H1
       
 10835 -><A
       
 10836 -NAME="SQLRATIOS"
       
 10837 -></A
       
 10838 ->
       
 10839 -SQLRatios</H1
       
 10840 -><DIV
       
 10841 -CLASS="REFNAMEDIV"
       
 10842 -><A
       
 10843 -NAME="AEN9461"
       
 10844 -></A
       
 10845 -><H2
       
 10846 ->Name</H2
       
 10847 ->SQLRatios&nbsp;--&nbsp;(docs incomplete)</DIV
       
 10848 -><DIV
       
 10849 -CLASS="REFSYNOPSISDIV"
       
 10850 -><A
       
 10851 -NAME="AEN9464"
       
 10852 -></A
       
 10853 -><H2
       
 10854 ->Synopsis</H2
       
 10855 -><P
       
 10856 -><B
       
 10857 -CLASS="COMMAND"
       
 10858 ->SQLRatios</B
       
 10859 ->  [  <CODE
       
 10860 -CLASS="OPTION"
       
 10861 ->"name" limit|regex|ip value</CODE
       
 10862 ->]</P
       
 10863 -><P
       
 10864 -></P
       
 10865 -><DIV
       
 10866 -CLASS="VARIABLELIST"
       
 10867 -><P
       
 10868 -><B
       
 10869 -></B
       
 10870 -></P
       
 10871 -><DL
       
 10872 -><DT
       
 10873 -><PRE
       
 10874 -CLASS="SYNOPSIS"
       
 10875 ->Default</PRE
       
 10876 -></DT
       
 10877 -><DD
       
 10878 -><P
       
 10879 ->None</P
       
 10880 -></DD
       
 10881 -><DT
       
 10882 -><PRE
       
 10883 -CLASS="SYNOPSIS"
       
 10884 ->Context</PRE
       
 10885 -></DT
       
 10886 -><DD
       
 10887 -><P
       
 10888 ->server config, &lt;Global&gt;</P
       
 10889 -></DD
       
 10890 -><DT
       
 10891 -><PRE
       
 10892 -CLASS="SYNOPSIS"
       
 10893 ->Module</PRE
       
 10894 -></DT
       
 10895 -><DD
       
 10896 -><P
       
 10897 ->mod_sql</P
       
 10898 -></DD
       
 10899 -><DT
       
 10900 -><PRE
       
 10901 -CLASS="SYNOPSIS"
       
 10902 ->Compatibility</PRE
       
 10903 -></DT
       
 10904 -><DD
       
 10905 -><P
       
 10906 ->1.2.5rc1 and later</P
       
 10907 -></DD
       
 10908 -></DL
       
 10909 -></DIV
       
 10910 -></DIV
       
 10911 -><DIV
       
 10912 -CLASS="REFSECT1"
       
 10913 -><A
       
 10914 -NAME="AEN9491"
       
 10915 -></A
       
 10916 -><H2
       
 10917 ->Description</H2
       
 10918 -><P
       
 10919 ->mod_ratio is currently lacking a module maintainer. This directive is 
       
 10920 -left over and not officially supported.</P
       
 10921 -></DIV
       
 10922 -><DIV
       
 10923 -CLASS="REFSECT1"
       
 10924 -><A
       
 10925 -NAME="AEN9494"
       
 10926 -></A
       
 10927 -><H2
       
 10928 ->See also</H2
       
 10929 -><P
       
 10930 -></P
       
 10931 -></DIV
       
 10932 -><DIV
       
 10933 -CLASS="REFSECT1"
       
 10934 -><A
       
 10935 -NAME="AEN9497"
       
 10936 -></A
       
 10937 -><H2
       
 10938 ->Examples</H2
       
 10939 -><P
       
 10940 -CLASS="LITERALLAYOUT"
       
 10941 ->(docs&nbsp;incomplete)</P
       
 10942 -></DIV
       
 10943 -><H1
       
 10944 -><A
       
 10945 -NAME="SQLRATIOSTATS"
       
 10946 -></A
       
 10947 ->
       
 10948 -SQLRatioStats</H1
       
 10949 -><DIV
       
 10950 -CLASS="REFNAMEDIV"
       
 10951 -><A
       
 10952 -NAME="AEN9508"
       
 10953 -></A
       
 10954 -><H2
       
 10955 ->Name</H2
       
 10956 ->SQLRatioStats&nbsp;--&nbsp;(docs incomplete)</DIV
       
 10957 -><DIV
       
 10958 -CLASS="REFSYNOPSISDIV"
       
 10959 -><A
       
 10960 -NAME="AEN9511"
       
 10961 -></A
       
 10962 -><H2
       
 10963 ->Synopsis</H2
       
 10964 -><P
       
 10965 -><B
       
 10966 -CLASS="COMMAND"
       
 10967 ->SQLRatioStats</B
       
 10968 ->  [  <CODE
       
 10969 -CLASS="OPTION"
       
 10970 ->"name" limit|regex|ip value</CODE
       
 10971 ->]</P
       
 10972 -><P
       
 10973 -></P
       
 10974 -><DIV
       
 10975 -CLASS="VARIABLELIST"
       
 10976 -><P
       
 10977 -><B
       
 10978 -></B
       
 10979 -></P
       
 10980 -><DL
       
 10981 -><DT
       
 10982 -><PRE
       
 10983 -CLASS="SYNOPSIS"
       
 10984 ->Default</PRE
       
 10985 -></DT
       
 10986 -><DD
       
 10987 -><P
       
 10988 ->None</P
       
 10989 -></DD
       
 10990 -><DT
       
 10991 -><PRE
       
 10992 -CLASS="SYNOPSIS"
       
 10993 ->Context</PRE
       
 10994 -></DT
       
 10995 -><DD
       
 10996 -><P
       
 10997 ->server config, &lt;Global&gt;</P
       
 10998 -></DD
       
 10999 -><DT
       
 11000 -><PRE
       
 11001 -CLASS="SYNOPSIS"
       
 11002 ->Module</PRE
       
 11003 -></DT
       
 11004 -><DD
       
 11005 -><P
       
 11006 ->mod_sql</P
       
 11007 -></DD
       
 11008 -><DT
       
 11009 -><PRE
       
 11010 -CLASS="SYNOPSIS"
       
 11011 ->Compatibility</PRE
       
 11012 -></DT
       
 11013 -><DD
       
 11014 -><P
       
 11015 ->1.2.5rc1 and later</P
       
 11016 -></DD
       
 11017 -></DL
       
 11018 -></DIV
       
 11019 -></DIV
       
 11020 -><DIV
       
 11021 -CLASS="REFSECT1"
       
 11022 -><A
       
 11023 -NAME="AEN9538"
       
 11024 -></A
       
 11025 -><H2
       
 11026 ->Description</H2
       
 11027 -><P
       
 11028 ->mod_ratio is currently lacking a module maintainer. This directive is
       
 11029 -left over and not officially supported.</P
       
 11030 -></DIV
       
 11031 -><DIV
       
 11032 -CLASS="REFSECT1"
       
 11033 -><A
       
 11034 -NAME="AEN9541"
       
 11035 -></A
       
 11036 -><H2
       
 11037 ->See also</H2
       
 11038 -><P
       
 11039 -></P
       
 11040 -></DIV
       
 11041 -><DIV
       
 11042 -CLASS="REFSECT1"
       
 11043 -><A
       
 11044 -NAME="AEN9544"
       
 11045 -></A
       
 11046 -><H2
       
 11047 ->Examples</H2
       
 11048 -><P
       
 11049 -CLASS="LITERALLAYOUT"
       
 11050 ->(docs&nbsp;incomplete)</P
       
 11051 -></DIV
       
 11052 -><H1
       
 11053 -><A
       
 11054 -NAME="SQLSHOWINFO"
       
 11055 -></A
       
 11056 ->
       
 11057 -SQLShowInfo</H1
       
 11058 -><DIV
       
 11059 -CLASS="REFNAMEDIV"
       
 11060 -><A
       
 11061 -NAME="AEN9555"
       
 11062 -></A
       
 11063 -><H2
       
 11064 ->Name</H2
       
 11065 ->SQLShowInfo&nbsp;--&nbsp;Create a message to be sent to the user after any successful command</DIV
       
 11066 -><DIV
       
 11067 -CLASS="REFSYNOPSISDIV"
       
 11068 -><A
       
 11069 -NAME="AEN9558"
       
 11070 -></A
       
 11071 -><H2
       
 11072 ->Synopsis</H2
       
 11073 -><P
       
 11074 -><B
       
 11075 -CLASS="COMMAND"
       
 11076 ->SQLShowInfo</B
       
 11077 ->  [  <CODE
       
 11078 -CLASS="OPTION"
       
 11079 ->cmd-set numeric query-string</CODE
       
 11080 ->]</P
       
 11081 -><P
       
 11082 -></P
       
 11083 -><DIV
       
 11084 -CLASS="VARIABLELIST"
       
 11085 -><P
       
 11086 -><B
       
 11087 -></B
       
 11088 -></P
       
 11089 -><DL
       
 11090 -><DT
       
 11091 -><PRE
       
 11092 -CLASS="SYNOPSIS"
       
 11093 ->Default</PRE
       
 11094 -></DT
       
 11095 -><DD
       
 11096 -><P
       
 11097 ->None</P
       
 11098 -></DD
       
 11099 -><DT
       
 11100 -><PRE
       
 11101 -CLASS="SYNOPSIS"
       
 11102 ->Context</PRE
       
 11103 -></DT
       
 11104 -><DD
       
 11105 -><P
       
 11106 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 11107 -></DD
       
 11108 -><DT
       
 11109 -><PRE
       
 11110 -CLASS="SYNOPSIS"
       
 11111 ->Module</PRE
       
 11112 -></DT
       
 11113 -><DD
       
 11114 -><P
       
 11115 ->mod_sql</P
       
 11116 -></DD
       
 11117 -><DT
       
 11118 -><PRE
       
 11119 -CLASS="SYNOPSIS"
       
 11120 ->Compatibility</PRE
       
 11121 -></DT
       
 11122 -><DD
       
 11123 -><P
       
 11124 ->1.2.5rc1 and later</P
       
 11125 -></DD
       
 11126 -></DL
       
 11127 -></DIV
       
 11128 -></DIV
       
 11129 -><DIV
       
 11130 -CLASS="REFSECT1"
       
 11131 -><A
       
 11132 -NAME="AEN9585"
       
 11133 -></A
       
 11134 -><H2
       
 11135 ->Description</H2
       
 11136 -><P
       
 11137 ->This directive creates a message to be sent to the user after any successful
       
 11138 -command.</P
       
 11139 -><P
       
 11140 ->The first parameter, the cmd-set, is a comma separated (no spaces) list of
       
 11141 -FTP commands for which this log command will trigger. The list of commands
       
 11142 -is too long to list in entirety; commands include: CWD, DELE, HELP, LIST,
       
 11143 -MKD, MODE, NLST, PASS, PASV, PORT and many more. For the complete list check
       
 11144 -the FTP RFCs.</P
       
 11145 -><P
       
 11146 ->FTP commands in the command set will only be triggered if they complete
       
 11147 -successfully. Prefixing any command with "ERR_" will show information only
       
 11148 -if there was an error in command processing. To send a message on both
       
 11149 -errors and successfull completion of a given command X, therefore, you'll
       
 11150 -need both "X" and "ERR_X" in your cmd-set.</P
       
 11151 -><P
       
 11152 ->The special command "*" matches all FTP commands, while "ERR_*" matches
       
 11153 -all errors.</P
       
 11154 -><P
       
 11155 ->The second parameter, numeric, specifies the numeric value of the message
       
 11156 -returned to the FTP client. Do not choose a number blindly: message numbers
       
 11157 -may be parsed by clients. In most cases you will want to use 214, the "Help
       
 11158 -message" numeric. It specifies that the information is only meant to be human
       
 11159 -readable.</P
       
 11160 -><P
       
 11161 ->The third parameter, query-string, is exactly equivalent to the query-string
       
 11162 -parameter to the SQLLog directive, with one addition:</P
       
 11163 -><P
       
 11164 -></P
       
 11165 -><UL
       
 11166 -><LI
       
 11167 -STYLE="list-style-type: disc"
       
 11168 -><P
       
 11169 ->%{name}</P
       
 11170 -><P
       
 11171 ->The first return value from the SQLNamedQuery  identified by "name". There
       
 11172 -is currently no way to retrieve more than one value from the database at
       
 11173 -a time.</P
       
 11174 -></LI
       
 11175 -></UL
       
 11176 -><P
       
 11177 ->Any references to non-existent named queries, non-SELECT or -FREEFORM type
       
 11178 -queries, or references to queries which return a NULL first value, will be
       
 11179 -replaced with the string "{null}".</P
       
 11180 -></DIV
       
 11181 -><DIV
       
 11182 -CLASS="REFSECT1"
       
 11183 -><A
       
 11184 -NAME="AEN9598"
       
 11185 -></A
       
 11186 -><H2
       
 11187 ->See also</H2
       
 11188 -><P
       
 11189 -></P
       
 11190 -></DIV
       
 11191 -><DIV
       
 11192 -CLASS="REFSECT1"
       
 11193 -><A
       
 11194 -NAME="AEN9601"
       
 11195 -></A
       
 11196 -><H2
       
 11197 ->Examples</H2
       
 11198 -><P
       
 11199 -CLASS="LITERALLAYOUT"
       
 11200 ->&nbsp;&nbsp;SQLNamedQuery&nbsp;count&nbsp;SELECT&nbsp;"count&nbsp;from&nbsp;users&nbsp;where&nbsp;userid='%u'"<br>
       
 11201 -&nbsp;&nbsp;SQLShowInfo&nbsp;PASS&nbsp;"230"&nbsp;"You've&nbsp;logged&nbsp;on&nbsp;%{count}&nbsp;times,&nbsp;%u"</P
       
 11202 -><P
       
 11203 ->As long as the information is in the database, these two directives specify
       
 11204 -that the user will be greeted with their login count each time they
       
 11205 -successfully login. Note the use of the "230" numeric, which means "User
       
 11206 -logged in, proceed". "230" is appropriate in this case because the message
       
 11207 -will be sent immediately after their password has been accepted and the
       
 11208 -session has started.</P
       
 11209 -></DIV
       
 11210 -><H1
       
 11211 -><A
       
 11212 -NAME="SQLUSERINFO"
       
 11213 -></A
       
 11214 ->
       
 11215 -SQLUserInfo</H1
       
 11216 -><DIV
       
 11217 -CLASS="REFNAMEDIV"
       
 11218 -><A
       
 11219 -NAME="AEN9613"
       
 11220 -></A
       
 11221 -><H2
       
 11222 ->Name</H2
       
 11223 ->SQLUserInfo&nbsp;--&nbsp;Configure the user table and fields that hold user information</DIV
       
 11224 -><DIV
       
 11225 -CLASS="REFSYNOPSISDIV"
       
 11226 -><A
       
 11227 -NAME="AEN9616"
       
 11228 -></A
       
 11229 -><H2
       
 11230 ->Synopsis</H2
       
 11231 -><P
       
 11232 -><B
       
 11233 -CLASS="COMMAND"
       
 11234 ->SQLUserInfo</B
       
 11235 ->  [  <CODE
       
 11236 -CLASS="OPTION"
       
 11237 ->user-table user-name passwd uid gid home-dir shell</CODE
       
 11238 ->]</P
       
 11239 -><P
       
 11240 -></P
       
 11241 -><DIV
       
 11242 -CLASS="VARIABLELIST"
       
 11243 -><P
       
 11244 -><B
       
 11245 -></B
       
 11246 -></P
       
 11247 -><DL
       
 11248 -><DT
       
 11249 -><PRE
       
 11250 -CLASS="SYNOPSIS"
       
 11251 ->Default</PRE
       
 11252 -></DT
       
 11253 -><DD
       
 11254 -><P
       
 11255 ->&quot;users userid passwd uid gid homedir shell&quot;</P
       
 11256 -></DD
       
 11257 -><DT
       
 11258 -><PRE
       
 11259 -CLASS="SYNOPSIS"
       
 11260 ->Context</PRE
       
 11261 -></DT
       
 11262 -><DD
       
 11263 -><P
       
 11264 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 11265 -></DD
       
 11266 -><DT
       
 11267 -><PRE
       
 11268 -CLASS="SYNOPSIS"
       
 11269 ->Module</PRE
       
 11270 -></DT
       
 11271 -><DD
       
 11272 -><P
       
 11273 ->mod_sql</P
       
 11274 -></DD
       
 11275 -><DT
       
 11276 -><PRE
       
 11277 -CLASS="SYNOPSIS"
       
 11278 ->Compatibility</PRE
       
 11279 -></DT
       
 11280 -><DD
       
 11281 -><P
       
 11282 ->1.2.5rc1 and later</P
       
 11283 -></DD
       
 11284 -></DL
       
 11285 -></DIV
       
 11286 -></DIV
       
 11287 -><DIV
       
 11288 -CLASS="REFSECT1"
       
 11289 -><A
       
 11290 -NAME="AEN9643"
       
 11291 -></A
       
 11292 -><H2
       
 11293 ->Description</H2
       
 11294 -><P
       
 11295 ->The SQLUserInfo directive configures the user table and fields that hold
       
 11296 -user information. If you need to change any of these field names from the
       
 11297 -default, you must specify all of them, whether NULL or not. The parameters
       
 11298 -are described below:</P
       
 11299 -><P
       
 11300 -></P
       
 11301 -><UL
       
 11302 -><LI
       
 11303 -STYLE="list-style-type: disc"
       
 11304 -><P
       
 11305 ->usertable</P
       
 11306 -><P
       
 11307 ->Specifies the name of the table that holds user information.</P
       
 11308 -></LI
       
 11309 -><LI
       
 11310 -STYLE="list-style-type: disc"
       
 11311 -><P
       
 11312 ->username</P
       
 11313 -><P
       
 11314 ->Specifies the field in the user table that holds the username.</P
       
 11315 -></LI
       
 11316 -><LI
       
 11317 -STYLE="list-style-type: disc"
       
 11318 -><P
       
 11319 ->passwd</P
       
 11320 -><P
       
 11321 ->Specifies the field in the user table that holds the user's password.</P
       
 11322 -></LI
       
 11323 -><LI
       
 11324 -STYLE="list-style-type: disc"
       
 11325 -><P
       
 11326 ->uid</P
       
 11327 -><P
       
 11328 ->Specifies the field in the user table that holds the user's UID. When a
       
 11329 -UID is retrieved from the database it is checked against the value of
       
 11330 -SQLMinUserUID. If the field name is specified as "NULL" the database will
       
 11331 -not be queried for this value and the user's UID will be set to the value
       
 11332 -of SQLDefaultUID.</P
       
 11333 -></LI
       
 11334 -><LI
       
 11335 -STYLE="list-style-type: disc"
       
 11336 -><P
       
 11337 ->gid</P
       
 11338 -><P
       
 11339 ->Specifies the field in the user table that holds the user's GID. When a GID
       
 11340 -is retrieved from the database it is checked against the value of
       
 11341 -SQLMinUserGID. If the field name is specified as "NULL" the database will
       
 11342 -not be queried for this value and the user's GID will be set to the value
       
 11343 -of SQLDefaultGID.</P
       
 11344 -></LI
       
 11345 -><LI
       
 11346 -STYLE="list-style-type: disc"
       
 11347 -><P
       
 11348 ->homedir</P
       
 11349 -><P
       
 11350 ->Specifies the field in the user table that holds the user's home directory.
       
 11351 -If the fieldname is specified as "NULL" the database will not be queried for
       
 11352 -this value and the user's home directory will be set to the value of
       
 11353 -SQLDefaultHomedir. If no home directory is set with either directive, user
       
 11354 -authentication will be automatically turned off.</P
       
 11355 -></LI
       
 11356 -><LI
       
 11357 -STYLE="list-style-type: disc"
       
 11358 -><P
       
 11359 ->shell</P
       
 11360 -><P
       
 11361 ->Specifies the field in the user table that holds the user's shell. If the 
       
 11362 -fieldname is specified as "NULL" the database will not be queried and the
       
 11363 -shell will be reported as an empty string ("").</P
       
 11364 -></LI
       
 11365 -></UL
       
 11366 -><P
       
 11367 ->As of 1.2.9rc1, the SQLUserInfo directive accepts an alternate syntax:</P
       
 11368 -><P
       
 11369 -CLASS="LITERALLAYOUT"
       
 11370 ->&nbsp;&nbsp;SQLUserInfo&nbsp;custom:/name</P
       
 11371 -><P
       
 11372 ->where name refers to a configured SELECT SQLNamedQuery. This named query
       
 11373 -must return one row, and return the following columns, in this order:
       
 11374 -username, passwd, uid, gid, homedir, shell. The configured query may make use
       
 11375 -of the variables mentioned in the SQLLog description. This syntax allows the
       
 11376 -administrator a flexible way of constructing queries as needed. Note that if
       
 11377 -you want use the given USER name, you should use the %U variable, not %u; the
       
 11378 -latter requires the locally authenticated user name, which is exactly what
       
 11379 -SQLUserInfo is meant to provide.</P
       
 11380 -></DIV
       
 11381 -><DIV
       
 11382 -CLASS="REFSECT1"
       
 11383 -><A
       
 11384 -NAME="AEN9671"
       
 11385 -></A
       
 11386 -><H2
       
 11387 ->See also</H2
       
 11388 -><P
       
 11389 -><A
       
 11390 -HREF="#SQLLOG"
       
 11391 ->SQLLog</A
       
 11392 ->
       
 11393 -<A
       
 11394 -HREF="#SQLNAMEDQUERY"
       
 11395 ->SQLNamedQuery</A
       
 11396 -></P
       
 11397 -></DIV
       
 11398 -><DIV
       
 11399 -CLASS="REFSECT1"
       
 11400 -><A
       
 11401 -NAME="AEN9676"
       
 11402 -></A
       
 11403 -><H2
       
 11404 ->Examples</H2
       
 11405 -><P
       
 11406 -CLASS="LITERALLAYOUT"
       
 11407 -></P
       
 11408 -></DIV
       
 11409 -><H1
       
 11410 -><A
       
 11411 -NAME="SQLUSERWHERECLAUSE"
       
 11412 -></A
       
 11413 ->
       
 11414 -SQLUserWhereClause</H1
       
 11415 -><DIV
       
 11416 -CLASS="REFNAMEDIV"
       
 11417 -><A
       
 11418 -NAME="AEN9687"
       
 11419 -></A
       
 11420 -><H2
       
 11421 ->Name</H2
       
 11422 ->SQLUserWhereClause&nbsp;--&nbsp;Configure a WHERE clause for every user query&#60;</DIV
       
 11423 -><DIV
       
 11424 -CLASS="REFSYNOPSISDIV"
       
 11425 -><A
       
 11426 -NAME="AEN9690"
       
 11427 -></A
       
 11428 -><H2
       
 11429 ->Synopsis</H2
       
 11430 -><P
       
 11431 -><B
       
 11432 -CLASS="COMMAND"
       
 11433 ->SQLUserWhereClause</B
       
 11434 ->  [  <CODE
       
 11435 -CLASS="OPTION"
       
 11436 ->where-clause</CODE
       
 11437 ->]</P
       
 11438 -><P
       
 11439 -></P
       
 11440 -><DIV
       
 11441 -CLASS="VARIABLELIST"
       
 11442 -><P
       
 11443 -><B
       
 11444 -></B
       
 11445 -></P
       
 11446 -><DL
       
 11447 -><DT
       
 11448 -><PRE
       
 11449 -CLASS="SYNOPSIS"
       
 11450 ->Default</PRE
       
 11451 -></DT
       
 11452 -><DD
       
 11453 -><P
       
 11454 ->None</P
       
 11455 -></DD
       
 11456 -><DT
       
 11457 -><PRE
       
 11458 -CLASS="SYNOPSIS"
       
 11459 ->Context</PRE
       
 11460 -></DT
       
 11461 -><DD
       
 11462 -><P
       
 11463 ->server config, &lt;Global&gt;, &lt;VirtualHost&gt;</P
       
 11464 -></DD
       
 11465 -><DT
       
 11466 -><PRE
       
 11467 -CLASS="SYNOPSIS"
       
 11468 ->Module</PRE
       
 11469 -></DT
       
 11470 -><DD
       
 11471 -><P
       
 11472 ->mod_sql</P
       
 11473 -></DD
       
 11474 -><DT
       
 11475 -><PRE
       
 11476 -CLASS="SYNOPSIS"
       
 11477 ->Compatibility</PRE
       
 11478 -></DT
       
 11479 -><DD
       
 11480 -><P
       
 11481 ->1.2.5rc1 and later</P
       
 11482 -></DD
       
 11483 -></DL
       
 11484 -></DIV
       
 11485 -></DIV
       
 11486 -><DIV
       
 11487 -CLASS="REFSECT1"
       
 11488 -><A
       
 11489 -NAME="AEN9717"
       
 11490 -></A
       
 11491 -><H2
       
 11492 ->Description</H2
       
 11493 -><P
       
 11494 ->The directive is used to configure a WHERE clause that is added to every
       
 11495 -user query. The WHERE clause must contain all relevant punctuation, and
       
 11496 -must not contain a leading "and".</P
       
 11497 -><P
       
 11498 ->Starting with ProFTPD 1.3.1rc1 the SQLUserWhereClause also supports the
       
 11499 -variables supported by <A
       
 11500 -HREF="#SQLNAMEDQUERY"
       
 11501 ->SQLNamedQuery</A
       
 11502 ->
       
 11503 -except for the &quot;%{n}&quot; variable</P
       
 11504 -></DIV
       
 11505 -><DIV
       
 11506 -CLASS="REFSECT1"
       
 11507 -><A
       
 11508 -NAME="AEN9722"
       
 11509 -></A
       
 11510 -><H2
       
 11511 ->See also</H2
       
 11512 -><P
       
 11513 -><A
       
 11514 -HREF="#SQLNAMEDQUERY"
       
 11515 ->SQLNamedQuery</A
       
 11516 -></P
       
 11517 -></DIV
       
 11518 -><DIV
       
 11519 -CLASS="REFSECT1"
       
 11520 -><A
       
 11521 -NAME="AEN9726"
       
 11522 -></A
       
 11523 -><H2
       
 11524 ->Examples</H2
       
 11525 -><P
       
 11526 ->As an example of a possible use for this directive, imagine if your user
       
 11527 -table included a "LoginAllowed" field:</P
       
 11528 -><P
       
 11529 -CLASS="LITERALLAYOUT"
       
 11530 ->&nbsp;&nbsp;SQLUserWhereClause&nbsp;"LoginAllowed&nbsp;=&nbsp;'true'"</P
       
 11531 -><P
       
 11532 ->would be appended to every user-related query as the string:</P
       
 11533 -><P
       
 11534 -CLASS="LITERALLAYOUT"
       
 11535 ->&nbsp;&nbsp;"&nbsp;WHERE&nbsp;(LoginAllowed&nbsp;=&nbsp;'true')"</P
       
 11536 -></DIV
       
 11537 -><H1
       
 11538 -><A
       
 11539  NAME="STOREUNIQUEPREFIX"
       
 11540  ></A
       
 11541  >
       
 11542 @@ -30450,7 +19166,7 @@
       
 11543  ></A
       
 11544  ><H2
       
 11545  >Name</H2
       
 11546 ->TLSPassPhraseProvider&nbsp;--&nbsp;FIXFIXFIX</DIV
       
 11547 +>TLSPassPhraseProvider&nbsp;--&nbsp;Configure external provider for key</DIV
       
 11548  ><DIV
       
 11549  CLASS="REFSYNOPSISDIV"
       
 11550  ><A
       
 11551 @@ -31916,7 +20632,7 @@
       
 11552  ></A
       
 11553  ><H2
       
 11554  >Name</H2
       
 11555 ->UnsetEnv&nbsp;--&nbsp;(docs incomplete)</DIV
       
 11556 +>UnsetEnv&nbsp;--&nbsp;Unset environment variable</DIV
       
 11557  ><DIV
       
 11558  CLASS="REFSYNOPSISDIV"
       
 11559  ><A
       
 11560 @@ -33037,115 +21753,6 @@
       
 11561  ></DIV
       
 11562  ><H1
       
 11563  ><A
       
 11564 -NAME="USERRATIO"
       
 11565 -></A
       
 11566 ->
       
 11567 -UserRatio</H1
       
 11568 -><DIV
       
 11569 -CLASS="REFNAMEDIV"
       
 11570 -><A
       
 11571 -NAME="AEN12397"
       
 11572 -></A
       
 11573 -><H2
       
 11574 ->Name</H2
       
 11575 ->UserRatio&nbsp;--&nbsp;Ratio directive</DIV
       
 11576 -><DIV
       
 11577 -CLASS="REFSYNOPSISDIV"
       
 11578 -><A
       
 11579 -NAME="AEN12400"
       
 11580 -></A
       
 11581 -><H2
       
 11582 ->Synopsis</H2
       
 11583 -><P
       
 11584 -><B
       
 11585 -CLASS="COMMAND"
       
 11586 ->UserRatio</B
       
 11587 ->  [  <CODE
       
 11588 -CLASS="OPTION"
       
 11589 ->UserRatio foo1 foo2 foo3</CODE
       
 11590 ->]</P
       
 11591 -><P
       
 11592 -></P
       
 11593 -><DIV
       
 11594 -CLASS="VARIABLELIST"
       
 11595 -><P
       
 11596 -><B
       
 11597 -></B
       
 11598 -></P
       
 11599 -><DL
       
 11600 -><DT
       
 11601 -><PRE
       
 11602 -CLASS="SYNOPSIS"
       
 11603 ->Default</PRE
       
 11604 -></DT
       
 11605 -><DD
       
 11606 -><P
       
 11607 ->None known</P
       
 11608 -></DD
       
 11609 -><DT
       
 11610 -><PRE
       
 11611 -CLASS="SYNOPSIS"
       
 11612 ->Context</PRE
       
 11613 -></DT
       
 11614 -><DD
       
 11615 -><P
       
 11616 ->&lt;Directory&gt;, &lt;Anonymous&gt;, &lt;Limit&gt;,.ftpaccess</P
       
 11617 -></DD
       
 11618 -><DT
       
 11619 -><PRE
       
 11620 -CLASS="SYNOPSIS"
       
 11621 ->Module</PRE
       
 11622 -></DT
       
 11623 -><DD
       
 11624 -><P
       
 11625 ->mod_ratio</P
       
 11626 -></DD
       
 11627 -><DT
       
 11628 -><PRE
       
 11629 -CLASS="SYNOPSIS"
       
 11630 ->Compatibility</PRE
       
 11631 -></DT
       
 11632 -><DD
       
 11633 -><P
       
 11634 ->at least 1.2.0 and later</P
       
 11635 -></DD
       
 11636 -></DL
       
 11637 -></DIV
       
 11638 -></DIV
       
 11639 -><DIV
       
 11640 -CLASS="REFSECT1"
       
 11641 -><A
       
 11642 -NAME="AEN12427"
       
 11643 -></A
       
 11644 -><H2
       
 11645 ->Description</H2
       
 11646 -><P
       
 11647 ->The UserRatio directive ....
       
 11648 -Example:
       
 11649 -UserRatio</P
       
 11650 -></DIV
       
 11651 -><DIV
       
 11652 -CLASS="REFSECT1"
       
 11653 -><A
       
 11654 -NAME="AEN12430"
       
 11655 -></A
       
 11656 -><H2
       
 11657 ->See also</H2
       
 11658 -><P
       
 11659 -></P
       
 11660 -></DIV
       
 11661 -><DIV
       
 11662 -CLASS="REFSECT1"
       
 11663 -><A
       
 11664 -NAME="AEN12433"
       
 11665 -></A
       
 11666 -><H2
       
 11667 ->Examples</H2
       
 11668 -><P
       
 11669 -></P
       
 11670 -></DIV
       
 11671 -><H1
       
 11672 -><A
       
 11673  NAME="USESENDFILE"
       
 11674  ></A
       
 11675  >
       
 11676 @@ -34223,7 +22830,7 @@
       
 11677  ></A
       
 11678  ><H2
       
 11679  >Name</H2
       
 11680 ->mod_tls&nbsp;--&nbsp;Prevent information leak through timing attacks</DIV
       
 11681 +>mod_delay&nbsp;--&nbsp;Prevent information leak through timing attacks</DIV
       
 11682  ><DIV
       
 11683  CLASS="REFSYNOPSISDIV"
       
 11684  ><A
       
 11685 @@ -34301,167 +22908,6 @@
       
 11686  ></DIV
       
 11687  ><H1
       
 11688  ><A
       
 11689 -NAME="MOD-LDAP"
       
 11690 -></A
       
 11691 ->
       
 11692 -			mod_ldap</H1
       
 11693 -><DIV
       
 11694 -CLASS="REFNAMEDIV"
       
 11695 -><A
       
 11696 -NAME="AEN12810"
       
 11697 -></A
       
 11698 -><H2
       
 11699 ->Name</H2
       
 11700 ->mod_ldap&nbsp;--&nbsp;LDAP authentication support</DIV
       
 11701 -><DIV
       
 11702 -CLASS="REFSYNOPSISDIV"
       
 11703 -><A
       
 11704 -NAME="AEN12813"
       
 11705 -></A
       
 11706 -><H2
       
 11707 ->Synopsis</H2
       
 11708 -><P
       
 11709 -><B
       
 11710 -CLASS="COMMAND"
       
 11711 ->mod_ldap</B
       
 11712 -> </P
       
 11713 -></DIV
       
 11714 -><DIV
       
 11715 -CLASS="REFSECT1"
       
 11716 -><A
       
 11717 -NAME="AEN12816"
       
 11718 -></A
       
 11719 -><H2
       
 11720 ->Description</H2
       
 11721 -><P
       
 11722 ->		mod_ldap provides LDAP authentication support for ProFTPD. It
       
 11723 -		supports many features useful in "toaster" environments such as
       
 11724 -		default UID/GID and autocreation/autogeneration of home directories.
       
 11725 -	</P
       
 11726 -></DIV
       
 11727 -><DIV
       
 11728 -CLASS="REFSECT1"
       
 11729 -><A
       
 11730 -NAME="AEN12819"
       
 11731 -></A
       
 11732 -><H2
       
 11733 ->See also</H2
       
 11734 -><P
       
 11735 -><A
       
 11736 -HREF="#LDAPALIASDEREFERENCE"
       
 11737 ->LDAPAliasDereference</A
       
 11738 -> 
       
 11739 -<A
       
 11740 -HREF="#LDAPATTR"
       
 11741 ->LDAPAttr</A
       
 11742 -> 
       
 11743 -<A
       
 11744 -HREF="#LDAPAUTHBINDS"
       
 11745 ->LDAPAuthBinds</A
       
 11746 -> 
       
 11747 -<A
       
 11748 -HREF="#LDAPDEFAULTAUTHSCHEME"
       
 11749 ->LDAPDefaultAuthScheme</A
       
 11750 -> 
       
 11751 -<A
       
 11752 -HREF="#LDAPDEFAULTGID"
       
 11753 ->LDAPDefaultGID</A
       
 11754 -> 
       
 11755 -<A
       
 11756 -HREF="#LDAPDEFAULTUID"
       
 11757 ->LDAPDefaultUID</A
       
 11758 -> 
       
 11759 -<A
       
 11760 -HREF="#LDAPDNINFO"
       
 11761 ->LDAPDNInfo</A
       
 11762 -> 
       
 11763 -<A
       
 11764 -HREF="#LDAPDOAUTH"
       
 11765 ->LDAPDoAuth</A
       
 11766 -> 
       
 11767 -<A
       
 11768 -HREF="#LDAPDOGIDLOOKUPS"
       
 11769 ->LDAPDoGIDLookups</A
       
 11770 -> 
       
 11771 -<A
       
 11772 -HREF="#LDAPDOQUOTALOOKUPS"
       
 11773 ->LDAPDoQuotaLookups</A
       
 11774 -> 
       
 11775 -<A
       
 11776 -HREF="#LDAPDOUIDLOOKUPS"
       
 11777 ->LDAPDoUIDLookups</A
       
 11778 -> 
       
 11779 -<A
       
 11780 -HREF="#LDAPFORCEDEFAULTGID"
       
 11781 ->LDAPForceDefaultGID</A
       
 11782 -> 
       
 11783 -<A
       
 11784 -HREF="#LDAPFORCEDEFAULTUID"
       
 11785 ->LDAPForceDefaultUID</A
       
 11786 -> 
       
 11787 -<A
       
 11788 -HREF="#LDAPFORCEGENERATEDHOMEDIR"
       
 11789 ->LDAPForceGeneratedHomedir</A
       
 11790 -> 
       
 11791 -<A
       
 11792 -HREF="#LDAPFORCEHOMEDIRONDEMAND"
       
 11793 ->LDAPForceHomedirOnDemand</A
       
 11794 -> 
       
 11795 -<A
       
 11796 -HREF="#LDAPGENERATEHOMEDIR"
       
 11797 ->LDAPGenerateHomedir</A
       
 11798 -> 
       
 11799 -<A
       
 11800 -HREF="#LDAPGENERATEHOMEDIRPREFIX"
       
 11801 ->LDAPGenerateHomedirPrefix</A
       
 11802 -> 
       
 11803 -<A
       
 11804 -HREF="#LDAPGENERATEHOMEDIRPREFIXNOUSERNAME"
       
 11805 ->LDAPGenerateHomedirPrefixNoUsername</A
       
 11806 -> 
       
 11807 -<A
       
 11808 -HREF="#LDAPHOMEDIRONDEMAND"
       
 11809 ->LDAPHomedirOnDemand</A
       
 11810 -> 
       
 11811 -<A
       
 11812 -HREF="#LDAPHOMEDIRONDEMANDPREFIX"
       
 11813 ->LDAPHomedirOnDemandPrefix</A
       
 11814 -> 
       
 11815 -<A
       
 11816 -HREF="#LDAPHOMEDIRONDEMANDPREFIXNOUSERNAME"
       
 11817 ->LDAPHomedirOnDemandPrefixNoUsername</A
       
 11818 -> 
       
 11819 -<A
       
 11820 -HREF="#LDAPHOMEDIRONDEMANDSUFFIX"
       
 11821 ->LDAPHomedirOnDemandSuffix</A
       
 11822 -> 
       
 11823 -<A
       
 11824 -HREF="#LDAPNEGATIVECACHE"
       
 11825 ->LDAPNegativeCache</A
       
 11826 -> 
       
 11827 -<A
       
 11828 -HREF="#LDAPPROTOCOLVERSION"
       
 11829 ->LDAPProtocolVersion</A
       
 11830 -> 
       
 11831 -<A
       
 11832 -HREF="#LDAPQUERYTIMEOUT"
       
 11833 ->LDAPQueryTimeout</A
       
 11834 -> 
       
 11835 -<A
       
 11836 -HREF="#LDAPSEARCHSCOPE"
       
 11837 ->LDAPSearchScope</A
       
 11838 -> 
       
 11839 -<A
       
 11840 -HREF="#LDAPSERVER"
       
 11841 ->LDAPServer</A
       
 11842 -> 
       
 11843 -<A
       
 11844 -HREF="#LDAPUSETLS"
       
 11845 ->LDAPUseTLS</A
       
 11846 -> </P
       
 11847 -></DIV
       
 11848 -><H1
       
 11849 -><A
       
 11850  NAME="MOD-LOG"
       
 11851  ></A
       
 11852  >
       
 11853 @@ -34600,427 +23046,6 @@
       
 11854  ></DIV
       
 11855  ><H1
       
 11856  ><A
       
 11857 -NAME="MOD-RADIUS"
       
 11858 -></A
       
 11859 ->
       
 11860 -mod_radius</H1
       
 11861 -><DIV
       
 11862 -CLASS="REFNAMEDIV"
       
 11863 -><A
       
 11864 -NAME="AEN12900"
       
 11865 -></A
       
 11866 -><H2
       
 11867 ->Name</H2
       
 11868 ->mod_radius&nbsp;--&nbsp;RADIUS based authentication support</DIV
       
 11869 -><DIV
       
 11870 -CLASS="REFSYNOPSISDIV"
       
 11871 -><A
       
 11872 -NAME="AEN12903"
       
 11873 -></A
       
 11874 -><H2
       
 11875 ->Synopsis</H2
       
 11876 -><P
       
 11877 -><B
       
 11878 -CLASS="COMMAND"
       
 11879 ->mod_radius</B
       
 11880 -> </P
       
 11881 -></DIV
       
 11882 -><DIV
       
 11883 -CLASS="REFSECT1"
       
 11884 -><A
       
 11885 -NAME="AEN12906"
       
 11886 -></A
       
 11887 -><H2
       
 11888 ->Description</H2
       
 11889 -><P
       
 11890 ->This module provides RADIUS authentication and accounting support.</P
       
 11891 -><P
       
 11892 ->Strong authentication is in demand for Internet services. For many, this means using the RADIUS (Remote Authentication Dial-In User Service) protocol.</P
       
 11893 -><P
       
 11894 ->However, there are caveats to using RADIUS for authentication. RADIUS packets are sent in the clear, which means that they can easily be sniffed. First, do not have your authenticating RADIUS servers exposed to the Internet; keep them protected within your LAN. Second, it is highly recommended to use separate RADIUS servers for each of your services.</P
       
 11895 -></DIV
       
 11896 -><DIV
       
 11897 -CLASS="REFSECT1"
       
 11898 -><A
       
 11899 -NAME="AEN12911"
       
 11900 -></A
       
 11901 -><H2
       
 11902 ->RADIUS Authentication</H2
       
 11903 -><P
       
 11904 ->The RADIUS protocol can be used for answering the question "Should this user be allowed to login?" However, the "yes/no" answer is not everything that proftpd needs to log a user in; the server also requires the UID and GID to use for the authenticated user, home directory, and shell. This information is usually not available from the RADIUS servers, which means that using RADIUS to provide all the necessary login information can be problematic. The RadiusUserInfo directive is meant to be used to address this issue, to provide the missing information.</P
       
 11905 -><P
       
 11906 ->In those cases where the RADIUS servers can provide that additional login information, via custom attributes, the RadiusUserInfo directive can also be used obtain that information as well.</P
       
 11907 -></DIV
       
 11908 -><DIV
       
 11909 -CLASS="REFSECT1"
       
 11910 -><A
       
 11911 -NAME="AEN12915"
       
 11912 -></A
       
 11913 -><H2
       
 11914 ->RADIUS Accounting</H2
       
 11915 -><P
       
 11916 ->While RADIUS is primarily used for authentication, the protocol also allows for accounting of user activities. The mod_radius module makes use of this ability, using RADIUS accounting packets to transmit the following data:</P
       
 11917 -><P
       
 11918 ->    * Acct-Authentic: How the user was authenticated (e.g. locally, or via RADIUS)
       
 11919 -    * Acct-Session-Id: The process ID of the FTP session
       
 11920 -    * Acct-Session-Time: The duration of the FTP session, in seconds
       
 11921 -    * Acct-Input-Octets: The number of bytes uploaded (includes appending to files)
       
 11922 -    * Acct-Output-Octets: The number of bytes downloaded
       
 11923 -    Merely configuring a RadiusAcctServer enables the module's accounting capabilities.
       
 11924 -    Common Attributes
       
 11925 -    The following RADIUS attributes are sent with every RADIUS packet generated by mod_radius:
       
 11926 -    * User-Name: The name of the logging-in user
       
 11927 -    * NAS-Identifier: Always "ftp"
       
 11928 -    * NAS-IP-Address: IP address of FTP server
       
 11929 -    * NAS-Port: Port of FTP server
       
 11930 -    * NAS-Port-Type: Always Virtual.
       
 11931 -    * Calling-Station-Id: IP address of connecting FTP client</P
       
 11932 -></DIV
       
 11933 -><DIV
       
 11934 -CLASS="REFSECT1"
       
 11935 -><A
       
 11936 -NAME="AEN12919"
       
 11937 -></A
       
 11938 -><H2
       
 11939 ->See also</H2
       
 11940 -><P
       
 11941 -><A
       
 11942 -HREF="#RADIUSACCTSERVER"
       
 11943 ->RadiusAcctServer</A
       
 11944 -> 
       
 11945 -<A
       
 11946 -HREF="#RADIUSAUTHSERVER"
       
 11947 ->RadiusAuthServer</A
       
 11948 -> 
       
 11949 -<A
       
 11950 -HREF="#RADIUSENGINE"
       
 11951 ->RadiusEngine</A
       
 11952 -> 
       
 11953 -<A
       
 11954 -HREF="#RADIUSLOG"
       
 11955 ->RadiusLog</A
       
 11956 -> 
       
 11957 -<A
       
 11958 -HREF="#RADIUSREALM"
       
 11959 ->RadiusRealm</A
       
 11960 -> 
       
 11961 -<A
       
 11962 -HREF="#RADIUSUSERINFO"
       
 11963 ->RadiusUserInfo</A
       
 11964 -> </P
       
 11965 -></DIV
       
 11966 -><H1
       
 11967 -><A
       
 11968 -NAME="MOD-RATIO"
       
 11969 -></A
       
 11970 ->
       
 11971 -mod_ratio</H1
       
 11972 -><DIV
       
 11973 -CLASS="REFNAMEDIV"
       
 11974 -><A
       
 11975 -NAME="AEN12933"
       
 11976 -></A
       
 11977 -><H2
       
 11978 ->Name</H2
       
 11979 ->mod_ratio&nbsp;--&nbsp;FIX ME FIX ME</DIV
       
 11980 -><DIV
       
 11981 -CLASS="REFSYNOPSISDIV"
       
 11982 -><A
       
 11983 -NAME="AEN12936"
       
 11984 -></A
       
 11985 -><H2
       
 11986 ->Synopsis</H2
       
 11987 -><P
       
 11988 -><B
       
 11989 -CLASS="COMMAND"
       
 11990 ->mod_ratio</B
       
 11991 -> </P
       
 11992 -></DIV
       
 11993 -><DIV
       
 11994 -CLASS="REFSECT1"
       
 11995 -><A
       
 11996 -NAME="AEN12939"
       
 11997 -></A
       
 11998 -><H2
       
 11999 ->Description</H2
       
 12000 -><P
       
 12001 ->FIXME
       
 12002 -FIXME
       
 12003 -FIXME</P
       
 12004 -></DIV
       
 12005 -><DIV
       
 12006 -CLASS="REFSECT1"
       
 12007 -><A
       
 12008 -NAME="AEN12942"
       
 12009 -></A
       
 12010 -><H2
       
 12011 ->See also</H2
       
 12012 -><P
       
 12013 -><A
       
 12014 -HREF="#ANONRATIO"
       
 12015 ->AnonRatio</A
       
 12016 -> 
       
 12017 -<A
       
 12018 -HREF="#BYTERATIOERRMSG"
       
 12019 ->ByteRatioErrMsg</A
       
 12020 -> 
       
 12021 -<A
       
 12022 -HREF="#CWDRATIOMSG"
       
 12023 ->CwdRatioMsg</A
       
 12024 -> 
       
 12025 -<A
       
 12026 -HREF="#FILERATIOERRMSG"
       
 12027 ->FileRatioErrMsg</A
       
 12028 -> 
       
 12029 -<A
       
 12030 -HREF="#GROUPRATIO"
       
 12031 ->GroupRatio</A
       
 12032 -> 
       
 12033 -<A
       
 12034 -HREF="#HOSTRATIO"
       
 12035 ->HostRatio</A
       
 12036 -> 
       
 12037 -<A
       
 12038 -HREF="#LEECHRATIOMSG"
       
 12039 ->LeechRatioMsg</A
       
 12040 -> 
       
 12041 -<A
       
 12042 -HREF="#RATIOFILE"
       
 12043 ->RatioFile</A
       
 12044 -> 
       
 12045 -<A
       
 12046 -HREF="#RATIOS"
       
 12047 ->Ratios</A
       
 12048 -> 
       
 12049 -<A
       
 12050 -HREF="#RATIOTEMPFILE"
       
 12051 ->RatioTempFile</A
       
 12052 -> 
       
 12053 -<A
       
 12054 -HREF="#SAVERATIOS"
       
 12055 ->SaveRatios</A
       
 12056 -> 
       
 12057 -<A
       
 12058 -HREF="#USERRATIO"
       
 12059 ->UserRatio</A
       
 12060 -> </P
       
 12061 -></DIV
       
 12062 -><H1
       
 12063 -><A
       
 12064 -NAME="MOD-README"
       
 12065 -></A
       
 12066 ->
       
 12067 -mod_readme</H1
       
 12068 -><DIV
       
 12069 -CLASS="REFNAMEDIV"
       
 12070 -><A
       
 12071 -NAME="AEN12962"
       
 12072 -></A
       
 12073 -><H2
       
 12074 ->Name</H2
       
 12075 ->mod_readme&nbsp;--&nbsp;"README" file support</DIV
       
 12076 -><DIV
       
 12077 -CLASS="REFSYNOPSISDIV"
       
 12078 -><A
       
 12079 -NAME="AEN12965"
       
 12080 -></A
       
 12081 -><H2
       
 12082 ->Synopsis</H2
       
 12083 -><P
       
 12084 -><B
       
 12085 -CLASS="COMMAND"
       
 12086 ->mod_readme</B
       
 12087 -> </P
       
 12088 -></DIV
       
 12089 -><DIV
       
 12090 -CLASS="REFSECT1"
       
 12091 -><A
       
 12092 -NAME="AEN12968"
       
 12093 -></A
       
 12094 -><H2
       
 12095 ->Description</H2
       
 12096 -><P
       
 12097 ->FIXME
       
 12098 -FIXME
       
 12099 -FIXME</P
       
 12100 -></DIV
       
 12101 -><DIV
       
 12102 -CLASS="REFSECT1"
       
 12103 -><A
       
 12104 -NAME="AEN12971"
       
 12105 -></A
       
 12106 -><H2
       
 12107 ->See also</H2
       
 12108 -><P
       
 12109 -><A
       
 12110 -HREF="#DISPLAYREADME"
       
 12111 ->DisplayReadme</A
       
 12112 -> </P
       
 12113 -></DIV
       
 12114 -><H1
       
 12115 -><A
       
 12116 -NAME="AEN12975"
       
 12117 -></A
       
 12118 -></H1
       
 12119 -><A
       
 12120 -HREF="#REWRITECONDITION"
       
 12121 ->RewriteCondition</A
       
 12122 -><A
       
 12123 -HREF="#REWRITEENGINE"
       
 12124 ->RewriteEngine</A
       
 12125 -><A
       
 12126 -HREF="#REWRITELOCK"
       
 12127 ->RewriteLock</A
       
 12128 -><A
       
 12129 -HREF="#REWRITELOG"
       
 12130 ->RewriteLog</A
       
 12131 -><A
       
 12132 -HREF="#REWRITEMAP"
       
 12133 ->RewriteMap</A
       
 12134 -><A
       
 12135 -HREF="#REWRITERULE"
       
 12136 ->RewriteRule</A
       
 12137 -><H1
       
 12138 -><A
       
 12139 -NAME="MOD-SQL"
       
 12140 -></A
       
 12141 ->
       
 12142 -mod_sql</H1
       
 12143 -><DIV
       
 12144 -CLASS="REFNAMEDIV"
       
 12145 -><A
       
 12146 -NAME="AEN12987"
       
 12147 -></A
       
 12148 -><H2
       
 12149 ->Name</H2
       
 12150 ->mod_sql&nbsp;--&nbsp;SQL support module</DIV
       
 12151 -><DIV
       
 12152 -CLASS="REFSYNOPSISDIV"
       
 12153 -><A
       
 12154 -NAME="AEN12990"
       
 12155 -></A
       
 12156 -><H2
       
 12157 ->Synopsis</H2
       
 12158 -><P
       
 12159 -><B
       
 12160 -CLASS="COMMAND"
       
 12161 ->mod_sql</B
       
 12162 -> </P
       
 12163 -></DIV
       
 12164 -><DIV
       
 12165 -CLASS="REFSECT1"
       
 12166 -><A
       
 12167 -NAME="AEN12993"
       
 12168 -></A
       
 12169 -><H2
       
 12170 ->Description</H2
       
 12171 -><P
       
 12172 ->This module provides the necessary support for SQL based authentication, logging and other features as required.
       
 12173 -It replaces the SQL modules which were shipped with 1.2.0rc2 and earlier.</P
       
 12174 -></DIV
       
 12175 -><DIV
       
 12176 -CLASS="REFSECT1"
       
 12177 -><A
       
 12178 -NAME="AEN12996"
       
 12179 -></A
       
 12180 -><H2
       
 12181 ->See also</H2
       
 12182 -><P
       
 12183 -><A
       
 12184 -HREF="#SQLAUTHENTICATE"
       
 12185 ->SQLAuthenticate</A
       
 12186 -> 
       
 12187 -<A
       
 12188 -HREF="#SQLAUTHTYPES"
       
 12189 ->SQLAuthTypes</A
       
 12190 -> 
       
 12191 -<A
       
 12192 -HREF="#SQLBACKEND"
       
 12193 ->SQLBackend</A
       
 12194 -> 
       
 12195 -<A
       
 12196 -HREF="#SQLCONNECTINFO"
       
 12197 ->SQLConnectInfo</A
       
 12198 -> 
       
 12199 -<A
       
 12200 -HREF="#SQLDEFAULTGID"
       
 12201 ->SQLDefaultGID</A
       
 12202 -> 
       
 12203 -<A
       
 12204 -HREF="#SQLDEFAULTHOMEDIR"
       
 12205 ->SQLDefaultHomedir</A
       
 12206 -> 
       
 12207 -<A
       
 12208 -HREF="#SQLDEFAULTUID"
       
 12209 ->SQLDefaultUID</A
       
 12210 -> 
       
 12211 -<A
       
 12212 -HREF="#SQLENGINE"
       
 12213 ->SQLEngine</A
       
 12214 -> 
       
 12215 -<A
       
 12216 -HREF="#SQLGROUPINFO"
       
 12217 ->SQLGroupInfo</A
       
 12218 -> 
       
 12219 -<A
       
 12220 -HREF="#SQLGROUPWHERECLAUSE"
       
 12221 ->SQLGroupWhereClause</A
       
 12222 -> 
       
 12223 -<A
       
 12224 -HREF="#SQLHOMEDIRONDEMAND"
       
 12225 ->SQLHomedirOnDemand</A
       
 12226 -> 
       
 12227 -<A
       
 12228 -HREF="#SQLLOG"
       
 12229 ->SQLLog</A
       
 12230 -> 
       
 12231 -<A
       
 12232 -HREF="#SQLLOGFILE"
       
 12233 ->SQLLogFile</A
       
 12234 -> 
       
 12235 -<A
       
 12236 -HREF="#SQLMINID"
       
 12237 ->SQLMinID</A
       
 12238 -> 
       
 12239 -<A
       
 12240 -HREF="#SQLMINUSERGID"
       
 12241 ->SQLMinUserGID</A
       
 12242 -> 
       
 12243 -<A
       
 12244 -HREF="#SQLMINUSERUID"
       
 12245 ->SQLMinUserUID</A
       
 12246 -> 
       
 12247 -<A
       
 12248 -HREF="#SQLNAMEDQUERY"
       
 12249 ->SQLNamedQuery</A
       
 12250 -> 
       
 12251 -<A
       
 12252 -HREF="#SQLNEGATIVECACHE"
       
 12253 ->SQLNegativeCache</A
       
 12254 -> 
       
 12255 -<A
       
 12256 -HREF="#SQLRATIOS"
       
 12257 ->SQLRatios</A
       
 12258 -> 
       
 12259 -<A
       
 12260 -HREF="#SQLRATIOSTATS"
       
 12261 ->SQLRatioStats</A
       
 12262 -> 
       
 12263 -<A
       
 12264 -HREF="#SQLSHOWINFO"
       
 12265 ->SQLShowInfo</A
       
 12266 -> 
       
 12267 -<A
       
 12268 -HREF="#SQLUSERINFO"
       
 12269 ->SQLUserInfo</A
       
 12270 -> 
       
 12271 -<A
       
 12272 -HREF="#SQLUSERWHERECLAUSE"
       
 12273 ->SQLUserWhereClause</A
       
 12274 -> </P
       
 12275 -></DIV
       
 12276 -><H1
       
 12277 -><A
       
 12278  NAME="MOD-TLS"
       
 12279  ></A
       
 12280  >
       
 12281 @@ -35263,7 +23288,7 @@
       
 12282  ></A
       
 12283  ><H2
       
 12284  >Name</H2
       
 12285 ->mod_xfer&nbsp;--&nbsp;FIX ME FIX ME</DIV
       
 12286 +>mod_xfer&nbsp;--&nbsp;control transfer</DIV
       
 12287  ><DIV
       
 12288  CLASS="REFSYNOPSISDIV"
       
 12289  ><A