summaryrefslogtreecommitdiff
path: root/README.freebsd
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2002-06-08 23:23:15 +0100
committerJarkko Hietaniemi <jhi@iki.fi>2002-06-08 20:31:18 +0000
commitd41150a633c012f8c6a2c9d01f78708b471bfe01 (patch)
tree2e90ddd84daa861b0b4943d34eb8b642d3c4a137 /README.freebsd
parentd473d728aa905c7536de5257e7ca13d507f4b3e6 (diff)
downloadperl-d41150a633c012f8c6a2c9d01f78708b471bfe01.tar.gz
Re: perl Makfile.PL for DBI give Segmentation fault (core dumped) (was: perl@17014)
Message-ID: <20020608212315.GE302@Bagpuss.unfortu.net> p4raw-id: //depot/perl@17114
Diffstat (limited to 'README.freebsd')
-rw-r--r--README.freebsd39
1 files changed, 39 insertions, 0 deletions
diff --git a/README.freebsd b/README.freebsd
new file mode 100644
index 0000000000..e147c66843
--- /dev/null
+++ b/README.freebsd
@@ -0,0 +1,39 @@
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see pod/perlpod.pod) which is
+specifically designed to be readable as is.
+
+=head1 NAME
+
+README.freebsd - Perl version 5 on FreeBSD systems
+
+=head1 DESCRIPTION
+
+This document describes various features of FreeBSD that will affect how Perl
+version 5 (hereafter just Perl) is compiled and/or runs.
+
+=head2 core dumps from readdir_r with ithreads
+
+When perl is configured to use ithreads, it will use re-entrant library calls
+in preference to non-re-entrant versions. There is a bug in FreeBSD's
+C<readdir_r> function that can cause a SEGV when reading large directories.
+A patch is available
+(see http://www.freebsd.org/cgi/query-pr.cgi?pr=misc/30631 )
+and will hopefully be integrated into FreeBSD 4.6.
+
+=head2 $^X doesn't always contain a full path
+
+perl 5.8.0 sets C<$^X> where possible to a full path by asking the operating
+system. On FreeBSD the full path of the perl interpreter is found by reading
+the symlink F</proc/curproc/file>. There is a bug on FreeBSD, where the
+result of reading this symlink is can be wrong in certain circumstances
+(see http://www.freebsd.org/cgi/query-pr.cgi?pr=35703 ).
+In these cases perl will fall back to the old behaviour of using C's
+argv[0] value for C<$^X>.
+
+=head1 AUTHOR
+
+Nicholas Clark <nick@ccl4.org>, collating wisdom supplied by Slaven Rezic
+and Tim Bunce.
+
+Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
+