PERFQUERY(8) | Open IB Diagnostics | PERFQUERY(8) |
perfquery - query InfiniBand port counters on a single port
perfquery [options] [<lid|guid> [[port(s)] [reset_mask]]]
perfquery uses PerfMgt GMPs to obtain the PortCounters (basic performance and error counters), PortExtendedCounters, PortXmitDataSL, PortRcvDataSL, PortRcvErrorDetails, PortXmitDiscardDetails, PortExtendedSpeedsCounters, or PortSamplesControl from the PMA at the node/port specified. Optionally shows aggregated counters for all ports of node. Finally it can, reset after read, or just reset the counters.
Note: In PortCounters, PortCountersExtended, PortXmitDataSL, and PortRcvDataSL, components that represent Data (e.g. PortXmitData and PortRcvData) indicate octets divided by 4 rather than just octets.
Note: Inputting a port of 255 indicates an operation be performed on all ports.
Note: For PortCounters, ExtendedCounters, and resets, multiple ports can be specified by either a comma separated list or a port range. See examples below.
-G, --Guid The address specified is a Port GUID
-L, --Lid The address specified is a LID
-s, --sm_port <smlid> use 'smlid' as the target lid for SA queries.
-C, --Ca <ca_name> use the specified ca_name.
-P, --Port <ca_port> use the specified ca_port.
Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria:
If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible.
For example:
ibaddr # use the first port (criteria #1 above) ibaddr -C mthca1 # pick the best port from "mthca1" only. ibaddr -P 2 # use the second (active/up) port from the first available IB device. ibaddr -C mthca0 -P 2 # use the specified port only.
-h, --help show the usage message
-V, --version show the version info.
-t, --timeout <timeout_ms> override the default timeout for the solicited mads.
--config, -z <config_file> Specify alternate config file.
/etc/infiniband-diags/ibdiag.conf
A global config file is provided to set some of the common options for all tools. See supplied config file for details.
perfquery # read local port performance counters perfquery 32 1 # read performance counters from lid 32, port 1 perfquery -x 32 1 # read extended performance counters from lid 32, port 1 perfquery -a 32 # read perf counters from lid 32, all ports perfquery -r 32 1 # read performance counters and reset perfquery -x -r 32 1 # read extended performance counters and reset perfquery -R 0x20 1 # reset performance counters of port 1 only perfquery -x -R 0x20 1 # reset extended performance counters of port 1 only perfquery -R -a 32 # reset performance counters of all ports perfquery -R 32 2 0x0fff # reset only error counters of port 2 perfquery -R 32 2 0xf000 # reset only non-error counters of port 2 perfquery -a 32 1-10 # read performance counters from lid 32, port 1-10, aggregate output perfquery -l 32 1-10 # read performance counters from lid 32, port 1-10, output each port perfquery -a 32 1,4,8 # read performance counters from lid 32, port 1, 4, and 8, aggregate output perfquery -l 32 1,4,8 # read performance counters from lid 32, port 1, 4, and 8, output each port