summaryrefslogtreecommitdiff
path: root/README.threads
diff options
context:
space:
mode:
authorGurusamy Sarathy <gsar@cpan.org>1999-02-16 06:18:27 +0000
committerGurusamy Sarathy <gsar@cpan.org>1999-02-16 06:18:27 +0000
commit99ed61e6cc0c0db3082cc4fadff22a2fe3b2049f (patch)
tree79ef307428b21baceb40f5d0e3436553e178c8f8 /README.threads
parentcceca5ed003bac658cb0392a14bb2f26d434bd78 (diff)
parent9de70c85adb9a4d3b22d09bb8920e00bf4051bdb (diff)
downloadperl-99ed61e6cc0c0db3082cc4fadff22a2fe3b2049f.tar.gz
integrate change#2852 from maint-5.005; integrate cfgperl contents;
elide dups and non-dependents from Changes p4raw-link: @2852 on //depot/maint-5.005/perl: 9d2bcc06253ec4693886be5b5b7869bda6582d6e p4raw-id: //depot/perl@2958 p4raw-integrated: from //depot/maint-5.005/perl@2957 'copy in' README.threads (@1717..) 'merge in' INSTALL (@2737..) p4raw-integrated: from //depot/maint-5.005/perl@2852 'merge in' Configure (@2837..)
Diffstat (limited to 'README.threads')
-rw-r--r--README.threads24
1 files changed, 18 insertions, 6 deletions
diff --git a/README.threads b/README.threads
index 952623fcbd..136b156e7f 100644
--- a/README.threads
+++ b/README.threads
@@ -1,3 +1,10 @@
+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
@@ -27,7 +34,8 @@ 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.
-Omit the -d from your ./Configure arguments. For example, use
+On other platforms that use Configure to build perl, omit the -d
+from your ./Configure arguments. For example, use:
./Configure -Dusethreads
@@ -92,6 +100,10 @@ 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
@@ -147,11 +159,8 @@ 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.
@@ -275,3 +284,6 @@ Last updated: 27 November 1997
Configure-related info updated 16 July 1998 by
Andy Dougherty <doughera@lafayette.edu>
+
+Other minor updates 10 Feb 1999 by
+Gurusamy Sarathy