112027Sjungma@eit.uni-kl.deInstallation of the `QuickThreads' threads-building toolkit.
212027Sjungma@eit.uni-kl.de
312027Sjungma@eit.uni-kl.de* Notice
412027Sjungma@eit.uni-kl.de
512027Sjungma@eit.uni-kl.deQuickThreads -- Threads-building toolkit.
612027Sjungma@eit.uni-kl.deCopyright (c) 1993 by David Keppel
712027Sjungma@eit.uni-kl.de
812027Sjungma@eit.uni-kl.dePermission to use, copy, modify and distribute this software and
912027Sjungma@eit.uni-kl.deits documentation for any purpose and without fee is hereby
1012027Sjungma@eit.uni-kl.degranted, provided that the above copyright notice and this notice
1112027Sjungma@eit.uni-kl.deappear in all copies.  This software is provided as a
1212027Sjungma@eit.uni-kl.deproof-of-concept and for demonstration purposes; there is no
1312027Sjungma@eit.uni-kl.derepresentation about the suitability of this software for any
1412027Sjungma@eit.uni-kl.depurpose.
1512027Sjungma@eit.uni-kl.de
1612027Sjungma@eit.uni-kl.de
1712027Sjungma@eit.uni-kl.de* Configuration
1812027Sjungma@eit.uni-kl.de
1912027Sjungma@eit.uni-kl.deConfigure with
2012027Sjungma@eit.uni-kl.de
2112027Sjungma@eit.uni-kl.de	./config *machtype*
2212027Sjungma@eit.uni-kl.de
2312027Sjungma@eit.uni-kl.dewhere "*machtype*" is one of the supported target machines.  As of
2412027Sjungma@eit.uni-kl.deOctober 1994, the supported machines (targets) are:
2512027Sjungma@eit.uni-kl.de
2612027Sjungma@eit.uni-kl.de	axp --	All Digital Equipment Corporation AXP (DEC Alpha)
2712027Sjungma@eit.uni-kl.de		processors, compile with GNU CC
2812027Sjungma@eit.uni-kl.de	axp-osf1 -- AXP running OSF 1.x
2912027Sjungma@eit.uni-kl.de	axp-osf2 -- AXP running OSF 2.x
3012027Sjungma@eit.uni-kl.de	hppa -- HP's PA-RISC 1.1 processor
3112027Sjungma@eit.uni-kl.de	hppa-cnx-spp -- Convex SPP (PA-RISC 1.1 processor)
3212027Sjungma@eit.uni-kl.de	iX86 --	80386, 80486, and 80586-compatible processors
3312027Sjungma@eit.uni-kl.de		See notes below for OS/2.
3412027Sjungma@eit.uni-kl.de	iX86-ss -- 'iX86 for assemblers that use slash-slash ('//')
3512027Sjungma@eit.uni-kl.de		comments.
3612027Sjungma@eit.uni-kl.de	ksr1 --	All KSR processors
3712027Sjungma@eit.uni-kl.de	m88k --	All members of the Motorola 88000 family
3812027Sjungma@eit.uni-kl.de	mips --	MIPS R2000 and R3000 processors
3912027Sjungma@eit.uni-kl.de	mips-irix5 -- Irix 5.xx (use `mips' for Irix 4.xx)
4012027Sjungma@eit.uni-kl.de	sparc-os1 -- V8-compliant SPARC processors using compilers
4112027Sjungma@eit.uni-kl.de		that prefix labels (e.g. "foo" appears as "_foo")
4212027Sjungma@eit.uni-kl.de		Includes Solaris 1 (SunOS 4.X).
4312027Sjungma@eit.uni-kl.de	sparc-os2 -- V8-compliant SPARC processors using compilers
4412027Sjungma@eit.uni-kl.de		that do not prefix labels.  Includes Solaris 2.
4512027Sjungma@eit.uni-kl.de	vax --	All VAX processors
4612027Sjungma@eit.uni-kl.de
4712027Sjungma@eit.uni-kl.deIn addition, the target `clean' will deconfigure QuickThreads.
4812027Sjungma@eit.uni-kl.de
4912027Sjungma@eit.uni-kl.deNote that a given machine target may not work on all instances of that
5012027Sjungma@eit.uni-kl.demachine because e.g., the assembler syntax varies from machine to
5112027Sjungma@eit.uni-kl.demachine.
5212027Sjungma@eit.uni-kl.de
5312027Sjungma@eit.uni-kl.deNote also that additions to a processor family may require a new
5412027Sjungma@eit.uni-kl.detarget.  So, for example, the `vax' target might not work for all
5512027Sjungma@eit.uni-kl.defuture VAX processors if, say, new VAX processors are introduced and
5612027Sjungma@eit.uni-kl.dethey use separate floating-point registers.
5712027Sjungma@eit.uni-kl.de
5812027Sjungma@eit.uni-kl.deFor OS/2, change `ranlib' to `ar -s', `configure' to `configure.cmd'
5912027Sjungma@eit.uni-kl.de(or was that `config' to `config.cmd'?), and replace the soft links
6012027Sjungma@eit.uni-kl.de(`ln -s') with plain copies.
6112027Sjungma@eit.uni-kl.de
6212027Sjungma@eit.uni-kl.de
6312027Sjungma@eit.uni-kl.de* Build
6412027Sjungma@eit.uni-kl.de
6512027Sjungma@eit.uni-kl.deTo build the QuickThreads library, first configure (see above) then
6612027Sjungma@eit.uni-kl.detype `make libqt.a' in the top-level directory.
6712027Sjungma@eit.uni-kl.de
6812027Sjungma@eit.uni-kl.deTo build the demonstration threads package, SimpleThreads, type
6912027Sjungma@eit.uni-kl.de`make libstp.a' in the top-level directory.
7012027Sjungma@eit.uni-kl.de
7112027Sjungma@eit.uni-kl.deTo build an executable ``stress-test'' and measurement program, type
7212027Sjungma@eit.uni-kl.de`make run' in the top-level directory.  Run `time/raw' to run the
7312027Sjungma@eit.uni-kl.destress tests.
7412027Sjungma@eit.uni-kl.de
7512027Sjungma@eit.uni-kl.de
7612027Sjungma@eit.uni-kl.de* Installation
7712027Sjungma@eit.uni-kl.de
7812027Sjungma@eit.uni-kl.deBuild the QuickThreads library (see above) and then copy `libqt.a' to
7912027Sjungma@eit.uni-kl.dethe installation library directory (e.g., /usr/local/lib) and `qt.h'
8012027Sjungma@eit.uni-kl.deand `qtmd.h' to the installation include directory (e.g.,
8112027Sjungma@eit.uni-kl.de/usr/local/include).
82