Installation¶

Das Paket networkd-dispatcher ist bei jedem Ubuntu-System als Standardkomponente bereits installiert. Bei Bedarf kann es so installiert werden:

• networkd-dispatcher

Befehl zum Installieren der Pakete:

sudo apt-get install networkd-dispatcher 

Oder mit apturl installieren, Link: apt://networkd-dispatcher

Arbeitsweise¶

Die beiden systemd-Units systemd-networkd.service und networkd-dispatcher.service müssen aktiv sein. Kontrolle^[2]:

systemctl status systemd-networkd.service
systemctl status networkd-dispatcher.service 

Sobald systemd-networkd bei einer Schnittstelle einen Zustandswechsel erkennt, startet es networkd-dispatcher und dieser startet die Programme in dem Verzeichnis, welches zu dem neuen Zustand der Schnittstelle gehört. Dies funktioniert auch, wenn systemd-networkd die Schnittstelle nicht selber konfiguriert hat.

Konfiguration¶

networkd-dispatcher startet Programme in Unterverzeichnissen von

• /etc/networkd-dispatcher und

• /usr/lib/networkd-dispatcher

Dabei überlagern Dateien unter /etc gleichnamige Dateien unter /usr. Man sollte eigene Dateien vorzugsweise unter /etc ablegen und /usr den Distributionen vorbehalten.

Es werden diese Unterverzeichnisse berücksichtigt:

ls /etc/networkd-dispatcher/ 

carrier.d  degraded.d  dormant.d  no-carrier.d  off.d  routable.d 

Der Name des Unterverzeichnisses entspricht natürlich dem neuen Zustand der Schnittstelle.

Die Konfigurationsverzeichnisse müssen root gehören und niemand außer root darf in diese Ordner schreiben können.

Details zu den Skripten¶

Als Programm kann man beispielsweise eine ausführbare Textdatei mit einem Shell-Skript in das passende Verzeichnis legen, und dies ist auch als Regelfall so vorgesehen. Die Datei muss root gehören und niemand außer root darf sie beschreiben dürfen.

Die Programme werden mit diesen Umständen ausgeführt:

1. Sie werden als root ausgeführt.

2. Bei mehreren Dateien in einem Verzeichnis kann man die Reihenfolge der Ausführung nicht steuern.

3. Als Arbeitsverzeichnis ist die Wurzel des Dateibaums / gesetzt.

4. Es gibt keine Argumente auf der „Kommandozeile“. "$0" ist der Dateiname.

5. stdin ist geschlossen, stdout ist unbekannt und stderr schreibt in das Systemlog.

6. Sie laufen in einer Programmumgebung mit diesen Variablen:
   

   OperationalState=routable
   IP6_ADDRS=
   NOTIFY_SOCKET=/run/systemd/notify
   JOURNAL_STREAM=9:18243
   PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
   INVOCATION_ID=e1ed182dc4f34afca8368e7a7f677da4
   LANG=de_DE.UTF-8
   AdministrativeState=unmanaged
   IP_ADDRS=
   networkd_dispatcher_args=--run-startup-triggers
   IFACE=radio
   PWD=/
   ADDR=
   STATE=routable 

   Die Werte sind natürlich nur Beispiele. Man kann sich nicht darauf verlassen, dass alle Variablen mit vernünftigen Werten versehen sind und es gibt situationsabhängig noch weitere Umgebungsvariablen. Bei einer WLAN-Schnittstelle wurde z.B. die richtige SSID als ESSID übergeben.

• Die wichtigste Variable ist IFACE. Hier steht, um welche Schnittstelle es sich handelt.

• Die Variablen OperationalState und AdministrativeState entsprechen wohl (d.h. nach bisherigen Erfahrungen) den Ausgaben von networkctl.

• Die Variable STATE entspricht wohl dem Verzeichnis bzw. dem neuen Zustand der Schnittstelle.

Beispiele¶

#! /bin/bash -e

LOG ()	{ echo ${*:- } ;} >&2

LOG IFACE=$IFACE $OperationalState

journalctl -b -u networkd-dispatcher.service 

Mai 04 10:01:29 networkd-dispatcher[95390]: IFACE=eth0 routable
Mai 04 10:04:37 networkd-dispatcher[95577]: IFACE=eth0 off
Mai 04 10:04:38 networkd-dispatcher[95580]: IFACE=WLAN routable

Links¶

• Manpage zu networkd-dispatcher 🇬🇧 – bei Focal Fossa

• systemd

• systemd/networkd

• systemd/Units