NETWORKCTL(1) networkctl NETWORKCTL(1) BEZEICHNUNG networkctl - Den Status der Netzwerkverbindungen abfragen oder verandern UBERSICHT networkctl [OPTIONEN] BEFEHL [VERBINDUNG] BESCHREIBUNG networkctl kann zum Abfragen und Verandern des Zustands von Netzwerkverbindungen, wie sie von systemd-networkd gesehen werden, verwandt werden. Bitte lesen Sie systemd-networkd.service(8) fur eine Einfuhrung in die grundlegenden Konzepte, Funktionalitaten und Konfigurationssyntax. BEFEHLE Die folgenden Befehle werden verstanden: list [MUSTER] Zeigt eine Liste der existierenden Verbindungen und ihren Status. Falls eine oder mehrere MUSTER angegeben sind, werden nur die Links, die darauf passen, angezeigt. Falls keine weiteren Argumente angegeben sind, werden alle Verbindungen angezeigt, andernfalls nur die angegebenen Verbindungen. Erstellt Ausgabe ahnlich folgender: IDX LINK TYPE OPERATIONAL SETUP 1 lo loopback carrier unmanaged 2 eth0 ether routable configured 3 virbr0 ether no-carrier unmanaged 4 virbr0-nic ether off unmanaged 4 links listed. Der Betriebsstatus ist einer der Folgenden: missing Das Gerat fehlt. Hinzugefugt in Version 245. off Das Gerat ist ausgeschaltet. Hinzugefugt in Version 240. no-carrier Das Gerat ist eingeschaltet, hat aber noch kein Signal (Trager). Hinzugefugt in Version 240. dormant Das Gerat hat ein Signal, ist aber noch nicht fur normalen Verkehr bereit. Hinzugefugt in Version 240. degraded-carrier Einer der gebundelten oder Bridge-Slave-Netzwerkschnittstellen ist ausgeschaltet, hat kein Signal oder ist in einem ruhendem Zustand und die Master-Schnittstelle hat keine Adresse. Hinzugefugt in Version 242. carrier Der Link hat ein Signal oder fur Master bei Bundelungen oder Bridges, alle gebundelten oder Bridge-Slave-Netzwerkschnittstellen sind an dem Master angebunden. Hinzugefugt in Version 240. degraded Der Link hat ein Signal und eine auf dem konfigurierten lokalen Link gultige Adresse. Fur gebundene oder Bridge-Master bedeutet dies, dass nicht alle Slave-Netzwerkschnittstellen uber ein Signal verfugen, aber mindestens eine. Hinzugefugt in Version 240. enslaved Der Link hat ein Signal und ist an eine Bundelung oder Bridge-Master-Netzwerkschnittstelle angebunden. Hinzugefugt in Version 242. routable Der Link hat ein Signal und eine weiterleitbare Adresse. Fur Master bei Bundelungen oder Bridges ist es nicht notwendig, dass alle Slave-Netzwerkschnittstellen uber ein Signal verfugen, aber mindestens eine muss. Hinzugefugt in Version 240. Der Einrichtungsstatus ist einer der Folgenden: pending systemd-udevd(8) bearbeitet den Link noch, es ist noch nicht klar, ob es den Link verwalten wird. Hinzugefugt in Version 240. initialized systemd-udevd(8) hat den Link verarbeitet, aber es ist noch nicht klar, ob es den Link verwalten wird. Hinzugefugt in Version 251. configuring Die Konfigurations fur den Link wird abgerufen oder der Link wird konfiguriert. Hinzugefugt in Version 240. configured Link wurde erfolgreich konfiguriert. Hinzugefugt in Version 240. unmanaged systemd-networkd(8) handhabt den Link nicht. Hinzugefugt in Version 240. failed systemd-networkd(8) konnten den Link nicht konfigurieren. Hinzugefugt in Version 240. linger Der Link ist verschwunden, wurde aber von systemd-networkd(8) noch nicht freigegeben. Hinzugefugt in Version 240. Hinzugefugt in Version 219. status [MUSTER] Zeigt Informationen uber die angegebenen Verbindungen: Typ, Status, Kernelmodultreiber, Hardware- und IP-Adresse, konfigurierte DNS-Server usw. Falls eine oder mehrere MUSTER angegeben sind, werden nur die Links, die darauf passen, angezeigt. Wenn keine Verbindungen angegeben wurden, wird ein Gesamtnetzwerkstatus angezeigt. Siehe auch die Option --all. Erstellt Ausgabe ahnlich folgender: State: routable Online state: online Address: 10.193.76.5 on eth0 192.168.122.1 on virbr0 169.254.190.105 on eth0 fe80::5054:aa:bbbb:cccc on eth0 Gateway: 10.193.11.1 (CISCO SYSTEMS, INC.) on eth0 DNS: 8.8.8.8 8.8.4.4 Im Gesamtnetzwerkstatus hangt der Online-Status von den einzelnen Online-Status aller benotigten Links ab. Standardmassig werden verwaltete Links fur >>online<< benotigt. In diesem Fall ist der Online-Status einer der folgenden: unknown Alle Links haben einen unbekannten Online-Status (d.h. es gibt keine benotigten Links). Hinzugefugt in Version 249. offline Alle benotigten Links sind offline. Hinzugefugt in Version 249. partial Einige, aber nicht alle, benotigten Links sind online. Hinzugefugt in Version 249. online Alle benotigten Links sind online. Hinzugefugt in Version 249. Hinzugefugt in Version 219. lldp [MUSTER] Zeigt entdeckte LLDP- (Link Layer Discovery Protocol)Nachbarn. Falls ein oder mehrere MUSTER angegeben sind, werden nur die Nachbarn auf diesen Schnittstellen angezeigt. Andernfalls werden die Nachbarn auf allen Schnittstellen angezeigt. Beachten Sie, dass LLDP= auf der angegebenen Schnittstelle eingeschaltet sein muss, damit diese funktioniert, siehe systemd.network(5) fur Details. Erstellt Ausgabe ahnlich folgender: LINK SYSTEM-NAME SYSTEM-DESCRIPTION CHASSIS-ID PORT-ID PORT-DESCRIPTION CAPS enp0s25 GS1900 - 00:e0:4c:00:00:00 2 Port #2 ..b........ Capability Flags: o - Other; p - Repeater; b - Bridge; w - WLAN Access Point; r - Router; t - Telephone; d - DOCSIS cable device; a - Station; c - Customer VLAN; s - Service VLAN, m - Two-port MAC Relay (TPMR) 1 neighbor(s) listed. Hinzugefugt in Version 219. label Zeigt numerische Adresskennzeichnungen, die zur Adressauswahl verwandt werden konnen. Dies ist die gleiche Information, die ip-addrlabel(8) zeigt. Siehe RFC 3484[1] fur eine Diskussion von Adresskennzeichnungen. Erstellt Ausgabe ahnlich folgender: Prefix/Prefixlen Label ::/0 1 fc00::/7 5 fec0::/10 11 2002::/16 2 3ffe::/16 12 2001:10::/28 7 2001::/32 6 ::ffff:0.0.0.0/96 4 ::/96 3 ::1/128 0 Hinzugefugt in Version 234. delete GERAT Loscht virtuelle Netdevs. Akzeptiert Schnittstellennamen oder Indexnummer. Hinzugefugt in Version 243. up GERAT Aktiviert Gerate. Akzeptiert Schnittstellennamen oder Indexnummer. Hinzugefugt in Version 246. down GERAT Deaktiviert Gerate. Akzeptiert Schnittstellennamen oder Indexnummer. Hinzugefugt in Version 246. renew GERAT Erneuert dynamische Konfigurationen, z.B. vom DHCP-Server empfangene Adressen. Akzeptiert Schnittstellennamen oder Indexnummer. Hinzugefugt in Version 244. forcerenew GERAT Sendet FORCERENEW-Nachrichten an alle verbundenen Clients, lost DHCP-Rekonfiguration aus. Akzeptiert Schnittstellennamen oder Indexnummer. Hinzugefugt in Version 246. reconfigure GERAT Konfiguriert Netzwerkschnittstellen neu. Akzeptiert einen Schnittstellennamen oder eine Index-Nummer. Beachten Sie, dass dies nicht die der angegebenen Schnittstelle entsprechenden >>.netdev<< oder >>.network<< neu ladt. Falls Sie daher diese Konfigurationsdateien bearbeiten, ist es notwendig, zuerst networkctl reload aufzurufen, um die neuen Einstellungen anzuwenden. Hinzugefugt in Version 244. reload Ladt .netdev- und .network-Dateien neu. Falls eine neue oder veranderte .netdev-Datei gefunden wird, dann wird das entsprechende Netdev erstellt bzw. aktualisiert. Beachten Sie, dass einige Einstellungen nicht angewandt werden konnten, falls die entsprechende Schnittstelle bereits existiert. Z.B. konnen VLAN-Kennungen nicht nach der Erstellung der Schnittstelle geandert werden, daher wird eine Anderung der [VLAN] Id= nicht wirksam werden, falls die entsprechende VLAN-Schnittstelle bereits existiert. Um solche Einstellungen anzuwenden, muss die Schnittstelle vor dem Neuladen manuell entfernt werden. Beachten Sie auch, dass systemd-networkd(8) das der Datei entsprechende bestehende Netdev nicht entfernt, selbst wenn eine .netdev-Datei entfernt wird. Falls eine neue, veranderte oder entfernte .network-Datei gefunden wird, dann werden alle auf die Datei passenden Schnittstellen rekonfiguriert. Hinzugefugt in Version 244. edit FILE|@GERAT Bearbeitet Netzwerkkonfigurationsdateien, einschliesslich .network-, .netdev- und .link-Dateien. Falls keine Netzwerkkonfigurationsdatei gefunden wird, die auf den angegebenen Namen passt, wird eine neue unter /etc/ oder /run/, abhangig von der Angabe von --runtime, erstellt. Falls insbesondere dem Namen >>@<< vorangestellt wird, wird diese als Netzwerkschnittstelle behandelt und das Bearbeiten wird auf den ihr zugeordneten Netzwerkkonfigurationsdateien erfolgen. Zusatzlich kann dem Schnittstellennamen >>:network<< (die Vorgabe), >>:link<< oder >>:netdev<< angehangt werden, um den Typ der Netzwerkkonfiguration auszuwahlen, auf dem gearbeitet werden soll. Falls --drop-in= angegeben ist, wird die Erganzungsdatei anstelle der Hauptkonfigurationsdatei bearbeitet. Sofern --no-reload nicht angegeben ist, wird systemd-networkd(8) nach Abschluss der Bearbeitung der .network- oder .netdev-Dateien neu geladen. Das gleiche gilt fur .link-Dateien und systemd-udevd(8). Beachten Sie, dass die geanderten Link-Einstellungen nach dem Neuladen nicht automatisch angewandt werden. Um dies zu erreichen, losen Sie Uevents fur die entsprechende Schnittstelle aus. Weitere Informationen finden Sie in systemd.link(5). Falls --stdin angegeben ist, wird der neue Inhalt von der Standardeingabe gelesen. In diese Modus wird der alte Inhalt der Datei verworfen. Hinzugefugt in Version 254. cat [DATEI|@GERAT] Zeigt Netzwerkkonfigurationsdateien. Dieser Befehl berucksichtigt vorangestellte >>@<< auf eine ahnliche Art wie edit. Dabei wird zusatzlich das Anhangen von >>:all<< zur gesamten Anzeige aller Typen von Konfigurationsdateien, die der Schnittstelle zugeordnet sind, unterstutzt. Falls kein Argument angegeben ist, werden networkd.conf(5) und seine Erganzungsdateien angezeigt. Hinzugefugt in Version 254. mask DATEI Maskiert Netzwerkkonfigurationsdateien, dazu gehoren Dateien .network, .netdev und .link. Ein Symlink des angegebenen Namens wird unter /etc/ oder /run/ erstellt, der auf /dev/null zeigt, abhangig davon, ob --runtime angegeben ist. Falls eine nicht leere Konfigurationsdatei mit dem angegebenen Namen unter dem Zielverzeichnis oder einem Verzeichnis mit hoherer Prioritat existiert (z.B. wird --runtime verwandt, wahrend eine bestehende Konfiguration in /etc/ liegt), wird die Aktion abgebrochen. Dieser Befehl berucksichtigt --no-reload auf die gleiche Art wie edit. Hinzugefugt in Version 256. unmask DATEI Entmaskiert Netzwerkkonfigurationsdateien, d.h. macht die Auswirkung von mask ruckgangig. Beachten Sie, dass dieser Befehl unabhangig vom Geltungsbereich des Verzeichnisses agiert, d.h. --runtime hat keine Auswirkungen. Dieser Befehl berucksichtigt --no-reload auf die gleiche Art wie edit und mask. Hinzugefugt in Version 256. persistent-storage LOGISCH Benachrichtigt systemd-networkd.service(8), dass der dauerhafte Speicher fur den Dienst bereit ist. Dies wird von systemd-networkd-persistent-storage.service aufgerufen. Normalerweise sollte dieser Befehl von Benutzer oder Administratoren nicht manuell aufgerufen werden. Hinzugefugt in Version 256. OPTIONEN Die folgenden Optionen werden verstanden: -a --all Zeigt mit status alle Verbindungen. Hinzugefugt in Version 219. -s --stats Zeigt mit status Link-Statistiken. Hinzugefugt in Version 243. -l, --full Verkurzt die Ausgabe nicht. Hinzugefugt in Version 245. -n, --lines= Steuert bei der Verwendung mit status die Anzahl der anzuzeigenden Journal-Eintrage, gezahlt vom neusten. Akzeptiert eine positive Ganzzahl als Argument. Standardmassig 10. Hinzugefugt in Version 245. --drop-in=NAME Bearbeitet bei der Verwendung mit edit die Erganzungsdatei NAME anstelle der Hauptkonfigurationsdatei. Hinzugefugt in Version 254. --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. Hinzugefugt in Version 254. --runtime Bei der Verwendung mit edit oder mask wird auf Dateien unterhalb von /run/ anstelle von /etc/ agiert. Hinzugefugt in Version 256. --stdin Bei der Verwendung mit edit werden die Inhalte der Datei von der Standardeingabe gelesen und der Editor wird nicht gestartet. In diesem Modus werden die alten Inhalte der Datei automatisch ersetzt. Dies ist nutzlich, um die Konfiguration von Skripten heraus aus zu >>bearbeiten<<, insbesondere so, dass Erganzungsverzeichnisse in einem Durchlauf erstellt und befullt werden. In diesem Modus konnen mehrere Erganzungen mit --drop-in= >>bearbeitet<< werden und die gleichen Inhalte werden in alle von ihnen geschrieben. Andernfalls wird genau eine Hauptkonfigurationsdatei erwartet. Hinzugefugt in Version 257. --no-ask-password Befragt den Benutzer nicht fur Authentifizierung fur privilegierte Aktionen. --json=MODUS Zeigt die Ausgabe als JSON formatiert. Erwartet entweder >>short<< (fur die kurzest mogliche Ausgabe ohne unnotigen Leerraum oder Zeilenumbruche), >>pretty<< (fur eine schonere Version der gleichen Ausgabe, mit Einzugen und Zeilenumbruchen) 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 Spaltenkopfe und die Fusszeile mit Hinweisen. --no-pager Leitet die Ausgabe nicht an ein Textanzeigeprogramm weiter. EXIT-STATUS Bei Erfolg wird 0 zuruckgegeben, anderenfalls ein Fehlercode ungleich Null. SIEHE AUCH systemd-networkd.service(8), systemd.network(5), systemd.netdev(5), ip(8) ANMERKUNGEN 1. RFC 3484 https://tools.ietf.org/html/rfc3484 UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . systemd 260.2 NETWORKCTL(1)