OS Manuals

/usr/bin/saquery

userspace components for the Linux Kernel's drivers/infiniband subsystem

From rdma-core 66.0-r0 (os), captured 2026-11-10 by running saquery --help (exit 2). permalink

Usage: /usr/bin/saquery [options] [query-name] [<name> | <lid> | <guid>]

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) [subscriber_gid]
  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]

  Queries node records by default.

Options:
  --p, -p                 get PathRecord info
  --N, -N                 get NodeRecord info
  --L, -L                 return the Lids of the name specified
  --l, -l                 return the unique Lid of the name specified
  --G, -G                 return the Guids of the name specified
  --O, -O                 return name for the Lid specified
  --U, -U                 return name for the Guid specified
  --s, -s                 return the PortInfoRecords with isSM or
                          isSMdisabled capability mask bit on
  --g, -g                 get multicast group info
  --m, -m                 get multicast member info (if multicast group
                          specified, list member GIDs only for group
                          specified, for example 'saquery -m 0xC000')
  --x, -x                 get LinkRecord info
  --c, -c                 get the SA's class port info
  --S, -S                 get ServiceRecord info
  --I, -I                 get InformInfoRecord (subscription) info
  --list, -D              the node desc of the CA's
  --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-dgid> where sgid
                              and dgid are addresses in IPv6 format
  --node-name-map <file>  specify a node name map file
  --smkey <val>           SA SM_Key value for the query. If non-numeric
                          value (like 'x') is specified then saquery will
                          prompt for a value.  Default (when not
                          specified here or in ibdiag.conf) is to  use
                          SM_Key == 0 (or "untrusted")
  --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, -r <val>  Reversible path (PathRecord)
  --numb_path, -n <val>   Number of paths (PathRecord)
  --pkey <val>            P_Key (PathRecord, MCMemberRecord). If
                          non-numeric value (like 'x') is specified then
                          saquery will prompt for a value
  --qos_class, -Q <val>   QoS Class (PathRecord)
  --sl <val>              Service level (PathRecord, MCMemberRecord)
  --mtu, -M <val>         MTU and selector (PathRecord, MCMemberRecord)
  --rate, -R <val>        Rate and selector (PathRecord, MCMemberRecord)
  --pkt_lifetime <val>    Packet lifetime and selector (PathRecord, MCMemberRecord)
  --qkey, -q <val>        Q_Key (MCMemberRecord). If non-numeric value
                          (like 'x') is specified then saquery will
                          prompt for a value
  --tclass, -T <val>      Traffic Class (PathRecord, MCMemberRecord)
  --flow_label, -F <val>  Flow Label (PathRecord, MCMemberRecord)
  --hop_limit, -H <val>   Hop limit (PathRecord, MCMemberRecord)
  --scope <val>           Scope (MCMemberRecord)
  --join_state, -J <val>  Join state (MCMemberRecord)
  --proxy_join, -X <val>  Proxy join (MCMemberRecord)
  --service_id <val>      ServiceID (PathRecord)
  --config, -z <config>   use config file, default: /etc/infiniband-diags/ibdiag.conf
  --Ca, -C <ca>           Ca name to use
  --Port, -P <port>       Ca port number to use
  --timeout, -t <ms>      timeout in ms
  --show_keys, -K         display security keys in output
  --pkey-idx, -Y <idx>    P_Key table index for outgoing SA/GMP MADs
                          (default 0)
  --errors, -e            show send and receive errors
  --verbose, -v           increase verbosity level
  --debug, -d             raise debug level
  --help, -h              help message
  --version, -V           show version
Options (53)
OptionDescriptionSource
--p, -pget PathRecord infohelp
--N, -Nget NodeRecord infohelp
--L, -Lreturn the Lids of the name specifiedhelp
--l, -lreturn the unique Lid of the name specifiedhelp
--G, -Greturn the Guids of the name specifiedhelp
--O, -Oreturn name for the Lid specifiedhelp
--U, -Ureturn name for the Guid specifiedhelp
--s, -sreturn the PortInfoRecords with isSM or isSMdisabled capability mask bit onhelp
--g, -gget multicast group infohelp
--m, -mget multicast member info (if multicast group specified, list member GIDs only for group specified, for example 'saquery -m 0xC000')help
--x, -xget LinkRecord infohelp
--c, -cget the SA's class port infohelp
--S, -Sget ServiceRecord infohelp
--I, -Iget InformInfoRecord (subscription) infohelp
--list, -Dthe node desc of the CA'shelp
--src-to-dst src:dstget a PathRecord for <src:dst> where src and dst are either node names or LIDshelp
--sgid-to-dgid sgid-dgidget a PathRecord for <sgid-dgid> where sgid and dgid are addresses in IPv6 formathelp
--node-name-map filespecify a node name map filehelp
--smkey valSA SM_Key value for the query.help
--slid lidSource LID (PathRecord)help
--dlid lidDestination LID (PathRecord)help
--mlid lidMulticast LID (MCMemberRecord)help
--sgid gidSource GID (IPv6 format) (PathRecord)help
--dgid gidDestination GID (IPv6 format) (PathRecord)help
--gid gidPort GID (MCMemberRecord)help
--mgid gidMulticast GID (MCMemberRecord)help
--reversible, -r valReversible path (PathRecord)help
--numb_path, -n valNumber of paths (PathRecord)help
--pkey valP_Key (PathRecord, MCMemberRecord).help
--qos_class, -Q valQoS Class (PathRecord)help
--sl valService level (PathRecord, MCMemberRecord)help
--mtu, -M valMTU and selector (PathRecord, MCMemberRecord)help
--rate, -R valRate and selector (PathRecord, MCMemberRecord)help
--pkt_lifetime valPacket lifetime and selector (PathRecord, MCMemberRecord)help
--qkey, -q valQ_Key (MCMemberRecord).help
--tclass, -T valTraffic Class (PathRecord, MCMemberRecord)help
--flow_label, -F valFlow Label (PathRecord, MCMemberRecord)help
--hop_limit, -H valHop limit (PathRecord, MCMemberRecord)help
--scope valScope (MCMemberRecord)help
--join_state, -J valJoin state (MCMemberRecord)help
--proxy_join, -X valProxy join (MCMemberRecord)help
--service_id valServiceID (PathRecord)help
--config, -z configuse config file, default: /etc/infiniband-diags/ibdiag.confhelp
--Ca, -C caCa name to usehelp
--Port, -P portCa port number to usehelp
--timeout, -t mstimeout in mshelp
--show_keys, -Kdisplay security keys in outputhelp
--pkey-idx, -Y idxP_Key table index for outgoing SA/GMP MADs (default 0)help
--errors, -eshow send and receive errorshelp
--verbose, -vincrease verbosity levelhelp
--debug, -draise debug levelhelp
--help, -hhelp messagehelp
--version, -Vshow versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.