man/ja/start-stop-daemon.8


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244

.\" dpkg manual page - start-stop-daemon(8)
.\"
.\" Copyright 息 1999 Klee Dienes <klee@mit.edu>
.\" Copyright 息 1999 Ben Collins <bcollins@debian.org>
.\" Copyright 息 2000-2001 Wichert Akkerman <wakkerma@debian.org>
.\" Copyright 息 2002-2003 Adam Heath <doogie@debian.org>
.\" Copyright 息 2004 Scott James Remnant <keybuk@debian.org>
.\" Copyright 息 2008-2012 Guillem Jover <guillem@debian.org>
.\"
.\" This is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH start\-stop\-daemon 8 2012\-01\-14 "Debian Project" "dpkg ユーティリティ"
.SH 名前
start\-stop\-daemon \- システムデーモンプログラムの起動、停止
.
.SH 書式
\fBstart\-stop\-daemon\fP [\fIoption\fP...] \fIcommand\fP
.
.SH 説明
\fBstart\-stop\-daemon\fP はシステムレベルのプロセスの生成や停止を制御するために使用される。また、
適切なオプションを指定することで、実行中のプロセスを確認することができる。
.PP
注記: \fB\-\-pidfile\fP を指定しない場合、\fBstart\-stop\-daemon\fP は \fBkillall\fP(1)
と類似の動作を行う。\fBstart\-stop\-daemon\fP は、(指定されていれば) プロセス名、uid、および gid
にマッチするプロセスをプロセステーブルから検索する。\fB\-\-start\fP
が指定されている場合にマッチするプロセスがあれば、デーモンは起動されない。\fB\-\-stop\fP が指定されていれば、マッチするプロセスすべてに TERM
シグナル (もしくは \fB\-\-signal\fP や \fB\-\-retry\fP により指定されたシグナル) が送られる。そのため、\fB\-\-stop\fP
を指定されても動作しつづける必要があるような、長寿命の子プロセスを持つデーモンには、 pidfile を指定しなければならない。
.
.SH コマンド
.TP 
\fB\-S\fP, \fB\-\-start\fP [\fB\-\-\fP] \fIarguments\fP
指定されたプロセスの存在を確認する。該当するプロセスが存在する場合、 \fBstart\-stop\-daemon\fP は何もせず、エラーステータス 1
を返して終了する (\fB\-\-oknodo\fP が指定された場合は、0 を返す)。該当するプロセスが存在しない場合、 \fB\-\-exec\fP により、もしくは
\fB\-\-startas\fP が指定された場合はこれにより指定される実行ファイルを起動する。コマンドライン上で \fB\-\-\fP
以降に与えられた任意の引数は起動されるプログラムにそのまま引き渡される。
.TP 
\fB\-K\fP, \fB\-\-stop\fP
指定されたプロセスの存在を確認する。該当するプロセスが存在する場合、 \fBstart\-stop\-daemon\fP は \fB\-\-signal\fP
により指定されたシグナルをそのプロセスに送り、エラーステータス 0 を返して終了する。該当するプロセスが存在しない場合、
\fBstart\-stop\-daemon\fP はエラーステータス 1 を返して終了する( \fB\-\-oknodo\fP が指定された場合は 0
を返す)。\fB\-\-retry\fP を指定した場合、\fBstart\-stop\-daemon\fP はそのプロセスが終了したことを確認する。
.TP 
\fB\-T\fP, \fB\-\-status\fP
指定されたプロセスの存在を確認し、LSB の Init Script Action に基づいた終了ステータスを返却する。
.TP 
\fB\-H\fP, \fB\-\-help\fP
使用方法に関する情報を表示し、終了する。
.TP 
\fB\-V\fP, \fB\-\-version\fP
バージョンと著作権に関する情報を表示し、終了する。
.
.SH マッチ用オプション
.TP 
\fB\-p\fP, \fB\-\-pidfile\fP \fIpid\-file\fP
Check whether a process has created the file \fIpid\-file\fP. Note: using this
matching option alone might cause unintended processes to be acted on, if
the old process terminated without being able to remove the \fIpid\-file\fP.
.TP 
\fB\-x\fP, \fB\-\-exec\fP \fIexecutable\fP
Check for processes that are instances of this \fIexecutable\fP. The
\fIexecutable\fP argument should be an absolute pathname. Note: this might not
work as intended with interpreted scripts, as the executable will point to
the interpreter. Take into account processes running from inside a chroot
will also be matched, so other match restrictions might be needed.
.TP 
\fB\-n\fP, \fB\-\-name\fP \fIprocess\-name\fP
Check for processes with the name \fIprocess\-name\fP. The \fIprocess\-name\fP is
usually the process filename, but it could have been changed by the process
itself. Note: on most systems this information is retrieved from the process
comm name from the kernel, which tends to have a relatively short length
limit (assuming more than 15 characters is non\-portable).
.TP 
\fB\-u\fP, \fB\-\-user\fP \fIusername\fP|\fIuid\fP
Check for processes owned by the user specified by \fIusername\fP or
\fIuid\fP. Note: using this matching option alone will cause all processes
matching the user to be acted on.
.
.SH オプション
.TP 
\fB\-g\fP, \fB\-\-group\fP \fIgroup\fP|\fIgid\fP
プロセスを開始する時点で、\fIgroup\fP や \fIgid\fP を変更する。
.TP 
\fB\-s\fP, \fB\-\-signal\fP \fIsignal\fP
\fB\-\-stop\fP と同時に指定することで、プロセスを停止するために送信するシグナルを指定する (デフォルトは TERM)。
.TP 
\fB\-R\fP, \fB\-\-retry\fP \fItimeout\fP|\fIschedule\fP
\fB\-\-stop\fP と同時に指定することで、\fBstart\-stop\-daemon\fP
にプロセスの終了を確認させる。これにより、マッチした実行中のプロセスが全て終了するまで繰り返し確認が行われる。プロセスが終了しなければ、スケジュールにより指定されたアクションが実行される。

