home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Tcl-Tk 8.0 / Pre-installed version / tcl8.0 / unix / porting.notes < prev    next >
Encoding:
Text File  |  1997-08-15  |  12.7 KB  |  393 lines  |  [TEXT/ALFA]
  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. If you see the word "I" in any explanations, it refers to the person
  6. who contributed the information, not to me;  this means that I
  7. probably can't answer any questions about any of this stuff.  In
  8. some cases, a person has volunteered to act as a contact point for
  9. questions about porting Tcl to a particular machine;  in these
  10. cases the person's name and e-mail address are listed.  I'm
  11. interested in getting new porting information to add to the file;
  12. please mail updates to "john.ousterhout@eng.sun.com".
  13.  
  14. This file reflects information provided for Tcl 7.4 and later releases.
  15. If there is no information for your configuration in this file, check
  16. the file "porting.old" too;  it contains information that was
  17. submitted for Tcl 7.3 and earlier releases, and some of that information
  18. may still be valid.
  19.  
  20. A new porting database has recently become available on the Web at
  21. the following URL:
  22.     http://www.sunlabs.com/cgi-bin/tcl/info.4.0
  23. This page provides information about the platforms on which Tcl 7.4
  24. and Tk 4.0 have been compiled and what changes were needed to get Tcl
  25. and Tk to compile.  You can also add new entries to that database
  26. when you install Tcl and Tk on a new platform.  The Web database is
  27. likely to be more up-to-date than this file.
  28.  
  29. sccsid = SCCS: @(#) porting.notes 1.18 96/12/31 14:50:27
  30.  
  31. --------------------------------------------
  32. Solaris, various versions
  33. --------------------------------------------
  34.  
  35. 1. If typing "make test" results in an error message saying that
  36. there are no "*.test" files, or you get lots of globbing errors,
  37. it's probably because your system doesn't have cc installed and
  38. you used gcc.  In order for this to work, you have to set your
  39. CC environment variable to gcc and your CPP environment variable
  40. to "gcc -E" before running the configure script.
  41.  
  42. 2. Make sure that /usr/ucb is not in your PATH or LD_LIBRARY_PATH
  43. environment variables;  this will cause confusion between the new
  44. Solaris libraries and older UCB versions (Tcl will expect one version
  45. and get another).
  46.  
  47. 3. There have been several reports of problems with the "glob" command.
  48. So far these reports have all been for older versions of Tcl, but
  49. if you run into problems, edit the Makefile after "configure" is
  50. run and add "-DNO_DIRENT_H=1" to the definitions of DEFS.  Do this
  51. before compiling.
  52.  
  53. --------------------------------------------
  54. Pyramid DC/OSx SVr4, DC/OSx version 94c079
  55. --------------------------------------------
  56.  
  57. Tcl seems to dump core in cmdinfo.test when compiled with the
  58. optimiser turned on in TclEval which calls 'free'.  To get around
  59. this, turn the optimiser off.
  60.  
  61. --------------------------------------------
  62. SGI machines, IRIX 5.2, 5.3, IRIX64 6.0.1
  63. --------------------------------------------
  64.  
  65. 1. If you compile with gcc-2.6.3 under some versions of IRIX (e.g.
  66.    4.0.5), DBL_MAX is defined too large for gcc and Tcl complains
  67.    about all floating-point values being too large to represent.
  68.    If this happens, redefining DBL_MAX to 9.99e299.
  69.  
  70. 2. Add "-D_BSD_TIME" to CFLAGS in Makefile.  This avoids type conflicts
  71. in the prototype for the gettimeofday procedure.
  72.  
  73. 2. If you're running under Irix 6.x and tclsh dumps core, try
  74. removing -O from the CFLAGS in Makefile and recompiling;  compiler
  75. optimizations seem to cause problems on some machines.
  76.  
  77. --------------------------------------------
  78. IBM RTs, AOS
  79. --------------------------------------------
  80.  
  81. 1. Steal fmod from 4.4BSD
  82. 2. Add a #define to tclExpr such that:
  83. extern double fmod(); 
  84. is defined conditionally on ibm032
  85.  
  86. --------------------------------------------
  87. QNX 4.22
  88. --------------------------------------------
  89.  
  90. tclPort.h
  91.     - commented out 2 lines containing #include <sys/param.h>
  92.  
  93. tcl.h
  94.     - changed  #define VARARGS ()
  95.     - to       #ifndef __QNX__
  96.                  #define VARARGS ()
  97.                #else
  98.                  #define VARARGS (void *, ...)
  99.                #endif
  100.  
  101. --------------------------------------------
  102. Interactive UNIX
  103. --------------------------------------------
  104.  
  105. Add the switch -Xp to LIBS in Makefile;  otherwise strftime will not
  106. be found when linking.
  107.  
  108. --------------------------------------------
  109. Motorola SVR4 V4.2 (m88k)
  110. --------------------------------------------
  111.  
  112. For Motorola Unix R40V4.2 (m88k architechure), use /usr/ucb/cc instead of
  113. /usr/bin/cc.  Otherwise, the compile will fail because of conflicts over
  114. the gettimeofday() call.
  115.  
  116. Also, -DNO_DIRENT_H=1 is required for the "glob" command to work.
  117.  
  118. --------------------------------------------
  119. NeXTSTEP 3.x
  120. --------------------------------------------
  121.  
  122. Here's the set of changes I made to make 7.5b3 compile cleanly on
  123. NeXTSTEP3.x.
  124.  
  125. Here are a couple lines from unix/Makefile:
  126.  
  127. # Added utsname.o, which implements a uname() emulation for NeXTSTEP.
  128. COMPAT_OBJS =         getcwd.o strtod.o tmpnam.o utsname.o
  129.  
  130. TCL_NAMES=\
  131.     -Dstrtod=tcl_strtod -Dtmpnam=tcl_tmpnam -Dgetcwd=tcl_getcwd \
  132.     -Dpanic=tcl_panic -Dmatherr=tcl_matherr \
  133.     -Duname=tcl_uname -Dutsname=tcl_utsname
  134.  
  135. # Added mode_t, pid_t, and O_NONBLOCK definitions.
  136. AC_FLAGS =         -DNO_DIRENT_H=1 -DHAVE_UNISTD_H=1 -DHAVE_SYS_TIME_H=1  
  137. -DTIME_WITH_SYS_TIME=1 -DHAVE_TM_ZONE=1 -DHAVE_TM_GMTOFF=1 -DHAVE_TIMEZONE_VAR=1  
  138. -DSTDC_HEADERS=1 -Dmode_t=int -Dpid_t=int -DO_NONBLOCK=O_NDELAY ${TCL_NAMES}
  139.  
  140.  
  141. Here are diffs for other files.  utsname.[hc] are a couple files I added
  142. to compat/  I'm not clear whether that's where they legitimately belong
  143. - I considered stashing them in tclLoadNext.c instead.  The tclIO.c
  144. change was a bug, I believe, which I reported on comp.lang.tcl and
  145. has apparently been noted and fixed.  The objc_loadModules() change
  146. allows "load" to load object code containing Objective-C code in
  147. addition to plain C code.
  148.  
  149. ---
  150. scott hess <shess@winternet.com> (WWW to "http://www.winternet.com/~shess/")
  151. Work: 12550 Portland Avenue South #121, Burnsville, MN  55337  (612)895-1208
  152.  
  153.  
  154. diff -rc tcl7.5b3.orig/compat/utsname.c tcl7.5b3/compat/utsname.c
  155. *** tcl7.5b3.orig/compat/utsname.c    Tue Apr  2 13:57:23 1996
  156. --- tcl7.5b3/compat/utsname.c    Mon Mar 18 11:05:54 1996
  157. ***************
  158. *** 0 ****
  159. --- 1,27 ----
  160. + /*
  161. +  * utsname.c --
  162. +  *
  163. +  *    This file is an emulation of the POSIX uname() function
  164. +  *    under NeXTSTEP 3.x.
  165. +  *
  166. +  */
  167. + 
  168.  
  169. + #include "utsname.h"
  170. + #include <mach-o/arch.h>
  171. + #include <stdio.h>
  172. + 
  173.  
  174. + int uname( struct utsname *name)
  175. + {
  176. +     const NXArchInfo *arch;
  177. +     if( gethostname( name->nodename, sizeof( name->nodename))==-1) {
  178. +     return -1;
  179. +     }
  180. +     if( (arch=NXGetLocalArchInfo())==NULL) {
  181. +     return -1;
  182. +     }
  183. +     strncpy( name->machine, arch->description, sizeof( name->machine));
  184. +     strcpy( name->sysname, "NEXTSTEP");
  185. +     strcpy( name->release, "0");
  186. +     strcpy( name->version, "3");
  187. +     return 0;
  188. + }
  189. diff -rc tcl7.5b3.orig/compat/utsname.h tcl7.5b3/compat/utsname.h
  190. *** tcl7.5b3.orig/compat/utsname.h    Tue Apr  2 13:57:26 1996
  191. --- tcl7.5b3/compat/utsname.h    Mon Mar 18 10:34:05 1996
  192. ***************
  193. *** 0 ****
  194. --- 1,22 ----
  195. + /*
  196. +  * utsname.h --
  197. +  *
  198. +  *    This file is an emulation of the POSIX uname() function
  199. +  *    under NeXTSTEP.
  200. +  *
  201. +  */
  202. + 
  203.  
  204. + #ifndef _UTSNAME
  205. + #define _UTSNAME
  206. + 
  207.  
  208. + struct utsname {
  209. +     char sysname[ 32];
  210. +     char nodename[ 32];
  211. +     char release[ 32];
  212. +     char version[ 32];
  213. +     char machine[ 32];
  214. + };
  215. + 
  216.  
  217. + extern int uname( struct utsname *name);
  218. + 
  219.  
  220. + #endif /* _UTSNAME */
  221. diff -rc tcl7.5b3.orig/generic/tclIO.c tcl7.5b3/generic/tclIO.c
  222. *** tcl7.5b3.orig/generic/tclIO.c    Fri Mar  8 12:59:53 1996
  223. --- tcl7.5b3/generic/tclIO.c    Mon Mar 18 11:38:57 1996
  224. ***************
  225. *** 2542,2548 ****
  226.               }
  227.               result = GetInput(chanPtr);
  228.               if (result != 0) {
  229. !                 if (result == EWOULDBLOCK) {
  230.                       chanPtr->flags |= CHANNEL_BLOCKED;
  231.                       return copied;
  232.                   }
  233. --- 2542,2548 ----
  234.               }
  235.               result = GetInput(chanPtr);
  236.               if (result != 0) {
  237. !                 if (result == EAGAIN) {
  238.                       chanPtr->flags |= CHANNEL_BLOCKED;
  239.                       return copied;
  240.                   }
  241. diff -rc tcl7.5b3.orig/unix/tclLoadNext.c tcl7.5b3/unix/tclLoadNext.c
  242. *** tcl7.5b3.orig/unix/tclLoadNext.c    Sat Feb 17 16:16:42 1996
  243. --- tcl7.5b3/unix/tclLoadNext.c    Mon Mar 18 10:02:36 1996
  244. ***************
  245. *** 55,61 ****
  246.     char *files[]={fileName,NULL};
  247.     NXStream *errorStream=NXOpenMemory(0,0,NX_READWRITE);
  248.   
  249.  
  250. !   if(!rld_load(errorStream,&header,files,NULL)) {
  251.       NXGetMemoryBuffer(errorStream,&data,&len,&maxlen);
  252.       Tcl_AppendResult(interp,"couldn't load file \"",fileName,"\": ",data,NULL);
  253.       NXCloseMemory(errorStream,NX_FREEBUFFER);
  254. --- 55,61 ----
  255.     char *files[]={fileName,NULL};
  256.     NXStream *errorStream=NXOpenMemory(0,0,NX_READWRITE);
  257.   
  258.  
  259. !   if(objc_loadModules(files,errorStream,NULL,&header,NULL)) {
  260.       NXGetMemoryBuffer(errorStream,&data,&len,&maxlen);
  261.       Tcl_AppendResult(interp,"couldn't load file \"",fileName,"\": ",data,NULL);
  262.       NXCloseMemory(errorStream,NX_FREEBUFFER);
  263. diff -rc tcl7.5b3.orig/unix/tclUnixFile.c tcl7.5b3/unix/tclUnixFile.c
  264. *** tcl7.5b3.orig/unix/tclUnixFile.c    Thu Mar  7 18:16:34 1996
  265. --- tcl7.5b3/unix/tclUnixFile.c    Mon Mar 18 11:10:03 1996
  266. ***************
  267. *** 31,37 ****
  268. --- 31,41 ----
  269.   
  270.  
  271.   static int executableNameExitHandlerSet = 0;
  272.   
  273.  
  274. + #if NeXT
  275. + #define waitpid( p, s, o) wait4( p, s, o, NULL)
  276. + #else
  277.   extern pid_t waitpid _ANSI_ARGS_((pid_t pid, int *stat_loc, int options));
  278. + #endif
  279.   
  280.  
  281.   /*
  282.    * Static routines for this file:
  283. diff -rc tcl7.5b3.orig/unix/tclUnixInit.c tcl7.5b3/unix/tclUnixInit.c
  284. *** tcl7.5b3.orig/unix/tclUnixInit.c    Sat Feb 17 16:16:39 1996
  285. --- tcl7.5b3/unix/tclUnixInit.c    Mon Mar 18 11:50:28 1996
  286. ***************
  287. *** 14,20 ****
  288.   #include "tclInt.h"
  289.   #include "tclPort.h"
  290.   #ifndef NO_UNAME
  291. ! #   include <sys/utsname.h>
  292.   #endif
  293.   #if defined(__FreeBSD__)
  294.   #include <floatingpoint.h>
  295. --- 14,24 ----
  296.   #include "tclInt.h"
  297.   #include "tclPort.h"
  298.   #ifndef NO_UNAME
  299. ! #    if NeXT
  300. ! #        include "../compat/utsname.h"
  301. ! #    else
  302. ! #        include <sys/utsname.h>
  303. ! #    endif
  304.   #endif
  305.   #if defined(__FreeBSD__)
  306.   #include <floatingpoint.h>
  307. diff -rc tcl7.5b3.orig/unix/tclUnixPort.h tcl7.5b3/unix/tclUnixPort.h
  308. *** tcl7.5b3.orig/unix/tclUnixPort.h    Thu Mar  7 18:16:31 1996
  309. --- tcl7.5b3/unix/tclUnixPort.h    Mon Mar 18 11:53:14 1996
  310. ***************
  311. *** 76,82 ****
  312.    */
  313.   
  314.  
  315.   #include <sys/socket.h>        /* struct sockaddr, SOCK_STREAM, ... */
  316. ! #include <sys/utsname.h>    /* uname system call. */
  317.   #include <netinet/in.h>        /* struct in_addr, struct sockaddr_in */
  318.   #include <arpa/inet.h>        /* inet_ntoa() */
  319.   #include <netdb.h>        /* gethostbyname() */
  320. --- 76,88 ----
  321.    */
  322.   
  323.  
  324.   #include <sys/socket.h>        /* struct sockaddr, SOCK_STREAM, ... */
  325. ! #ifndef NO_UNAME
  326. ! #    if NeXT
  327. ! #        include "../compat/utsname.h"
  328. ! #    else
  329. ! #        include <sys/utsname.h>    /* uname system call. */
  330. ! #    endif
  331. ! #endif
  332.   #include <netinet/in.h>        /* struct in_addr, struct sockaddr_in */
  333.   #include <arpa/inet.h>        /* inet_ntoa() */
  334.   #include <netdb.h>        /* gethostbyname() */
  335.  
  336. --------------------------------------------
  337. SCO Unix 3.2.4 (ODT 3.0)
  338. --------------------------------------------
  339.  
  340. The macro va_start in /usr/include/stdarg.h is incorrectly terminated by
  341. a semi-colon.  This causes compile of generic/tclBasic.c to fail.  The
  342. best solution is to edit the definition of va_start to remove the `;'.
  343. This will fix this file for anything you want to compile.  If you don't have
  344. permission to edit /usr/include/stdarg.h in place, copy it to the tcl unix
  345. directory and change it there.
  346.  
  347. Contact me directly if you have problems on SCO systems.
  348. Mark Diekhans <markd@grizzly.com>
  349.  
  350. --------------------------------------------
  351. SCO Unix 3.2.5 (ODT 5.0)
  352. --------------------------------------------
  353.  
  354. Expect failures from socket tests 2.9 and 3.1.
  355.  
  356. Contact me directly if you have problems on SCO systems.
  357. Mark Diekhans <markd@grizzly.com>
  358.  
  359. --------------------------------------------
  360. Linux 1.2.13 (gcc 2.7.0, libc.so.5.0.9)
  361. --------------------------------------------
  362.  
  363. Symptoms:
  364.  
  365. *    Some extensions could not be loaded dynamically, most
  366.     prominently Blt 2.0
  367.  
  368.     The given error message essentially said:
  369.     Could not resolve symbol '__eprintf'.
  370.  
  371.     (This procedure is used by the macro 'assert')
  372.  
  373. Cause
  374.  
  375. *    '__eprintf' is defined in 'libgcc.a', not 'libc.so.x.y'.
  376.     It is therefore impossible to load it dynamically.
  377.  
  378. *    Neither tcl nor tk make use of 'assert', thereby
  379.     preventing a static linkage.
  380.  
  381. Workaround
  382.  
  383. *    I included <assert.h> in 'tclAppInit.c' / 'tkAppInit.c'
  384.     and then executed 'assert (argc)' just before the call
  385.     to Tcl_Main / Tk_Main.
  386.  
  387.     This forced the static linkage of '__eprintf' and
  388.     everything went fine from then on.
  389.  
  390.     (Something like 'assert (1)', 'assert (a==a)' is not
  391.     sufficient, it will be optimized away).
  392.  
  393.