Linux Certif

Toute la documentation sur la certification Linux LPI

start-stop-daemon

NAME

start-stop-daemon - startet und stoppt System-Daemon-Programme

�BERSICHT

start-stop-daemon -S|--start Optionen [--] Argumente

start-stop-daemon -K|--stop Optionen

start-stop-daemon -H|--help

start-stop-daemon -V|--version

BESCHREIBUNG

start-stop-daemon

wird zur Kontrolle der Erzeugung und Beendigung von Prozessen auf Systemebene verwendet. Durch die Verwendung der --exec, --pidfile, --user, und --name Optionen kann start-stop-daemon so konfiguriert werden, da� er bereits existierende Instanzen von einem laufenden Prozess finden kann.

Mittels --start �berpr�ft start-stop-daemon auf die Existenz von speziellen Prozessen. Falls ein solcher Prozess existiert, dann macht start-stop-daemon nichts, und beendet sich mit Fehlerstatus 1 (0, falls --oknodo angegeben wurde). Falls ein solcher Prozess nicht existiert, dann startet es eine Instanz, entweder unter Verwendung des ausf�hrbaren Programms, das mittels --exec spezifiziert wurde (oder, falls angegeben, mittels --startas). Jedes weitere auf der Kommandozeile angegebene Argument nach -- wird unver�ndert an das zu startende Programm weitergegeben. Falls --retry spezifiziert wurde, dann �berpr�ft start-stop-daemon ob der Prozess (die Prozesse) beendet wurden.

Mit --stop �berpr�ft start-stop-daemon auf auf die Existenz eines speziellen Prozesses. Falls ein solcher Prozess existiert, dann sendet start-stop-daemon das durch --signal spezifizierte Signal und beendet sich mit Fehlerstatus 0. Falls kein solcher Prozess existiert, dann beendet sich start-stop-daemon mit Fehlerstatus 1 (0 falls --oknodo spezifiziert ist).

OPTIONEN

-x|--exec Programm

�berpr�fe auf Prozesse die (laut /proc/pid/exe) Instanzen von diesem Programm sind.

-p|--pidfile pid-Datei

�berpr�fe auf Prozesse deren Prozess-ID in pid-Datei angegeben ist.

-u|--user Benutzername|uid

�berpr�fe auf Prozesse die dem mit Benutzername oder uid spezifizierten Benutzer geh�ren.

-g|--group Gruppe|gid

Wechsle zum Starten des Prozesses zur Gruppe oder gid.

-n|--name Prozessname

�berpr�fe (laut /proc/pid/stat) auf Prozesse mit dem Namen Prozessname.

-s|--signal Signal

Mit --stop wird das an den zu beendenden Prozess zu sendende Signal spezifiziert (standardm��ig 15).

-R|--retry timeout|Plan

Mit --stop spezifiziert, das start-stop-daemon �berpr�fen soll, ob der Prozess (die Prozesse) sich beenden. Es �berpr�ft regelm��ig, ob ein passender Prozess l�uft, bis dies nicht mehr der Fall ist. Falls sich die Prozesse nicht beenden werden weitere im �Plan� angegebene Aktionen durchgef�hrt.

Falls timeout anstelle von Plan spezifiziert wird, dann wird der Plan signal/timeout/KILL/timeout verwendet, wobei signal das mit --signal spezifizierte Signal ist.

Plan ist eine Liste von mindestens zwei durch Schr�gstriche (/) getrennten Punkten; jeder Punkt kann aus -Signalnummer oder [-]Signalname bestehen, was bedeutet, da� dieses Signal gesendet werden soll, oder aus timeout was bedeutet das soviele Sekunden auf das Beenden des Prozesses gewartet werden soll, oder forever was bedeutet, den Rest des Plans falls notwendig f�r immer zu wiederholen.

