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