setinfo(8) setinfo(8)
NAME
setinfo - set or display device configuration info
SYNOPSIS
setinfo -l pathname
setinfo -t info [-wv] pathname
setinfo -p {info | all}
setinfo -C {l | e | d} pathname
setinfo -Cc {pathname | all}
setinfo -T {e | d} pathname
setinfo -m pathname
DESCRIPTION
/sbin/setinfo describes a device to the kernel. info files are com-
posed in a simple language describing device configuration parameters.
The language consists of identifier=value pairs. The identifiers
recognized are device specific. A particular identifier expects a
value of a particular type.
Several types of values are supported. Values enclosed in single or
double quotes are treated as strings. Simple integer values or hex
numbers are recognized. Arrays of integers are recognized as a comma
separated list of integers enclosed in curly brackets.
For example:
dktbsize=2048 # A simple integer
dktname='NEC2363' # A string value
xmiaddrs={0x1a0,0x1b0,0x12c8} # An array of integers
The info language is compatible with the Bourne shell variable assign-
ment syntax. The output of setinfo -l may be used in shell scripts to
initialize the value of shell variables.
pathname is the name of a raw device such as /dev/ios0/rsdisk000s0 or
/dev/ios0/rstape000.
Some devices, such as magnetic disks, are capable of saving the confi-
guration info so that it will not be lost during a system reboot.
These devices only need a setinfo to be done once during installation
of the device.
Page 1 Reliant UNIX 5.44 Printed 11/98
setinfo(8) setinfo(8)
OPTIONS
-l Displays the configuration info for pathname.
-t info
Sets the configuration of pathname to info. info is the name of a
file containing identifier=value pairs describing various
descriptive and configuration parameters for the device. If info
contains a "/", setinfo tries to open info, otherwise setinfo
searches for info in the directories
/etc/default/diskinfo/setinfo and /etc/default/tapeinfo/setinfo.
-v Verbose. Additional display of the configuration data.
-w Does not attempt to save the info on the device.
-p {info | all}
Loads one or all info files (see -t option) in the kernel.
-C{l | e | d}
By default, the write cache of SNI SCSI disks is disabled for
better reliability. This function makes it possible to list the
state of the write cache or enable or disable the write cache of
desired SCSI disks.
Caution: Enabling or disabling of SCSI write caches is only pos-
sible on inactive SCSI disks that have not been mounted, to
prevent data corruption. This command should be executed typi-
cally prior to fsck or mount start scripts.
-Cc {pathname | all}
Checks if the status of the write cache is compatible with the
status in the system file /etc/default/wcache. If there are
differences, appropriate error messages are output. This pro-
cedure can be used to check either individual disks or all disks
known in the system.
-T {e | d}
Activates (e) or deactivates (d) "Tagged Queuing" for SCSI-2
disks. ("Tagged Queuing" means that a disk can accept a number of
tasks while other tasks are already being processed.)
Warning: A disk must not be in "used" mode when (-Td) is deac-
tivated.
-m pathname
Initalizes the specified disk with the default attributes. The
error handling and cache parameters (mode select parameters) are
set here to ensure optimal operation of the disk.
Page 2 Reliant UNIX 5.44 Printed 11/98
setinfo(8) setinfo(8)
DIAGNOSTICS
Exit status is normally 0. If an error occurs, exit status is 1.
NOTE
Some hardware is self describing and therefore does not require a
setinfo before use.
FILES
/etc/default/diskinfo/setinfo
A directory containing disk configuration files.
/etc/default/tapeinfo/setinfo
A directory containing tape configuration files.
SEE ALSO
autoconf(8), dkpart(8), dksetup(8), dktune(8).
Page 3 Reliant UNIX 5.44 Printed 11/98