SAQUERY(8)

NAME
saquery - query InfiniBand subnet administration attributes

SYNOPSIS
saquery [-h] [-d] [-p] [-N] [--list | -D] [-S] [-I] [-L] [-l] [-G] [-O] [-U] [-c] [-s] [-g] [-m] [-x] [-C ca_name] [-P ca_port] [--smkey val] [-t(imeout) <msec>] [--src-to-dst <src:dst>] [--sgid-to-dgid <sgid-dgid>] [--node-name-map <node-name-map>] [<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

--list | -D
    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
    get a PathRecord for <src:dst> where src and dst are either node names or LIDs

--sgid-to-dgid
    get a PathRecord for sgid to dgid where both GIDs are in an IPv6 format acceptable to inet_pton(3).

-C <ca_name>
    use the specified ca_name.

-P <ca_port>
    use the specified ca_port.

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

-t, -timeout <msec>
    Specify SA query response timeout in milliseconds. Default is 100 milliseconds. You may want to use this option if IB_TIMEOUT is indicated.

--node-name-map <node-name-map>
    Specify a node name map. The node name map file maps GUIDs to more user friendly names. See ibnetdiscover(8) for node name map file format. Only used with the -O and -U options.

Supported query names (and aliases):
     ClassPortInfo (CPI)
     NodeRecord (NR)
     PortInfoRecord (PIR) [[lid]/[port]]
     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]]

-d  enable debugging

-h  show help

AUTHORS

Ira Weiny
    <weiny2@llnl.gov>

Hal Rosenstock
    <halr@voltaire.com>