Переводы страниц руководства

НАЗВАНИЕ

start-stop-daemon - запуск и остановка системных программ-демонов

ОБЗОР

start-stop-daemon [опции] команда

ОПИСАНИЕ

start-stop-daemon используется для управления созданием и завершением системных процессов. Используя одну из опций совпадения, start-stop-daemon может быть настроен для поиска существующих экземпляров запущенных процессов.

Замечание: пока не указана опция --pidfile, start-stop-daemon поступает аналогично killall(1). start-stop-daemon просмотрит таблицу процессов в поисках любых процессов с подходящим именем, uid и/или gid (если указан). Любой подходящий процесс предохранит --start от запуска демона. Всем подходящим процессам будет отправлен сигнал KILL, если указана --stop. Для демонов, которые имеют долгоживущих детей, которых нужно оставить работающими после --stop, вы должны указать PID-файл.

КОМАНДЫ

-S, --start [--] аргументы
	Проверить существование указанных процессов. Если такие процессы существуют, start-stop-daemon ничего не делает, и завершает работу с кодом ошибки 1 (0 - если указана --oknodo). Если такие процессы не существуют, он запускает экземпляр, используя любой выполняемый файл, указанный опцией --exec или, если указано, опцией --startas. Любые аргументы, следующие в командной строке за -- передаются неизменными в запускаемую программу.
-K, --stop	Проверяет существование указанного процесса. Если такие процессы существуют, start-stop-daemon отправит сигнал, указанный опцией --signal и завершит работу с кодом ошибки 1 (0 - если указана --oknodo). Если указана опция --retry, тогда start-stop-daemon проверяет, что эти процессы были завершены.
-H, --help	Показать справку по использованию и завершить работу.
-V, --version
	Показать версию программы и завершить работу.

ОПЦИИ СОВПАДЕНИЯ

-p, --pidfile PID-файл
	Проверить, что процесс создал файл PID-файл.
-x, --exec исполняемый
	Проверить, что процесс является экземпляром указанного исполняемого файла (в соответствии с /proc/pid/exe).
-n, --name название-процесса
	Проверить процессы с именем название-процесса (в соответствии с /proc/pid/stat).
-u, --user имя-пользователя|uid
	Проверить, что процесс принадлежит пользователю с указанным именем или uid (идентификатором пользователя).

ОПЦИИ

-g, --group группа|gid
	Сменить группу или gid при запуске процесса.
-s, --signal сигнал
	Совместно с опцией --stop указывает сигнал, который будет отправлен останавливаемому процессу (по умолчанию 15).
-R, --retry тайм-аут|расписание
	Совместно с опцией --stop указывает, что start-stop-daemon дополнительно проверяет, что процесс был завершён. Он выполняет проверки повторно, пока есть подходящие работающие процессы, пока они не исчезнут. Если процесс не завершается, он предпринимает дальнейшие действия, предписанные расписанием. Если вместо расписания указан тайм-аут, тогда используется расписание сигнал/тайм-аут/KILL/тайм-аут, где сигнал - это сигнал указанный с помощью --signal. Расписание - это список по меньшей мере из двух элементов, разделённых косыми чертами (/); каждый элемент может быть -номером-сигнала или [-]именем-сигнала, которые означают отправку сигнала, или тайм-аутом, который обозначает сколько секунд ждать завершения процесса, или forever (бесконечно), что означает повторять остаток задания бесконечно, если это необходимо. Если достигнут конец задания и forever не указано, тогда start-stop-daemon завершит работу с кодом ошибки 2. Если задание указано, то любой сигнал, указанный с помощью --signal, будет проигнорирован.
-a, --startas путь
	Совместно с опцией --start, запускает процесс, указанный путевым именем. Если не указан, по умолчанию используется аргумент, указанный опцией --exec.
-t, --test	Вывести предпринимаемые действия и установить соответствующее возвращённое значение, но не предпринимать действий.
-o, --oknodo
	Вернуть статус завершения 0 вместо 1, если действия не (были) предприняты.
