start-stop-daemon.8 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244
  1. .\" Hey, Emacs! This is an -*- nroff -*- source file.
  2. .\"
  3. .\" Updated by <alexm@hsys.msk.ru> to r1.11 of start-stop-daemon.8 from CVS
  4. .\"
  5. .TH START\-STOP\-DAEMON 8 "15 марта 1997" "Debian Project" "Debian GNU/Linux"
  6. .SH ИМЯ
  7. start\-stop\-daemon \- запуск и остановка системных программ-демонов
  8. .SH ОБЗОР
  9. .B start-stop-daemon
  10. .BR -S|--start
  11. .I флаги
  12. .RB [ \-\- ]
  13. .IR аргументы
  14. .HP
  15. .B start-stop-daemon
  16. .BR -K|--stop
  17. .IR "флаги ..."
  18. .HP
  19. .B start-stop-daemon
  20. .BR -H|--help
  21. .HP
  22. .B start-stop-daemon
  23. .BR -V|--version
  24. .SH ОПИСАНИЕ
  25. .B start\-stop\-daemon
  26. используется для управления созданием и завершением системных процессов.
  27. Используя флаги
  28. .BR --exec ,
  29. .BR --pidfile ,
  30. .BR --user ,
  31. и
  32. .BR --name ,
  33. .B start\-stop\-daemon
  34. может быть настроен для поиска уже запущенных экземпляров
  35. процесса.
  36. .B start\-stop\-daemon
  37. с флагом
  38. .B --start
  39. проверяет существование указанного процесса. Если такой процесс существует,
  40. .B start\-stop\-daemon
  41. ничего не делает и прекращает работу с кодом завершения\~1 (или\~0, если задан
  42. флаг
  43. .BR --oknodo ).
  44. Если же такой процесс не существует, то он запускается, используя либо
  45. исполняемый файл, заданный флагом
  46. .BR --exec ,
  47. либо флагом
  48. .BR --startas ,
  49. если он задан).
  50. Аргументы, заданные в командной строке после
  51. .BR -- ,
  52. будут без изменений переданы запускаемой программе.
  53. Если указан флаг
  54. .BR --retry ,
  55. то
  56. .B start-stop-daemon
  57. станет отслеживать завершение процесса(ов).
  58. .B start\-stop\-daemon
  59. с флагом
  60. .BR --stop
  61. также проверяет существование заданного процесса.
  62. Если такой процесс существует, то
  63. .B start\-stop\-daemon
  64. посылает ему сигнал, заданный флагом
  65. .BR --signal ,
  66. и прекращает работу с кодом завершения\~0.
  67. Если же такой процесс не существует, то
  68. .B start\-stop\-daemon
  69. прекращает работу с кодом завершения\~1 (или\~0, если задан флаг
  70. .BR --oknodo ).
  71. .SH ФЛАГИ
  72. .TP
  73. \fB-x\fP|\fB--exec\fP \fIисполняемый_файл\fP
  74. Проверяет процессы, которые являются экземплярами данного исполняемого файла
  75. (согласно
  76. .BR /proc/\fP\fIpid\fB/exe ).
  77. .TP
  78. \fB-p\fP|\fB--pidfile\fP \fIpid-файл\fP
  79. Проверяет процессы, чьи идентификаторы процесса записаны в
  80. .IR pid-файл .
  81. .TP
  82. \fB-u\fP|\fB--user\fP \fIимя_пользователя\fP|\fIuid\fP
  83. Проверяет процессы, принадлежащие пользователю, указанному с помощью
  84. .I имени_пользователя
  85. или
  86. .IR uid .
  87. .TP
  88. \fB-n\fP|\fB--name\fP \fIprocess-name\fP
  89. Проверяет процессы с именем
  90. .I process-name
  91. (согласно
  92. .BR /proc/\fP\fIpid\fB/stat ).
  93. .TP
  94. \fB-s\fP|\fB--signal\fP \fIsignal\fP
  95. При использовании вместе с флагом
  96. .BR --stop ,
  97. задаёт сигнал, который будет послан процессам для их останова
  98. (по умолчанию\~15).
  99. .TP
  100. \fB-R\fP|\fB--retry\fP \fIтайм-аут\fP|\fIзатем\fP
  101. При использовании вместе с флагом
  102. .B --stop
  103. указывает, что
  104. .B start-stop-daemon
  105. должен проверять следить за правильным завершением процесса.
  106. Периодически будет проверяться, выполняются ли ещё указанные процессы,
  107. до тех пор, пока все они не завершатся. Если процессы не завершаются,
  108. то будет предпринято действие, заданное в параметре
  109. .IR затем .
  110. Если вместо параметра
  111. .I затем
  112. указан
  113. .IR тайм-аут ,
  114. то используется последовательность действий
  115. .IB сигнал / timeout /KILL/ timeout\fR,
  116. где
  117. .IR signal "\~--"
  118. это сигнал, заданный флагом
  119. .BR --signal .
  120. Вообще, параметр
  121. .IR затем "\~--"
  122. это последовательность из не менее двух элементов, разделённых косой
  123. чертой
  124. .RB ( / );
  125. причём каждый элемент -- это либо
  126. .BI - номер-сигнала
  127. или [\fB-\fP]\fIназвание-сигнала\fP,
  128. или
  129. .IR тайм-аут ,
  130. задающий количество секунд, в течение которых следует ждать завершения
  131. процесса, или же слово
  132. .BR forever ,
  133. предписывающее повторять остаток последовательности до предела, если
  134. нужно.
  135. Если достигнут конец последовательности действий, а
  136. .B forever
  137. не было указано, то
  138. .B start-stop-daemon
  139. прекращает работу с кодом завершения\~2.
  140. Если параметр
  141. .I затем
  142. указан, то сигнал, заданный с помощью флага
  143. .BR --signal ,
  144. игнорируется.
  145. .TP
  146. \fB-a\fP|\fB--startas\fP \fIполное_имя\fP
  147. При использовании с флагом
  148. .B --start
  149. запускает процесс, указанный в параметре
  150. .IR полное_имя .
  151. Если этот флаг не задан, то берётся аргумент, заданный флагом
  152. .BR --exec .
  153. .TP
  154. .BR -t | --test
  155. Напечатать действия, которые должны быть выполнены и установить соответствующий
  156. код завершения, но не выполнять эти действия.
  157. .TP
  158. .BR -o | --oknodo
  159. Возвращать код\~0 вместо\~1, если не было выполнено (или не должно
  160. было быть выполнено) никаких действий.
  161. .TP
  162. .BR -q | --quiet
  163. Не выдавать информационных сообщений; только сообщения об ошибках.
  164. .TP
  165. \fB-c\fP|\fB--chuid\fP \fIимя-пользователя\fR|\fIuid\fP
  166. Установить данное имя пользователя или uid перед запуском процесса. Вы можете
  167. также задать группу, добавив двоеточие
  168. .BR : ,
  169. и имя группы или gid, как в команде `chown'
  170. (\fIпользователь\fP\fB:\fP\fIгруппа\fP).
  171. При использовании этого флага вы должны понимать, что основная и
  172. дополнительные группы будут установлены, даже если не задан флаг
  173. .BR --group .
  174. Флаг
  175. .B --group
  176. используется только для групп, в которых пользователь обычно не
  177. состоит (например, в случае с системным пользователем `nobody').
  178. .TP
  179. \fB-r\fP|\fB--chroot\fB \fIroot\fP
  180. Перед запуском процесса перейти в каталог
  181. .I root
  182. и сделать его корневым (с помощью
  183. .BR chroot ).
  184. Заметьте, что pid-файл будет создан после установки нового корневого
  185. каталога.
  186. .TP
  187. .BR -b | --background
  188. Этот флаг обычно используется с программами, которые не могут сами
  189. отключиться от терминала, на котором они запущены. Этот флаг заставит
  190. .B start-stop-daemon
  191. сделать fork() перед запуском процесса и уйти в фоновый режим.
  192. .B ВНИМАНИЕ: start-stop-daemon
  193. не может проверить код возврата, если процесс не может успешно выполниться по
  194. .I какой бы то ни было
  195. причине. Это\~-- последняя возможность, предназначенная только для
  196. программ, которым не имеет смысла выполнять fork() самим, или если нет
  197. возможности добавить в них код для этого.
  198. .TP
  199. .BR -n | --nicelevel
  200. Этот флаг перед запуском изменяет приоритет процесса.
  201. .TP
  202. .BR -m | --make-pidfile
  203. Этот флаг используется, если запускаемая программа не создаёт свой
  204. собственный pid-файл. При этом
  205. .B start-stop-daemon
  206. непосредственно перед запуском процесса создаст файл, указанный в
  207. параметре флага
  208. .B --pidfile
  209. и поместит в него pid запускаемого процесса. Заметьте, что этот файл
  210. не будет удалён при остановке программы.
  211. .B ЗАМЕЧАНИЕ:
  212. Эта возможность иногда может не работать: в основном это случается,
  213. когда запускаемая программа выполняет fork(). Поэтому данный флаг
  214. обычно бывает полезен только при использовании вместе с флагом
  215. .BR --background .
  216. .TP
  217. .BR -v | --verbose
  218. Выдавать подробные информационные сообщения.
  219. .TP
  220. .BR -H | --help
  221. Выдать подсказку и завершиться.
  222. .TP
  223. .BR -V | --version
  224. Выдать информацию о версии и завершиться.
  225. .SH АВТОРЫ
  226. Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl>, основываясь
  227. на версии, сделанной by Ian Jackson <ian@chiark.greenend.org.uk>.
  228. Страница руководства by Klee Dienes <klee@mit.edu>, частично
  229. переформатировано by Ian Jackson.
  230. .SH ПЕРЕВОД
  231. Перевёл с английского Виктор Вислобоков <victor_v@permonline.ru>.
  232. Обновление и корректура: Alexey Mahotkin <alexm@hsys.msk.ru>.