mod_ident.xml revision 158222078a98fb13cddf2793b42f7eb8eafe51ae
97a9a944b5887e91042b019776c41d5dd74557aferikabele<?xml version="1.0"?>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
97a9a944b5887e91042b019776c41d5dd74557aferikabele<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
b1ced323143ade589985456a78f3f64d6a6580c5yoshiki<!-- $LastChangedRevision$ -->
b1ced323143ade589985456a78f3f64d6a6580c5yoshiki
b1ced323143ade589985456a78f3f64d6a6580c5yoshiki<!--
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd Licensed to the Apache Software Foundation (ASF) under one or more
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd contributor license agreements. See the NOTICE file distributed with
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd this work for additional information regarding copyright ownership.
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd The ASF licenses this file to You under the Apache License, Version 2.0
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd (the "License"); you may not use this file except in compliance with
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd the License. You may obtain a copy of the License at
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd http://www.apache.org/licenses/LICENSE-2.0
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd
52fff662005b1866a3ff09bb6c902800c5cc6dedjerenkrantz Unless required by applicable law or agreed to in writing, software
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd distributed under the License is distributed on an "AS IS" BASIS,
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd See the License for the specific language governing permissions and
4b5981e276e93df97c34e4da05ca5cf8bbd937dand limitations under the License.
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd-->
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<modulesynopsis metafile="mod_ident.xml.meta">
7dc5a2d4a0c77f5bf5a95de92d68e43de7d8117anilgun
7dc5a2d4a0c77f5bf5a95de92d68e43de7d8117anilgun<name>mod_ident</name>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<description>RFC 1413 ident lookups</description>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<status>Extension</status>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<sourcefile>mod_ident.c</sourcefile>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<identifier>ident_module</identifier>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd
cea021a7fc2657b091df4d3b031c4254ec371dd7rbowen<summary>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <p>This module queries an <a href="http://www.ietf.org/rfc/rfc1413.txt"
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd >RFC 1413</a> compatible daemon on a remote host to look up the owner of
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin a connection.</p>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin</summary>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<seealso><module>mod_log_config</module></seealso>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<directivesynopsis>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<name>IdentityCheck</name>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<description>Enables logging of the RFC 1413 identity of the remote
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirinuser</description>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<syntax>IdentityCheck On|Off</syntax>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<default>IdentityCheck Off</default>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<contextlist><context>server config</context><context>virtual host</context>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<context>directory</context></contextlist>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin<usage>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin <p>This directive enables <a href="http://www.ietf.org/rfc/rfc1413.txt"
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin >RFC 1413</a>-compliant logging of the remote user name for each
06ba4a61654b3763ad65f52283832ebf058fdf1cslive connection, where the client machine runs identd or something similar.
f0a393c5c2d7de58f447855369ad2fbfa254e544rbowen This information is logged in the access log using the <code>%...l</code>
f0a393c5c2d7de58f447855369ad2fbfa254e544rbowen <a href="mod_log_config.html#formats">format string</a>.</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <note>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd The information should not be trusted in any way except for
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd rudimentary usage tracking.
117c1f888a14e73cdd821dc6c23eb0411144a41cnd </note>
117c1f888a14e73cdd821dc6c23eb0411144a41cnd
117c1f888a14e73cdd821dc6c23eb0411144a41cnd <p>Note that this can cause serious latency problems accessing
117c1f888a14e73cdd821dc6c23eb0411144a41cnd your server since every request requires one of these lookups
117c1f888a14e73cdd821dc6c23eb0411144a41cnd to be performed. When firewalls or proxy servers are involved,
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd each lookup might possibly fail and add a latency duration as
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf defined by the <directive module="mod_ident"
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf >IdentityCheckTimeout</directive> directive to each hit. So in
7571ea383299910bead3e93e66246cb212a28d0figalic general this is not very useful on public servers accessible from
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf the Internet.</p>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf</usage>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf</directivesynopsis>
7571ea383299910bead3e93e66246cb212a28d0figalic
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<directivesynopsis>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<name>IdentityCheckTimeout</name>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<description>Determines the timeout duration for ident requests</description>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<syntax>IdentityCheckTimeout <var>seconds</var></syntax>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<default>IdentityCheckTimeout 30</default>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<contextlist><context>server config</context><context>virtual host</context>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<context>directory</context></contextlist>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf<usage>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf <p>This directive specifies the timeout duration of an ident
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf request. The default value of 30 seconds is recommended by <a
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>, mainly because
1f0a28764a0520e43ce3a9130e56236fd67cd568igalic of possible network latency. However, you may want to adjust the
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf timeout value according to your local network speed.</p>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf</usage>
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf</directivesynopsis>
1e6708ac9aebbbd0ff63c2b93e6b97d50263a8bbrbowen
b41a0dbe6310c576e96b7ea6910051fd84fb06f5sf</modulesynopsis>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen