Mercurial > hg > nginx-site
diff xml/en/docs/ngx_core_module.xml @ 516:8e1356bd281a
Documented the "debug_connection" directive.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Mon, 14 May 2012 11:29:39 +0000 |
parents | 8275e169f77b |
children | a8daad8e83bb |
line wrap: on
line diff
--- a/xml/en/docs/ngx_core_module.xml Fri May 11 12:51:02 2012 +0000 +++ b/xml/en/docs/ngx_core_module.xml Mon May 14 11:29:39 2012 +0000 @@ -42,6 +42,43 @@ </directive> +<directive name="debug_connection"> +<syntax> + <value>address</value> | + <value>CIDR</value> | + <literal>unix:</literal></syntax> +<default/> +<context>events</context> + +<para> +Enables debugging log for selected client connections. +Other connections will use logging level set by the +<link id="error_log"/> directive. +Debugged connections are specified by IPv4 or IPv6 (1.3.0) address or network. +A connection may also be specified using a hostname, in which case the +first IPv4 address corresponding to a name is used. +For connections using UNIX-domain sockets (1.3.0), debugging log is enabled +by the “<literal>unix:</literal>” parameter. +<example> +events { + debug_connection 127.0.0.1; + debug_connection localhost; + debug_connection 192.0.2.0/24; + debug_connection ::1; + debug_connection 2001:0db8::/32; + debug_connection unix:; + ... +} +</example> +<note> +For this directive to work, nginx needs to +be built with <literal>--with-debug</literal>. +</note> +</para> + +</directive> + + <directive name="error_log"> <syntax> <value>file</value> | <literal>stderr</literal>