Setup and Install

Troubleshooting HyperFabric
Running Diagnostics
Chapter 5
106
• -r specifies that you want to probe a specific remote node identified by
remote_node_name. The probe is done on all operational routes to the remote node.
• -T specifies that you want to set the tracing level for the HyperFabric software and
the firmware to trace_level, which can be one or more of the following (you can
specify either the keyword or the hexadecimal value):
reset or 0x0 Reset tracing to the default level for all
components (that is, turn off all tracing).
send_path or 0x0002 Trace the HyperFabric software send path.
packet_data or 0x0004 Trace the packet data.
packet_hdr or 0x0008 Trace the protocol headers (TCP/UDP/IP).
data_struct or 0x0010 Trace the HyperFabric software CLIC-specific
data structures and events.
rcv_path or 0x0020 Trace the HyperFabric software receive path.
control or 0x0040 Trace the HyperFabric software control
messages.
all or 0xffff Turn on all possible trace levels. Note that this
will have a severe impact on performance.
To find out what the current tracing level is, run this parameter (-T) without any
keyword or hexadecimal value specified.
• -D specifies that you want to dump the trace buffers from the kernel to a user-space
file and format the data using the formatter TCP_IP. The HyperFabric software trace
data is dumped into the file /var/adm/clic_ip_drv.trc and formatted.
• -C TCP_IP operates in a way similar to -D TCP_IP, except that the trace data in the
kernel is dumped at regular intervals to the trace file /var/adm/clic_ip_drv.trc0,
and if that file gets full, to /var/adm/clic_ip_drv.trc1. So, new trace events are
appended to the trace output file. This stops when tracing is turned off.
• -B specifies that you want the size (in bytes) of the trace buffer to be
trace_buffer_size. The buffer is dynamically allocated when tracing is enabled.
Also, the buffer is circular, which means that when the end of the buffer is reached,
the data wraps around to the beginning of the buffer (and overwrites any previous
data). If you do not specify this parameter, a default buffer is created with a size of
64k bytes.
• -F specifies trace_file_size as the maximum size of the trace output file. For the
-D TCP_IP parameter, the file is /var/adm/clic_ip_drv.trc. For the -C TCP_IP
parameter, the files are /var/adm/clic_ip_drv.trc0 (and if needed,
/var/adm/clic_ip_drv.trc1).
• -d dumps the memory of the adapter identified by adapter_ID to the dump file
filename. If you do not specify filename, the default file is
/var/adm/clic_fw.dumpx, where x is the adapter instance number.
• -? displays the online help for clic_diag.
If you do not specify any of the above parameters, the online help for clic_diag is
displayed.