Commit | Line | Data |
---|---|---|
a83b6f46 JH |
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 JH |
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 JH |
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 JH |
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 JH |
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 JH |
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 AD |
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 JH |
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 JH |
73 | |
74 | =over 4 | |
75 | ||
76 | =item * | |
77 | ||
8c1bea16 JH |
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 JH |
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 JH |
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 JH |
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 JH |
102 | processes, waitpid is supposed to start returning -1 (and set |
103 | errno to ECHILD). In BeOS, it doesn't seem to. | |
dff18f87 JH |
104 | |
105 | =item * | |
106 | ||
8c1bea16 JH |
107 | The Tie/File/t/16_handle seems to indicate some brokenness |
108 | (non-UNIXness) in how BeOS handles pipes. | |
dff18f87 JH |
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 JH |
115 | |
116 | jhi@iki.fi |