`/etc/install`

Install a software package (QNX)

Syntax:

install [-u update | drive] [files...]

Options:

-u update: Unpack and install the file update.
drive: Install a software package from the disk drive named by drive. Default is /dev/fd0 (floppy disk drive 0).
files: Install only those files whose filenames match the pattern files. Default is * (install all files in the archive).

Description:

The /etc/install utility is a shell script provided as a convenience for installing QNX products and product updates on an already-running QNX system.

You must be root to run the /etc/install utility.

The install utility will typically install a directory tree from your current working directory. To install a product or update obtained from QNX Software Systems Ltd you will typically want to be in the root directory (/) before you run /etc/install.

It is still possible for an archive being installed to install components elsewhere than under the current working directory - check any installation instructions that came with the product or archive.

Incremental product updates are periodically posted on QUICS, the bulletin board maintained by QNX Software Systems for support of QNX products. Updates for all the modified components of a product are bundled into single files for download, which you can subsequently unbundle by using /etc/install -u filename.

Disk updates are also unbundled using the /etc/install script. In this case, the updates will be read from the first floppy drive (/dev/fd0) or the drive named as a command-line parameter.

The /etc/install utility will, in addition to simply unpacking the software, transfer licenses from update diskettes and run a setup program if one accompanies the software package.

Examples:

Install a software package from floppy disks using the drive /dev/fd0:

    /etc/install

Unpack and install an update contained in the file 961002.tar.F:

    /etc/install -u 961002.tar.F

Unpack and install an updated contained in the file 961002.tar.gz:

    /etc/install -u 961002.tar.gz

Exit status:

0: The installation completed successfully.
>0: The installation was not completed successfully. Either an invalid command-line parameter was supplied, an error occurred during the installation, or the installation was aborted midway.

Caveats:

This utility applies only to software update archives and to packages supplied on floppy diskettes. Software packages supplied on CD-ROM will use a different installation procedure. See the instructions supplied with the CD-ROM for details.