btldinstall(ADM)                19 June 1992                btldinstall(ADM)


 Name

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

 Syntax

    /etc/btldinstall mountdir

 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.

    mountdir is expected to be the root directory of a mounted btld
    diskette.  btldinstall is typically run by a Bourne shell ( 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:

    a)    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 instal-
          lation of boot-time drivers.

    b)    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:

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

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

    e)    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.

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

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

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

    i)    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.


 See also

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

 Notes

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

 Value added

    /etc/btldinstall is an extension of AT&T System V provided by The Santa
    Cruz Operation, Inc.