xref: /openbsd/gnu/usr.bin/perl/README.openbsd (revision e0680481)
1# vim: syntax=pod
2
3If you read this file _as_is_, just ignore the funny characters you
4see.  It is written in the POD format (see pod/perlpod.pod) which is
5specifically designed to be readable as is.
6
7=head1 NAME
8
9perlopenbsd - Perl version 5 on OpenBSD systems
10
11=head1 DESCRIPTION
12
13This document describes various features of OpenBSD that will affect how Perl
14version 5 (hereafter just Perl) is compiled and/or runs.
15
16=head2 OpenBSD core dumps from getprotobyname_r and getservbyname_r with ithreads
17
18When Perl is configured to use ithreads, it will use re-entrant library calls
19in preference to non-re-entrant versions.  There is an incompatibility in
20OpenBSD's C<getprotobyname_r> and C<getservbyname_r> function in versions 3.7
21and later that will cause a SEGV when called without doing a C<bzero> on
22their return structs prior to calling these functions.  Current Perl's
23should handle this problem correctly.  Older threaded Perls (5.8.6 or earlier)
24will run into this problem.  If you want to run a threaded Perl on OpenBSD
253.7 or higher, you will need to upgrade to at least Perl 5.8.7.
26
27=head1 AUTHOR
28
29Steve Peters <steve@fisharerojo.org>
30
31Please report any errors, updates, or suggestions to
32L<https://github.com/Perl/perl5/issues>.
33
34