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

# opaextractlink(8)

## NAME

opaextractlink

Produces a CSV file listing all or some of the links in the fabric. opaextractlink is a front end to the opareport tool. The output from this tool can be imported into a spreadsheet or parsed by other scripts.

## Syntax

opaextractlink \[opareport  *options*\]

## Options

- \--help

  Produces full help text.

- opareport *options*

  The following options are passed to opareport. This subset is considered typical and useful for this command. By design, the tool ignores -o/--output report option.

  - \-h/--hfi *hfi*

    Specifies the HFI, numbered 1..n. Using 0 specifies that the -p *port* port is a system-wide port number. Default is 0.

  - \-p/--port *port*

    Specifies the port, numbered 1..n. Using 0 specifies the first active port. Default is 0.

  - \-X/--infile *snapshot\_input*

    Generates a report using the data in the snapshot\_input file. snapshot\_input must have been generated during a previous -o *snapshot* run. When used, the -s, -i, -C, and -a options are ignored. '-' may be used as the snapshot\_input to specify stdin.

  - \-T/--topology *topology\_input*

    Uses topology\_input file to augment and verify fabric information. When used, various reports can be augmented with information not available electronically (such as cable labels). '-' may be used to specify stdin.

## -h and -p options permit a variety of selections:

- \-h 0

  First active port in system (Default).

- \-h 0 -p 0

  First active port in system.

- \-h *x*

  First active port on HFI *x*.

- \-h *x* -p 0

  First active port on HFI *x*.

- \-h 0 -p *y*

  Port *y* within system (no matter which ports are active).

- \-h *x* -p *y*

  HFI *x*, port *y*.

## Examples

\# List all the links in the fabric:\

opaextractlink\

\# List all the links to a switch named "coresw1":\

opaextractlink -F "node:coresw1"\

\# List all the links to end-nodes:\

opaextractlink -F "nodetype:FI"\

\# List all the links on the 2nd HFI's fabric of a multi-plane fabric:\

opaextractlink -h 2