选择区域语言: EN CN HK

15-网络管理和监控命令参考

07-Packet Capture命令

本章节下载  (168.91 KB)

docurl=/cn/Service/Document_Software/Document_Center/Wlan/WA/H3C_WA5500/Command/Command_Manual/H3C_WA_CR(R2414)-6W100/15/201809/1113784_30005_0.htm

07-Packet Capture命令


1 Packet Capture

1.1  Packet Capture配置命令

1.1.1  display packet-capture status

display packet-capture status命令用来显示本地或远程报文捕获状态信息。

【命令】

display packet-capture status

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

本命令不能显示特性包报文捕获状态信息。

【举例】

# 显示本地或远程报文捕获状态信息。

<Sysname> display packet-capture status

AP name        : ap1

Radio ID       : 1

Radio mode     : 802.11n(2.4GHz)

Channel        : 1

Status         : Capturing

File name      : database.pcap

Username       : 1

Password       : ******

表1-1 display packet-capture status显示信息描述表

字段

描述

AP name

AP名称

Radio ID

射频ID

Radio mode

射频模式

Channel

被捕获射频口的当前工作信道

Status

显示捕获状态,目前只有Capturing一种状态

File name

存储捕获报文的文件名称

User name

登录远程FTP服务器时的用户名

Password

登录远程FTP服务器时的密码,配置明文和密文时,均显示为******

若不涉及或未配置则显示为N/A

 

1.1.2  packet-capture interface

说明

如需使用本命令,请先使用boot-loaderinstallissu命令安装Packet Capture特性软件包,有关安装步骤的详细介绍,请参见“基础配置指导”中的“软件升级”或“ISSU”。

packet-capture interface命令用来配置接口的入方向报文捕获。

【命令】

捕获并保存报文到文件:

packet-capture interface interface-type interface-number [ capture-filter capt-expression | limit-captured-frames limit | limit-frame-size bytes | autostop filesize kilobytes | autostop duration seconds | autostop files numbers | capture-ring-buffer filesize kilobytes | capture-ring-buffer duration seconds | capture-ring-buffer files numbers ] * write filepath [ raw | { brief | verbose } ] *

捕获并显示报文内容:

packet-capture interface interface-type interface-number [ capture-filter capt-expression | display-filter disp-expression | limit-captured-frames limit | limit-frame-size bytes | autostop duration seconds ] * [ raw | { brief | verbose } ] *

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number:表示以太网接口的接口类型和接口编号,用来开启指定接口的报文捕获功能。

capture-filter capt-expression:表示捕获报文时过滤规则的表达式,为1~256个字符的字符串,区分大小写。如果不指定此参数,则捕获该接口的所有入方向的报文。

display-filter disp-expression:表示显示捕获报文时过滤规则的表达式,为1~256个字符的字符串,区分大小写。如果不指定此参数,则显示所有捕获到的报文。

limit-captured-frames limit:表示捕获报文的最大个数,取值范围为0~2147483647,单位为个,缺省值为10。若指定报文最大个数为0,则表示没有限制。

limit-frame-size bytes:表示捕获报文的最大长度,取值范围为64~8000,单位为字节,缺省值为8000。当捕获到的报文超过此长度,会对报文进行截断。

autostop filesize kilobytes:表示报文文件(用来存储捕获报文的文件)的大小,取值范围为1~65536,单位为千字节。如果没有指定本参数,表示对报文文件大小没有限制。

autostop duration seconds:表示持续捕获报文的时长,取值范围为1~2147483647,单位为秒。如果没有指定本参数,表示不对捕获报文的时长进行限制。

autostop files numbers:表示允许写的报文文件的个数,取值范围为2~64。如果没有指定本参数,表示不对允许写的报文文件的个数进行限制。

capture-ring-buffer filesize kilobytes:表示切换存储报文文件大小,取值范围为1~65536,单位为千字节。如果没有指定本参数,表示不以文件大小为限制切换报文文件。

capture-ring-buffer duration seconds:表示切换存储报文文件时长,取值范围为1~2147483647,单位为秒。如果没有本参数,表示不以时长为限制切换报文文件。

capture-ring-buffer files numbers:表示报文文件的最大个数,取值范围为2~64。如果没有指定本参数,表示报文文件的最大个数没有限制。

