configure the SCSI subsystem
/etc/sconf [ -q ] -d n
/etc/sconf [ -q ] -g n
/etc/sconf [ -q ] -i attach ha bus number ID lun
/etc/sconf [ -q ] -o n attach ha bus number ID lun
/etc/sconf [ -q ] -p n
/etc/sconf [ -q ] -r
/etc/sconf [ -q ] -s attach
/etc/sconf [ -q ] -u [ master updated ]
/etc/sconf [ -q ] -v
sconf amends the current
SCSI configuration to reflect
devices that have been added or removed from the system
since the last kernel relink, or to configure the
system at first installation.
sconf updates a table in the kernel immediately. The
changes may also be written to the
file; this allows them to be made permanent
by relinking the kernel.
sconf should only be used by the installation query
manager (IQM), and the installation scripts.
It should not be used to configure devices after
installation; this should be done using
Devices are probed by sending them a SCSI
inquiry request. If a device does not return an
identification string, it is assumed that there is no
active hardware at that SCSI address.
sconf takes the following options:
Delete line n from the dynamic mscsi table.
Return data from line n in the dynamic mscsi table.
-i attach ha bus number ID lun
Add a line to the dynamic mscsi table.
The line is placed after all other lines relating to
device driver type attach.
for a description of the option arguments.
-o n attach ha bus number ID lun
Overwrite line n of the dynamic
mscsi table with the supplied data.
for a description of the other arguments.
Probe the device corresponding to line n of
the dynamic mscsi table.
Stop messages being sent to the standard error output.
Report the number of lines in the dynamic mscsi table.
Report the number of peripheral devices of type attach
that can be added to the dynamic mscsi table; that is,
the number of times that the -i option can be called
for that device. See
for a description of the attach argument.
-u [ master updated ]
Update the master mscsi file with the
contents of the dynamic mscsi table to produce
an updated version. If not specified, the
default master and updated files are
Probe all the possible addresses on all recognized host adapters
and print the configuration data on the standard output.
sconf returns one of the following exit values:
successful completion, no error
mscsi file is not writable
mscsi file does not exist
device does not respond to a SCSI inquiry request
not enough memory to allow an entry to be added to the
the dynamic mscsi table
specified line number n does not exist in the
dynamic mscsi table, or the entry to be added
would make mscsi inconsistent (due to a SCSI
address clash or an incorrect argument)
Note that these examples are provided for illustrative
purposes only. They may cause unpredictable errors if you invoke
Find how many devices are specified in the dynamic mscsi table:
Read the first line of the mscsi table:
sconf -g 1
arad Sdsk 0 1 2 3
which implies that the first (root) SCSI disk is on
adapter type arad, adapter number 0, bus 1 (secondary
bus), with target SCSI ID 2 and LUN 3.
To change this to a disk on the
single bus Adaptec 1742 (in enhanced mode)
with SCSI ID 6 and LUN 5:
sconf -o 1 eiad Sdsk 0 1 6 5
Update the mscsi file on disk using sconf -u.
The changes are added to the kernel automatically after the next
sconf is not intended for changing the configuration
of the SCSI subsystem from the command line.
Changing the SCSI configuration of a mounted disk
will panic the kernel. Filesystems on the disk may be left in an
inconsistent state that requires them to be repaired or completely
root privilege is required to run sconf.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003