Brocade Fabric OS Command Reference Manual Supporting Fabric OS v6.4.0 (53-1001764-01, March 2010)
568 Fabric OS Command Reference
53-1001764-01
perfAddUserMonitor
2
"grouplist" Specifies up to six sets of offset, mask, and ValueList, separated by
semicolons (;). The entire grouplist operand must be enclosed in quotation
marks. For example: "4, 0xff, 0x22; 12, 0xff, 0x01"
The grouplist component values are as follows:
Offset Specifies the offset within the frame. Offset 0 is the first byte of the SOF, and
offset 4 is the first byte of the frame header. The offset must be in decimal
format. Valid values for offset are 0, [4-63]. Offset 0 is a special case that can
be used to monitor the first four bytes SOFx frames. EOF cannot be
monitored.
Mask Specifies the mask value to be applied (with the AND operator) to frame
contents.
ValueList Specifies up to four values that need to be captured from frame contents.
The ValueList can be either hexadecimal or decimal format.
SOFx frames are considered a special case. The Offset is specified as 0x0;
valueList values are specified with:
0 SOFf
1 SOFc1
2 SOFi1
3 SOFn1
4 SOFi2
5 SOFn2
6 SOFi3
7 SOFn3
alias Specifies a name for the monitor. Strings exceeding 10 characters are
truncated. To accommodate spaces, the string must be surrounded by
quotation marks. Spaces count toward the character limit but are removed.
This operand is optional. By default, the alias is an empty string.
Examples To add a filter-based monitor for all Extended Link Service requests (R_CTL=0x22 and TYPE=0x01)
to a port:
switch:admin> perfaddusermonitor 1/4 "4, 0xff, 0x22; 12, 0xff, 0x01"
User monitor #0 added
As a special case, to add a filter-based monitor for SOFi3 to a port:
switch:admin> perfaddusermonitor 1/4 "0, 0xff, 6"
User monitor #1 added
See Also perfAddEEMonitor, perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor,
perfAddSCSIMonitor, perfAddWriteMonitor