summaryrefslogtreecommitdiffstats
path: root/man/de/start-stop-daemon.pod
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--man/de/start-stop-daemon.pod435
1 files changed, 435 insertions, 0 deletions
diff --git a/man/de/start-stop-daemon.pod b/man/de/start-stop-daemon.pod
new file mode 100644
index 0000000..125d353
--- /dev/null
+++ b/man/de/start-stop-daemon.pod
@@ -0,0 +1,435 @@
+
+ *****************************************************
+ * GENERATED FILE, DO NOT EDIT *
+ * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
+ *****************************************************
+
+This file was generated by po4a(7). Do not store it (in VCS, for example),
+but store the PO file used as source file by po4a-translate.
+
+In fact, consider this as a binary, and the PO file as a regular .c file:
+If the PO get lost, keeping this translation up-to-date will be harder.
+
+=encoding UTF-8
+
+=head1 BEZEICHNUNG
+
+start-stop-daemon - startet und stoppt System-Daemon-Programme
+
+=head1 ÜBERSICHT
+
+B<start-stop-daemon> [I<Option> …] I<Befehl>
+
+=head1 BESCHREIBUNG
+
+B<start-stop-daemon> wird zur Steuerung der Erzeugung und Beendigung von
+Prozessen auf Systemebene verwendet. Durch die Verwendung einer der
+Abgleich-Optionen kann B<start-stop-daemon> so konfiguriert werden, dass er
+existierende Instanzen von einem laufenden Prozess finden kann.
+
+B<Hinweis>: Falls B<--pid> oder B<--pidfile> nicht angegeben ist, verhält
+sich B<start-stop-daemon> ähnlich zu B<killall>(1). B<start-stop-daemon>
+wird die Prozesstabelle nach Prozessen durchsuchen, die auf den
+Prozessnamen, die Eltern-PID, UID und/oder GID (falls angegeben)
+passen. Jeder passende Prozess wird B<--start> daran hindern, den Daemon zu
+starten. Allen passenden Prozessen wird das TERM-Signal (oder das mit
+B<--signal> oder B<--retry> angegebene) geschickt, falls B<--stop> angegeben
+ist. Für Daemons, die langlebige Kinder haben, die ein B<--stop> überleben
+müssen, müssen Sie eine PID-Datei angeben.
+
+=head1 BEFEHLE
+
+=over
+
+=item B<-S>, B<--start> [B<-->] I<Argumente>
+
+Prüft auf Existenz eines angegebenen Prozesses. Falls ein solcher Prozess
+existiert, führt B<start-stop-daemon> nichts aus und beendet sich mit
+Fehlerstatus 1 (0, falls B<--oknodo> angegeben wurde). Falls ein solcher
+Prozess nicht existiert, dann startet es eine Instanz, entweder unter
+Verwendung des ausführbaren Programms, das mittels B<--exec> (oder, falls
+angegeben, mittels B<--startas>) spezifiziert wurde. Jedes weitere auf der
+Befehlszeile nach B<--> angegebene Argument wird unverändert an das zu
+startende Programm weitergegeben.
+
+=item B<-K>, B<--stop>
+
+Prüft auf die Existenz eines angegebenen Prozesses. Falls ein solcher
+Prozess existiert, dann sendet B<start-stop-daemon> das durch B<--signal>
+angegebene Signal und beendet sich mit Fehlerstatus 0. Falls kein solcher
+Prozess existiert, dann beendet sich B<start-stop-daemon> mit Fehlerstatus 1
+(0 falls B<--oknodo> angegeben ist). Falls B<--retry> angegeben wurde, wird
+B<start-stop-daemon> überprüfen, ob der/die Prozess(e) beendet wurden.
+
+=item B<-T>, B<--status>
+
+Prüft auf die Existenz eines bestimmten Prozesses und liefert den
+Exit-Status-Code entsprechend der „LSB Init Script Actions“ zurück (seit
+Version 1.16.1).
+
+=item B<-H>, B<--help>
+
+Gibt eine Meldung zur Verwendung aus und beendet das Programm.
+
+=item B<-V>, B<--version>
+
+Zeigt die Programmversion und beendet sich.
+
+=back
+
+=head1 OPTIONEN
+
+=head2 Abgleichoptionen
+
+=over
+
+=item B<--pid> I<PID>
+
+Prüft auf einen Prozess mit der angegebenen I<PID> (seit Version
+1.17.6). Die I<PID> muss eine Zahl größer Null sein.
+
+=item B<--ppid> I<PPID>
+
+Prüft auf einen Prozess mit der angegebenen Eltern-PID I<PPID> (seit Version
+1.17.7). Die I<PPID> muss eine Zahl größer Null sein.
+
+=item B<-p>, B<--pidfile> I<PID-Datei>
+
+Prüft, ob ein Prozess die Datei I<PID-Datei> angelegt hat.
+
+B<Hinweis>: Wird diese Abgleichoption alleine verwandt, könnte auf nicht
+geplante Prozesse eingewirkt werden, falls der alte Prozess beendet wurde,
+ohne dass er I<PID-Datei> entfernen konnte.
+
+B<Warnung>: Wird diese Abgleichoption mit einer durch alle Benutzer
+schreibbare PID-Datei oder alleine mit einem Daemon, der als nicht
+privilegierter Benutzer (d.h. nicht als root) in eine PID-Datei schreibt,
+verwandt, dann wird dies mit einem Fehler abgelehnt (seit Version 1.19.3),
+da dies ein Sicherheitsrisiko darstellt, da entweder jeder Benutzer
+hineinschreiben kann oder, falls der Daemon kompromittiert wird, dem Inhalt
+der PID-Datei nicht vertraut werden kann und dann ein privilegierter
+Ausführer (wie ein als Root ausgeführtes Init-Skript) am Ende auf jeden
+Systemprozess agieren würde. Die Verwendung von I</dev/null> ist von diesen
+Prüfungen ausgenommen.
+
+=item B<-x>, B<--exec> I<Programm>
+
+Überprüft auf Prozesse, die Instanzen von diesem I<Programm> sind. Das
+Argument I<Programm> sollte ein absoluter Pfadname sein.
+
+B<Hinweis>: Dies könnte bei interpretierten Skripten nicht wie geplant
+funktionieren, da das I<Programm> auf den Interpreter zeigt. Berücksichtigen
+Sie, dass dies auch auf Prozesse, die innerhalb einer Chroot laufen, passen
+könnte, daher könnten andere Abgleichrestriktionen benötigt werden.
+
+=item B<-n>, B<--name> I<Prozessname>
+
+Überprüft auf Prozesse mit dem Namen I<Prozessname>. Der I<Prozessname> ist
+normalerweise der Dateiname des Prozesses, er könnte aber vom Prozess selbst
+geändert worden sein.
+
+B<Hinweis>: Auf den meisten Systemen wird diese Information aus dem
+„comm“-Namen des Prozesses aus dem Kernel ausgelesen. Dessen Länge ist
+typischerweise sehr begrenzt (mehr als 15 Zeichen anzunehmen ist nicht
+portabel).
+
+=item B<-u>, B<--user> I<Benutzername>|I<uid>
+
+Überprüft auf Prozesse, die dem mit I<Benutzername> oder I<uid>
+spezifizierten Benutzer gehören.
+
+B<Hinweis>: Wird diese Abgleichoption alleine verwandt, wird auf alle
+Prozesse, die auf den Benutzer passen, eingewirkt.
+
+=back
+
+=head2 Allgemeine Optionen:
+
+=over
+
+=item B<-g>, B<--group> I<Gruppe>|I<gid>
+
+Wechselt zum Starten des Prozesses zur I<Gruppe> oder I<gid>.
+
+=item B<-s>, B<--signal> I<Signal>
+
+Mit B<--stop> wird das an den zu beendenden Prozess zu sendende Signal
+spezifiziert (standardmäßig TERM).
+
+=item B<-R>, B<--retry> I<Zeitüberschreitung>|I<Plan>
+
+Mit B<--stop> spezifiziert, dass B<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 I<Zeitüberschreitung> anstelle von I<Plan> spezifiziert wird, dann
+wird der Plan
+I<Signal>B</>I<Zeitüberschreitung>B</KILL/>I<Zeitüberschreitung> verwendet,
+wobei I<Signal> das mit B<--signal> spezifizierte Signal ist.
+
+I<Plan> ist eine Liste von mindestens zwei durch Schrägstriche (B</>)
+getrennten Punkten; jeder Punkt kann aus B<->I<Signalnummer> oder
+[B<->]I<Signalname> bestehen, was bedeutet, dass dieses Signal gesendet
+werden soll, oder aus I<Zeitüberschreitung>, was bedeutet, dass so viele
+Sekunden auf das Beenden von Prozessen gewartet werden soll, oder aus
+B<forever>, was bedeutet, den Rest des Plans falls notwendig für immer zu
+wiederholen.
+
+Falls das Ende des Plans erreicht wird und B<forever> nicht spezifiziert
+wurde, dann beendet sich der B<start-stop-daemon> mit dem Fehlerstatus
+2. Falls ein Plan spezifiziert wurde, dann wird jedes mit B<--signal>
+spezifizierte Signal ignoriert.
+
+=item B<-a>, B<--startas> I<Pfadname>
+
+Mit B<--start> wird der über I<Pfadname> spezifizierte Prozess
+gestartet. Falls nicht angegeben, werden standardmäßig die an B<--exec>
+übergebenen Argumente verwendet.
+
+=item B<-t>, B<--test>
+
+Gibt die Aktionen aus, die erledigt würden und setzt die entsprechenden
+Rückgabewerte, führt aber keine Aktionen durch.
+
+=item B<-o>, B<--oknodo>
+
+Liefert den Rückgabewert 0 anstatt 1, falls keine Aktionen ausgeführt wurden
+(würden).
+
+=item B<-q>, B<--quiet>
+
+Gibt keine informativen Meldungen aus, zeigt nur Fehlermeldungen an.
+
+=item B<-c> , B<--chuid> I<Benutzername>|I<uid>[B<:>I<Gruppe>|I<gid>]
+
+Wechselt vor dem Start des Prozesses zu diesem Benutzername/uid. Sie können
+durch Anhängen von B<:> auch die Gruppe spezifizieren, in diesem Fall wird
+die Gruppe oder gid wie bei dem Befehl B<chown>(1)
+(I<Benutzer>B<:>I<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 B<--group>
+nicht angegeben wird. Die Option B<--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 B<nobody>).
+
+=item B<-r>, B<--chroot> I<Wurzel>
+
+Wechselt das Verzeichnis vor dem Start des Prozesses zu I<Wurzel> und ruft
+B<chroot> auf. Bitte beachten Sie, dass die PID-Datei auch nach dem Aufruf
+von B<chroot> geschrieben wird.
+
+=item B<-d>, B<--chdir> I<Pfad>
+
+Wechselt vor dem Starten des Prozesses zum Verzeichnis I<Pfad>. Dies wird,
+falls die B<-r>|B<--chroot> Option gesetzt ist, nach dem Aufruf von
+B<chroot> durchgeführt. Falls nicht angegeben, wird B<start-stop-daemon> vor
+dem Prozess-Start in das Wurzelverzeichnis wechseln.
+
+=item B<-b>, B<--background>
+
+Wird typischerweise für Programme verwandt, die sich nicht selbständig
+ablösen. Diese Option zwingt B<start-stop-daemon>, vor dem Start des
+Prozesses einen Fork durchzuführen, und zwingt diesen dann in den
+Hintergrund.
+
+B<Warnung: start-stop-daemon> kann nicht den Rückgabewert überprüfen, falls
+der Prozess aus B<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.
+
+=item B<--notify-await>
+
+Wartet, dass der Hintergrundprozess eine Bereitschaftsbenachrichtigung
+sendet, bevor der Dienst als gestartet betrachtet wird (seit Version
+1.19.3). Dies implementiert Teile des Bereitschaftsprotokolls von Systemd,
+wie es in der Handbuchseite B<sd_notify>(3) festgelegt ist. Die folgenden
+Variablen werden unterstützt:
+
+=over
+
+=item B<READY=1>
+
+Das Programm ist bereit, den Dienst zu leisten, daher kann sicher beendet
+werden.
+
+=item B<EXTEND_TIMEOUT_USEC=>I<Anzahl>
+
+Das Programm erbittet die Verlängerung der Zeitüberschreitung um I<Anzahl>
+Mikrosekunden. Dies wird die aktuelle Zeitüberschreitung auf den
+festgelegten Wert zurücksetzen.
+
+=item B<ERRNO=>I<Nummer>
+
+Das Programm beendete sich mit einem Fehler. Macht das gleiche und gibt die
+benutzerfreundliche Zeichenkette für den Wert von B<errno> aus.
+
+=back
+
+=item B<--notify-timeout> I<Zeitüberschreitung>
+
+Setzt eine Zeitüberschreitung für die Option B<--notify-await> (seit Version
+1.19.3). Wenn die Zeitüberschreitung erreicht wird, wird sich
+B<start-stop-daemon> mit einem Fehler-Code beenden und es wird auf keine
+Bereitschaftsbenachrichtigung gewartet. Die Vorgabe ist B<60> Sekunden.
+
+=item B<-C>, B<--no-close>
+
+Keinen Dateideskriptor schließen, wenn ein Daemon in den Hintergrund
+gezwungen wird (seit Version 1.16.5). Dies wird zu Fehlersuchzwecken
+angewandt oder um Dateideskriptoren zur Protokollierung der Prozessausgabe
+umzuleiten. Nur relevant bei der Verwendung von B<--background>.
+
+=item B<-O>, B<--output> I<Pfadname>
+
+Leitet B<stdout> und B<stderr> auf I<Pfadname> um, wenn der Daemon in den
+Hintergrund gezwungen wird (seit Version 1.20.6). Nur relevant bei Einsatz
+von B<--background>.
+
+=item B<-N>, B<--nicelevel> I<Ganzzahl>
+
+Dies ändert die Priorität des Prozesses, bevor er gestartet wird.
+
+=item B<-P>, B<--procsched> I<Strategie>B<:>I<Priorität>
+
+Dies ändert die Prozesssteuerstrategie („process scheduler policy“) und die
+Priorität des Prozesses, bevor dieser gestartet wird (seit Version
+1.15.0). Die Priorität kann optional festgelegt werden, indem ein B<:>
+gefolgt von einem Wert angegeben wird. Die Standard-I<Priorität> beträgt
+0. Die derzeit unterstützten Werte für die Strategie lauten B<other>,
+B<fifo> und B<rr>.
+
+=item B<-I>, B<--iosched> I<Klasse>B<:>I<Priorität>
+
+Dies ändert die EA-Steuerklasse („IO scheduler class“) und die Priorität des
+Prozesses, bevor dieser gestartet wird (seit Version 1.15.0). Die Priorität
+kann optional festgelegt werden, indem ein B<:> gefolgt von einem Wert
+angegeben wird. Die Standard-I<Priorität> beträgt 4, außer I<Klasse> lautet
+B<idle>, dann beträgt sie immer 7. Die derzeit unterstützten Werte für die
+I<Klasse> lauten B<idle>, B<best-effort> und B<real-time>.
+
+=item B<-k>, B<--umask> I<Maske>
+
+Dies setzt die umask des Prozesses, bevor er gestartet wird (seit Version
+1.13.22).
+
+=item B<-m>, B<--make-pidfile>
+
+Wird verwandt, wenn ein Programm gestartet wird, das keine eigene PID-Datei
+anlegt. Diese Option sorgt dafür, dass B<start-stop-daemon> die mit
+B<--pidfile> referenzierte Datei anlegt und die PID kurz vor der Ausführung
+des Prozesses hineinlegt. Beachten Sie, dass die Datei beim Anhalten des
+Programms nur entfernt wird, falls B<--remove-pidfile> verwandt wird.
+
+B<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 B<--background> sinnvoll.
+
+=item B<--remove-pidfile>
+
+Wird verwandt, wenn ein Programm gestoppt wird, das seine PID-Datei nicht
+entfernt (seit Version 1.17.19). Diese Option führt dazu, dass
+B<start-stop-daemon> die durch B<--pidfile> referenzierte Datei nach der
+Beendigung des Prozesses entfernt.
+
+=item B<-v>, B<--verbose>
+
+Gibt ausführliche informative Meldungen aus.
+
+=back
+
+=head1 RÜCKGABEWERT
+
+=over
+
+=item B<0>
+
+Die angeforderte Aktion wurde durchgeführt. Falls B<--oknodo> angegeben
+wurde, kann es auch sein, dass nichts durchgeführt wurde. Das kann
+passieren, wenn B<--start> angegeben wurde und der passende Prozess bereits
+lief oder wenn B<--stop> angegeben wurde und es keinen passenden Prozess
+gab.
+
+=item B<1>
+
+Falls B<--oknodo> nicht angegeben war und nichts durchgeführt wurde.
+
+=item B<2>
+
+Falls B<--stop> und B<--retry> angegeben waren, aber das Ende des Plans
+erreicht wurde und die Prozesse noch liefen.
+
+=item B<3>
+
+Jeder andere Fehler.
+
+=back
+
+Bei der Verwendung des Befehls B<--status> werden die folgenden Statuscodes
+zurückgeliefert:
+
+=over
+
+=item B<0>
+
+Programm läuft.
+
+=item B<1>
+
+Programm läuft nicht und die PID-Datei existiert.
+
+=item B<3>
+
+Programm läuft nicht.
+
+=item B<4>
+
+Programmstatus kann nicht bestimmt werden.
+
+=back
+
+=head1 BEISPIEL
+
+Den Daemon B<food> starten, falls noch keiner läuft (ein Prozess mit Namen
+food, der als Benutzer food mit PID in food.pid läuft):
+
+=over
+
+ start-stop-daemon --start --oknodo --user food --name food \
+ --pidfile /run/food.pid --startas /usr/sbin/food \
+ --chuid food -- --daemon
+
+=back
+
+B<SIGTERM> an B<food> schicken und bis zu fünf Sekunden auf sein Beenden
+warten:
+
+=over
+
+ start-stop-daemon --stop --oknodo --user food --name food \
+ --pidfile /run/food.pid --retry 5
+
+=back
+
+Vorführung eines angepassten Plans zum Beenden von B<food>:
+
+=over
+
+ start-stop-daemon --stop --oknodo --user food --name food \
+ --pidfile /run/food.pid --retry=TERM/30/KILL/5
+
+=back
+
+
+=head1 ÜBERSETZUNG
+
+Die deutsche Übersetzung wurde 2004, 2006-2020 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.