目  录

1 系统维护与调试命令

1.1 系统维护命令

1.1.1 ping

1.1.2 ping ipv6

1.1.3 tracert

1.1.4 tracert ipv6

1.2 系统调试命令

1.2.1 debugging

1.2.2 display debugging

1 系统维护与调试命令

1.1  系统维护命令

1.1.1  ping

【命令】

ping [ ip ] [ -a source-ip | -c count | -f | -h ttl | -i interface-type interface-number | -m interval | -n | -p pad | -q | -r | -s packet-size | -t timeout | -tos tos | -v | -vpn-instance vpn-instance-name ] * host

【视图】

任意视图

【缺省级别】

0：访问级

【参数】

ip：如果ping的目的主机名为i、ip、ipv、ipv6、l、ls、lsp时，需要先指定该关键字再指定主机名，如：ping ip ip。

-a source-ip：指定ICMP回显请求（ECHO-REQUEST）报文的源IP地址。该地址必须是设备上已配置的IP地址。不指定该参数时，ICMP回显请求报文的源IP地址是该报文出接口的主IP地址。

-c count：指定ICMP回显请求报文的发送次数，取值范围为1～4294967295，缺省值为5。

-f：将长度大于接口MTU的报文直接丢弃，即不允许对发送的ICMP回显请求报文进行分片。

-h ttl：指定ICMP回显请求报文中的TTL值，取值范围为1～255，缺省值为255。

-i interface-type interface-number：指定发送ICMP回显请求报文的接口的类型和编号。不指定该参数时，将根据目的IP查找路由表或者转发表来确定发送ICMP回显请求报文的接口。

-m interval：指定发送ICMP回显请求报文的时间间隔，取值范围为1～65535，单位为毫秒，缺省值为200毫秒。

·     如果在timeout时间内收到目的主机的响应报文，则下次ICMP回显请求报文的发送时间间隔为报文的实际响应时间与interval之和；

·     如果在timeout时间内没有收到目的主机的响应报文，则下次ICMP回显请求报文的发送时间间隔为timeout与interval之和。

-n：对host参数不进行域名解析。不指定该参数时，如果host参数表示的是目的端的主机名，则设备会对host进行域名解析。

-p pad：指定ICMP回显请求报文的“PAD”字段的填充值，为1～8位的16进制数，取值范围为0～ffffffff。如果指定的参数不够8位，则会在首部补0，使填充值达到8位。比如将pad设置为0x2f，则会重复使用0x0000002f去填充报文，以使发送报文的总长度达到设备要求值。缺省情况下，填充值从0x01开始，逐渐递增，直到0xff，然后又从0x01开始循环，形如0x010203……feff01……，直至发送报文的总长度达到设备要求值。

-q：只显示统计信息。不指定该参数时，系统将显示包括统计信息在内的全部信息。

-r：记录路由信息。不指定该参数时，系统不记录路由。

-s packet-size：指定发送的ICMP回显请求报文的长度（不包括IP和ICMP报文头），取值范围为20～8100，单位为字节，缺省值为56字节。

-t timeout：指定ICMP回显应答（ECHO-REPLY）报文的超时时间，发送ICMP回显请求报文timeout后还没有收到ICMP回显应答报文，源端则认为ICMP回显应答报文超时。取值范围为0～65535，单位为毫秒，缺省值为2000毫秒。

-tos tos：指定ICMP回显请求报文中的ToS（Type of Service，服务类型）域的值，取值范围为0～255，缺省值为0。

-v：显示接收到的非回显应答的ICMP报文。不指定该参数时，系统不显示非回显应答的ICMP报文。

-vpn-instance vpn-instance-name：指定目的端所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示目的端位于公网中。需要注意的是，仅S5500-EI系列交换机支持该参数。

host：目的端的IP地址或主机名，主机名为1～255个字符的字符串。

【描述】

ping命令用来检查指定目的端是否可达，并输出相应的统计信息。

执行ping命令后，源端给目的端发送ICMP回显请求报文：

·     如果该目的端的名称不可识别，则输出提示信息“Error:  Ping: Unknown host host-name”。

·     如果在超时时间内收到目的端的ICMP回显响应报文，则输出响应报文的相关信息。

