comparison 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
comparison
equal deleted inserted replaced
515:1569ce935ea3 516:8e1356bd281a
35 <context>main</context> 35 <context>main</context>
36 36
37 <para> 37 <para>
38 Determines whether nginx should become a daemon. 38 Determines whether nginx should become a daemon.
39 Mainly used during development. 39 Mainly used during development.
40 </para>
41
42 </directive>
43
44
45 <directive name="debug_connection">
46 <syntax>
47 <value>address</value> |
48 <value>CIDR</value> |
49 <literal>unix:</literal></syntax>
50 <default/>
51 <context>events</context>
52
53 <para>
54 Enables debugging log for selected client connections.
55 Other connections will use logging level set by the
56 <link id="error_log"/> directive.
57 Debugged connections are specified by IPv4 or IPv6 (1.3.0) address or network.
58 A connection may also be specified using a hostname, in which case the
59 first IPv4 address corresponding to a name is used.
60 For connections using UNIX-domain sockets (1.3.0), debugging log is enabled
61 by the “<literal>unix:</literal>” parameter.
62 <example>
63 events {
64 debug_connection 127.0.0.1;
65 debug_connection localhost;
66 debug_connection 192.0.2.0/24;
67 debug_connection ::1;
68 debug_connection 2001:0db8::/32;
69 debug_connection unix:;
70 ...
71 }
72 </example>
73 <note>
74 For this directive to work, nginx needs to
75 be built with <literal>--with-debug</literal>.
76 </note>
40 </para> 77 </para>
41 78
42 </directive> 79 </directive>
43 80
44 81