ibqueryerrors (1m)

Name

Synopsis

ibqueryerrors  [-s  <err1,err2,...>  -c  -r  -C <ca_name> -P
<ca_port>  -G  <node_guid>  -D  <direct_route>  -d   -k   -K
--load-cache <filename>]

Description

OpenIB Diagnostics                              IBQUERYERRORS(1m)



NAME
     ibqueryerrors - query and report non-zero IB port counters


SYNOPSIS
     ibqueryerrors  [-s  <err1,err2,...>  -c  -r  -C <ca_name> -P
     <ca_port>  -G  <node_guid>  -D  <direct_route>  -d   -k   -K
     --load-cache <filename>]


DESCRIPTION
     ibqueryerrors  reports  port  counters.   This is similar to
     ibcheckerrors with the  additional  ability  to  filter  out
     selected  errors,  include the optional transmit and receive
     data counters, and report full link information for the link
     reported.


OPTIONS
     -s <err1,err2,...>
          Suppress  the errors listed in the comma separated list
          provided.

     -c   Suppress some of the  common  "side  effect"  counters.
          These  counters usually do not indicate an error condi-
          tion and can be usually be safely ignored.

     -G <node_guid>
          Report results only for the node guid specified.

     -S <node_guid>
          -S is provided  only  for  backward  compatibility  and
          works the same as "-G"

     -D <direct_route>
          Report  results  only  for  the switch specified by the
          direct route path.

     -r   Report the port information.  This includes LID,  port,
          external  port  (if  applicable),  link  speed setting,
          remote GUID, remote  port,  remote  external  port  (if
          applicable), and remote node description information.

     --data
          Include  the  optional  transmit and receive data coun-
          ters.

     --switch  print data for switches only

     --ca  print data for CA's only

     --router  print data for routers only



OpenIB              Last change: Dec 31, 2009                   1






OpenIB Diagnostics                              IBQUERYERRORS(1m)



     --clear-errors -k Clear error counters after read.
          -k and -K can be used together to clear both errors and
          counters.

     --clear-counts -K Clear data counters after read.
          CAUTION clearing data counters will occur regardless of
          if they are printed or not.  This is because data coun-
          ters are only printed on ports which have errors.  This
          means if a port has 0 errors and the -K option is spec-
          ified  the  data  counters  will be cleared without any
          printed output.

     --details include receive error and transmit discard details

     --load-cache <filename>
          Load  and  use  the cached ibnetdiscover data stored in
          the specified filename.  May be useful  for  outputting
          and learning about other fabrics or a previous state of
          a fabric.  Cannot be used if user specifies  a  directo
          route  path.   See  ibnetdiscover  for  information  on
          caching ibnetdiscover output.

     -R  (This option is obsolete and does nothing)


COMMON OPTIONS
     -d      raise the IB debugging level.       May be used sev-
     eral times (-ddd or -d -d -d).

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

     -h      show the usage message

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

     -V      show the version info.

     # Other common flags:

     -C <ca_name>    use the specified ca_name.

     -P <ca_port>    use the specified ca_port.

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



AUTHOR
     Ira Weiny
          <weiny2@llnl.gov>



OpenIB              Last change: Dec 31, 2009                   2






OpenIB Diagnostics                              IBQUERYERRORS(1m)



ATTRIBUTES
     See   attributes(5)   for   descriptions  of  the  following
     attributes:

     +---------------+----------------------+
     |ATTRIBUTE TYPE |   ATTRIBUTE VALUE    |
     +---------------+----------------------+
     |Availability   | network/open-fabrics |
     +---------------+----------------------+
     |Stability      | Volatile             |
     +---------------+----------------------+
NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community source was downloaded from   ['http://www.openfab-
     rics.org/downloads/ibutils/ibutils-1.5.7.tar.gz',
     'http://www.openfabrics.org/downloads/libibverbs/libib-
     verbs-1.1.4-1.22.g7257cd3.tar.gz',      'http://www.openfab-
     rics.org/down-
     loads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz',
     'http://www.openfabrics.org/downloads/libsdp/lib-
     sdp-1.1.108-0.15.gd7fdb72.tar.gz',      'http://www.openfab-
     rics.org/downloads/management/infiniband-
     diags-1.5.8.tar.gz',       'http://www.openfabrics.org/down-
     loads/management/libibmad-1.3.7.tar.gz',   'http://www.open-
     fabrics.org/downloads/management/libibumad-1.3.7.tar.gz',
     'http://www.openfabrics.org/downloads/manage-
     ment/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/down-
     loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz',
     'http://www.openfabrics.org/down-
     loads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz',
     'http://www.openfabrics.org/downloads/rdmacm/librd-
     macm-1.0.14.1.tar.gz',     'http://www.openfabrics.org/down-
     loads/rds-tools/rds-tools-2.0.4.tar.gz']

     Further  information about this software can be found on the
     open  source  community   website   at   http://www.openfab-
     rics.org/.

















OpenIB              Last change: Dec 31, 2009                   3