·     如果在超时时间内没有收到目的端的ICMP回显响应报文，则输出“Request time out”提示用户。

·     如果要使用目的端的主机名执行ping操作，事先必须在设备上配置DNS（Domain Name System，域名系统）功能，否则会ping失败。而且当目的端的名称是ping命令的关键字（如ip）时，命令形式应该是ping ip ip，而不能直接输入ping ip。

在执行命令过程中，键入<Ctrl+C>可终止ping操作。

【举例】

# 检查IP地址为1.1.2.2的设备是否可达。

<Sysname> ping 1.1.2.2

  PING 1.1.2.2: 56  data bytes, press CTRL_C to break

    Reply from 1.1.2.2: bytes=56 Sequence=1 ttl=254 time=205 ms

    Reply from 1.1.2.2: bytes=56 Sequence=2 ttl=254 time=1 ms

    Reply from 1.1.2.2: bytes=56 Sequence=3 ttl=254 time=1 ms

    Reply from 1.1.2.2: bytes=56 Sequence=4 ttl=254 time=1 ms

    Reply from 1.1.2.2: bytes=56 Sequence=5 ttl=254 time=1 ms

  --- 1.1.2.2 ping statistics ---

    5 packet(s) transmitted

    5 packet(s) received

    0.00% packet loss

    round-trip min/avg/max = 1/41/205 ms

以上信息表明，目的端可达，源端发出的ICMP回显请求报文均能得到回应，报文往返的最短时间、平均时间和最长时间分别为1ms、41ms和205ms。

# 检查私网vpn1中IP地址为1.1.2.2的设备是否可达。

<Sysname> ping -vpn-instance vpn1 1.1.2.2

  PING 1.1.2.2: 56  data bytes, press CTRL_C to break

    Reply from 1.1.2.2: bytes=56 Sequence=1 ttl=254 time=205 ms

    Reply from 1.1.2.2: bytes=56 Sequence=2 ttl=254 time=1 ms

    Reply from 1.1.2.2: bytes=56 Sequence=3 ttl=254 time=1 ms

    Reply from 1.1.2.2: bytes=56 Sequence=4 ttl=254 time=1 ms

    Reply from 1.1.2.2: bytes=56 Sequence=5 ttl=254 time=1 ms

  --- 1.1.2.2 ping statistics ---

    5 packet(s) transmitted

    5 packet(s) received

    0.00% packet loss

    round-trip min/avg/max = 1/41/205 ms

以上信息表明，私网vpn1中目的端可达，源端发出的ICMP回显请求报文均能得到回应，报文往返的最短时间、平均时间和最长时间分别为1ms、41ms和205ms。

# 检查IP地址为1.1.2.2的设备是否可达，只显示检查结果。

<Sysname> ping -q 1.1.2.2

  PING 1.1.2.2: 56  data bytes, press CTRL_C to break

  --- 1.1.2.2 ping statistics ---

    5 packet(s) transmitted

    4 packet(s) received

    20.00% packet loss

    round-trip min/avg/max = 1/12/29 ms

# 检查IP地址为1.1.2.2的设备是否可达，并显示路由信息。

<Sysname> ping -r 1.1.2.2

  PING 1.1.2.2: 56  data bytes, press CTRL_C to break

    Reply from 1.1.2.2: bytes=56 Sequence=1 ttl=254 time=53 ms

      Record Route:

         1.1.2.1

         1.1.2.2

         1.1.1.2

         1.1.1.1

    Reply from 1.1.2.2: bytes=56 Sequence=2 ttl=254 time=1 ms

      Record Route:

         1.1.2.1

         1.1.2.2

         1.1.1.2

         1.1.1.1

    Reply from 1.1.2.2: bytes=56 Sequence=3 ttl=254 time=1 ms

      Record Route:

         1.1.2.1

         1.1.2.2

         1.1.1.2

         1.1.1.1

    Reply from 1.1.2.2: bytes=56 Sequence=4 ttl=254 time=1 ms

      Record Route:

         1.1.2.1

         1.1.2.2

         1.1.1.2

         1.1.1.1

    Reply from 1.1.2.2: bytes=56 Sequence=5 ttl=254 time=1 ms

      Record Route:

         1.1.2.1

         1.1.2.2

         1.1.1.2

         1.1.1.1

  --- 1.1.2.2 ping statistics ---

    5 packet(s) transmitted

    5 packet(s) received

    0.00% packet loss

    round-trip min/avg/max = 1/11/53 ms

