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