top.mk

来自「This is a resource based on j2me embedde」· MK 代码 · 共 503 行 · 第 1/2 页

# @(#)top.mk	1.38 06/10/26
#
# Copyright  1990-2008 Sun Microsystems, Inc. All Rights Reserved.  
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER  
#   
# This program 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 program 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 at /legal/license.txt).   
#   
# 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 Sun Microsystems, Inc., 4150 Network Circle, Santa  
# Clara, CA 95054 or visit www.sun.com if you need additional  
# information or have any questions. 
#

#
# Topmost makefile shared by all targets
#
#########################################################
# Definitions of shared supported options.
# OS specific options are described in build/<os>/top.mk
#########################################################
#
# J2ME_CLASSLIB default: cdc
#     The class library build target. The choices are cdc and foundation.
#     cdc represents a limited class library that is meant for testing
#     purposes only. foundation represents the full Foundation Profile 1.0
#     class library.
#
# JDK_HOME
#     Location of the J2SE 1.3.1 SDK tools.
#
# OPT_PKGS
#     Indicates that an optional package will be compiled as part of the
#     regular build. The syntax of this flag is as follows: 
#
#       OPT_PKGS=all | <pkg1>[,<pkg2>]
#
#     where <pkg1> is the name of the optional package and a ',' is used to
#     separate multiple package names.  Quotes ("") are needed if spaces exist
#     in the value of OPT_PKGS, but are not necessary otherwise. When OPT_PKGS
#     is set to all, all available optional packages will be part of the
#     compilation.
#
# CVM_DEBUG default: false
#     Build the debug version of the VM.
#
# CVM_DEBUG_ASSERTS default: $(CVM_DEBUG)
#     Enable asserts. Also is forced to true if CVM_VERIFY_HEAP=true.
#
# CVM_DEBUG_CLASSINFO default: $(CVM_DEBUG)
#     Build the VM with the code necessary to interpret class debugging
#     information in the class files. Also causes preloaded classes to include
#     debugging information if they were compiled with it.
#     CVM_JAVAC_DEBUG=true should also be used to provide class debugging
#     information in the CDC and Foundation class files. Otherwise
#     this option will only benefit application classes that are
#     compiled with the -g option.
#
# CVM_DEBUG_DUMPSTACK default: $(CVM_DEBUG)
#     Include support for the CVMdumpStack and CVMdumpFrame functions.
#     CVMdumpStack is useful for dumping a Java stack from gdb after the
#     VM has crashed.
#
# CVM_DEBUG_STACKTRACES default: true
#     Include code for doing Throwable.printStackTrace and
#     Throwable.fillInStackTrace. If false, then printStackTrace will print
#     a "not supported" message. This is not really just a debug build feature.
#     To reduce the footprint of non-debug builds, set this option to false.
#
# CVM_JAVAC_DEBUG default: $(CVM_DEBUG)
#     Compile classes with debugging information (line numbers, localvariables,
#     etc.) by using the -g option. Otherwise build using -g:none. This will
#     not affect the size of the VM image unless CVM_DEBUG_CLASSINFO is also
#     true. Using this option will increase the size of the profile jar file.
#
# CVM_JIT default: target specific - see GNUmakefile
#     Build a VM with the dynamic compiler.
#
# CVM_JIT_USE_FP_HARDWARE default: target specific - see GNUmakefile
#     Enable the JIT to use an FPU. If true, the JIT will emit FP instructions
#     and use FP registers. If false, the JIT will store FP values in general
#     purpose registers and call out to C or assembler helper functions to do
#     FP arithmetic.
#
#     NOTE: This option is not supported on the ARM port and will result in
#     build errors if set true.
#
# CVM_JVMTI default: false
#     Build a VM that supports the new JVMTI debugger/profiler interface.
#     When set true, there can be a significant degradation of performance.
#
# CVM_JVMTI_ROM default: false
#     Build a VM that supports debugging romized system classes. CVM_JVMTI
#     must be true.
#
# CVM_JVMPI default: false
#     Build a VM that supports the Java profiler. This option is not
#     supported with CVM_JIT=true. When set true, there will be a significant
#     degradation of performance.
#
# CVM_JVMPI_TRACE_INSTRUCTION default: $(CVM_JVMPI)
#     Build a VM that supports Java bytecode tracing for profiling purposes.
#     Enabling this option imposes a greater runtime burden on the interpreter
#     and may cause it to run a little slower.  Hence, this option is provided
#     in case the user does not need this feature and does not want the
#     additional runtime burden to impact the profile they are sampling.
#
# CVM_OPTIMIZED default: !$(CVM_DEBUG)
#     If true, then use various C compiler optimization features. Setting
#     both CVM_DEBUG=true and CVM_OPTIMIZED=true will provide both debug
#     support and optimized code that will run faster, but not as fast
#     as when using CVM_DEBUG=false.
#
# CVM_PRELOAD_LIB default: unset
#     Build a VM with all the system and profile classes preloaded.
#     Obsolete.  Replaced by CVM_PRELOAD_SET.
#
# CVM_PRELOAD_TEST default: unset
#     Build a VM with the test classes (testclasses.zip) preloaded.
#     Obsolete.  Replaced by CVM_PRELOAD_SET.
#
# CVM_PRELOAD_SET default: minfull
#     Build a VM with the specified set of classes preloaded.
#     Possible choices: min nullapp libfull libtestfull
#
# CVM_SYMBOLS default: $(CVM_DEBUG)
#     Include debugging and symbol information for C code even if the build is
#     optimized.
#
# USE_VERBOSE_MAKE default: false
#     Avoid printing detailed messages that show each build step. Has the
#     opposite meaning as CVM_TERSEOUTPUT, which can be used instead, but
#     is now deprecated..
#
# CVM_TRACE default: $(CVM_DEBUG)
#     Include support for tracing VM events to stderr. The events that are
#     traced are controlled by the -Xtrace option.  Since CVM_TRACE=true
#     slows down the VM a lot, it is useful to build with CVM_TRACE=false
#     and CVM_DEBUG=true to get debugging support without tracing support.
#
# CVM_USE_NATIVE_TOOLS default: false
#     The native tools will be used rather than attempting to locate a gcc
#     compiler. This means cc is used as the default compiler. Normally the
#     makefiles search for gcc in a path determined by a number of other
#     options, including CVM_TOOLS_DIR and CVM_HOST. See
#     CVM_TARGET_TOOLS_PREFIX in build/share/defs.mk.
#
# CVM_VERIFY_HEAP default: false
#     Enable Java heap verification code.  Because this can have a dramatically
#     adverse affect on performance, is can be turned off while still enabling
#     other assertion code with CVM_DEBUG_ASSERTS=true.
#
# CVM_INCLUDE_COMMCONNECTION default: false
#     Include GCF CommProtocol support. This feature is not supported
#     on all platforms.

