Brocade Communications Systems Brocade 8/12c Command Reference Manual page 403

Fabric OS Command Reference
53-1001764-01
-pat bit_pattern
Specifies a unique combination of values in the first 64 bytes of a frame. The
syntax for the bit patterns is as follows: "offset,bitmask, value;[offset,
bitmask,value;] ...;" for example, "12,0xFF,0x08;4,0xFF,0x06;40,0xFF,0x08,
0x28;". This example monitors for SCSI read command traffic transmitted from a
port by filtering on offset 12 with a value of 0x08 (SCSI-FCP), on offset 4 with
value 0x06 (unsolicited command), and on offset 40 with values of 0x08 or 0x28
(read command). Each pattern must end with a semicolon (;) and the combined
pattern must be enclosed in double quotation marks. This operand is required with
the --create option. It is optional with the --change option.
The pattern components are as follows:
Offset
Specifies the offset within the frame. Offset 0 is the first byte of the
start-of-frame (SOF) delimiter, and offset 4 is the first byte of the frame
header. The offset must be in decimal format. Valid values for offset are 0,
and 4 to 63. Offset 0 is a special case that can be used to monitor the first
four bytes SOFx frames. The end-of--frame (EOF) delimiter cannot be
monitored. A maximum of six offsets can be specified for each filter, and each
offset can match up to four values. The count is incremented by one, if a
frame has a matching value in all the offsets specified by the filter.
bitmask
Specifies the mask value to be applied to frame contents.
value
Specifies the values that need to be captured from the frame contents.
In SOFx frames the offset is specified as 0x0; The value is specified as one of
the following. For example, the value of 0x6 matches frames of type SOFi3:
0
SOFf
1
SOFc1
2
SOFi1
3
SOFn1
4
SOFi2
5
SOFn2
6
SOFi3
7
SOFn3
22
fmMonitor
369