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 commands are understood:
19 list [PATTERN...]
21 Show a list of existing links and their status. If one ore more
22 PATTERNs are specified, only links matching one of them are shown.
23 If no further arguments are specified shows all links, otherwise
24 just the specified links. Produces output similar to:
25 IDX LINK TYPE OPERATIONAL SETUP
27 1 lo loopback carrier unmanaged
28 2 eth0 ether routable configured
29 3 virbr0 ether no-carrier unmanaged
30 4 virbr0-nic ether off unmanaged
31 4 links listed.
33 The operational status is one of the following:
35 missing
37 the device is missing
38 off
40 the device is powered down
41 no-carrier
43 the device is powered up, but it does not yet have a carrier
44 dormant
46 the device has a carrier, but is not yet ready for normal
47 traffic
48 degraded-carrier
50 for bond or bridge master, one of the bonding or bridge slave
51 network interfaces is in off, no-carrier, or dormant state
52 carrier
54 the link has a carrier, or for bond or bridge master, all
55 bonding or bridge slave network interfaces are enslaved to the
56 master.
57 degraded
59 the link has carrier and addresses valid on the local link
60 configured
61 enslaved
63 the link has carrier and is enslaved to bond or bridge master
64 network interface
65 routable
67 the link has carrier and routable address configured
68 The setup status is one of the following:
70 pending
72 udev is still processing the link, we don't yet know if we will
73 manage it
74 failed
76 networkd failed to manage the link
77 configuring
79 in the process of retrieving configuration or configuring the
80 link
81 configured
83 link configured successfully
84 unmanaged
86 networkd is not handling the link
87 linger
89 the link is gone, but has not yet been dropped by networkd
90 status [PATTERN...]
93 Show information about the specified links: type, state, kernel
94 module driver, hardware and IP address, configured DNS servers,
95 etc. If one ore more PATTERNs are specified, only links matching
96 one of them are shown.
97 When no links are specified, an overall network status is shown.
99 Also see the option --all.
100 Produces output similar to:
102 ● State: routable
104 Address: 10.193.76.5 on eth0
105 192.168.122.1 on virbr0
106 169.254.190.105 on eth0
107 fe80::5054:aa:bbbb:cccc on eth0
108 Gateway: 10.193.11.1 (CISCO SYSTEMS, INC.) on eth0
109 DNS: 8.8.8.8
110 8.8.4.4
111 lldp [PATTERN...]
113 Show discovered LLDP (Link Layer Discovery Protocol) neighbors. If
114 one or more PATTERNs are specified only neighbors on those
115 interfaces are shown. Otherwise shows discovered neighbors on all
116 interfaces. Note that for this feature to work, LLDP= must be
117 turned on for the specific interface, see systemd.network(5) for
118 details.
119 Produces output similar to:
121 LINK CHASSIS ID SYSTEM NAME CAPS PORT ID PORT DESCRIPTION
123 enp0s25 00:e0:4c:00:00:00 GS1900 ..b........ 2 Port #2
124 Capability Flags:
126 o - Other; p - Repeater; b - Bridge; w - WLAN Access Point; r - Router;
127 t - Telephone; d - DOCSIS cable device; a - Station; c - Customer VLAN;
128 s - Service VLAN, m - Two-port MAC Relay (TPMR)
129 1 neighbors listed.
131 label
133 Show numerical address labels that can be used for address
134 selection. This is the same information that ip-addrlabel(8) shows.
135 See RFC 3484[1] for a discussion of address labels.
136 Produces output similar to:
138 Prefix/Prefixlen Label
140 ::/0 1
141 fc00::/7 5
142 fec0::/10 11
143 2002::/16 2
144 3ffe::/16 12
145 2001:10::/28 7
146 2001::/32 6
147 ::ffff:0.0.0.0/96 4
148 ::/96 3
149 ::1/128 0
150 delete
152 Deletes virtual netdevs. Takes interface name or index number.
153 renew
155 Renew dynamic configurations e.g. addresses received from DHCP
156 server. Takes interface name or index number.
157 reconfigure
159 Reconfigure network interfaces. Takes interface name or index
160 number.
161 reload
163 Reload .netdev and .network files. If a new .netdev file is found,
164 then the corresponding netdev is created. Note that even if an
165 existing .netdev is modified or removed, systemd-networkd does not
166 update or remove the netdev. If a new, modified or removed .network
167 file is found, then all interfaces which match the file are
168 reconfigured.
169
171 The following options are understood:
172 -a --all
174 Show all links with status.
175 -s --stats
177 Show link statistics with status.
178 -l, --full
180 Do not ellipsize the output.
181 -n, --lines=
183 When used with status, controls the number of journal lines to
184 show, counting from the most recent ones. Takes a positive integer
185 argument. Defaults to 10.
186 -h, --help
188 Print a short help text and exit.
189 --version
191 Print a short version string and exit.
192 --no-legend
194 Do not print the legend, i.e. column headers and the footer with
195 hints.
196 --no-pager
198 Do not pipe output into a pager.
199
201 On success, 0 is returned, a non-zero failure code otherwise.
202
204 systemd-networkd.service(8), systemd.network(5), systemd.netdev(5),
205 ip(8)
206
208 1. RFC 3484
209 https://tools.ietf.org/html/rfc3484
210systemd 245 NETWORKCTL(1)