1 Current state of the patches here is with respect to perl5.002b1d ;-).
3 ========================================================
5 The OS/2 patchkit was submitted by ilya@math.ohio-state.edu. I have
6 applied some parts that I suspect won't cause any problems.
7 Others do things that I haven't had time to fully consider.
9 Still other patches included here should perhaps be integrated with the
10 metaconfig package that generates Configure.
12 Andy Dougherty <doughera@lafcol.lafayette.edu>
14 ========================================================
18 patches should be applied as
20 All the diff.* files and POSIX.mkfifo should be applied.
22 Additional files are available on
23 ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
24 including patched pdksh and gnumake, needed for build.
30 This is not supposed to make a perfect Perl on OS/2. This patch is
31 concerned only with perfect _build_ of Perl on OS/2. A lot of good
32 features from Andreas Kaiser port missed this patch.
34 Annotations of changes: (part of what is below is already included by Andy,
35 ~~~~~~~~~~~~~~~~~~~~~~~ thus there are skips below)
42 a) mkfifo macro added to Posix.c
43 b) Copyright notice for OS/2 port changed
44 c) MYMALLOC section in perl.h moved (why?)
45 d) setgrent grent and getgrent wrapped in ifdef
46 e) declarations for #if defined(MYMALLOC) && defined(HIDEMYMALLOC)
48 f) some diagnostics added to tests
51 b) Support for extraction from NE style libraries.
54 lines did not have $ldopts.
55 d) The above variables are used throughout the file for checks
57 3) Build tools and libraries
60 a) ln changed to $ln in some places
61 b) Makefiles and related scripts made to use $(O), $(A), $(AR)
62 using the vars found by Configure or defaulted to
63 some reasonable value.
64 c) $firstmakefile is the file make looks onto before Makefile
65 d) $plibext is the extension for the perl library
66 e) $archobjs is the list of additional object files needed for
68 l) Makefile.SH : added sh in front of some commands
69 if $d_shrplib is 'custom', looks into
70 $osname/Makefile.$osname.SH to construct the section
71 on shared Perl library.
72 !!!!!! Also: installperl installman makedepend
73 !!!!!! added as dependencies to the corresponding
75 m) clean target extended to delete some intermediate files
77 Notes on build on OS/2:
78 ~~~~~~~~~~~~~~~~~~~~~~~
79 The change of C code in this patch is based on the ak port of 5.001+.
81 a) Make sure your sort is not the broken OS/2 one, and that you have /tmp
82 on the build partition.
84 b) when extraction perl5.*.tar.gz you need to extract perl5.*/Configure
85 separately, since by default perl5.001m/configure may overwrite it;
87 tar vzxf perl5.004.tar.gz --case-sensitive perl5.004/Configure
89 c) Necessary manual intervention when compiling on OS/2:
91 Need to put perl.dll on LIBPATH after it is created.
95 # Look for hints/os2.sh and correct what is different on your system
96 # I have rather spartan configuration.
98 # Prefix means where to install:
99 sh Configure -des -D prefix=f:/perl5.005
101 # Will probably die after build of miniperl (unless you have DLL
102 # from previous compile). Need to move DLL where it belongs
104 # Somehow with 5.002b3 I needed to type another make after pod2man
106 # some warnings in POSIX.c
108 # some tests fail, 9 or 10 on my system (see the list at end).
110 # before this you should create subdirs bin and lib in the
111 # prefix directory (f:/perl5.005 above):
114 e) At the end of August GNU make and pdksh were too buggy for compile.
115 Both maintainers have patches that make it possible to compile perl.
116 The binaries are included in
117 ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
118 patches are available too.
119 Note that the pdksh5.2.4 broke builds with -Zexe option because of a
120 changed order of executable extensions. A patch is sent to maintainer.
123 If you see that some '/' became '\' in pdksh 5.2.3, you did not apply
125 Same with segfaults in Make 3.74.
130 a) one of the latest tr is broken, get an old one :-(
131 1.11 works. (On compuserver?)
132 b) You need a perlglob.exe and link386.
133 c) Get rid of invalid perl.dll on your LIBPATH.
136 Send comments to ilya@math.ohio-state.edu.
138 ======================================================
139 Requires 0.9b (well, provision are made to make it build under 0.9a6,
140 but they are not tested, please inform me on success).
141 (earlier than 0.9b ttyname was not present, it is hard to maintain this
142 difference automatically, though I try).
143 ======================================================
145 You may try building with a.out style by using `-D emxaout' on the Configure
146 line (dynamic extensions should not use CRT (and/or any perl API) in this
147 case, which prohibits most buildin extensions). Probably no extension is
148 possible, since boot code should return the amount on stack.
150 The reason why compiling with a.out style executables leads to problems
151 with dynamic extensions is:
152 a) OS/2 does not export symbols from executables;
153 b) Thus if extension needs to import symbols from an application
154 the symbols for the application should reside in a .dll.
155 c) You cannot export data from a .dll compiled with a.out style.
156 On the other hand, aout-style compiled extension enjoys all the
157 (dis)advantages of fork().
159 ======================================================
160 Tests which fail with OMF compile:
162 io/fs.t: 2-5, 7-11, 18 as they should.
163 io/pipe: all, since open("|-") is not working (even with fork, so far).
164 lib/"all the dbm".t: 1 test should fail (file permission).
165 op/fork all fail, as they should
166 op/stat 3 20 35 as they should, 39 (-t on /dev/null) ???? Sometimes 4 ????
168 Segfault in socket ????, only if run with Testing tools.
170 A lot of `bad free'... in databases, bug in DB confirmed on other
173 Fail: Total 30 subtests (if stat:4 fails) in 10 scripts (one of 10
174 is socket, which runs OK standalone).
176 =======================================================
178 Changes to calls to external programs:
179 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
180 Due to a popular demand the perl external program calling has been changed.
181 _If_ perl needs to call an external program via shell, the sh.exe will be
182 called. The name of the shell is not overridable.
184 Thus means that you need to pickup some copy of a sh.exe as well (I use one
187 Reasons: a consensus on perl5-porters was that perl should use one
188 non-overridable shell per platform. The obvious choices for OS/2 are cmd.exe
189 and sh.exe. Having perl build itself would be impossible with cmd.exe as
190 a shell, thus I picked up sh.exe. Thus assures almost 100% compatibility
191 with the scripts coming from *nix.
193 Disadvantages: sh.exe calls external programs via fork/exec, and there is
194 _no_ functioning exec on OS/2. exec is emulated by EMX by asyncroneous call
195 while the caller waits for child completion (to pretend that pid did
196 not change). This means that 1 _extra_ copy of sh.exe is made active via
197 fork/exec, which may lead to some resources taken from the system.
199 The long-term solution proposed on p5-p is to have a directive
201 which will override system(), exec(), ``, and open(,' |'). With current
202 perl you may override only system(), readpipe() - the explicit version
203 of ``, and maybe exec(). The code will substitute a one-argument system
204 by CORE::system('cmd.exe', '/c', shift).
206 If you have some working code for OS2::Cmd.pm, please send it to me,
207 I will include it into distribution. I have no need for such a module, so
210 ===================================================
214 I include 3 extensions by Andread Kaiser, OS2::REXX, OS2::UPM, and OS2::FTP,
215 into my ftp directory, mirrored on CPAN. I made
216 some minor changes needed to compile them by standard tools. I cannot
217 test UPM and FTP, so I will appreciate your feedback.
219 The -R switch of older perl is deprecated. If you need to call a REXX code
220 which needs access to variables, include the call into a REXX compartment
222 REXX_call {...block...};
224 Two new functions are supported by REXX code,
226 REXX_eval_with 'string', REXX_function_name => \&perl_sub_reference;
228 If you have some other extensions you want to share, send the code to me.
229 Two jump to mind: tied access to EA's, and tied access to system databases.