drvinstall(8) CLIX drvinstall(8)
NAME
drvinstall - Installs/uninstalls a driver
SYNOPSIS
/etc/drvinstall [-m master] [-d object] [-s system] [-o directory] [-c
minor] -v version -ufbnx
FLAGS
-m master Specifies the pathname of the master file to be used. If
this flag is omitted, the /etc/master.d directory is used.
Either this flag or the -d flag must be used.
-d object Specifies the pathname of the input object file to be used.
If this flag is omitted, the /boot directory is used.
Either this flag or the -m flag must be used.
-s system Specifies the pathname of the system file to be used. If
this flag is omitted, the /etc/system file is used.
-o directory Specifies the pathname of the output bootable file. If
this flag is omitted, the /boot directory is used.
-v version Specifies the version number of the drvinstall command
compatible with the master file being used. This flag is
required.
-u If this flag is not present, the driver will be installed.
If the driver to be installed is a software driver,
drvinstall will perform the following tasks:
⊕ Assign a major number to that driver if there is an ``-
'' entry in the major number field of the associated
master file entry. The drvinstall command expects any
unused field of the master file to be filled with a ``-
''.
⊕ The major numbers available for software drivers on 3B2
computers are 48-127 inclusive. The remaining major
numbers are reserved for hardware devices or are used by
integral drivers. The drvinstall command determines the
available major numbers by scanning all existing master
files for major numbers and then assigning the first
unused number in the above range. This value replaces
the corresponding ``-'' value in the major number field
of the master file.
⊕ Display the major number found or assigned in the master
file.
2/94 - Intergraph Corporation 1
drvinstall(8) CLIX drvinstall(8)
If the driver to be installed is not a hardware driver (it
is, for example, a software driver or a loadable type of
module), drvinstall will perform the following tasks:
⊕ Insert an statement for the driver in the system file.
⊕ If the -c flag is present, insert (minor) at the end of
the statement. The minor argument is optional in an and
specifies the quantity (default of 1) of minor devices
to be controlled by the driver. If the driver is not a
software driver, -c is ignored.
For any driver installed, drvinstall executes mkboot to
produce a bootable object file. The resultant output file
is placed into the directory determined by the -o flag.
The -b flag inhibits generation of the object file. This
flag is ignored for uninstall.
-u Uninstalls a driver. A driver dependency check is made and
if a dependency is found, a warning message is issued and
the command is aborted. If no dependency is found,
drvinstall performs the following tasks:
⊕ Remove the bootable object file.
⊕ Replace the major number with a ``-'' in the master file
if the driver is a software driver.
⊕ Delete the statement from the system file if the driver
is not a hardware driver.
⊕ Display the major number if the driver is a software
driver.
-f When used with the -u flag, -f disables the dependency
check. This results in the driver being uninstalled
regardless of dependencies.
-n Inhibits any edit of the system file. (This flag applies
to both installing and uninstalling.)
-x Enables debugging output. (This flag applies to both
installing and uninstalling.)
DESCRIPTION
The drvinstall command accepts an object file, master file and system file
as input, and creates the corresponding specially formatted file for use
by the self-configuring boot. In addition, the master and system files
may be modified.
2 Intergraph Corporation - 2/94
drvinstall(8) CLIX drvinstall(8)
EXIT VALUES
The major numbered assigned or found for a software driver is displayed on
stdout. The drvinstall command exits with a 0 if successful, and a
nonzero value if unsuccessful.
RELATED INFORMATION
Commands: mkboot(8)
Files: master(4), system(4)
2/94 - Intergraph Corporation 3