nginx-site: xml/en/docs/debugging

annotate xml/en/docs/debugging_log.xml @ 271:4c6d2c614d2c

Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".

author	Ruslan Ermilov <ru@nginx.com>
date	Fri, 23 Dec 2011 17:29:59 +0000
parents	5284967934df
children	8e1356bd281a

rev	line source
50 9d544687d02c Fixed DOCTYPE declaration. Ruslan Ermilov <ru@nginx.com> parents: 0 diff changeset	1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	2
123 7db449e89e92 Unified the use of the "name" attribute instead of "title". Ruslan Ermilov <ru@nginx.com> parents: 50 diff changeset	3 <article name="A debugging log"
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	4 link="/en/docs/debugging_log.html"
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	5 lang="en">
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	6
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	7
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	8 <section>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	9
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	10 <para>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	11 To enable a debugging log, nginx needs to be configured to support
5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	12 debugging during the build:
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	13
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14 <programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	15 ./configure --with-debug ...
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	16 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	17
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 213 diff changeset	18 Then the <literal>debug</literal> level should be set with the
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	19 <link doc="ngx_core_module.xml" id="error_log"/> directive:
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	20
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	21 <programlisting>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	22 error_log /path/to/log debug;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	23 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	24
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	25 The nginx binary version for Windows is always built with the debugging log
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 213 diff changeset	26 support, so only setting the <literal>debug</literal> level will suffice.
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	27 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	28
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	29 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 213 diff changeset	30 Note that redefining the log without also specifying the
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 213 diff changeset	31 <literal>debug</literal>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	32 level will disable the debugging log.
5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	33 In the example below, redefining the log on the
5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	34 <link doc="http/ngx_http_core_module.xml" id="server"/>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	35 level disables the debugging log for this server:
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	36 <programlisting>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	37 error_log /path/to/log debug;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	38
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	39 http {
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	40 server {
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	41 error_log /path/to/log;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	42 ...
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	43 </programlisting>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	44 To avoid this, either the line redefining the log should be
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 213 diff changeset	45 commented out, or the <literal>debug</literal> level specification should
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	46 also be added:
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	47 <programlisting>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	48 error_log /path/to/log debug;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	49
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	50 http {
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	51 server {
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	52 error_log /path/to/log debug;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	53 ...
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	54 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	55 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	56
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	57 <para>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	58 It is also possible to enable the debugging log for selected addresses only:
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	59
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	60 <programlisting>
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	61 error_log /path/to/log;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	62
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	63 events {
213 5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	64 debug_connection 192.168.1.1;
5284967934df Improved markup and wording. Ruslan Ermilov <ru@nginx.com> parents: 123 diff changeset	65 debug_connection 192.168.10.0/24;
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	66 }
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	67 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	68 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	69
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	70 </section>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	71
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	72 </article>

Mercurial > hg > nginx-site

annotate xml/en/docs/debugging_log.xml @ 271:4c6d2c614d2c