[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

IDEIOSTART (Start IDE) IDE Adapter Device Driver ioctl Operation

Purpose

Opens a logical path to an Integrated Device Electronics (IDE) device.

Description

The IDEIOSTART operation opens a logical path to an IDE device. This operation causes the adapter device driver to allocate and initialize the data areas needed to manage commands to a particular IDE device.

The IDEIOSTART operation must be issued prior to any of the other operations, such as IDEIOINQU and IDEIORESET. However, the IDEIOSTART operation is not required prior to calling the IOCINFO operation. Finally, when the caller is finished issuing commands to the IDE device, the IDEIOSTOP operation must be issued to release allocated data areas and close the path to the device.

The arg parameter to IDEIOSTART allows the caller to specify the IDE device ID identifier of the device to be started. The least significant byte in the arg parameter is the IDE device ID (master=0, slave=1). The remaining bytes are reserved and must be set to a value of 0.

Return Values

If completed successfully, this operation returns a value of 0. Otherwise, a value of -1 is returned and the errno global variable set to 1 of the following values:

EIO Indicates either an unrecoverable I/O error, or the device driver is unable to pin code.
EINVAL Indicates that the IDE device ID was incorrect.

If the IDEIOSTART operation is unsuccessful, the caller must not attempt other operations to this IDE device ID, since it is either already in use or was never successfully started.

Files

/dev/ide0, /dev/ide1, ..., /dev/iden Provide an interface to allow IDE device drivers to access IDE devices or adapters.

Related Information

idedisk IDE device driver or idecdrom IDE device driver.


[ Previous | Next | Contents | Home | Search ]