HPE FlexNetwork 5130 HI Series Network Management And Monitoring Command Reference page 367

64. The capture creates a file to store packet data when a rotation is triggered. The first rotation
occurs when the capture starts. If you do not set a limit, the number of file rotations is unlimited.
capture-ring-buffer filesize kilobytes: Rotates the packet file when the maximum file size is
reached. The kilobytes argument sets the maximum file size. The value range is 1 to 65536
kilobytes.
capture-ring-buffer duration seconds: Rotates the packet file when the rotation interval expires.
The seconds argument sets the rotation interval. The value range is 1 to 2147483647 seconds.
capture-ring-buffer files numbers: Sets the maximum number of packet files for file rotation, in the
range of 2 to 64. If this limit is reached before the capture stops, newly captured packets will
overwrite the packet data in the oldest file.
write filepath: Specifies the full path of the packet file to store captured packet data. The path must
be a case-sensitive string of up to 64 characters. The filename extension must be .pcap. For more
information about setting a file path, see file system management in Fundamentals Configuration
Guide.
raw: Displays packet contents in hexadecimal notation. If you do not specify this keyword, the
capture displays packet data in a string format.
verbose: Displays detailed information about captured packets.
brief: Displays brief information about captured packets.
Usage guidelines
The device displays captured packet data in real time.
• If you specify the write filepath option without specifying the raw, brief, or verbose keyword,
this command displays the number of captured packets.
• If you do not specify any one of the raw, brief, verbose, and write filepath parameters, this
command displays brief information about captured packets.
After packet capture is enabled, you are not allowed to configure other commands from the CLI. To
stop the capture while it is capturing packets, press Ctrl+C.
If file rotation is disabled, the capture creates a packet file with the file name specified by the write
filepath option. If file rotation is enabled, the capture automatically creates a packet file for each
rotation, and renames the file to include a sequence number and timestamp. The sequence number
increases by 1 for each file rotation. For example, set the file name to a.pcap. For the first rotation,
the capture will create a packet file named a_00001_20140211034151.pcap. For the second
rotation, the capture will create a packet file named a_00002_20140211034207.pcap.
Use Table 86
Table 86 Using the packet filter parameters
Purpose
Stop capturing
when you configure the options for stopping the capture or rotating the file.
Options
• Stop based on the capturing
duration:
autostop duration seconds
• Stop based on the number of
captured packets:
limit-captured-frames limit
• Stop based on the number of file
rotations:
autostop files numbers
• Stop based on the file size if file
rotation is disabled:
autostop filesize kilobytes
Remarks
The packet capture stops if any one of
the limits for the stop options is
reached. The packet capture also
stops if the file system's limit on the
number of files has been reached.
The autostop filesize option does not
stop the capture if file rotation is
enabled by the autostop files,
capture-ring-buffer files, or
capture-ring-buffer filesize option.
358