=======

saquery

=======

-------------------------------------------------

query InfiniBand subnet administration attributes

-------------------------------------------------

:Date: @BUILD_DATE@

:Manual section: 8

:Manual group: Open IB Diagnostics

SYNOPSIS

========

saquery [options] [<name> | <lid> | <guid>]

DESCRIPTION

===========

saquery issues the selected SA query. Node records are queried by default.

OPTIONS

=======

**-p**

        get PathRecord info

**-N**

        get NodeRecord info

**-D, --list**

        get NodeDescriptions of CAs only

**-S**

        get ServiceRecord info

**-I**

        get InformInfoRecord (subscription) info

**-L**

        return the Lids of the name specified

**-l**

        return the unique Lid of the name specified

**-G**

        return the Guids of the name specified

**-O**

        return the name for the Lid specified

**-U**

        return the name for the Guid specified

**-c**

        get the SA's class port info

**-s**

        return the PortInfoRecords with isSM or isSMdisabled capability mask bit on

**-g**

        get multicast group info

**-m**

        get multicast member info.  If a group is specified, limit the output

        to the group specified and print one line containing only the GUID and

        node description for each entry. Example: saquery -m 0xc000

**-x**

        get LinkRecord info

**--src-to-dst <src:dst>**

        get a PathRecord for <src:dst>

        where src and dst are either node names or LIDs

**--sgid-to-dgid <sgid:dgid>**

        get a PathRecord for **sgid** to **dgid**

        where both GIDs are in an IPv6 format acceptable to **inet_pton (3)**

**--smkey <val>**

        use SM_Key value for the query. Will be used only with "trusted"

        queries.  If non-numeric value (like 'x') is specified then saquery

	will prompt for a value.

	Default (when not specified here or in

	@IBDIAG_CONFIG_PATH@/ibdiag.conf) is to use SM_Key == 0 (or

	\"untrusted\")

.. include:: common/opt_K.rst

**--slid <lid>** Source LID (PathRecord)

**--dlid <lid>** Destination LID (PathRecord)

**--mlid <lid>** Multicast LID (MCMemberRecord)

**--sgid <gid>** Source GID (IPv6 format) (PathRecord)

**--dgid <gid>** Destination GID (IPv6 format) (PathRecord)

**--gid <gid>** Port GID (MCMemberRecord)

**--mgid <gid>** Multicast GID (MCMemberRecord)

**--reversible** Reversible path (PathRecord)

**--numb_path** Number of paths (PathRecord)

**--pkey** P_Key (PathRecord, MCMemberRecord). If non-numeric value (like 'x')

        is specified then saquery will prompt for a value

**--qos_class** QoS Class (PathRecord)

**--sl** Service level (PathRecord, MCMemberRecord)

**--mtu** MTU and selector (PathRecord, MCMemberRecord)

**--rate** Rate and selector (PathRecord, MCMemberRecord)

**--pkt_lifetime** Packet lifetime and selector (PathRecord, MCMemberRecord)

**--qkey** Q_Key (MCMemberRecord). If non-numeric value (like 'x') is specified

        then saquery will prompt for a value

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

Supported query names (and aliases):

::

        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

--------------------

.. include:: common/opt_C.rst

.. include:: common/opt_P.rst

.. include:: common/sec_portselection.rst

Debugging flags

---------------

.. include:: common/opt_d.rst

.. include:: common/opt_e.rst

.. include:: common/opt_h.rst

.. include:: common/opt_v.rst

.. include:: common/opt_V.rst

Configuration flags

-------------------

.. include:: common/opt_t.rst

.. include:: common/opt_o-outstanding_smps.rst

.. include:: common/opt_node_name_map.rst

.. include:: common/opt_z-config.rst

COMMON FILES

============

.. include:: common/sec_config-file.rst

.. include:: common/sec_node-name-map.rst

DEPENDENCIES

============

OpenSM (or other running SM/SA), libosmcomp, libibumad, libibmad

AUTHORS

=======

Ira Weiny

        < ira.weiny@intel.com >

Hal Rosenstock

        < halr@mellanox.com >