table of contents
- trixie 4.27.0-1
- trixie-backports 4.31.0-1~bpo13+1
- testing 4.31.0-1
- unstable 4.31.0-1
| NETWORKCTL(1) | networkctl | NETWORKCTL(1) |
BEZEICHNUNG¶
networkctl - Den Status der Netzwerkverbindungen abfragen oder verändern
ÜBERSICHT¶
networkctl [OPTIONEN…] BEFEHL [VERBINDUNG…]
BESCHREIBUNG¶
networkctl kann zum Abfragen und Verändern des Zustands von Netzwerkverbindungen, wie sie von systemd-networkd gesehen werden, verwandt werden. Bitte lesen Sie systemd-networkd.service(8) für eine Einführung in die grundlegenden Konzepte, Funktionalitäten und Konfigurationssyntax.
BEFEHLE¶
Die folgenden Befehle werden verstanden:
list [MUSTER…]
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
Hinzugefügt in Version 245.
off
Hinzugefügt in Version 240.
no-carrier
Hinzugefügt in Version 240.
dormant
Hinzugefügt in Version 240.
degraded-carrier
Hinzugefügt in Version 242.
carrier
Hinzugefügt in Version 240.
degraded
Hinzugefügt in Version 240.
enslaved
Hinzugefügt in Version 242.
routable
Hinzugefügt in Version 240.
Der Einrichtungsstatus ist einer der Folgenden:
pending
Hinzugefügt in Version 240.
initialized
Hinzugefügt in Version 251.
configuring
Hinzugefügt in Version 240.
configured
Hinzugefügt in Version 240.
unmanaged
Hinzugefügt in Version 240.
failed
Hinzugefügt in Version 240.
linger
Hinzugefügt in Version 240.
Hinzugefügt in Version 219.
status [MUSTER…]
Wenn keine Verbindungen angegeben wurden, wird ein Gesamtnetzwerkstatus angezeigt. Siehe auch die Option --all.
Erstellt Ausgabe ähnlich 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 hängt der Online-Status von den einzelnen Online-Status aller benötigten Links ab. Standardmäßig werden verwaltete Links für »online« benötigt. In diesem Fall ist der Online-Status einer der folgenden:
unknown
Hinzugefügt in Version 249.
offline
Hinzugefügt in Version 249.
partial
Hinzugefügt in Version 249.
online
Hinzugefügt in Version 249.
Hinzugefügt in Version 219.
dhcp-lease SCHNITTSTELLE [CODE[:FORMAT]] …
When called with the --json= option, the entire DHCP message is shown in JSON format. In that case, any specified option codes are ignored.
By default, each option is displayed in a human-readable format, depending on the option. For example, DNS server addresses are shown as a list of IP addresses (e.g. "192.0.2.1"), and the lease time is shown as a human-readable duration (e.g. "8h").
Each option code may optionally be followed by a formatter, separated by a colon (e.g. "42:address"). This can be useful if the default formatting is not appropriate.
The following formatters are supported:
auto
hex
flag
bool
uint8
uint16
time
string
address
Erstellt Ausgabe ähnlich folgender:
$ networkctl dhcp-lease eth0 Header:
KEY VALUE
Hardware Type: ETHER Hardware Address: 41:42:43:31:32:33
Client Address: 192.0.2.123
Server Address: 192.0.2.1 Options: CODE NAME DATA
1 subnet mask 255.255.255.0
3 router 192.0.2.1
6 domain name server 192.0.2.1
12 hostname test-node
15 domain name lan
28 broadcast address 192.0.2.255
42 NTP server 192.0.2.11
192.0.2.12
51 lease time 1d
53 message type 5
54 server identifier 192.0.2.1
58 renewal time 11h 5min 38s
59 rebinding time 20h 5min 38s
119 domain search hoge.example.com
foo.example.com
Hinzugefügt in Version 261.
lldp [MUSTER…]
Erstellt Ausgabe ähnlich 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.
Hinzugefügt in Version 219.
label
Erstellt Ausgabe ähnlich 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
Hinzugefügt in Version 234.
delete GERÄT…
Hinzugefügt in Version 243.
up GERÄT…
Hinzugefügt in Version 246.
down GERÄT…
Hinzugefügt in Version 246.
renew GERÄT…
Hinzugefügt in Version 244.
forcerenew GERÄT…
Hinzugefügt in Version 246.
reconfigure GERÄT…
Hinzugefügt in Version 244.
reload
Falls eine neue oder veränderte .netdev-Datei gefunden wird, dann wird das entsprechende Netdev erstellt bzw. aktualisiert. Beachten Sie, dass einige Einstellungen nicht angewandt werden könnten, falls die entsprechende Schnittstelle bereits existiert. Z.B. können VLAN-Kennungen nicht nach der Erstellung der Schnittstelle geändert werden, daher wird eine Änderung 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, veränderte oder entfernte .network-Datei gefunden wird, dann werden alle auf die Datei passenden Schnittstellen rekonfiguriert.
Hinzugefügt in Version 244.
edit FILE|@GERÄT…
Falls --drop-in= angegeben ist, wird die Ergänzungsdatei 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 für .link-Dateien und systemd-udevd(8). Beachten Sie, dass die geänderten Link-Einstellungen nach dem Neuladen nicht automatisch angewandt werden. Um dies zu erreichen, lösen Sie Uevents für 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.
Hinzugefügt in Version 254.
cat [DATEI|@GERÄT…]
Hinzugefügt in Version 254.
mask DATEI…
Dieser Befehl berücksichtigt --no-reload auf die gleiche Art wie edit.
Hinzugefügt in Version 256.
unmask DATEI…
Dieser Befehl berücksichtigt --no-reload auf die gleiche Art wie edit und mask.
Hinzugefügt in Version 256.
persistent-storage LOGISCH
Hinzugefügt in Version 256.
OPTIONEN¶
Die folgenden Optionen werden verstanden:
-a --all
Hinzugefügt in Version 219.
-s --stats
Hinzugefügt in Version 243.
-l, --full
Hinzugefügt in Version 245.
-n, --lines=
Hinzugefügt in Version 245.
--drop-in=NAME
Hinzugefügt in Version 254.
--no-reload
Hinzugefügt in Version 254.
--runtime
Hinzugefügt in Version 256.
--stdin
In diesem Modus können mehrere Ergänzungen mit --drop-in= »bearbeitet« werden und die gleichen Inhalte werden in alle von ihnen geschrieben. Andernfalls wird genau eine Hauptkonfigurationsdatei erwartet.
Hinzugefügt in Version 257.
--no-ask-password
--json=MODUS
-h, --help
--version
--no-legend
--no-pager
EXIT-STATUS¶
Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null.
SIEHE AUCH¶
systemd-networkd.service(8), systemd.network(5), systemd.netdev(5), ip(8)
ANMERKUNGEN¶
- 1.
- RFC 3484
ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> 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 die Mailingliste der Übersetzer.
| systemd 261~rc3 |