.\" Hey, Emacs! This is an -*- nroff -*- source file. .\"original revision: 1.11 .\" .\" Translated Wed May 13 17:28:56 JST 1998 .\" by Hidenobu NABETANI .\" .\" WORD: infomational message 参考情報 .\" WORD: instance インスタンス .\" .TH START\-STOP\-DAEMON 8 "15th March 1997" "Debian Project" "Debian GNU/Linux" .SH 名前 start\-stop\-daemon \- システムデーモンプログラムの起動、停止 .SH 書式 .B start-stop-daemon .BR -S | --start .IR options .RB [ \-\- ] .IR arguments .HP .B start-stop-daemon .BR -K | --stop .IR options .HP .B start-stop-daemon .BR -H | --help .HP .B start-stop-daemon .BR -V | --version .SH 説明 .B start\-stop\-daemon はシステムレベルのプロセスの生成・停止を制御するために使用される。 また、 .BR --exec ", " --pidfile ", " --user ", and " --name " options," はオプションを与えることで、実行中のプロセスを見つけることができる。 .BR --start を使用すると、 .B start\-stop\-daemon は指定されたプロセスが存在するかを調べる。 該当するプロセスが存在する場合、 .B start\-stop\-daemon は何もせず、エラーステータス 1 を返して終了する( .BR --oknodo が指定された場合は、0 を返す)。該当するプロセスが存在しない場合、 .BR --exec により(又は、 .BR --startas が指定された場合はこれにより )指定される実行ファイルを起動する。 コマンドライン上で .BR -- 以降に与えられた任意の引数は起動されるプログラムにそのまま引き 渡される。もし .B --retry が指定された場合、start-stop-daemonはそのプロセスが終了したかどうかを 確認する。 .BR --stop を使用すると、 .B start\-stop\-daemon は指定されたプロセスが存在するかを調べる。該当するプロセスが存在す る場合、 .B start\-stop\-daemon は .BR --signal により指定されたシグナルをそのプロセスに送り、エラーステータス 0 を返して終了する。該当するプロセスが存在しない場合、 .B start\-stop\-daemon はエラーステータス 1 を返して終了する( .BR --oknodo が指定された場合は 0 を返す)。 .SH オプション .TP \fB-x\fP|\fB--exec\fP \fIexecutable\fP ( .B /proc/ .I pid .B /exe により)指定された executable のプロセスを調べる。 .TP \fB-p\fP|\fB--pidfile\fP \fIpid-file\fP .I pid-file で指定されるプロセスIDを持つプロセスを調べる。 .TP \fB-u\fP|\fB--user\fP \fIusername\fP|\fIuid\fP .I username または .I uid で指定されるユーザが所有するプロセスを調べる。 .TP \fB-n\fP|\fB--name\fP \fIprocess-name\fP ( .B /proc/ .I pid .B /stat により) .I process-name という名のプロセスを調べる。 .TP \fB-s\fP|\fB--signal\fP \fIsignal\fP .BR --stop が与えられた時、プロセスを停止するために送るシグナルを指定する (デフォルトは 15)。 .TP \fB-R\fP|\fB--retry\fP \fItimeout\fP|\fIschedule\fP 同時に .BR --stop が与えられると .B start-stop-daemon はどのプロセスを終了させるかを確認する。 マッチした実行中のプロセスが全て終了するまで繰り返し確認する。 もしプロセスが終了しなければ、 .I schedule により決定される 別のアクションが実行される。 もし .I timeout が .I schedule のかわりに指定されていると、 .IB signal / timeout /KILL/ timeout が使われる。ここで .I signal は .BR --signal で指定されるシグナルである。 .I schedule はスラッシュ .RB ( / ) で区切られた少なくとも2つの要素からなるリストである。 それぞれの要素は .BI - signal-number もしくは [\fB\-\fP]\fIsignal-name\fP の場合は送るべきシグナル、 .IR timeout の場合はプロセスが終了するのを待つ秒数、 .BR forever の場合はもし必要なら残りの .I schedule を繰り返し適用することを意味する。 もし .I schedule を全て使って、 .BR forever が指定されていない場合は、 .B start-stop-daemon はエラー状態 2 で終了する。 もし .I schedule が指定されていれば、 .B --signal で指定したシグナルは無視される。 同時に .B --start が与えられると、 .I pathname により指定されるプロセスを起動する。このオプションが指定されない場合、 .B --exec に与えられる引数がデフォルトになる。 .TP .BR -t | --test 実行しようとする処理内容を出力し，それに伴い適切な返り値が設定される が、実際の処理は行わない。 .TP .BR -o | --oknodo 処理が何も行われない(又は、行なわれようともしなかった)場合、 終了ステータス 1 のかわりに 0 を返す。 .TP .BR -q | --quiet 参考情報を出力しない。エラーメッセージのみ表示。 .TP \fB-c\fP|\fB--chuid\fP \fIusername\fR|\fIuid\fP 処理を開始する前に指定されたユーザ名/ユーザ ID に変更する。 .BR ':' の後に グループ名またはグループ ID を与えることによりグループも指定できる。 これは `chown' コマンドと同じ書式 (\fIuser\fP\fB:\fP\fIgroup\fP) である。このオプションを 使用した時には、 .B --group オプションが指定されていない場合であってもプライマリグループと 補助グループは同様に設定されることを理解していなければなら ない。 .B --group オプションは、( .B nobody のような一般的ユーザに対してプロセス単位でグループに追加するというように) ユーザが通常のメンバーでないグループを指定する場合にのみ使用する。 .TP \fB-r\fP|\fB--chroot\fP \fIroot\fP 処理を開始する前に、 .I root に chdir と chroot を実行する。pidfile は chroot 後に、書き出されること に注意する。 .TP .BR -b | --background 典型的には、デーモンプロセスを切り離せないプログラムで使用される。このオプ ションを指定した場合、 .B start-stop-daemon は自分自身を対象プロセスの実行前に fork し、以後バックグラウンドで処理を行う。 .B 警告: start-stop-daemon は .B 何らかの理由 によって処理の実行に失敗した場合に、その終了ステータスをチェックできない。 このオプションは最終手段であり、自分から fork することに意味のないプログ ラムや、fork を自分で行うためのコードを追加できないプログラムのみでの使用 を意図している。 .TP .BR -N | --nicelevel プロセスを開始する前にプロセスのプライオリティを変更する。 .TP .BR -m | --make-pidfile 自分自身で PID ファイルを作成しないプログラムを起動する際に使用する。 このオプションにより、処理の実行直前に .B start-stop-daemon は .B --pidfile で参照されるファイルを作成し、配置する。このファイルはプログラムの 停止時に削除されないことに注意されたい。 .B 注意: このオプションは動作しない場合がある。特に、プログラムの実行時にその メインプロセスから fork するようなプログラムでは正しく動作しない。 このため、通常は .B --background オプションと併用する場合にのみ有用である。 .TP .BR -v | --verbose 詳しい参考情報を出力する。 .TP .BR -H | --help ヘルプ情報を出力して終了する。 .TP .BR -v | --verbose バージョン情報を出力して終了する。 .SH 著者 Marek Michalkiewicz がIan Jackson による以前のバージョンを 元に作成。 このマニュアルは Klee Dienes によって書かれた。 一部 Ian Jackson による整形。 .SH 翻訳者 鍋谷 栄展