xscsimode - display and edit Mode Pages for SCSI, Fibre
Channel devices accessed using the SGI linux-xscsi subsys
tem.
SYNOPSIS
xscsimode [-D] [-B Byte from Start of Page] [-P Page No.]
[-F Ref. Field No.] [-V New Field/Byte Value] [-o Output
LogFile] -d Device
DESCRIPTION
xscsimode is an interactive utility for scsi disks
accessed using the SGI xscsi subsystem. It sends a Mode
Sense(6) command to the device to get the modepages, dis
plays them in a tabular format, allows the user to change
various fields in those pages and then sends a Mode
Select(6) command to the device to save the changed mode
pages. More information about the Mode Sense(6) and Mode
Select(6) commands can be found in the SCSI Primary Com
mands-2 (SPC-2) reference documents.
OPTIONS
In the interactive mode xscsimode is invoked with the -d
devicename option. The device name must correspond to the
'ds' device. A logfile to store modepage modifications
should also be specified using the -o logfile option. For
example :
xscsimode -d /dev/xscsi/pci05.02.0/target70/lun0/ds -o
target70.log
If a logfile is not specified, modepage changes are stored
in xscsimode.log in the current working directory of the
user. The logfile is intended to facilitate the user to
make the same change on multiple devices (all supporting
the modepages being edited). For example (assuming the
logfile is target70.log):
sh target70.log /dev/xscsi/pci05.02.0/target71/lun0/ds
will copy the modepage changes made on target70 to tar
get71.
-P Page No.
specifies the number of the modepage to be edited.
Both decimal and hex values (preceded by 0x) are
acceptable.
-F Ref. Field No.
Specifies the Reference no. of the modepage field
being edited. Cannot be used with the -B option.
acceptable.
-V Value
The new value to be placed in the specified
field/byte of the page. Both decimal and hex val
ues (preceded by 0x) are acceptable.
-B Byte No.
Specifies the byte no. from the start of the page.
Bytes are numbered starting from 0 and include the
bytes forming the page header. This option cannot
be used with the -F option. Both decimal and hex
values (preceded by 0x) are acceptable.
-D Load Default Values. This option changes the cur
rent values in the modepage ( specified using -P )
to their default values.
In the interactive mode an invalid choice results in the
default option (specified in []) being chosen. For example
:
Do you wish to modify this ModePage (y/n) ? [n] :
Any keystroke other than 'y' or 'Y' will result in 'n'
being chosen. Modepage changes can result in loss of sys
tem data and this facility ensures that the user is fully
aware of the changes being made.
EXAMPLES
1) xscsimode -P 0x1 -F 16 -V 0x1024 -d <device>
In this example Field 16 (in the tabular representation)
of Page 1 gets changed to 0x1024.
2) xscsimode -P 0x1 -B 16 -V 0x24 -d <device>
In this example the 16th byte of Page 1 gets changed to
0x24.
3) xscsimode -P 0x1 -D -d <device>
In this example the current values of ModePage 1 are
changed to their default values.
FILES
/dev/xscsi/pci*/target*/lun*/ds - the SGI linux-xscsi
SEE ALSO
xscsicontrol(8), xscsiha(8), xscsiformat(8), xscsidisk
test(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