HP-UX Reference (11i v2 04/09) - 1M System Administration Commands N-Z (vol 4)
s
scsictl(1M) scsictl(1M)
EXAMPLES
To display all the mode parameters, turn
immediate_report on, and redisplay the value of
immediate_report
:
scsictl -a -m ir=1 -m ir /dev/rdsk/c0t6d0
producing the following output:
immediate_report = 0; queue_depth = 8; immediate_report = 1
The same operation with labels suppressed:
scsictl -aq -m ir=1 -m ir /dev/rdsk/c0t6d0
produces the following output:
0; 8; 1
To clear persistent reservation from a device:
scsictl -p pr_clear key /dev/rdsk/c0t6d0
WARNINGS
Not all devices support all mode parameters and commands listed above. Changing a mode parameter
may have no effect on such a device.
Issuing a command that is not supported by a device can cause an error message to be generated.
scsictl is not supported on sequential-access devices using the tape driver.
The
immediate_report
mode applies to the entire device; the section number of the device argument
is ignored.
To aid recovery, immediate reporting is not used for writes of file system data structures that are main-
tained by the operating system, writes to a hard disk (but not a magneto-optical device) through the
character-device interface, or writes to regular files that the user has made synchronous with
O_SYNC or
O_DSYNC (see open (2) and fcntl (2)).
DEPENDENCIES
disc3
When the system is rebooted, the
disc3 driver always resets the value of the immediate_report
mode parameter to off.Ifioctl() or scsictl is used to change the setting of immediate reporting
on a SCSI device, the new value becomes the default setting upon subsequent configuration (e.g., opens)
of this device and retains its value across system or device powerfail recovery. However, on the next sys-
tem reboot, the immediate-report
mode parameter is again reset to the value of the tunable system
parameter,
default_disk_ir. This is set using the kctune (1M) command.
sdisk
If
ioctl() or scsictl is used to change the setting of immediate reporting on a SCSI device, the new
value becomes the default setting upon subsequent configuration (e.g., opens) of this device until the "last
close" of the device, that is, when neither the system nor any application has the device open (for exam-
ple, unmounting a file system via umount and then mounting it again via mount (see mount(1M)). On
the next "first open", the immediate-report mode parameter is again reset to the value of the tunable
system parameter, default_disk_ir. This is set using the kctune (1M) command.
SEE ALSO
diskinfo(1M), fcntl(2), kctune(1M), open(2).
HP-UX 11i Version 2: September 2004 − 3 − Hewlett-Packard Company Section 1M−−745