1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
'\" t
.\" Title: fcrls
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\" Date: 02/06/2013
.\" Manual: Open-FCoE Tools
.\" Source: Open-FCoE
.\" Language: English
.\"
.TH "FCRLS" "8" "02/06/2013" "Open\-FCoE" "Open\-FCoE Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
fcrls \- Fibre Channel Read Link Error Status Block (RLS) tool
.SH "SYNOPSIS"
.sp
\fBfcrls\fR \-\-port \fIrport_bsg_name\fR [\-\-quiet]
.sp
\fBfcrls\fR \-\-fcid \fIrport_port_FC\-ID\fR [\-\-quiet]
.sp
\fBfcrls\fR \-\-help
.SH "DESCRIPTION"
.sp
The \fBfcrls\fR command performs Fibre Channel Read Link Error Status Block (RLS) ELS request (see FC\-LS\-2) via BSG over a given rport bsg name or FC\-ID\&.
.sp
\fBfcrls\fR takes either a rport bsg name or a rport port FC\-ID as the input\&. To disable verbose output, use the \fB\-\-quiet\fR option\&.
.SH "OPTIONS"
.PP
\fB\-\-port\fR \fIrport_bsg_name\fR
.RS 4
Send RLS to a rport by FC remote port bsg name, e\&.g\&., rport\-7:0\-1\&.
.RE
.PP
\fB\-\-fcid\fR \fIrport_port_FC\-ID\fR
.RS 4
Send RLS to a rport by port FC\-ID, e\&.g\&., 0xce000d\&.
.RE
.PP
\fB\-\-quiet\fR
.RS 4
Disable verbose output\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Display a help message with basic usage instructions\&.
.RE
.SH "EXAMPLES"
.sp
Sends RLS to the FC remote port as rport\-7:0\-1
.sp
.if n \{\
.RS 4
.\}
.nf
fcrls \-\-port rport\-7:0\-1
.fi
.if n \{\
.RE
.\}
.sp
Sends RLS to the FC remote port with 0xce000d as its port FC\-ID
.sp
.if n \{\
.RS 4
.\}
.nf
fcrls \-\-fcid 0xce000d
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.sp
\fBfcoeadm\fR(8)
.SH "SUPPORT"
.sp
\fBfcrls\fR is part of the \fIfcoe\-utils\fR package, maintained through the \fIOpen\-FCoE\fR project\&. Resources for both developers and users can be found at the \fIOpen\-FCoE\fR website http://open\-fcoe\&.org/\&.
|
