ibroute(8)                    Open IB Diagnostics                   ibroute(8)

<?><?><?> (NAME)
       ibroute - <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ibroute [options] [<dest dr_path|lid|guid> [<startlid> [<endlid>]]]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> ibroute <?><?> <?><?><?><?><?><?><?><?> SMP
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       (<?><?><?><?><?><?><?> (LinearForwardingTable <?><?> LFT) <?><?>
       <?><?><?><?><?><?><?> (MulticastForwardingTable <?><?> MFT))
       <?><?><?><?> LID <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> lid (<?><?> mlid)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> 1...FDBTop <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)

       -a, --all
              <?><?><?><?><?> <?><?><?> lid<?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       -n, --no_dests
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?>.

       -M, --Multicast
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> mlid
              <?><?><?><?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (Addressing Flags)
       -D, --Direct     <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> (directed route) <?><?><?>

          Examples:
             [options] -D [options] "0"          # self port
             [options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...

             (Note the second number in the path specified must match the port being
             used.  This can be specified using the port selection flag '-P' or the
             port found through the automatic selection process.)

       -G, --Guid     <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> Port GUID
       <?><?><?>

       -L, --Lid   <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> LID <?><?><?>

       -s, --sm_port <smlid>     <?><?><?><?><?><?><?> <?><?> 'smlid' <?><?>
       <?><?><?><?><?> lid <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> SA.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (Port Selection
       flags)
       -C, --Ca <ca_name>    <?><?><?><?><?><?><?> <?><?> ca_name
       <?><?><?><?><?><?><?><?>.

       -P, --Port <ca_port>    <?><?><?><?><?><?><?> <?><?> ca_port
       <?><?><?><?><?><?><?><?>.

       -Y, --pkey-idx <idx>
              <?><?><?><?><?> <?><?><?><?> P_Key (<?><?><?><?><?> 0-65535<?>
              <?><?><?><?><?><?><?> 0) <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> SA/GMP MAD
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> SMP (<?><?><?><?>
              <?><?><?><?><?><?><?><?><?> SMI <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> LID) <?><?><?><?><?> <?><?>
              <?><?><?><?><?> P_Key <?><?><?><?><?> <?><?> 0
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

   <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (Local port Selection)
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>/<?><?><?><?><?> CA: <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> IB <?><?><?><?> <?><?><?><?>
       <?><?><?><?> (<?><?><?> <<<?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       umad>> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?>)<?>
       <?><?><?><?><?><?><?><?> libibumad <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>:

          1. <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> ACTIVE <?><?><?><?>.

          2. <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> UP <?><?><?><?>
             (<?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>).

          <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> CA <?><?><?><?> <?><?><?>
          <?><?><?><?><?> <?><?><?><?><?><?><?><?> libibumad <?><?><?><?>
          <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
          <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?> <?><?><?><?>
          <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

          <?><?> <?><?><?><?><?> <?><?><?><?>:

             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     <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              IB.  <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> (-ddd <?><?> -d -d -d).

       -e     <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?>).

       -h, --help      <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>

       -v, --verbose
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?> (-vv <?><?> -v -v -v).

       -V, --version     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (Configuration flags)
       -t, --timeout <timeout_ms> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> mad<?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

       -y, --m_key <key>
              <?><?><?><?><?><?><?> <?><?> M_key <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?> 'x')
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       --node-name-map <node-name-map> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?>.
          <?><?><?> <?><?><?><?> GUID<?><?> <?><?> <?><?>
          <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
          <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> FILES <?><?>
          <?><?><?><?><?><?>.

       --config, -z  <config_file> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
          <?><?><?><?><?><?><?>: /etc/infiniband-diags/ibdiag.conf

<?><?><?><?><?><?><?> (FILES)
   <?><?><?><?> <?><?><?><?><?><?><?><?> (CONFIG FILE)
       /etc/infiniband-diags/ibdiag.conf

       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.

   <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> (NODE NAME
       MAP FILE FORMAT)
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> GUID<?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> opensm-libs
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       opensm(8) <?><?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?> <?><?><?>:

          # comment
          <guid> "<name>"

       <?><?><?><?>:

          # IB1
          # Line cards
          0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
          0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
          0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
          0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
          0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"

          # Spines
          0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
          0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
          0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
          0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
          0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"

          # GUID   Node Name
          0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
          0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
          0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
          0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (Unicast)

          ibroute 4               # dump all lids with valid out ports of switch with lid 4
          ibroute -a 4            # same, but dump all lids, even with invalid out ports
          ibroute -n 4            # simple dump format - no destination resolution
          ibroute 4 10            # dump lids starting from 10 (up to FDBTop)
          ibroute 4 0x10 0x20     # dump lid range
          ibroute -G 0x08f1040023 # resolve switch by GUID
          ibroute -D 0,1          # resolve switch by direct path

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (Multicast)

          ibroute -M 4                # dump all non empty mlids of switch with lid 4
          ibroute -M 4 0xc010 0xc020  # same, but with range
          ibroute -M -n 4             # simple dump format

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       ibtracert(8)

<?><?><?><?><?><?><?><?><?> (AUTHORS)

       Hal Rosenstock
              < <halr@voltaire.com> >

                                  2017-08-21                        ibroute(8)