Commit | Line | Data |
---|---|---|
d41150a6 NC |
1 | If you read this file _as_is_, just ignore the funny characters you |
2 | see. It is written in the POD format (see pod/perlpod.pod) which is | |
3 | specifically designed to be readable as is. | |
4 | ||
5 | =head1 NAME | |
6 | ||
de2902a6 | 7 | perlfreebsd - Perl version 5 on FreeBSD systems |
d41150a6 NC |
8 | |
9 | =head1 DESCRIPTION | |
10 | ||
11 | This document describes various features of FreeBSD that will affect how Perl | |
12 | version 5 (hereafter just Perl) is compiled and/or runs. | |
13 | ||
3df9be30 | 14 | =head2 FreeBSD core dumps from readdir_r with ithreads |
d41150a6 NC |
15 | |
16 | When perl is configured to use ithreads, it will use re-entrant library calls | |
17 | in preference to non-re-entrant versions. There is a bug in FreeBSD's | |
e8d8eebf NC |
18 | C<readdir_r> function in versions 4.5 and earlier that can cause a SEGV when |
19 | reading large directories. A patch for FreeBSD libc is available | |
d41150a6 | 20 | (see http://www.freebsd.org/cgi/query-pr.cgi?pr=misc/30631 ) |
e8d8eebf | 21 | which has been integrated into FreeBSD 4.6. |
d41150a6 | 22 | |
3df9be30 | 23 | =head2 $^X doesn't always contain a full path in FreeBSD |
d41150a6 | 24 | |
7969fa3a NC |
25 | perl sets C<$^X> where possible to a full path by asking the operating |
26 | system. On FreeBSD the full path of the perl interpreter is found by using | |
27 | C<sysctl> with C<KERN_PROC_PATHNAME> if that is supported, else by reading | |
28 | the symlink F</proc/curproc/file>. FreeBSD 7 and earlier has a bug where | |
29 | either approach sometimes returns an incorrect value | |
d41150a6 NC |
30 | (see http://www.freebsd.org/cgi/query-pr.cgi?pr=35703 ). |
31 | In these cases perl will fall back to the old behaviour of using C's | |
32 | argv[0] value for C<$^X>. | |
33 | ||
34 | =head1 AUTHOR | |
35 | ||
36 | Nicholas Clark <nick@ccl4.org>, collating wisdom supplied by Slaven Rezic | |
37 | and Tim Bunce. | |
38 | ||
39 | Please report any errors, updates, or suggestions to F<perlbug@perl.org>. | |
40 |