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 CHASSIS ID SYSTEM NAME CAPS PORT ID PORT DESCRIPTION enp0s25 00:e0:4c:00:00:00 GS1900 ..b........ 2 Port #2 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 neighbors 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 .netdev-Datei gefunden wird, dann wird das entsprechende Netdev erstellt. Beachten Sie, dass systemd-networkd das Netdev nicht aktualisiert oder entfernt, falls ein bestehendes .netdev verandert oder entfernt wird. Falls eine neue, veranderte oder entfernte .network-Datei gefunden wird, dann werden alle Schnittstellen, die auf die Datei passen, neu konfiguriert. 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/ 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) oder >>:link<< 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 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). Hinzugefugt in Version 254. cat DATEI|@GERAT Zeigt Netzwerkkonfigurationsdateien. Dieser Befehl berucksichtigt vorangestellte >>@<< auf die gleiche Art wie edit. Hinzugefugt in Version 254. 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 werden systemd-networkd.service(8) oder systemd-udevd.service(8) nicht nach Abschluss der Bearbeitung neu geladen. Hinzugefugt in Version 254. --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 standardmassig aktivierte JSON-Ausgabe auszuschalten). -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 255 NETWORKCTL(1)