Brocade Fabric OS Command Reference Manual Supporting Fabric OS v6.3.0 (53-1001337-01, July 2009)

Fabric OS Command Reference 885

53-1001337-01

traceDump

Initiates, or removes a trace dump or displays the trace dump status.

Synopsis tracedump [-S ]

tracedump -n [-s slot]

tracedump -r [-s slot] | -R

tracedump -c [-s slot]

Description Use this command to initiate a background trace dump, to remove the content of a trace dump, or

to display the dump status on the switch.

When executed without operands, this command defaults to traceDump -S.

Execution of traceDump –n generates a local trace dump locally. Use supportSave to transfer the

local trace dump to a remote host. When supportSave is used, the default remote file name format

for the trace dump file is as follows:

chassisname-S#-YYYYMMDDHHMMSS.<new | old>.tracedump.dmp.gz

S# Indicates the slot number (0 on standalone platforms)

YYYYMMDDHHMMSS

Indicates the trace dump time stamp (year-month-day-hour-minute-second).

new | old Indicates a new or an old trace dump file.

dmp.gz The compressed trace dump archive file extension.

Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may

be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command

Availability" for details.

Operands This command has the following mutually exclusive operands:

-S Displays the trace dump status This operand is optional. If omitted, the same

status information is displayed.

-n Initiates a background trace dump.

-r Clears the status of a particular trace dump on a specified slot.

-R Clears the status of a particular trace dump on all slots.

-c Clears all trace dump buffers. This operation resets the trace buffer contents.

This command has the following optional operand:

-s slot Specifies the slot number from which a trace dump is generated. If a slot is

not supplied, the trace dump is generated from the local slot. This operand is

optional.

Examples To initiate a background trace dump from slot 5:

switch:admin> tracedump -n -s 5