Commit | Line | Data |
a83b6f46 |
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. |
c4f23d77 |
4 | |
a83b6f46 |
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 |
c4f23d77 |
14 | |
46193409 |
15 | To compile perl under BeOS R4 x86: |
c4f23d77 |
16 | |
a83b6f46 |
17 | ./Configure -d |
c4f23d77 |
18 | |
a83b6f46 |
19 | and hit ^C when it asks you if you want to make changes to config.sh; |
46193409 |
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=; |
46193409 |
23 | add '#define bool short' to x2p/a2p.h; |
c4f23d77 |
24 | |
a83b6f46 |
25 | ../Configure -S; make; make install |
26 | |
27 | cd ~/config/lib; ln -s 5.00502/BeOS-BePC/CORE/libperl.so . |
c4f23d77 |
28 | |
46193409 |
29 | (substitute 5.00502 with the appropriate filename) |
c4f23d77 |
30 | |
a83b6f46 |
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. |
46193409 |
39 | (Hopefully, sockets will at least work by R5, if not sooner.) |
c4f23d77 |
40 | |
a83b6f46 |
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 |
c4f23d77 |
52 | |
c4f23d77 |
53 | If you have comments, problem reports, or even patches or bugfixes (gasp!) |
54 | please email me. |
55 | |
46193409 |
56 | 28 Jan 1999 |
c4f23d77 |
57 | Tom Spindler |
46193409 |
58 | dogcow@isi.net |
c4f23d77 |
59 | |
8c1bea16 |
60 | =head2 Update 2002-05-25 |
dff18f87 |
61 | |
8c1bea16 |
62 | The following tests fail on 5.8.0 Perl in BeOS Personal 5.03: |
dff18f87 |
63 | |
8c1bea16 |
64 | t/op/lfs............................FAILED at test 17 |
65 | t/op/magic..........................FAILED at test 24 |
66 | ext/Fcntl/t/syslfs..................FAILED at test 17 |
67 | ext/File/Glob/t/basic...............FAILED at test 3 |
68 | ext/POSIX/t/sigaction...............FAILED at test 13 |
69 | ext/POSIX/t/waitpid.................FAILED at test 1 |
70 | lib/Tie/File/t/16_handle............FAILED at test 39 |
dff18f87 |
71 | |
8c1bea16 |
72 | The reasons for the failures are as follows: |
dff18f87 |
73 | |
74 | =over 4 |
75 | |
76 | =item * |
77 | |
8c1bea16 |
78 | The op/lfs and Fcntl/t/syslfs seem to hit a real bug: though we can |
79 | seek around past the 2GB limit, reading from there doesn't work. |
80 | Therefore, please don't try doing large files in BeOS with Perl. |
81 | |
82 | =item * |
83 | |
dff18f87 |
84 | The op/magic failures look like something funny going on with $0 and |
85 | $^X that I can't now figure out: none of the generated pathnames are |
86 | wrong as such, they just seem to accumulate "./" prefixes and infixes |
87 | in ways that define logic. |
88 | |
89 | =item * |
90 | |
8c1bea16 |
91 | The Glob/t/basic indicates a bug in the getpw*() functions of Perl: |
92 | they do not always return the correct user db entries. |
93 | |
94 | =item * |
95 | |
dff18f87 |
96 | The sigaction #13 means that signal mask doesn't get properly restored |
97 | if sigaction returns early. |
98 | |
99 | =item * |
100 | |
101 | The waitpid failure means that after there are no more child |
9c966d23 |
102 | processes, waitpid is supposed to start returning -1 (and set |
103 | errno to ECHILD). In BeOS, it doesn't seem to. |
dff18f87 |
104 | |
105 | =item * |
106 | |
8c1bea16 |
107 | The Tie/File/t/16_handle seems to indicate some brokenness |
108 | (non-UNIXness) in how BeOS handles pipes. |
dff18f87 |
109 | |
110 | =back |
111 | |
112 | Disclaimer: I just installed BeOS Personal Edition 5.0 and the |
113 | Developer Tools, that is the whole extent of my BeOS expertise, |
9c966d23 |
114 | so please don't ask me for further help in BeOS Perl problems. |
dff18f87 |
115 | |
116 | jhi@iki.fi |