View | Details | Raw Unified | Return to bug 159948
Collapse All | Expand All

(-)ata.4 (-25 / +31 lines)
Lines 74-120 Link Here
74 
atavia_load="YES"
 74 
atavia_load="YES"
75 
.Ed
 75 
.Ed
76 
.Pp
 76 
.Pp
77 
First line is common hardware independent code.
 77 
The first line is for common hardware independent code, and is a
78 
Next three lines are generic bus-specific drivers.
 78 
prerequisite for the other modules.
79 
ataahci is AHCI driver.
 79 
The next three lines are generic bus-specific drivers.
80 
The rest are vendor-specific PCI drivers.
 80 
Of the rest, ataahci is the AHCI driver.
81 
ATA_CAM option should always remain in kernel configuration to make
 81 
The others are vendor-specific PCI drivers.
82 
the driver work as CAM(4) subsystem module.
 82 
The ATA_CAM option should always remain in the kernel configuration, to make
83 
the driver work as a
84 
.Xr CAM 4
85 
subsystem module.
83 
.Pp
 86 
.Pp
84 
The following tunables are settable from the
 87 
The following tunables are settable from the
85 
.Xr loader 8 :
 88 
.Xr loader 8 :
86 
.Bl -ohang
 89 
.Bl -ohang
87 
.It Va hw.ata.ata_dma_check_80pin
 90 
.It Va hw.ata.ata_dma_check_80pin
88 
set to 0 to disable the 80pin cable check (default is 1, check the cable)
91 
set to 0 to disable the 80pin cable check (the default is 1, check the cable)
89 
.It Va hint.atapci.X.msi
 92 
.It Va hint.atapci.X.msi
90 
set to 1 to allow Message Signalled Interrupts (MSI) to be used by
 93 
set to 1 to allow Message Signalled Interrupts (MSI) to be used by the
91 
specified PCI ATA controller, if supported.
 94 
specified PCI ATA controller, if supported.
92 
.It Va hint.ata.X.devX.mode
 95 
.It Va hint.ata.X.devX.mode
93 
limits initial ATA mode for specified device on specified channel.
 96 
limits the initial ATA mode for the specified device on the specified channel.
94 
.It Va hint.ata.X.mode
 97 
.It Va hint.ata.X.mode
95 
limits initial ATA mode for every device on specified channel.
 98 
limits the initial ATA mode for every device on the specified channel.
96 
.It Va hint.ata.X.pm_level
 99 
.It Va hint.ata.X.pm_level
97 
controls SATA interface Power Management for specified channel,
 100 
controls SATA interface Power Management for the specified channel,
98 
allowing to save some power by the cost of additional command latency.
 101 
allowing some power savings at the cost of additional command latency.
99 
Possible values:
 102 
Possible values:
100 
.Bl -tag -compact
 103 
.Bl -tag -compact
101 
.It 0
 104 
.It 0
102 
interface Power Management is disabled, default value.
 105 
Interface Power Management is disabled.
106 
This is the default value.
103 
.It 1
 107 
.It 1
104 
device is allowed to initiate PM state change, host is passive.
 108 
The device is allowed to initiate a PM state change; the host is passive.
105 
.It 2
 109 
.It 2
106 
host initiates PARTIAL PM state transition every time port becomes idle.
 110 
The host initiates a PARTIAL PM state transition every time a port becomes idle.
107 
.It 3
 111 
.It 3
108 
host initiates SLUMBER PM state transition every time port becomes idle.
 112 
The host initiates a SLUMBER PM state transition every time a port becomes idle.
109 
.El
 113 
.El
110 
Modes 2 and 3 are supported only for AHCI.
 114 
Modes 2 and 3 are only supported for AHCI.
111 
.El
 115 
.El
112 
.Sh DESCRIPTION
 116 
.Sh DESCRIPTION
113 
The
 117 
The
114 
.Nm
 118 
.Nm
115 
driver provides the CAM(4) subsystem access to ATA (IDE) and SATA ports
 119 
driver gives the
120 
.Xr CAM 4
121 
subsystem access to the ATA (IDE) and SATA ports
116 
of many generic controllers.
 122 
of many generic controllers.
117 
Depending on controller, each PATA port or each one or two SATA ports are
 123 
Depending on the controller, each PATA (IDE)
124 
port or each one or two SATA ports are
118 
represented to CAM as a separate bus with one or two targets.
 125 
represented to CAM as a separate bus with one or two targets.
119 
Most of the bus-management details are handled by the ATA/SATA-specific
 126 
Most of the bus-management details are handled by the ATA/SATA-specific
120 
transport of CAM.
 127 
transport of CAM.
Lines 126-147 Link Here
126 
.Xr sa 4 ,
 133 
.Xr sa 4 ,
127 
etc.
 134 
etc.
128 
.Pp
 135 
.Pp
129 
Driver supports ATA and for the most of controllers ATAPI devices.
 136 
This driver supports ATA, and for the most controllers, ATAPI devices.
130 
Command queuing and SATA port multipliers are not supported.
 137 
Command queuing and SATA port multipliers are not supported.
131 
Device hot-plug and SATA interface power management supported only on
 138 
Device hot-plug and SATA interface power management is supported only on
132 
some controllers.
 139 
some controllers.
133 
.Pp
 140 
.Pp
134 
The
 141 
The
135 
.Nm
 142 
.Nm
136 
driver can change the transfer mode when the system is up and running.
 143 
driver can change the transfer mode when the system is up and running.
137 
See
 144 
See the negotiate subcommand of
138 
.Xr camcontrol 8
 145 
.Xr camcontrol 8 .
139 
negotiate subcommand.
140 
.Pp
 146 
.Pp
141 
The
 147 
The
142 
.Nm
 148 
.Nm
143 
driver sets the maximum transfer mode supported by the hardware as default.
 149 
driver sets the maximum transfer mode supported by the hardware as default.
144 
However the
 150 
However, the
145 
.Nm
 151 
.Nm
146 
driver sometimes warns:
 152 
driver sometimes warns:
147 
.Dq Sy "DMA limited to UDMA33, non-ATA66 cable or device".
 153 
.Dq Sy "DMA limited to UDMA33, non-ATA66 cable or device".

Return to bug 159948