OS Manuals

/usr/bin/perfquery

userspace components for the Linux Kernel's drivers/infiniband subsystem

From rdma-core 66.0-r0 (os), captured 2026-11-10 by running perfquery --help (exit 2). permalink

Usage: /usr/bin/perfquery [options]  [<lid|guid> [[port(s)] [reset_mask]]]

Options:
  --extended, -x          show extended port counters
  --xmtsl, -X             show Xmt SL port counters
  --rcvsl, -S             show Rcv SL port counters
  --xmtdisc, -D           show Xmt Discard Details
  --rcverr, -E            show Rcv Error Details
  --extended_speeds, -T   show port extended speeds counters
  --oprcvcounters         show Rcv Counters per Op code
  --flowctlcounters       show flow control counters
  --vloppackets           show packets received per Op code per VL
  --vlopdata              show data received per Op code per VL
  --vlxmitflowctlerrors   show flow control update errors per VL
  --vlxmitcounters        show ticks waiting to transmit counters per VL
  --swportvlcong          show sw port VL congestion
  --rcvcc                 show Rcv congestion control counters
  --slrcvfecn             show SL Rcv FECN counters
  --slrcvbecn             show SL Rcv BECN counters
  --xmitcc                show Xmit congestion control counters
  --vlxmittimecc          show VL Xmit Time congestion control counters
  --smplctl, -c           show samples control
  --all_ports, -a         show aggregated counters
  --loop_ports, -l        iterate through each port
  --reset_after_read, -r  reset counters after read
  --Reset_only, -R        only reset counters
  --config, -z <config>   use config file, default: /etc/infiniband-diags/ibdiag.conf
  --Ca, -C <ca>           Ca name to use
  --Port, -P <port>       Ca port number to use
  --Lid, -L               use LID address argument
  --Guid, -G              use GUID address argument
  --timeout, -t <ms>      timeout in ms
  --sm_port, -s <lid>     SM port lid
  --m_key, -y <key>       M_Key to use in request
  --pkey-idx, -Y <idx>    P_Key table index for outgoing SA/GMP MADs
                          (default 0)
  --errors, -e            show send and receive errors
  --verbose, -v           increase verbosity level
  --debug, -d             raise debug level
  --help, -h              help message
  --version, -V           show version

Examples:
  /usr/bin/perfquery 		# read local port's performance counters
  /usr/bin/perfquery 32 1		# read performance counters from lid 32, port 1
  /usr/bin/perfquery -x 32 1	# read extended performance counters from lid 32, port 1
  /usr/bin/perfquery -a 32		# read performance counters from lid 32, all ports
  /usr/bin/perfquery -r 32 1	# read performance counters and reset
  /usr/bin/perfquery -x -r 32 1	# read extended performance counters and reset
  /usr/bin/perfquery -R 0x20 1	# reset performance counters of port 1 only
  /usr/bin/perfquery -x -R 0x20 1	# reset extended performance counters of port 1 only
  /usr/bin/perfquery -R -a 32	# reset performance counters of all ports
  /usr/bin/perfquery -R 32 2 0x0fff	# reset only error counters of port 2
  /usr/bin/perfquery -R 32 2 0xf000	# reset only non-error counters of port 2
  /usr/bin/perfquery -a 32 1-10	# read performance counters from lid 32, port 1-10, aggregate output
  /usr/bin/perfquery -l 32 1-10	# read performance counters from lid 32, port 1-10, output each port
  /usr/bin/perfquery -a 32 1,4,8	# read performance counters from lid 32, port 1, 4, and 8, aggregate output
  /usr/bin/perfquery -l 32 1,4,8	# read performance counters from lid 32, port 1, 4, and 8, output each port
Options (37)
OptionDescriptionSource
--extended, -xshow extended port countershelp
--xmtsl, -Xshow Xmt SL port countershelp
--rcvsl, -Sshow Rcv SL port countershelp
--xmtdisc, -Dshow Xmt Discard Detailshelp
--rcverr, -Eshow Rcv Error Detailshelp
--extended_speeds, -Tshow port extended speeds countershelp
--oprcvcountersshow Rcv Counters per Op codehelp
--flowctlcountersshow flow control countershelp
--vloppacketsshow packets received per Op code per VLhelp
--vlopdatashow data received per Op code per VLhelp
--vlxmitflowctlerrorsshow flow control update errors per VLhelp
--vlxmitcountersshow ticks waiting to transmit counters per VLhelp
--swportvlcongshow sw port VL congestionhelp
--rcvccshow Rcv congestion control countershelp
--slrcvfecnshow SL Rcv FECN countershelp
--slrcvbecnshow SL Rcv BECN countershelp
--xmitccshow Xmit congestion control countershelp
--vlxmittimeccshow VL Xmit Time congestion control countershelp
--smplctl, -cshow samples controlhelp
--all_ports, -ashow aggregated countershelp
--loop_ports, -literate through each porthelp
--reset_after_read, -rreset counters after readhelp
--Reset_only, -Ronly reset countershelp
--config, -z configuse config file, default: /etc/infiniband-diags/ibdiag.confhelp
--Ca, -C caCa name to usehelp
--Port, -P portCa port number to usehelp
--Lid, -Luse LID address argumenthelp
--Guid, -Guse GUID address argumenthelp
--timeout, -t mstimeout in mshelp
--sm_port, -s lidSM port lidhelp
--m_key, -y keyM_Key to use in requesthelp
--pkey-idx, -Y idxP_Key table index for outgoing SA/GMP MADs (default 0)help
--errors, -eshow send and receive errorshelp
--verbose, -vincrease verbosity levelhelp
--debug, -draise debug levelhelp
--help, -hhelp messagehelp
--version, -Vshow versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.