INSTALL 2.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. Installation of the `QuickThreads' threads-building toolkit.
  2. * Notice
  3. QuickThreads -- Threads-building toolkit.
  4. Copyright (c) 1993 by David Keppel
  5. Permission to use, copy, modify and distribute this software and
  6. its documentation for any purpose and without fee is hereby
  7. granted, provided that the above copyright notice and this notice
  8. appear in all copies. This software is provided as a
  9. proof-of-concept and for demonstration purposes; there is no
  10. representation about the suitability of this software for any
  11. purpose.
  12. * Configuration
  13. Configure with
  14. ./config *machtype*
  15. where "*machtype*" is one of the supported target machines. As of
  16. October 1994, the supported machines (targets) are:
  17. axp -- All Digital Equipment Corporation AXP (DEC Alpha)
  18. processors, compile with GNU CC
  19. axp-osf1 -- AXP running OSF 1.x
  20. axp-osf2 -- AXP running OSF 2.x
  21. hppa -- HP's PA-RISC 1.1 processor
  22. hppa-cnx-spp -- Convex SPP (PA-RISC 1.1 processor)
  23. iX86 -- 80386, 80486, and 80586-compatible processors
  24. See notes below for OS/2.
  25. iX86-ss -- 'iX86 for assemblers that use slash-slash ('//')
  26. comments.
  27. ksr1 -- All KSR processors
  28. m88k -- All members of the Motorola 88000 family
  29. mips -- MIPS R2000 and R3000 processors
  30. mips-irix5 -- Irix 5.xx (use `mips' for Irix 4.xx)
  31. sparc-os1 -- V8-compliant SPARC processors using compilers
  32. that prefix labels (e.g. "foo" appears as "_foo")
  33. Includes Solaris 1 (SunOS 4.X).
  34. sparc-os2 -- V8-compliant SPARC processors using compilers
  35. that do not prefix labels. Includes Solaris 2.
  36. vax -- All VAX processors
  37. In addition, the target `clean' will deconfigure QuickThreads.
  38. Note that a given machine target may not work on all instances of that
  39. machine because e.g., the assembler syntax varies from machine to
  40. machine.
  41. Note also that additions to a processor family may require a new
  42. target. So, for example, the `vax' target might not work for all
  43. future VAX processors if, say, new VAX processors are introduced and
  44. they use separate floating-point registers.
  45. For OS/2, change `ranlib' to `ar -s', `configure' to `configure.cmd'
  46. (or was that `config' to `config.cmd'?), and replace the soft links
  47. (`ln -s') with plain copies.
  48. * Build
  49. To build the QuickThreads library, first configure (see above) then
  50. type `make libqt.a' in the top-level directory.
  51. To build the demonstration threads package, SimpleThreads, type
  52. `make libstp.a' in the top-level directory.
  53. To build an executable ``stress-test'' and measurement program, type
  54. `make run' in the top-level directory. Run `time/raw' to run the
  55. stress tests.
  56. * Installation
  57. Build the QuickThreads library (see above) and then copy `libqt.a' to
  58. the installation library directory (e.g., /usr/local/lib) and `qt.h'
  59. and `qtmd.h' to the installation include directory (e.g.,
  60. /usr/local/include).