HWCONFIG(C) XENIX System V HWCONFIG(C)
Name
hwconfig - Display hardware configuration information.
Syntax
/etc/hwconfig [-f filename] [-chlnq] [field=value] [field]
...
Description
hwconfig displays hardware configuration information as
reported by device drivers during system bootup, from the
file /usr/adm/hwconfig or a specified file. Using
combinations of the remaining options, the user can select
which devices to report on as well as what information to
report about these devices. hwconfig can also be used to
detect conflicts in device settings.
Two display formats are available. By default, hwconfig
displays a series of field=value entries for each recognized
device. The fields include (but are not restricted to)
name, base I/O address, offset (number of consecutive I/O
addresses used), interrupt vector, DMA channel, and fields
specific to each device. This format is easily interpreted
by programs.
In the default format, an argument of field=value causes
only lines with a matching field to be displayed. A field
argument without a value causes only the specified fields of
the selected lines to display, and selects only those lines
which contain that field.
Using the -h option, the hwconfig display looks similar to
this:
device address vec dma comment
====== ======= === === =======
floppy 0x3f2-0x3f7 06 2 unit=0 type=96ds15
serial 0x210-0x217 03 - unit=1 type=DIGIBOARD nports=4
console - - - unit=vga type=0
disk 0x1f0-0x1f7 36 - type=W0 unit=0 cyls=1023 hds=8 secs=52
Options
The following options are available:
-f filename
use filename instead of /usr/adm/hwconfig.
-h Display tabular format with headers, rather than
field=value pairs. If field=value or field
arguments are included, only lines matching all
such arguments are displayed. (The complete line
is always displayed.)
Page 1 (printed 2/7/91)
HWCONFIG(C) XENIX System V HWCONFIG(C)
-c Check for device conflicts, including I/O
addresses, DMA channels and interrupt vectors
which are being used by more than one driver.
-q Check quietly for device conflicts; display
nothing. When both -c and -q are given, display
conflicts only.
-n Display names; same as a field argument of name.
-l Display all fields, even if field selectors have
been given.
field=value
Display all devices with a field matching the
stated value.
field Display only the matching fields of selected
devices. With -h, display whole lines with a
matching field.
Examples
hwconfig The entire contents of the file /usr/adm/hwconfig
is printed.
hwconfig base
prints all base values found in /usr/adm/hwconfig.
hwconfig -f conf base=300 vec=31
prints all entries in conf that match the base and
vec values given.
hwconfig name=floppy base
prints the base values for any floppy entries in
/usr/adm/hwconfig.
hwconfig -n base dma
displays name, base and dma of all entries in
/usr/adm/hwconfig with base and dma values.
hwconfig base dma vec=4
displays the base and dma values of all
/usr/adm/hwconfig entries with base and dma values
and vec=4.
hwconfig -l base dma
displays in full all entries in /usr/adm/hwconfig
with both base and dma values.
hwconfig -ch
displays /usr/adm/hwconfig in an easy-to-read
tabular format and checks for device conflicts.
Page 2 (printed 2/7/91)
HWCONFIG(C) XENIX System V HWCONFIG(C)
Files
/etc/hwconfig program file
/usr/lib/hwconfig.awk awk program which hwconfig uses
/usr/adm/hwconfig default source file
Diagnostics
hwconfig returns 0 for success, 1 for conflicts detected, 2
for invalid arguments.
Notes
Information about conflicts is purely advisory because
hwconfig can only report about hardware devices which have
been correctly recognized by a kernel driver.
/usr/adm/hwconfig is not normally readable by users, but can
be made so by the System Administrator.
/usr/adm/hwconfig is written by the error logger daemon.
The logger daemon does not run while in System Maintenance
mode. This means that the hwconfig report is not valid
until the system is brought into multi-user mode.
Page 3 (printed 2/7/91)