ahci/sili.4 - Document sysctl nodes & loader tunables
[dragonfly.git] / share / man / man4 / sili.4
CommitLineData
95f9378d
SW
1.\" $OpenBSD: sili.4,v 1.3 2007/05/31 19:19:52 jmc Exp $
2.\"
3.\" Copyright (c) 2007 David Gwynne <dlg@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" TORTIOUS ACTION, ARISING OUT OF
15.\" PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd June 23, 2009
18.Dt SILI 4
19.Os
20.Sh NAME
21.Nm sili
d856dabc 22.Nd Silicon Image 3124/3132 SATA controller
95f9378d
SW
23.Sh SYNOPSIS
24To compile this driver into the kernel,
25place the following line in your
26kernel configuration file:
27.Bd -ragged -offset indent
28.Cd "device sili"
29.Ed
30.Pp
31Alternatively, to load the driver as a
32module at boot time, place the following line in
33.Xr loader.conf 5 :
34.Bd -literal -offset indent
35sili_load="YES"
36.Ed
37.Sh DESCRIPTION
38The
39.Nm
40driver provides support for SATA controllers using the Silicon Image
d856dabc 413124/3132 SATALink chipsets.
95f9378d
SW
42.Pp
43Although
44.Nm
45controllers are actual ATA controllers, the driver emulates SCSI via a
46translation layer.
d856dabc
TN
47.Sh LOADER TUNABLES
48The following hints may be set in
49.Xr loader.conf 5
50to control the
51.Nm
52driver's behavior.
53Note that the hint need only exist, so removing it requires commenting it out.
54.Pp
55Usually both the
56.Xr nata 4
57and the
58.Nm
59drivers are loaded.
60The
61.Xr nata 4
62driver will pick up any ata-like devices which the
63.Nm
64driver misses.
65If the
66.Nm
67driver is disabled the
68.Xr nata 4
69driver will typically pick up the
70.Nm
71devices, albeit under the
72.Pa ad
73disk name rather than the
74.Pa da
75disk name.
76.Bd -literal -offset indent
77hint.sili.disabled=1
78.Ed
79.Pp
80The
81.Nm
82driver can be told to force a lower-speed 1.5Gb link speed
83if necessary, and can also be told to refrain from attempting to send
84certain higher-level ATA commands to initialize ATA features which
85some devices might not properly implement.
86.Bd -literal -offset indent
87hint.sili.force150=1
88hint.sili.nofeatures=1
89.Ed
95f9378d
SW
90.Sh SEE ALSO
91.Xr ahci 4 ,
92.Xr intro 4 ,
93.Xr nata 4 ,
94.Xr pci 4 ,
95.Xr scsi 4 ,
96.Xr loader.conf 5
97.Sh HISTORY
98The
99.Nm
100driver first appeared in
101.Dx 2.3 .
102.Sh AUTHORS
103.An -nosplit
104The
105.Nm
106driver was originally written by
107.An David Gwynne Aq dlg@openbsd.org
108and
109.An Christopher Pascoe Aq pascoe@openbsd.org
110for
111.Ox .
112.Pp
113It was ported to
114.Dx
115by
d856dabc
TN
116.An Matt Dillon Aq dillon@apollo.backplane.com
117who added new features such as hot-plug and port multiplier support.