os2/README

   1 Current state of the patches here is with respect to perl5.002b1d ;-).
   2
   3 ========================================================
   4
   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.
   8
   9 Still other patches included here should perhaps be integrated with the
  10 metaconfig package that generates Configure.
  11
  12         Andy Dougherty          <doughera@lafcol.lafayette.edu>
  13
  14 ========================================================
  15
  16 Notes on the patch:
  17 ~~~~~~~~~~~~~~~~~~~
  18 patches should be applied as
  19         patch -p0 <.....
  20 All the diff.* files and POSIX.mkfifo should be applied.
  21
  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.
  25
  26
  27 Target:
  28 ~~~~~~~
  29
  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.
  33
  34 Annotations of changes: (part of what is below is already included by Andy,
  35 ~~~~~~~~~~~~~~~~~~~~~~~ thus there are skips below)
  36 1) C files
  37 2) Configure
  38 3) MakeMaker
  39 4) Build tools
  40
  41 1) C files
  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)
  47                 added
  48         f) some diagnostics added to tests
  49
  50 2) Configure
  51         b) Support for extraction from NE style libraries.
  52         c) a lot of
  53                         cc -o whatever
  54                 lines did not have $ldopts.
  55         d) The above variables are used throughout the file for checks
  56
  57 3) Build tools and libraries
  58
  59
  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
  67                 local build.
  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
  74                 !!!!!!          targets.
  75         m) clean target extended to delete some intermediate files
  76
  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+.
  80
  81 a) Make sure your sort is not the broken OS/2 one, and that you have /tmp
  82 on the build partition.
  83
  84 b) when extraction perl5.*.tar.gz you need to extract perl5.*/Configure
  85 separately, since by default perl5.001m/configure may overwrite it;
  86         like this:
  87                 tar vzxf perl5.004.tar.gz perl5.004/Configure
  88
  89 c) Necessary manual intervention when compiling on OS/2:
  90
  91         Need to put perl.dll on LIBPATH after it is created.
  92
  93 d) Compile summary:
  94
  95 # Look for hints/os2.sh and correct what is different on your system
  96 # I have rather spartan configuration.
  97
  98         # Prefix means where to install:
  99 sh Configure -des -D prefix=f:/perl5.005
 100 make
 101         # Will probably die after build of miniperl (unless you have DLL
 102         # from previous compile). Need to move DLL where it belongs
 103         #
 104         # Somehow with 5.002b3 I needed to type another make after pod2man
 105 make
 106         # some warnings in POSIX.c
 107 make test
 108         # some tests fail, 9 or 10 on my system (see the list at end).
 109         #
 110         # before this you should create subdirs bin and lib in the
 111         # prefix directory (f:/perl5.005 above):
 112 make install
 113
 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.
 121
 122 !!!!!!!!!!!!!!!!!
 123 If you see that some '/' became '\' in pdksh 5.2.3, you did not apply
 124 my patches!
 125 Same with segfaults in Make 3.74.
 126 !!!!!!!!!!!!!!!!!
 127
 128 Problems reported:
 129
 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.
 134
 135
 136 Send comments to ilya@math.ohio-state.edu.
 137
 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 ======================================================
 144
 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.
 149
 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().
 158
 159 ======================================================
 160 Tests which fail with OMF compile:
 161
 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 ????
 167
 168 Segfault in socket ????, only if run with Testing tools.
 169
 170 A lot of `bad free'... in databases, bug in DB confirmed on other
 171 platforms.
 172
 173 Fail: Total 30 subtests (if stat:4 fails) in 10 scripts (one of 10
 174 is socket, which runs OK standalone).
 175
 176 =======================================================
 177
 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.
 183
 184 Thus means that you need to pickup some copy of a sh.exe as well (I use one
 185 from pdksh).
 186
 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.
 192
 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.
 198
 199 The long-term solution proposed on p5-p is to have a directive
 200         use OS2::Cmd;
 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).
 205
 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
 208 cannot test it.
 209
 210 ===================================================
 211
 212 OS/2 extensions
 213 ~~~~~~~~~~~~~~~
 214 I include 3 extensions by Andread Kaiser, OS2::REXX, OS2::UPM, and OS2::FTP,
 215 with minor changes needed to compile them by standard tools. I cannot
 216 test UPM and FTP, so I will appreciate your feedback.
 217
 218 The -R switch of older perl is deprecated. If you need to call a REXX code
 219 which needs access to variables, include the call into a REXX compartment
 220 created by
 221         REXX_call {block};
 222
 223 Two new functions are supported by REXX code,
 224         REXX_eval 'string';
 225         REXX_eval_with 'string', REXX_function_name => \&perl_sub_reference;
 226
 227 If you have some other extensions you want to share, send the code to me.
 228 Two jump to mind: tied access to EA's, and tied access to system databases.