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