Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

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