xref: /dragonfly/share/man/man4/sili.4 (revision 678e8cc6)
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
22.Nd Silicon Image 3124/3132 SATA controller
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
413124/3132 SATALink chipsets. Both 3124-1 (1.5 Gbps) and 3124-2 (3 Gbps)
42versions of the 3124 chip are supported.
43.Pp
44Although
45.Nm
46controllers are actual ATA controllers, the driver emulates SCSI via a
47translation layer.
48.Sh LOADER TUNABLES
49The following hints may be set in
50.Xr loader.conf 5
51to control the
52.Nm
53driver's behavior.
54Note that the hint need only exist, so removing it requires commenting it out.
55.Pp
56Usually both the
57.Xr nata 4
58and the
59.Nm
60drivers are loaded.
61The
62.Xr nata 4
63driver will pick up any ata-like devices which the
64.Nm
65driver misses.
66If the
67.Nm
68driver is disabled the
69.Xr nata 4
70driver will typically pick up the
71.Nm
72devices, albeit under the
73.Pa ad
74disk name rather than the
75.Pa da
76disk name.
77.Bd -literal -offset indent
78hint.sili.disabled=1
79.Ed
80.Pp
81The
82.Nm
83driver can be told to force a lower-speed 1.5Gb link speed
84if necessary, and can also be told to refrain from attempting to send
85certain higher-level ATA commands to initialize ATA features which
86some devices might not properly implement.
87.Bd -literal -offset indent
88hint.sili.force150=1
89hint.sili.nofeatures=1
90.Ed
91.Sh SEE ALSO
92.Xr ahci 4 ,
93.Xr intro 4 ,
94.Xr nata 4 ,
95.Xr pci 4 ,
96.Xr scsi 4 ,
97.Xr loader.conf 5
98.Sh HISTORY
99The
100.Nm
101driver first appeared in
102.Dx 2.3 .
103.Sh AUTHORS
104.An -nosplit
105The
106.Nm
107driver was originally written by
108.An David Gwynne Aq dlg@openbsd.org
109and
110.An Christopher Pascoe Aq pascoe@openbsd.org
111for
112.Ox .
113.Pp
114It was ported to
115.Dx
116by
117.An Matt Dillon Aq dillon@apollo.backplane.com
118who added new features such as hot-plug and port multiplier support.
119