Changeset View
Standalone View
share/man/man4/ocs_fc.4
- This file was added.
Property | Old Value | New Value |
---|---|---|
svn:eol-style | null | native \ No newline at end of property |
svn:keywords | null | FreeBSD=%H \ No newline at end of property |
svn:mime-type | null | text/plain \ No newline at end of property |
.\" Copyright (c) 2017 Broadcom. All rights reserved. | |||||
.\" The term "Broadcom" refers to Broadcom Limited and/or its subsidiaries. | |||||
.\" | |||||
.\" Redistribution and use in source and binary forms, with or without | |||||
.\" modification, are permitted provided that the following conditions are met: | |||||
.\" | |||||
.\" 1. Redistributions of source code must retain the above copyright notice, | |||||
.\" this list of conditions and the following disclaimer. | |||||
.\" | |||||
.\" 2. Redistributions in binary form must reproduce the above copyright notice, | |||||
.\" this list of conditions and the following disclaimer in the documentation | |||||
.\" and/or other materials provided with the distribution. | |||||
.\" | |||||
.\" 3. Neither the name of the copyright holder nor the names of its contributors | |||||
.\" may be used to endorse or promote products derived from this software | |||||
.\" without specific prior written permission. | |||||
.\" | |||||
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |||||
.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE | |||||
.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | |||||
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | |||||
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | |||||
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | |||||
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | |||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |||||
.\" POSSIBILITY OF SUCH DAMAGE. | |||||
.\" | |||||
.Dd November 10, 2017 | |||||
.Dt OCS_FC 4 | |||||
.Os | |||||
.Sh NAME | |||||
.Nm ocs_fc | |||||
.Nd Device driver for Emulex Fibre Channel Host Adapters | |||||
.Sh SYNOPSIS | |||||
To compile this driver into the kernel, | |||||
place the following lines in your | |||||
kernel configuration file: | |||||
.Bd -ragged -offset indent | |||||
.Cd "device ocs_fc" | |||||
.Ed | |||||
.Pp | |||||
Alternatively, to load the driver as a | |||||
module at boot time, place the following line in | |||||
.Xr loader.conf 5 : | |||||
.Bd -literal -offset indent | |||||
ocs_fc_load="YES" | |||||
wblock: This whole introductory section is the old style with halting and confusing wording. Please… | |||||
.Ed | |||||
.Sh DESCRIPTION | |||||
This driver provides access to FibreChannel SCSI devices. | |||||
wblockUnsubmitted Done Inline Actionss/FibreChannel/Fibre Channel/ wblock: s/FibreChannel/Fibre Channel/ | |||||
.Pp | |||||
The | |||||
.Nm | |||||
driver supports initiator and target modes. | |||||
Support is available for Arbitrated loops, Point-to-Point | |||||
wblockUnsubmitted Done Inline ActionsUse the serial comma: s/Point-to-Point/Point-to-Point,/ wblock: Use the serial comma: s/Point-to-Point/Point-to-Point,/ | |||||
and Fabric connections. | |||||
FC-Tape is highly recommended for connections to tape drives that support | |||||
it. | |||||
It encompasses four elements from the T-10 FCP-4 specification: | |||||
wblockUnsubmitted Done Inline ActionsNonspecific "It" here... probably means FC-Tape and would be clearer just saying that. Also, "encompasses" might be a technical term here, but would probably be clearer with just "includes": FC-Tape includes four elements from the T-10 FCP-4 specification: wblock: Nonspecific "It" here... probably means FC-Tape and would be clearer just saying that. Also… | |||||
.Bl -bullet -offset indent | |||||
.It | |||||
Precise Delivery of Commands | |||||
.It | |||||
Confirmed Completion of FCP I/O Operations | |||||
.It | |||||
Retransmission of Unsuccessfully Transmitted IUs | |||||
.It | |||||
Task Retry Identification | |||||
.El | |||||
.Pp | |||||
Together these features allow for link level error recovery with tape | |||||
devices. | |||||
Without it, an initiator cannot, for instance, tell whether a tape write | |||||
wblockUnsubmitted Done Inline ActionsAnother non-specific "it". Does this refer to "link level error recover"? wblock: Another non-specific "it". Does this refer to "link level error recover"? | |||||
command that has timed out resulted in all, part or none of the data going to | |||||
wblockUnsubmitted Done Inline ActionsUse the serial comma: s/part/part,/ wblock: Use the serial comma: s/part/part,/ | |||||
the tape drive. | |||||
FC-Tape is automatically enabled when connecting controller that supports | |||||
wblockUnsubmitted Done Inline ActionsToo many "it"s. FC-Tape is automatically enabled when both the controller and target support it." wblock: Too many "it"s.
```FC-Tape is automatically enabled when both the controller and target… | |||||
it to a target that supports it. | |||||
.Sh HARDWARE | |||||
The | |||||
.Nm | |||||
Driver supports the following FibreChannel adapters: | |||||
wblockUnsubmitted Done Inline Actionss/Driver/driver/ wblock: s/Driver/driver/
s/the following/these/
s/FibreChannel/Fibre Channel/ | |||||
.Bl -tag -width xxxxxx -offset indent | |||||
.It Emulex 16/8G FC GEN 5 HBAS | |||||
.Bd -literal -offset indent | |||||
LPe15004 FC Host Bus Adapters. | |||||
wblockUnsubmitted Done Inline ActionsThese would probably look better without the periods. wblock: These would probably look better without the periods. | |||||
LPe1600XX FC Host Bus Adapters. | |||||
.Ed | |||||
.It Emulex 16/8G FC GEN 6 HBAS | |||||
.Bd -literal -offset indent | |||||
LPe3100X FC Host Bus Adapters. | |||||
wblockUnsubmitted Done Inline ActionsAs above, periods are probably not needed. wblock: As above, periods are probably not needed. | |||||
LPe3200X FC Host Bus Adapters. | |||||
.Ed | |||||
.El | |||||
.Sh UPDATING FIRMWARE | |||||
Adapter firmware updates are persistent. | |||||
.Pp | |||||
Firmware can be updated by following the steps below: | |||||
wblockUnsubmitted Done Inline Actionss/the steps below/these steps/ wblock: s/the steps below/these steps/ | |||||
.Bl -enum | |||||
.It | |||||
Copy the below code to a Makefile: | |||||
wblockUnsubmitted Done Inline ActionsCopy this code to a .Pa Makefile : wblock: ```Copy this code to a
.Pa Makefile :``` | |||||
.Bd -literal -offset indent | |||||
KMOD=ocsflash | |||||
FIRMWS=imagename.grp:ocsflash | |||||
\&.include <bsd.kmod.mk> | |||||
.Ed | |||||
.It | |||||
Replace imagename in above with GRP file name | |||||
wblockUnsubmitted Done Inline ActionsReplace .Pa imagename with the name of the GRP file. wblock: ```Replace
.Pa imagename
with the name of the GRP file.``` | |||||
.It | |||||
Copy Makefile and GRP file to a directory | |||||
wblockUnsubmitted Done Inline ActionsCopy the .Pa Makefile and GRP file to a local directory wblock: ```Copy the
.Pa Makefile
and GRP file to a local directory``` | |||||
.It | |||||
Execute make & copy generated ocsflash.ko to | |||||
wblockUnsubmitted Done Inline ActionsExecute .Cm make and copy the generated .Pa ocsflash.ko file to wblock: ```Execute
.Cm make
and copy the generated
.Pa ocsflash.ko
file to``` | |||||
.Pa /lib/modules | |||||
.It | |||||
sysctl dev.ocs_fc.<N>.fw_upgrade=ocsflash | |||||
wblockUnsubmitted Done Inline ActionsI think this also needs .Cm wblock: I think this also needs .Cm | |||||
.It | |||||
Check kernel messages regarding status of the operation | |||||
.It | |||||
Reboot the machine | |||||
.El | |||||
.Pp | |||||
.Sh BOOT OPTIONS | |||||
The following options are switchable by setting values in | |||||
wblockUnsubmitted Done Inline ActionsOptions are controlled by setting values in wblock: ```Options are controlled by setting values in``` | |||||
.Pa /boot/device.hints . | |||||
.Pp | |||||
They are: | |||||
.Bl -tag -width indent | |||||
.It Va hint.ocs_fc.N.initiator | |||||
A hint value to disable or enable initiator functionality. | |||||
wblockUnsubmitted Done Inline ActionsThis type of thing is usually clearer to read when the items are just the description rather than a full sentence. For example, Enable initiator functionality. Default 1 (enabled), 0 to disable. It's not clear to me whether "hint" is necessary or useful. wblock: This type of thing is usually clearer to read when the items are just the description rather… | |||||
Default is 1 (enabled). Set to 0 to disable. | |||||
.It Va hint.ocs_fc.N.target | |||||
A hint value to disable or enable target functionality. | |||||
wblockUnsubmitted Done Inline ActionsEnable target functionality. Default 1 (enabled), 0 to disable. wblock: ```Enable target functionality.
Default 1 (enabled), 0 to disable.``` | |||||
Default is 1 (enabled). Set to 0 to disable. | |||||
.It Va hint.ocs_fc.N.topology | |||||
Configure Topology, 0-Auto; 1-NPort only; 2-Loop only. | |||||
wblockUnsubmitted Done Inline ActionsTopology: 0 for Auto, 1 for NPort only, 2 for Loop only. wblock: ```Topology: 0 for Auto, 1 for NPort only, 2 for Loop only.``` | |||||
.It Va hint.ocs_fc.N.speed | |||||
Sets the link speed. Value is in megabits per second. Possible values include: | |||||
wblockUnsubmitted Done Inline ActionsAs above, but also please start new sentences on new lines. Link speed in megabits per second. Possible values include: wblock: As above, but also please start new sentences on new lines.
```Link speed in megabits per… | |||||
0 Auto-speed negotiation (default), 4000 (4GFC), 8000 (8GFC), 16000 (16GFC) | |||||
wblockUnsubmitted Done Inline ActionsNeeds ending period. wblock: Needs ending period. | |||||
.El | |||||
.Sh SYSCTL OPTIONS | |||||
.Bl -tag -width indent | |||||
.It Va dev.ocs_fc.N.port_state | |||||
Read and configure port state. Valid values "online","offline". | |||||
wblockUnsubmitted Done Inline ActionsAs above: skip the introductory part to make it a sentence, and just give the description the reader is looking for anyway. Also, start sentences on new lines. Port state (read/write). Valid values are .Li online and .Li offline . wblock: As above: skip the introductory part to make it a sentence, and just give the description the… | |||||
.It Va dev.ocs_fc.N.wwpn | |||||
Read and configure World Wide Node Name value for this port. | |||||
wblockUnsubmitted Done Inline ActionsAs above. wblock: As above. | |||||
.It Va dev.ocs_fc.N.wwnn | |||||
Read and configure World Wide Node Name value for this port. | |||||
wblockUnsubmitted Done Inline ActionsAs above. wblock: As above. | |||||
.It Va dev.ocs_fc.N.fwrev | |||||
This is the readonly Firmware revision. | |||||
wblockUnsubmitted Done Inline ActionsFirmware revision (read-only). wblock: ```Firmware revision (read-only).``` | |||||
.It Va dev.ocs_fc.N.sn | |||||
This is the readonly Adapter serial number. | |||||
wblockUnsubmitted Done Inline ActionsAdapter serial number (read-only). wblock: ```Adapter serial number (read-only).``` | |||||
.It Va dev.ocs_fc.N.configured_speed | |||||
Configure Port Speed, 0-Auto, 2000, 4000, 8000, 16000, 32000 | |||||
wblockUnsubmitted Done Inline ActionsAs above. wblock: As above. | |||||
.It Va dev.ocs_fc.N.configured_topology | |||||
Configure Topology, 0-Auto; 1-NPort; 2-Loop | |||||
wblockUnsubmitted Done Inline ActionsAs above. wblock: As above. | |||||
.It Va dev.ocs_fc.N.current_speed | |||||
Current Port Speed. | |||||
wblockUnsubmitted Done Inline ActionsAs above. wblock: As above. | |||||
.It Va dev.ocs_fc.N.current_topology | |||||
Current Port Topology. | |||||
wblockUnsubmitted Done Inline ActionsAs above. wblock: As above. | |||||
.El | |||||
.Sh SUPPORT | |||||
For general information and support, | |||||
go to the Broadcom website at: | |||||
.Pa http://www.broadcom.com/ | |||||
or E-Mail at | |||||
.Pa ocs-driver-team.pdl@broadcom.com. | |||||
.Sh SEE ALSO | |||||
.Xr ifconfig 8 | |||||
.Sh AUTHORS | |||||
.An -nosplit | |||||
The | |||||
.Nm | |||||
driver was written by | |||||
.An Broadcom. |
This whole introductory section is the old style with halting and confusing wording. Please see https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/manpages-sample-structures.html#manpages-sample-structures-section-4 for a suggested newer style.