spawn−fcgi

НАЗВАНИЕ
ОБЗОР
ОПИСАНИЕ
ОПЦИИ
СМОТРИТЕ ТАКЖЕ
АВТОР ПЕРЕВОДА

НАЗВАНИЕ

spawn−fcgi − порождает процессы FastCGI

ОБЗОР

spawn−fcgi [опции] [ −− <приложение−fcgi> [аргументы приложения fcgi]]

spawn−fcgi −v

spawn−fcgi −h

ОПИСАНИЕ

spawn−fcgi используется для порождения удалённых и локальных процесоов FastCGI.

Обычно требуется порождать только удалённые бэкэнды FastCGI (веб−сервер может порождать только локальные), но также рекомендуется порождать с помощью spawn−fcgi и локальные бэкэнды.

Причины, по которым вы можете предпочесть воспользоваться именно spawn−fcgi:

*

Разделение привилегий без необходимости использовать выполняемые файлы с битом suid или запускать сервер от имени пользователя root.

*

Вы можете перезапустить ваш веб−сервер и приложения FastCGI по отдельности.

*

Вы можете запустить их в разных средах с изменённым коренвым каталогом chroot.

*

Запуск ваших приложений FastCGI не зависит от запущенного вами веб−сервера, что упрощает тестировние других веб−серверов.

ОПЦИИ

spawn−fcgi принимает следующие опции:
−f <путь>

Имя файла порождаемого приложения FastCGI. Эта опция нежелательна и рекомендуется всегда указывать полный путь к приложению и его параметры после символов "−−"; параметры приложения fcgi передаются прямо в системный вызов exec(), поэтому для запуска некоторых файлов может потребоваться указать оболочку −f /bin/sh (которая может быть недоступна в среде с изменённым корневым каталогом chroot).

Эта опция игнорируется, если задано приложение fcgi.

−d <путь>

Поменять текущий каталог перед порождением приложения.

−a <адрес>

Адрес IPv4/IPv6, на котором следует ожидать соединений; используется только если задана опция −p. По умолчанию используется адрес "0.0.0.0" (IPv4).

−p <порт>

Прослушиваемый порт TCP; вы не можете сочетать эту опцию с опцией −s.

−s <путь>

Путь к сокету домена Unix, на котором следует ожидать соединений; вы не можете сочетать эту опцию с опцией −p.

−C <дети>

(Только PHP) Количество порождаемых дочерних процессов, настраивается в переменной окружения PHP_FCGI_CHILDREN. По умолчанию существующая переменная окружения не заменяется; php не породит дочерних процессов, если эта переменная не настроена (что равнонзначно значению 0).

−F <дети>

Количество дочерних процессов, по умолчанию 1. Эта опция не работает совместно с опцией −n. Обратитесь к multiwatch(1) если хотите, чтобы один сокет обслуживало несколько процессов.

−b <фоновые−соединения>

Количество фоновых соединений, доступных на сокете (по умолчанию 1024). Обычно оно также ограничивается ядром, проверьте параметр net.core.somaxconn (по умолчанию − 128) в sysctl linux.

Фоновые соединения − это очередь подключений, которые ядро принимает перед тем как они поступят в приложение.

−P <путь>

Имя файла, в котором будут храниться идентификаторы порождаемых процессов (игнорируется в режиме без запуска дочерних процессов)

−n

Порождения дочерних процессов не производится (для daemontools)

−M <режим>

Поменять режим доступа к сокету домена Unix (восьмеричное целое число); используется только если задана опция −s. По умолчанию разрешается чтение и запись для пользователя и группы (0660) в той мере, насколько это позволяется umask.

−?, −h

Общая справка по использованию

−v

Показать информацию о версии и завершить работу

Следующие опции доступны только если spawn−fcgi запущен от имени пользователя root:
−c <каталог>

Изменить корневой каталог процесса на указанный; сокет домена Unix создаётся внутри среды с изменённым корневым каталогом, если не задана опция −S.

−S

Создать сокет домена Unix перед сменой корневого каталога.

−u

Идентификатор пользователя, который необходимо использовать во время работы.

−g

Идентификатор группы, которую необходимо использовать при работе. По умолчанию используется первичная группа пользователя, заданного в опции −u.

−U

Поменять владельца сокета домена Unix, по умолчанию используется значение из опции −u. (Используется только если задана опция −s).

−G

Поменять группу владельца сокета домена Unix, по умолчанию используется первичная группа пользователя, указанная в опции −U; если −U не была задана, по умолчанию используется значение опции −g. (Используется только если указана опция −s).

СМОТРИТЕ ТАКЖЕ

svc(8), supervise(8), http://cr.yp.to/daemontools.html

multiwatch(1), http://cgit.stbuehler.de/gitosis/multiwatch/about/

АВТОР ПЕРЕВОДА

Перевод на русский язык выполнил Владимир Ступин <vladimir@stupin.su>.