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