SCIOSTOP (Stop) Device SCSI Adapter Device Driver ioctl Operation

Purpose

Closes the logical path to a SCSI target device.

Description

The SCIOSTOP operation closes the logical path to a SCSI device. The host SCSI adapter acts as an initiator. The SCIOSTOP operation causes the adapter device driver to deallocate data areas allocated in response to a SCIOSTART operation. This command must be issued when the caller wishes to cease communications to a particular SCSI target. The SCIOSTOP operation should only be issued for a device successfully opened by a previous call to an SCIOSTART operation.

The SCIOSTOP operation passes the arg parameter. This parameter allows the caller to specify the SCSI and logical unit number (LUN) IDs of the device to be stopped. The least significant byte in the arg parameter is the LUN, and the next least significant byte is the SCSI ID. The remaining two 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 one of the following values:

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

Files

Item Description
/dev/scsi0, /dev/scsi1, ..., /dev/scsin Provide an interface to allow SCSI device drivers to access SCSI devices or adapters.
/dev/vscsi0, /dev/vscsi1,..., /dev/vscsin Provide an interface to allow SCSI-2 Fast/Wide Adapter/A and SCSI-2 Differential Fast/Wide Adapter/A device drivers to access SCSI devices or adapters.