#####################################################################
# Definitions of limited options. The default values of these options
# are supported. Alternate values should be considered experimental.
#####################################################################
#
# CVM_CSTACKANALYSIS default: false
#     Include stub functions to assist in C stack usage analysis.
#
# CVM_GPROF default: false
#     Enable gprof profiling support.
#
# CVM_GPROF_NO_CALLGRAPH: true
#     When gprof is enabled, this option can be used to control if
#     call graph is generated in the gprof output.
#
# CVM_CCM_COLLECT_STATS default: false
#     Build a VM which collect statistics on the runtime activity of
#     dynamically compiled code, even if the build is optimized.
#
# CVM_CLASSLIB_JCOV default: false
#     Build library classes with -Xjov (JDK 1.4 javac command line option)
#     enabled. Also instruments the VM to simulate loading of classfiles for
#     preloaded classes at startup.
#
# CVM_CLASSLOADING default: true
#     Build a VM that supports class loading. This option also affects how many
#     system classes are preloaded. If true, then the minimal number of classes
#     needed to bootstrap the VM are preloaded and the rest are dynamically
#     loaded. WARNING: setting this option to false is currently broken.
#
# CVM_DYNAMIC_LINKING default: true
#     Support the base functionality in the porting layer for dynamic linking.
#     This will be needed by dynamic classloading as well as debugger and
#     profiler support.
#
# CVM_GCCHOICE default: generational
#     Set to the garbage collection technique. semispace, marksweep and
#     generational-seg are also available.
#
# CVM_JIT_DEBUG default: false
#     Build the JIT with extra debugging support, including support for
#     filtering which methods are compiled, and support for tracing
#     the JCS rules used during compilation.
#
# CVM_JIT_ESTIMATE_COMPILATION_SPEED default: false
#     Build a VM which estimates the theoretical maximum compilation speed
#     of the JIT. The measurement is in KB of byte-code compiled per second.
#
# CVM_JIT_PROFILE default: false
#     Enable profiling of compiled code. Use -Xjit:Xprofile=<filename> to
#     enable profiling and specify the file to dump profile information too.
#     For linux, enabling profiling at runtime generally degrades performance
#     by about 2%. If profiling support is included at build time but not
#     used at runtime, it has no affect on preformance.
#
# CVM_NO_LOSSY_OPCODES default: false
#     Field-related opcodes whose arguments would ordinarily be quickened into
#     offsets instead have their arguments quickened into constant pool
#     references, to ensure the fieldblock for the field is available. This is
#     required to allow the debugger to set field watchpoints. Note this works
#     either with or without classloading enabled, and affects both
#     JavaCodeCompact and quicken.c.
#
# CVM_REBUILD default: false
#     Rebuild using the same build flags as last time, preventing the need to
#     retype a bunch of command line options. The main benefit of this is that
#     there is not risk of having a typo that results in a bunch
#     of cleanup actions triggered.
#
#     NOTE: this option will not remember the value of any options that
#     specify where tools are located, such as JDK_HOME and CVM_TOOLS_DIR.
#
# CVM_REFLECT default: true
#     Build a VM that supports the java.lang.reflect package. This does not
#     cause any native function definitions to be eliminated from the
#     build. Instead, their bodies simply throw an
#     UnsupportedOperationException. See the description of CVM_SERIALIZATION
#     for more information.
#
#     NOTE: setting this option true will result in a VM that is not
#     compliant with the J2ME CDC and Foundation specifications.
#
# CVM_SERIALIZATION default: true
#     Build a VM that supports object serialization
#     (java.io.ObjectInputStream, java.io.ObjectOutputStream).