Mercurial > hg > nginx-site
changeset 1328:b35cdfabe949
Command-line parameters: English article added.
| author | Yaroslav Zhuravlev <yar@nginx.com> |
|---|---|
| date | Fri, 03 Oct 2014 18:49:33 +0400 |
| parents | 03741fb502f4 |
| children | 3d29c4c81b51 |
| files | xml/en/GNUmakefile xml/en/docs/index.xml xml/en/docs/switches.xml |
| diffstat | 3 files changed, 96 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/GNUmakefile +++ b/xml/en/GNUmakefile @@ -4,6 +4,7 @@ DOCS = \ windows \ events \ syntax \ + switches \ control \ hash \ syslog \
--- a/xml/en/docs/index.xml +++ b/xml/en/docs/index.xml @@ -54,6 +54,10 @@ </listitem> <listitem> +<link doc="switches.xml"/> +</listitem> + +<listitem> <link doc="windows.xml"/> </listitem>
new file mode 100644 --- /dev/null +++ b/xml/en/docs/switches.xml @@ -0,0 +1,91 @@ +<!-- + Copyright (C) Igor Sysoev + Copyright (C) Nginx, Inc. + --> + +<!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> + +<article name="Command-line parameters" + link="/en/docs/switches.html" + lang="en" + rev="2"> + +<section> + +<para> +nginx supports the following command-line parameters: +<list type="bullet"> + +<listitem> +<literal>-?</literal> | <literal>-h</literal>—print help +for command-line parameters. +</listitem> + +<listitem> +<literal>-c <value>file</value></literal>—use an alternative +configuration <value>file</value> instead of a default file. +</listitem> + +<listitem> +<literal>-g <value>directives</value></literal>— set +<link doc="ngx_core_module.xml">global configuration directives</link>, +for example, +<programlisting> +nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;" +</programlisting> +</listitem> + +<listitem> +<literal>-p <value>prefix</value></literal>—set nginx path prefix, +i.e. a directory that will keep server files +(default value is <value>/usr/local/nginx</value>). +</listitem> + +<listitem> +<literal>-q</literal>—suppress non-error messages +during configuration testing. +</listitem> + +<listitem> +<literal>-s <value>signal</value></literal>—send a <i>signal</i> +to the master process. +The argument <i>signal</i> can be one of: +<list type="bullet"> +<listitem> +<literal>stop</literal>—shut down quickly +</listitem> +<listitem> +<literal>quit</literal>—shut down gracefully +</listitem> +<listitem> +<literal>reload</literal>—reload configuration, +start the new worker process with a new configuration, +gracefully shut down old worker processes. +</listitem> +<listitem> +<literal>reopen</literal>—reopen log files +</listitem> +</list> +</listitem> + +<listitem> +<literal>-t</literal>— test the configuration file: nginx checks the +configuration for correct syntax, and then tries to open files +referred in the configuration. +</listitem> + +<listitem> +<literal>-v</literal>—print nginx version. +</listitem> + +<listitem> +<literal>-V</literal>—print nginx version, compiler version, +and configurŠµ parameters. +</listitem> + +</list> +</para> + +</section> + +</article>