networkctl 中文手册

优质

小牛编辑

128浏览

2023-12-01

名称

networkctl — 查询网络连接的状态

大纲

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

描述

networkctl用于查询systemd-networkd 所看到的网络连接的状态。参见systemd-networkd.service(8)以了解相关概念、功能、配置语法。

选项

能够识别的命令行选项如下：

-a --all: 显示所有连接的状态(status)
-h, --help: 显示简短的帮助信息并退出。
--version: 显示简短的版本信息并退出。
--no-legend: 不输出列标题，也就是不在输出列表的头部和尾部显示字段的名称。
--no-pager: 不将程序的输出内容管道(pipe)给分页程序。

命令

能够识别的命令如下：

list [LINK…]

列出存在的连接及其状态。若未指定连接(LINK)则显示所有连接，否则仅显示指定的连接。一个典型的输出类似下面这样：

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.

OPERATIONAL(操作)状态可以是如下之一：

off: 该设备已被断电关闭
no-carrier: 设备已通电开启，但是尚无网络载波(光电信号)
dormant: 设备上已有网络载波(光电信号)，但是尚未准备好进行网络传输(收发数据包)
carrier: 连接已具备收发数据包的能力
degraded: 连接已具备收发数据包的能力，并且已经配置了有效地址
routable: 连接已具备收发数据包的能力，并且已经配置了可路由地址

SETUP(安装)状态可以是如下之一：

pending: udev 正在处理此连接，目前尚不确定是否可以管理此连接。
failed: networkd 管理此连接失败
configuring: 正在配置此连接的过程中
configured: 连接已被配置成功
unmanaged: 此连接不受 networkd 管理(可能由发行版专用的方式管理)
linger: 连接已经不存在，但是(配置信息)尚未被 networkd 丢弃。

status [LINK…]

显示连接的各种信息：类型、状态、内核模块、MAC地址、IP地址、DNS服务器，等等。

若未指定连接(LINK)则显示网络状态概览，否则仅显示指定连接的详细信息。参见 --all 选项。

一个典型的输出类似下面这样：

●      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 [LINK…]

显示已发现的 LLDP (Link Layer Discovery Protocol) 邻居。若未指定连接(LINK)则显示所有连接上发现的邻居，否则仅显示指定连接上发现的邻居。注意，此命令仅在指定的连接(LINK)已经启用了 LLDP= 特性的情况下才有意义。参见 systemd.network(5) 以了解详情。

一个典型的输出类似下面这样：

LINK             CHASSIS ID        SYSTEM NAME      CAPS        PORT ID           PORT DESCRIPTION
enp0s25          00:e0:4c:00:00:00 GS1900           ..b........ 2                 Port #2

Capability Flags:
o - Other; p - Repeater;  b - Bridge; w - WLAN Access Point; r - Router;
t - Telephone; d - DOCSIS cable device; a - Station; c - Customer VLAN;
s - Service VLAN, m - Two-port MAC Relay (TPMR)

1 neighbors listed.

label

显示以数字形式表示的地址标签，可用于地址选择。该命令显示的内容与 ip-addrlabel(8) 相同。详见 RFC 3484 以了解更多与"地址标签"相关的讨论。

一个典型的输出类似下面这样：

Prefix/Prefixlen                          Label  ::/0                                  1fc00::/7                                  5fec0::/10                                112002::/16                                 23ffe::/16                                12
 2001:10::/28                                 72001::/32                                 6
::ffff:0.0.0.0/96                             4  ::/96                                 3 ::1/128                                0

退出状态

返回值为 0 表示成功，非零返回值表示失败代码。

参见

systemd-networkd.service(8),systemd.network(5),systemd.netdev(5),ip(8)