Mercurial > hg > nginx-site
annotate xml/en/docs/ngx_core_module.xml @ 1450:f5b5eefc43cb
Updated commercial docs for the upcoming release.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 09 Apr 2015 19:18:54 +0300 |
parents | c79501e16e26 |
children | eea7541e7c6a |
rev | line source |
---|---|
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
574
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
574
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
574
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
574
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
574
diff
changeset
|
7 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../dtd/module.dtd"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 <module name="Core functionality" |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 link="/en/docs/ngx_core_module.html" |
589 | 12 lang="en" |
1450
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
13 rev="13"> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 <section id="example" name="Example Configuration"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 user www www; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 worker_processes 2; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
21 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 error_log /var/log/nginx-error.log info; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 events { |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 use kqueue; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 worker_connections 2048; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 } |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 ... |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
30 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 </section> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 <section id="directives" name="Directives"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
38 <directive name="accept_mutex"> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
39 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
40 <default>on</default> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
41 <context>events</context> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
42 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
43 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
44 If <literal>accept_mutex</literal> is enabled, |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
45 worker processes will accept new connections by turn. |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
46 Otherwise, all worker processes will be notified about new connections, |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
47 and if volume of new connections is low, some of the worker processes |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
48 may just waste system resources. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
49 <note> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
50 The use of <link doc="events.xml" id="rtsig"/> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
51 connection processing method |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
52 requires <literal>accept_mutex</literal> to be enabled. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
53 </note> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
54 </para> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
55 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
56 </directive> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
57 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
58 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
59 <directive name="accept_mutex_delay"> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
60 <syntax><value>time</value></syntax> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
61 <default>500ms</default> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
62 <context>events</context> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
63 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
64 <para> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
65 If <link id="accept_mutex"/> is enabled, specifies the maximum time |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
66 during which a worker process will try to restart accepting new |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
67 connections if another worker process is currently accepting |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
68 new connections. |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
69 </para> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
70 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
71 </directive> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
72 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
73 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
74 <directive name="daemon"> |
271 | 75 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
76 <default>on</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
77 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 Determines whether nginx should become a daemon. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 Mainly used during development. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 |
516
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
87 <directive name="debug_connection"> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
88 <syntax> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
89 <value>address</value> | |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
90 <value>CIDR</value> | |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
91 <literal>unix:</literal></syntax> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
92 <default/> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
93 <context>events</context> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
94 |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
95 <para> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
96 Enables debugging log for selected client connections. |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
97 Other connections will use logging level set by the |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
98 <link id="error_log"/> directive. |
523 | 99 Debugged connections are specified by IPv4 or IPv6 (1.3.0, 1.2.1) |
100 address or network. | |
614
0526cac4637e
Removed intimate details of the "debug_connection" directive's
Ruslan Ermilov <ru@nginx.com>
parents:
610
diff
changeset
|
101 A connection may also be specified using a hostname. |
523 | 102 For connections using UNIX-domain sockets (1.3.0, 1.2.1), |
103 debugging log is enabled by the “<literal>unix:</literal>” parameter. | |
516
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
104 <example> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
105 events { |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
106 debug_connection 127.0.0.1; |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
107 debug_connection localhost; |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
108 debug_connection 192.0.2.0/24; |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
109 debug_connection ::1; |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
110 debug_connection 2001:0db8::/32; |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
111 debug_connection unix:; |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
112 ... |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
113 } |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
114 </example> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
115 <note> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
116 For this directive to work, nginx needs to |
913
9a65d437da42
Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents:
804
diff
changeset
|
117 be built with <literal>--with-debug</literal>, |
9a65d437da42
Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents:
804
diff
changeset
|
118 see “<link doc="debugging_log.xml"/>”. |
516
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
119 </note> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
120 </para> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
121 |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
122 </directive> |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
123 |
8e1356bd281a
Documented the "debug_connection" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
469
diff
changeset
|
124 |
574 | 125 <directive name="debug_points"> |
126 <syntax><literal>abort</literal> | <literal>stop</literal></syntax> | |
127 <default/> | |
128 <context>main</context> | |
129 | |
130 <para> | |
131 This directive is used for debugging. | |
132 </para> | |
133 | |
134 <para> | |
135 When internal error is detected, e.g. the leak of sockets on | |
136 restart of working processes, enabling <literal>debug_points</literal> | |
137 leads to a core file creation (<literal>abort</literal>) | |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
138 or to stopping of a process (<literal>stop</literal>) for further |
574 | 139 analysis using a system debugger. |
140 </para> | |
141 | |
142 </directive> | |
143 | |
144 | |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
145 <directive name="error_log"> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
146 <syntax> |
953
aded7086e84f
Commercial version documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
935
diff
changeset
|
147 <value>file</value> | <literal>stderr</literal> | |
1449
c79501e16e26
Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1436
diff
changeset
|
148 <literal>syslog:</literal><literal>server</literal>=<value>address</value>[,<value>parameter</value>=<value>value</value>] | |
c79501e16e26
Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1436
diff
changeset
|
149 <literal>memory:</literal><value>size</value> |
271 | 150 [<literal>debug</literal> | |
151 <literal>info</literal> | | |
152 <literal>notice</literal> | | |
153 <literal>warn</literal> | | |
154 <literal>error</literal> | | |
155 <literal>crit</literal> | | |
156 <literal>alert</literal> | | |
157 <literal>emerg</literal>]</syntax> | |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
158 <default>logs/error.log error</default> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
159 <context>main</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
160 <context>http</context> |
1450
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
161 <context>stream</context> |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
162 <context>server</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
163 <context>location</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
164 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
165 <para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
166 Configures logging. |
935
3860b37d56c0
Documented support for multiple "error_log" directives.
Vladimir Homutov <vl@nginx.com>
parents:
913
diff
changeset
|
167 Several logs can be specified on the same level (1.5.2). |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
168 </para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
169 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
170 <para> |
271 | 171 The first parameter defines a file that will store the log. |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
172 <!-- |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
173 If filename is not absolute, it is prefixed with the prefix path. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
174 --> |
455
571b790ddf9e
error_log: documented the special value "stderr" and default logging level.
Ruslan Ermilov <ru@nginx.com>
parents:
444
diff
changeset
|
175 The special value <literal>stderr</literal> selects the standard error file. |
1285
4e89518a5999
Moved syslog configuration details into the separate documents.
Ruslan Ermilov <ru@nginx.com>
parents:
1205
diff
changeset
|
176 Logging to <link doc="syslog.xml">syslog</link> can be configured by specifying |
953
aded7086e84f
Commercial version documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
935
diff
changeset
|
177 the “<literal>syslog:</literal>” prefix. |
1449
c79501e16e26
Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1436
diff
changeset
|
178 Logging to a |
c79501e16e26
Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1436
diff
changeset
|
179 <link doc="debugging_log.xml" id="memory">cyclic memory buffer</link> |
c79501e16e26
Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1436
diff
changeset
|
180 can be configured by specifying the “<literal>memory:</literal>” prefix and |
c79501e16e26
Documented cyclic memory buffer support for error_log.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1436
diff
changeset
|
181 buffer <value>size</value>, and is generally used for debugging (1.7.11). |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
182 </para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
183 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
184 <para> |
271 | 185 The second parameter determines the level of logging. |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
186 Log levels above are listed in the order of increasing severity. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
187 Setting a certain log level will cause all messages of |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
188 the specified and more severe log levels to be logged. |
271 | 189 For example, the default level <literal>error</literal> will |
190 cause <literal>error</literal>, <literal>crit</literal>, | |
191 <literal>alert</literal>, and <literal>emerg</literal> messages | |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
192 to be logged. |
455
571b790ddf9e
error_log: documented the special value "stderr" and default logging level.
Ruslan Ermilov <ru@nginx.com>
parents:
444
diff
changeset
|
193 If this parameter is omitted then <literal>error</literal> is used. |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
194 <note> |
271 | 195 For <literal>debug</literal> logging to work, nginx needs to |
913
9a65d437da42
Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents:
804
diff
changeset
|
196 be built with <literal>--with-debug</literal>, |
9a65d437da42
Link to "A debugging log" from "debug_connection" and "error_log".
Ruslan Ermilov <ru@nginx.com>
parents:
804
diff
changeset
|
197 see “<link doc="debugging_log.xml"/>”. |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
198 </note> |
1450
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
199 |
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
200 <note> |
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
201 The directive can be specified on the |
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
202 <literal>stream</literal> level |
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
203 starting from version 1.7.11. |
f5b5eefc43cb
Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
1449
diff
changeset
|
204 </note> |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
205 </para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
206 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
207 </directive> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
208 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
209 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
210 <directive name="env"> |
271 | 211 <syntax><value>variable</value>[=<value>value</value>]</syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
212 <default>TZ</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
213 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
214 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
215 <para> |
804
d22421dc5d00
Clarified the effects of the "env" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
764
diff
changeset
|
216 By default, nginx removes all environment variables inherited |
d22421dc5d00
Clarified the effects of the "env" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
764
diff
changeset
|
217 from its parent process except the TZ variable. |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
218 This directive allows preserving some of the inherited variables, |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
219 changing their values, or creating new environment variables. |
804
d22421dc5d00
Clarified the effects of the "env" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
764
diff
changeset
|
220 These variables are then: |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
221 <list type="bullet"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
222 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
223 <listitem> |
804
d22421dc5d00
Clarified the effects of the "env" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
764
diff
changeset
|
224 inherited during a <link doc="control.xml" id="upgrade">live upgrade</link> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
225 of an executable file; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
226 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
227 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
228 <listitem> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
229 used by the |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
230 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link> module; |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
231 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
232 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
233 <listitem> |
804
d22421dc5d00
Clarified the effects of the "env" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
764
diff
changeset
|
234 used by worker processes. |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
235 One should bear in mind that controlling system libraries in this way |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
236 is not always possible as it is common for libraries to check |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
237 variables only during initialization, well before they can be set |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
238 using this directive. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
239 An exception from this is an above mentioned |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
240 <link doc="control.xml" id="upgrade">live upgrade</link> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
241 of an executable file. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
242 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
243 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
244 </list> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
245 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
246 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
247 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
248 The TZ variable is always inherited and available to the |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
249 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link> |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
250 module, unless it is configured explicitly. |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
251 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
252 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
253 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
254 Usage example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
255 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
256 env MALLOC_OPTIONS; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
257 env PERL5LIB=/data/site/modules; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
258 env OPENSSL_ALLOW_PROXY_CERTS=1; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
259 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
260 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
261 |
444
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
262 <para> |
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
263 <note> |
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
264 The NGINX environment variable is used internally by nginx |
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
265 and should not be set directly by the user. |
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
266 </note> |
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
267 </para> |
43c84d19bf92
Added a note about the NGINX environment variable.
Ruslan Ermilov <ru@nginx.com>
parents:
289
diff
changeset
|
268 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
269 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
270 |
249 | 271 |
556
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
272 <directive name="events"> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
273 <syntax block="yes"/> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
274 <default/> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
275 <context>main</context> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
276 |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
277 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
278 Provides the configuration file context in which the directives that |
556
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
279 affect connection processing are specified. |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
280 </para> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
281 |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
282 </directive> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
283 |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
284 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
285 <directive name="include"> |
271 | 286 <syntax><value>file</value> | <value>mask</value></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
287 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
288 <context/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
289 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
290 <para> |
271 | 291 Includes another <value>file</value>, or files matching the |
292 specified <value>mask</value>, into configuration. | |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
293 Included files should consist of |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
294 syntactically correct directives and blocks. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
295 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
296 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
297 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
298 Usage example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
299 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
300 include mime.types; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
301 include vhosts/*.conf; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
302 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
303 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
304 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
305 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
306 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
307 |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
308 <directive name="lock_file"> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
309 <syntax><value>file</value></syntax> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
310 <default>logs/nginx.lock</default> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
311 <context>main</context> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
312 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
313 <para> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
314 nginx uses the locking mechanism to implement <link id="accept_mutex"/> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
315 and serialize access to shared memory. |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
316 On most systems the locks are implemented using atomic operations, |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
317 and this directive is ignored. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
318 On other systems the “lock file” mechanism is used. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
319 This directive specifies a prefix for the names of lock files. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
320 </para> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
321 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
322 </directive> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
323 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
324 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
325 <directive name="master_process"> |
271 | 326 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
327 <default>on</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
328 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
329 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
330 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
331 Determines whether worker processes are started. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
332 This directive is intended for nginx developers. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
333 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
334 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
335 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
336 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
337 |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
338 <directive name="multi_accept"> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
339 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
340 <default>off</default> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
341 <context>events</context> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
342 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
343 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
344 If <literal>multi_accept</literal> is disabled, a worker process |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
345 will accept one new connection at a time. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
346 Otherwise, a worker process |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
347 will accept all new connections at a time. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
348 <note> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
349 The directive is ignored if <link doc="events.xml" id="kqueue"/> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
350 connection processing method is used, because it reports |
571
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
351 the number of new connections waiting to be accepted. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
352 </note> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
353 <note> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
354 The use of <link doc="events.xml" id="rtsig"/> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
355 connection processing method |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
356 automatically enables <literal>multi_accept</literal>. |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
357 </note> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
358 </para> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
359 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
360 </directive> |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
361 |
71d775bef043
Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file.
Ruslan Ermilov <ru@nginx.com>
parents:
556
diff
changeset
|
362 |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
363 <directive name="pcre_jit"> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
364 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
365 <default>off</default> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
366 <context>main</context> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
367 <appeared-in>1.1.12</appeared-in> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
368 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
369 <para> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
370 Enables or disables the use of “just-in-time compilation” (PCRE JIT) |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
371 for the regular expressions known by the time of configuration parsing. |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
372 </para> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
373 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
374 <para> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
375 PCRE JIT can speed up processing of regular expressions significantly. |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
376 <note> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
377 The JIT is available in PCRE libraries starting from version 8.20 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
378 built with the <literal>--enable-jit</literal> configuration parameter. |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
379 When the PCRE library is built with nginx (<literal>--with-pcre=</literal>), |
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
380 the JIT support is enabled via the |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
381 <literal>--with-pcre-jit</literal> configuration parameter. |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
382 </note> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
383 </para> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
384 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
385 </directive> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
386 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
387 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
388 <directive name="pid"> |
271 | 389 <syntax><value>file</value></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
390 <default>nginx.pid</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
391 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
392 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
393 <para> |
271 | 394 Defines a <value>file</value> that will store the process ID of the main process. |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
395 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
396 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
397 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
398 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
399 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
400 <directive name="ssl_engine"> |
271 | 401 <syntax><value>device</value></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
402 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
403 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
404 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
405 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
406 Defines the name of the hardware SSL accelerator. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
407 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
408 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
409 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
410 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
411 |
1436 | 412 <directive name="thread_pool"> |
413 <syntax> | |
414 <value>name</value> | |
415 <literal>threads</literal>=<value>number</value> | |
416 [<literal>max_queue</literal>=<value>number</value>]</syntax> | |
417 <default>default threads=32 max_queue=65536</default> | |
418 <context>main</context> | |
419 <appeared-in>1.7.11</appeared-in> | |
420 | |
421 <para> | |
422 Defines named thread pools | |
423 used for multi-threaded reading and sending of files | |
424 <link doc="http/ngx_http_core_module.xml" id="aio">without blocking</link> | |
425 worker processes. | |
426 </para> | |
427 | |
428 <para> | |
429 The <literal>threads</literal> parameter | |
430 defines the number of threads in the pool. | |
431 </para> | |
432 | |
433 <para> | |
434 In the event that all threads in the pool are busy, | |
435 a new task will wait in the queue. | |
436 The <literal>max_queue</literal> parameter limits the number | |
437 of tasks allowed to be waiting in the queue. | |
438 By default, up to 65536 tasks can wait in the queue. | |
439 When the queue overflows, the task is completed with an error. | |
440 </para> | |
441 | |
442 </directive> | |
443 | |
444 | |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
445 <directive name="timer_resolution"> |
271 | 446 <syntax><value>interval</value></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
447 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
448 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
449 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
450 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
451 Reduces timer resolution in worker processes, thus reducing the |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
452 number of <c-func>gettimeofday</c-func> system calls made. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
453 By default, <c-func>gettimeofday</c-func> is called each time |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
454 a kernel event is received. |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
455 With reduced resolution, <c-func>gettimeofday</c-func> is only |
271 | 456 called once per specified <value>interval</value>. |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
457 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
458 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
459 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
460 Example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
461 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
462 timer_resolution 100ms; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
463 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
464 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
465 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
466 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
467 Internal implementation of the interval depends on the method used: |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
468 <list type="bullet"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
469 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
470 <listitem> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
471 the <c-def>EVFILT_TIMER</c-def> filter if <literal>kqueue</literal> is used; |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
472 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
473 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
474 <listitem> |
271 | 475 <c-func>timer_create</c-func> if <literal>eventport</literal> is used; |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
476 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
477 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
478 <listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
479 <c-func>setitimer</c-func> otherwise. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
480 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
481 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
482 </list> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
483 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
484 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
485 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
486 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
487 |
556
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
488 <directive name="use"> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
489 <syntax><value>method</value></syntax> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
490 <default/> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
491 <context>events</context> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
492 |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
493 <para> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
494 Specifies the <link doc="events.xml">connection processing</link> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
495 <value>method</value> to use. |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
496 There is normally no need to specify it explicitly, because nginx will |
556
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
497 by default use the most efficient method. |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
498 </para> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
499 |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
500 </directive> |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
501 |
345012910707
Documented the "events" and "use" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
554
diff
changeset
|
502 |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
503 <directive name="user"> |
271 | 504 <syntax><value>user</value> [<value>group</value>]</syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
505 <default>nobody nobody</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
506 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
507 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
508 <para> |
271 | 509 Defines <value>user</value> and <value>group</value> |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
510 credentials used by worker processes. |
271 | 511 If <value>group</value> is omitted, a group whose name equals |
512 that of <value>user</value> is used. | |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
513 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
514 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
515 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
516 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
517 |
749
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
518 <directive name="worker_aio_requests"> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
519 <syntax><value>number</value></syntax> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
520 <default>32</default> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
521 <context>events</context> |
750
6a1b1ba62cab
Documented history of "worker_aio_requests" directive.
Vladimir Homutov <vl@nginx.com>
parents:
749
diff
changeset
|
522 <appeared-in>1.1.4</appeared-in> |
6a1b1ba62cab
Documented history of "worker_aio_requests" directive.
Vladimir Homutov <vl@nginx.com>
parents:
749
diff
changeset
|
523 <appeared-in>1.0.7</appeared-in> |
749
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
524 |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
525 <para> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
526 When using <link doc="http/ngx_http_core_module.xml" id="aio"/> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
527 with the <link doc="../docs/events.xml" id="epoll"/> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
528 connection processing method, sets the maximum <value>number</value> of |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
529 outstanding asynchronous I/O operations |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
530 for a single worker process. |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
531 </para> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
532 |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
533 </directive> |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
534 |
2abb92a19101
Documented 'worker_aio_requests' directive.
Vladimir Homutov <vl@nginx.com>
parents:
742
diff
changeset
|
535 |
545
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
536 <directive name="worker_connections"> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
537 <syntax><value>number</value></syntax> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
538 <default>512</default> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
539 <context>events</context> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
540 |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
541 <para> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
542 Sets the maximum number of simultaneous connections that |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
543 can be opened by a worker process. |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
544 </para> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
545 |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
546 <para> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
547 It should be kept in mind that this number includes all connections |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
548 (e.g. connections with proxied servers, among others), |
545
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
549 not only connections with clients. |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
550 Another consideration is that the actual number of simultaneous |
966 | 551 connections cannot exceed the current limit on |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
552 the maximum number of open files, which can be changed by |
545
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
553 <link id="worker_rlimit_nofile"/>. |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
554 </para> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
555 |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
556 </directive> |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
557 |
e97b46d1842d
Documented the "worker_connections" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
523
diff
changeset
|
558 |
469
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
559 <directive name="worker_cpu_affinity"> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
560 <syntax><value>cpumask</value> ...</syntax> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
561 <default/> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
562 <context>main</context> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
563 |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
564 <para> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
565 Binds worker processes to the sets of CPUs. |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
566 Each CPU set is represented by a bitmask of allowed CPUs. |
469
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
567 There should be a separate set defined for each of the worker processes. |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
568 By default, worker processes are not bound to any specific CPUs. |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
569 </para> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
570 |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
571 <para> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
572 For example, |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
573 <example> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
574 worker_processes 4; |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
575 worker_cpu_affinity 0001 0010 0100 1000; |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
576 </example> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
577 binds each worker process to a separate CPU, while |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
578 <example> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
579 worker_processes 2; |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
580 worker_cpu_affinity 0101 1010; |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
581 </example> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
582 binds the first worker process to CPU0/CPU2, |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
583 and the second worker process to CPU1/CPU3. |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
584 The second example is suitable for hyper-threading. |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
585 </para> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
586 |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
587 <para> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
588 <note> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
589 The directive is only available on FreeBSD and Linux. |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
590 </note> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
591 </para> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
592 |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
593 </directive> |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
594 |
8275e169f77b
Documented the "worker_cpu_affinity" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
455
diff
changeset
|
595 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
596 <directive name="worker_priority"> |
271 | 597 <syntax><value>number</value></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
598 <default>0</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
599 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
600 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
601 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
602 Defines the scheduling priority for worker processes like it is |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
603 done by the <command>nice</command> command: a negative |
271 | 604 <value>number</value> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
605 means higher priority. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
606 Allowed range normally varies from -20 to 20. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
607 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
608 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
609 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
610 Example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
611 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
612 worker_priority -10; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
613 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
614 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
615 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
616 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
617 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
618 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
619 <directive name="worker_processes"> |
740
46d70031bea9
Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents:
659
diff
changeset
|
620 <syntax><value>number</value> | <literal>auto</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
621 <default>1</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
622 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
623 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
624 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
625 Defines the number of worker processes. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
626 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
627 |
226
c4b33b07dcfe
Added some basic hints on how to tune "worker_processes".
Ruslan Ermilov <ru@nginx.com>
parents:
158
diff
changeset
|
628 <para> |
c4b33b07dcfe
Added some basic hints on how to tune "worker_processes".
Ruslan Ermilov <ru@nginx.com>
parents:
158
diff
changeset
|
629 The optimal value depends on many factors including (but not |
c4b33b07dcfe
Added some basic hints on how to tune "worker_processes".
Ruslan Ermilov <ru@nginx.com>
parents:
158
diff
changeset
|
630 limited to) the number of CPU cores, the number of hard disk |
c4b33b07dcfe
Added some basic hints on how to tune "worker_processes".
Ruslan Ermilov <ru@nginx.com>
parents:
158
diff
changeset
|
631 drives that store data, and load pattern. |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
632 When one is in doubt, setting it to the number of available CPU cores |
740
46d70031bea9
Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents:
659
diff
changeset
|
633 would be a good start (the value “<literal>auto</literal>” |
46d70031bea9
Documented the recently added "auto" parameter of the
Andrey Belov <defan@nginx.com>
parents:
659
diff
changeset
|
634 will try to autodetect it). |
742
3a2e35f4c279
Documented that "worker_processes auto" appeared in version 1.3.8.
Ruslan Ermilov <ru@nginx.com>
parents:
740
diff
changeset
|
635 <note> |
3a2e35f4c279
Documented that "worker_processes auto" appeared in version 1.3.8.
Ruslan Ermilov <ru@nginx.com>
parents:
740
diff
changeset
|
636 The <literal>auto</literal> parameter is supported starting from |
764
f8434fdd3cd9
The "auto" parameter of the ""worker_processes" directive
Ruslan Ermilov <ru@nginx.com>
parents:
750
diff
changeset
|
637 versions 1.3.8 and 1.2.5. |
742
3a2e35f4c279
Documented that "worker_processes auto" appeared in version 1.3.8.
Ruslan Ermilov <ru@nginx.com>
parents:
740
diff
changeset
|
638 </note> |
226
c4b33b07dcfe
Added some basic hints on how to tune "worker_processes".
Ruslan Ermilov <ru@nginx.com>
parents:
158
diff
changeset
|
639 </para> |
c4b33b07dcfe
Added some basic hints on how to tune "worker_processes".
Ruslan Ermilov <ru@nginx.com>
parents:
158
diff
changeset
|
640 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
641 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
642 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
643 |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
644 <directive name="worker_rlimit_core"> |
271 | 645 <syntax><value>size</value></syntax> |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
646 <default/> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
647 <context>main</context> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
648 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
649 <para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
650 Changes the limit on the largest size of a core file |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
651 (<c-def>RLIMIT_CORE</c-def>) for worker processes. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
652 Used to increase the limit without restarting the main process. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
653 </para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
654 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
655 </directive> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
656 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
657 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
658 <directive name="worker_rlimit_nofile"> |
271 | 659 <syntax><value>number</value></syntax> |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
660 <default/> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
661 <context>main</context> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
662 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
663 <para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
664 Changes the limit on the maximum number of open files |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
665 (<c-def>RLIMIT_NOFILE</c-def>) for worker processes. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
666 Used to increase the limit without restarting the main process. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
667 </para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
668 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
669 </directive> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
670 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
671 |
554
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
672 <directive name="worker_rlimit_sigpending"> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
673 <syntax><value>number</value></syntax> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
674 <default/> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
675 <context>main</context> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
676 |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
677 <para> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
678 On systems that support <link doc="events.xml" id="rtsig"/> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
679 connection processing method, |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
680 changes the limit on the number of signals that may be queued |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
681 (<c-def>RLIMIT_SIGPENDING</c-def>) for worker processes. |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
682 Used to increase the limit without restarting the main process. |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
683 </para> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
684 |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
685 </directive> |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
686 |
ccb7451af1d8
Documented the "worker_rlimit_sigpending" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
545
diff
changeset
|
687 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
688 <directive name="working_directory"> |
271 | 689 <syntax><value>directory</value></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
690 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
691 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
692 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
693 <para> |
957
6d9d4bb571a9
Text review of the ngx_core_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents:
953
diff
changeset
|
694 Defines the current working directory for a worker process. |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
695 It is primarily used when writing a core-file, in which case |
262
676abe405aba
Changed one instance of "working process" to "worker process".
Ruslan Ermilov <ru@nginx.com>
parents:
249
diff
changeset
|
696 a worker process should have write permission for the |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
697 specified directory. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
698 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
699 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
700 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
701 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
702 </section> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
703 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
704 </module> |