home *** CD-ROM | disk | FTP | other *** search
/ The UNIX CD Bookshelf / OREILLY_TUCB_UNIX_CD.iso / upt / examples / README. < prev    next >
Encoding:
Text File  |  1998-07-24  |  3.2 KB  |  78 lines

  1. Thank you for purchasing the Power Tools CDROM.
  2.  
  3. The Power Tools CDROM is designed to allow you to search for and/or
  4. install the already built (binary) packages for any supported system
  5. (SCO UNIX, DEC Alpha, Sun 4, Sun Solaris, IBM RS/6000 and HP
  6. 9000/700) with minimal effort.  In addition, sources for all packages
  7. is included along with patches and BUILD scripts to assist in
  8. rebuilding any of the packages.
  9.  
  10. Please note that the Power Tools book contains references to scripts
  11. with "dots" in their names (e.g. "cleanup.sed"), the installation system
  12. refers to these with "underscores" (e.g. "cleanup_sed"), but will
  13. install them as they appear in the book (with dots).
  14.  
  15. Complete instructions should have accompanied your Power Tools Book and
  16. CDROM.  Here is a brief synopsis of the installation instructions.
  17.  
  18. To install executable versions of the packages, simply execute
  19. "INSTALL.PT" (which is found in the root directory of the CDROM).
  20. INSTALL.PT will attempt to determine the mount point of the CDROM and
  21. the machine type of your hardware.  If INSTALL.PT determines these
  22. incorrectly, you may set the following environment variables.
  23.  
  24.         CDROM                           - typically /cdrom
  25.  
  26.         MACHINE 
  27.                 set MACHINE to one of the following:
  28.                         i386            - SCO Unix 
  29.                         alpha           - DEC Alpha with Digital Unix
  30.                         rs6000          - IBM Risc System/6000
  31.                         linux           - Linux
  32.                         sun4c           - Sun Sparc with SunOS 4.1.x
  33.                         hp700           - HP 9000 series 700
  34.                         solaris         - Sun Sparc with Solaris 
  35.  
  36.  
  37. To rebuild any of the packages, there exists a script for each
  38. package.  The BUILD scripts read the sources from the CDROM and do the
  39. actual building in a subdirectory of the current working directory
  40. (this directory will have the same name as the package and will be
  41. created by the BUILD script). For example, to rebuild "cvtbase" you
  42. would execute:
  43.  
  44.         /cdrom/BUILD.PT cvtbase
  45.  
  46. or something similar if your cdrom is not mounted at /cdrom.  
  47. The BUILD scripts also make use of the following environment variables
  48. (in addition to MACHINE):
  49.  
  50.         SOURCEDIR                       - typically /cdrom/SOURCES
  51.         INSTALLDIR                      - defaults to /usr/local
  52.         INSTALLSHAREDIR                 - defaults to /usr/local/share
  53.         SHAREPREFIX                     - defaults to ""
  54.         RM                              - defaults to ""
  55.  
  56. If the RM variable is set, then the directory which is created for the
  57. build is removed upon completion of the build (even if the build
  58. fails).
  59.  
  60. Most BUILD scripts use "patch" so you will probably want to make sure
  61. that patch is installed before running BUILD.
  62.  
  63. If your mount command mounts the files in <cdrom>/<MACHINE>/BIN as either
  64. suid or sgid, then you will want to use the "-o nosuid,nosgid" options if
  65. your version of mount supports them.
  66.  
  67. If you are using an SCO UNIX machine and get a "killed" message when
  68. trying to run the installation system, please read the readme file in 
  69. the i386 directory.
  70.  
  71.  
  72. Ready-to-Run Software, Inc.
  73. 4 Pleasant Street
  74. Westford, MA 01886
  75.  
  76. Phone  978 692 9922
  77. FAX    978 692 9990
  78.