1 .\" Copyright (c) 2017 Broadcom. All rights reserved.
2 .\" The term "Broadcom" refers to Broadcom Limited and/or its subsidiaries.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions are met:
7 .\" 1. Redistributions of source code must retain the above copyright notice,
8 .\" this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright notice,
11 .\" this list of conditions and the following disclaimer in the documentation
12 .\" and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the copyright holder nor the names of its contributors
15 .\" may be used to endorse or promote products derived from this software
16 .\" without specific prior written permission.
18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 .\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22 .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 .\" POSSIBILITY OF SUCH DAMAGE.
37 .Nd "Device driver for Emulex Fibre Channel Host Adapters"
39 To compile this driver into the kernel, add this line to the
40 kernel configuration file:
41 .Bd -ragged -offset indent
45 To load the driver as a module at boot, add this line to
47 .Bd -literal -offset indent
53 driver provides access to Fibre Channel SCSI devices.
57 driver supports initiator and target modes.
58 Support is available for Arbitrated loops, Point-to-Point,
59 and Fabric connections.
60 FC-Tape is highly recommended for connections to tape drives that support
62 FC-Tape includes four elements from the T-10 FCP-4 specification:
63 .Bl -bullet -offset indent
65 Precise Delivery of Commands
67 Confirmed Completion of FCP I/O Operations
69 Retransmission of Unsuccessfully Transmitted IUs
71 Task Retry Identification
74 Together these features allow for link level error recovery with tape
76 Without link level error recovery, an initiator cannot, for instance, tell whether a tape write
77 command that has timed out resulted in all, part, or none of the data going to
79 FC-Tape is automatically enabled when both the controller and target support it.
84 driver supports these Fibre Channel adapters:
85 .Bl -tag -width xxxxxx -offset indent
86 .It Emulex 16/8G FC GEN 5 HBAS
87 .Bd -literal -offset indent
88 LPe15004 FC Host Bus Adapters
89 LPe160XX FC Host Bus Adapters
91 .It Emulex 32/16G FC GEN 6 HBAS
92 .Bd -literal -offset indent
93 LPe3100X FC Host Bus Adapters
94 LPe3200X FC Host Bus Adapters
98 Adapter firmware updates are persistent.
100 Firmware can be updated by following these steps:
105 .Bd -literal -offset indent
107 FIRMWS=imagename.grp:ocsflash
108 \&.include <bsd.kmod.mk>
113 with the name of the GRP file.
117 and GRP file to a local directory
121 and copy the generated
126 .Cm sysctl dev.ocs_fc.<N>.fw_upgrade=ocsflash
128 Check kernel messages regarding status of the operation
134 Options are controlled by setting values in
135 .Pa /boot/device.hints .
138 .Bl -tag -width indent
139 .It Va hint.ocs_fc.N.initiator
140 Enable initiator functionality.
141 Default 1 (enabled), 0 to disable.
142 .It Va hint.ocs_fc.N.target
143 Enable target functionality.
144 Default 1 (enabled), 0 to disable.
145 .It Va hint.ocs_fc.N.topology
146 Topology: 0 for Auto, 1 for NPort only, 2 for Loop only.
147 .It Va hint.ocs_fc.N.speed
148 Link speed in megabits per second.
149 Possible values include:
150 0 Auto-speed negotiation (default), 4000 (4GFC), 8000 (8GFC), 16000 (16GFC).
153 .Bl -tag -width indent
154 .It Va dev.ocs_fc.N.port_state
155 Port state (read/write).
160 .It Va dev.ocs_fc.N.wwpn
161 World Wide Port Name (read/write).
162 .It Va dev.ocs_fc.N.wwnn
163 World Wide Node Name (read/write).
164 .It Va dev.ocs_fc.N.fwrev
165 Firmware revision (read-only).
166 .It Va dev.ocs_fc.N.sn
167 Adapter serial number (read-only).
168 .It Va dev.ocs_fc.N.configured_speed
169 Configured Port Speed (read/write).
171 0 Auto-speed negotiation (default), 4000 (4GFC), 8000 (8GFC), 16000 (16GFC).
172 .It Va dev.ocs_fc.N.configured_topology
173 Configured Port Topology (read/write).
175 0-Auto; 1-NPort; 2-Loop.
176 .It Va dev.ocs_fc.N.current_speed
177 Current Port Speed (read-only).
178 .It Va dev.ocs_fc.N.current_topology
179 Current Port Topology (read-only).
182 For general information and support,
183 go to the Broadcom website at:
184 .Pa http://www.broadcom.com/
186 .Pa ocs-driver-team.pdl@broadcom.com.
193 driver was written by