.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSTEMD\-NOTIFY 1 "" "systemd 241" 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\fB[OPTIONS...]\fR\fB\ \fR\fB[VARIABLE=VALUE...]\fR\ 'u \fBsystemd\-notify \fP\fB[OPTIONEN…]\fP\fB \fP\fB[VARIABLE=WERT…]\fP .SH BESCHREIBUNG .PP \fBsystemd\-notify\fP kann von Daemon\-Skripten zur Benachrichtigung des Init\-Systems ü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 für die Dienste\-Unit, aus der dieser Befehl aufgerufen wird, gesetzt ist\&. .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 PID 1 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\&. .PP \fBsystemd\-notify\fP wird erst versuchen, \fBsd_notify()\fP aufzurufen und dabei vorzugeben, die PID 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 oben beschriebenen Einschränkungen von \fINotifyAccess=\fP\fBall\fP im Hauptprozess eines Dienstes erscheint\&. .SH OPTIONEN .PP Die folgenden Optionen werden verstanden: .PP \fB\-\-ready\fP .RS 4 Informiert das Init\-System über den Abschluss des Startens von Diensten\&. 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\-\-pid=\fP .RS 4 Informiert das Init\-System über die Haupt\-PID des Daemons\&. Akzeptiert eine PID als Argument\&. Falls das Argument fehlt, wird die PID des \fBsystemd\-notify\fP aufrufenden Prozesses verwandt\&. Dies ist zu \fBsystemd\-notify MAINPID=$PID\fP äquivalent\&. Für Details über die Semantik dieser Option siehe \fBsd_notify\fP(3)\&. .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\&. .RE .PP \fB\-\-status=\fP .RS 4 Sendet eine formlose Statuszeichenkette für den Daemon an das Init\-System\&. 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)\&. .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\-h\fP, \fB\-\-help\fP .RS 4 Zeigt einen kurzen Hilfetext an und beendet das Programm\&. .RE .PP \fB\-\-version\fP .RS 4 Zeigt eine kurze Versionszeichenkette an und beendet das Programm\&. .RE .SH RÜCKGABEWERT .PP Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null\&. .SH BEISPIEL .PP \fBExample\ \&1.\ \&Startbenachrichtigungen und Statusaktualisierungen\fP .PP Ein einfacher Shell\-Daemon, der Startbenachrichtigungen versendet, nachdem er einen Kommunikationskanal eingerichtet hat\&. Während der Laufzeit sendet er weitere Statusaktualisierungen an das Init\-System: .sp .if n \{\ .RS 4 .\} .nf #!/bin/bash mkfifo /tmp/waldo systemd\-notify \-\-ready \-\-status="Warte auf Daten…" while : ; do read a < /tmp/waldo systemd\-notify \-\-status="Verarbeite $a" # Mache etwas mit $a … systemd\-notify \-\-status="Warten auf Daten…" done .fi .if n \{\ .RE .\} .SH "SIEHE AUCH" .PP \fBsystemd\fP(1), \fBsystemctl\fP(1), \fBsystemd.unit\fP(5), \fBsd_notify\fP(3), \fBsd_booted\fP(3) .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an .