Manual Pages for UNIX Operating System command usage for man uata
Devices uata(7D)
NAME
uata - IDE Host Bus Adapter Driver
SYNOPSIS
ide@unit-address
DESCRIPTION
The uata host bus adapter driver is a nexus driver that sup-
ports the ide interface on SPARC platforms. The driver
attempts to set the disk and ATAPI CD-ROM drive to maximum
supported speed. The uata driver supports ultra DMA mode-4
(ATA66).
Currently, the uata driver supports the CMD646U, Sil680a and
Acer Southbridge M5229 IDE controllers. The uata driver sup-
ports two channels concurrently with two devices connected
per channel. The devices are logically numbered from 0 to
3:
0 Master disk on primary channel.
1 Slave disk on primary channel.
2 Master disk on secondary channel.
3 Slave disk on secondary channel.
For ATAPI devices, an ATAPI DRIVE RESET command is issued to
facilitate recovery from timeouts and errors. The BSY bit of
the drive's status register is polled to check for the drive
reset completion. If the drive reset fails, a warning mes-
sage is displayed and the recovery process continues. This
logic is subject to change.
To control the maximum time spent waiting for the ATAPI
drive reset to complete, the atapi-device-reset-waittime
tunable property is available through the
/kernel/drv/uata.conf file. The default and maximum/minimum
values are shown below. Please see /kernel/drv/uata.conf for
more info.
Default value: 3000000
Minimum value: 20
Maximum value: 3000000
SunOS 5.11 Last change: 20 April 2005 1
Devices uata(7D)
The atapi-device-reset-waittime property units are in
microseconds.
FILES
/kernel/drv/uata 32-bit ELF kernel module.
/kernel/drv/uata.conf Driver configuration file.
SEE ALSO
prtconf(1M), driver.conf(4), attributes(5)
Writing Device Drivers
X3T10 ATA-4 specifications
DIAGNOSTICS
In addition to being logged, the following messages may
appear on the system console:
ddi_get_iblock_cookie failed.
The driver could not obtain the interrupt cookie. The
attach may fail.
Drive not ready before set_features.
Indicates a fatal problem. The drives are not ready to
be programmed and features cannot be set. (During the
driver initialization process, the driver must set the
features for the drive, including dma and pio).
Error set after issuing Set Feature command.
Indicates a fatal problem. The driver's error bit was
set after the set feature command was issued. (During
the driver initialization process, the driver must set
the features for the drive, including dma and pio).
Interrupt not seen after set_features.
Indicates a fatal problem with the drive. Features can-
not be set.
SunOS 5.11 Last change: 20 April 2005 2
Devices uata(7D)
ata_controller - set features failed.
Indicates a fatal problem with the drive. Features can-
not be set.
? target lun 0.
Displayed at boot up time to indicate that the target
was identified, where is a decimal
value.
resid
Residual number of bytes in data transfer and the I/O
operation could not be finished completely.
ghd_timer_newstate: HBA reset failed.
Generally indicates a fatal condition. I/O operation
cannot be completed following reset of the channel.
timeout: chno = target=.
A timeout occured because of on device
(target=) on channel (chno = could be either early abort, early timeout,
abort request, abort device, reset target or reset bus.
ata_controller - Drive not ready before command .
The drive did not respond before issuing the command
to the controller; command will not be
issued to the drive. ( is the hexadecimal opcode
for the sleep or standby commands, which are issued when
the drive transitions between power management states).
ATAPI drive reset failed for target: ;Continuing the
recovery process.
If this message is displayed after you modify
/kernel/drv/uata.conf, try to increase the atapi-
device-reset-waittime property value within the maximum
value allowed, otherwise contact Sun support.
SunOS 5.11 Last change: 20 April 2005 3
Devices uata(7D)
ata_controller - Command failed.
Command failed on the drive. ( is the
hexadecimal opcode for the sleep or standby commands,
which are issued when the drive transitions between
power management states).
ata_controller - Command returned error.
The command returned an error. ( is the hexade-
cimal opcode for the sleep or standby commands, which
are issued when the drive transitions between power
management states).
ata_controller - Cannot take drive to sleep.
The disk will not transition to sleep state. (Indicates
that the driver could not set the device to sleep mode
while performing power management functions).
ata_controller - Cannot reset secondary/primary channel.
The disk will not transition from sleep to active state.
ata_controller - Unsupported Controller Vendor 0x13d0, Dev-
ice 0x43f1, Revision 0x034.
An unsupported ata controller was found on the system
and prints , device id and revision of the con-
troller, where represents the hexidecimal vendor
ID.
Changing the mode of targ: to Ultra DMA mode:
.
For the timedout command, the driver attempts to recover
by changing speed to lower values and retrying the com-
mand. This message indicates to which mode the driver is
attempting to re-program the drive, where is a
decimal value.
Changing the mode of targ: to Multi DMA mode:
.
For the timedout command, the driver attempts to recover
by changing speed to lower values and retrying the
SunOS 5.11 Last change: 20 April 2005 4
Devices uata(7D)
command. This message indicates to which mode the driver
is attempting to re-program the drive, where is
a decimal value.
These messages are informational and indicate that a timeout
occured for a I/O request. The uata driver recovers from
these states automatically unless there is a fatal error.
SunOS 5.11 Last change: 20 April 2005 5