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

IDEIOSTOP (Stop) IDE Adapter Device Driver ioctl Operation

Purpose

Closes the logical path to an Integrated Device Electronics (IDE) device.

Description

The IDEIOSTOP operation closes the logical path to an IDE device. The IDEIOSTOP operation causes the adapter device driver to deallocate data areas allocated in response to an IDEIOSTART operation. This command must be issued when the caller wishes to cease communications to a particular IDE device. The IDEIOSTOP operation should only be issued for a device successfully opened by a previous call to an IDEIOSTART operation.

The IDEIOSTOP operation passes the arg parameter. This parameter allows the caller to specify the IDE device ID of the device to be stopped. The least significant byte in the arg parameter is the IDE device ID. The remaining bytes are reserved and must be set to 0.

Return Values

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

EINVAL Indicates that the device has not been opened. An IDEIOSTART operation should be issued prior to calling the IDEIOSTOP operation.
EIO Indicates that the device drive was unable to pin code.

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 ]