networkctl 中文手册

译者:金步国


版权声明

本文译者是一位开源理念的坚定支持者,所以本文虽然不是软件,但是遵照开源的精神发布。

其他作品

本文译者十分愿意与他人分享劳动成果,如果你对我的其他翻译作品或者技术文章有兴趣,可以在如下位置查看现有的作品集:

联系方式

由于译者水平有限,因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好),请来信指出,任何提高译文质量的建议我都将虚心接纳。


手册索引 · 指令索引systemd-241

名称

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                                  1
    fc00::/7                                  5
    fec0::/10                                11
    2002::/16                                 2
    3ffe::/16                                12
 2001:10::/28                                 7
    2001::/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)