write filepath:表示报文文件的名称,为1~64字符的字符串,后缀必须为“.pcap”,区分大小写。文件名命名规则的详细介绍,请参见“基础配置指导”中的“文件系统管理”。如果没有指定此参数,将不会保存捕获的报文。

raw:将报文内容以十六进制格式显示。不指定该参数时,以字符串格式显示报文内容。

verbose:显示捕获报文的详细信息。

brief:显示捕获报文的简要信息。

【使用指导】

开启指定接口的报文捕获功能后,命令行输入界面会实时显示捕获报文的数量,此时,该用户界面下不允许输入命令行。如果用户希望停止捕获,直接输入Ctrl+C停止捕获报文。

当不指定rawbriefverbose中的任何一个参数时,指定write参数,显示捕获的报文个数;当不指定rawbriefverbosewrite中的任何一个参数时,显示报文的简要信息。

当没有设置报文文件切换条件时,捕获的报文会保存在一个报文文件中,文件名称由write filepath参数指定。如果配置了报文文件切换条件,则捕获的报文会被保存到文件名为扩展文件名的文件中,扩展文件名由filepath、文件生成序号和写入时间组成。当切换到新文件时,新生成的扩展报文文件序号按序递增。例如,指定的文件名称为a.pcap,则第一个生成的报文文件的名称为a_00001_20140211034151.pcap,当达到切换写文件条件时,则将报文写入新生成的a_00002_20140211034207.pcap文件中,依次类推。如果报文文件的最大个数已经达到,但是停止捕获条件还没有达到,设备会继续捕获报文,并用用新捕获的报文覆盖生成时间最早的报文文件。

表1-2 packet-capture命令参数描述表

操作

参数

说明

过滤表达式

·     capture-filter capt-expression:设备根据此规则对报文进行过滤并捕获匹配过滤规则的报文。

·     display-filter disp-expression:设备对已捕获的报文进行过滤,并将匹配的报文内容进行显示。

捕获过滤不能对报文内容进行过滤,显示过滤可以对报文内容进行过滤

捕获过滤规则详细描述请参见“网络管理和监控配置指导”中的“Packet Capture”。

停止捕获

使用以下任意参数,即可实现设备自动停止捕获报文。当同时配置多个停止捕获参数时,先匹配成功的参数生效:

·     autostop filesize kilobytes:当报文文件的大小达到配置值时,则自动停止捕获报文

·     autostop duration seconds:当持续捕获报文的时长达到最大值时,则自动停止捕获报文

·     autostop files numbers:当写过的文件的个数达到配置值时(包括被覆盖写过的文件),则自动停止捕获报文

·     limit-captured-frames limit:当捕获报文的个数达到配置值时,则自动停止捕获报文

报文捕获功能还受文件系统空闲空间大小的限制。当文件系统空闲空间不足时,即便停止捕获参数设置的条件没有匹配,也将自动停止捕获报文

切换存储

使用以下任意参数,即可触发报文文件的切换。当同时配置多个切换参数时,先匹配成功的参数生效:

·     capture-ring-buffer filesize kilobytes:当报文文件大小达到配置值时,切换到下一个文件来存储捕获报文

·     capture-ring-buffer duration seconds:当捕获报文时长达到配置值时,切换到下一个文件来存储捕获报文

·     当指定autostop files参数或者capture-ring-buffer files参数时,如果同时指定autostop filesize参数,则autostop filesize作为切换条件参数处理

当指定autostop files参数或者capture-ring-buffer files参数时,则需指定切换存储参数

当同时指定autostop filesizecapture-ring-buffer filesize时,autostop filesize作为停止条件参数将失效,autostop filesize作为切换条件参数将生效。当autostop filesizecapture-ring-buffer filesize均作为切换条件参数,配置命令时后输入的生效

 

【举例】

# 配置接口GigabitEthernet1/0/1的入方向报文捕获。

<Sysname> packet-capture interface gigabitethernet 1/0/1

【相关命令】

·     packet-capture read

1.1.3  packet-capture local ap

packet-capture local ap命令用来配置射频接口上的本地报文捕获并将捕获到的报文保存到FTP服务器。

【命令】

