Mercurial > hg > nginx-site
annotate xml/en/docs/ngx_core_module.xml @ 199:8796246b31e1
- Added new entries to faq.xml
- Deleted denied shite
author | Andrey Alexeev <andrew@nginx.com> |
---|---|
date | Wed, 23 Nov 2011 16:42:05 +0000 |
parents | 05e58829de2e |
children | c4b33b07dcfe |
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 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../../dtd/module.dtd"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
4 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
5 <module name="Core functionality" |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 link="/en/docs/ngx_core_module.html" |
98 | 7 lang="en"> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 <section id="example" name="Example Configuration"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
12 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
13 user www www; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 worker_processes 2; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 error_log /var/log/nginx-error.log info; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 events { |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 use kqueue; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 worker_connections 2048; |
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 |
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 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 </section> |
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 <section id="directives" name="Directives"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 <directive name="daemon"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
33 <syntax><value>on</value> | <value>off</value></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
34 <default>on</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 Determines whether nginx should become a daemon. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 Mainly used during development. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 |
158
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
45 <directive name="error_log"> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
46 <syntax> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
47 <argument>file</argument> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
48 [<value>debug</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
49 <value>info</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
50 <value>notice</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
51 <value>warn</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
52 <value>error</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
53 <value>crit</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
54 <value>alert</value> | |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
55 <value>emerg</value>] |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
56 </syntax> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
57 <default>logs/error.log error</default> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
58 <context>main</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
59 <context>http</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
60 <context>server</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
61 <context>location</context> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
62 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
63 <para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
64 Configures logging. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
65 </para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
66 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
67 <para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
68 The first argument defines a file that will store the log. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
69 <!-- |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
70 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
|
71 --> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
72 </para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
73 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
74 <para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
75 The second argument determines the level of logging. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
76 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
|
77 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
|
78 the specified and more severe log levels to be logged. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
79 For example, the default level <value>error</value> will |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
80 cause <value>error</value>, <value>crit</value>, |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
81 <value>alert</value>, and <value>emerg</value> messages |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
82 to be logged. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
83 <note> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
84 For <value>debug</value> logging to work, nginx needs to |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
85 be configured with <code>--with-debug</code>. |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
86 </note> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
87 </para> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
88 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
89 </directive> |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
90 |
05e58829de2e
Documented the "error_log" directive.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
91 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 <directive name="env"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
93 <syntax><argument>VAR</argument>[=<argument>VALUE</argument>]</syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
94 <default>TZ</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
95 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 Allows to limit a set of environment variables, change their values, |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
99 or create new environment variables, for the following cases: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 <list type="bullet"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 <listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 variable inheritance during a |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 <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
|
105 of an executable file; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
107 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
108 <listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
109 use of variables by the module |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
110 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
111 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
112 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
113 <listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
114 use of variables by worker processes. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
115 Please bear in mind that controlling system libraries in this way |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
116 is not always possible as it is not uncommon for libraries to check |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
117 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
|
118 using this directive. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
119 An exception from this is an above mentioned |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
120 <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
|
121 of an executable file. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
122 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
123 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
124 </list> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
125 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 The TZ variable is always inherited and made available to the module |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
129 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>, |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
130 unless configured explicitly. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
131 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
132 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
134 Usage example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
135 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
136 env MALLOC_OPTIONS; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
137 env PERL5LIB=/data/site/modules; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
138 env OPENSSL_ALLOW_PROXY_CERTS=1; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
139 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
140 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
141 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
142 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
143 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
144 <directive name="include"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
145 <syntax><argument>file</argument> | <argument>mask</argument></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
146 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
147 <context/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
148 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
149 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
150 Includes another <argument>file</argument>, or files matching the |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
151 specified <argument>mask</argument>, into configuration. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
152 Included files should consist of |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
153 syntactically correct directives and blocks. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
154 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
155 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
156 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
157 Usage example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
158 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
159 include mime.types; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
160 include vhosts/*.conf; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
161 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
162 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
163 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
164 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
165 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
166 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
167 <directive name="master_process"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
168 <syntax><value>on</value> | <value>off</value></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
169 <default>on</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
170 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
171 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
172 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
173 Determines whether worker processes are started. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
174 This directive is intended for nginx developers. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
175 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
176 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
177 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
178 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
179 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
180 <directive name="pid"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
181 <syntax><argument>file</argument></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
182 <default>nginx.pid</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
183 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
184 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
185 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
186 Defines a <argument>file</argument> which will store the process ID of the main process. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
187 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
188 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
189 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
190 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
191 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
192 <directive name="ssl_engine"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
193 <syntax><argument>device</argument></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
194 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
195 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
196 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
197 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
198 Defines the name of the hardware SSL accelerator. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
199 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
200 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
201 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
202 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
203 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
204 <directive name="timer_resolution"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
205 <syntax><argument>interval</argument></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
206 <default/> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
207 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
208 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
209 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
210 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
|
211 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
|
212 By default, <c-func>gettimeofday</c-func> is called each time |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
213 on receiving a kernel event. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
214 With reduced resolution, <c-func>gettimeofday</c-func> is only |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
215 called once per specified <argument>interval</argument>. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
216 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
217 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
218 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
219 Example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
220 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
221 timer_resolution 100ms; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
222 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
223 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
224 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
225 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
226 An internal implementation of interval depends on the method used: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
227 <list type="bullet"> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
228 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
229 <listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
230 an <c-def>EVFILT_TIMER</c-def> filter if <value>kqueue</value> is used; |
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> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
234 <c-func>timer_create</c-func> if <value>eventport</value> is used; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
235 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
236 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
237 <listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
238 <c-func>setitimer</c-func> otherwise. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
239 </listitem> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
240 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
241 </list> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
242 </para> |
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 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
245 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
246 |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
247 <directive name="user"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
248 <syntax><argument>user</argument> [<argument>group</argument>]</syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
249 <default>nobody nobody</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
250 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
251 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
252 <para> |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
253 Defines <argument>user</argument> and <argument>group</argument> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
254 credentials used by worker processes. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
255 If <argument>group</argument> is omitted, a group whose name equals |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
256 that of <argument>user</argument> is used. |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
257 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
258 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
259 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
260 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
261 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
262 <directive name="worker_priority"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
263 <syntax><argument>number</argument></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
264 <default>0</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
265 <context>main</context> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
266 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
267 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
268 Defines a scheduling priority for worker processes like is |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
269 done by the <command>nice</command> command: a negative |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
270 <argument>number</argument> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
271 means higher priority. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
272 Allowed range normally varies from -20 to 20. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
273 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
274 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
275 <para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
276 Example: |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
277 <example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
278 worker_priority -10; |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
279 </example> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
280 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
281 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
282 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
283 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
284 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
285 <directive name="worker_processes"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
286 <syntax><argument>number</argument></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
287 <default>1</default> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
288 <context>main</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> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
291 Defines the number of worker processes. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
292 </para> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
293 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
294 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
295 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
296 |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
297 <directive name="worker_rlimit_core"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
298 <syntax><argument>size</argument></syntax> |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
299 <default/> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
300 <context>main</context> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
301 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
302 <para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
303 Changes the limit on the largest size of a core file |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
304 (<c-def>RLIMIT_CORE</c-def>) for worker processes. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
305 Used to increase the limit without restarting the main process. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
306 </para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
307 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
308 </directive> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
309 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
310 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
311 <directive name="worker_rlimit_nofile"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
312 <syntax><argument>number</argument></syntax> |
82
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
313 <default/> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
314 <context>main</context> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
315 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
316 <para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
317 Changes the limit on the maximum number of open files |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
318 (<c-def>RLIMIT_NOFILE</c-def>) for worker processes. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
319 Used to increase the limit without restarting the main process. |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
320 </para> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
321 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
322 </directive> |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
323 |
89c31b453d40
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
63
diff
changeset
|
324 |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
325 <directive name="working_directory"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
326 <syntax><argument>directory</argument></syntax> |
63
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
327 <default/> |
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 Defines a current working directory for a worker process. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
332 It is primarily used when writing a core-file, in which case |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
333 a working process should have write permission for the |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
334 specified directory. |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
335 </para> |
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 </directive> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
338 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
339 </section> |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
340 |
6108fd3217e7
Initial English translation of ngx_core_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
341 </module> |