1 .TH CACAO 1 "January 12, 1999"
4 cacao \- a java just-in-time compiler
7 [\-ieee][options] classname [program arguments]
10 The method \fBmain\fP of the class \fIclassname\fP is executed.
11 Method \fBmain\fP must have the signature \fBpublic static void
12 main(String[] argv)\fP. The program arguments are passed to method
13 \fBmain\fP in the string array \fBargv\fP. The environment variable
14 \fICLASSPATH\fP must contain the directory of the Java class files.
15 Class archives in \fBzip\fP format are not supported. The option
16 \fI\-ieee\fP is needed for a compliant implementation, the default
17 behaviour of CACAO (aborting in case of floating point exeptions) is both
18 faster and more desirable. The other options for \fBcacao\fP are in most
19 cases identical to the options of the \fBjava\fP interpreter of SUN's
20 JDK, with some additions and minor changes.
22 Currently recognized options are:
24 .B -classpath \fIpath\fP
25 Defines the search path for class files. Usually the environment variable
26 CLASSPATH specifies the search path, but this option overides the
27 value of the environment variable.
29 .B -propertyname=\fIvalue\fP
30 Assigns a value to an entry of the system property list.
32 .B -ms \fIinitmem\fP { k | m }
33 Specicfies the heap size at program start. If this size has been used
34 garbage collection is started.
36 .B -mx \fImaxmem\fP { k | m }
37 Specifies maximal heap size. Default size is 16 MB.
39 .B -oss \fIstacksize\fP { k | m }
40 no effect, compatibility option
42 .B -ss \fIstacksize\fP { k | m }
43 no effect, compatibility option
46 no effect, compatibility option
49 no effect, compatibility option
52 CACAO prints a log message of every class loaded.
55 CACAO prints a log message for each garbage collection.
58 CACAO prints a log message for each method call.
61 Enables IEEE compliant floating point arithmetic as specified in the
62 JVM specification. The default behavior is aborting CACAO with a
63 floating point exception on overflows.
66 Software null pointer check is used instead of hardware null pointer
67 check. Needed for debugging of CACAO.
70 Gives statistics about run time after the program has completed.
73 Gives detailed statistics about the compiled program.
76 Specifies the logfile. Default is \fIstdout\fP.
79 Disables different run time checks.
80 These options improves the run time of programs. But instead of throwing
81 an exception the program crashes. These options should only be used for
82 completely debugged programs.
84 Disables array bound checks. Works well for \fBjavac\fP.
86 Disables synchronization. Only useful for single threaded programs like
87 \fBjavac\fP or \fBjBYTEmark\fP
89 Loads the class files into the CACAO system without calling method
90 \fBmain\fP. Used for debugging of CACAO.
92 Use the old JIT compiler instead the new one. Used for debugging and comparison
93 of the two JIT compilers.
96 Compiles all methods without calling them.
97 Used for cross compilation and debugging of CACAO.
99 .B -m \fImethodname\fP
100 Compiles the specified method without calling it.
101 Used for debugging of CACAO.
103 .B -sig \fIsignature\fP
104 specifies the signature of the method specified with the -m option.
105 Used for debugging of CACAO.
107 .B -s(how){[a][c][i][m][s][u]}
108 The following options are used for debugging of the CACAO system. The
109 compiler gives the values of internal data structures in readable form:
111 Gives an assembles listing of all compiled methods.
113 Gives a listing of all constant pool entries.
115 Gives the intermediate code of all compiled methods.
117 Gives a description of all fields and methods of a class.
119 Gives the JavaVM stack for every compiled instruction.
121 Gives the complete hash table with all unicode symbols.
124 Andreas Krall, Mark Probst, Philipp Tomsich, Reinhard Grafl, Markus Gschwind
126 Send mail to cacao@complang.tuwien.ac.at