以上显示信息表明本设备与1.1.2.2之间路由可达，具体路由为1.1.1.1 <-> {1.1.1.2; 1.1.2.1} <-> 1.1.2.2。

表1-1 ping命令显示信息描述表

1.1.2  ping ipv6

【命令】

ping ipv6 [ -a source-ipv6 | -c count | -m interval | -s packet-size | -t timeout | -tos tos | -vpn-instance vpn-instance-name ] * host [ -i interface-type interface-number ]

【视图】

任意视图

【缺省级别】

0：访问级

【参数】

-a source-ipv6：指定ICMP回显请求报文中的源IPv6地址。该地址必须是设备上已配置的合法IPv6地址。不指定该参数时，ICMP回显请求报文的源IPv6地址是该报文出接口的地址（地址选择原则遵循RFC 3484）。

-c count：指定发送的ICMPv6回显请求报文的数目，取值范围为1～4294967295，缺省值为5。

-m interval：指定发送ICMPv6回显请求报文的时间间隔，取值范围为1～65535，单位为毫秒，缺省值为200毫秒。

·     如果在timeout时间内收到目的主机的响应报文，则下次ICMP回显请求报文的发送时间间隔为报文的实际响应时间与interval之和；

·     如果在timeout时间内没有收到目的主机的响应报文，则下次ICMP回显请求报文的发送时间间隔为timeout与interval之和。

-s packet-size：指定发送的ICMPv6回显请求报文的长度，取值范围为20～8100，单位为字节，缺省值为56字节。

-t timeout：指定ICMPv6回显应答报文的超时时间，取值范围为0～65535，单位为毫秒，缺省值为2000毫秒。

-tos tos：指定ICMP回显请求报文中的ToS（Type of Service，服务类型）域的值。取值范围为0～255，缺省值为0。

host：目的端的IPv6地址或主机名，为1～255个字符的字符串。

-i interface-type interface-number：指定出接口的接口类型与接口编号。此参数只用于目的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“三层技术-IP业务配置指导”中的“IPv6基础”）。不指定该参数时，将根据目的IP查找路由表或者转发表来确定发送ICMP回显请求报文的接口。

-vpn-instance vpn-instance-name：指定目的端所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示目的端位于公网中。需要注意的是，仅S5500-EI系列交换机支持该参数。

【描述】

ping ipv6命令用来检查指定IPv6地址是否可达，并输出相应的统计信息。

需要注意的是：

如果要使用目的端的主机名执行ping ipv6操作，事先必须在设备上配置DNS（Domain Name System，域名系统）功能，否则会ping ipv6失败，DNS的相关介绍和配置请参见“三层技术-IP业务配置指导”中的“IPv6域名解析”。

在执行命令过程中，键入<Ctrl+C>可终止ping ipv6操作。

【举例】

# 检查IPv6地址为2001::1的设备是否可达。

<Sysname> ping ipv6 2001::1

  PING 2001::2 : 56  data bytes, press CTRL_C to break

    Reply from 2001::1

    bytes=56 Sequence=1 hop limit=64  time = 62 ms

    Reply from 2001::1

    bytes=56 Sequence=2 hop limit=64  time = 26 ms

    Reply from 2001::1

    bytes=56 Sequence=3 hop limit=64  time = 20 ms

    Reply from 2001::1

    bytes=56 Sequence=4 hop limit=64  time = 4 ms

    Reply from 2001::1

    bytes=56 Sequence=5 hop limit=64  time = 16 ms

  --- 2001::2 ping statistics ---

    5 packet(s) transmitted

    5 packet(s) received

    0.00% packet loss

    round-trip min/avg/max = 4/25/62 ms

# 检查vpn1中IPv6地址为2001::1的设备是否可达。

