xref: /freebsd-src/share/man/man4/isci.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1f11c7f63SJim Harris.\"
2f11c7f63SJim Harris.\" Copyright (c) 2012 Intel Corporation
3f11c7f63SJim Harris.\" All rights reserved.
4f11c7f63SJim Harris.\"
5f11c7f63SJim Harris.\" Redistribution and use in source and binary forms, with or without
6f11c7f63SJim Harris.\" modification, are permitted provided that the following conditions
7f11c7f63SJim Harris.\" are met:
8f11c7f63SJim Harris.\" 1. Redistributions of source code must retain the above copyright
9f11c7f63SJim Harris.\"    notice, this list of conditions, and the following disclaimer,
10f11c7f63SJim Harris.\"    without modification.
11f11c7f63SJim Harris.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer
12f11c7f63SJim Harris.\"    substantially similar to the "NO WARRANTY" disclaimer below
13f11c7f63SJim Harris.\"    ("Disclaimer") and any redistribution must be conditioned upon
14f11c7f63SJim Harris.\"    including a substantially similar Disclaimer requirement for further
15f11c7f63SJim Harris.\"    binary redistribution.
16f11c7f63SJim Harris.\"
17f11c7f63SJim Harris.\" NO WARRANTY
18f11c7f63SJim Harris.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19f11c7f63SJim Harris.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20f11c7f63SJim Harris.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
21f11c7f63SJim Harris.\" A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22f11c7f63SJim Harris.\" HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23f11c7f63SJim Harris.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24f11c7f63SJim Harris.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25f11c7f63SJim Harris.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
26f11c7f63SJim Harris.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
27f11c7f63SJim Harris.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28f11c7f63SJim Harris.\" POSSIBILITY OF SUCH DAMAGES.
29f11c7f63SJim Harris.\"
30f11c7f63SJim Harris.\" isci driver man page.
31f11c7f63SJim Harris.\"
32f11c7f63SJim Harris.\" Author: Jim Harris <jimharris@FreeBSD.org>
33f11c7f63SJim Harris.\"
34f11c7f63SJim Harris.Dd January 23, 2012
35f11c7f63SJim Harris.Dt ISCI 4
36f11c7f63SJim Harris.Os
37f11c7f63SJim Harris.Sh NAME
38f11c7f63SJim Harris.Nm isci
39f11c7f63SJim Harris.Nd Intel C600 Serial Attached SCSI driver
40f11c7f63SJim Harris.Sh SYNOPSIS
41f11c7f63SJim HarrisTo compile this driver into your kernel,
42f11c7f63SJim Harrisplace the following lines in your kernel configuration file:
43f11c7f63SJim Harris.Bd -ragged -offset indent
44f11c7f63SJim Harris.Cd "device scbus"
45f11c7f63SJim Harris.Cd "device isci"
46f11c7f63SJim Harris.Ed
47f11c7f63SJim Harris.Pp
48f11c7f63SJim HarrisOr, to load the driver as a module at boot, place the following line in
49f11c7f63SJim Harris.Xr loader.conf 5 :
50f11c7f63SJim Harris.Bd -literal -offset indent
51f11c7f63SJim Harrisisci_load="YES"
52f11c7f63SJim Harris.Ed
530a503333SChristian Brueffer.Sh HARDWARE
54f11c7f63SJim HarrisThe
55f11c7f63SJim Harris.Nm
56f11c7f63SJim Harrisdriver provides support for Intel C600
57f11c7f63SJim Harris.Tn SAS
587aae843bSChristian Brueffercontrollers.
59f11c7f63SJim Harris.Sh CONFIGURATION
60f11c7f63SJim HarrisTo force legacy interrupts for all
61f11c7f63SJim Harris.Nm
62f11c7f63SJim Harrisdriver instances, set the following tunable value in
63f11c7f63SJim Harris.Xr loader.conf 5 :
64f11c7f63SJim Harris.Bd -literal -offset indent
65f11c7f63SJim Harrishw.isci.force_legacy_interrupts=1
66f11c7f63SJim Harris.Ed
67f11c7f63SJim Harris.Sh DEBUGGING
68f11c7f63SJim HarrisTo enable debugging prints from the
69f11c7f63SJim Harris.Nm
70f11c7f63SJim Harrisdriver, set the
71f11c7f63SJim Harris.Bd -literal -offset indent
72f11c7f63SJim Harrishw.isci.debug_level
73f11c7f63SJim Harris.Ed
74f11c7f63SJim Harris.Pp
75f11c7f63SJim Harrisvariable to a value between 1 and 4 in
76f11c7f63SJim Harris.Xr loader.conf 5 .
77f11c7f63SJim Harris.Pp
787aae843bSChristian BruefferThe hardware layer in the
797aae843bSChristian Brueffer.Nm
807aae843bSChristian Bruefferdriver has extensive logging capabilities
817aae843bSChristian Bruefferwhich are disabled by default for performance reasons.
827aae843bSChristian BruefferThese can be enabled by adding
83f11c7f63SJim Harris.Bd -literal -offset indent
84f11c7f63SJim Harrisoptions ISCI_LOGGING
85f11c7f63SJim Harris.Ed
86f11c7f63SJim Harris.Pp
87f11c7f63SJim Harristo the kernel configuration file.
88f11c7f63SJim Harris.Sh SEE ALSO
89f11c7f63SJim Harris.Xr cd 4 ,
90f11c7f63SJim Harris.Xr ch 4 ,
91f11c7f63SJim Harris.Xr da 4 ,
92f11c7f63SJim Harris.Xr pci 4 ,
93f11c7f63SJim Harris.Xr sa 4 ,
947aae843bSChristian Brueffer.Xr scsi 4
95f11c7f63SJim Harris.Sh HISTORY
96f11c7f63SJim HarrisThe
97f11c7f63SJim Harris.Nm
98f11c7f63SJim Harrisdriver first appeared in
9950d922a0SGlen Barber.Fx 8.3
10050d922a0SGlen Barberand 9.1.
101f11c7f63SJim Harris.Sh AUTHORS
102f11c7f63SJim Harris.An -nosplit
103f11c7f63SJim HarrisThe
104f11c7f63SJim Harris.Nm
105f11c7f63SJim Harrisdriver was developed by Intel and originally written by
106*6c899950SBaptiste Daroussin.An Jim Harris Aq Mt jimharris@FreeBSD.org
107*6c899950SBaptiste Daroussinwith contributions from
108*6c899950SBaptiste Daroussin.An Sohaib Ahsan
109*6c899950SBaptiste Daroussinand input from
110*6c899950SBaptiste Daroussin.An Scott Long Aq Mt scottl@FreeBSD.org .
111f11c7f63SJim Harris.Pp
112f11c7f63SJim HarrisThis man page was written by
113*6c899950SBaptiste Daroussin.An Jim Harris Aq Mt jimharris@FreeBSD.org .
114