home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / languages / java / kaffe.0.5p4-nx3.README < prev    next >
Encoding:
Text File  |  1996-09-18  |  13.6 KB  |  387 lines
  1. kaffe-0.5p4-nx3, 17.07.96
  2.  
  3. This is the third release of kaffe-0.5pl4 with NEXTSTEP patches. 
  4.  
  5. Changes in nx3 compared to nx1:
  6.  
  7. * NEXTSTEP/m68k support by Ralf E. Stranzenbach <ralf@reswi.ruhr.de>
  8. * threading bug fix by Thomas Katzlberger <katzlbt@vuse.vanderbilt.edu>
  9.  
  10.  
  11. kaffe is a JIT and interpreting virtual machine to run Java(tm) code:
  12.  
  13. "This is Kaffe, a virtual machine design to execute Java bytecode.
  14. This machine can be configured in two modes.  In one mode it operates as
  15. a pure bytecode interpreter (not unlike Javasoft's machine); in the second
  16. mode if performs "just-in-time" code conversion from the abstract code to
  17. the host machine's native code.  This will ultimately allow execution of
  18. Java code at the same speed as standard compiled code but while maintaining
  19. the advantages and flexibility of code independence."
  20.  
  21.  
  22. kaffe 0.5pl4 comes with support for NEXTSTEP (i386 and sparc), but the 
  23. support is broken. This distribution includes fixes that hopefully will be
  24. incorporated in the next general kaffe release. See below for the patches
  25. applied to the p4 source distribution.
  26.  
  27. The Intel version can be compiled as interpreter or JIT (just-in-time
  28. compiler, faster!), the SPARC and the m68k port currently only supports interpreter mode. I'm still hoping that somebody volunteers for an HPPA
  29. port!
  30.  
  31. kaffe's primary site is ftp://ftp.sarc.city.ac.uk/pub/kaffe. There's also a
  32. WWW page on kaffe: http://www.sarc.city.ac.uk/~tim/kaffe
  33.  
  34.  
  35. COMPILATION:
  36.  
  37. To compile kaffe, you need GNU make. With the patch applied, compilation
  38. should be rather straightforward (configure; make; make install).
  39.  
  40.  
  41. INSTALLATION:
  42.  
  43. Verbose instructions can be found in the source distribution. The binary
  44. distribution are intended to be unpacked in /usr. They will populate
  45. the /usr/local tree (/usr/local/bin, /usr/local/lib and 
  46. /usr/local/share/kaffe). Finally, you have to set the environment variables
  47. CLASSPATH and KAFFEHOME. If you did install in /usr/local, this whould be
  48.  
  49.     CLASSPATH=.:/usr/local/share/kaffe/classes.zip
  50.     KAFFEHOME=/usr/local/share/kaffe
  51.  
  52.  
  53. NOTES and KNOWN BUGS:
  54.  
  55. Starting with nx3, the i386 JIT port seems to be quite useable. All examples
  56. in test that I tried did work; I managed to start and run W3C's jigsaw WWW 
  57. server.
  58.  
  59. The sparc and the m68k port run fine with all tests I tried, but they fail
  60. to run jigsaw yet.
  61.  
  62. kaffe tends to terminate the calling shell in certain circumstances. AFAIK
  63. this only affects sh and csh, but not zsh. This is a general bug in 0.5p4.
  64.  
  65. The dynamic loading of libraries is currently disabled for NEXTSTEP. You'll
  66. have to recompile kaffe for things like sawt.
  67.  
  68. I'm now going to try and compile sawt (Free, simple AWT clone) for NEXTSTEP
  69. and X11.
  70.  
  71.  
  72.     Gregor Hoffleit <flight@mathi.uni-heidelberg.de>
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79. %%%
  80. %%% patch for kaffe-0.5p4 and NEXTSTEP 3.3 (i386 and sparc, m68k)
  81. %%%        patch release kaffe-0.5p4-nx3
  82. %%%
  83. %%% - unpack
  84. %%% - patch -p <...
  85. %%% - ./configure
  86. %%% - gmake
  87.  
  88. %%% Release status:
  89. %%% - NEXTSTEP executables statically linked
  90. %%% - javac,javadoc are not executable
  91. %%% - W3C's jigsaw server works with kaffe and NEXTSTEP/i386!
  92.  
  93. %%% Changes in nx3:
  94. %%% - threading bug fix in kaffevm/threadCalls.c by
  95. %%%   Thomas Katzlberger <katzlbt@vuse.vanderbilt.edu>
  96. %%% Changes in nx2:
  97. %%% - added NEXTSTEP/m68k port by Ralf E. Stranzenbach <ralf@reswi.ruhr.de>
  98. %%% - fixed a typo in kaffevm/threadCalls.c
  99.  
  100.  
  101.  
  102. diff -urN /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/kaffevm/jit/funcs.c ./kaffevm/jit/funcs.c
  103. --- /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/kaffevm/jit/funcs.c    Sat Jul 20 05:33:30 1996
  104. +++ ./kaffevm/jit/funcs.c    Fri Sep  6 10:58:47 1996
  105. @@ -27,7 +27,11 @@
  106.  extern int isStatic;
  107.  extern nativecode* CODEPC;
  108.  
  109. +#ifdef NeXT
  110. +#define    define_insn(n, i) void i(sequence* s)
  111. +#else
  112.  #define    define_insn(n, i) void i##(sequence* s)
  113. +#endif
  114.  
  115.  #define    OUT    (*CODEPC++)
  116.  
  117. diff -urN /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/lib/native/java.io/File.c ./lib/native/java.io/File.c
  118. --- /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/lib/native/java.io/File.c    Fri Aug 16 15:14:01 1996
  119. +++ ./lib/native/java.io/File.c    Fri Sep  6 12:13:53 1996
  120. @@ -33,6 +33,9 @@
  121.  # if defined(HAVE_NDIR_H)
  122.  #  include <ndir.h>
  123.  # endif
  124. +# if defined(NeXT)
  125. +#  include <sys/dir.h>
  126. +# endif
  127.  #endif
  128.  /* This may nolonger be necessary */
  129.  #if defined(HAVE_DIR_H)
  130.  
  131. diff -urN /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/kaffevm/threadCalls.c ./kaffevm/threadCalls.c
  132. --- /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/kaffevm/threadCalls.c    Wed Aug 21 22:17:59 1996
  133. +++ ./kaffevm/threadCalls.c    Wed Sep 11 19:49:44 1996
  134. @@ -95,7 +95,7 @@
  135.  int
  136.  threadedFileDescriptor(int fd)
  137.  {
  138. -#if !defined(NO_READ_THEADING) && !defined(NO_WRITE_THREADING)
  139. +#if !defined(NO_READ_THREADING) && !defined(NO_WRITE_THREADING)
  140.      int r;
  141.      int on = 1;
  142.      int pid;
  143. @@ -216,7 +216,7 @@
  144.      int r;
  145.  
  146.      for (;;) {
  147. -#if defined(NO_READ_THREADING)
  148. +#if !defined(NO_READ_THREADING)
  149.          blockOnFile(fd, TH_READ);
  150.  #endif
  151.          r = read(fd, buf, len);
  152. @@ -240,7 +240,7 @@
  153.  
  154.      ptr = buf;
  155.      do {
  156. -#if defined(NO_WRITE_THREADING)
  157. +#if !defined(NO_WRITE_THREADING)
  158.          blockOnFile(fd, TH_WRITE);
  159.  #endif
  160.          r = write(fd, ptr, len);
  161.  
  162.  
  163. %%%
  164. %%% NEXTSTEP m68k port by Ralf E. Stranzenbach <ralf@reswi.ruhr.de>.
  165. %%%
  166.  
  167.  
  168. diff -urN /private/tmp/O_kaffe-0_5p4/kaffe-0.5p4/config/m68k/nextstep3/md.c ./config/m68k/nextstep3/md.c
  169. --- /private/tmp/O_kaffe-0_5p4/kaffe-0.5p4/config/m68k/nextstep3/md.c    Thu Jan  1 01:00:00 1970
  170. +++ ./config/m68k/nextstep3/md.c    Fri Sep  6 16:23:06 1996
  171. @@ -0,0 +1,12 @@
  172. +/*
  173. + * m68k/nextstep3/md.c
  174. + * NEXTSTEP m68k specific functions.
  175. + *
  176. + * Copyright (c) 1996 Systems Architecture Research Centre,
  177. + *           City University, London, UK.
  178. + *
  179. + * See the file "license.terms" for information on usage and redistribution
  180. + * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  181. + *
  182. + * Written by Tim Wilkinson <tim@sarc.city.ac.uk>, May 1996.
  183. + */
  184. diff -urN /private/tmp/O_kaffe-0_5p4/kaffe-0.5p4/config/m68k/nextstep3/md.h ./config/m68k/nextstep3/md.h
  185. --- /private/tmp/O_kaffe-0_5p4/kaffe-0.5p4/config/m68k/nextstep3/md.h    Thu Jan  1 01:00:00 1970
  186. +++ ./config/m68k/nextstep3/md.h    Wed Sep 11 19:33:57 1996
  187. @@ -0,0 +1,54 @@
  188. +/*
  189. + * m68k/nextstep3/md.h
  190. + * NEXTSTEP m68k specific functions.
  191. + *
  192. + * Copyright (c) 1996 Matthias Hopf <mshopf@informatik.uni-erlangen.de>
  193. + *
  194. + * Permission granted for Tim Wilkinson to include this source in his
  195. + * Kaffe system, Copyright (c) 1996 Systems Architecture Research Centre,
  196. + *               City University, London, UK.
  197. + *
  198. + * See the file "license.terms" for information on usage and redistribution
  199. + * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  200. + */
  201. +
  202. +#ifndef __m68k_nextstep3_md_h
  203. +#define __m68k_nextstep3_md_h
  204. +
  205. +
  206. +#include "m68k/nextstep3/threads.h"
  207. +
  208. +#if 0
  209. +#undef  THREADINFO
  210. +/* we should use StackSwap instead of native code, but that would be too complicated and extra overhead... */
  211. +#define THREADINFO(ee)                                               \
  212. +          do {                                               \
  213. +              int stacksize;                                 \
  214. +              M68K_THREADINFO (ee);                          \
  215. +              (ee)->stackBase = FindTask(NULL)->tc_SPLower; /* not NULL on Amiga!!! This is the absolute minimum stack base of this task! */ \
  216. +              stacksize = (ee)->stackEnd - (ee)->stackBase;  \
  217. +              if (stacksize < threadStackSize)               \
  218. +              {                                              \
  219. +              fprintf (stderr, "stack size too low - stack left (%d) < stack needed (%d)\n", stacksize, threadStackSize); \
  220. +              exit (20);                                 \
  221. +              }                                              \
  222. +          } while (0)
  223. +
  224. +#undef  THREADSWITCH
  225. +/* we *should* surround this with Forbid()/Permit() (Task struct stack consistency), but overhead is too high. */
  226. +#define THREADSWITCH(to, from)                                       \
  227. +          do {                                               \
  228. +              struct Task *task;             /* perhaps this should be saved in ctx */                                         \
  229. +              task = FindTask (NULL);        /* write stack information into system structures */                              \
  230. +              task->tc_SPLower = (to)->stackBase;            \
  231. +              task->tc_SPUpper = (to)->stackEnd;             \
  232. +DBG(                  printf ("setting task stack info from %x to %x\n", (to)->stackBase, (to)->stackEnd); )                           \
  233. +              M68K_THREADSWITCH(to, from);                   \
  234. +          } while (0)
  235. +#endif
  236. +
  237. +#if defined(TRANSLATOR)
  238. +#include "m68k/jit-md.h"
  239. +#endif
  240. +
  241. +#endif
  242. diff -urN /private/tmp/O_kaffe-0_5p4/kaffe-0.5p4/config/m68k/nextstep3/threads.h ./config/m68k/nextstep3/threads.h
  243. --- /private/tmp/O_kaffe-0_5p4/kaffe-0.5p4/config/m68k/nextstep3/threads.h    Thu Jan  1 01:00:00 1970
  244. +++ ./config/m68k/nextstep3/threads.h    Wed Sep 11 19:34:14 1996
  245. @@ -0,0 +1,107 @@
  246. +/*
  247. + * m68k/threads.h
  248. + * m68k thread handling.
  249. + *
  250. + * Copyright (c) 1996 Matthias Hopf <mshopf@informatik.uni-erlangen.de>
  251. + *
  252. + * Permission granted for Tim Wilkinson to include this source in his
  253. + * Kaffe system, Copyright (c) 1996 Systems Architecture Research Centre,
  254. + *               City University, London, UK.
  255. + *
  256. + * See the file "license.terms" for information on usage and redistribution
  257. + * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  258. + */
  259. +
  260. +#ifndef __m68k_threads_h
  261. +#define __m68k_threads_h
  262. +
  263. +/**/
  264. +/* Thread handling */
  265. +/**/
  266. +
  267. +/* NOTE! a6 is asumed to be the frame pointer (only for frame counting). */
  268. +
  269. +/*
  270. + * Stack of waiting thread:
  271. + *       + 64... Thread stack
  272. + *       + 60    pc  (return address)
  273. + *       + 56    a6  (frame pointer) (56=14*4)
  274. + *       + 52    a5
  275. + *        ...
  276. + *       + 32    a0
  277. + *        ...
  278. + *       +  4    d0
  279. + * SPReg +  0    d0
  280. + */
  281. +
  282. +#define USE_INTERNAL_THREADS
  283. +
  284. +#define THREADSTACKSIZE         (32 * 1024)
  285. +
  286. +#define M68K_THREADSWITCH(to, from)                       \
  287. +            asm("                                 \
  288. +            pea _1:l                            \n\
  289. +            movml d0-d7/a0-a6, a7@-             \n\
  290. +            movel a7, %0@                       \n\
  291. +            movel %1, a7                        \n\
  292. +            movml a7@+,d0-d7/a0-a6              \n\
  293. +            rts                                 \n\
  294. +                _1:                      "\
  295. +            : : "a" (&from->restorePoint), "a" (to->restorePoint))
  296. +
  297. +#define M68K_THREADINIT(to, func)                        \
  298. +          asm("                                  \
  299. +          moveq #0, d0                           \n\
  300. +          movel %2, %0@-                         \n\
  301. +              movel d0, %0@-                         \n\
  302. +              movel d0, %0@-                         \n\
  303. +              movel d0, %0@-                         \n\
  304. +              movel d0, %0@-                         \n\
  305. +              movel d0, %0@-                         \n\
  306. +              movel d0, %0@-                         \n\
  307. +              movel d0, %0@-                         \n\
  308. +              movel d0, %0@-                         \n\
  309. +              movel d0, %0@-                         \n\
  310. +              movel d0, %0@-                         \n\
  311. +              movel d0, %0@-                         \n\
  312. +              movel d0, %0@-                         \n\
  313. +              movel d0, %0@-                         \n\
  314. +              movel d0, %0@-                         \n\
  315. +              movel d0, %0@-                          "\
  316. +          : "=a" (to->restorePoint) : "0" (to->stackEnd), "g" (func) : "d0", "d1")
  317. +
  318. +#define M68K_THREADINFO(ee)                                     \
  319. +        do {                                            \
  320. +            void** ptr;                             \
  321. +            int i;                                  \
  322. +            asm("movel a6, %0" : "=r" (ptr));       \
  323. +            for (i = 0; i != 2; i++) {              \
  324. +                ptr = (void**)*ptr;             \
  325. +            }                                       \
  326. +            (ee)->restorePoint = 0;                 \
  327. +            (ee)->stackBase = NULL;                 \
  328. +            (ee)->stackEnd = (void*)ptr;            \
  329. +        } while(0)
  330. +
  331. +#define M68K_THREADFRAMES(tid, cnt)                             \
  332. +        do {                                            \
  333. +            void** ptr;                             \
  334. +            cnt = 0;                                \
  335. +            if (tid == currentThread) {             \
  336. +                asm("movel a6,%0" : "=r" (ptr));\
  337. +            }                                       \
  338. +            else {                                  \
  339. +                ptr = ((void***)tid->PrivateInfo->restorePoint)[13];\
  340. +            }                                       \
  341. +            while (*ptr != 0) {                     \
  342. +                cnt++;                          \
  343. +                ptr = (void**)*ptr;             \
  344. +            }                                       \
  345. +        } while (0)
  346. +
  347. +#define THREADSWITCH(to, from)    M68K_THREADSWITCH(to, from)
  348. +#define THREADINIT(to, func)      M68K_THREADINIT(to, func)
  349. +#define THREADINFO(ee)            M68K_THREADINFO(ee)
  350. +#define THREADFRAMES(tid,cnt)     M68K_THREADFRAMES(tid, cnt)
  351. +
  352. +#endif
  353. diff -urN /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/configure ./configure
  354. --- /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/configure    Thu Sep  5 09:59:55 1996
  355. +++ ./configure    Fri Sep  6 11:38:46 1996
  356. @@ -705,6 +705,13 @@
  357.      VPATHSEP=" "
  358.      ;;
  359.  
  360. +m68k-nextstep3)
  361. +    host_cpu=m68k
  362. +    host_os=nextstep3
  363. +    KAFFEVMFLAGS=-DNO_SHARED_LIBRARIES
  364. +    NOSHAREDLIBS="-L../lib/native -L../lib/net -lkaffe_native -lkaffe_net"
  365. +    ;;
  366. +
  367.  
  368.  *)
  369.      { echo "configure: error: Configuration $host_cpu-$host_os not supported" 1>&2; exit 1; }
  370. diff -urN /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/configure.in ./configure.in
  371. --- /tmp/O_1_kaffe-0_5p4/kaffe-0.5p4/configure.in    Sat Aug 31 01:00:32 1996
  372. +++ ./configure.in    Fri Sep  6 11:35:23 1996
  373. @@ -193,6 +193,13 @@
  374.      VPATHSEP=" "
  375.      ;;
  376.  
  377. +m68k-nextstep3)
  378. +    host_cpu=m68k
  379. +    host_os=nextstep3
  380. +    KAFFEVMFLAGS=-DNO_SHARED_LIBRARIES
  381. +    NOSHAREDLIBS="-L../lib/native -L../lib/net -lkaffe_native -lkaffe_net"
  382. +    ;;
  383. +
  384.  dnl =======================================================================
  385.  dnl = End of configurations
  386.  dnl =======================================================================
  387.