Provided by:
dpkg_1.14.24ubuntu1_i386 
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.