Monitor Capture File Location Buffer-Size - Cisco Catalyst 4500 Series Command Reference Manual

Chapter 2 Cisco IOS Commands for the Catalyst 4500 Series Switches

monitor capture file location buffer-size

To specify the capture destination, use the monitor capture command. To remove the details, use the
no form of this command.
Syntax Description
file location filename
buffer-size <1-100>
ring <2-10>
size <1-100>
buffer [circular] size <1-100>
Defaults The default buffer size is one MB.
Command Modes Privileged EXEC mode
Command History Release
IOS XE 3.3.0SG/
15.1(1)SG
Usage Guidelines The capture destination can be a file in storage disk or a memory buffer. This command specifies the
parameters related to packet storage.
The file option specifies that the packets must be stored to a file. To reduce or avoid any loss in packet
capture, you can use the buffer-size option. The capture and store operations require more CPU, limiting
the capture throughput.
You can increase the throughput by triggering lock-step mode, wherein the packets are first captured in
the buffer. Within this mode, the "duration" parameter defines the capture duration. Once the buffer is
full or the duration closes, the buffer is written to the file, greatly increasing the capture throughput. The
lock-step mode is automatically triggered by specifying the buffer size to 32MB or higher.
The size of the capture file can be limited with the size option. The file location must one of the
following:
•
•
•
OL-27596 -01
monitor capture name [[file location filename [buffer-size <1-100>] [ring <2-10>] [size
<1-100>]] | [buffer [circular] size <1-100>]]
]no monitor capture name [file | buffer]
Modification
Support for this command was introduced on the Catalyst 4500 series switch.
Internal bootflash (bootflash: )
External flash (slot0: )
USB (usb0: )
Catalyst 4500 Series Switch Cisco IOS Command Reference—Release IOS XE 3.4.0SG and IOS 15.1(2)SG)
Specifies filename of location.
Specifies bufer size in MB.
Specifies number of files.
Specifies the file size.
Specifies that the capture destination is a buffer. By default, the
mode is linear.
The keyword circular sets the buffer mode to circular.
The keyword size specifies the buffer size.
monitor capture file location buffer-size
2-469