HP-UX Reference (11i v1 05/09) - 7 Device (Special) Files, 9 General Information, Index (vol 10)

s
SCSI(7) SCSI(7)
};
/* structure for SCSI-2 sense data */
struct sense_2_aligned {
unsigned int info_valid:1;
unsigned int error_code:7;
unsigned char seg_num;
unsigned int filemark:1;
unsigned int eom:1;
unsigned int ili:1;
unsigned int resv:1;
unsigned int key:4;
unsigned char info[4];
unsigned char add_len;
unsigned char cmd_info[4];
unsigned char code;
unsigned char qualifier;
unsigned char fru;
unsigned char key_specific[3];
unsigned char add_sense_bytes[113];
};
ERRORS
The following errors may result from a call to a SCSI device driver:
[EACCES] Required permission is denied for the the device or operation.
[ENXIO] If resulting from an open call, this indicates there is no device at the specified address.
For other calls, this indicates the specified address is out of range or the device may
no longer be accessed.
[EINVAL] If resulting from an open call, this indicates the device is not supported by the device
driver (for example, incorrect device type). For other calls, this indicates the request
or some request argument is invalid.
[EBUSY] This indicates the device is not ready for use or that the requested operation conflicts
with other operations (for example, the device is currently open via another device
driver or exclusive access is in effect).
[EIO] Indicates a SCSI protocol or communication problem has occurred, or that a SCSI
command resulted in a non-good status.
Manual entries that describe specific SCSI peripheral device drivers may provide additional qualification of
error results.
WARNINGS
Use of devices that are not officially supported can cause data loss, system panics and device damage. HP-
UX device drivers expect devices to be SCSI-2 compliant. Unsupported devices that are only SCSI-CCS
compliant may work but their use is discouraged. Use of unsupported devices that are only SCSI-1 compli-
ant is strongly discouraged.
Changing SCSI bus connectivity (recabling) while the system is running is not supported. Switching SCSI
device power on or off while the device is connected to a system that does not support powerfail recovery is
not supported. These activities are known to cause data loss and system panics.
On systems that support the
scsi_ctl interface, the SIOC_CMD_MODE, SIOC_SET_CMD , and
SIOC_RETURN_STATUS ioctls are obsolete (see scsi_ctl(7)). Direct manipulation of SCSI devices via the
scsi_ctl interface provides a more functionally complete and easier-to-use means of low level SCSI dev-
ice control (see scsi_ctl(7)).
Drivers that support only devices which have no meaningful size may not support the SIOC_CAPACITY
ioctl. Total device size in bytes may exceed 2
32
1 for some devices.
DEPENDENCIES
sdisk/schgr/sflop/stape
The SIOC_EXCLUSIVE ioctl may be used to obtain and release exclusive access. Exclusive access, which
prevents simultaneous access by other applications, is required for some operations and may be desirable in
Section 7128 Hewlett-Packard Company 3 HP-UX 11i Version 1: September 2005