Thank you for purchasing The UNIX CD Bookshelf.

The original Power Tools CDROM was designed to allow you to search for and/or install the already built (binary) packages for any supported system (SCO UNIX, DEC Alpha, Sun 4, Sun Solaris, IBM RS/6000 and HP 9000/700) with minimal effort. In addition, sources for all packages is included along with patches and BUILD scripts to assist in rebuilding any of the packages.

Please note that the Power Tools book contains references to scripts with "dots" in their names (e.g. cleanup.sed), the installation system refers to these with "underscores" (e.g. cleanup_sed), but will install them as they appear in the book (with dots).

Complete instructions accompanied your Power Tools book and CDROM. Here is a brief synopsis of the installation instructions.

To install executable versions of the packages, simply execute INSTALL.PT (which is found in the examples directory of this book). INSTALL.PT will attempt to determine the mount point of the CDROM and the machine type of your hardware. If INSTALL.PT determines these incorrectly, you may set the following environment variables.

CDROM

typically /cdrom

MACHINE

set MACHINE to one of the following:

i386

SCO Unix

alpha

DEC Alpha with Digital Unix

rs6000

IBM Risc System/6000

linux

Linux

sun4c

Sun Sparc with SunOS 4.1.x

hp700

HP 9000 series 700

solaris

Sun Sparc with Solaris

To rebuild any of the packages, there exists a script for each package. The BUILD scripts read the sources from the CDROM and do the actual building in a subdirectory of the current working directory (this directory will have the same name as the package and will be created by the BUILD script). For example, to rebuild cvtbase you would execute:

/cdrom/BUILD.PT cvtbase

or something similar if your CDROM is not mounted at /cdrom. The BUILD scripts also make use of the following environment variables (in addition to MACHINE):

SOURCEDIR

typically /cdrom/SOURCES

INSTALLDIR

defaults to /usr/local

INSTALLSHAREDIR

defaults to /usr/local/share

SHAREPREFIX

defaults to ""

RM

defaults to ""

If the RM variable is set, then the directory which is created for the build is removed upon completion of the build (even if the build fails).

Most BUILD scripts use patch so you will probably want to make sure that patch is installed before running BUILD.

If your mount command mounts the files in cdrom/MACHINE/BIN as either suid or sgid, then you will want to use the -o nosuid,nosgid options if your version of mount supports them.

If you are using an SCO UNIX machine and get a "killed" message when trying to run the installation system, please read the readme file in the i386 directory.

Ready-to-Run Software, Inc.
4 Pleasant Street
Westford, MA 01886

Phone 978 692 9922
FAX 978 692 9990