Mercurial > hg > nginx-site
diff 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 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/xml/en/docs/switches.xml Fri Oct 03 18:49:33 2014 +0400 @@ -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>