.\" .\" *********************************************************************
.\" .\" *                                                                   *
.\" .\" *             Copyright 2015-2019, Intel Corporation                *
.\" .\" *                                                                   *
.\" .\" *                       All Rights Reserved.                        *
.\" .\" *                                                                   *
.\" .\" *********************************************************************

.TH opaledports 8 "Intel Corporation" "Copyright(C) 2015\-2019" "IFSFFCLIRG (Man Page)"
.SH NAME
opaledports


.PP
Toggles the beaconing LED state of HFIs, switches, and switch ports. opaledports is a useful aid for finding specific physical nodes in a crowded data center. It supports the CSV link format provided by opaextractsellinks.
.SH Syntax
opaledports [-h hfi] [-p port] [-C] [-s|-d] [on|off] < portlist.csv
.SH Options

.TP 10
--help

Produces full help text.

.TP 10
-h \fIhfi\fR

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

.TP 10
-p \fIport\fR

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

.TP 10
-C

Clears beaconing LED on all ports.

.IP

\fBNOTE:\fR
If -C is entered, no other options are valid.
.TP 10
-s

Affects source side (first node) of link only.

.TP 10
-d

Affects destination side (second node) of link only.

.TP 10
on|off

Turns on or off the beaconing LED. Options include:

.RS
.TP 10

.sp
on
Turns on beaconing LED.

.RE

.RS
.TP 10

.sp
off
Turns off beaconing LED.

.RE

.TP 10
portlist.csv

Specifies the file listing the links to process. The list is of the form:

.IP
NodeGUID;PortNum;NodeType;NodeDesc;NodeGUID;PortNum;
.br
NodeType;NodeDesc;Dontcare
.SH Examples
echo "0x001175010165ac1d;1;FI;phkpstl035 hfi1\(ul0"|opaledports on
.br

opaledports on < portlist.csv
.br

opaextractsellinks -F led:on | opaledports off
.br

opaledports -C