diff options
| author | Lucas Magasweran <lrm@linux.com> | 2021-05-10 10:11:28 +0200 |
|---|---|---|
| committer | Lucas Magasweran <lrm@linux.com> | 2021-05-10 13:40:33 +0200 |
| commit | 2480ca95bac0f1bed350ba8d5aef1ef92be0f8a4 (patch) | |
| tree | b7fbe255e5b14b8257acc890c97a85985133593b /man/systemd.link.xml | |
| parent | network: examples: use wlan for Type instead of wifi (diff) | |
| download | systemd-2480ca95bac0f1bed350ba8d5aef1ef92be0f8a4.tar.xz systemd-2480ca95bac0f1bed350ba8d5aef1ef92be0f8a4.zip | |
man: network: use `networkctl list` instead of `status` to list network interface type
To determine the network interface type for use in the `Type=` directive, it is more concise to use the `list` command. Whereas, the `status` command requires an interface parameter.
For example, on a RaspberryPi 4 the following shows that the `wlan0` interface type `wlan` is more coveniently listed by the `list` command.
```
root@raspberrypi4-64:~# networkctl list
IDX LINK TYPE OPERATIONAL SETUP
1 lo loopback carrier unmanaged
2 eth0 ether routable configured
3 wlan0 wlan off unmanaged
3 links listed.
```
Whereas the `networkctl status` command doesn't include this information.
```
root@raspberrypi4-64:~# networkctl status
● State: routable
Address: 192.168.1.141 on eth0
fd8b:8779:b7a4::f43 on eth0
fd8b:8779:b7a4:0:dea6:32ff:febe:d1ce on eth0
fe80::dea6:32ff:febe:d1ce on eth0
Gateway: 192.168.1.1 (CZ.NIC, z.s.p.o.) on eth0
DNS: 192.168.1.1
May 07 14:17:18 raspberrypi4-64 systemd-networkd[212]: eth0: Gained carrier
May 07 14:17:19 raspberrypi4-64 systemd-networkd[212]: eth0: Gained IPv6LL
May 07 14:17:19 raspberrypi4-64 systemd-networkd[212]: eth0: DHCPv6 address fd8b:8779:b7a4::f43/128 timeout preferred -1 valid -1
May 07 14:17:21 raspberrypi4-64 systemd-networkd[212]: eth0: DHCPv4 address 192.168.1.141/24 via 192.168.1.1
```
To get the interface type using the `status` command you need to specify an additional argument.
```
root@raspberrypi4-64:~# networkctl status wlan0
● 3: wlan0
Link File: /lib/systemd/network/99-default.link
Network File: n/a
Type: wlan
State: off (unmanaged)
Path: platform-fe300000.mmcnr
Driver: brcmfmac
HW Address: dc:a6:32:be:d1:cf (Raspberry Pi Trading Ltd)
MTU: 1500 (min: 68, max: 1500)
QDisc: noop
IPv6 Address Generation Mode: eui64
Queue Length (Tx/Rx): 1/1
```
Diffstat (limited to 'man/systemd.link.xml')
| -rw-r--r-- | man/systemd.link.xml | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 6be115026b..34b56df937 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -133,7 +133,10 @@ <term><varname>Type=</varname></term> <listitem> <para>A whitespace-separated list of shell-style globs matching the device type, as exposed by - <command>networkctl status</command>. If the list is prefixed with a "!", the test is inverted. + <command>networkctl list</command>. If the list is prefixed with a "!", the test is inverted. + Some valid values are <literal>ether</literal>, <literal>loopback</literal>, <literal>wlan</literal>, <literal>wwan</literal>. + Valid types are named either from the udev <literal>DEVTYPE</literal> attribute, or + <literal>ARPHRD_</literal> macros in <filename>linux/if_arp.h</filename>, so this is not comprehensive. </para> </listitem> </varlistentry> |