<Sysname> ping ipv6 –vpn-instance vpn1 2001::1

  PING 2001::1 : 56  data bytes, press CTRL_C to break

    Reply from 2001::1

    bytes=56 Sequence=1 hop limit=64  time = 62 ms

    Reply from 2001::1

    bytes=56 Sequence=2 hop limit=64  time = 26 ms

    Reply from 2001::1

    bytes=56 Sequence=3 hop limit=64  time = 20 ms

    Reply from 2001::1

    bytes=56 Sequence=4 hop limit=64  time = 4 ms

    Reply from 2001::1

    bytes=56 Sequence=5 hop limit=64  time = 16 ms

  --- 2001::2 ping statistics ---

    5 packet(s) transmitted

    5 packet(s) received

    0.00% packet loss

    round-trip min/avg/max = 4/25/62 ms

该显示信息中的“hop limit”字段与IPv4 ping命令显示信息中的“ttl”字段含义相同，均表示ICMP回显请求报文中的TTL值。其它字段的信息请参见表1-1。

1.1.3  tracert

【命令】

tracert [ -a source-ip | -f first-ttl | -m max-ttl | -p port | -q packet-number | -tos tos | -vpn-instance vpn-instance-name | -w timeout ] * host

【视图】

任意视图

【缺省级别】

0：访问级

【参数】

-a source-ip：指定tracert报文的源IP地址。该地址必须是设备上已配置的合法IP地址。不指定该参数时，tracert报文的源IP地址是该报文出接口的主IP地址。

-f first-ttl：指定一个初始TTL，即第一个报文所允许的跳数。取值范围为1～255，且小于最大TTL，缺省值为1。

-m max-ttl：指定一个最大TTL，即一个报文所允许的最大跳数。取值范围为1～255，且大于初始TTL，缺省值为30。

-p port：指定目的端的UDP端口号，取值范围为1～65535，缺省值为33434。

-q packet-number：指定每次发送的探测报文个数，取值范围为1～65535，缺省值为3。

-tos tos：指定tracert报文中的ToS域的值。取值范围为0～255，缺省值为0。

-vpn-instance vpn-instance-name：指定目的端所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示目的端位于公网中。需要注意的是，仅S5500-EI系列交换机支持该参数。

-w timeout：指定探测报文的响应报文的超时时间，取值范围是1～65535，单位为毫秒，缺省值为5000毫秒。

host：目的端的IP地址或主机名，主机名为1～255个字符的字符串。

【描述】

tracert命令用来查看IPv4报文从源端传到目的端所经过的路径。

当网络出现故障时，用户可以使用该命令分析出现故障的网络节点。

tracert命令的输出信息包括到达目的端所经过的所有三层设备的IP地址，如果某设备不能回应ICMP错误消息（可能因为路由不可达或者没有开启ICMP错误报文处理功能），则输出“* * *”。

在执行命令过程中，键入<Ctrl+C>可终止此次tracert操作。

【举例】

# 查看报文从源端到目的端（IP地址为1.1.2.2）所经过的路径。

<Sysname> tracert 1.1.2.2

 traceroute to 1.1.2.2(1.1.2.2) 30 hops max,40 bytes packet, press CTRL_C to break

 1  1.1.1.2 673 ms 425 ms 30 ms

 2  1.1.2.2 580 ms 470 ms 80 ms

# 查看报文从源端到目的端（IP地址为192.168.0.46）所经过的路径（途经MPLS网络）。

<Sysname> tracert 192.168.0.46

 traceroute to 192.168.0.46(192.168.0.46) 30 hops max,40 bytes packet, press CTRL_C to break

 1  192.0.2.13 (192.0.2.13)  0.661 ms  0.618 ms  0.579 ms

 2  192.0.2.9 (192.0.2.9)  0.861 ms  0.718 ms  0.679 ms

    MPLS Label=100048 Exp=0 TTL=1 S=1

 3  192.0.2.5 (192.0.2.5)  0.822 ms  0.731 ms  0.708 ms

    MPLS Label=100016 Exp=0 TTL=1 S=1

 4  192.0.2.1 (192.0.2.1)  0.961 ms  8.676 ms  0.875 ms

表1-2 tracert命令显示信息描述表

1.1.4  tracert ipv6

【命令】

tracert ipv6 [ -f first-ttl | -m max-ttl | -p port | -q packet-number | -tos tos | -vpn-instance vpn-instance-name | -w timeout ] * host

