Provided by: dpkg_1.16.1.2ubuntu7_i386 bug

NAME

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

ÜBERSICHT

       start-stop-daemon [Option...] 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  TERM-Signal  (oder das mit --signal oder --retry angegebene)
       geschickt, falls --stop  angegeben  ist.  Für  Daemons  die  langlebige
       Kinder  haben,  die  ein  --stop  überleben  müssen,  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.

       -T, --status
              Überprüft  auf  die  Existenz  eines  bestimmten  Prozesses  und
              liefert den Exit-Status-Code entsprechend der »LSB  Init  Script
              Actions« zurück.

       -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 angelegt 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 TERM).

       -R, --retry Zeitberschreitung|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  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 Schrägstriche  (/)
              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 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[:Gruppe|gid]
              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.

       -P, --procsched Strategie:Prioritt
              Dies  ändert  die  Prozesssteuerstrategie  (»process   scheduler
              policy«) und die Priorität des Prozesses, bevor dieser gestartet
              wird. Die Priorität kann optional festgelegt werden, indem ein :
              gefolgt  von  einem  Wert angegeben wird. Die Standard-Prioritt
              beträgt 0. Die derzeit unterstützten  Werte  für  die  Strategie
              lauten other, fifo und rr.

       -I, --iosched Klasse:Prioritt
              Dies  ändert  die IO-Steuerklasse (»IO scheduler class«) und die
              Priorität  des  Prozesses,  bevor  dieser  gestartet  wird.  Die
              Priorität  kann  optional festgelegt werden, indem ein : gefolgt
              von einem Wert angegeben wird. Die Standard-Prioritt beträgt 4,
              außer  Klasse lautet idle, dann beträgt sie immer 7. Die derzeit
              unterstützten Werte für 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    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

       0      Die  angeforderte  Aktion  wurde  durchgeführt.  Falls  --oknodo
              angegeben  wurde,  kann  es  auch  sein, dass nicht durchgeführt
              wurde. Das kann passieren, wenn --start angegeben wurde und  der
              passende  Prozess  bereits lief oder wenn --stop angegeben wurde
              und es keinen passenden Prozess gab.

       1      Falls --oknodo  nicht  angegeben  war  und  nichts  durchgeführt
              wurde.

       2      Falls  --stop  und  --retry  angegeben  waren, aber das Ende des
              Plans erreicht wurde und die Prozesse noch liefen.

       3      Jeder andere Fehler.

       Bei  der  Verwendung  des  Befehls  --status   werden   die   folgenden
       Statuscodes zurückgeliefert:

       0      Programm läuft.

       1      Programm läuft nicht und die PID-Datei existiert.

       3      Programm läuft nicht.

       4      Programmstatus kann nicht bestimmt werden.

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-2011 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.