xscsicontrol - probe and control scsi devices accessed
using the SGI linux-xscsi subsystem.
SYNOPSIS
/bin/xscsicontrol [-CDHISacdegilmqsv] [-b blockize] device
...
DESCRIPTION
xscsicontrol may be used to print info from the SCSI
inquiry commands, which normally indicate the device type,
manufacturer, and similar info. Other options may be used
show more data, or to issue commands that control the
operation of the device, or the bus as a whole. By using
the debug option (-d), the exact command sent, and the
data returned (if any) is displayed, along with more
extensive error information.
-C Send the SGI-specific command that causes the CD-
ROM drive to reply to the inquiry command (see -i
below) as a CD-ROM drive. On poweron, or after a
SCSI bus reset (either as part of error recovery or
from a user issued command), the CD-ROM drives sold
by SGI respond to inquiry as a hard disk. This was
done because older systems would otherwise refuse
to boot from the CD-ROM drive.
-D Send the SCSI self test (diagnostic) command to the
device.
-H Send the SCSI halt, or stop, command. This causes
the device to stop the media, or in some cases, to
unload it.
-S Send the SCSI start, or load, command. This causes
the device to start the media, or in some cases, to
load it.
-a Attempt to negotiate with the device to operate in
asynchronous mode. This will usually mean a lower
data rate on the SCSI bus, but is less sensitive to
scsi cabling problems, etc. Some devices will
negotiate synchronous mode, but may not work cor
rectly in that mode. This can also be forced by
changing the configuration variables for the scsi
controller driver. Also see the -s option below.
-d Debug mode. This causes all commands sent to the
device and the data that is returned, if any, to
be printed. Extensive information about errors is
also printed when they occur.
-e Open the device in exclusive mode. This will fail
other process or SCSI driver. If it succeeds,
other opens will then fail. This mode applies to
the host controller driver, and does not issue any
SCSI commands to the device (in particular, the
reserve unit command is not sent).
-g Get the host adapter flags for this SCSI bus. This
is mostly of interest to driver writer's, but it
does provide a way to determine if the SCSI discon
nect option has been disabled on the bus.
-i Send the SCSI inquiry command, and display the info
in a readable fashion. The information typically
includes the device type, the manufacturer, the
SCSI version, and some of the optional SCSI fea
tures the device supports. Also see -I below.
-I display all the data from the -i or -v options in
both hex and ascii form. Implies -i if neither
-i or -v were given on the command line.
-q Quiet mode. Don't print the name of each device as
it is opened, unless an error occurs.
-s Attempt to negotiate with the device to operate in
synchronous mode. This is normally done by the
operating system when the device is first used, but
that may fail, and the system will not then re-
attempt to negotiate. Some drivers will suppress
the negotiation. Operating in synchronous mode
will usually mean a higher data rate on the SCSI
bus, but this mode is more sensitive to SCSI
cabling problems. Additionally, some devices will
negotiate successfully for this mode, but will not
work correctly. Also see the -a option above.
-v Issue the SCSI inquiry command with the vital prod
ucts modifier, and display the data in a readable
fashion. The vital product data often includes the
serial number, and the additional information about
the device. Also see -I above.
-c blocksize
For devices that support the readcapacity command,
print the capacity of the device, and if it's block
oriented, the number of bytes per block.
-b blocksize
Set the blocksize (for disks, CDROMs, and some
types of tape drives) to the given value, and also
report the previous value. blocksize may be given
in decimal, hex (with leading 0x), or octal (with
leading 0). Not all devices support changing their
-l Print the current values of all the supported
logsense pages. This can sometimes be useful in
debugging device problems, but almost always
requires the device specific manual from it's manu
facturer, to be of use.
-m Print the current values of all the supported mode
sense pages. Mostly of use to people debugging
problems or writing devscsi drivers.
-R Issue the SCSI Report Luns command and display the
Logical Unit Numbers [LUNs] of all configured logi
cal units on the device.
FILES
/dev/xscsi/pci*/target*/lun*/ds - the SGI linux-xscsi
driver device
SEE ALSO
dsopen(8), ds(8), xscsiha(8).
NOTE
This command is normally usable only by the superuser,
because the standard permissions of the devices in
/dev/xscsi restrict access to other users.
Man(1) output converted with
man2html