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 DEVICE...
152 Deletes virtual netdevs. Takes interface name or index number.
153 up DEVICE...
155 Bring devices up. Takes interface name or index number.
156 down DEVICE...
158 Bring devices down. Takes interface name or index number.
159 renew DEVICE...
161 Renew dynamic configurations e.g. addresses received from DHCP
162 server. Takes interface name or index number.
163 forcerenew DEVICE...
165 Send a FORCERENEW message to all connected clients, triggering DHCP
166 reconfiguration. Takes interface name or index number.
167 reconfigure DEVICE...
169 Reconfigure network interfaces. Takes interface name or index
170 number. Note that this does not reload .netdev or .network
171 corresponding to the specified interface. So, if you edit config
172 files, it is necessary to call networkctl reload first to apply new
173 settings.
174 reload
176 Reload .netdev and .network files. If a new .netdev file is found,
177 then the corresponding netdev is created. Note that even if an
178 existing .netdev is modified or removed, systemd-networkd does not
179 update or remove the netdev. If a new, modified or removed .network
180 file is found, then all interfaces which match the file are
181 reconfigured.
182
184 The following options are understood:
185 -a --all
187 Show all links with status.
188 -s --stats
190 Show link statistics with status.
191 -l, --full
193 Do not ellipsize the output.
194 -n, --lines=
196 When used with status, controls the number of journal lines to
197 show, counting from the most recent ones. Takes a positive integer
198 argument. Defaults to 10.
199 -h, --help
201 Print a short help text and exit.
202 --version
204 Print a short version string and exit.
205 --no-legend
207 Do not print the legend, i.e. column headers and the footer with
208 hints.
209 --no-pager
211 Do not pipe output into a pager.
212
214 On success, 0 is returned, a non-zero failure code otherwise.
215
217 systemd-networkd.service(8), systemd.network(5), systemd.netdev(5),
218 ip(8)
219
221 1. RFC 3484
222 https://tools.ietf.org/html/rfc3484
223systemd 248 NETWORKCTL(1)