opaextractlids(8)

🌸 opaextractlids — the IFSFFCLIRG manual page, but make it cute 💖

okay bestie, welcome to opaextractlids(8) 💅 this is a lil tool from the IFSFFCLIRG man page family, and honestly? she's a baddie. let's get into it.

✨ NAME ✨

opaextractlids

She produces a CSV file listing all or some of the LIDs in the fabric. No cap.

And the tea: opaextractlids is a front end to the opareport tool. The output from this tool can be imported into a spreadsheet or parsed by other scripts. it's giving "hand it off to your spreadsheet bestie" energy fr fr 📊✨

🦋 SYNTAX 🦋

opaextractlids [opareport  options]

🎀 OPTIONS 🎀

• --help — Produces full help text. she's helpful like that 🫶
• opareport options — The following options are passed to opareport. This subset is considered typical and useful for this command. And listen — by design, the tool ignores the -o/--output report option. not me being like "where's the output flag" 😭 she just ignores it. periodt.
  • -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. 👑 yes she eats from stdin too.
  • -F/--focus point — Specifies the focus area for report. Used for all reports except route to limit scope of report. Refer to Point Syntax for details.

🌈 the -h and -p options permit a variety of selections 🌈

this is the part where you mix and match, and it's honestly iconic:

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

💜 Point Syntax 💜

okay this is the big one, the main character section, the -F focus menu. every single one of these is a vibe. buckle up bestie 🧚

• gid:value — value is numeric port GID of form: subnet:guid.
• lid:value — value is numeric LID.
• lid:value:node — value is numeric LID, selects entire node with given LID.
• lid:value:port:value2 — value is numeric LID of node, value2 is port number.
• portguid:value — value is numeric port GUID.
• nodeguid:value — value is numeric node GUID.
• nodeguid:value1:port:value2 — value1 is numeric node GUID, value2 is port number.
• iocguid:value — value is numeric IOC GUID.
• iocguid:value1:port:value2 — value1 is numeric IOC GUID, value2 is port number.
• systemguid:value — value is numeric system image GUID.
• systemguid:value1:port:value2 — value1 is the numeric system image GUID, value2 is port number.
• ioc:value — value is IOC Profile ID String (IOC Name).
• ioc:value1:port:value2 — value1 is IOC Profile ID String (IOC Name), value2 is port number.
• iocpat:value — value is glob pattern for IOC Profile ID String (IOC Name).
• iocpat:value1:port:value2 — value1 is glob pattern for IOC Profile ID String (IOC Name), value2 is port number.
• ioctype:value — value is IOC type (SRP or OTHER).
• ioctype:value1:port:value2 — value1 is IOC type (SRP or OTHER); value2 is port number.
• node:value — value is node description (node name).
• node:value1:port:value2 — value1 is node description (node name), value2 is port number.
• nodepat:value — value is glob pattern for node description (node name).
• nodepat:value1:port:value2 — value1 is the glob pattern for the node description (node name), value2 is port number.
• nodedetpat:value — value is glob pattern for node details.
• nodedetpat:value1:port:value2 — value1 is the glob pattern for the node details, value2 is port number.
• nodetype:value — value is node type (SW or FI).
• nodetype:value1:port:value2 — value1 is node type (SW or FI), value2 is port number.
• rate:value — value is string for rate (25g, 50g, 75g, 100g), omits switch mgmt port 0.
• portstate:value — value is a string for state (down, init, armed, active, notactive, initarmed).
• portphysstate:value — value is a string for PHYs state (polling, disabled, training, linkup, recovery, offline, test)
• mtucap:value — value is MTU size (2048, 4096, 8192, 10240), omits switch mgmt port 0.
• labelpat:value — value is glob pattern for cable label.
• lengthpat:value — value is glob pattern for cable length.
• cabledetpat:value — value is glob pattern for cable details.
• cabinflenpat:value — value is glob pattern for cable info length.
• cabinfvendnamepat:value — value is glob pattern for cable info vendor name.
• cabinfvendpnpat:value — value is glob pattern for cable info vendor part number.
• cabinfvendrevpat:value — value is glob pattern for cable info vendor revision.
• cabinfvendsnpat:value — value is glob pattern for cable info vendor serial number.
• cabinftype:value — value is either optical, passive_copper, active_copper, or unknown.
• linkdetpat:value — value is glob pattern for link details.
• portdetpat:value — value is glob pattern for port details.
• sm — Specifies the master subnet manager (SM). 👑 the master. the moment.
• smdetpat:value — value is glob pattern for SM details.
• route:point1:point2 — Specifies all ports along the routes between the two given points.
• led:value — value is either on or off for LED port beacon. ✨ the lights, bestie
• linkqual:value — Specifies the ports with a link quality equal to value.
• linkqualLE:value — Specifies the ports with a link quality less than or equal to value.
• linkqualGE:value — Specifies the ports with a link quality greater than or equal to value.
• nodepatfile:FILENAME — Specifies the name of file with the list of nodepats or node descriptions.
• nodepairpatfile:FILENAME — Specifies the name of file with the list of node pairs, separated by a colon.
• ldr — Specifies the ports with a non-zero link down reason or neighbor link down reason.
• ldr:value — Specifies the ports with a link down reason or neighbor link down reason equal to value.

⭐ EXAMPLES ⭐

she's a demo girlie, let's go 🫶

# List all the lids in the fabric:

opaextractlids

# List all the lids of end-nodes:

opaextractlids -F "nodetype:FI"

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

opaextractlids -h 2

💀 reminder bestie: -o/--output is ignored by design. don't fight it. she's not gonna output where you tell her to. it's her whole thing.

🌸 also: -h 0 is the default, -p 0 is the default, and -X makes -s, -i, -C, and -a completely ignored. just so we're clear, no surprises, fr fr.

💖 the sign-off 💖

this page is opaextractlids(8) from the IFSFFCLIRG (Man Page) collection, and the copyright tea is: Copyright(C) 2015-2019 Intel Corporation. that's it, that's the whole legacy. ate and left no crumbs 🎀🦋✨

go forth and extract those LIDs, bestie. you got this. 💅🌈👑