saquery(8)                    Open IB Diagnostics                   saquery(8)

<?><?><?> (NAME)
       saquery - <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (SA) <?><?> InfiniBand

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       saquery [<?><?><?><?><?><?><?><?>] [<name> | <lid> | <guid>]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> saquery <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> SA <?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> (Node records) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

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

       -p     <?><?><?><?><?><?> <?><?><?><?><?><?><?> PathRecord

       -N     <?><?><?><?><?><?> <?><?><?><?><?><?><?> NodeRecord

       -D, --list
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> CA (NodeDescriptions)

       -S     <?><?><?><?><?><?> <?><?><?><?><?><?><?> ServiceRecord

       -I     <?><?><?><?><?><?> <?><?><?><?><?><?><?> InformInfoRecord
              (<?><?><?><?><?><?>)

       -L     <?><?><?><?><?><?><?><?><?><?> Lid<?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?>

       -l     <?><?><?><?><?><?><?><?><?><?> Lid <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>

       -G     <?><?><?><?><?><?><?><?><?><?> Guid<?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?>

       -O     <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              Lid <?><?><?><?><?><?><?><?>

       -U     <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              Guid <?><?><?><?><?><?><?><?>

       -c     <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> (class port) <?><?><?><?><?> <?><?> SA

       -s     <?><?><?><?><?><?><?><?><?><?> PortInfoRecord<?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?> isSM <?><?>
              isSMdisabled <?><?> <?><?><?><?><?> <?><?><?><?> (<?><?><?><?>)
              <?><?><?>

       -g     <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (multicast group)

       -m     <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> (multicast member). <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> GUID <?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?>. <?><?><?><?>: saquery -m 0xc000

       -x     <?><?><?><?><?><?> <?><?><?><?><?><?><?> LinkRecord

       --src-to-dst <src:dst>
              <?><?><?><?><?><?> <?><?> PathRecord <?><?><?><?> <src:dst>
              <?><?> <?><?> <?><?> src <?> dst <?><?><?><?><?><?><?> <?><?><?>
              <?><?> LID<?><?> <?><?><?><?><?>

       --sgid-to-dgid <sgid:dgid>
              <?><?><?><?><?><?> <?><?> PathRecord <?><?> sgid <?><?> dgid
              <?><?> <?><?> <?><?> <?><?> <?><?> GID <?><?> <?><?><?><?> IPv6
              <?><?><?><?> <?><?><?><?> <?><?><?><?> inet_pton (3)
              <?><?><?><?><?>

       --smkey <val>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> SM_Key <?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <<<?><?><?><?><?>>> ("trusted")
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?> 'x')
              <?><?><?><?> <?><?><?><?> saquery <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?> (<?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?> /etc/infiniband-diags/ibdiag.conf
              <?><?><?><?> <?><?><?><?> <?><?><?><?>) <?><?><?><?><?><?><?>
              <?><?> SM_Key == 0 (<?><?> <<<?><?><?><?><?><?><?>>>
              "untrusted") <?><?><?>.

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

       --slid <lid> <?><?><?><?><?> LID <?><?><?><?> (PathRecord)

       --dlid <lid> <?><?><?><?><?> LID <?><?><?><?> (PathRecord)

       --mlid <lid> <?><?><?><?><?> LID <?><?><?><?><?><?><?> (MCMemberRecord)

       --sgid <gid> <?><?><?><?><?> GID <?><?><?><?> (<?><?><?><?> IPv6)
       (PathRecord)

       --dgid <gid> <?><?><?><?><?> GID <?><?><?><?> (<?><?><?><?> IPv6)
       (PathRecord)

       --gid <gid> <?><?><?><?><?> GID <?><?><?><?><?> (MCMemberRecord)

       --mgid <gid> <?><?><?><?><?> GID <?><?><?><?><?><?><?> (MCMemberRecord)

       --reversible <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (PathRecord)

       --numb_path <?><?><?><?><?> <?><?><?><?><?><?> (PathRecord)

       --pkey <?><?><?><?><?> P_Key (<?><?> PathRecord <?> MCMemberRecord).
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?>
       'x')   <?><?><?><?> <?><?><?><?> saquery <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> P_Key <?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?> P_Key <?><?><?> <?><?><?><?>
              MAD <?><?><?><?><?><?><?> (<?><?><?><?><?><?> --pkey-idx <?><?>
              <?><?><?><?><?><?>).

       --qos_class <?><?><?> <?><?><?><?><?> <?><?><?><?><?> (QoS Class)
       (PathRecord)

       --sl <?><?><?> <?><?><?><?><?> (PathRecord, MCMemberRecord)

       --mtu <?><?><?><?><?> MTU <?> <?><?><?><?><?><?><?><?><?> (PathRecord,
       MCMemberRecord)

       --rate <?><?><?> <?> <?><?><?><?><?><?><?><?><?> (PathRecord,
       MCMemberRecord)

       --pkt_lifetime <?><?><?> <?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> (PathRecord, MCMemberRecord)

       --qkey <?><?><?><?><?> Q_Key (<?><?> MCMemberRecord). <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?> 'x')
       <?><?><?><?> <?><?><?>
              saquery <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>

       --tclass <?><?><?> <?><?><?><?><?><?> (Traffic Class) (PathRecord,
       MCMemberRecord)

       --flow_label <?><?><?><?><?> <?><?><?><?><?> (Flow Label) (PathRecord,
       MCMemberRecord)

       --hop_limit <?><?> <?><?><?> (Hop limit) (PathRecord, MCMemberRecord)

       --scope <?><?><?><?> (Scope) (MCMemberRecord)

       --join_state <?><?><?><?><?> <?><?><?><?><?><?> (Join state)
       (MCMemberRecord)

       --proxy_join <?><?><?><?><?><?> <?><?><?><?><?><?> (Proxy join)
       (MCMemberRecord)

       --service_id <?><?><?><?><?> <?><?><?><?><?> (ServiceID) (PathRecord)

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

          ClassPortInfo (CPI)
          NodeRecord (NR) [lid]
          PortInfoRecord (PIR) [[lid]/[port]/[options]]
          SL2VLTableRecord (SL2VL) [[lid]/[in_port]/[out_port]]
          PKeyTableRecord (PKTR) [[lid]/[port]/[block]]
          VLArbitrationTableRecord (VLAR) [[lid]/[port]/[block]]
          InformInfoRecord (IIR)
          LinkRecord (LR) [[from_lid]/[from_port]] [[to_lid]/[to_port]]
          ServiceRecord (SR)
          PathRecord (PR)
          MCMemberRecord (MCMR)
          LFTRecord (LFTR) [[lid]/[block]]
          MFTRecord (MFTR) [[mlid]/[position]/[block]]
          GUIDInfoRecord (GIR) [[lid]/[block]]
          SwitchInfoRecord (SWIR) [lid]
          SMInfoRecord (SMIR) [lid]

   <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (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                 # <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?> <?> <?><?> <?><?><?><?>)
             ibaddr -C mthca1       # <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> "mthca1".
             ibaddr -P 2            # <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> (active/up) <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> IB <?><?><?><?><?>.
             ibaddr -C mthca0 -P 2  # <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (Debugging flags)

       -d     <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              IB.  <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> (-ddd <?><?> -d -d -d).

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

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

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

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

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

       --outstanding_smps, -o <val>
              <?><?><?><?><?> <?><?><?><?><?> SMP<?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?>

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

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

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

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (COMMON 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"

<?><?><?><?><?><?><?><?><?><?> (DEPENDENCIES)
       OpenSM (<?><?> <?><?> SM/SA <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?>)<?> libosmcomp<?> libibumad<?> libibmad

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

       Ira Weiny
              < <ira.weiny@intel.com> >

       Hal Rosenstock
              < <halr@mellanox.com> >

                                  2017-08-21                        saquery(8)