ibprintswitch(8) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| OPTIONS \| AUTHORS \| COLOPHON

IBPRINTSWITCH(8)            OpenIB Diagnostics           IBPRINTSWITCH(8)

NAME top

       ibprintswitch.pl - print either the switch specified or a list of
       switches from the ibnetdiscover output

SYNOPSIS top

       ibprintswitch.pl [-R -l -C <ca_name> -P <ca_port>]
       [<switch_guid|switch_name>]

DESCRIPTION top

       Faster than greping/viewing with an editor the output of
       ibnetdiscover, ibprintswitch.pl will parse out and print either
       the switch information for the switch specified or a list of all
       the switches found in the subnet.  In addition, it will crudely
       parse on the node description information and if found report all
       the information for an entire chasis if the description
       information is consistent.

       Finally, ibprintswitch.pl will also reuse the cached ibnetdiscover
       output from some of the other diag tools which makes it a bit
       faster than running ibnetdiscover from scratch.

OPTIONS top

       -l     List the switches (simply a wrapper for ibswitches).

       -R     Recalculate the ibnetdiscover information, ie do not use
              the cached information.  This option is slower but should
              be used if the diag tools have not been used for some time
              or if there are other reasons to believe that the fabric
              has changed.

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

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

AUTHORS top

       Ira Weiny
              <weiny2@llnl.gov>

       Hal Rosenstock
              <halr@voltaire.com>

COLOPHON top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

OpenIB                         May 31, 2007              IBPRINTSWITCH(8)