home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tcl2-73c.zip / tcl7.3 / porting.notes < prev    next >
Text File  |  1993-10-31  |  8KB  |  215 lines
  1. This file contains a collection of notes that various people have
  2. provided about porting Tcl to various machines and operating systems.
  3. I don't have personal access to any of these machines, so I make
  4. no guarantees that the notes are correct, complete, or up-to-date.
  5. In some cases, a person has volunteered to act as a contact point
  6. for questions about porting Tcl to a particular machine;  in these
  7. cases the person's name and e-mail address are listed.
  8.  
  9. ---------------------------------------------
  10. Cray machines running UNICOS:
  11. Contact: John Freeman (jlf@cray.com)
  12. ---------------------------------------------
  13.  
  14. 1. There is an error in the strstr function in UNICOS such that if the
  15. string to be searched is empty (""), the search will continue past the
  16. end of the string.  Because of this, the history substitution loop
  17. will sometimes run past the end of its target string and trash
  18. malloc's free list, resulting in a core dump some time later.  (As you
  19. can probably guess, this took a while to diagnose.)  I've submitted a
  20. problem report to the C library maintainers, but in the meantime here
  21. is a workaround.
  22.  
  23. -----------------------------------------------------------------
  24. diff -c1 -r1.1 tclHistory.c
  25. *** 1.1    1991/11/12 16:01:58
  26. --- tclHistory.c    1991/11/12 16:14:22
  27. ***************
  28. *** 23,24 ****
  29. --- 23,29 ----
  30.   #include "tclInt.h"
  31. + 
  32. + #ifdef _CRAY
  33. + /* There is a bug in strstr in UNICOS; this works around it. */
  34. + #define strstr(s1,s2) ((s1)?(*(s1)?strstr((s1),(s2)):0):0)
  35. + #endif _CRAY
  36.  
  37. ---------------------------------------------
  38. MIPS systems runing EP/IX:
  39. ---------------------------------------------
  40.  
  41. 1. Need to add a line "#include <bsd/sys/time.h>" in tclUnix.h.
  42.  
  43. 2. Need to add "-lbsd" into the line that makes tclTest:
  44.  
  45.     ${CC} ${CFLAGS} tclTest.o libtcl.a -lbsd -o tclTest
  46.  
  47. ---------------------------------------------
  48. IBM RS/6000 systems running AIX:
  49. ---------------------------------------------
  50.  
  51. 1. The system version of strtoul is buggy, at least under some
  52. versions of AIX.  If the expression tests fail, try forcing Tcl
  53. to use its own version of strtoul instead of the system version.
  54. To do this, first copy strtoul.c from the compat subdirectory up
  55. to the main Tcl directory.  Then modify the Makefile so that
  56. the definition for COMPAT_OBJS includes "strtoul.o".  Note:  the
  57. "config" script should now detect the buggy strtoul and substitute
  58. Tcl's version automatically.
  59.  
  60. 2. You may have to comment out the declaration of open in tclUnix.h.
  61.  
  62. 3. You may need to add "-D_BSD -lbsd" to the CFLAGS definition.  This
  63. causes the system include files to look like BSD include files and
  64. causes C library routines to act like bsd library routines.  Without
  65. this, the system may choke on "struct wait".
  66.  
  67. ---------------------------------------------
  68. AT&T 4.03 OS:
  69. ---------------------------------------------
  70.  
  71. Machine: i386/33Mhz i387 32k Cache 16MByte 
  72. OS: AT&T SYSV Release 4 Version 3
  73. X: X11R5 fixlevel 9
  74. Xserver: X386 1.2
  75.  
  76. 1. Change the Tk Makefile as follows:
  77. XLIB            = -lX11
  78.     should be changed to:
  79. XLIB            = -lX11 -lsocket -lnsl
  80.  
  81. -------------------------------------------------------
  82. Silicon Graphics systems:
  83. -------------------------------------------------------
  84.  
  85. 1. Change the CC variable in the Makefile to:
  86.  
  87. CC =        cc -xansi -D__STDC__ -signed
  88.  
  89. 2. In  Irix releases 4.0.1 or earlier the C compiler has a buggy optimizer.
  90.    If Tcl fails its test suite or generates inexplicable errors,
  91.    compile tclVar.c with -O0 instead of -O.
  92.  
  93. 3. For IRIX 5.1 or later, comments 1 and 2 are no longer relevant,
  94. but you must add -D_BSD_SIGNALS to CFLAGS to get the proper signal
  95. routines.
  96.  
  97. 4. Add a "-lsun" switch in the targets for tclsh and tcltest,
  98. just before ${MATH_LIBS}.
  99.  
  100. ---------------------------------------------
  101. NeXT machines running NeXTStep 3.1:
  102. ---------------------------------------------
  103.  
  104. 1. Run configure with predefined CPP:
  105.     CPP='cc -E' ./configure
  106.     
  107. 2. Edit Makefile: 
  108.   -add tmpnam.o to COMPAT_OBJS:
  109.     COMPAT_OBJS =         getcwd.o waitpid.o strtod.o tmpnam.o
  110.   -add '-m' to MATH_LIBS
  111.     MATH_LIBS = -m -lm  
  112.  
  113. 3. Edit compat/tmpnam.o and replace "/usr/tmp" with "/tmp"
  114.  
  115. After this, tcl7.0 will be build fine on NeXT (ignore linker warning)
  116. and run all the tests. There are some formatting problems in printf() or
  117. scanf() which come from NeXT's lacking POSIX conformance. Ignore those
  118. errors, they don't matter much.
  119.  
  120. -------------------------------------------------
  121. ISC 2.2 UNIX (using standard ATT SYSV compiler):
  122. -------------------------------------------------
  123.  
  124. In Makefile, change
  125.  
  126. CFLAGS =      -g -I. -DTCL_LIBRARY=\"${TCL_LIBRARY}\"
  127.  
  128. to
  129.  
  130. CFLAGS =      -g -I. -DPOSIX_JC -DTCL_LIBRARY=\"${TCL_LIBRARY}\"
  131.  
  132. This brings in the typedef for pid_t, which is needed for
  133. /usr/include/sys/wait.h in tclUnix.h.
  134.  
  135. ---------------------------------------------
  136. DEC Alphas:
  137. ---------------------------------------------
  138.  
  139. 1. There appears to be a compiler/library bug that causes core-dumps
  140. unless you compile tclVar.c without optimization (remove the -O compiler
  141. switch).  The problem appears to have been fixed in the 1.3-4 version
  142. of the compiler.
  143.  
  144. ---------------------------------------------
  145. CDC 4680MNP, EP/IX 1.4.3:
  146. ---------------------------------------------
  147.  
  148. The installation was done in the System V environment (-systype sysv)
  149. with the BSD extensions available (-I/usr/include/bsd and -lbsd).  It was
  150. built with the 2.20 level C compiler.  The 2.11 level should not be used
  151. because it has a problem with detecting NaN values in lines like:
  152.     if (x != x) ...
  153. which appear in the TCL code.
  154.  
  155. To make the configure script find the BSD extensions, I set environment
  156. variable DEFS to "-I/usr/include/bsd" and LIBS to "-lbsd" before
  157. running it.  I would have also set CC to "cc2.20", but that compiler
  158. driver has a bug that loader errors (e.g. not finding a library routine,
  159. which the script uses to tell what is available) do not cause an error
  160. status to be returned to the shell.
  161.  
  162. There is a bug in the <sys/wait.h> include file that mis-defines the
  163. structure fields and causes WIFEXITED and WIFSIGNALED to return incorrect
  164. values.  My solution was to create a subdirectory "sys" of the main TCL
  165. source directory and put a corrected wait.h in it.  The "-I." already on
  166. all the compile lines causes it to be used instead of the system version.
  167. To fix this, compare the structure definition in /usr/include/bsd/sys/wait.h
  168. with /bsd43/include/sys/wait.h (or mail to John Jackson, jrj@cc.purdue.edu,
  169. and he'll send you a context diff).
  170.  
  171. After running configure, I made the following changes to Makefile:
  172.  
  173.     1)  In AC_FLAGS, change:
  174.         -DNO_WAIT3=1
  175.     to
  176.         -DNO_WAIT3=0 -Dwait3=wait2
  177.     EP/IX (in the System V environment) provides a wait2() system
  178.     call with what TCL needs (the WNOHANG flag).  The extra parameter
  179.     TCL passes to what it thinks is wait3() (the resources used by
  180.     the child process) is always zero and will be safely ignored.
  181.  
  182.     3)  Change:
  183.         CC=cc
  184.     to
  185.         CC=cc2.20
  186.     because of the NaN problem mentioned earlier.  Skip this if the
  187.     default compiler is already 2.20 (or later).
  188.  
  189.     4)  Add "-lbsd" to the commands that create tclsh and tcltest
  190.     (look for "-o").
  191.  
  192. ---------------------------------------------
  193. Convex systems, OS 10.1 and 10.2:
  194. Contact: Lennart Sorth (ls@dmi.min.dk)
  195. ---------------------------------------------
  196.  
  197. 1. tcl7.0b2 compiles on Convex systems (OS 10.1 and 10.2) by just running 
  198.   configure, typing make, except tclUnixUtil.c needs to be compiled
  199.   with option "-pcc" (portable cc, =!ANSI) due to:
  200.   cc: Error on line 1111 of tclUnixUtil.c: 'waitpid' redeclared:
  201.   incompatible types.
  202.  
  203. -------------------------------------------------
  204. Pyramid, OSx 5.1a (UCB universe, GCC installed):
  205. -------------------------------------------------
  206.  
  207. 1. The procedures memcpy, strchr, fmod, and strrchr are all missing,
  208. so you'll need to provide substitutes for them.  After you do that
  209. everything should compile fine.  There will be one error in a scan
  210. test, but it's an obscure one because of a non-ANSI implementation
  211. of sscanf on the machine;  you can ignore it.
  212.  
  213. 2. You may also have to add "tmpnam.o" to COMPAT_OBJS in Makefile:
  214. the system version appears to be bad.
  215.