【视图】

任意视图

【缺省级别】

0：访问级

【参数】

-f first-ttl：指定一个初始TTL，即第一个报文所允许的跳数。取值范围为1～255，且小于最大TTL，缺省值为1。

-m max-ttl：指定一个最大TTL，即一个报文所允许的最大跳数。取值范围为1～255，且大于初始TTL，缺省值为30。

-p port：指定目的端的UDP端口号，取值范围为1～65535，缺省值为33434。

-q packet-number：指定每次发送的探测报文个数，取值范围为1～65535，缺省值为3。

-w timeout：指定探测报文的响应报文的超时时间，取值范围为1～65535，单位为毫秒，缺省值为5000毫秒。

host：目的端的IPv6地址或主机名，为1～255个字符的字符串。

-tos tos：指定tracert ipv6报文中的ToS域的值。取值范围为0～255，缺省值为0。

-vpn-instance vpn-instance-name：指定目的端所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示目的端位于公网中。需要注意的是，仅S5500-EI系列交换机支持该参数。

【描述】

tracert ipv6命令用来查看IPv6报文从源端传到目的端所经过的路径。

当网络出现故障时，用户可以使用该命令分析出现故障的网络节点。

本命令的输出信息包括到达目的端所经过的所有三层设备的IP地址，如果某设备设备不能回应ICMP错误消息（可能因为路由不可达或者没有开启ICMP错误报文处理功能），则输出“*  *  *”。

在执行命令过程中，键入<Ctrl+C>可终止此次tracert操作。

【举例】

# 查看报文从源端到目的端（IPv6地址为2001::1）所经过的路径。

<Sysname> tracert ipv6 2001::1

 traceroute to 2001::1  30 hops max,60 bytes packet, press CTRL_C to break

 1  2001::1 3 ms <1 ms 19 ms

# 查看报文从源端到目的端（假设目的端处于vpn1中，IPv6地址为2001::1）所经过的路径。

<Sysname> tracert ipv6 –vpn-instance vpn1 2001::1

 traceroute to 2001::1  30 hops max,60 bytes packet, press CTRL_C to break

 1  2001::1 3 ms <1 ms 19 ms

上述显示信息中各字段的含义请参见表1-2。

1.2  系统调试命令

1.2.1  debugging

【命令】

debugging module-name [ option ]

undo debugging { all | module-name [ option ] }

【视图】

用户视图

【缺省级别】

1：监控级

【参数】

all：所有的调试开关。

module-name：功能模块的名称，比如arp、device等。可以使用debugging ？命令匹配出设备当前支持的模块名。

option：模块中的调试选项。对于不同的模块，调试选项的数量和内容都不相同。可以使用debugging module-name ？匹配出设备当前支持的指定模块的调试选项。

【描述】

debugging命令用来打开设备支持的功能项的调试开关。undo debugging命令用来关闭设备支持的功能项的调试开关。

缺省情况下，所有功能项的调试开关均处于关闭状态。

需要注意的是：

·     由于调试信息的输出会影响系统的运行效率，所以建议在需要进行网络故障诊断时根据需要打开相应功能模块调试开关，不要同时打开多个功能模块的调试开关。

·     【缺省级别】描述的是debugging all的缺省级别，不同功能项debugging命令的缺省级别可能不同，请以实际情况为准。

·     只有同时配置了debugging、terminal debugging和terminal monitor命令，才能在终端显示调试信息的具体内容。terminal debugging和terminal monitor命令的详细介绍请参见“网络管理和监控命令参考”中的“信息中心”。

相关配置可参考命令display debugging。

【举例】

# 打开IP模块中Packet选项的调试开关。

<Sysname> debugging ip packet

1.2.2  display debugging

【命令】

display debugging [ interface interface-type interface-number ] [ module-name ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

interface interface-type interface-number：显示指定接口调试开关的设置情况，interface-type interface-number表示接口类型和接口编号。

module-name：功能模块的名称。

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display debugging命令用来显示系统中已经打开的调试开关。

相关配置可参考命令debugging。

【举例】

# 显示所有打开的调试开关。

<Sysname> display debugging

IP packet debugging is on