smpquery(8)                   Open IB Diagnostics                  smpquery(8)

<?><?><?> (NAME)
       smpquery - <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (InfiniBand)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       smpquery [<?><?><?><?><?><?><?><?>] <op> <dest dr_path|lid|guid> [op
       params]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> smpquery <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> SMP <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>:
       <?><?><?><?><?><?><?> <?><?><?> (node info)<?> <?><?><?> <?><?><?>
       (node description)<?> <?><?><?><?><?><?><?> <?><?><?><?><?> (switch
       info) <?> <?><?><?><?><?><?><?> <?><?><?><?><?> (port info).
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

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

          Nodeinfo (NI) <addr>

          Nodedesc (ND) <addr>

          Portinfo (PI) <addr> [<portnum>]     # default port is zero

          PortInfoExtended (PIE) <addr> [<portnum>]

          Switchinfo (SI) <addr>

          PKeyTable (PKeys) <addr> [<portnum>]

          SL2VLTable (SL2VL) <addr> [<portnum>]

          VLArbitration (VLArb) <addr> [<portnum>]

          GUIDInfo (GI) <addr>

          MlnxExtPortInfo (MEPI) <addr> [<portnum>]  # default port is zero

       -c, --combined
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> (Combined route) <lid> <DR_Path>

       -x, --extended
              <?><?><?><?><?> <?><?><?> <?><?> SMSupportsExtendedSpeeds <?><?>
              AttributeModifier (<?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> PortInfo <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>).

       -K, --show_keys
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (mkey<?> smkey <?> <?><?><?><?>) <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?>.

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

          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) <?><?><?><?><?> <?><?>
              <?><?><?><?><?> 0 <?><?><?><?> P_Key <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

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

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

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

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

          smpquery portinfo 3 1                     # portinfo by lid, with port modifier
          smpquery -G switchinfo 0x2C9000100D051 1  # switchinfo by guid
          smpquery -D nodeinfo 0                    # nodeinfo by direct route
          smpquery -c nodeinfo 6 0,12               # nodeinfo by combined route

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

<?><?><?><?><?><?><?> (AUTHOR)

       Hal Rosenstock
              < <hal@mellanox.com> >

                                  2017-08-21                       smpquery(8)