forked from jatovm/jato
-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
129 lines (78 loc) · 3.56 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
What is it?
Jato is a Java virtual machine implementation with a Just-in-time (JIT)
compiler. It can currently run some simple Java programs on Linux/i386.
How can I try it out?
- Download development tree:
$ git clone git://git.kernel.org/pub/scm/java/jato/jato.git
- Make sure you have necessary dependencies installed to compile the program.
For Ubuntu:
$ sudo apt-get install ecj classpath libffi-dev binutils-dev libzip-dev
For Fedora:
$ su
$ yum install eclipse-ecj ; exit
and
$ wget ftp://ftp.gnu.org/gnu/classpath/classpath-0.97.2.tar.gz
$ tar xzvf classpath-0.97.2.tar.gz
$ cd classpath-0.97.2
$ ./configure ; make
$ su
$ make install ; exit
- Compile Jato and run the unit tests:
$ cd <JATO_ROOT> ; make
Running Jato
Command line options:
-Xtrace:jit
Trace all compilation phases for each method.
-Xtrace:asm
Trace the emitted machine code for each method.
-Xtrace:classloader
Trace class loading and initialization.
-Xtrace:trampoline
Trace executed trampolines.
Development
If you use git for development, please remember to add your committer name
and email to .git/config file. You can do that by running the following
commands:
git config user.name "Pekka Enberg"
git config user.email penberg@cs.helsinki.fi
How to run the regression test suite?
Installation prerequisites:
- Eclipse Compiler for Java (ECJ)
- GNU classpath installed in '/usr/local/classpath/'
To run the test suite, execute the following commands:
$ make regression
How do I launch a simple application?
To run a simple Java application, you can download Christian Schneider's Java
tetris at:
http://www.liquidreality.de/display/liquid/Java+Tris
and launch it with the following command:
$ ./scripts/java -Xtrace:jit -jar tetris.jar
Note: Jato interacts badly with JamVM GC which is why you should make
the initial heap size big enough for GC not to trigger during
execution.
To launch the application under gdb, use the following command:
$ gdb --args ./jato [...]
Copyright and License
Copyright (C) 2005-2009 Pekka Enberg
Jato is available under the GNU General Public License (GPL) version 2 with
the following clarification and special exception:
Linking this library statically or dynamically with other modules is making
a combined work based on this library. Thus, the terms and conditions of the
GNU General Public License cover the whole combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent modules,
and to copy and distribute the resulting executable under terms of your
choice, provided that you also meet, for each linked independent module,
the terms and conditions of the license of that module. An independent
module is a module which is not derived from or based on this library. If
you modify this library, you may extend this exception to your version of
the library, but you are not obligated to do so. If you do not wish to do
so, delete this exception statement from your version.
Acknowledgements
I would like to thank the following people and organizations for supporting
Jato development:
Reaktor Innovations Oy for sponsoring initial development of Jato.
Kernel.org for providing git hosting for Jato.
Google for including Jato in Summer of Code 2008 and 2009.
Thank you!