comparison xml/en/docs/switches.xml @ 1328:b35cdfabe949

Command-line parameters: English article added.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 03 Oct 2014 18:49:33 +0400
parents
children 7ac25c159209
comparison
equal deleted inserted replaced
1327:03741fb502f4 1328:b35cdfabe949
1 <!--
2 Copyright (C) Igor Sysoev
3 Copyright (C) Nginx, Inc.
4 -->
5
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
7
8 <article name="Command-line parameters"
9 link="/en/docs/switches.html"
10 lang="en"
11 rev="2">
12
13 <section>
14
15 <para>
16 nginx supports the following command-line parameters:
17 <list type="bullet">
18
19 <listitem>
20 <literal>-?</literal> | <literal>-h</literal>&mdash;print help
21 for command-line parameters.
22 </listitem>
23
24 <listitem>
25 <literal>-c <value>file</value></literal>&mdash;use an alternative
26 configuration <value>file</value> instead of a default file.
27 </listitem>
28
29 <listitem>
30 <literal>-g <value>directives</value></literal>&mdash; set
31 <link doc="ngx_core_module.xml">global configuration directives</link>,
32 for example,
33 <programlisting>
34 nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;"
35 </programlisting>
36 </listitem>
37
38 <listitem>
39 <literal>-p <value>prefix</value></literal>&mdash;set nginx path prefix,
40 i.e. a directory that will keep server files
41 (default value is <value>/usr/local/nginx</value>).
42 </listitem>
43
44 <listitem>
45 <literal>-q</literal>&mdash;suppress non-error messages
46 during configuration testing.
47 </listitem>
48
49 <listitem>
50 <literal>-s <value>signal</value></literal>&mdash;send a <i>signal</i>
51 to the master process.
52 The argument <i>signal</i> can be one of:
53 <list type="bullet">
54 <listitem>
55 <literal>stop</literal>&mdash;shut down quickly
56 </listitem>
57 <listitem>
58 <literal>quit</literal>&mdash;shut down gracefully
59 </listitem>
60 <listitem>
61 <literal>reload</literal>&mdash;reload configuration,
62 start the new worker process with a new configuration,
63 gracefully shut down old worker processes.
64 </listitem>
65 <listitem>
66 <literal>reopen</literal>&mdash;reopen log files
67 </listitem>
68 </list>
69 </listitem>
70
71 <listitem>
72 <literal>-t</literal>&mdash; test the configuration file: nginx checks the
73 configuration for correct syntax, and then tries to open files
74 referred in the configuration.
75 </listitem>
76
77 <listitem>
78 <literal>-v</literal>&mdash;print nginx version.
79 </listitem>
80
81 <listitem>
82 <literal>-V</literal>&mdash;print nginx version, compiler version,
83 and configurŠµ parameters.
84 </listitem>
85
86 </list>
87 </para>
88
89 </section>
90
91 </article>