1 .TH CACAO 1 "November 23, 2005"
4 cacao \- a Java just-in-time compiler
26 The method \fBmain\fP of the class \fIclassname\fP is executed.
27 Method \fBmain\fP must have the signature \fBpublic static void
28 main(String[] argv)\fP. The program arguments are passed to method
29 \fBmain\fP in the string array \fBargv\fP. The environment variable
30 \fICLASSPATH\fP must contain the directory of the Java class files.
32 Currently recognized options are:
35 .B -classpath \fIpath\fP
36 Set the search path for user-defined class files. Usually the environment variable CLASSPATH
37 specifies the search path, but this option overrides the value of the environment variable.
38 \fIpath\fP may be a colon-separated list of directories and .jar files.
42 Equivalent to \fB-classpath \fIpath\fP.
45 .B -D\fIproperty\fB=\fIvalue\fP
46 Assign a value to an entry of the system property list.
49 .BR -verbose [ :class | gc | jni ]
50 Enable specific verbose output.
54 Print product version and exit.
58 Print jpackage-compatible product version and exit.
62 Print product version and continue.
66 Print this help message and exit.
70 Print help on non-standard Java options.
72 .SH NON-STANDARD OPTIONS
73 Currently recognized options are:
76 .B -Xbootclasspath/a:\fIpath\fP
77 Append \fIpath\fP to the search path of the bootstrap loader.
80 .B -Xbootclasspath/p:\fIpath\fP
81 Prepend \fIpath\fP to the search path of the bootstrap loader.
84 .B -Xbootclasspath:\fIpath\fP
85 Set the search path of the bootstrap loader to \fIpath\fP.
86 \fIpath\fP is a list of .zip files, .jar files, or directories, separated by \fB:\fP.
90 Interpreter mode execution.
94 JIT mode execution (default).
98 Set the initial size of the heap (default: 2MB).
102 Set the maximum size of the heap (default: 64MB).
106 Set the thread stack size (default: 128kB).
110 Compile all methods, no execution.
114 Disable array bounds checks.
118 Disable synchronization.
122 Don't start the class after loading.
126 Don't warn about overlong UTF-8 sequences.
129 .B -log \fIlogfile\fP
130 Specifies the logfile. Default is \fIstdout\fP.
134 Use linear scan register allocation.
138 Compile only a specific method.
142 Turn off bytecode verification and other verifier checks.
145 .B -sig \fIsignature\fP
146 Specify signature for the method given by the \fB-m\fP option.
150 Use software nullpointer check.
154 Print detailed compiler statistics.
158 Gives statistics about run time after the program has completed.
162 Print state information.
164 .SH DEBUGGING OPTIONS
166 The following options are useful for debugging \fBcacao\fP:
170 Show a disassembled listing of the generated code.
174 Show the constant pool.
178 Show data segment listing.
182 Show disassembled exception stubs (only with \fB-sa\fP).
186 Show intermediate representation.
190 Show class fields and methods.
194 Show disassembled native stubs.
198 Show the internal utf hash.
202 Print more information.
210 Trace exceptions and stack unwinding.
214 Print a message for each garbage collection.
216 .SH EXPERIMENTAL OPTIONS
220 Perform eager class loading and linking.
224 Inline methods with exceptions.
228 Activate inlining of methods.
232 Inline methods of foreign classes.
236 Optimize argument renaming when inlining.
240 Inline virtual methods (uses/turns \fB-rt\fP option on).
244 Optimize array accesses in loops.
248 Use rapid type analysis.
252 Use variable type analysis.
258 .SH ENVIRONMENT VARIABLES
262 A colon-separated list of directories and .jar files to search for
263 user-defined classes.
267 A colon-separated list of directories and .jar files searched
268 by the bootstrap loader.
289 Send mail to cacao@cacaojvm.org