networkctl

networkctl - Status der Netzwerkverbindungen abfragen oder verändern

Beschreibung

networkctl kann zum Abfragen und Verändern des Zustands von Netzwerkverbindungen, wie sie von systemd-networkd gesehen werden, verwandt werden.

Konzepte, Funktionalitäten und Konfigurationssyntax

systemd-networkd.service(8)

Dieses Programm funktioniert eingeschränkt auch dann, wenn systemd-networkd nicht läuft bzw. die systemd-Unit systemd-networkd.service inaktiv ist und mit sehr eingeschränkter Funktionalität sogar dann, wenn systemd nicht installiert ist

Installation

Aufruf

networkctl [OPTIONEN…] BEFEHL [VERBINDUNG…]

Optionen

Unix	GNU	Parameter	Beschreibung
-a	--all		Zeigt mit status alle Verbindungen
-s	--stats		Zeigt mit status Link-Statistiken
-l	--full		Verkürzt die Ausgabe nicht
-n	--lines=		Steuert bei der Verwendung mit status die Anzahl der anzuzeigenden Journal-Einträge, gezählt vom neusten. Akzeptiert eine positive Ganzzahl als Argument. Standardmäßig 10
	--drop-in=	NAME	Bearbeitet bei der Verwendung mit edit die Ergänzungsdatei NAME anstelle der Hauptkonfigurationsdatei
	--no-reload		Bei der Verwendung mit edit, mask oder unmask werden systemd-networkd.service(8) oder systemd-udevd.service(8) nicht nach Abschluss der Aktion neu geladen
	--runtime		When used with edit or mask, operate on the file under /run/ instead of /etc/
	--json=	MODUS	Zeigt die Ausgabe als JSON formatiert. Erwartet entweder short (für die kürzest mögliche Ausgabe ohne unnötigen Leerraum oder Zeilenumbrüche),pretty (für eine schönere Version der gleichen Ausgabe, mit Einzügen und Zeilenumbrüchen) oder off (um die JSON-Ausgabe auszuschalten, was die Vorgabe ist)
-h	--help		Zeigt einen kurzen Hilfetext an und beendet das Programm
	--version		Zeigt eine kurze Versionszeichenkette an und beendet das Programm
	--no-legend		Gibt die Legende nicht aus, d.h. die Spaltenköpfe und die Fußzeile mit Hinweisen
	--no-pager		Leitet die Ausgabe nicht an ein Textanzeigeprogramm weiter

Parameter

Umgebungsvariablen

Exit-Status

Wert	Beschreibung
0	Erfolg
>0	Fehler

Anwendung

Zustand ermitteln

Liste der im System vorhandenen Schnittstellen

Der Befehlsteil list ist optional

# networkctl list
IDX LINK TYPE OPERATIONAL SETUP
1 lo loopback carrier unmanaged
2 cable ether no-carrier unmanaged
3 radio wlan routable unmanaged
6 HUB bridge no-carrier configuring

networkctl zeigt hier auch Schnittstellen an, welche gar nicht von systemd-networkd betreut werden

Die Angabe unmanaged ist zu lesen als: "Nicht von systemd-networkd verwaltet, aber möglicherweise von einem anderen Programm"

Kurze Übersicht der aktiven IP-Konfiguration des Systems:

networkctl status

Zusätzlich wird auch ein Auszug der relevanten Meldungen aus dem Systemlog angezeigt

Ausführliche Übersicht der IP-Konfiguration einer Schnittstelle

Schnittstelle hier beispielhaft: lo

networkctl status lo

Hier wird auch angezeigt, welche .link- und .network-Datei tatsächlich zur Konfiguration der Schnittstelle verwendet wurde

Ausführiche Übersicht der aktiven IP-Konfiguration des Systems

networkctl status --all

Schnittstelle löschen

Es können natürlich nur Software-Schnittstellen (hier als schlechtes Beispiel: lo) entfernt werden

# networkctl delete lo # <- Ersetze "lo" durch anderen Namen! </

Dies funktioniert bei systemd in der Version 237 gar nicht

Der vorstehende Befehl macht das, was man über diesen Befehl auch machen könnte

# ip link del lo # <- Ersetze "lo" durch anderen Namen! </

Schnittstelle aktualisieren

Bei Schnittstellen mit dynamischer IP-Konfiguration beispielsweise über DHCP kann man eine Aktualisierung auslösen

# networkctl renew HUB

Dies funktioniert bei systemd in der Version 237 gar nicht

Schnittstelle ändern

Nach Änderung einer .network-Datei werden die Änderungen nicht automatisch übernommen

Man kann das für eine Schnittstelle (hier beispielhaft: HUB) mit diesem Befehl anstoßen

# networkctl reconfigure HUB

Dies funktioniert bei systemd in der Version 237 gar nicht und in der Version 245 nicht immer wie erwartet, beispielsweise kann man über diese Methode nicht zuverlässig eine statisch zugewiesenen IP-Adresse ändern

Alternativ kann man die Software-Schnittstellen löschen und systemd neu starten

Konfiguration erneut laden

Die erneute Auswertung aller (vielleicht geänderter) .netdev- und .network-Dateien kann man mit diesem Befehl erzwingen

# networkctl reload

* Für jede .netdev-Datei ohne dazu passende Schnittstellen wird eine Schnittstelle angelegt

.netdev-Dateien werden ignoriert, wenn es bereits eine passende Schnittstelle gibt
.network-Dateien werden auf alle passenden Schnittstellen angewandt

Dies funktioniert bei systemd in der Version 237 gar nicht und in der Version 245 nicht immer wie erwartet