sconf(ADM)

sconf -- configure the SCSI subsystem

Syntax

/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

Description

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 mscsi(F) 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 mkdev(ADM).

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:

-d n: Delete line n from the dynamic mscsi table.
-g n: 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. See mscsi(F) 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. See mscsi(F) for a description of the other arguments.
-p n: Probe the device corresponding to line n of the dynamic mscsi table.
-q: Stop messages being sent to the standard error output.
-r: Report the number of lines in the dynamic mscsi table.
-s attach: 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 mscsi(F) 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 /etc/conf/cf.d/mscsi and /etc/conf/cf.d/mscsi.new.
-v: Probe all the possible addresses on all recognized host adapters and print the configuration data on the standard output.

Exit values

sconf returns one of the following exit values:

0: successful completion, no error
1: mscsi file is not writable
2: mscsi file does not exist
5: I/O error
6: device does not respond to a SCSI inquiry request
12: not enough memory to allow an entry to be added to the the dynamic mscsi table
22: 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)

Examples

Note that these examples are provided for illustrative purposes only. They may cause unpredictable errors if you invoke them.

Find how many devices are specified in the dynamic mscsi table:

sconf -r

Read the first line of the mscsi table:

sconf -g 1

This returns:

   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 kernel relink.

Warning

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 rebuilt.

Authorization

root privilege is required to run sconf.