networkctl

Name

networkctl — Query the status of network links

Synopsis

networkctl [OPTIONS...] COMMAND [LINK...]

Description¶

networkctl may be used to introspect the state of the network links as seen by systemd-networkd. Please refer to systemd-networkd.service(8) for an introduction to the the basic concepts, functionality, and configuration syntax.

Options¶

The following options are understood:

-a --all ¶: Show all links with status.
-h, --help¶: Print a short help text and exit.
--version¶: Print a short version string and exit.
--no-pager¶: Do not pipe output into a pager.

Commands¶

The following commands are understood:

list ¶

Show a list of existing links and their status. Produces output similar to

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.

status [LINK...] ¶

Show information about the specified links: type, state, kernel module driver, hardware and IP address, configured DNS servers, etc.

When no links are specified, routable links are shown. See also option --all.

Produces output similar to

●      State: routable
     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

lldp ¶

Show LLDP (Link Layer Discovery Protocol) status.

Exit status¶

On success, 0 is returned, a non-zero failure code otherwise.