xref: /openbsd-src/gnu/usr.bin/perl/README.hurd (revision e068048151d29f2562a32185e21a8ba885482260)
1# vim: syntax=pod
2
3If you read this file _as_is_, just ignore the funny characters you see.
4It is written in the POD format (see pod/perlpod.pod) which is specially
5designed to be readable as is.
6
7=head1 NAME
8
9perlhurd - Perl version 5 on Hurd
10
11=head1 DESCRIPTION
12
13If you want to use Perl on the Hurd, I recommend using the Debian
14GNU/Hurd distribution ( see L<https://www.debian.org/> ), even if an
15official, stable release has not yet been made.  The old "gnu-0.2"
16binary distribution will most certainly have additional problems.
17
18=head2 Known Problems with Perl on Hurd
19
20The Perl test suite may still report some errors on the Hurd.  The
21"lib/anydbm" and "pragma/warnings" tests will almost certainly fail.
22Both failures are not really specific to the Hurd, as indicated by the
23test suite output.
24
25The socket tests may fail if the network is not configured.  You have
26to make "/hurd/pfinet" the translator for "/servers/socket/2", giving
27it the right arguments.  Try "/hurd/pfinet --help" for more
28information.
29
30Here are the statistics for Perl 5.005_62 on my system:
31
32 Failed Test  Status Wstat Total Fail  Failed  List of failed
33 -----------------------------------------------------------------------
34 lib/anydbm.t                 12    1   8.33%  12
35 pragma/warnings             333    1   0.30%  215
36
37 8 tests and 24 subtests skipped.
38 Failed 2/229 test scripts, 99.13% okay. 2/10850 subtests failed,
39     99.98% okay.
40
41There are quite a few systems out there that do worse!
42
43However, since I am running a very recent Hurd snapshot, in which a lot of
44bugs that were exposed by the Perl test suite have been fixed, you may
45encounter more failures.  Likely candidates are: "op/stat", "lib/io_pipe",
46"lib/io_sock", "lib/io_udp" and "lib/time".
47
48In any way, if you're seeing failures beyond those mentioned in this
49document, please consider upgrading to the latest Hurd before reporting
50the failure as a bug.
51
52=head1 AUTHOR
53
54Mark Kettenis <kettenis@gnu.org>
55
56Last Updated: Fri, 29 Oct 1999 22:50:30 +0200
57
58