DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

btldinstall(ADM)


btldinstall -- install boot-time loadable device drivers into the Link Kit

Syntax

/etc/btldinstall mount_dir

Description

This command asks the user which packages on a boot-time loadable device driver diskette (the btld(F) diskette) are to be installed, and then adds the appropriate drivers to the Link Kit. A ``package'' is a directory hierarchy which contains one or more drivers, and associated files.

mount_dir is expected to be the root directory of a mounted btld diskette. btldinstall is typically run by a Bourne shell (see sh(C)) script (/install/INSTALL) which is always present on a btld diskette. /install/INSTALL is itself run automatically by installpkg(ADM).

btldinstall performs the following actions, in order:

  1. Ensure the Link Kit is installed. If it is not, the user is asked whether to install it using custom(ADM), or to abandon the installation of boot-time drivers.

  2. Asks the user which boot-time loadable device driver packages to install. The default behavior is that btldinstall installs all the packages on the btld diskette which are also in the package string (see string(M)).
Then once per required package:

3.
If the Bourne shell script /pkg/install/copyright exists and is executable it is run.

4.
If the Bourne shell script /pkg/install/preinstall exists it is run as though it were part of btldinstall.

5.
The list of drivers in /pkg/install/drivers is checked to determine if a driver with the same name already exists in the Link Kit. The user is asked to resolve this conflict, either by replacing the driver in the Link Kit or by choosing not to install the boot-time loadable driver.

6.
The drivers are installed with idinstall(ADM).

7.
If the hierarchy /pkg/new exists, it is copied to the hard disk as if it were ``/''.

8.
If the file /pkg/install/pkg.name exists it is copied to /usr/options/pkg.name.

9.
If the Bourne shell script /pkg/install/postinstall exists it is run as though it were part of btldinstall.

The following environment variables are available for use in scripts run by btldinstall:

$pkg
The current package being installed.

$pkginst
All packages to be installed.

$okdrivers
All drivers to be installed for this package.

Limitations

If an error occurs during the installation, btldinstall unwinds changes to the Link Kit to leave it in a working state.

See also

boot(HW), btld(F), idinstall(ADM), installpkg(ADM), string(M)

Standards conformance

/etc/btldinstall 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