.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSTEMD\-NOTIFY 1 "" "systemd 256.5" systemd\-notify .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH BEZEICHNUNG systemd\-notify \- Den Diensteverwalter über den Abschluss des Startens und andere Statusänderungen des Daemons benachrichtigen .SH ÜBERSICHT .HP \w'\fBsystemd\-notify\fR\ 'u \fBsystemd\-notify\fP [OPTIONEN…] [VARIABLE=WERT…] .HP \w'\fBsystemd\-notify\fR\ 'u \fBsystemd\-notify\fP [\-\-exec] [OPTIONEN…] [VARIABLE=WERT…] [;] [BEFEHLSZEILE…] .SH BESCHREIBUNG .PP \fBsystemd\-notify\fP kann von Dienste\-Skripten zur Benachrichtigung des aufrufenden Diensteverwalters über Statusänderungen aufgerufen werden\&. Es kann zum Senden beliebiger Informationen, kodiert in einer umgebungsblockartigen Zeichenkettenliste, verwandt werden\&. Am wichtigsten ist der Einsatz zur Benachrichtigung über den Abschluss des Starts\&. .PP Dies ist hauptsächlich eine Hülle um \fBsd_notify()\fP und stellt diese Funktionalität Shell\-Skripten zur Verfügung\&. Für Details siehe \fBsd_notify\fP(3)\&. .PP Dieser Befehl kann eine Liste von Umgebungsvariablen transportieren, die als Teil der Statusaktualisierung gesandt werden sollen\&. .PP Beachten Sie, dass Systemd den Empfang von Statusaktualisierungen aus diesem Befehl verweigern wird, falls nicht \fINotifyAccess=\fP geeignet für die Dienste\-Unit, aus der dieser Befehl aufgerufen wird, gesetzt ist\&. Siehe \fBsystemd.service\fP(5) für Details\&. .PP Beachten Sie, dass \fBsd_notify()\fP\-Benachrichtigungen nur Units korrekt zugeordnet werden können, falls entweder der sendende Prozess noch zu dem Zeitpunkt vorhanden ist, zu dem der Diensteverwalter die Nachricht verarbeitet oder falls der sendende Prozess explizit vom Diensteverwalter laufzeitverfolgt ist\&. Letzteres ist der Fall, falls der Diensteverwalter den Prozess ursprünglich mit »fork« erzeugte, d\&.h\&. bei allen Prozessen, die auf \fINotifyAccess=\fP\fBmain\fP oder \fINotifyAccess=\fP\fBexec\fP passen\&. Umgekehrt, falls ein Hilfsprozess einer Unit eine \fBsd_notify()\fP\-Nachricht sendet und sich sofort beendet, könnte der Diensteverwalter nicht in der Lage sein, die Nachricht korrekt der Unit zuzuordnen und wird sie daher ignorieren, selbst falls \fINotifyAccess=\fP\fBall\fP für sie gesetzt ist\&. Um dieses zu beheben, wird \fBsystemd\-notify\fP warten, bis alle Benachrichtigungsmeldungen durch den Diensteverwalter verarbeitet wurden\&. Wenn \fB\-\-no\-block\fP verwandt wird, wird diese Synchronisationen zum Empfang von Benachrichtigungen deaktiviert und daher kann der weiter oben erwähnte Ressourcenwettlauf stattfinden, falls der aufrufende Prozess nicht der Diensteverwalter ist oder von diesem erzeugt wurde\&. .PP \fBsystemd\-notify\fP wird zuerst versuchen, \fBsd_notify()\fP aufzurufen und dabei vorzugeben, die PID des übergeordneten Prozesses von \fBsystemd\-notify\fP (d\&.h\&. des aufrufenden Prozesses) zu besitzen\&. Dies gelingt nur, wenn der Aufruf mit ausreichenden Privilegien erfolgt\&. Beim Fehlschlag wird er dann auf den Aufruf unter seiner eigenen PID zurückfallen\&. Dieses Verhalten ist nützlich, damit der Shell\-Prozess \(em und nicht der \fBsystemd\-notify\fP\-Prozess \(em im Falle des Aufrufs des Werkzeugs aus einem Shell\-Skript als Sender der Nachricht erscheint, was wiederum hilfreich ist, falls der Shell\-Prozess aufgrund der Einschränkungen von \fINotifyAccess=\fP\fBall\fP im Hauptprozess eines Dienstes erscheint\&. Verwenden Sie den Schalter \fB\-\-pid=\fP, um dieses Verhalten anzupassen\&. .SH OPTIONEN .PP Die folgenden Optionen werden verstanden: .PP \fB\-\-ready\fP .RS 4 Informiert den aufrufenden Diensteverwalter über den Abschluss des Dienstestarts oder des Neuladens der Konfiguration\&. Dies ist zu \fBsystemd\-notify READY=1\fP äquivalent\&. Für Details über die Semantik dieser Option siehe \fBsd_notify\fP(3)\&. .RE .PP \fB\-\-reloading\fP .RS 4 Informiert den aufrufenden Diensteverwalter über den Anfang eines Konfigurationsneuladezyklus\&. Die ist zu \fBsystemd\-notify RELOADING=1\fP äquivalent (setzt aber implizit auch das für den Dienst \fIType=notify\-reload\fP benötigte Feld \fIMONOTONIC_USEC=\fP, siehe \fBsystemd.service\fP(5) für Details)\&. Für Details zur Semantik dieser Option siehe \fBsd_notify\fP(3)\&. .sp Hinzugefügt in Version 253\&. .RE .PP \fB\-\-stopping\fP .RS 4 Informiert den aufrufenden Diensteverwalter über den Anfang der Herunterfahrphase des Dienstes\&. Dies ist zu \fBsystemd\-notify STOPPING=1\fP äquivalent\&. Für Details über die Semantik dieser Option siehe \fBsd_notify\fP(3)\&. .sp Hinzugefügt in Version 253\&. .RE .PP \fB\-\-pid=\fP .RS 4 Informiert den Diensteverwalter über die Haupt\-PID des Dienstes\&. Akzeptiert eine PID als Argument\&. Falls das Argument als »auto« angegeben ist oder fehlt, wird die PID des \fBsystemd\-notify\fP aufrufenden Prozesses verwandt, außer falls dies der Diensteverwalter ist\&. Falls das Argument als »self« angegeben ist, wird die PID des Befehls \fBsystemd\-notify\fP selbst verwandt, und falls »parent« angegeben ist, wird die PID des aufrufenden Prozesses verwandt \(em selbst falls dies der Diensteverwalter selbst ist\&. \fB\-\-pid=auto\fP ist zu \fBsystemd\-notify MAINPID=$PID\fP äquivalent\&. Für Details über die Semantik dieser Option siehe \fBsd_notify\fP(3)\&. .sp Falls dieser Schalter im Aufruf von \fBsystemd\-notify\fP aus einem Prozess, der der neue Hauptprozess des Dienstes werden soll \(en und der nicht der vom Diensteverwalter mit Fork erzeugte Prozess ist (oder der aktuelle Hauptprozess) \(en verwandt wird, dann ist es wesentlich, \fINotifyAccess=all\fP in der Dienste\-Unit\-Datei zu setzen oder andernfalls wird die Benachrichtigung aus Sicherheitsgründen ignoriert\&. Siehe \fBsystemd.service\fP(5) für Details\&. .RE .PP \fB\-\-uid=\fP\fIBENUTZER\fP .RS 4 Setzt die Benutzerkennung von der die Benachrichtigung gesendet werden soll\&. Akzeptiert einen UNIX\-Benutzernamen oder eine numerische UID\&. Wenn angegeben, wird die Benachrichtigungsmeldung mit der angegebenen UID als Absender gesandt, anstelle die des Benutzers, unter der es aufgerufen wurde\&. Diese Option benötigt ausreichende Privilegien, um in der Lage zu sein, die Benutzerkennung des Prozesses zu verändern\&. .sp Hinzugefügt in Version 237\&. .RE .PP \fB\-\-status=\fP .RS 4 Sendet eine formlose, menschenlesbare Statuszeichenkette für den Daemon an den Dienste\-Verwalter\&. Diese Option akzeptiert die Statuszeichenkette als Argument\&. Dies ist zu \fBsystemd\-notify STATUS=…\fP äquivalent\&. Für Details über die Semantik dieser Option siehe \fBsd_notify\fP(3)\&. Diese Information wird unter anderem in der Ausgabe von \fBsystemctl\fP(1) \fBstatus\fP angezeigt\&. .RE .PP \fB\-\-booted\fP .RS 4 Liefert 0 zurück, falls das System mit Systemd gestartet wurde, einen anderen Wert andernfalls\&. Falls diese Option übergeben wurde, wird keine Nachricht gesandt\&. Diese Option hat daher keinen Bezug zu den anderen Optionen\&. Für Details über die Semantik dieser Option, siehe \fBsd_booted\fP(3)\&. Eine alternative Art, auf diesen Zustand zu prüfen, ist der Aufruf \fBsystemctl\fP(1) mit dem Befehl \fBis\-system\-running\fP\&. Er wird »offline« zurückliefern, falls das System nicht mit Systemd gestartet wurde\&. .RE .PP \fB\-\-no\-block\fP .RS 4 Wartet nicht synchron auf den Abschluss der angefragten Option\&. Der Einsatz dieser Option wird nur empfohlen, wenn \fBsystemd\-notify\fP vom Diensteverwalter erzeugt wurde oder wenn der aufrufende Prozess direkt durch den Diensteverwalter erzeugt wurde und über genug Privilegien verfügt, um \fBsystemd\-notify\fP zu erlauben, die Benachrichtigungen an seiner Stelle zu senden\&. Das Senden von Benachrichtigungen mit dieser Option ist in allen anderen Fällen anfällig für Ressourcenwettläufe\&. .sp Hinzugefügt in Version 246\&. .RE .PP \fB\-\-exec\fP .RS 4 Falls angegeben wird \fBsystemd\-notify\fP eine andere Befehlszeile ausführen, nachdem es seine Aktion abgeschlossen hat, und seinen eigenen Prozess ersetzen\&. Falls verwandt, muss die Liste der Zuweisungen, die in der versandten Meldung aufgenommen werden soll, von einem Zeichen »;« gefolgt werden (als getrenntes Argument), gefolgt von der auszuführenden Befehlszeile\&. Dies erlaubt das »Verketten« von Befehlen, d\&.h\&. dem Ausgeben einer Aktionen mit sofort folgender zweiten, ohne die PID zu verändern\&. .sp Beachten Sie, dass viele Shells »;« als ihr eigenes Trennzeichen für Befehlszeilen interpretieren, daher muss das Semikolon normalerweise als »\e;« maskiert werden, wenn \fBsystemd\-notify\fP von der Shell aufgerufen wird\&. .sp Hinzugefügt in Version 254\&. .RE .PP \fB\-\-fd=\fP .RS 4 Sendet zusammen mit der Benachrichtigungsmeldung einen Dateideskriptor\&. Dies ist in Diensten nützlich, bei denen die Einstellung \fIFileDescriptorStoreMax=\fP aktiviert ist; siehe \fBsystemd.service\fP(5) zu Details\&. Der angegebene Dateideskriptor muss beim Aufruf an \fBsystemd\-notify\fP übergeben werden\&. Diese Option kann mehrfach verwandt werden, um mehrere Dateideskriptoren in einer einzelnen Benachrichtigungsmeldung zu übergeben\&. .sp Um diese Funktionalität von einer \fBbash\fP(1)\-Shell zu verwenden, nutzen Sie einen Ausdruck der folgenden Art: .sp .if n \{\ .RS 4 .\} .nf systemd\-notify \-\-fd=4 \-\-fd=5 4 erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .