Provided by: dpkg_1.15.8.4ubuntu3_i386 bug

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.