packet-capture local ap ap-name radio radio-id [ capture-filter capt-expression | limit-frame-size bytes | autostop filesize kilobytes | autostop duration seconds ] * write url url [ username username [ password { cipher | simple } string ] ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ap-name:指定AP的名称,,为1~64个字符的字符串,可以包含字母、数字、下划线、“[”、“]”、“/”及“-”,不区分大小写。

radio radio-id:指定射频号。

capture-filter capt-expression:指定用来捕获报文的过滤规则,capt-expression为捕获过滤表达式,为1~256个字符的字符串,区分大小写。设备根据此参数指定的过滤规则对报文进行过滤并捕获过滤后的报文。捕获过滤语法规则请参见“网络管理和监控配置指导”中的“Packet Capture”。如果不指定此参数,则捕获该接口的所有入方向的报文。

limit-frame-size bytes:指定捕获报文的最大长度,bytes为报文的最大长度,取值范围为64~8000,单位为字节,缺省值为8000。当捕获到的报文超过此长度,会对报文进行截断。

autostop filesize kilobytes:指定存储报文的文件大小,kilobytes为文件的最大长度,取值范围为1~65536,单位为千字节。当报文文件达到最大值时,报文捕获自动停止。如果没有指定本参数,表示对报文文件大小没有限制。

autostop duration seconds:指定捕获报文时长,seconds为最大时长,取值范围为1~2147483647,单位为秒。当捕获报文时长达到最大值时,报文捕获自动停止。如果没有指定本参数,表示不对捕获报文的时长进行限制。

write url url:指定存储报文文件的路径。url为FTP服务器上的路径,为1~255个字符的字符串,区分大小写,路径中不能包含“@”,不能包含用户名和密码,用户名和密码由usernamepassword参数指定。如果没有指定此参数,将不会保存捕获的报文。

username username:指定登录远程FTP服务器时使用的用户名,为1~32个字符的字符串,区分大小写。

password:设置用户密码。

cipher:以密文方式设置密码。

simple:以明文方式设置密码,该密码将以密文形式存储。

string:密码字符串,区分大小写。明文密码为1~32个字符的字符串;密文密码为1~73个字符的字符串。

【使用指导】

开启指定AP、指定射频接口、指定端口的报文捕获功能,并将捕获的报文上传到FTP服务器,如需要停止本地报文捕获,请输入packet-capture stop命令。

具有停止报文捕获条件属性的参数有autostop filesize参数、autostop duration参数。不同条件的停止捕获参数同时存在时,只要满足任意一个参数,则报文捕获退出。

仅支持使用FTP协议将捕获的报文上传到远程FTP服务器。输入url、登录用户名、密码时遵循以下要求:

·     url采用“ftp://服务器地址[:端口号]/文件名”的形式,形如ftp://192.168.1.1/test.cfg和ftp://192.168.1.1:21/test.cfg。其中,服务器地址支持IP地址和DNS域名方式,端口号为可选参数(和服务器端的配置一致)。

·     若服务器地址为IPv6地址时需使用方括号“[”和“]”将IPv6地址括起来,以便将IPv6地址和端口号区分开来。形如ftp://[2001::1]/test.cfg和ftp://[2001::1]:21/test.cfg,其中,2001::1为FTP服务器的IPv6地址,21为服务器接收FTP协议报文的端口号。

·     若服务器地址为DNS域名格式时请勿使用方括号引用,形如ftp://sdp:21/test.cfg。

·     如有用户名和密码请分别使用参数username和参数password进行配置,用户名和密码必须和服务器上的配置一致,如果服务器只对用户名进行验证,则不用输入密码。

当用户将捕获的报文保存到FTP服务器时,若指定的autostop duration时间较短时,可能设备还未连接到FTP服务器,捕获服务已经退出,此时FTP服务器不会产生保存捕获报文的文件。

【举例】

# 开启AP1的Radio1的本地报文捕获。

<Sysname> packet-capture local ap ap1 radio 1 write url ftp://10.1.1.1/database.pcap username 1 password simple 1

【相关命令】

·     display packet-capture status

·     packet-capture stop

1.1.4  packet-capture local interface

packet-capture local interface命令用来配置接口的本地报文捕获并将捕获的报文保存到本地或FTP服务器。

【命令】

packet-capture local interface interface-type interface-number [ capture-filter capt-expression | limit-frame-size bytes | autostop filesize kilobytes | autostop duration seconds ] * write { filepath | url url [ username username [ password { cipher | simple } string ] ] }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number:表示以太网接口的接口类型和接口编号,用来对指定的接口开启报文捕获功能。

capture-filter capt-expression:指定用来捕获报文的过滤规则,capt-expression表示捕获过滤表达式,为1~256个字符的字符串,区分大小写。设备根据此参数指定的过滤规则对报文进行过滤并捕获过滤后的报文。捕获过滤语法规则请参见“网络管理和监控配置指导”中的“Packet Capture”。如果不指定此参数,则捕获该接口的所有入方向的报文。

limit-frame-size bytes:指定捕获报文的最大长度,bytes为报文的最大长度,取值范围为64~8000,单位为字节,缺省值为8000。当捕获到的报文超过此长度,会对报文进行截断。

autostop filesize kilobytes:指定存储报文的文件大小,kilobytes为文件的最大长度,取值范围为1~65536,单位为千字节。当报文文件达到最大值时,报文捕获自动停止。如果没有指定本参数,表示对报文文件大小没有限制。

autostop duration seconds:指定捕获报文时长,seconds为最大时长,取值范围为1~2147483647,单位为秒。当捕获报文时长达到最大值时,报文捕获自动停止。如果没有指定本参数,表示不对捕获报文的时长进行限制。

write:保存报文文件。

filepath:存储报文文件的本地路径,为1~64字符的字符串,区分大小写。文件名命名规则的详细介绍,请参见“基础配置指导”中的“文件系统管理”。后缀必须为pcap。如果没有指定此参数,还可以保存在远程目标路径上。

url url:指定存储报文文件的路径,url为FTP服务器上的路径,为1~255个字符的字符串,区分大小写,路径中不能包含“@”,不能包含用户名和密码,用户名和密码由usernamepassword参数指定。

username username:指定登录远程FTP服务器时使用的用户名,为1~32个字符的字符串,区分大小写。

password:设置用户密码。

cipher:以密文方式设置密码。

simple:以明文方式设置密码,该密码将以密文形式存储。

string:密码字符串,区分大小写。明文密码为1~32个字符的字符串;密文密码为1~73个字符的字符串。

【使用指导】

开启接口的报文捕获,Packet Capture终端允许用户执行其它操作。如果用户希望停止捕获,请输入packet-capture stop命令。

具有停止报文捕获条件属性的参数有autostop filesize参数、autostop duration参数。不同条件的停止捕获参数同时存在时,只要满足任意一个参数,则报文捕获退出。

仅支持使用FTP协议将捕获的报文上传到远程FTP服务器。输入url、登录用户名、密码时遵循以下要求:

·     url采用“ftp://服务器地址[:端口号]/文件名”的形式,形如ftp://192.168.1.1/test.cfg和ftp://192.168.1.1:21/test.cfg。其中,服务器地址支持IP地址和DNS域名方式,端口号为可选参数(和服务器端的配置一致)。

·     若服务器地址为IPv6地址时需使用方括号“[”和“]”将IPv6地址括起来,以便将IPv6地址和端口号区分开来。形如ftp://[2001::1]/test.cfg和ftp://[2001::1]:21/test.cfg,其中,2001::1为FTP服务器的IPv6地址,21为服务器接收FTP协议报文的端口号。

·     若服务器地址为DNS域名格式时请勿使用方括号引用,形如ftp://sdp:21/test.cfg。

·     如有用户名和密码请分别使用参数username和参数password进行配置,用户名和密码必须和服务器上的配置一致,如果服务器只对用户名进行验证,则不用输入密码。

当用户将捕获的报文保存到FTP服务器时,若指定的autostop duration时间较短时,可能设备还未连接到FTP服务器,捕获服务已经退出,此时FTP服务器不会产生保存捕获报文的文件。

【举例】

# 将捕获的报文保存到IP地址为10.1.1.1的FTP服务器,FTP服务器工作目录下,用户名为1,密码为1,文件名为database.pcap。

<Sysname> packet-capture local interface wlan-radio 1/0/1 write url ftp://10.1.1.1/database.pcap username 1 password simple 1

【相关命令】

·     display packet-capture status

·     packet-capture stop

1.1.5  packet-capture read

说明

如需使用本命令,请先使用boot-loaderinstallissu命令安装Packet Capture特性软件包,有关安装步骤的详细介绍,请参见“基础配置指导”中的“软件升级”或“ISSU”。

packet-capture read命令用来解析并显示保存的报文文件。

【命令】

packet-capture read filepath [ display-filter disp-expression ] [ raw | { brief | verbose } ] *

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

filepath:指定读取的文件的完整路径,为1~64个字符的字符串,后缀为“.pcap”或“.pcapng”,区分大小写。文件名命名规则的详细介绍,请参见“基础配置指导”中的“文件系统管理”。

display-filter disp-expression:指定用来显示报文的过滤规则,为1~256个字符的字符串。disp-expression为显示报文的过滤规则。设备报文文件内容匹配参数指定的显示过滤规则,并将匹配的报文内容进行显示。显示过滤语法规则参见Packet Capture配置手册。如果不指定此参数,则显示报文文件中的所有报文信息。

raw:将报文文件内容用十六进制格式显示。不指定该参数时,以字符串格式显示报文内容。

brief:显示报文文件的简要信息。

verbose:显示报文文件的详细信息。

【使用指导】

配置解析并显示报文文件内容后,Packet Capture终端显示从指定文件中读取解析的报文信息,如果用户希望退出此过程,可以直接输入Ctrl+C退出解析过程。

设备保存报文文件时使用pcap格式,但解析的报文文件可以为pcap或pcapng格式。

未指定rawbriefverbose参数时,则显示简要信息。

【举例】

# 解析flash:/test目录下的报文文件aaaa.pcap。

<Sysname> packet-capture read flash:/test/aaaa.pcap

【相关命令】

·     packet-capture interface

1.1.6  packet-capture remote ap

packet-capture remote ap ap-name radio radio-id命令用来配置AP远程报文捕获。

【命令】

packet-capture remote ap ap-name radio radio-id [ port port ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ap-name:表示捕获指定AP收到的报文,ap-name表示AP的名称,为1~64个字符的字符串,可以包含字母、数字、下划线、“[”、“]”、“/”及“-”,不区分大小写。

radio radio-id:表示捕获指定射频收到的报文,radio-id表示射频ID。

port port:表示捕获AP上指定RPCAP服务端口号收到的报文,若不指定本参数,缺省值为2002。

【使用指导】

配置指定AP指定Radio口的远程报文捕获,客户端(比如Wireshark)连接到AP的RPCAP服务端口,就可以获取到指定的Radio口捕获的从客户端发往AP的报文。

如需停止报文捕获,请输入packet-capture stop命令。

【举例】

# 配置AP1的Radio 2的远程报文捕获,并且指定服务端口号为2014。

<Sysname> packet-capture remote ap ap1 radio 2 port 2014

【相关命令】

·     display packet-capture status

·     packet-capture stop

1.1.7  packet-capture remote interface

packet-capture remote interface命令用来配置接口远程报文捕获。

【命令】

packet-capture remote interface interface-type interface-number [ port port ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number:指定捕获报文的接口。

port port:指定RPCAP服务端口号,若不指定本参数,缺省值为2002。

【使用指导】

配置指定接口的远程报文捕获,客户端连接到AP,就可以获取指定的接口的报文。

可以通过执行packet-capture stop命令来停止捕获。

【举例】

# 在射频接口上配置远程报文捕获,并且指定服务端口号为2014。

<Sysname> packet-capture remote interface wlan-radio 1/0/1 port 2014

【相关命令】

·     display packet-capture status

·     packet-capture stop

1.1.8  packet-capture stop

packet-capture stop命令用来停止本地或远程报文捕获。

【命令】

packet-capture stop

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

本命令不能用来停止特性包报文捕获。执行快捷键<Ctrl+C>,可结束特性包报文捕获。

【举例】

# 停止本地或远程报文捕获。

<Sysname> packet-capture stop

【相关命令】

·     packet-capture local ap

·     packet-capture local interface

·     packet-capture remote ap

·     packet-capture remote interface

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!