SCIOLSTOP

Edit online

This operation closes a logical path to the device and causes the adapter device driver to deallocate all data areas that were allocated by the SCIOLSTART operation. This operation should only be issued after a successful SCIOLSTART operation to a device.

The following is a typical call:


rc = fp_ioctl(fp, SCIOLSTOP, &sciolst);

where fp is a pointer to a file structure and sciolst is a scsi_sciolst structure (defined in /usr/include/sys/scsi_buf.h) that contains the SCSI or iSCSI device's SCSI ID alias, and Logical Unit Number (LUN) ID values of the device to be stopped.

A nonzero return value indicates an error has occurred. Possible errno values are:

Item	Description
`EIO`	An unrecoverable system error has occurred.
`EINVAL`	The adapter was not in open mode.

The version field of the scsi_sciolst structure must be set to a minimum value of SCSI_VERSION_1, which is defined in the /usr/include/sys/scsi_buf.h file. In addition, the following fields can be set:

world_wide_name - The caller can set the world_wide_name field to the World Wide Name of the attached target device. If Dynamic Tracking of FC devices is enabled, the world_wide_name field must be set to ensure communication with the device because the scsi_id field of a device can change after dynamic tracking events.
node_name - The caller can set the node_name field to the Node Name of the attached target device. For AIX® 5.2 through AIX® 5.2.0.9, if the world_wide_name field and the version field are set to SCSI_VERSION_1 but the node_name field is not set, the scsi_id field is used for device lookup instead of the world_wide_name. If Dynamic Tracking of FC devices is enabled, the node_name field must be set to ensure communication with the device because the scsi_id field of a device can change after dynamic tracking events.

For Virtual SCSIadapters, the version field of the scsi_sciolst structure must be set to the value of SCSI_VERSION_1 (defined in the /usr/include/sys/scsi_buf.h file). In addition, Virtual SCSI adapters require the caller to set the lun_id field to the Logical Unit Id (LUN) of the device being stopped.

This operation requires SCIOLSTART to be run first.