mod_ident.xml revision fe9dca85c9e1544931fb420615372c10c0181ea7
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<?xml version="1.0"?>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<!-- $LastChangedRevision$ -->
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<!--
50c04f297d76a57ead2fa6b73845f7563b1fc788sf Copyright 2003-2005 The Apache Software Foundation or its licensors,
50c04f297d76a57ead2fa6b73845f7563b1fc788sf as applicable.
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf Licensed under the Apache License, Version 2.0 (the "License");
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen you may not use this file except in compliance with the License.
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen You may obtain a copy of the License at
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen http://www.apache.org/licenses/LICENSE-2.0
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf Unless required by applicable law or agreed to in writing, software
50c04f297d76a57ead2fa6b73845f7563b1fc788sf distributed under the License is distributed on an "AS IS" BASIS,
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
3f08db06526d6901aa08c110b5bc7dde6bc39905nd See the License for the specific language governing permissions and
50c04f297d76a57ead2fa6b73845f7563b1fc788sf limitations under the License.
50c04f297d76a57ead2fa6b73845f7563b1fc788sf-->
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<modulesynopsis metafile="mod_ident.xml.meta">
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<name>mod_ident</name>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<description>RFC 1413 ident lookups</description>
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<status>Extension</status>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<sourcefile>mod_ident.c</sourcefile>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<identifier>ident_module</identifier>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<compatibility>Available in Apache 2.1 and later</compatibility>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<summary>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf <p>This module queries an <a href="http://www.ietf.org/rfc/rfc1413.txt"
50c04f297d76a57ead2fa6b73845f7563b1fc788sf >RFC 1413</a> compatible daemon on a remote host to look up the owner of
1538dfa9300693372892a358260e1dcdbf1138eapoirier a connection.</p>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf</summary>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<seealso><module>mod_log_config</module></seealso>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic<directivesynopsis>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic<name>IdentityCheck</name>
bed3c2e56e8f3328e780200466b9d009093db468sf<description>Enables logging of the RFC 1413 identity of the remote
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalicuser</description>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic<syntax>IdentityCheck On|Off</syntax>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<default>IdentityCheck Off</default>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<contextlist><context>server config</context><context>virtual host</context>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<context>directory</context></contextlist>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<compatibility>Moved out of core in Apache 2.1</compatibility>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<usage>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh <p>This directive enables <a href="http://www.ietf.org/rfc/rfc1413.txt"
50c04f297d76a57ead2fa6b73845f7563b1fc788sf >RFC 1413</a>-compliant logging of the remote user name for each
50c04f297d76a57ead2fa6b73845f7563b1fc788sf connection, where the client machine runs identd or something similar.
50c04f297d76a57ead2fa6b73845f7563b1fc788sf This information is logged in the access log using the <code>%...l</code>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf <a href="mod_log_config.html#formats">format string</a>.</p>
bed3c2e56e8f3328e780200466b9d009093db468sf
9a58dc6a2b26ec128b1270cf48810e705f1a90dbsf <note>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf The information should not be trusted in any way except for
50c04f297d76a57ead2fa6b73845f7563b1fc788sf rudimentary usage tracking.
50c04f297d76a57ead2fa6b73845f7563b1fc788sf </note>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
50c04f297d76a57ead2fa6b73845f7563b1fc788sf <p>Note that this can cause serious latency problems accessing
50c04f297d76a57ead2fa6b73845f7563b1fc788sf your server since every request requires one of these lookups
50c04f297d76a57ead2fa6b73845f7563b1fc788sf to be performed. When firewalls or proxy servers are involved,
50c04f297d76a57ead2fa6b73845f7563b1fc788sf each lookup might possibly fail and add a latency duration as
bed3c2e56e8f3328e780200466b9d009093db468sf defined by the <directive module="mod_ident"
bed3c2e56e8f3328e780200466b9d009093db468sf >IdentityCheckTimeout</directive> directive to each hit. So in
50c04f297d76a57ead2fa6b73845f7563b1fc788sf general this is not very useful on public servers accessible from
50c04f297d76a57ead2fa6b73845f7563b1fc788sf the Internet.</p>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic</usage>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic</directivesynopsis>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<directivesynopsis>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic<name>IdentityCheckTimeout</name>
f0fa55ff14fa0bf8fd72d989f6625de6dc3260c8igalic<description>Determines the timeout duration for ident requests</description>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf<syntax>IdentityCheckTimeout <var>seconds</var></syntax>
bed3c2e56e8f3328e780200466b9d009093db468sf<default>IdentityCheckTimeout 30</default>
bed3c2e56e8f3328e780200466b9d009093db468sf<contextlist><context>server config</context><context>virtual host</context>
bed3c2e56e8f3328e780200466b9d009093db468sf<context>directory</context></contextlist>
bed3c2e56e8f3328e780200466b9d009093db468sf<usage>
bed3c2e56e8f3328e780200466b9d009093db468sf <p>This directive specifies the timeout duration of an ident
50c04f297d76a57ead2fa6b73845f7563b1fc788sf request. The default value of 30 seconds is recommended by <a
50c04f297d76a57ead2fa6b73845f7563b1fc788sf href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>, mainly because
50c04f297d76a57ead2fa6b73845f7563b1fc788sf of possible network latency. However, you may want to adjust the
50c04f297d76a57ead2fa6b73845f7563b1fc788sf timeout value according to your local network speed.</p>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf</usage>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf</directivesynopsis>
50c04f297d76a57ead2fa6b73845f7563b1fc788sf
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung</modulesynopsis>
727872d18412fc021f03969b8641810d8896820bhumbedooh
0d0ba3a410038e179b695446bb149cce6264e0abnd