-q, --quiet
	Не выводить информационные сообщения; отображать только сообщения об ошибках.
-c, --chuid имя-пользователя|uid
	Изменить имя пользователя/uid перед запуском процесса. Вы также можете указать группу, указав её через :, тогда группа или gid в этом случае будут указаны способом, подобным команде ’chown’ (пользователь:группа). Если пользователь указан без группы, используется первичный gid пользователя. При использовании этой опции вы должны понимать, что первичная и дополнительные группы обрабатываются необходимым образом, даже если опция --group не была указана. Опция --group используется только для тех групп, членами которых пользователь не является (например, при назначении процессам членства в группе обобщённых пользователей, таких как nobody).
-r, --chroot корень
	Перед запуском процесса сменить текущий каталог и сменить корень на указанный. Помните, что PID-файл также будет записан после смены корня.
-d, --chdir путь
	Перед запуском процесса сменить текущий каталог на указанный. Это выполняется после смены корня, если была указана опция -r|--chroot. Если не указана, start-stop-daemon перед запуском процесса изменит текущий каталог на корневой каталог.
-b, --background
	Обычно используется с программами, которые не отключаются от их владельца. Эта опция заставит start-stop-daemon разделиться перед запуском процесса, и заставит его перейти в фоновый режим. ПРЕДУПРЕЖДЕНИЕ: start-stop-daemon не может проверить статус завершения, если процесс завершился с ошибкой по какой-либо причине. Это последняя попытка и она не применяется к тем программам, которые не чувствительны к ответвлению от её владельца, или когда невозможно добавить исполнимый код к ней для того, чтобы сделать её такой.
-N, --nicelevel число-со-знаком
	Изменяет приоритет процесса перед его запуском.
-k, --umask маска
	Задаёт маску процесса перед его запуском.
-m, --make-pidfile
	Используется при запуске программы, которая не создаёт собственный PID-файл. Эта опция позволяет start-stop-daemon создать файл, указанный опцией --pidfile и поместить PID внутрь него, перед выполнением процесса. Отметим, что он не будет удалён при остановке программы. ЗАМЕЧАНИЕ: Эта функция может не сработать во всех случаях. Большинство особых программ при запуске ответвляются от своего главного процесса. Поэтому данная опция может быть полезна только в сочетании с опцией --background.
-v, --verbose
	Выводить подробные информационные сообщения.

EXIT STATUS

start-stop-daemon возвращает 0, если запрошенное действие было произведено, или если указана --oknodo и также был указан --start и совпадающие процессы уже запущены, или указана --stop и нет совпадающих процессов. Если --oknodo не была указана и ничего не было сделано, возвращается 1. Если была указана --stop и --retry, но был достигнут конец задания и процесс всё ещё запущен, значение ошибки - 2. При возникновении остальных ошибок, код завершения - 3.

ПРИМЕР

Запуск демона food, если не запущен хотя-бы один (процесс с именем food, запущенный как пользователь food, с PID в файле food.pid):

	start-stop-daemon --start --oknodo --user food --name food --pidfile /var/run/food.pid --startas /usr/sbin/food --chuid food -- --daemon
Отправить SIGTERM процессу food и подождать его остановки, не более 5 секунд:
	start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5
Демонстрация особого расписания для остановки food:
	start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry=TERM/30/KILL/5

АВТОРЫ

Марек Михалкевич (Marek Michalkiewicz) <marekm@i17linuxb.ists.pwr.wroc.pl> основываясь на предыдущей версии от Йена Джексона (Ian Jackson) <ian@chiark.greenend.org.uk>.

Страница руководства от Кли Дайнес (Klee Dienes) <klee@mit.edu>, частично переформатировано Йеном Джексоном (Ian Jackson).

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

Перевод выполнен на сайте коллективных переводов http://translated.by. Авторы перевода Владимир Ступин <wheelof@gmail.com>, Олег Безначев aka saturn721.