Defs-solaris.gmk revision 0
0N/A# Copyright 1995-2007 Sun Microsystems, Inc. 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 0N/A# published by the Free Software Foundation. Sun designates this 0N/A# particular file as subject to the "Classpath" exception as provided 0N/A# by Sun 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. 0N/A# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, 0N/A# CA 95054 USA or visit www.sun.com if you need additional information or 0N/A# have any questions. 0N/A# Makefile to specify compiler flags for programs and libraries 0N/A# targeted to Solaris. Should not contain any rules. 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) 0N/A# Get shared JDK settings 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 0N/A# Default HPI libraries. Build will build only native unless 0N/A# overriden at the make command line. This makes it convenient for 0N/A# people doing, say, a pthreads port -- they can create a posix 0N/A# directory here, and say "gnumake HPIS=posix" at the top 0N/A# Java default optimization (-x04/-O2) etc. Applies to the VM. 0N/A# If -Xa is in CFLAGS_COMMON it will end up ahead of $(POPT) 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) 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. 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# -Xarch=XXX Same as 'cc -xarch=XXX' 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. 0N/A# Arch specific settings (determines type of .o files and instruction set) 0N/A # Someday this should change to improve optimization on UltraSPARC 0N/A # and abandon the old v8-only machines like the SPARCstation 10. 0N/A # Indications with Mustang is that alacrity runs do not show a 0N/A # big improvement using v8plus over v8, but other benchmarks might. 0N/A# Arch value based on current data model being built 0N/A # The actual compiler -xarch options to use 0N/A# If we have a specific -xarch 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. 0N/A # WARNING: Use of _OPT=$(CC_HIGHEST_OPT) 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 0N/A # CC_HIGHEST_OPT += -xlibmopt 0N/A # Assume at most 8byte alignment, raise SIGBUS on error 0N/A ### Presents an ABI issue with customer JNI libs? 0N/A ####CC_HIGHEST_OPT += -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 # Do NOT use the frame pointer register as a general purpose opt register 0N/A # We MUST allow data alignment of 4 for sparc V8 (32bit) 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. 0N/A# If NO_OPTIMIZATIONS is defined in the environment, turn all optimzations off 0N/A# Flags required all the time 0N/A# Add processor specific options for optimizations 0N/A# Secret compiler optimization options that should be in the above macros 0N/A# but since they differ in format from C to C++, are added into the C or 0N/A# C++ specific macros for compiler flags. 0N/A# On i586 we need to tell the code generator to ALWAYS use a 0N/A # Note that in 5.7, this is done with -xregs=no%frameptr 0N/A # It's not exactly clear when this optimization kicks in, the 0N/A # current assumption is -xO4 or greater and for C++ with 0N/A # the -features=no%except option and -xO4 and greater. 0N/A # Bottom line is, we ALWAYS want a frame pointer! 0N/A# Optimizer for sparc needs to be told not to do certain things 0N/A# related to frames or save instructions. 0N/A # NOTE: Someday the compilers will provide a high-level option for this. 0N/A # Use save instructions instead of add instructions 0N/A # This was an optimization starting in SC5.0 that made it hard for us to 0N/A # find the "save" instruction (which got turned into an "add") 0N/A # NOTE: Someday the compilers will provide a high-level option for this. 0N/A # Don't allow tail call code optimization. Started in SC5.0. 0N/A # We don't like code of this form: 0N/A # because we can't tell if the method will have a stack frame 0N/A # and register windows or not. 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. 0N/A# There might be two versions of libm.so on the build system: 0N/A# Depending on the Solaris release being used to build with, 0N/A# explicit here so that the libjvm.so you have built will work on an 0N/A# older Solaris release that might not have libm.so.2. 0N/A# This is a critical factor in allowing builds on Solaris 10 or newer 0N/A# to run on Solaris 8 or 9. 0N/A# Note: Historically there was also a problem picking up a static version 0N/A# of libm.a from the compiler area, but that problem has gone away 0N/A# with the newer compilers. Use of libm.a would cause .so bloat. 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