4907N/A# Copyright (c) 1995, 2012, Oracle and/or its affiliates. All rights reserved. 0N/A# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A# This code is free software; you can redistribute it and/or modify it 0N/A# under the terms of the GNU General Public License version 2 only, as 2362N/A# published by the Free Software Foundation. Oracle designates this 0N/A# particular file as subject to the "Classpath" exception as provided 2362N/A# by Oracle in the LICENSE file that accompanied this code. 0N/A# This code is distributed in the hope that it will be useful, but WITHOUT 0N/A# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A# version 2 for more details (a copy is included in the LICENSE file that 0N/A# accompanied this code). 0N/A# You should have received a copy of the GNU General Public License version 0N/A# 2 along with this work; if not, write to the Free Software Foundation, 0N/A# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 0N/A# Makefile to specify compiler flags for programs and libraries 0N/A# targeted to Solaris. Should not contain any rules. 0N/A# WARNING: This file is shared with other workspaces. 0N/A# So when it includes other files, it must use JDK_TOPDIR. 0N/A# Warning: the following variables are overridden by Defs.gmk. Set 0N/A# values will be silently ignored: 0N/A# CFLAGS (set $(OTHER_CFLAGS) instead) 0N/A# CPPFLAGS (set $(OTHER_CPPFLAGS) instead) 0N/A# CXXFLAGS (set $(OTHER_CXXFLAGS) instead) 0N/A# LDFLAGS (set $(OTHER_LDFAGS) instead) 0N/A# LDLIBS (set $(EXTRA_LIBS) instead) 0N/A# LDLIBS_COMMON (set $(EXTRA_LIBS) instead) 0N/A# LINTFLAGS (set $(OTHER_LINTFLAGS) instead) 422N/A# Note: CPPFLAGS are used in C and C++ compiles. 0N/A# Get shared JDK settings 4924N/A# Location of the various .properties files specific to Solaris platform 0N/A# Platform specific closed sources 0N/A# platform specific include files 0N/A# suffix used for make dependencies files 0N/A# suffix used for lint files 0N/A# The suffix applied to the library name for FDLIBM 0N/A# The suffix applied to scripts (.bat for windows, nothing for unix) 0N/A# CC compiler object code output directive flag value 4915N/A# The Full Debug Symbols (FDS) default for VARIANT == OPT builds is 4915N/A# enabled with debug info files ZIP'ed to save space. For VARIANT != 4915N/A# OPT builds, FDS is always enabled, after all a debug build without 4915N/A# debug info isn't very useful. The ZIP_DEBUGINFO_FILES option only has 4915N/A# meaning when FDS is enabled. 4915N/A# If you invoke a build with FULL_DEBUG_SYMBOLS=0, then FDS will be 4915N/A# disabled for a VARIANT == OPT build. 4915N/A# Note: Use of a different variable name for the FDS override option 4915N/A# versus the FDS enabled check is intentional (FULL_DEBUG_SYMBOLS 4915N/A# versus ENABLE_FULL_DEBUG_SYMBOLS). For auto build systems that pass 4915N/A# in options via environment variables, use of distinct variables 4915N/A# prevents strange behaviours. For example, in a VARIANT != OPT build, 4915N/A# the FULL_DEBUG_SYMBOLS environment variable will be 0, but the 4915N/A# ENABLE_FULL_DEBUG_SYMBOLS make variable will be 1. If the same 4915N/A# variable name is used, then different values can be picked up by 4915N/A# different parts of the build. Just to be clear, we only need two 4915N/A# variable names because the incoming option value can be overridden 4915N/A# in some situations, e.g., a VARIANT != OPT build. 4915N/A # debug variants always get Full Debug Symbols (if available) 4907N/A# since objcopy is optional, we set ZIP_DEBUGINFO_FILES later 4907N/A # Default OBJCOPY comes from the SUNWbinutils package: 5036N/A # disable .debuginfo support by setting ALT_OBJCOPY to a non-existent path 4907N/A # Setting ENABLE_FULL_DEBUG_SYMBOLS=1 (and OBJCOPY) above enables the 4907N/A # JDK build to import .debuginfo or .diz files from the HotSpot build. 4907N/A # However, adding FDS support to the JDK build will occur in phases 4956N/A # so a different make variable (LIBRARY_SUPPORTS_FULL_DEBUG_SYMBOLS 4956N/A # and PROGRAM_SUPPORTS_FULL_DEBUG_SYMBOLS) is used to indicate that a 4956N/A # particular library or program supports FDS. 4907N/A echo >&2 "INFO: no objcopy cmd found so cannot create .debuginfo files.") 4907N/A echo >&2 "INFO: $(OBJCOPY) cmd found so will create .debuginfo files.") 4907N/A # Library stripping policies for .debuginfo configs: 4907N/A # all_strip - strips everything from the library 4907N/A # min_strip - strips most stuff from the library; leaves minimum symbols 4907N/A # no_strip - does not strip the library at all 4907N/A # Oracle security policy requires "all_strip". A waiver was granted on 4907N/A # 2011.09.01 that permits using "min_strip" in the Java JDK and Java JRE. 4907N/A # Currently, STRIP_POLICY is only used when Full Debug Symbols is enabled. 0N/A# Java default optimization (-x04/-O2) etc. Applies to the VM. 460N/A# If -Xa is in CFLAGS_COMMON it will end up ahead of $(CC_OPT) for the 0N/A# optimized build, and that ordering of the flags completely freaks 0N/A# out cc. Hence, -Xa is instead in each CFLAGS variant. 0N/A# The more unusual options to the Sun C compiler: 0N/A# -v Stricter type checking, more error checking 0N/A# (To turn ALL warnings into fatals, use -errwarn=%all) 0N/A# -xstrconst Place string literals and constants in read-only area 0N/A# (means you can't write on your string literals) 0N/A# -xs Force debug information (stabs) into the .so or a.out 0N/A# .o files needing to be around, but at a space cost) 0N/A# -g & -O If you add the -g option to the optimized compiles 0N/A# you will get better stack retraces, the code is 0N/A# still optimized. This includes a space cost too. 0N/A# -xc99=%none Do NOT allow for c99 extensions to be used. 0N/A# e.g. declarations must precede statements 0N/A# -xCC Allow the C++ style of comments in C: // 0N/A# Required with many of the source files. 0N/A# -mt Assume multi-threaded (important) 422N/A# The more unusual options to the Sun C compiler: 422N/A# +w Print more warnings 0N/A# Debug flag for C and C++ compiler 0N/A# Turn off -g if we are doing tcov build 0N/A# FASTDEBUG: Optimize the -g builds, gives us a faster debug java 0N/A# If true adds -O to the debug compiles. This allows for any assert 0N/A# tests to remain and debug checking. The resulting code is faster 0N/A# but less debuggable. Stack traces are still valid, although only 0N/A# approximate line numbers are given. Printing of local variables 0N/A# during a debugging session is not possible, but stepping and 0N/A# printing of global or static variables should be possible. 4956N/A# If Full Debug Symbols is enabled, then we want the same debug and 4956N/A# optimization flags as used by FASTDEBUG. We also want all the 4956N/A# debug info in one place (-xs). 422N/A# Do not allow C99 language features like declarations in code etc. 422N/A# Allow C++ comments in C code 422N/A# Show error message tags on errors 422N/A# Required C compiler flags 422N/A# Maximum warnings all the time 0N/A# Assume MT behavior all the time (important) 0N/A# Assume no C++ exceptions are used 0N/A# For C++, these options tell it to assume nothing about locating libraries 0N/A# either at compile time, or at runtime. Use of these options will likely 0N/A# require the use of -L and -R options to indicate where libraries will 0N/A# be found at compile time (-L) and at runtime (-R). 0N/A# The /usr/lib location comes for free, so no need to specify that one. 0N/A# Note: C is much simplier and there is no need for these options. This 0N/A# is mostly needed to avoid dependencies on libraries in the 0N/A# Compiler install area, also see LIBCXX and LIBM. 0N/A# Treat compiler warnings as errors, if requested 0N/A# Add -xstrconst to the library compiles. This forces all string 0N/A# literals into the read-only data section, which prevents them from 0N/A# being written to and increases the runtime pages shared on the system. 0N/A# Source browser database 0N/A# If defined adds -xsb to compiles and creates a 0N/A# source browsing database during compilation. 0N/A# -Xa ANSI C plus K&R, favor ANSI rules 0N/A# -fd report on old style func defs 0N/A# -errchk=structarg report on 64bit struct args by value 0N/A# -errchk=longptr64 report on 64bit to 32bit issues (ignores casts) 0N/A# -errchk=parentheses report on suggested use of extra parens 0N/A# -v suppress unused args 0N/A# -x suppress unused externs 0N/A# -errfmt=simple use one line errors with position info 0N/A# The -W0,-noglobal tells the compiler to NOT generate mangled global 0N/A# ELF data symbols for file local static data. 0N/A# This can break fix&continue, but we'd rather do the same compilations 0N/A# for deliverable bits as we do for non-deliverable bits 0N/A# Tell the compilers to never generate globalized names, all the time. 334N/A# If we have a specific arch value to use, add it 0N/A# uncomment the following to build with PERTURBALOT set 0N/A# OTHER_CFLAGS += -DPERTURBALOT 0N/A # The macro _LITTLE_ENDIAN needs to be defined the same to avoid the 0N/A # Sun C compiler warning message: warning: macro redefined: _LITTLE_ENDIAN 0N/A # Note: -Dmacro is the same as #define macro 1 0N/A # -Dmacro= is the same as #define macro 0N/A # Turn off a superfluous compiler error message on Intel 0N/A# Java memory management is based on memory mapping by default, but a 0N/A# system only assuming malloc/free can be built by adding -DUSE_MALLOC 0N/A# -L paths for finding and -ljava 0N/A# We never really want the incremental linker, ever 0N/A# The -xildoff option tells Sun's compilers to NOT use incremental linker 0N/A # Libraries need to locate other libraries at runtime, and you can tell 0N/A # a library where to look by way of the dynamic runpaths (RPATH or RUNPATH) 0N/A # buried inside the .so. The $ORIGIN says to look relative to where 0N/A # the library itself is and it can be followed with relative paths from 0N/A # that. By default we always look in $ORIGIN, optionally we add relative 0N/A # paths if the Makefile sets LD_RUNPATH_EXTRAS to those relative paths. 0N/A # The environment variable LD_LIBRARY_PATH will over-ride these runpaths. 0N/A # Try: 'dump -Lv lib*.so' to see these settings in a library. 0N/A# Postprocessing is done on the images directories only 0N/A # Debug 'strip -x' leaves local function Elf symbols (better stack traces) 0N/A# Sun C compiler will take -M and pass it on to ld. 0N/A# Usage: ld $(LD_MAPFILE_FLAG) mapfile *.o 0N/A# Variables globally settable from the make command line (default 0N/A# values in brackets): 0N/A# Eg: % gnumake GPROF=true 0N/A# PARTIAL_GPROF is to be used ONLY during compilation - it should not 0N/A# appear during linking of libraries or programs. It also should 0N/A# prevent linking with -z defs to allow a symbol to remain undefined. 0N/A# For a TCOV build we add in the TCOV_OPTION 0N/A# Solaris only uses native threads. 0N/A# Support for Quantify. 0N/A# Support for Purify. 0N/A# Different "levels" of optimization. 0N/A # Automatic precompiled header option to use (if COMPILE_APPROACH=batch) 0N/A # Highest could be -xO5, but indications are that -xO5 should be reserved 0N/A # for a per-file use, on sources with known performance impacts. 460N/A # We need stack frames at all times 460N/A # Unknown spelling on this option at this time (Maybe in SS13?) 460N/A # On X86, make sure tail call optimization is off 460N/A # The z and y are the tail call optimizations. 4031N/A # Somehow, tail call optimization is creeping in. 4031N/A # WARNING: These may cause compiler warnings about duplicate -O options 460N/A # On i586 we need to tell the code generator to ALWAYS use a 460N/A # Note that in 5.7, this is done with -xregs=no%frameptr 460N/A # It's not exactly clear when this optimization kicks in, the 460N/A # current assumption is -xO4 or greater and for C++ with 460N/A # the -features=no%except option and -xO4 and greater. 460N/A # Bottom line is, we ALWAYS want a frame pointer! 4031N/A # Do NOT use frame pointer register as a general purpose opt register 460N/A # Optimizer for sparc needs to be told not to do certain things 460N/A # related to frames or save instructions. 460N/A # Do not use save instructions instead of add instructions 460N/A # This was an optimization starting in SC5.0 that made it hard for us to 460N/A # find the "save" instruction (which got turned into an "add") 460N/A # Don't allow tail call code optimization. Started in SC5.0. 460N/A # We don't like code of this form: 460N/A # because we can't tell if the method will have a stack frame 460N/A # and register windows or not. 460N/A # Extra options used with HIGHEST 460N/A # WARNING: Use of OPTIMIZATION_LEVEL=HIGHEST in your Makefile needs to be 0N/A # done with care, there are some assumptions below that need to 0N/A # be understood about the use of pointers, and IEEE behavior. 0N/A # Use non-standard floating point mode (not IEEE 754) 0N/A # Do some simplification of floating point arithmetic (not IEEE 754) 0N/A # Use single precision floating point with 'float' 0N/A # Assume memory references via basic pointer types do not alias 0N/A # (Source with excessing pointer casting and data access with mixed 0N/A # pointer types are not recommended) 0N/A # Use intrinsic or inline versions for math/std functions 0N/A # (If you expect perfect errno behavior, do not use this) 0N/A # Loop data dependency optimizations (need -xO3 or higher) 0N/A # Pointer parameters to functions do not overlap 0N/A # (Similar to -xalias_level=basic usage, but less obvious sometimes. 0N/A # If you pass in multiple pointers to the same data, do not use this) 0N/A # Inline some library routines 0N/A # (If you expect perfect errno behavior, do not use this) 0N/A # Use optimized math routines 0N/A # (If you expect perfect errno behavior, do not use this) 0N/A # Can cause undefined external on Solaris 8 X86 on __sincos, removing for now 460N/A # CC_HIGHEST_EXTRAS += -xlibmopt 0N/A # Assume at most 8byte alignment, raise SIGBUS on error 0N/A ### Presents an ABI issue with customer JNI libs? 460N/A ####CC_HIGHEST_EXTRAS += -xmemalign=8s 0N/A # Automatic prefetch instructions, explicit prefetch macros 0N/A # Pick ultra as the chip to optimize to 0N/A # Pick pentium as the chip to optimize to 0N/A # The Solaris CBE (Common Build Environment) requires that the use 0N/A # of appl registers be disabled when compiling a public library (or 0N/A # a library that's loaded by a public library) on sparc. 0N/A # Presents an ABI issue with customer JNI libs? We must be able to 0N/A # to handle 4byte aligned objects? (rare occurance, but possible?) 0N/A # Just incase someone trys to use the SOS9 compilers 0N/A # We MUST allow data alignment of 4 for sparc (sparcv9 is ok at 8s) 0N/A # Automatic precompiled header option to use (if COMPILE_APPROACH=batch) 0N/A # (See Rules.gmk) The SS11 -xpch=auto* options appear to be broken. 460N/A # Add in keep frame options 460N/A # Add in highest optimization settings 460N/A# Default optimization settings based on level. 0N/A# Flags required all the time 0N/A# Path and option to link against the VM, if you have to. Note that 0N/A# there are libraries that link against only -ljava, but they do get 0N/A# -L to the -ljvm, this is because -ljava depends on -ljvm, whereas 0N/A# the library itself should not. 0N/A# Part of INCREMENTAL_BUILD mechanism. 0N/A# In addition on Solaris, any include file starting with / is deleted, 0N/A# this gets rid of things like /usr/include files, which never change. 0N/A# Location of openwin libraries (do we really need this anymore?) 0N/A# Runtime graphics library search paths... 0N/A# Originally used instead of -lCrun to guarantee use of the system 0N/A# .so version and not the .a or .so that came with the compilers. 0N/A# With the newer compilers this could probably change back to -lCrun but 0N/A# in general this is ok to continue to do. 4481N/A# service configuration facility library 0N/A# GLOBAL_KPIC: If set means all libraries are PIC, position independent code 0N/A# EXCEPT for select compiles 0N/A# If a .o file is compiled non-PIC then it should be forced 0N/A# into the RW data segment with a mapfile option. This is done 0N/A# with object files which generated from .s files. 0N/A# The -ztext enforces that no relocations remain in the text segment 0N/A# so that it remains purely read-only for optimum system performance. 0N/A# Some libraries may use a smaller size (13bit -Kpic) on sparc instead of 0N/A# (32 bit -KPIC) and will override GLOBAL_KPIC appropriately. 0N/A# If your platform has DPS, it will have Type1 fonts too, in which case 0N/A# it is best to enable DPS support until such time as 2D's rasteriser 0N/A# can fully handle Type1 fonts in all cases. Default is "yes". 0N/A# HAVE_DPS should only be "no" if the platform has no DPS headers or libs 0N/A# DPS (Displayable PostScript) is available on Solaris machines 0N/A# Settings for the JDI - Serviceability Agent binding.