94 lines
3.8 KiB
Plaintext
94 lines
3.8 KiB
Plaintext
|
#
|
||
|
|
# 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
|
||
|
|
|