1NETWORKCTL(1) networkctl NETWORKCTL(1)
2
6 networkctl - Query the status of network links
7
9 networkctl [OPTIONS...] COMMAND [LINK...]
10
12 networkctl may be used to introspect the state of the network links as
13 seen by systemd-networkd. Please refer to systemd-networkd.service(8)
14 for an introduction to the basic concepts, functionality, and
15 configuration syntax.
16
18 The following options are understood:
19 -a --all
21 Show all links with status.
22 -s --stats
24 Show link statistics with status.
25 -h, --help
27 Print a short help text and exit.
28 --version
30 Print a short version string and exit.
31 --no-legend
33 Do not print the legend, i.e. column headers and the footer with
34 hints.
35 --no-pager
37 Do not pipe output into a pager.
38
40 The following commands are understood:
41 list [PATTERN...]
43 Show a list of existing links and their status. If one ore more
44 PATTERNs are specified, only links matching one of them are shown.
45 If no further arguments are specified shows all links, otherwise
46 just the specified links. Produces output similar to:
47 IDX LINK TYPE OPERATIONAL SETUP
49 1 lo loopback carrier unmanaged
50 2 eth0 ether routable configured
51 3 virbr0 ether no-carrier unmanaged
52 4 virbr0-nic ether off unmanaged
53 4 links listed.
55 The operational status is one of the following:
57 off
59 the device is powered down
60 no-carrier
62 the device is powered up, but it does not yet have a carrier
63 dormant
65 the device has a carrier, but is not yet ready for normal
66 traffic
67 degraded-carrier
69 for bond or bridge master, one of the bonding or bridge slave
70 network interfaces is in off, no-carrier, or dormant state
71 carrier
73 the link has a carrier, or for bond or bridge master, all
74 bonding or bridge slave network interfaces are enslaved to the
75 master.
76 degraded
78 the link has carrier and addresses valid on the local link
79 configured
80 enslaved
82 the link has carrier and is enslaved to bond or bridge master
83 network interface
84 routable
86 the link has carrier and routable address configured
87 The setup status is one of the following:
89 pending
91 udev is still processing the link, we don't yet know if we will
92 manage it
93 failed
95 networkd failed to manage the link
96 configuring
98 in the process of retrieving configuration or configuring the
99 link
100 configured
102 link configured successfully
103 unmanaged
105 networkd is not handling the link
106 linger
108 the link is gone, but has not yet been dropped by networkd
109 status [PATTERN...]
112 Show information about the specified links: type, state, kernel
113 module driver, hardware and IP address, configured DNS servers,
114 etc. If one ore more PATTERNs are specified, only links matching
115 one of them are shown.
116 When no links are specified, an overall network status is shown.
118 Also see the option --all.
119 Produces output similar to:
121 ● State: routable
123 Address: 10.193.76.5 on eth0
124 192.168.122.1 on virbr0
125 169.254.190.105 on eth0
126 fe80::5054:aa:bbbb:cccc on eth0
127 Gateway: 10.193.11.1 (CISCO SYSTEMS, INC.) on eth0
128 DNS: 8.8.8.8
129 8.8.4.4
130 lldp [PATTERN...]
132 Show discovered LLDP (Link Layer Discovery Protocol) neighbors. If
133 one or more PATTERNs are specified only neighbors on those
134 interfaces are shown. Otherwise shows discovered neighbors on all
135 interfaces. Note that for this feature to work, LLDP= must be
136 turned on for the specific interface, see systemd.network(5) for
137 details.
138 Produces output similar to:
140 LINK CHASSIS ID SYSTEM NAME CAPS PORT ID PORT DESCRIPTION
142 enp0s25 00:e0:4c:00:00:00 GS1900 ..b........ 2 Port #2
143 Capability Flags:
145 o - Other; p - Repeater; b - Bridge; w - WLAN Access Point; r - Router;
146 t - Telephone; d - DOCSIS cable device; a - Station; c - Customer VLAN;
147 s - Service VLAN, m - Two-port MAC Relay (TPMR)
148 1 neighbors listed.
150 label
152 Show numerical address labels that can be used for address
153 selection. This is the same information that ip-addrlabel(8) shows.
154 See RFC 3484[1] for a discussion of address labels.
155 Produces output similar to:
157 Prefix/Prefixlen Label
159 ::/0 1
160 fc00::/7 5
161 fec0::/10 11
162 2002::/16 2
163 3ffe::/16 12
164 2001:10::/28 7
165 2001::/32 6
166 ::ffff:0.0.0.0/96 4
167 ::/96 3
168 ::1/128 0
169 delete
171 Deletes virtual netdevs. Takes interface name or index number.
172
174 On success, 0 is returned, a non-zero failure code otherwise.
175
177 systemd-networkd.service(8), systemd.network(5), systemd.netdev(5),
178 ip(8)
179
181 1. RFC 3484
182 https://tools.ietf.org/html/rfc3484
183systemd 243 NETWORKCTL(1)