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