Provided by:
dpkg_1.15.8.4ubuntu3_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, verhlt 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 TERM-Signal (oder das mit --signal oder --retry angegebene)
geschickt, falls --stop angegeben ist. Fr Daemons die langlebige Kinder
haben, die ein --stop berleben mssen, mssen Sie eine PID-Datei angeben.
BEFEHLE
-S, --start [--] Argumente
Prfe auf Existenz eines angegebenen Prozesses. Falls ein solcher
Prozess existiert fhrt 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 ausfhrbaren Programms,
das mittels --exec (oder, falls angegeben, mittels --startas)
spezifiziert wurde. Jedes weitere auf der Kommandozeile nach --
angegebene Argument wird unverndert an das zu startende Programm
weitergegeben.
-K, --stop
berprft 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 berprfen, 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
berprfe, ob ein Prozess die Datei pid-Datei angelegt hat.
-x, --exec Programm
berprfe auf Prozesse die (laut /proc/pid/exe) Instanzen von
diesem Programm sind.
-n, --name Prozessname
berprfe (laut /proc/pid/stat) auf Prozesse mit dem Namen
Prozessname.
-u, --user Benutzername|uid
berprfe auf Prozesse die dem mit Benutzername oder uid
spezifizierten Benutzer gehren.
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 (standardmig TERM).
-R, --retry Zeitberschreitung|Plan
Mit --stop spezifiziert, dass start-stop-daemon berprfen soll,
ob der Prozess (die Prozesse) sich beenden. Es berprft
wiederholt, ob passende Prozesse laufen, bis dies nicht mehr der
Fall ist. Falls sich die Prozesse nicht beenden, werden weitere
im Plan angegebene Aktionen durchgefhrt.
Falls Zeitberschreitung anstelle von Plan spezifiziert wird,
dann wird der Plan
Signal/Zeitberschreitung/KILL/Zeitberschreitung verwendet, wobei
Signal das mit --signal spezifizierte Signal ist.
Plan ist eine Liste von mindestens zwei durch Schrgstriche (/)
getrennten Punkten; jeder Punkt kann aus -Signalnummer oder
[-]Signalname bestehen, was bedeutet, dass dieses Signal
gesendet werden soll, oder aus Zeitberschreitung, was bedeutet,
dass soviele Sekunden auf das Beenden von Prozessen gewartet
werden soll, oder aus forever was bedeutet, den Rest des Plans
falls notwendig fr 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 standardmig die an
--exec bergebenen Argumente verwendet.
-t, --test
Gebe die Aktionen aus, die erledigt wrden und setze die
entsprechenden Rckgabewerte, fhre aber keine Aktionen durch.
-o, --oknodo
Liefert den Rckgabewert 0 anstatt 1 falls keine Aktionen
ausgefhrt wurden (wrden).
-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 knnen durch Anhngen 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 primre GID fr diesen Benutzer verwandt.
Wenn Sie diese Option verwenden, mssen Sie daran denken, dass
die primre und zustzliche Gruppen auch gesetzt werden, selbst
wenn die Option --group nicht angegeben wird. Die Option --group
ist nur fr Gruppen, in denen der Benutzer normalerweise kein
Mitglied ist (wie das Hinzufgen von pro-Prozess
Gruppenmitgliedschaften fr 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 durchgefhrt.
Falls nicht angegeben, wird start-stop-daemon vor dem
Prozess-Start in das Wurzelverzeichnis wechseln.
-b, --background
Typischerweise verwendet fr Programme, die sich nicht selbstndig
ablsen. Diese Option zwingt start-stop-daemon vor dem Start des
Prozesses einen Fork durchzufhren, und zwingt diesen dann in den
Hintergrund. WARNUNG: start-stop-daemon kann nicht den
Rckgabewert berprfen, falls der Prozess aus irgendeinem Grund
nicht startet. Dies ist ein letztes Mittel und ist nur fr
Programme gedacht, bei denen das selbststndige Forken keinen
Sinn ergibt oder wo es nicht sinnvoll ist, den Code hierfr
hinzuzufgen.
-N, --nicelevel Ganzzahl
Dies ndert die Prioritt des Prozesses bevor er gestartet wird.
-P, --procsched Strategie:Prioritt
Dies ndert die Prozesssteuerstrategie (process scheduler policy)
und die Prioritt des Prozesses, bevor dieser gestartet wird. Die
Prioritt kann optional festgelegt werden, indem ein : gefolgt
von einem Wert angegeben wird. Die Standard-Prioritt betrgt 0.
Die derzeit untersttzten Werte fr die Strategie lauten other,
fifo und rr.
-I, --iosched Klasse:Prioritt
Dies ndert die IO-Steuerklasse (IO scheduler class) und die
Prioritt des Prozesses, bevor dieser gestartet wird. Die
Prioritt kann optional festgelegt werden, indem ein : gefolgt
von einem Wert angegeben wird. Die Standard-Prioritt betrgt 4,
auer Klasse lautet idle, dann betrgt sie immer 7. Die derzeit
untersttzten Werte fr die Klasse lauten idle, best-effort und
real-time.
-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 anlegt. Diese Option sorgt dafr, dass
start-stop-daemon die mit --pidfile referenzierte Datei anlegt
und die PID kurz vor der Ausfhrung des Prozesse hineinlegt.
Beachten Sie, dass die Datei nicht entfernt wird, wenn das
Programm beendet wird. HINWEIS: Diese Funktion knnte in nicht
allen Fllen funktionieren. Insbesondere wenn das auszufhrende
Programm sich vom Hauptprozess forkt. Deshalb ist diese Option
normalerweise nur in Kombination mit der Option --background
sinnvoll.
-v, --verbose
Gibt ausfhrliche informative Meldungen aus.
RCKGABEWERT
start-stop-daemon liefert 0, falls die angeforderte Aktion ausgefhrt
wurde oder --oknodo angegeben und entweder --start angegeben wurde und
ein passender Prozess lief bereits oder --stop angebeben wurde und es
gab keinen passenden Prozess. Falls --oknodo nicht angegeben wurde und
nichts erfolgte, wird 1 zurckgeliefert. Falls --stop und --retry
angegeben wurden, aber das Ende des Plans errreicht wurde und der
Prozess noch luft, lautet der Fehlerwert 2. Bei allen anderen Fehlern
ist der Status 3.
BEISPIEL
Starte den Daemon food falls noch keiner luft (ein Prozess mit Namen
food, der als Benutzer food mit PID in food.pid luft):
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 fnf Sekunden auf sein Beenden:
start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5
Vorfhrung 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-2010 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 fr die Kopierbedingungen. Es gibt KEINE HAFTUNG.