read hardware configuration information
/etc/hwconfig [ -nlhcq ] [ -f file ] [ param ] [ param=val ]
The hwconfig command returns the configuration information
contained in the configuration string device /dev/string/cfg or
in the file specified on the command line with
the -f option.
Using combinations of the remaining options, the user
can view as much information as needed from the configuration
string. The display format is as follows:
device_name base+finish vec dma rest
is the name of the device driver.
are the starting and the finishing addresses of the driver working space.
is the interrupt vector number in decimal.
is the DMA channel number.
is a possibly empty list of parameter=value pairs.
The default hwconfig display looks similar to this:
name=fpu vec=13 dma=- type=80387
name=serial base=0x3F8 offset=0x7 vec=4 dma=- unit=0 type=Standard nports=1
name=floppy base=0x3F2 offset=0x5 vec=6 dma=2 unit=0 type=135ds18
name=console vec=- dma=- unit=vga type=0 12 screens=68k
name=adapter base=0x2000 offset=0xCDC vec=11 dma=- type=eiad ha=0 id=7 fts=std
name=eisarom vec=- dma=- eisa (1.3.0)
name=sme base=0x300 offset=0x1F vec=10 dma=- type=8216 addr=00 00 c0 a2 d5 6e
name=tape vec=- dma=- type=S ha=0 id=2 lun=0 bus=0 ht=eiad
name=disk vec=- dma=- type=S ha=0 id=0 lun=0 bus=0 ht=eiad
name=Sdsk vec=- dma=- cyls=496 hds=64 secs=32 fts=sdb
The configuration string device
/dev/string/cfg is written to by the boot
program. Thus, the hwconfig report is up to
date when the system is rebooted into either system maintenance
or multiuser mode.
The device name is always printed out.
The long format of the device configuration content, with a label
for each entry, is used. This is the default.
Use the short format, with headers instead of labels.
Check for device conflicts, including I/O addresses, DMA channels,
and interrupt vectors which are being used by more than one driver.
Check quietly for device conflicts; display nothing.
When both -c and -q are given, display conflicts only.
Use file as the input file instead of the default
Show all values of param throughout the configuration
string device. param can be any valid system parameter.
The current valid system parameters are:
name, base, offset, vec, dma,
unit, type, nports,
hds, cyls, secs, and drvr.
Show only information from the line where param equals
the value val.
The -n, -l and -h options are in increasing overriding power.
That is, if -n and -l are both specified,
-l is used.
param on its own indicates a query for its corresponding value(s),
whereas param=value indicates a
matching <token,val> pair in the input file.
-l is used by default if there are no queries and no explicit option.
Command-line queries, that is, those with parameters only,
are always displayed in long format.
hwconfig returns 0 for success, 1 for conflicts detected, 2 for
hwconfig -f /usr/adm/hwconfig
The entire contents of the file
/usr/adm/hwconfig are printed.
All the values of the base parameter found
in /dev/string/cfg are printed.
hwconfig -f conf base=300 vec=19
All entries in conf that match the
base and vec values given
hwconfig name=floppy base
The name and value of base in /dev/string/cfg
for the drivers with the name floppy
are printed for all entries.
hwconfig -n base dma
The device name associated with the base and dma is displayed.
name=scsi base=0x234 dma=4
hwconfig base dma vec=4
The base and dma values of all /dev/string/cfg
entries with matching vec=4 are printed.
hwconfig -l base dma vec=4
Similar to hwconfig -l vec=4
except that base and dma values are printed first.
Everything is printed in the long format, with a header similar to
the one shown at boot time.
All queries are ignore, but matching is performed on token values. For example,
hwconfig -h vec=4 dma=1
prints in long format, with headers, all those entries with
vec=4 and dma=1
displays /dev/string/cfg in an easy-to-read tabular format and
checks for device conflicts.
Information about conflicts is purely advisory because hwconfig can
only report about hardware devices which have been correctly recognized by a
/dev/string/cfg is normally readable by all users;
however, the system administrator may change its permissions.
awk program which hwconfig uses
configuration string device
hwconfig is not part of any currently supported standard;
it is an extension of AT&T System V provided
by The Santa Cruz Operation, Inc.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003