Defs-solaris.gmk revision 422
5923N/A# Copyright 1995-2008 Sun Microsystems, Inc. All Rights Reserved. 5923N/A# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 5923N/A# This code is free software; you can redistribute it and/or modify it 5923N/A# under the terms of the GNU General Public License version 2 only, as 5923N/A# published by the Free Software Foundation. Sun designates this 5923N/A# particular file as subject to the "Classpath" exception as provided 5923N/A# by Sun in the LICENSE file that accompanied this code. 5923N/A# This code is distributed in the hope that it will be useful, but WITHOUT 5923N/A# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 5923N/A# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 5923N/A# version 2 for more details (a copy is included in the LICENSE file that 5923N/A# You should have received a copy of the GNU General Public License version 5923N/A# 2 along with this work; if not, write to the Free Software Foundation, 5923N/A# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 5923N/A# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, 5923N/A# Makefile to specify compiler flags for programs and libraries 5923N/A# targeted to Solaris. Should not contain any rules. 5923N/A# WARNING: This file is shared with other workspaces. 5923N/A# So when it includes other files, it must use JDK_TOPDIR. 5923N/A# values will be silently ignored: 5923N/A# CFLAGS (set $(OTHER_CFLAGS) instead) 5923N/A# CPPFLAGS (set $(OTHER_CPPFLAGS) instead) 5923N/A# CXXFLAGS (set $(OTHER_CXXFLAGS) instead) 5923N/A# LDFLAGS (set $(OTHER_LDFAGS) instead) 5923N/A# LDLIBS (set $(EXTRA_LIBS) instead) 5923N/A# LDLIBS_COMMON (set $(EXTRA_LIBS) instead) 5923N/A# LINTFLAGS (set $(OTHER_LINTFLAGS) instead) 5923N/A# Note: CPPFLAGS are used in C and C++ compiles. 5923N/A# Platform specific closed sources 5923N/A# platform specific include files 5923N/A# suffix used for make dependencies files 5923N/A# suffix used for lint files 5923N/A# The suffix applied to the library name for FDLIBM 5923N/A# The suffix applied to scripts (.bat for windows, nothing for unix) 5923N/A# CC compiler object code output directive flag value 5923N/A# Default HPI libraries. Build will build only native unless 5923N/A# overriden at the make command line. This makes it convenient for 5923N/A# people doing, say, a pthreads port -- they can create a posix 5923N/A# directory here, and say "gnumake HPIS=posix" at the top 5923N/A# Java default optimization (-x04/-O2) etc. Applies to the VM. 5923N/A# If -Xa is in CFLAGS_COMMON it will end up ahead of $(POPT) for the 5923N/A# optimized build, and that ordering of the flags completely freaks 5923N/A# out cc. Hence, -Xa is instead in each CFLAGS variant. 5923N/A# The more unusual options to the Sun C compiler: 5923N/A# -v Stricter type checking, more error checking 5923N/A# (To turn ALL warnings into fatals, use -errwarn=%all) 5923N/A# -xstrconst Place string literals and constants in read-only area 5923N/A# (means you can't write on your string literals) 5923N/A# -xs Force debug information (stabs) into the .so or a.out 5923N/A# .o files needing to be around, but at a space cost) 5923N/A# -g & -O If you add the -g option to the optimized compiles 5923N/A# you will get better stack retraces, the code is 5923N/A# still optimized. This includes a space cost too. 5923N/A# -xc99=%none Do NOT allow for c99 extensions to be used. 5923N/A# e.g. declarations must precede statements 5923N/A# -xCC Allow the C++ style of comments in C: // 5923N/A# Required with many of the source files. 5923N/A# -mt Assume multi-threaded (important) 5923N/A# The more unusual options to the Sun C compiler: 5923N/A# Debug flag for C and C++ compiler 5923N/A# Turn off -g if we are doing tcov build 5923N/A# FASTDEBUG: Optimize the -g builds, gives us a faster debug java 5923N/A# If true adds -O to the debug compiles. This allows for any assert 5923N/A# tests to remain and debug checking. The resulting code is faster 5923N/A# but less debuggable. Stack traces are still valid, although only 5923N/A# approximate line numbers are given. Printing of local variables 5923N/A# during a debugging session is not possible, but stepping and 5923N/A# printing of global or static variables should be possible. 5923N/A# Do not allow C99 language features like declarations in code etc. 5923N/A# Allow C++ comments in C code 5923N/A# Show error message tags on errors 5923N/A# Maximum warnings all the time 5923N/A# Assume MT behavior all the time (important) 5923N/A# Assume no C++ exceptions are used 5923N/A# For C++, these options tell it to assume nothing about locating libraries 5923N/A# either at compile time, or at runtime. Use of these options will likely 5923N/A# require the use of -L and -R options to indicate where libraries will 5923N/A# be found at compile time (-L) and at runtime (-R). 5923N/A# The /usr/lib location comes for free, so no need to specify that one. 5923N/A# Note: C is much simplier and there is no need for these options. This 5923N/A# is mostly needed to avoid dependencies on libraries in the 5923N/A# Compiler install area, also see LIBCXX and LIBM. 5923N/A# Treat compiler warnings as errors, if requested 4634N/A# Add -xstrconst to the library compiles. This forces all string 4634N/A# literals into the read-only data section, which prevents them from 4634N/A# being written to and increases the runtime pages shared on the system. 4634N/A# If defined adds -xsb to compiles and creates a 4634N/A# source browsing database during compilation. 4634N/A# -Xa ANSI C plus K&R, favor ANSI rules 4634N/A# -fd report on old style func defs 4634N/A# -errchk=structarg report on 64bit struct args by value 4634N/A# -errchk=longptr64 report on 64bit to 32bit issues (ignores casts) 4634N/A# -errchk=parentheses report on suggested use of extra parens 4634N/A# -x suppress unused externs 4634N/A# -errfmt=simple use one line errors with position info 4634N/A# The -W0,-noglobal tells the compiler to NOT generate mangled global 4634N/A# ELF data symbols for file local static data. 4634N/A# This can break fix&continue, but we'd rather do the same compilations 4634N/A# for deliverable bits as we do for non-deliverable bits 4634N/A# Tell the compilers to never generate globalized names, all the time. 4634N/A# If we have a specific arch value to use, add it 4634N/A# uncomment the following to build with PERTURBALOT set 4634N/A# OTHER_CFLAGS += -DPERTURBALOT 3852N/A # The macro _LITTLE_ENDIAN needs to be defined the same to avoid the 3852N/A # Sun C compiler warning message: warning: macro redefined: _LITTLE_ENDIAN 3852N/A # Note: -Dmacro is the same as #define macro 1 3852N/A # -Dmacro= is the same as #define macro 3852N/A # Turn off a superfluous compiler error message on Intel 3852N/A# Java memory management is based on memory mapping by default, but a 3852N/A# -L paths for finding and -ljava 3852N/A# We never really want the incremental linker, ever 3852N/A# The -xildoff option tells Sun's compilers to NOT use incremental linker 3852N/A # Libraries need to locate other libraries at runtime, and you can tell 3852N/A # a library where to look by way of the dynamic runpaths (RPATH or RUNPATH) 3852N/A # buried inside the .so. The $ORIGIN says to look relative to where 3852N/A # the library itself is and it can be followed with relative paths from 3852N/A # that. By default we always look in $ORIGIN, optionally we add relative 3852N/A # paths if the Makefile sets LD_RUNPATH_EXTRAS to those relative paths. 3852N/A # The environment variable LD_LIBRARY_PATH will over-ride these runpaths. 3852N/A # Try: 'dump -Lv lib*.so' to see these settings in a library. 3852N/A# Postprocessing is done on the images directories only 3852N/A # Debug 'strip -x' leaves local function Elf symbols (better stack traces) 3852N/A# Sun C compiler will take -M and pass it on to ld. 3852N/A# Usage: ld $(LD_MAPFILE_FLAG) mapfile *.o 3852N/A# Variables globally settable from the make command line (default 3852N/A# PARTIAL_GPROF is to be used ONLY during compilation - it should not 3852N/A# appear during linking of libraries or programs. It also should 3852N/A# prevent linking with -z defs to allow a symbol to remain undefined. 3852N/A# For a TCOV build we add in the TCOV_OPTION 3852N/A# Solaris only uses native threads. 729N/A# Different "levels" of optimization. 729N/A # Automatic precompiled header option to use (if COMPILE_APPROACH=batch) 729N/A # Highest could be -xO5, but indications are that -xO5 should be reserved 729N/A # for a per-file use, on sources with known performance impacts. 729N/A # WARNING: Use of _OPT=$(CC_HIGHEST_OPT) in your Makefile needs to be 729N/A # done with care, there are some assumptions below that need to 729N/A # be understood about the use of pointers, and IEEE behavior. 729N/A # Use non-standard floating point mode (not IEEE 754) 729N/A # Do some simplification of floating point arithmetic (not IEEE 754) 729N/A # Use single precision floating point with 'float' 729N/A # Assume memory references via basic pointer types do not alias 729N/A # (Source with excessing pointer casting and data access with mixed 729N/A # pointer types are not recommended) 729N/A # (If you expect perfect errno behavior, do not use this) 729N/A # Loop data dependency optimizations (need -xO3 or higher) 729N/A # Pointer parameters to functions do not overlap 729N/A # (Similar to -xalias_level=basic usage, but less obvious sometimes. 729N/A # If you pass in multiple pointers to the same data, do not use this) 729N/A # Inline some library routines 729N/A # (If you expect perfect errno behavior, do not use this) 729N/A # Use optimized math routines 729N/A # (If you expect perfect errno behavior, do not use this) 729N/A # Can cause undefined external on Solaris 8 X86 on __sincos, removing for now 729N/A # CC_HIGHEST_OPT += -xlibmopt 729N/A # Assume at most 8byte alignment, raise SIGBUS on error 729N/A ### Presents an ABI issue with customer JNI libs? 729N/A ####CC_HIGHEST_OPT += -xmemalign=8s 729N/A # Automatic prefetch instructions, explicit prefetch macros 729N/A # Pick ultra as the chip to optimize to 729N/A # Pick pentium as the chip to optimize to 729N/A # The Solaris CBE (Common Build Environment) requires that the use 729N/A # of appl registers be disabled when compiling a public library (or 729N/A # a library that's loaded by a public library) on sparc. 729N/A # Do NOT use the frame pointer register as a general purpose opt register 729N/A # We MUST allow data alignment of 4 for sparc V8 (32bit) 729N/A # Presents an ABI issue with customer JNI libs? We must be able to 729N/A # to handle 4byte aligned objects? (rare occurance, but possible?) 729N/A # Just incase someone trys to use the SOS9 compilers 729N/A # We MUST allow data alignment of 4 for sparc (sparcv9 is ok at 8s) 729N/A # Automatic precompiled header option to use (if COMPILE_APPROACH=batch) 729N/A# If NO_OPTIMIZATIONS is defined in the environment, turn all optimzations off 729N/A# Flags required all the time 729N/A# Add processor specific options for optimizations 729N/A# Secret compiler optimization options that should be in the above macros 729N/A# but since they differ in format from C to C++, are added into the C or 729N/A# C++ specific macros for compiler flags. 729N/A# On i586 we need to tell the code generator to ALWAYS use a 729N/A # Note that in 5.7, this is done with -xregs=no%frameptr 729N/A # It's not exactly clear when this optimization kicks in, the 729N/A # current assumption is -xO4 or greater and for C++ with 729N/A # the -features=no%except option and -xO4 and greater. 729N/A # Bottom line is, we ALWAYS want a frame pointer! 729N/A# Optimizer for sparc needs to be told not to do certain things 729N/A# related to frames or save instructions. 729N/A # NOTE: Someday the compilers will provide a high-level option for this. 729N/A # Use save instructions instead of add instructions 729N/A # This was an optimization starting in SC5.0 that made it hard for us to 729N/A # find the "save" instruction (which got turned into an "add") 729N/A # NOTE: Someday the compilers will provide a high-level option for this. 729N/A # Don't allow tail call code optimization. Started in SC5.0. 729N/A # We don't like code of this form: 729N/A # because we can't tell if the method will have a stack frame 729N/A # and register windows or not. 729N/A# Path and option to link against the VM, if you have to. Note that 729N/A# there are libraries that link against only -ljava, but they do get 729N/A# -L to the -ljvm, this is because -ljava depends on -ljvm, whereas 729N/A# the library itself should not. 729N/A# Part of INCREMENTAL_BUILD mechanism. 729N/A# In addition on Solaris, any include file starting with / is deleted, 729N/A# Location of openwin libraries (do we really need this anymore?) 729N/A# Runtime graphics library search paths... 729N/A# Originally used instead of -lCrun to guarantee use of the system 729N/A# .so version and not the .a or .so that came with the compilers. 729N/A# With the newer compilers this could probably change back to -lCrun but 729N/A# in general this is ok to continue to do. 729N/A# There might be two versions of libm.so on the build system: 729N/A# Depending on the Solaris release being used to build with, 729N/A# This is a critical factor in allowing builds on Solaris 10 or newer 729N/A# to run on Solaris 8 or 9. 729N/A# Note: Historically there was also a problem picking up a static version 729N/A# of libm.a from the compiler area, but that problem has gone away 729N/A# with the newer compilers. Use of libm.a would cause .so bloat. 729N/A# GLOBAL_KPIC: If set means all libraries are PIC, position independent code 729N/A# EXCEPT for select compiles 729N/A# If a .o file is compiled non-PIC then it should be forced 729N/A# into the RW data segment with a mapfile option. This is done 729N/A# with object files which generated from .s files. 729N/A# The -ztext enforces that no relocations remain in the text segment 729N/A# so that it remains purely read-only for optimum system performance. 729N/A# Some libraries may use a smaller size (13bit -Kpic) on sparc instead of 729N/A# (32 bit -KPIC) and will override GLOBAL_KPIC appropriately. 729N/A# If your platform has DPS, it will have Type1 fonts too, in which case 729N/A# it is best to enable DPS support until such time as 2D's rasteriser 729N/A# can fully handle Type1 fonts in all cases. Default is "yes". 729N/A# HAVE_DPS should only be "no" if the platform has no DPS headers or libs 729N/A# DPS (Displayable PostScript) is available on Solaris machines 729N/A# Settings for the JDI - Serviceability Agent binding.