---
name: "opa_osd_query"
section: "1"
platform: "linux"
package: "opa-address-resolution"
version: "10.10.3.0.11-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/opa_osd_query"
---

# opa\_osd\_query(1)

## NAME

opa\_osd\_query

Queries the opasadb for path records. This tool allows you to create an arbitrary path query and view the result.

## Syntax

opa\_osd\_query \[-v \| -verbose\] \| \[-s \| --slid\] \| \[-d \| --dlid\] \| \[-S \|\
 \--sgid\] \| \[-D \| --dgid\]\| \[-k \| --pkey\] \| \[-i \| --sid\] \| \[-h \| --hfi\] \|\
 \[-p \| --port\]

## Options

**NOTE:**

- •

  All arguments are optional, but ill-formed queries can be expected to fail. You must provide at least a pair of LIDs or a pair of GIDs.

- •

  The mixing of lids and gids in a query is not permitted.

- •

  SID or PKey can be provided, but not both.

- •

  If you have multiple HFIs, the same LID can appear on more than one HFI, therefore you must specify which HFI to use when searching by LIDs.

- •

  Numbers can be in decimal, hex, or octal.

- \--help

  Produces full help text.

- \-v/--verbose *arg*

  Sets debugging level. Range is 1 - 7.

- \-s/--slid *arg*

  Specifies source LID.

- \-d/--dlid *arg*

  Specifies destination LID.

- \-S/--sgid *arg*

  Specifies source GID in GID format (0x00000000:0x00000000) or in Inet6 format (x:x:x:x:x:x:x:x).

- \-D/--dgid *arg*

  Specifies destination GID in GID format (0x00000000:0x00000000) or in Inet6 format (x:x:x:x:x:x:x:x).

- \-k/--pkey *arg*

  Specifies partition key.

- \-i/--sid *arg*

  Specifies service ID.

- \-h/--hfi *arg*

  Specifies the HFI to use. Default is first HFI. The HFI can be identified by name, for example, hfi1\_0 or by number, for example, 1, 2, 3, ... .

- \-p/--port *arg*

  Specifies the port to use. Default is first port.

## Example

opa\_osd\_query -s2 -d4