start-stop-daemon(8)

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

ÜBERSICHT
start-stop-daemon [Optionen] Befehl

BESCHREIBUNG
start-stop-daemon wird zur Steuerung der Erzeugung und Beendigung von Prozessen auf Systemebene verwendet. Durch die Verwendung einer der Abgleich-Optionen kann start-stop-daemon so konfiguriert werden, dass er existierende Instanzen von einem laufenden Prozess finden kann.

Hinweis: Falls --pidfile nicht angegeben ist, verhält sich start-stop-daemon ähnlich zu killall(1). start-stop-daemon wird die Prozesstabelle nach Prozessen durchsuchen, die auf den Prozessnamen, uid und/oder gid (falls angegeben) passen. Jeder passende Prozess wird --start daran hindern, den Daemon zu starten. Allen passenden Prozessen wird das KILL-Signal geschickt, falls --stop angegeben ist. Für Daemons die langlebige Kinder haben, die ein --stop überleben sollen, müssen Sie eine PID-Datei angeben.

BEFEHLE

-S, --start [--] Argumente
    Prüfe auf Existenz eines angegebenen Prozesses. Falls ein solcher Prozess existiert führt start-stop-daemon nichts aus 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 (oder, falls angegeben, mittels --startas) spezifiziert wurde. Jedes weitere auf der Kommandozeile nach -- angegebene Argument wird unverändert an das zu startende Programm weitergegeben.

-K, --stop
    Überprüft auf die Existenz eines speziellen Prozesses. Falls ein solcher Prozess existiert, dann sendet start-stop-daemon das durch --signal angegebene Signal und beendet sich mit Fehlerstatus 0. Falls kein solcher Prozess existiert, dann beendet sich start-stop-daemon mit Fehlerstatus 1 (0 falls --oknodo angegeben ist). Falls --retry angegeben wurde, wird start-stop-daemon überprüfen, ob der/die Prozess(e) beendet wurden.

-H, --help
    Zeige Bedienungsinformationen und beendet sich.

-V, --version
    Zeige die Programmversion und beendet sich.

ABGLEICH-OPTIONEN

-p, --pidfile pid-Datei
    Überprüfe, ob ein Prozess die Datei pid-Datei erstellt hat.

-x, --exec Programm
    Überprüfe auf Prozesse die (laut /proc/pid/exe) Instanzen von diesem Programm sind.

-n, --name Prozessname
    Überprüfe (laut /proc/pid/stat) auf Prozesse mit dem Namen Prozessname.

-u, --user Benutzername|uid
    Überprüfe auf Prozesse die dem mit Benutzername oder uid spezifizierten Benutzer gehören.

OPTIONEN

-g, --group Gruppe|gid
    Wechsle zum Starten des Prozesses zur Gruppe oder gid.

-s, --signal Signal
    Mit --stop wird das an den zu beendenden Prozess zu sendende Signal spezifiziert (standardmäßig 15).

-R, --retry Zeitüberschreitung|Plan
    Mit --stop spezifiziert, dass start-stop-daemon überprüfen soll, ob der Prozess (die Prozesse) sich beenden. Es überprüft wiederholt, ob passende Prozesse laufen, bis dies nicht mehr der Fall ist. Falls sich die Prozesse nicht beenden, werden weitere im »Plan« angegebene Aktionen durchgeführt. Falls Zeitüberschreitung anstelle von Plan spezifiziert wird, dann wird der Plan Signal/Zeitüberschreitung/KILL/Zeitüberschreitung 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, dass dieses Signal gesendet werden soll, oder aus Zeitüberschreitung, was bedeutet, dass soviele Sekunden auf das Beenden von Prozessen gewartet werden soll, oder aus 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 wird der über Pfadname spezifizierte Prozess gestartet. Falls nicht angegeben, werden standardmäßig die an --exec übergebenen Argumente verwendet.

-t, --test
    Gebe die Aktionen aus, die erledigt würden und setze die entsprechenden Rückgabewerte, führe aber keine Aktionen durch.

-o, --oknodo
    Liefert den Rückgabewert 0 anstatt 1 falls keine Aktionen ausgeführt wurden (würden).

-q, --quiet
    Gebe keine informativen Meldungen aus, zeige nur Fehlermeldungen an.

-c ,  --chuid Benutzername|uid
    Wechsele 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. Falls ein Benutzer ohne Gruppe angegeben ist, wird die primäre GID für diesen Benutzer verwandt. Wenn Sie diese Option verwenden, müssen Sie daran denken, dass die primäre und zusätzliche Gruppen auch gesetzt werden, selbst wenn die Option --group nicht angegeben wird. Die Option --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 Benutzer wie nobody).

-r, --chroot Wurzel
    Chdir und chroot vor dem Start des Prozesse zu Wurzel. Bitte beachten Sie, dass 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. Falls nicht angegeben, wird start-stop-daemon vor dem Prozess-Start in das Wurzelverzeichnis wechseln.

-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 zwingt diesen dann in den Hintergrund. 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 ergibt 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.

-k, --umask Maske
    Dies setzt die umask des Prozesses bevor er gestartet wird.

-m, --make-pidfile
    Verwendet, wenn ein Programm gestartet wird, das 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 die Datei nicht entfernt wird, wenn das Programm beendet wird. HINWEIS: Diese Funktion könnte in nicht allen Fällen funktionieren. Insbesondere wenn das auszuführende Programm sich vom Hauptprozess forkt. Deshalb ist diese Option normalerweise nur in Kombination mit der Option --background sinnvoll.

-v, --verbose
    Gibt ausführliche informative Meldungen aus.

RÜCKGABEWERT
start-stop-daemon liefert 0, falls die angeforderte Aktion ausgeführt wurde oder --oknodo angegeben und entweder --start angegeben wurde und ein passener Prozess lief bereits oder --stop angebeben wurde und es gab keinen passenden Prozess. Falls --oknodo nicht angegeben wurde und nichts erfolgte, wird 1 zurückgeliefert. Falls --stop und --retry angegeben wurden, aber das Ende des Plans errreicht wurde und der Prozess noch läuft, lautet der Fehlerwert 2. Bei allen anderen Fehlern ist der Status 3.

BEISPIEL
Starte den Daemon food falls noch keiner läuft (ein Prozess mit Namen food, der als Benutzer food mit PID in food.pid läuft):

    start-stop-daemon --start --oknodo --user food --name food --pidfile /var/run/food.pid --startas /usr/sbin/food --chuid food -- --daemon

Schicke SIGTERM an food und warte bis zu fünf Sekunden auf sein Beenden:

    start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5

Vorführung eines angepassten Plans zum Beenden von food:

    start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry=TERM/30/KILL/5

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.

ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2008 von Helge Kreutzmann <debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und 2008 von Sven Joachim <svenjoac@gmx.de> angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 2 oder neuer für die Kopierbedingungen. Es gibt KEINE HAFTUNG.