\fIschedule\fP のかわりに \fItimeout\fP が指定されている場合、
\fIsignal\fP\fB/\fP\fItimeout\fP\fB/KILL/\fP\fItimeout\fP スケジュールが使われる。ここで \fIsignal\fP は
\fB\-\-signal\fP で指定されるシグナルである。

スケジュール \fIschedule\fP は、スラッシュ (\fB/\fP) で区切られた少なくとも 2
つの要素からなるリストである。それぞれの要素は、\fB\-\fP\fIsignal\-number\fP もしくは [\fB\-\fP]\fIsignal\-name\fP
の場合は送るべきシグナル、 \fItimeout\fP の場合はプロセスが終了するのを待つ秒数、 \fBforever\fP の場合は必要な限り、残りの
\fIschedule\fP を繰り返し適用することを意味する。

\fIschedule\fP が終了し、\fBforever\fP が指定されていない場合、 \fBstart\-stop\-daemon\fP はエラー状態 2
で終了する。schedule が指定されている場合、\fB\-\-signal\fP で指定したシグナルは無視される。
.TP 
\fB\-a\fP, \fB\-\-startas\fP \fIpathname\fP
\fB\-\-start\fP と同時に指定することで、\fIpathname\fP により指定されるプロセスを起動する。このオプションが指定されない場合、
\fB\-\-exec\fP に与えられる引数がデフォルトになる。
.TP 
\fB\-t\fP, \fB\-\-test\fP
実行しようとする処理内容を出力し，それに伴い適切な返り値が設定されるが、実際の処理は行わない。
.TP 
\fB\-o\fP, \fB\-\-oknodo\fP
処理が何も行われない (又は、行なわれないと想定される) 場合、終了ステータス 1 のかわりに 0 を返す。
.TP 
\fB\-q\fP, \fB\-\-quiet\fP
情報メッセージを出力しない。エラーメッセージのみ出力する。
.TP 
\fB\-c\fP, \fB\-\-chuid\fP \fIusername\fP|\fIuid\fP[\fB:\fP\fIgroup\fP|\fIgid\fP]
プロセスを起動する前に指定されたユーザ名やユーザ ID に変更する。 \fB:\fP に続いてグループ名またはグループ ID
を与えることによりグループも指定できる。これは `chown' コマンドと同じ書式 (\fIuser\fP\fB:\fP\fIgroup\fP)
である。ユーザ名のみを指定した場合、そのユーザのプライマリグループの GID が用いられる。このオプション ( \fB:\fP 書式) を使用した時には、
\fB\-\-group\fP
オプションが指定されていない場合であっても、指定された場合と同様にプライマリグループと補助グループが設定されることを認識しておく必要がある。\fB\-\-group\fP
オプションは、(あるプロセスについて \fBnobody\fP のような汎用のユーザをグループに追加するといった)
ユーザが通常メンバとなっていないグループを指定する場合にのみ使用する。
.TP 
\fB\-r\fP, \fB\-\-chroot\fP \fIroot\fP
プロセスを起動する前に、\fIroot\fP に対して chdir と chroot を実行する。pidfile は chroot
後に、書き出されることに注意すること。
.TP 
\fB\-d\fP, \fB\-\-chdir\fP \fIpath\fP
プロセスを起動する前に、\fIpath\fP に chdir する。\fB\-r\fP|\fB\-\-chroot\fP オプションを同時に指定した場合は、chroot の後に
chdir する。そうでない場合、start\-stop\-daemon は、プロセスを起動する前に root ディレクトリに chdir する。
.TP 
\fB\-b\fP, \fB\-\-background\fP
通常、自身をデタッチできないプログラムで使用される。このオプションを指定した場合、 \fBstart\-stop\-daemon\fP
は自身を対象プロセスの起動前に fork し、以後バックグラウンドで実行させる。 \fB警告: start\-stop\-daemon\fP は
\fBいかなる\fP理由によってプロセスの起動に失敗した場合であっても、その終了ステータスをチェックできなくなる。このオプションは最終手段であり、自身の
fork に意味のないプログラムや、fork を自身で行うためのコード追加が現実的でないプログラム以外での使用を意図していない。
.TP 
\fB\-N\fP, \fB\-\-nicelevel\fP \fIint\fP
プロセスを起動する前にプロセスのプライオリティを変更する。
.TP 
\fB\-P\fP, \fB\-\-procsched\fP \fIpolicy\fP\fB:\fP\fIpriority\fP
プロセスを起動する前に、スケジューラのポリシーと優先順位を変更する。優先順位の指定は任意であり、\fB:\fP
に続いて値を設定することで指定する。デフォルトの \fIpriority\fP は 0 である。現在サポートされているポリシーの値は \fBother\fP,
\fBfifo\fP, \fBrr\fP である。
.TP 
\fB\-I\fP, \fB\-\-iosched\fP \fIclass\fP\fB:\fP\fIpriority\fP
プロセスを起動する前に、IO スケジューラのクラスと優先順位を変更する。優先順位の指定は任意であり、\fB:\fP
に続いて値を設定することで指定する。デフォルトの \fIpriority\fP は 4 であるが、\fIclass\fP が \fBidle\fP の場合の
\fIpriority\fP は常に 7 となる。現在サポートされている \fIclass\fP の値は \fBidle\fP, \fBbest\-effort\fP,
\fBreal\-time\fP である。
.TP 
\fB\-k\fP, \fB\-\-umask\fP \fImask\fP
プロセスを起動する前にプロセスの umask を設定する。
.TP 
\fB\-m\fP, \fB\-\-make\-pidfile\fP
自分自身で PID ファイルを作成しないプログラムを起動する際に使用する。このオプションにより、プロセスの起動直前に
\fBstart\-stop\-daemon\fP は \fB\-\-pidfile\fP で参照されるファイルを作成し、pid
の値を格納する。このファイルはプログラムの停止時に削除されないことに注意。\fB注記:\fP
このオプションは動作しない場合がある。特に、プログラムの実行時にそのメインのプロセスから fork
するようなプログラムでは正しく動作しない。このため、通常は \fB\-\-background\fP オプションと併用する場合にのみ有用である。
.TP 
\fB\-v\fP, \fB\-\-verbose\fP
詳細な情報を出力する。
.
.SH 終了ステータス
.TP 
\fB0\fP
指定されたアクションが実行された。\fB\-\-oknodo\fP が指定された場合、何も行われなかった場合も意味する。これは、\fB\-\-start\fP
が指定されたがマッチするプロセスが実行されていた場合、\fB\-\-stop\fP が指定されたがマッチするプロセスが存在しなかった場合に発生しうる。
.TP 
\fB1\fP
\fB\-\-oknodo\fP が指定されなかった場合に、何も行われなかった。
.TP 
\fB2\fP
\fB\-\-stop\fP および \fB\-\-retry\fP が指定されたが、規定時間の最後まで到達したにも関わらず、プロセスがまだ実行されている。
.TP 
\fB3\fP
その他のエラー。
.PP
\fB\-\-status\fP コマンドを実行した際には、以下の戻り値が返される:
.TP 
\fB0\fP
プログラムは実行中である。
.TP 
\fB1\fP
プログラムは実行中でないが、pid ファイルが存在している。
.TP 
\fB3\fP
プログラムは実行中でない。
.TP 
\fB4\fP
プログラムの状況を確認できない。
.
.SH 例
既に実行中でない場合に、\fBfood\fP デーモンを (プロセス名 food、実行ユーザ food 、PID 情報を food.pid に格納で)
起動する。
.IP
.nf
start\-stop\-daemon \-\-start \-\-oknodo \-\-user food \-\-name food \e
	\-\-pidfile /var/run/food.pid \-\-startas /usr/sbin/food \e
	\-\-chuid food \-\- \-\-daemon
.fi
.PP
\fBfood\fP に \fBSIGTERM\fP を送信し、停止するまで 5 秒間待機する:
.IP
.nf
start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e
	\-\-pidfile /var/run/food.pid \-\-retry 5
.fi
.PP
\fBfood\fP 停止のためのカスタムスケジュールのデモ:
.IP
.nf
start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e
	\-\-pidfile /var/run/food.pid \-\-retry=TERM/30/KILL/5
.fi
.SH 翻訳者
高橋 基信 <monyo@monyo.com>.
喜瀬 浩 <kise@fuyuneko.jp>.
関戸 幸一 <sekido@mbox.kyoto-inet.or.jp>.
鍋谷 栄展 <nabe@debian.or.jp>.
倉澤 望 <nabetaro@debian.or.jp>.
石川 睦 <ishikawa@linux.or.jp>.
鵜飼 文敏 <ukai@debian.or.jp>.
中野 武雄 <nakano@apm.seikei.ac.jp>.
.SH 翻訳校正
Debian JP Documentation ML <debian-doc@debian.or.jp>.