X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.threads;h=b02e607d2bfa4b89bb6629b0ea24f0d2d6c284b8;hb=1ba752a043289c0682ba096aba08751ac71b298a;hp=83570561a721cb8e2b63958a0e538705b1573af9;hpb=8b73bbec3102cdf25a35c954eb1aab85acc07808;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.threads b/README.threads index 8357056..b02e607 100644 --- a/README.threads +++ b/README.threads @@ -1,43 +1,76 @@ +NOTE + +Threading is a highly experimental feature. There are still a +few race conditions that show up under high contention on SMP +machines. Internal implementation is still subject to changes. +It is not recommended for production use at this time. + +--------------------------------------------------------------------------- + Building -If you want to build with multi-threading support and you are -running one of the following: +If your system is in the following list you should be able to just: - * Linux 2.x (with the LinuxThreads library installed: that's - the linuxthreads and linuxthreads-devel RPMs for RedHat) + ./Configure -Dusethreads -des + make - * Digital UNIX 4.x +and ignore the rest of this "Building" section. If not, continue +from the "Problems" section. - * Solaris 2.x for recentish x (2.5 is OK) + * Linux 2.* (with the LinuxThreads library installed: + that's the linuxthreads and linuxthreads-devel RPMs + for RedHat) - * IRIX 6.2 or newer. 6.2 will require a few os patches. - IMPORTANT: Without patch 2401, a kernel bug in IRIX 6.2 will - cause your machine to panic and crash when running threaded perl. - IRIX 6.3 and up should be OK. See lower down for patch details. + * Tru64 UNIX (formerly Digital UNIX formerly DEC OSF/1) + (see additional note below) -then you should be able to use + * Solaris 2.* for recentish x (2.5 is OK) - ./Configure -Dusethreads -des - make + * IRIX 6.2 or newer. 6.2 will require a few OS patches. + IMPORTANT: Without patch 2401 (or its replacement), + a kernel bug in IRIX 6.2 will cause your machine to + panic and crash when running threaded perl. + IRIX 6.3 and up should be OK. See lower down for patch details. + + * AIX 4.1.5 or newer. + + * FreeBSD 2.2.8 or newer. + + * OpenBSD + + * NeXTstep, OpenStep (Rhapsody?) + + * OS/2 -and ignore the rest of this "Building" section. If it doesn't -work or you are using another platform which you believe supports -POSIX.1c threads then read on. Additional information may be in -a platform-specific "hints" file in the hints/ subdirectory. + * DOS DJGPP -Omit the -d from your ./Configure arguments. For example, use + * VM/ESA + +--------------------------------------------------------------------------- + +Problems + +If the simple way doesn't work or you are using another platform which +you believe supports POSIX.1c threads then read on. Additional +information may be in a platform-specific "hints" file in the hints/ +subdirectory. + +On platforms that use Configure to build perl, omit the -d from your +./Configure arguments. For example, use: ./Configure -Dusethreads When Configure prompts you for ccflags, insert any other arguments in -there that your compiler needs to use POSIX threads. When Configure -prompts you for linking flags, include any flags required for -threading (usually nothing special is required here). Finally, when -COnfigure prompts you for libraries, include any necessary libraries -(e.g. -lpthread). Pay attention to the order of libraries. It is -probably necessary to specify your threading library *before* your -standard C library, e.g. it might be necessary to have -lpthread -lc, -instead of -lc -lpthread. +there that your compiler needs to use POSIX threads (-D_REENTRANT, +-pthreads, -threads, -pthread, -thread, are good guesses). When +Configure prompts you for linking flags, include any flags required +for threading (usually nothing special is required here). Finally, +when Configure prompts you for libraries, include any necessary +libraries (e.g. -lpthread). Pay attention to the order of libraries. +It is probably necessary to specify your threading library *before* +your standard C library, e.g. it might be necessary to have -lpthread +-lc, instead of -lc -lpthread. You may also need to use -lc_r instead +of -lc. Once you have specified all your compiler flags, you can have Configure accept all the defaults for the remainder of the session by typing &-d @@ -59,6 +92,14 @@ For Digital Unix 4.x: Zap mallocobj and mallocsrc (foo='') Change d_mymalloc to undef +For Digital Unix 3.x (Formerly DEC OSF/1): + Add -DOLD_PTHREADS_API to ccflags + If compiling with the GNU cc compiler, remove -threads from ccflags + + (The following should be done automatically if you call Configure + with the -Dusethreads option). + Add -lpthread -lmach -lc_r to libs (in the order specified). + For IRIX: (This should all be done automatically by the hint file). Add -lpthread to libs @@ -75,6 +116,7 @@ For IRIX: For IRIX 6.3 and 6.4 the pthreads should work out of the box. Thanks to Hannu Napari for the IRIX pthreads patches information. + For AIX: (This should all be done automatically by the hint file). Change cc to xlc_r or cc_r. @@ -82,9 +124,19 @@ For AIX: Add -lc_r to libswanted Change -lc in lddflags to be -lpthread -lc_r -lc +For Win32: + See README.win32, and the notes at the beginning of win32/Makefile + or win32/makefile.mk. + Now you can do a make +When you succeed in compiling and testing ("make test" after your +build) a threaded Perl in a platform previosuly unknown to support +threaded perl, please let perlbug@perl.com know about your victory. +Explain what you did in painful detail. + +--------------------------------------------------------------------------- O/S specific bugs @@ -133,20 +185,17 @@ Try running the main perl test suite too. There are known failures for some of the DBM/DB extensions (if their underlying libraries were not compiled to be thread-aware). +--------------------------------------------------------------------------- Bugs * FAKE_THREADS should produce a working perl but the Thread -extension won't build with it yet. - -* There's a known memory leak (curstack isn't freed at the end -of each thread because it causes refcount problems that I -haven't tracked down yet) and there are very probably others too. +extension won't build with it yet. (FAKE_THREADS has not been +tested at all in recent times.) * There may still be races where bugs show up under contention. -* Need to document "lock", Thread.pm, Queue.pm, ... - +--------------------------------------------------------------------------- Debugging @@ -159,6 +208,7 @@ have to delete the lines in perl.c which say DEBUG_S(signal(SIGSEGV, (void(*)(int))catch_sigsegv);); #endif +--------------------------------------------------------------------------- Background @@ -265,3 +315,9 @@ Last updated: 27 November 1997 Configure-related info updated 16 July 1998 by Andy Dougherty + +Other minor updates 10 Feb 1999 by +Gurusamy Sarathy + +More platforms added 26 Jul 1999 by +Jarkko Hietaniemi