xref: /openbsd-src/gnu/usr.bin/perl/README.openbsd (revision e068048151d29f2562a32185e21a8ba885482260)
1*e0680481Safresh1# vim: syntax=pod
2*e0680481Safresh1
352bd00bfSmillertIf you read this file _as_is_, just ignore the funny characters you
452bd00bfSmillertsee.  It is written in the POD format (see pod/perlpod.pod) which is
552bd00bfSmillertspecifically designed to be readable as is.
652bd00bfSmillert
752bd00bfSmillert=head1 NAME
852bd00bfSmillert
9898184e3Ssthenperlopenbsd - Perl version 5 on OpenBSD systems
1052bd00bfSmillert
1152bd00bfSmillert=head1 DESCRIPTION
1252bd00bfSmillert
1352bd00bfSmillertThis document describes various features of OpenBSD that will affect how Perl
1452bd00bfSmillertversion 5 (hereafter just Perl) is compiled and/or runs.
1552bd00bfSmillert
1652bd00bfSmillert=head2 OpenBSD core dumps from getprotobyname_r and getservbyname_r with ithreads
1752bd00bfSmillert
1852bd00bfSmillertWhen Perl is configured to use ithreads, it will use re-entrant library calls
19898184e3Ssthenin preference to non-re-entrant versions.  There is an incompatibility in
2052bd00bfSmillertOpenBSD's C<getprotobyname_r> and C<getservbyname_r> function in versions 3.7
2152bd00bfSmillertand later that will cause a SEGV when called without doing a C<bzero> on
2252bd00bfSmillerttheir return structs prior to calling these functions.  Current Perl's
2352bd00bfSmillertshould handle this problem correctly.  Older threaded Perls (5.8.6 or earlier)
2452bd00bfSmillertwill run into this problem.  If you want to run a threaded Perl on OpenBSD
2552bd00bfSmillert3.7 or higher, you will need to upgrade to at least Perl 5.8.7.
2652bd00bfSmillert
2752bd00bfSmillert=head1 AUTHOR
2852bd00bfSmillert
2952bd00bfSmillertSteve Peters <steve@fisharerojo.org>
3052bd00bfSmillert
3198dafc01Safresh1Please report any errors, updates, or suggestions to
3298dafc01Safresh1L<https://github.com/Perl/perl5/issues>.
3352bd00bfSmillert
34