Manpages

НАЗВАНИЕ

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

СИНТАКСИС

start−stop−daemon −S|−−start параметры [−−] аргументы

ОПИСАНИЕ

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

start−stop−daemon с параметром −−start проверяет существование указанного процесса. Если такой процесс существует, start−stop−daemon ничего не делает и прекращает работу с кодом завершения 1 (или 0, если задан параметр −−oknodo). Если же такой процесс не существует, то он запускается, используя либо исполняемый файл, заданный параметром −−exec, (либо параметром −−startas). Все аргументы, заданные в командной строке после −−, будут без изменений переданы запускаемой программе.

start−stop−daemon с параметром −−stop также проверяет существование заданного процесса. Если такой процесс существует, то start−stop−daemon посылает ему сигнал, заданный параметром −−signal и прекращает работу с кодом завершения 0. Если такой процесс не существует, то start−stop−daemon прекращает работу с кодом завершения 1 (или 0, если задан параметр −−oknodo). Если указан параметр −−retry, то start−stop−daemon будет проверять, что процесс(ы) завершили работу.

Note: unless −−pidfile is specified, start−stop−daemon behaves similar to killall(1). start−stop−daemon will scan the process table looking for any processes which match the process name, uid, and/or gid (if specified). Any matching process will prevent −−start from starting the daemon. All matching processes will be sent the KILL signal if −−stop is specified. For daemons which have long−lived children which need to live through a −−stop you must specify a pidfile.

ПАРАМЕТРЫ

−x|−−exec исполняемый_файл

Проверить процессы, которые являются экземплярами данного исполняемого файла (согласно /proc/pid/exe).

−p|−−pidfile pid−файл

Проверить какой процесс создал pid−файл.

−u|−−user имя_пользователя|uid

Проверить процессы, принадлежащие пользователю, указанному с помощью имени_пользователя или uid.

−g|−−group группа|gid

Изменить группу на группу или gid при запуске процесса.

−n|−−name имя_процесса

Проверить процессы с именем имя_процесса (согласно /proc/pid/stat).

−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

Change to this username/uid before starting the process. You can also specify a group by appending a :, then the group or gid in the same way as you would for the ’chown’ command (user:group). When using this option you must realize that the primary and supplemental groups are set as well, even if the −−group option is not specified. The −−group option is only for groups that the user isn’t normally a member of (like adding per process group membership for generic users like nobody).

−r|−−chroot root

Перед запуском процесса перейти в каталог root и сделать его корневым. Заметим, что pid−файл будет создан после установки нового корневого каталога.

−d|−−chdir путь

Перейти в каталог путь перед запуском процесса. Это действие выполняется после выполнения действий согласно параметру −r|−−chroot если он задан. Если он не указан, то start−stop−daemon переходит в корневой каталог перед запуском процесса.

−b|−−background

Typically used with programs that don’t detach on their own. This option will force start−stop−daemon to fork before starting the process, and force it into the background. WARNING: start−stop−daemon cannot check the exit status if the process fails to execute for any reason. This is a last resort, and is only meant for programs that either make no sense forking on their own, or where it’s not feasible to add the code for them to do this themself.

−N|−−nicelevel int

Этот параметр перед запуском изменяет приоритет процесса.

−k|−−umask mask

This sets the umask of the process before starting it.

−m|−−make−pidfile

Used when starting a program that does not create its own pid file. This option will make start−stop−daemon create the file referenced with −−pidfile and place the pid into it just before executing the process. Note, the file will not be removed when stopping the program. NOTE: This feature may not work in all cases. Most notably when the program being executed forks from its main process. Because of this it is usually only useful when combined with the −−background option.

−v|−−verbose

Выдавать подробные информационные сообщения.

−H|−−help

Выдать подсказку и завершить работу.

−V|−−version

Выдать информацию о версии и завершить работу.

АВТОРЫ

Marek Michalkiewicz <marekm [AT] i17linuxb.pl> основываясь на версии, сделанной Ian Jackson <ian [AT] chiark.uk>.

Страница руководства написана Klee Dienes <klee [AT] mit.edu>, частично переформатировано Ian Jackson.

ПЕРЕВОД

Перевёл с английского Виктор Вислобоков <victor_v [AT] permonline.ru>. Обновление и корректура: Alexey Mahotkin <alexm [AT] hsys.ru>.