Falls das Ende des Plans erreicht wird und forever nicht spezifiziert wurde, dann beendet sich der start-stop-daemon mit dem Fehlerstatus 2. Falls ein Plan spezifiziert wurde dann wird jedes mit --signal spezifizierte Signal ignoriert.

-a|--startas Pfadname

Mit --start wir der �ber Pfadname spezifizierte Prozess gestartet. Falls nicht angegeben, werden standardm��ig die an --exec �bergebenen Argumente verwendet.

-t|--test

Gibt die zu erledigenden Aktionen aus und setzt die entsprechenden R�ckgabewerte, f�hrt aber keine Aktionen durch.

-o|--oknodo

Liefert den R�ckgabewert 0 anstatt 1 falls keine Aktionen ausgef�hrt wurden (w�rden).

-q|--quiet

Gibt keine informationelle Meldungen aus, nur Fehlermeldungen werden angezeigt.

-c|--chuid Benutzername|uid

Wechselt vor dem Start des Prozesses zu diesem Benutzername/uid. Sie k�nnen durch Anh�ngen von : auch die Gruppe spezifizieren, in diesem Fall wird die Gruppe oder gid wie bei dem �chown�-Befehl (Benutzer:Gruppe) angegeben. Wenn Sie diese Option verwenden, m�ssen Sie daran denken, da� die prim�re und zus�tzlichen Gruppe auch gesetzt werden, selbst wenn die --group Option nicht spezifiziert wird. Die --group ist nur f�r Gruppen in denen der Benutzer normalerweise kein Mitglied ist (wie das Hinzuf�gen von pro-Prozess Gruppenmitgliedschaften f�r generische Nutzer wie nobody).

-r|--chroot Wurzel

Chdir und chroot vor dem Start des Prozesse zu Wurzel.# Bitte beachten Sie das die PID-Datei auch nach dem chroot geschrieben wird.

-d|--chdir Pfad

Chdir vor dem Starten des Prozesses zu Pfad. Dies wird, falls die -r|--chroot Option gesetzt ist, nach dem chroot durchgef�hrt.

-b|--background

Typischerweise verwendet f�r Programme die sich nicht selbst�ndig abl�sen. Diese Option zwingt start-stop-daemon vor dem Start des Prozesses einen Fork durchzuf�hren, und ihn in den Hintergrund zu zwingen. WARNUNG: start-stop-daemon kann nicht den R�ckgabewert �berpr�fen, falls der Prozess aus irgendeinem Grund nicht startet. Dies ist ein letztes Mittel und ist nur f�r Programme gedacht, bei denen das selbstst�ndige Forken keinen Sinn macht oder wo es nicht sinnvoll ist, den Code hierf�r hinzuzuf�gen.

-N|--nicelevel Ganzzahl

Dies �ndert die Priorit�t des Prozesses bevor er gestartet wird.

-m|--make-pidfile

Verwendet wenn ein Programm gestartet wird, dass keine eigene PID-Datei erstellt. Diese Option sorgt daf�r, dass start-stop-daemon die mit --pidfile referenzierte Datei anlegt und die PID kurz vor der Ausf�hrung des Prozesse hineinlegt. Beachten Sie, dass sie nicht entfernt wird wenn das Programm beendet wird. HINWEIS: Diese Funktion k�nnte nicht in allen F�llen funktionieren. Insbesondere wenn das auszuf�hrende Programm sich vom Hauptprozess forkt. Deshalb ist diese Option normalerweise nur in Kombination mit der --background Option sinnvoll.

-v|--verbose

Gibt ausf�hrliche informative Meldungen aus.

-H|--help

Gibt Hilfeinformationen aus und beendet sich dann.

-V|--version

Gibt Versionsinformationen aus und beendet sich dann.

AUTOREN

Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl> basierend auf einer vorherigen Version von Ian Jackson <ian@chiark.greenend.org.uk>.

Handbuchseite von Klee Dienes <klee@mit.edu>, teilweise von Ian Jackson umformatiert.