.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PERLHURD 1"
.TH PERLHURD 1 "2023-11-25" "perl v5.36.0" "Perl Programmers Reference Guide"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
perlhurd \- Perl version 5 on Hurd
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
If you want to use Perl on the Hurd, I recommend using the Debian
GNU/Hurd distribution ( see <https://www.debian.org/> ), even if an
official, stable release has not yet been made.  The old \*(L"gnu\-0.2\*(R"
binary distribution will most certainly have additional problems.
.SS "Known Problems with Perl on Hurd"
.IX Subsection "Known Problems with Perl on Hurd"
The Perl test suite may still report some errors on the Hurd.  The
\&\*(L"lib/anydbm\*(R" and \*(L"pragma/warnings\*(R" tests will almost certainly fail.
Both failures are not really specific to the Hurd, as indicated by the
test suite output.
.PP
The socket tests may fail if the network is not configured.  You have
to make \*(L"/hurd/pfinet\*(R" the translator for \*(L"/servers/socket/2\*(R", giving
it the right arguments.  Try \*(L"/hurd/pfinet \-\-help\*(R" for more
information.
.PP
Here are the statistics for Perl 5.005_62 on my system:
.PP
.Vb 4
\& Failed Test  Status Wstat Total Fail  Failed  List of failed
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\& lib/anydbm.t                 12    1   8.33%  12
\& pragma/warnings             333    1   0.30%  215
\&
\& 8 tests and 24 subtests skipped.
\& Failed 2/229 test scripts, 99.13% okay. 2/10850 subtests failed,
\&     99.98% okay.
.Ve
.PP
There are quite a few systems out there that do worse!
.PP
However, since I am running a very recent Hurd snapshot, in which a lot of
bugs that were exposed by the Perl test suite have been fixed, you may
encounter more failures.  Likely candidates are: \*(L"op/stat\*(R", \*(L"lib/io_pipe\*(R",
\&\*(L"lib/io_sock\*(R", \*(L"lib/io_udp\*(R" and \*(L"lib/time\*(R".
.PP
In any way, if you're seeing failures beyond those mentioned in this
document, please consider upgrading to the latest Hurd before reporting
the failure as a bug.
.SH "AUTHOR"
.IX Header "AUTHOR"
Mark Kettenis <kettenis@gnu.org>
.PP
Last Updated: Fri, 29 Oct 1999 22:50:30 +0200