INSTALL revision 12027
14202Sbinkertn@umich.eduInstallation of the `QuickThreads' threads-building toolkit. 24202Sbinkertn@umich.edu 34202Sbinkertn@umich.edu* Notice 44202Sbinkertn@umich.edu 54202Sbinkertn@umich.eduQuickThreads -- Threads-building toolkit. 64202Sbinkertn@umich.eduCopyright (c) 1993 by David Keppel 74202Sbinkertn@umich.edu 84202Sbinkertn@umich.eduPermission to use, copy, modify and distribute this software and 94202Sbinkertn@umich.eduits documentation for any purpose and without fee is hereby 104202Sbinkertn@umich.edugranted, provided that the above copyright notice and this notice 114202Sbinkertn@umich.eduappear in all copies. This software is provided as a 124202Sbinkertn@umich.eduproof-of-concept and for demonstration purposes; there is no 134202Sbinkertn@umich.edurepresentation about the suitability of this software for any 144202Sbinkertn@umich.edupurpose. 154202Sbinkertn@umich.edu 164202Sbinkertn@umich.edu 174202Sbinkertn@umich.edu* Configuration 184202Sbinkertn@umich.edu 194202Sbinkertn@umich.eduConfigure with 204202Sbinkertn@umich.edu 214202Sbinkertn@umich.edu ./config *machtype* 224202Sbinkertn@umich.edu 234202Sbinkertn@umich.eduwhere "*machtype*" is one of the supported target machines. As of 244202Sbinkertn@umich.eduOctober 1994, the supported machines (targets) are: 254202Sbinkertn@umich.edu 264202Sbinkertn@umich.edu axp -- All Digital Equipment Corporation AXP (DEC Alpha) 274202Sbinkertn@umich.edu processors, compile with GNU CC 284202Sbinkertn@umich.edu axp-osf1 -- AXP running OSF 1.x 294202Sbinkertn@umich.edu axp-osf2 -- AXP running OSF 2.x 304202Sbinkertn@umich.edu hppa -- HP's PA-RISC 1.1 processor 314202Sbinkertn@umich.edu hppa-cnx-spp -- Convex SPP (PA-RISC 1.1 processor) 324202Sbinkertn@umich.edu iX86 -- 80386, 80486, and 80586-compatible processors 334486Sbinkertn@umich.edu See notes below for OS/2. 344486Sbinkertn@umich.edu iX86-ss -- 'iX86 for assemblers that use slash-slash ('//') 356165Ssanchezd@stanford.edu comments. 366168Snate@binkert.org ksr1 -- All KSR processors 374202Sbinkertn@umich.edu m88k -- All members of the Motorola 88000 family 384202Sbinkertn@umich.edu mips -- MIPS R2000 and R3000 processors 394202Sbinkertn@umich.edu mips-irix5 -- Irix 5.xx (use `mips' for Irix 4.xx) 404202Sbinkertn@umich.edu sparc-os1 -- V8-compliant SPARC processors using compilers 414202Sbinkertn@umich.edu that prefix labels (e.g. "foo" appears as "_foo") 424202Sbinkertn@umich.edu Includes Solaris 1 (SunOS 4.X). 435650Sgblack@eecs.umich.edu sparc-os2 -- V8-compliant SPARC processors using compilers 446168Snate@binkert.org that do not prefix labels. Includes Solaris 2. 457768SAli.Saidi@ARM.com vax -- All VAX processors 467768SAli.Saidi@ARM.com 477768SAli.Saidi@ARM.comIn addition, the target `clean' will deconfigure QuickThreads. 487768SAli.Saidi@ARM.com 497768SAli.Saidi@ARM.comNote that a given machine target may not work on all instances of that 504202Sbinkertn@umich.edumachine because e.g., the assembler syntax varies from machine to 514202Sbinkertn@umich.edumachine. 527768SAli.Saidi@ARM.com 534202Sbinkertn@umich.eduNote also that additions to a processor family may require a new 544202Sbinkertn@umich.edutarget. So, for example, the `vax' target might not work for all 555192Ssaidi@eecs.umich.edufuture VAX processors if, say, new VAX processors are introduced and 568335Snate@binkert.orgthey use separate floating-point registers. 578335Snate@binkert.org 588335Snate@binkert.orgFor OS/2, change `ranlib' to `ar -s', `configure' to `configure.cmd' 598335Snate@binkert.org(or was that `config' to `config.cmd'?), and replace the soft links 608335Snate@binkert.org(`ln -s') with plain copies. 618335Snate@binkert.org 627780Snilay@cs.wisc.edu 638335Snate@binkert.org* Build 648335Snate@binkert.org 658683Snilay@cs.wisc.eduTo build the QuickThreads library, first configure (see above) then 668335Snate@binkert.orgtype `make libqt.a' in the top-level directory. 678335Snate@binkert.org 688335Snate@binkert.orgTo build the demonstration threads package, SimpleThreads, type 698335Snate@binkert.org`make libstp.a' in the top-level directory. 708335Snate@binkert.org 718335Snate@binkert.orgTo build an executable ``stress-test'' and measurement program, type 728615Snilay@cs.wisc.edu`make run' in the top-level directory. Run `time/raw' to run the 738335Snate@binkert.orgstress tests. 748335Snate@binkert.org 758335Snate@binkert.org 767780Snilay@cs.wisc.edu* Installation 777780Snilay@cs.wisc.edu 788615Snilay@cs.wisc.eduBuild the QuickThreads library (see above) and then copy `libqt.a' to 798683Snilay@cs.wisc.eduthe installation library directory (e.g., /usr/local/lib) and `qt.h' 80and `qtmd.h' to the installation include directory (e.g., 81/usr/local/include). 82