networkctl

systemd
Documentation Zbigniew Jędrzejewski-Szmek zbyszek@in.waw.pl
networkctl 1
networkctl Query the status of network links
`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`.

## 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.

## See Also

systemd-networkd.service 8, systemd.network 5, systemd.netdev 5