scsictl.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

scsictl(1M) scsictl(1M)

NAME

scsictl - control a SCSI device

SYNOPSIS

scsictl [-akq][-m mode[

=value ] ]... [-c command]... device

scsictl -o ola_params arguments...

scsictl -p pr_clear key device

scsictl [-k] -t tgtid {-c

command}... ctrl

DESCRIPTION

The

scsictl command provides a mechanism for controlling a SCSI device. It can be used to query

mode parameters, set conﬁgurable mode parameters, and perform SCSI commands. The operations are

performed in the same order as they appear on the command line.

The second form, as shown above, supports the online addition of a supported SCSI card to a system.

This option cannot be used with any other options available for this command.

The

scsictl command can be used to clear persistent reservation from a device, as shown in the third

form above, using the -p option.

Some of the commands can be used on a controller device as shown in the fourth form. The list of com-

mands supported on a controller device is provided in the

-t option description below.

device speciﬁes the character special ﬁle to use.

ctrl speciﬁes the special ﬁle of a parallel SCSI controller node.

Options

scsictl recognizes the following options.

Mode parameters and commands need only be speciﬁed up to a unique preﬁx. When abbreviating a mode

parameter or command, at least the ﬁrst three characters must be supplied.

-a Display the status of all mode parameters available, separated by semicolon-blank (

; )

or newline.

-c command

Cause the device to perform the speciﬁed command. If multiple commands need to be

speciﬁed, then each command must be preﬁxed by the -c option. command can be one of

the following:

erase For magneto-optical devices that support write without erase,

this command can be used to pre-erase the whole surface to

increase data throughput on subsequent write operations. This

command maintains exclusive access to the surface during the

pre-erasure.

sync_cache For devices that have an internal write cache, this command

causes the device to ﬂush its cache to the physical medium.

domain_val Domain validation allows the user to check the quality of

transmissions across the bus and helps to ﬁnd problems like

faulty and missing terminators, bad components, and so on.

This command is only valid for Ultra160 and later devices. If

any errors encountered during domain validation, they will be

logged in the

syslog.

get_bus_parms This command displays information about limits and negoti-

able parameters of a bus.

get_lun_parms This command displays information about limits and negoti-

able parameters of a physical or a virtual peripheral device.

get_target_parms This command displays information about limits and negoti-

able parameters of a target peripheral device.

reset_target This command causes a target reset task management function

to be sent to the associated target.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
scsictl(1M) scsictl(1M) NAME scsictl - control a SCSI device SYNOPSIS scsictl [-akq] [-m mode[=value ] ]... [-c command]... device scsictl -o ola_params arguments... scsictl -p pr_clear key device scsictl [-k] -t tgtid {-c command}... ctrl DESCRIPTION The scsictl command provides a mechanism for controlling a SCSI device. It can be used to query mode parameters, set configurable mode parameters, and perform SCSI commands. The operations are performed in the same order as they appear on the command line.
PAGE 2
scsictl(1M) scsictl(1M) reset_bus -k This command causes the system to generate a SCSI bus reset condition on the associated bus. A SCSI bus reset condition causes all devices on the bus to be reset (including clearing all active commands on all devices). Continue processing arguments even after an error is detected. The default behavior is to exit immediately when an error is detected. Command line syntax is always verified for correctness, regardless of the -k option.
PAGE 3
scsictl(1M) scsictl(1M) Suppress the labels that are normally printed when mode parameters are displayed. Mode parameter values are printed in the same order as they appear on the command line, separated by semicolon-blank (; ) or newline. -q -t tgtid ctrl Specify tgtid as the SCSI target parameter on which operation needs to be initiated. The valid range of tgtid value is between 0 and 15. In agile addressing the tgtid is the port_id returned by the command scsimgr get_info -H target_path .
PAGE 4
scsictl(1M) scsictl(1M) DEPENDENCIES disc3 When the system is rebooted, the disc3 driver always resets the value of the immediate_report mode parameter to off. 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 (for example, opens) of this device and retains its value across system or device powerfail recovery.