+
−
Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.+
−
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.+
−
+
−
This code is free software; you can redistribute it and/or modify it+
−
under the terms of the GNU General Public License version 2 only, as+
−
published by the Free Software Foundation.+
−
+
−
This code is distributed in the hope that it will be useful, but WITHOUT+
−
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or+
−
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License+
−
version 2 for more details (a copy is included in the LICENSE file that+
−
accompanied this code).+
−
+
−
You should have received a copy of the GNU General Public License version+
−
2 along with this work; if not, write to the Free Software Foundation,+
−
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.+
−
+
−
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA+
−
or visit www.oracle.com if you need additional information or have any+
−
questions.+
−
+
−
+
−
+
−
DESCRIPTION+
−
+
−
This is replacement for CompileTheWorld (CTW) written on java. Its purpose is+
−
to make possible the use of CTW in product builds.+
−
+
−
DEPENDENCES+
−
+
−
The tool depends on Whitebox API. Assumed, that the sources of whitebox are+
−
located in '../whitebox' directory.+
−
+
−
BUILDING+
−
+
−
Simple way to build, just type 'make'.+
−
+
−
Makefile uses environment variables 'ALT_BOOTDIR', 'BOOTDIR' as root-dir of jdk+
−
that will be used for compilation and creating jar.+
−
+
−
On successful building 'ctw.jar' will be created.+
−
+
−
RUNNING+
−
+
−
Since the tool uses WhiteBox API, options 'UnlockDiagnosticVMOptions' and+
−
'WhiteBoxAPI' should be specified, and 'wb.jar' should be added to+
−
boot-classpath:+
−
  $ java -XX:+UnlockDiagnosticVMOptions -XX:+WhiteBoxAPI -Xbootclasspath/a:wb.jar -jar ctw.jar +
−
+
−
Arguments can be paths to '.jar, '.zip', '.lst' files or directories with+
−
classes, that define which classes will be compiled:+
−
  - '.jar', '.zip' files and directories are interpreted like in classpath+
−
(including '<dir>/*' syntax)+
−
  - '.lst' files -- files with class names (in java notation) to compile.+
−
CTW will try to find these classes with default class loader, so they should+
−
be located in classpath.+
−
+
−
Without arguments it would work as old version of CTW: all classes in+
−
boot-classpath will be compiled, excluding classes in 'rt.jar' if 'rt.jar' isn't+
−
first in boot-classpath.+
−
+
−
Due CTW's flags also are not available in product builds, the tool uses+
−
properties with the same names:+
−
  - 'CompileTheWorldPreloadClasses' -- type:boolean, default:true, description:+
−
Preload all classes used by a class before start loading+
−
  - 'CompileTheWorldStartAt' -- type:long, default:1, description: First class+
−
to consider+
−
  - 'CompileTheWorldStopAt' -- type:long, default:Long.MAX_VALUE, description:+
−
Last class to consider+
−
+
−
Also it uses additional properties:+
−
  - 'sun.hotspot.tools.ctw.verbose' -- type:boolean, default:false,+
−
description: Verbose output, adds additional information about compilation+
−
  - 'sun.hotspot.tools.ctw.logfile' -- type:string, default:null,+
−
description: Path to logfile, if it's null, cout will be used.+
−
+
−
EXAMPLES+
−
+
−
compile classes from 'rt.jar':+
−
  $ java -XX:+UnlockDiagnosticVMOptions -XX:+WhiteBoxAPI -Xbootclasspath/a:wb.jar -jar ctw.jar ${JAVA_HOME}/jre/lib/rt.jar+
−
+
−
compile classes from all '.jar' in './testjars' directory:+
−
  $ java -XX:+UnlockDiagnosticVMOptions -XX:+WhiteBoxAPI -Xbootclasspath/a:wb.jar -jar ctw.jar ./testjars/*+
−
+
−
compile classes from './build/classes' directory:+
−
  $ java -XX:+UnlockDiagnosticVMOptions -XX:+WhiteBoxAPI -Xbootclasspath/a:wb.jar -jar ctw.jar ./build/classes+
−
+
−
compile only java.lang.String, java.lang.Object classes:+
−
  $ echo java.lang.String > classes.lst+
−
  $ echo java.lang.Object >> classes.lst+
−
  $ java -XX:+UnlockDiagnosticVMOptions -XX:+WhiteBoxAPI -Xbootclasspath/a:wb.jar -jar ctw.jar classes.lst+
−
+
−