switches.xml

<!--
  Copyright (C) Igor Sysoev
  Copyright (C) Nginx, Inc.
  -->

<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">

<article name="Параметры командной строки nginx"
         link="/ru/docs/switches.html"
         lang="ru"
         rev="4">

<section>

<para>
nginx поддерживает следующие параметры командной строки:
<list type="bullet">

<listitem>
<literal>-?</literal> | <literal>-h</literal>&mdash;вывод справки
по параметрам командной строки.
</listitem>

<listitem>
<literal>-c <value>файл</value></literal>&mdash;использование альтернативного
конфигурационного файла <value>файл</value> вместо файла по умолчанию.
</listitem>

<listitem>
<literal>-e <value>файл</value></literal>&mdash;использование альтернативного
лог-файла ошибок <value>файл</value>
вместо файла по умолчанию (1.19.5).
Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
</listitem>

<listitem>
<literal>-g <value>директивы</value></literal>&mdash;задание
<link doc="ngx_core_module.xml">глобальных директив конфигурации</link>,
например
<programlisting>
nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;"
</programlisting>
</listitem>

<listitem id="l">
<literal>-l <value>порт</value></literal>&mdash;включение
<link url="https://docs.nginx.com/nginx/admin-guide/basic-functionality/runtime-control#control-api">REST API управления nginx</link>
на указанном <value>порту</value> или UNIX-сокете (1.29.8).
<para>
<note>
Параметр доступен как часть
<commercial_version>коммерческой подписки</commercial_version>.
</note>
</para>
</listitem>

<listitem>
<literal>-p <value>префикс</value></literal>&mdash;задание префикса пути nginx,
т.е. каталога, в котором будут находиться файлы сервера
(по умолчанию&mdash;каталог <value>/usr/local/nginx</value>).
</listitem>

<listitem>
<literal>-q</literal>&mdash;вывод только сообщений об ошибках
при тестировании конфигурации.
</listitem>

<listitem>
<literal>-s <value>сигнал</value></literal>&mdash;отправка <i>сигнала</i>
главному процессу.
Аргументом <i>сигнал</i> может быть:
<list type="bullet">
<listitem>
<literal>stop</literal>&mdash;быстрое завершение
</listitem>
<listitem>
<literal>quit</literal>&mdash;плавное завершение
</listitem>
<listitem>
<literal>reload</literal>&mdash;перезагрузка конфигурации,
старт нового рабочего процесса с новой конфигурацией,
плавное завершение старых рабочих процессов.
</listitem>
<listitem>
<literal>reopen</literal>&mdash;переоткрытие лог-файлов
</listitem>
</list>
</listitem>

<listitem>
<literal>-t</literal>&mdash;тестирование конфигурационного файла:
nginx проверяет
синтаксическую правильность конфигурации, а затем пытается открыть файлы,
описанные в конфигурации.
</listitem>

<listitem>
<literal>-T</literal>&mdash;то же, что и <literal>-t</literal>,
а также вывод конфигурационных файлов
в стандартный поток вывода (1.9.2).
</listitem>

<listitem>
<literal>-v</literal>&mdash;вывод версии nginx.
</listitem>

<listitem>
<literal>-V</literal>&mdash;вывод версии nginx, версии компилятора
и параметров конфигурации сборки.
</listitem>

</list>
</para>

</section>

</article>