Re: [patch] IO::Socket::INET Broadcast patch
[perl.git] / README.beos
1 If you read this file _as_is_, just ignore the funny characters you see.
2 It is written in the POD format (see pod/perlpod.pod) which is specially
3 designed to be readable as is.
4
5 =head1 NAME
6
7 README.beos - Perl version 5 on BeOS
8
9 =head1 DESCRIPTION
10
11 Notes for building Perl under BeOS.
12
13 =head2 General Issues with Perl on BeOS
14
15 To compile perl under BeOS R4 x86:
16
17         ./Configure -d
18
19 and hit ^C when it asks you if you want to make changes to config.sh;
20 edit config.sh and do the following:
21 change d_socket='define' to ='undef';
22 remove SDBM, Errno, and Socket from dynamic_ext= and nonxs_ext=;
23 add '#define bool short' to x2p/a2p.h;
24
25         ../Configure -S; make; make install
26
27         cd ~/config/lib; ln -s 5.00502/BeOS-BePC/CORE/libperl.so .
28
29 (substitute 5.00502 with the appropriate filename)
30
31 =head2 BeOS Release-specific Notes
32
33 =over 4
34
35 =item R4 x86
36
37 Dynamic loading finally works! Yay! This means you can compile your
38 own modules into perl. However, Sockets and Errno still don't work.
39 (Hopefully, sockets will at least work by R5, if not sooner.)
40
41 =item R4 PPC
42
43 I have not tested this. I rather severely doubt that dynamic loading
44 will work. (My BeBox is in pieces right now, following a nasty disk
45 crash.) You may have to disable dynamic loading to get the thing to
46 compile at all. (use `./Configure` without -d, and say 'no' to 'Build
47 a shared libperl.so'.)
48
49 =back
50
51 =head2 Contact Information
52
53 If you have comments, problem reports, or even patches or bugfixes (gasp!)
54 please email me.
55
56 28 Jan 1999
57 Tom Spindler
58 dogcow@isi.net
59
60 =head2 Update 2002-03-02
61
62 The following tests fail on pre-5.8.0 Perl in BeOS Personal 5.0:
63
64         op/magic                        24-26
65         ext/POSIX/t/sigaction           13
66         ext/POSIX/t/waitpid             1
67         lib/ExtUtils/t/Installed        9-10 25-27 29-30 33-36
68
69 None of the failures look too serious:
70
71 =over 4
72
73 =item *
74
75 The op/magic failures look like something funny going on with $0 and
76 $^X that I can't now figure out: none of the generated pathnames are
77 wrong as such, they just seem to accumulate "./" prefixes and infixes
78 in ways that define logic.
79
80 =item *
81
82 The sigaction #13 means that signal mask doesn't get properly restored
83 if sigaction returns early.
84
85 =item *
86
87 The waitpid failure means that after there are no more child
88 processes, waitpid is supposed to start returning -1 (and set
89 errno to ECHILD).  In BeOS, it doesn't seem to.
90
91 =item *
92
93 The Installed test has some filesystem portability assumptions.
94
95 =back
96
97 Disclaimer: I just installed BeOS Personal Edition 5.0 and the
98 Developer Tools, that is the whole extent of my BeOS expertise,
99 so please don't ask me for further help in BeOS Perl problems.
100
101 jhi@iki.fi