xref: /openbsd-src/gnu/usr.bin/perl/README.hurd (revision e068048151d29f2562a32185e21a8ba885482260)
1*e0680481Safresh1# vim: syntax=pod
2*e0680481Safresh1
355745691SmillertIf you read this file _as_is_, just ignore the funny characters you see.
455745691SmillertIt is written in the POD format (see pod/perlpod.pod) which is specially
555745691Smillertdesigned to be readable as is.
655745691Smillert
755745691Smillert=head1 NAME
855745691Smillert
9898184e3Ssthenperlhurd - Perl version 5 on Hurd
1055745691Smillert
1155745691Smillert=head1 DESCRIPTION
120a5f61bbSmillert
130a5f61bbSmillertIf you want to use Perl on the Hurd, I recommend using the Debian
1456d68f1eSafresh1GNU/Hurd distribution ( see L<https://www.debian.org/> ), even if an
1552bd00bfSmillertofficial, stable release has not yet been made.  The old "gnu-0.2"
160a5f61bbSmillertbinary distribution will most certainly have additional problems.
170a5f61bbSmillert
1855745691Smillert=head2 Known Problems with Perl on Hurd
190a5f61bbSmillert
200a5f61bbSmillertThe Perl test suite may still report some errors on the Hurd.  The
2152bd00bfSmillert"lib/anydbm" and "pragma/warnings" tests will almost certainly fail.
22c8ca9003SmillertBoth failures are not really specific to the Hurd, as indicated by the
23c8ca9003Smillerttest suite output.
240a5f61bbSmillert
250a5f61bbSmillertThe socket tests may fail if the network is not configured.  You have
2652bd00bfSmillertto make "/hurd/pfinet" the translator for "/servers/socket/2", giving
2752bd00bfSmillertit the right arguments.  Try "/hurd/pfinet --help" for more
280a5f61bbSmillertinformation.
290a5f61bbSmillert
30c8ca9003SmillertHere are the statistics for Perl 5.005_62 on my system:
310a5f61bbSmillert
320a5f61bbSmillert Failed Test  Status Wstat Total Fail  Failed  List of failed
33b8851fccSafresh1 -----------------------------------------------------------------------
340a5f61bbSmillert lib/anydbm.t                 12    1   8.33%  12
35c8ca9003Smillert pragma/warnings             333    1   0.30%  215
3655745691Smillert
37c8ca9003Smillert 8 tests and 24 subtests skipped.
38b8851fccSafresh1 Failed 2/229 test scripts, 99.13% okay. 2/10850 subtests failed,
39b8851fccSafresh1     99.98% okay.
400a5f61bbSmillert
410a5f61bbSmillertThere are quite a few systems out there that do worse!
420a5f61bbSmillert
430a5f61bbSmillertHowever, since I am running a very recent Hurd snapshot, in which a lot of
440a5f61bbSmillertbugs that were exposed by the Perl test suite have been fixed, you may
4552bd00bfSmillertencounter more failures.  Likely candidates are: "op/stat", "lib/io_pipe",
4652bd00bfSmillert"lib/io_sock", "lib/io_udp" and "lib/time".
470a5f61bbSmillert
48c8ca9003SmillertIn any way, if you're seeing failures beyond those mentioned in this
49c8ca9003Smillertdocument, please consider upgrading to the latest Hurd before reporting
50c8ca9003Smillertthe failure as a bug.
5155745691Smillert
5255745691Smillert=head1 AUTHOR
5355745691Smillert
5455745691SmillertMark Kettenis <kettenis@gnu.org>
5555745691Smillert
5655745691SmillertLast Updated: Fri, 29 Oct 1999 22:50:30 +0200
5755745691Smillert
58