iblinkinfo (1m)

Name

iblinkinfo - report link info for all links in the fabric

Synopsis

iblinkinfo
[-hcdl  -C  <ca_name> -P <ca_port> -v <lt,hoq,vlstall> -S
<guid> -D <direct_route> --load-cache <filename>]

Description

OpenIB Diagnostics                                 IBLINKINFO(1m)



NAME
     iblinkinfo - report link info for all links in the fabric


SYNOPSIS
     iblinkinfo
        [-hcdl  -C  <ca_name> -P <ca_port> -v <lt,hoq,vlstall> -S
     <guid> -D <direct_route> --load-cache <filename>]


DESCRIPTION
     iblinkinfo reports the link  info  for  each  port  of  each
     switch active in the IB fabric.


OPTIONS
     -S <guid>
          Output only the switch specified by <guid> (hex format)

     -D <direct_route>
          Output only the switch specified by  the  direct  route
          path.

     -l   Print  all  information  for  each  link  on  one line.
          Default is to print a header with the  switch  informa-
          tion and then a list for each port (useful for grep'ing
          output).

     -d   Print only switches which have a  port  in  the  "Down"
          state.

     -v <lt,hoq,vlstall>
          Verify     additional     switch    settings    (<Life-
          Time>,<HoqLife>,<VLStallCount>)

     -c   Print port capabilities (enabled and supported values)

     -C <ca_name>    use the specified ca_name for the search.

     -P <ca_port>    use the specified ca_port for the search.

     -R (This option is obsolete and does nothing)

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

     --diff <filename>



OpenIB              Last change: Jan 24, 2008                   1






OpenIB Diagnostics                                 IBLINKINFO(1m)



          Load cached ibnetdiscover data and do a diff comparison
          to the current network or  another  cache.   A  special
          diff  output  for  iblinkinfo  output will be displayed
          showing differences between the old and current  fabric
          links.  Be default, the following are compared for dif-
          ferences: port connections and port state.  See  ibnet-
          discover  for information on caching ibnetdiscover out-
          put.

     --diffcheck <key(s)>
          Specify what diff checks should be done in  the  --diff
          option  above.   Comma  separate  multiple  diff  check
          key(s).  The available diff checks are:port = port con-
          nections,  state  =  port state, lid = lids, nodedesc =
          node descriptions.  If port is specified alongside  lid
          or  nodedesc,  remote  port  lids and node descriptions
          will also be compared.

     --filterdownports <filename>
          Filter downports indicated in  a  ibnetdiscover  cache.
          If a port was previously indicated as down in the spec-
          ified cache, and is still down, do not output it in the
          resulting output.  This option may be particularly use-
          ful for environments where switches are not fully popu-
          lated, thus much of the default iblinkinfo info is con-
          sidered unuseful.  See ibnetdiscover for information on
          caching ibnetdiscover output.


AUTHOR
     Ira Weiny
          <weiny2@llnl.gov>



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-



OpenIB              Last change: Jan 24, 2008                   2






OpenIB Diagnostics                                 IBLINKINFO(1m)



     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: Jan 24, 2008                   3