.\" dpkg manual page - start-stop-daemon(8) .\" .\" Copyright © 1999 Klee Dienes .\" Copyright © 1999 Ben Collins .\" Copyright © 2000-2001 Wichert Akkerman .\" Copyright © 2002-2003 Adam Heath .\" Copyright © 2004 Scott James Remnant .\" Copyright © 2008-2015 Guillem Jover .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH start\-stop\-daemon 8 2018-06-26 1.18.25 dpkg\-Programmsammlung .nh .SH BEZEICHNUNG start\-stop\-daemon \- startet und stoppt System\-Daemon\-Programme . .SH \(:UBERSICHT \fBstart\-stop\-daemon\fP [\fIOption\fP …] \fIBefehl\fP . .SH BESCHREIBUNG \fBstart\-stop\-daemon\fP wird zur Steuerung der Erzeugung und Beendigung von Prozessen auf Systemebene verwendet. Durch die Verwendung einer der Abgleich\-Optionen kann \fBstart\-stop\-daemon\fP so konfiguriert werden, dass er existierende Instanzen von einem laufenden Prozess finden kann. .PP Hinweis: Falls \fB\-\-pid\fP oder \fB\-\-pidfile\fP nicht angegeben ist, verh\(:alt sich \fBstart\-stop\-daemon\fP \(:ahnlich zu \fBkillall\fP(1). \fBstart\-stop\-daemon\fP wird die Prozesstabelle nach Prozessen durchsuchen, die auf den Prozessnamen, die Eltern\-PID, uid und/oder gid (falls angegeben) passen. Jeder passende Prozess wird \fB\-\-start\fP daran hindern, den Daemon zu starten. Allen passenden Prozessen wird das TERM\-Signal (oder das mit \fB\-\-signal\fP oder \fB\-\-retry\fP angegebene) geschickt, falls \fB\-\-stop\fP angegeben ist. F\(:ur Daemons die langlebige Kinder haben, die ein \fB\-\-stop\fP \(:uberleben m\(:ussen, m\(:ussen Sie eine PID\-Datei angeben. . .SH BEFEHLE .TP \fB\-S\fP, \fB\-\-start\fP [\fB\-\-\fP] \fIArgumente\fP Pr\(:ufe auf Existenz eines angegebenen Prozesses. Falls ein solcher Prozess existiert f\(:uhrt \fBstart\-stop\-daemon\fP nichts aus und beendet sich mit Fehlerstatus 1 (0, falls \fB\-\-oknodo\fP angegeben wurde). Falls ein solcher Prozess nicht existiert, dann startet es eine Instanz, entweder unter Verwendung des ausf\(:uhrbaren Programms, das mittels \fB\-\-exec\fP (oder, falls angegeben, mittels \fB\-\-startas\fP) spezifiziert wurde. Jedes weitere auf der Befehlszeile nach \fB\-\-\fP angegebene Argument wird unver\(:andert an das zu startende Programm weitergegeben. .TP \fB\-K\fP, \fB\-\-stop\fP \(:Uberpr\(:uft auf die Existenz eines speziellen Prozesses. Falls ein solcher Prozess existiert, dann sendet \fBstart\-stop\-daemon\fP das durch \fB\-\-signal\fP angegebene Signal und beendet sich mit Fehlerstatus 0. Falls kein solcher Prozess existiert, dann beendet sich \fBstart\-stop\-daemon\fP mit Fehlerstatus 1 (0 falls \fB\-\-oknodo\fP angegeben ist). Falls \fB\-\-retry\fP angegeben wurde, wird \fBstart\-stop\-daemon\fP \(:uberpr\(:ufen, ob der/die Prozess(e) beendet wurden. .TP \fB\-T\fP, \fB\-\-status\fP \(:Uberpr\(:uft auf die Existenz eines bestimmten Prozesses und liefert den Exit\-Status\-Code entsprechend der \(FcLSB Init Script Actions\(Fo zur\(:uck (seit Version 1.16.1). .TP \fB\-H\fP, \fB\-\-help\fP Zeige Bedienungsinformationen und beendet sich. .TP \fB\-V\fP, \fB\-\-version\fP Zeige die Programmversion und beendet sich. . .SH OPTIONEN .SS Abgleichoptionen .TP \fB\-\-pid\fP \fIPID\fP Pr\(:ufe auf einen Prozess mit der angegebenen \fIPID\fP (seit Version 1.17.6). Die \fIPID\fP muss eine Zahl gr\(:o\(sser Null sein. .TP \fB\-\-ppid\fP \fIPPID\fP Pr\(:ufe auf einen Prozess mit der angegebenen Eltern\-PID \fIPPID\fP (seit Version 1.17.7). Die \fIPPID\fP muss eine Zahl gr\(:o\(sser Null sein. .TP \fB\-p\fP, \fB\-\-pidfile\fP \fIpid\-Datei\fP Pr\(:ufe, ob ein Prozess \fIpid\-Datei\fP erstellt hat. Hinweis: Wird diese Abgleichoption alleine verwandt, k\(:onnte auf nicht geplante Prozesse eingewirkt werden, falls der alte Prozess beendet wurde, ohne dass er \fIpid\-Datei\fP entfernen konnte. .TP \fB\-x\fP, \fB\-\-exec\fP \fIProgramm\fP \(:Uberpr\(:ufe auf Prozesse, die Instanzen von diesem Programm sind. Das Argument \fIProgramm\fP sollte ein absoluter Pfadname sein. Hinweis: Dies k\(:onnte bei interpretierten Skripten nicht wie geplant funktionieren, da das \fIProgramm\fP auf den Interpreter zeigt. Ber\(:ucksichtigen Sie, dass dies auch auf Prozesse, die innerhalb einer Chroot laufen, passen k\(:onnte, daher k\(:onnten andere Abgleichrestriktionen ben\(:otigt werden. .TP \fB\-n\fP, \fB\-\-name\fP \fIProzessname\fP \(:Uberpr\(:ufe auf Prozesse mit dem Namen \fIProzessname\fP. Der \fIProzessname\fP ist normalerweise der Dateiname des Prozesses, er k\(:onnte aber vom Prozess selbst ge\(:andert worden sein. Hinweis: Auf den meisten Systemen wird diese Information aus dem \(Fccomm\(Fo\-Namen des Prozesses aus dem Kernel ausgelesen. Dieser hat typischerweise eine recht kurze L\(:angenbegrenzung (mehr als 15 Zeichen anzunehmen ist nicht portabel). .TP \fB\-u\fP, \fB\-\-user\fP \fIBenutzername\fP|\fIuid\fP \(:Uberpr\(:ufe auf Prozesse die dem mit \fIBenutzername\fP oder \fIuid\fP spezifizierten Benutzer geh\(:oren. Hinweis: Wird diese Abgleichoption alleine verwandt, wird auf alle Prozesse, die auf den Benutzer passen, eingewirkt. . .SS "Allgemeine Optionen:" .TP \fB\-g\fP, \fB\-\-group\fP \fIGruppe\fP|\fIgid\fP Wechsle zum Starten des Prozesses zur \fIGruppe\fP oder \fIgid\fP. .TP \fB\-s\fP, \fB\-\-signal\fP \fISignal\fP Mit \fB\-\-stop\fP wird das an den zu beendenden Prozess zu sendende Signal spezifiziert (standardm\(:a\(ssig TERM). .TP \fB\-R\fP, \fB\-\-retry\fP \fIZeit\(:uberschreitung\fP|\fIPlan\fP Mit \fB\-\-stop\fP spezifiziert, dass \fBstart\-stop\-daemon\fP \(:uberpr\(:ufen soll, ob der Prozess (die Prozesse) sich beenden. Es \(:uberpr\(:uft wiederholt, ob passende Prozesse laufen, bis dies nicht mehr der Fall ist. Falls sich die Prozesse nicht beenden, werden weitere im \(FcPlan\(Fo angegebene Aktionen durchgef\(:uhrt. Falls \fIZeit\(:uberschreitung\fP anstelle von \fIPlan\fP spezifiziert wird, dann wird der Plan \fISignal\fP\fB/\fP\fIZeit\(:uberschreitung\fP\fB/KILL/\fP\fIZeit\(:uberschreitung\fP verwendet, wobei \fISignal\fP das mit \fB\-\-signal\fP spezifizierte Signal ist. \fIPlan\fP ist eine Liste von mindestens zwei durch Schr\(:agstriche (\fB/\fP) getrennten Punkten; jeder Punkt kann aus \fB\-\fP\fISignalnummer\fP oder [\fB\-\fP]\fISignalname\fP bestehen, was bedeutet, dass dieses Signal gesendet werden soll, oder aus \fIZeit\(:uberschreitung\fP, was bedeutet, dass soviele Sekunden auf das Beenden von Prozessen gewartet werden soll, oder aus \fBforever\fP was bedeutet, den Rest des Plans falls notwendig f\(:ur immer zu wiederholen. Falls das Ende des Plans erreicht wird und \fBforever\fP nicht spezifiziert wurde, dann beendet sich der \fBstart\-stop\-daemon\fP mit dem Fehlerstatus 2. Falls ein Plan spezifiziert wurde, dann wird jedes mit \fB\-\-signal\fP spezifizierte Signal ignoriert. .TP \fB\-a\fP, \fB\-\-startas\fP \fIPfadname\fP Mit \fB\-\-start\fP wird der \(:uber \fIPfadname\fP spezifizierte Prozess gestartet. Falls nicht angegeben, werden standardm\(:a\(ssig die an \fB\-\-exec\fP \(:ubergebenen Argumente verwendet. .TP \fB\-t\fP, \fB\-\-test\fP Gebe die Aktionen aus, die erledigt w\(:urden und setze die entsprechenden R\(:uckgabewerte, f\(:uhre aber keine Aktionen durch. .TP \fB\-o\fP, \fB\-\-oknodo\fP Liefert den R\(:uckgabewert 0 anstatt 1 falls keine Aktionen ausgef\(:uhrt wurden (w\(:urden). .TP \fB\-q\fP, \fB\-\-quiet\fP Gebe keine informativen Meldungen aus, zeige nur Fehlermeldungen an. .TP \fB\-c \fP, \fB \-\-chuid \fP\fIBenutzername\fP|\fIuid\fP[\fB:\fP\fIGruppe\fP|\fIgid\fP] Wechsele vor dem Start des Prozesses zu diesem Benutzername/uid. Sie k\(:onnen durch Anh\(:angen von \fB:\fP auch die Gruppe spezifizieren, in diesem Fall wird die Gruppe oder gid wie bei dem Befehl \fBchown\fP(1) (\fIBenutzer\fP\fB:\fP\fIGruppe\fP) angegeben. Falls ein Benutzer ohne Gruppe angegeben ist, wird die prim\(:are GID f\(:ur diesen Benutzer verwandt. Wenn Sie diese Option verwenden, m\(:ussen Sie daran denken, dass die prim\(:are und zus\(:atzliche Gruppen auch gesetzt werden, selbst wenn die Option \fB\-\-group\fP nicht angegeben wird. Die Option \fB\-\-group\fP ist nur f\(:ur Gruppen, in denen der Benutzer normalerweise kein Mitglied ist (wie das Hinzuf\(:ugen von pro\-Prozess Gruppenmitgliedschaften f\(:ur generische Benutzer wie \fBnobody\fP). .TP \fB\-r\fP, \fB\-\-chroot\fP \fIWurzel\fP Chdir und chroot vor dem Start des Prozesse zu \fIWurzel\fP. Bitte beachten Sie, dass die PID\-Datei auch nach dem chroot geschrieben wird. .TP \fB\-d\fP, \fB\-\-chdir\fP \fIPfad\fP Chdir vor dem Starten des Prozesses zu \fIPfad\fP. Dies wird, falls die \fB\-r\fP|\fB\-\-chroot\fP Option gesetzt ist, nach dem chroot durchgef\(:uhrt. Falls nicht angegeben, wird \fBstart\-stop\-daemon\fP vor dem Prozess\-Start in das Wurzelverzeichnis wechseln. .TP \fB\-b\fP, \fB\-\-background\fP Typischerweise verwendet f\(:ur Programme, die sich nicht selbst\(:andig abl\(:osen. Diese Option zwingt \fBstart\-stop\-daemon\fP vor dem Start des Prozesses einen Fork durchzuf\(:uhren, und zwingt diesen dann in den Hintergrund. \fBWarnung: start\-stop\-daemon\fP kann nicht den R\(:uckgabewert \(:uberpr\(:ufen, falls der Prozess aus \fBirgendeinem\fP Grund nicht startet. Dies ist ein letztes Mittel und ist nur f\(:ur Programme gedacht, bei denen das selbstst\(:andige Forken keinen Sinn ergibt oder wo es nicht sinnvoll ist, den Code hierf\(:ur hinzuzuf\(:ugen. .TP \fB\-C\fP, \fB\-\-no\-close\fP Keinen Dateideskriptor schlie\(ssen, 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 \fB\-\-background\fP. .TP \fB\-N\fP, \fB\-\-nicelevel\fP \fIGanzzahl\fP Dies \(:andert die Priorit\(:at des Prozesses bevor er gestartet wird. .TP \fB\-P\fP, \fB\-\-procsched\fP \fIStrategie\fP\fB:\fP\fIPriorit\(:at\fP Dies \(:andert die Prozesssteuerstrategie (\(Fcprocess scheduler policy\(Fo) und die Priorit\(:at des Prozesses, bevor dieser gestartet wird (seit Version 1.15.0). Die Priorit\(:at kann optional festgelegt werden, indem ein \fB:\fP gefolgt von einem Wert angegeben wird. Die Standard\-\fIPriorit\(:at\fP betr\(:agt 0. Die derzeit unterst\(:utzten Werte f\(:ur die Strategie lauten \fBother\fP, \fBfifo\fP und \fBrr\fP. .TP \fB\-I\fP, \fB\-\-iosched\fP \fIKlasse\fP\fB:\fP\fIPriorit\(:at\fP Dies \(:andert die IO\-Steuerklasse (\(FcIO scheduler class\(Fo) und die Priorit\(:at des Prozesses, bevor dieser gestartet wird (seit Version 1.15.0). Die Priorit\(:at kann optional festgelegt werden, indem ein \fB:\fP gefolgt von einem Wert angegeben wird. Die Standard\-\fIPriorit\(:at\fP betr\(:agt 4, au\(sser \fIKlasse\fP lautet \fBidle\fP, dann betr\(:agt sie immer 7. Die derzeit unterst\(:utzten Werte f\(:ur die \fIKlasse\fP lauten \fBidle\fP, \fBbest\-effort\fP und \fBreal\-time\fP. .TP \fB\-k\fP, \fB\-\-umask\fP \fIMaske\fP Dies setzt die umask des Prozesses, bevor er gestartet wird (seit Version 1.13.22). .TP \fB\-m\fP, \fB\-\-make\-pidfile\fP Verwendet, wenn ein Programm gestartet wird, das keine eigene PID\-Datei anlegt. Diese Option sorgt daf\(:ur, dass \fBstart\-stop\-daemon\fP die mit \fB\-\-pidfile\fP referenzierte Datei anlegt und die PID kurz vor der Ausf\(:uhrung des Prozesse hineinlegt. Beachten Sie, dass die Datei beim Anhalten des Programms nur entfernt wird, falls \fB\-\-remove\-pidfile\fP verwandt wird. \fBHinweis:\fP Diese Funktion k\(:onnte in nicht allen F\(:allen funktionieren. Insbesondere wenn das auszuf\(:uhrende Programm sich vom Hauptprozess forkt. Deshalb ist diese Option normalerweise nur in Kombination mit der Option \fB\-\-background\fP sinnvoll. .TP \fB\-\-remove\-pidfile\fP Wird verwandt, wenn ein Programm gestoppt wird, das seine PID\-Datei nicht entfernt (seit Version 1.17.19). Diese Option f\(:uhrt dazu, dass \fBstart\-stop\-daemon\fP die durch \fB\-\-pidfile\fP referenzierte Datei nach der Beendigung des Prozesses entfernt. .TP \fB\-v\fP, \fB\-\-verbose\fP Gibt ausf\(:uhrliche informative Meldungen aus. . .SH R\(:UCKGABEWERT .TP \fB0\fP Die angeforderte Aktion wurde durchgef\(:uhrt. Falls \fB\-\-oknodo\fP angegeben wurde, kann es auch sein, dass nicht durchgef\(:uhrt wurde. Das kann passieren, wenn \fB\-\-start\fP angegeben wurde und der passende Prozess bereits lief oder wenn \fB\-\-stop\fP angegeben wurde und es keinen passenden Prozess gab. .TP \fB1\fP Falls \fB\-\-oknodo\fP nicht angegeben war und nichts durchgef\(:uhrt wurde. .TP \fB2\fP Falls \fB\-\-stop\fP und \fB\-\-retry\fP angegeben waren, aber das Ende des Plans erreicht wurde und die Prozesse noch liefen. .TP \fB3\fP Jeder andere Fehler. .PP Bei der Verwendung des Befehls \fB\-\-status\fP werden die folgenden Statuscodes zur\(:uckgeliefert: .TP \fB0\fP Programm l\(:auft. .TP \fB1\fP Programm l\(:auft nicht und die PID\-Datei existiert. .TP \fB3\fP Programm l\(:auft nicht. .TP \fB4\fP Programmstatus kann nicht bestimmt werden. . .SH BEISPIEL Starte den Daemon \fBfood\fP falls noch keiner l\(:auft (ein Prozess mit Namen food, der als Benutzer food mit PID in food.pid l\(:auft): .IP .nf start\-stop\-daemon \-\-start \-\-oknodo \-\-user food \-\-name food \e \-\-pidfile /run/food.pid \-\-startas /usr/sbin/food \e \-\-chuid food \-\- \-\-daemon .fi .PP Schicke \fBSIGTERM\fP an \fBfood\fP und warte bis zu f\(:unf Sekunden auf sein Beenden: .IP .nf start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e \-\-pidfile /run/food.pid \-\-retry 5 .fi .PP Vorf\(:uhrung eines angepassten Plans zum Beenden von \fBfood\fP: .IP .nf start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e \-\-pidfile /run/food.pid \-\-retry=TERM/30/KILL/5 .fi .SH \(:UBERSETZUNG Die deutsche \(:Ubersetzung wurde 2004, 2006-2017 von Helge Kreutzmann , 2007 von Florian Rehnisch und 2008 von Sven Joachim angefertigt. Diese \(:Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 2 oder neuer f\(:ur die Kopierbedingungen. Es gibt KEINE HAFTUNG.