[perl5.git] / README.openbsd

# vim: syntax=pod

If you read this file _as_is_, just ignore the funny characters you
see.  It is written in the POD format (see pod/perlpod.pod) which is
specifically designed to be readable as is.

=head1 NAME

perlopenbsd - Perl version 5 on OpenBSD systems

=head1 DESCRIPTION

This document describes various features of OpenBSD that will affect how Perl
version 5 (hereafter just Perl) is compiled and/or runs.

=head2 OpenBSD core dumps from getprotobyname_r and getservbyname_r with ithreads

When Perl is configured to use ithreads, it will use re-entrant library calls
in preference to non-re-entrant versions.  There is an incompatibility in
OpenBSD's C<getprotobyname_r> and C<getservbyname_r> function in versions 3.7
and later that will cause a SEGV when called without doing a C<bzero> on
their return structs prior to calling these functions.  Current Perl's
should handle this problem correctly.  Older threaded Perls (5.8.6 or earlier)
will run into this problem.  If you want to run a threaded Perl on OpenBSD
3.7 or higher, you will need to upgrade to at least Perl 5.8.7.

=head1 AUTHOR

Steve Peters <steve@fisharerojo.org>

Please report any errors, updates, or suggestions to
L<https://github.com/Perl/perl5/issues>.
Commit	Line	Data
ffe25ee3 B	1	# vim: syntax=pod
ffe25ee3 B	2
23e2b7a9 SP	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
de2902a6	9	perlopenbsd - Perl version 5 on OpenBSD systems
23e2b7a9 SP	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
f858446f	19	in preference to non-re-entrant versions. There is an incompatibility in
23e2b7a9 SP	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
8166b4e0 DB	31	Please report any errors, updates, or suggestions to
8166b4e0 DB	32	L<https://github.com/Perl/perl5/issues>.
23e2b7a9	33