comparison xml/en/docs/ngx_core_module.xml @ 455:571b790ddf9e

error_log: documented the special value "stderr" and default logging level.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 20 Mar 2012 08:24:14 +0000
parents 43c84d19bf92
children 8275e169f77b
comparison
equal deleted inserted replaced
454:daafc5600fc4 455:571b790ddf9e
42 </directive> 42 </directive>
43 43
44 44
45 <directive name="error_log"> 45 <directive name="error_log">
46 <syntax> 46 <syntax>
47 <value>file</value> 47 <value>file</value> | <literal>stderr</literal>
48 [<literal>debug</literal> | 48 [<literal>debug</literal> |
49 <literal>info</literal> | 49 <literal>info</literal> |
50 <literal>notice</literal> | 50 <literal>notice</literal> |
51 <literal>warn</literal> | 51 <literal>warn</literal> |
52 <literal>error</literal> | 52 <literal>error</literal> |
66 <para> 66 <para>
67 The first parameter defines a file that will store the log. 67 The first parameter defines a file that will store the log.
68 <!-- 68 <!--
69 If filename is not absolute, it is prefixed with the prefix path. 69 If filename is not absolute, it is prefixed with the prefix path.
70 --> 70 -->
71 The special value <literal>stderr</literal> selects the standard error file.
71 </para> 72 </para>
72 73
73 <para> 74 <para>
74 The second parameter determines the level of logging. 75 The second parameter determines the level of logging.
75 Log levels above are listed in the order of increasing severity. 76 Log levels above are listed in the order of increasing severity.
77 the specified and more severe log levels to be logged. 78 the specified and more severe log levels to be logged.
78 For example, the default level <literal>error</literal> will 79 For example, the default level <literal>error</literal> will
79 cause <literal>error</literal>, <literal>crit</literal>, 80 cause <literal>error</literal>, <literal>crit</literal>,
80 <literal>alert</literal>, and <literal>emerg</literal> messages 81 <literal>alert</literal>, and <literal>emerg</literal> messages
81 to be logged. 82 to be logged.
83 If this parameter is omitted then <literal>error</literal> is used.
82 <note> 84 <note>
83 For <literal>debug</literal> logging to work, nginx needs to 85 For <literal>debug</literal> logging to work, nginx needs to
84 be built with <literal>--with-debug</literal>. 86 be built with <literal>--with-debug</literal>.
85 </note> 87 </note>
86 </para> 88 </para>