perfquery(8)

NAME

   PERFQUERY -

QUERY INFINIBAND PORT COUNTERS ON A SINGLE PORT

   SYNOPSIS
   perfquery [options] [<lid|guid> [[port(s)] [reset_mask]]]

   DESCRIPTION
   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.

   OPTIONS
   -x, --extended
          show  extended  port counters rather than (basic) port counters.
          Note that extended port counters attribute is optional.

   -X, --xmtsl
          show transmit data SL counter. This is an optional  counter  for
          QoS.

   -S, --rcvsl
          show  receive  data  SL counter. This is an optional counter for
          QoS.

   -D, --xmtdisc
          show transmit discard details. This is an optional counter.

   -E, --rcverr
          show receive error details. This is an optional counter.

   -D, --xmtdisc
          show transmit discard details. This is an optional counter.

   -T, --extended_speeds
          show extended speeds port counters. This is an optional counter.

   --oprcvcounters
          show Rcv Counters per Op code. This is an optional counter.

   --flowctlcounters
          show flow control counters. This is an optional counter.

   --vloppackets
          show packets received per Op code per VL. This  is  an  optional
          counter.

   --vlopdata
          show  data  received  per  Op  code  per VL. This is an optional
          counter.

   --vlxmitflowctlerrors
          show flow control update errors per  VL.  This  is  an  optional
          counter.

   --vlxmitcounters
          show  ticks  waiting  to  transmit  counters  per VL. This is an
          optional counter.

   --swportvlcong
          show sw port VL congestion. This is an optional counter.

   --rcvcc
          show Rcv  congestion  control  counters.  This  is  an  optional
          counter.

   --slrcvfecn
          show SL Rcv FECN counters. This is an optional counter.

   --slrcvbecn
          show SL Rcv BECN counters. This is an optional counter.

   --xmitcc
          show  Xmit  congestion  control  counters.  This  is an optional
          counter.

   --vlxmittimecc
          show VL Xmit  Time  congestion  control  counters.  This  is  an
          optional counter.

   -c, --smplctl
          show port samples control.

   -a, --all_ports
          show  aggregated  counters for all ports of the destination lid,
          reset all counters for all  ports,  or  if  multiple  ports  are
          specified,  aggregate  the  counters of the specified ports.  If
          the destination lid does not support the AllPortSelect flag, all
          ports   will   be  iterated  through  to  emulate  AllPortSelect
          behavior.

   -l, --loop_ports
          If all ports are selected by the user  (either  through  the  -a
          option  or  port  255)  or  multiple ports are specified iterate
          through each port rather than doing than aggregate operation.

   -r, --reset_after_read
          reset counters after read

   -R, --Reset_only
          only reset counters

   Addressing Flags
   -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.

   Port Selection flags
   -C, --Ca <ca_name>    use the specified ca_name.

   -P, --Port <ca_port>    use the specified ca_port.

   Local port Selection
   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:

      1. the first port that is ACTIVE.

      2. if not found, the first port that is UP (physical link up).

      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.

   Debugging flags
   -d     raise the IB debugging level.  May be used several  times  (-ddd
          or -d -d -d).

   -e     show send and receive errors (timeouts and others)

   -h, --help      show the usage message

   -v, --verbose
          increase  the  application verbosity level.  May be used several
          times (-vv or -v -v -v)

   -V, --version     show the version info.

   Configuration flags
   -t,  --timeout  <timeout_ms>  override  the  default  timeout  for  the
   solicited mads.

   -y, --m_key <key>
          use the specified M_key for requests. If non-numeric value (like
          'x') is specified then a value will be prompted for.

   --config, -z  <config_file> Specify alternate config file.
      Default: /etc/infiniband-diags/ibdiag.conf

   FILES
   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.

   EXAMPLES
      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

   AUTHOR
   Hal Rosenstock
          < [email protected] >

                                                              PERFQUERY(8)

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.