# 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