1 #
   2 # Copyright (c) 2011, 2018, Oracle and/or its affiliates. All rights reserved.
   3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4 #
   5 # This code is free software; you can redistribute it and/or modify it
   6 # under the terms of the GNU General Public License version 2 only, as
   7 # published by the Free Software Foundation.  Oracle designates this
   8 # particular file as subject to the "Classpath" exception as provided
   9 # by Oracle in the LICENSE file that accompanied this code.
  10 #
  11 # This code is distributed in the hope that it will be useful, but WITHOUT
  12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14 # version 2 for more details (a copy is included in the LICENSE file that
  15 # accompanied this code).
  16 #
  17 # You should have received a copy of the GNU General Public License version
  18 # 2 along with this work; if not, write to the Free Software Foundation,
  19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20 #
  21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22 # or visit www.oracle.com if you need additional information or have any
  23 # questions.
  24 #
  25 
  26 # When you read this source. Remember that $(sort ...) has the side effect
  27 # of removing duplicates. It is actually this side effect that is
  28 # desired whenever sort is used below!
  29 
  30 ifeq (,$(_MAKEBASE_GMK))
  31   $(error You must include MakeBase.gmk prior to including NativeCompilation.gmk)
  32 endif
  33 
  34 ifneq ($(TOOLCHAIN_TYPE), microsoft)
  35   COMPILING_MSG=echo $(LOG_INFO) "Compiling $(notdir $1) (for $(notdir $2))"
  36   LINKING_MSG=echo $(LOG_INFO) "Linking $1"
  37   LINKING_EXE_MSG=echo $(LOG_INFO) "Linking executable $1"
  38   ARCHIVING_MSG=echo $(LOG_INFO) "Archiving $1"
  39 else
  40   COMPILING_MSG=
  41   LINKING_MSG=
  42   LINKING_EXE_MSG=
  43   ARCHIVING_MSG=
  44 endif
  45 
  46 define add_native_source
  47   # param 1 = BUILD_MYPACKAGE
  48   # parma 2 = the source file name (..../alfa.c or .../beta.cpp)
  49   # param 3 = the bin dir that stores all .o (.obj) and .d files.
  50   # param 4 = the c flags to the compiler
  51   # param 5 = the c compiler
  52   # param 6 = the c++ flags to the compiler
  53   # param 7 = the c++ compiler
  54   # param 8 = the flags to the assembler
  55 
  56   ifneq (,$$(filter %.c,$2))
  57     # Compile as a C file
  58     $1_$2_FLAGS=$4 $$($1_$(notdir $2)_CFLAGS) -DTHIS_FILE='"$$(<F)"' -c
  59     $1_$2_COMP=$5
  60     $1_$2_DEP_FLAG:=$(C_FLAG_DEPS)
  61   else ifneq (,$$(filter %.m,$2))
  62     # Compile as a objective-c file
  63     $1_$2_FLAGS=-x objective-c $4 $$($1_$(notdir $2)_CFLAGS) -DTHIS_FILE='"$$(<F)"' -c
  64     $1_$2_COMP=$5
  65     $1_$2_DEP_FLAG:=$(C_FLAG_DEPS)
  66   else ifneq (,$$(filter %.s,$2))
  67     # Compile as assembler file
  68     $1_$2_FLAGS=$8 -DTHIS_FILE='"$$(<F)"'
  69     $1_$2_COMP=$(AS)
  70     $1_$2_DEP_FLAG:=
  71   else
  72     # Compile as a C++ file
  73     $1_$2_FLAGS=$6 $$($1_$(notdir $2)_CXXFLAGS) -DTHIS_FILE='"$$(<F)"' -c
  74     $1_$2_COMP=$7
  75     $1_$2_DEP_FLAG:=$(CXX_FLAG_DEPS)
  76   endif
  77   # Generate the .o (.obj) file name and place it in the bin dir.
  78   $1_$2_OBJ:=$3/$$(patsubst %.cpp,%$(OBJ_SUFFIX),$$(patsubst %.c,%$(OBJ_SUFFIX),$$(patsubst %.m,%$(OBJ_SUFFIX),$$(patsubst %.s,%$(OBJ_SUFFIX),$$(notdir $2)))))
  79   # Only continue if this object file hasn't been processed already. This lets the first found
  80   # source file override any other with the same name.
  81   ifeq (,$$(findstring $$($1_$2_OBJ),$$($1_OBJS_SO_FAR)))
  82     $1_OBJS_SO_FAR+=$$($1_$2_OBJ)
  83     ifeq (,$$(filter %.s,$2))
  84       # And this is the dependency file for this obj file.
  85       $1_$2_DEP:=$$(patsubst %$(OBJ_SUFFIX),%.d,$$($1_$2_OBJ))
  86       # Include previously generated dependency information. (if it exists)
  87       -include $$($1_$2_DEP)
  88 
  89       ifeq ($(TOOLCHAIN_TYPE), microsoft)
  90         $1_$2_DEBUG_OUT_FLAGS:=-Fd$$(patsubst %$(OBJ_SUFFIX),%.pdb,$$($1_$2_OBJ)) \
  91             -Fm$$(patsubst %$(OBJ_SUFFIX),%.map,$$($1_$2_OBJ))
  92       endif
  93     endif
  94 
  95     $$($1_$2_OBJ) : $2
  96         ifneq ($(TOOLCHAIN_TYPE), microsoft)
  97           $$(call COMPILING_MSG,$2,$$($1_TARGET))
  98           # The Solaris studio compiler doesn't output the full path to the object file in the
  99           # generated deps files. Fixing it with sed. If compiling assembly, don't try this.
 100           ifeq ($(TOOLCHAIN_TYPE)$$(filter %.s,$2), solstudio)
 101             $$($1_$2_COMP) $$($1_$2_FLAGS) $$($1_$2_DEP_FLAG) $$($1_$2_DEP).tmp $(CC_OUT_OPTION)$$($1_$2_OBJ) $2
 102             $(SED) 's|^$$(@F):|$$@:|' $$($1_$2_DEP).tmp > $$($1_$2_DEP)
 103           else
 104             $$($1_$2_COMP) $$($1_$2_FLAGS) $$($1_$2_DEP_FLAG) $$($1_$2_DEP) $(CC_OUT_OPTION)$$($1_$2_OBJ) $2
 105           endif
 106         endif
 107         # The Visual Studio compiler lacks a feature for generating make dependencies, but by
 108         # setting -showIncludes, all included files are printed. These are filtered out and
 109         # parsed into make dependences.
 110         ifeq ($(TOOLCHAIN_TYPE), microsoft)
 111           ($$($1_$2_COMP) $$($1_$2_FLAGS) -showIncludes $$($1_$2_DEBUG_OUT_FLAGS) \
 112               $(CC_OUT_OPTION)$$($1_$2_OBJ) $2 ; echo $$$$? > $$($1_$2_DEP).exitvalue) \
 113               | $(TEE) $$($1_$2_DEP).raw | $(GREP) -v "^Note: including file:" \
 114               && exit `cat $$($1_$2_DEP).exitvalue`
 115           $(RM) $$($1_$2_DEP).exitvalue
 116           ($(ECHO) $$@: \\ \
 117           && $(SED) -e '/^Note: including file:/!d' \
 118               -e 's|Note: including file: *||' \
 119               -e 's|\\|/|g' \
 120               -e 's|^\([a-zA-Z]\):|/cygdrive/\1|g' \
 121               -e '/$(subst /,\/,$(TOPDIR))/!d' \
 122               -e 's|$$$$| \\|g' \
 123               $$($1_$2_DEP).raw) > $$($1_$2_DEP)
 124         endif
 125   endif
 126 endef
 127 
 128 define SetupNativeCompilation
 129   # param 1 is for example BUILD_MYPACKAGE
 130   # param 2,3,4,5,6,7,8 are named args.
 131   #   SRC one or more directory roots to scan for C/C++ files.
 132   #   LANG C or C++
 133   #   CFLAGS the compiler flags to be used, used both for C and C++.
 134   #   CXXFLAGS the compiler flags to be used for c++, if set overrides CFLAGS.
 135   #   LDFLAGS the linker flags to be used, used both for C and C++.
 136   #   LDFLAGS_SUFFIX the linker flags to be added last on the commandline
 137   #       typically the libraries linked to.
 138   #   ARFLAGS the archiver flags to be used
 139   #   OBJECT_DIR the directory where we store the object files
 140   #   LIBRARY the resulting library file
 141   #   PROGRAM the resulting exec file
 142   #   INCLUDES only pick source from these directories
 143   #   EXCLUDES do not pick source from these directories
 144   #   INCLUDE_FILES only compile exactly these files!
 145   #   EXCLUDE_FILES with these names
 146   #   VERSIONINFO_RESOURCE Input file for RC. Setting this implies that RC will be run
 147   #   RC_FLAGS flags for RC.
 148   #   MAPFILE mapfile
 149   #   REORDER reorder file
 150   #   DEBUG_SYMBOLS add debug symbols (if configured on)
 151   #   CC the compiler to use, default is $(CC)
 152   #   LDEXE the linker to use for linking executables, default is $(LDEXE)
 153   #   OPTIMIZATION sets optimization level to NONE, LOW, HIGH, HIGHEST
 154   $(foreach i,2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26, $(if $($i),$1_$(strip $($i)))$(NEWLINE))
 155   $(call LogSetupMacroEntry,SetupNativeCompilation($1),$2,$3,$4,$5,$6,$7,$8,$9,$(10),$(11),$(12),$(13),$(14),$(15),$(16),$(17),$(18),$(19),$(20),$(21),$(22),$(23),$(24),$(25),$(26))
 156   $(if $(27),$(error Internal makefile error: Too many arguments to SetupNativeCompilation, please update NativeCompilation.gmk))
 157 
 158   ifneq (,$$($1_BIN))
 159     $$(error BIN has been replaced with OBJECT_DIR)
 160   endif
 161 
 162   ifneq (,$$($1_LIB))
 163     $$(error LIB has been replaced with LIBRARY)
 164   endif
 165 
 166   ifneq (,$$($1_EXE))
 167     $$(error EXE has been replaced with PROGRAM)
 168   endif
 169 
 170   ifneq (,$$($1_LIBRARY))
 171     ifeq (,$$($1_OUTPUT_DIR))
 172       $$(error LIBRARY requires OUTPUT_DIR)
 173     endif
 174 
 175     ifneq ($$($1_LIBRARY),$(basename $$($1_LIBRARY)))
 176       $$(error directory of LIBRARY should be specified using OUTPUT_DIR)
 177     endif
 178 
 179     ifneq (,$(findstring $(SHARED_LIBRARY_SUFFIX),$$($1_LIBRARY)))
 180       $$(error LIBRARY should be specified without SHARED_LIBRARY_SUFFIX: $(SHARED_LIBRARY_SUFFIX))
 181     endif
 182 
 183     ifneq (,$(findstring $(LIBRARY_PREFIX),$$($1_LIBRARY)))
 184       $$(error LIBRARY should be specified without LIBRARY_PREFIX: $(LIBRARY_PREFIX))
 185     endif
 186 
 187     $1_BASENAME:=$(LIBRARY_PREFIX)$$($1_LIBRARY)$(SHARED_LIBRARY_SUFFIX)
 188     $1_TARGET:=$$($1_OUTPUT_DIR)/$$($1_BASENAME)
 189 
 190   endif
 191 
 192   ifneq (,$$($1_STATIC_LIBRARY))
 193     ifeq (,$$($1_OUTPUT_DIR))
 194       $$(error STATIC_LIBRARY requires OUTPUT_DIR)
 195     endif
 196 
 197     ifneq ($$($1_STATIC_LIBRARY),$(basename $$($1_STATIC_LIBRARY)))
 198       $$(error directory of STATIC_LIBRARY should be specified using OUTPUT_DIR)
 199     endif
 200 
 201     ifneq (,$(findstring $(STATIC_LIBRARY_SUFFIX),$$($1_STATIC_LIBRARY)))
 202       $$(error STATIC_LIBRARY should be specified without STATIC_LIBRARY_SUFFIX: $(STATIC_LIBRARY_SUFFIX))
 203     endif
 204 
 205     ifneq (,$(findstring $(LIBRARY_PREFIX),$$($1_STATIC_LIBRARY)))
 206       $$(error STATIC_LIBRARY should be specified without LIBRARY_PREFIX: $(LIBRARY_PREFIX))
 207     endif
 208 
 209     $1_BASENAME:=$(LIBRARY_PREFIX)$$($1_STATIC_LIBRARY)$(STATIC_LIBRARY_SUFFIX)
 210     $1_TARGET:=$$($1_OUTPUT_DIR)/$$($1_BASENAME)
 211   endif
 212 
 213   ifneq (,$$($1_PROGRAM))
 214     ifeq (,$$($1_OUTPUT_DIR))
 215       $$(error PROGRAM requires OUTPUT_DIR)
 216     endif
 217 
 218     ifneq ($$($1_PROGRAM),$(basename $$($1_PROGRAM)))
 219       $$(error directory of PROGRAM should be specified using OUTPUT_DIR)
 220     endif
 221 
 222     ifneq (,$(findstring $(EXE_SUFFIX),$$($1_PROGRAM)))
 223       $$(error PROGRAM should be specified without EXE_SUFFIX: $(EXE_SUFFIX))
 224     endif
 225 
 226     $1_BASENAME:=$$($1_PROGRAM)$(EXE_SUFFIX)
 227     $1_TARGET:=$$($1_OUTPUT_DIR)/$$($1_BASENAME)
 228 
 229   endif
 230 
 231   ifeq (,$$($1_TARGET))
 232     $$(error Neither PROGRAM, LIBRARY nor STATIC_LIBRARY has been specified for SetupNativeCompilation)
 233   endif
 234 
 235   ifeq (,$$($1_LANG))
 236     $$(error You have to specify LANG for native compilation $1)
 237   endif
 238   ifeq (C,$$($1_LANG))
 239     ifeq ($$($1_LDEXE),)
 240       $1_LDEXE:=$(LDEXE)
 241     endif
 242     $1_LD:=$(LD)
 243   else
 244     ifeq (C++,$$($1_LANG))
 245       $1_LD:=$(LDCXX)
 246       $1_LDEXE:=$(LDEXECXX)
 247     else
 248       $$(error Unknown native language $$($1_LANG) for $1)
 249     endif
 250   endif
 251 
 252   ifeq ($$($1_CC),)
 253     $1_CC:=$(CC)
 254   endif
 255 
 256   # Make sure the dirs exist.
 257   $$(eval $$(call MakeDir,$$($1_OBJECT_DIR) $$($1_OUTPUT_DIR)))
 258   $$(foreach d,$$($1_SRC), $$(if $$(wildcard $$d),,$$(error SRC specified to SetupNativeCompilation $1 contains missing directory $$d)))
 259 
 260   # Find all files in the source trees. Sort to remove duplicates.
 261   $1_ALL_SRCS := $$(sort $$(call CacheFind,$$($1_SRC)))
 262   # Extract the C/C++ files.
 263   $1_EXCLUDE_FILES:=$$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$($1_EXCLUDE_FILES)))
 264   $1_INCLUDE_FILES:=$$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$($1_INCLUDE_FILES)))
 265   ifneq ($$($1_EXCLUDE_FILES),)
 266     $1_EXCLUDE_FILES:=$$(addprefix %,$$($1_EXCLUDE_FILES))
 267   endif
 268   $1_SRCS := $$(filter-out $$($1_EXCLUDE_FILES),$$(filter %.s %.c %.cpp %.m,$$($1_ALL_SRCS)))
 269   ifneq (,$$(strip $$($1_INCLUDE_FILES)))
 270     $1_SRCS := $$(filter $$($1_INCLUDE_FILES),$$($1_SRCS))
 271   endif
 272   ifeq (,$$($1_SRCS))
 273     $$(error No sources found for $1 when looking inside the dirs $$($1_SRC))
 274   endif
 275   # There can be only a single bin dir root, no need to foreach over the roots.
 276   $1_BINS := $$(wildcard $$($1_OBJECT_DIR)/*$(OBJ_SUFFIX))
 277   # Now we have a list of all c/c++ files to compile: $$($1_SRCS)
 278   # and we have a list of all existing object files: $$($1_BINS)
 279 
 280   # Prepend the source/bin path to the filter expressions. Then do the filtering.
 281   ifneq ($$($1_INCLUDES),)
 282     $1_SRC_INCLUDES := $$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$(addsuffix /%,$$($1_INCLUDES))))
 283     $1_SRCS := $$(filter $$($1_SRC_INCLUDES),$$($1_SRCS))
 284   endif
 285   ifneq ($$($1_EXCLUDES),)
 286     $1_SRC_EXCLUDES := $$(foreach i,$$($1_SRC),$$(addprefix $$i/,$$(addsuffix /%,$$($1_EXCLUDES))))
 287     $1_SRCS := $$(filter-out $$($1_SRC_EXCLUDES),$$($1_SRCS))
 288   endif
 289 
 290   # Calculate the expected output from compiling the sources (sort to remove duplicates. Also provides
 291   # a reproducable order on the input files to the linker).
 292   $1_EXPECTED_OBJS:=$$(sort $$(addprefix $$($1_OBJECT_DIR)/,$$(patsubst %.cpp,%$(OBJ_SUFFIX),$$(patsubst %.c,%$(OBJ_SUFFIX),$$(patsubst %.m,%$(OBJ_SUFFIX),$$(patsubst %.s,%$(OBJ_SUFFIX),$$(notdir $$($1_SRCS))))))))
 293   # Are there too many object files on disk? Perhaps because some source file was removed?
 294   $1_SUPERFLOUS_OBJS:=$$(sort $$(filter-out $$($1_EXPECTED_OBJS),$$($1_BINS)))
 295   # Clean out the superfluous object files.
 296   ifneq ($$($1_SUPERFLUOUS_OBJS),)
 297     $$(shell $(RM) -f $$($1_SUPERFLUOUS_OBJS))
 298   endif
 299 
 300   # Pickup extra OPENJDK_TARGET_OS_API, OPENJDK_TARGET_OS, and/or OPENJDK_TARGET_OS plus
 301   # OPENJDK_TARGET_CPU pair dependent variables for CFLAGS.
 302   $1_EXTRA_CFLAGS:=$$($1_CFLAGS_$(OPENJDK_TARGET_OS_API)) $$($1_CFLAGS_$(OPENJDK_TARGET_OS)) \
 303       $$($1_CFLAGS_$(OPENJDK_TARGET_OS)_$(OPENJDK_TARGET_CPU))
 304   ifneq ($(DEBUG_LEVEL),release)
 305     # Pickup extra debug dependent variables for CFLAGS
 306     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_debug)
 307     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_$(OPENJDK_TARGET_OS_API)_debug)
 308     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_$(OPENJDK_TARGET_OS)_debug)
 309     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_$(OPENJDK_TARGET_OS)_$(OPENJDK_TARGET_CPU)_debug)
 310   else
 311     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_release)
 312     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_$(OPENJDK_TARGET_OS_API)_release)
 313     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_$(OPENJDK_TARGET_OS)_release)
 314     $1_EXTRA_CFLAGS+=$$($1_CFLAGS_$(OPENJDK_TARGET_OS)_$(OPENJDK_TARGET_CPU)_release)
 315   endif
 316 
 317   # Pickup extra OPENJDK_TARGET_OS_API and/or OPENJDK_TARGET_OS dependent variables for CXXFLAGS.
 318   $1_EXTRA_CXXFLAGS:=$$($1_CXXFLAGS_$(OPENJDK_TARGET_OS_API)) $$($1_CXXFLAGS_$(OPENJDK_TARGET_OS))
 319   ifneq ($(DEBUG_LEVEL),release)
 320     # Pickup extra debug dependent variables for CXXFLAGS
 321     $1_EXTRA_CXXFLAGS+=$$($1_CXXFLAGS_debug)
 322     $1_EXTRA_CXXFLAGS+=$$($1_CXXFLAGS_$(OPENJDK_TARGET_OS_API)_debug)
 323     $1_EXTRA_CXXFLAGS+=$$($1_CXXFLAGS_$(OPENJDK_TARGET_OS)_debug)
 324   else
 325     $1_EXTRA_CXXFLAGS+=$$($1_CXXFLAGS_release)
 326     $1_EXTRA_CXXFLAGS+=$$($1_CXXFLAGS_$(OPENJDK_TARGET_OS_API)_release)
 327     $1_EXTRA_CXXFLAGS+=$$($1_CXXFLAGS_$(OPENJDK_TARGET_OS)_release)
 328   endif
 329 
 330   ifeq ($$($1_CXXFLAGS),)
 331     $1_CXXFLAGS:=$$($1_CFLAGS)
 332   endif
 333   ifeq ($$(strip $$($1_EXTRA_CXXFLAGS)),)
 334     $1_EXTRA_CXXFLAGS:=$$($1_EXTRA_CFLAGS)
 335   endif
 336 
 337   ifneq (,$$($1_DEBUG_SYMBOLS))
 338     ifeq ($(ENABLE_DEBUG_SYMBOLS), true)
 339       ifdef OPENJDK
 340         # Always add debug symbols
 341         $1_EXTRA_CFLAGS+=$(CFLAGS_DEBUG_SYMBOLS)
 342         $1_EXTRA_CXXFLAGS+=$(CXXFLAGS_DEBUG_SYMBOLS)
 343       else
 344         # Programs don't get the debug symbols added in the old build. It's not clear if
 345         # this is intentional.
 346         ifeq ($$($1_PROGRAM),)
 347           $1_EXTRA_CFLAGS+=$(CFLAGS_DEBUG_SYMBOLS)
 348           $1_EXTRA_CXXFLAGS+=$(CXXFLAGS_DEBUG_SYMBOLS)
 349         endif
 350       endif
 351     endif
 352   endif
 353 
 354   ifneq (,$$($1_REORDER))
 355     $1_EXTRA_CFLAGS += $$(C_FLAG_REORDER)
 356     $1_EXTRA_CXXFLAGS += $$(CXX_FLAG_REORDER)
 357   endif
 358 
 359   ifeq (NONE, $$($1_OPTIMIZATION))
 360     $1_EXTRA_CFLAGS += $(C_O_FLAG_NONE)
 361     $1_EXTRA_CXXFLAGS += $(CXX_O_FLAG_NONE)
 362   else ifeq (LOW, $$($1_OPTIMIZATION))
 363     $1_EXTRA_CFLAGS += $(C_O_FLAG_NORM)
 364     $1_EXTRA_CXXFLAGS += $(CXX_O_FLAG_NORM)
 365   else ifeq (HIGH, $$($1_OPTIMIZATION))
 366     $1_EXTRA_CFLAGS += $(C_O_FLAG_HI)
 367     $1_EXTRA_CXXFLAGS += $(CXX_O_FLAG_HI)
 368   else ifeq (HIGHEST, $$($1_OPTIMIZATION))
 369     $1_EXTRA_CFLAGS += $(C_O_FLAG_HIGHEST)
 370     $1_EXTRA_CXXFLAGS += $(CXX_O_FLAG_HIGHEST)
 371   else ifneq (, $$($1_OPTIMIZATION))
 372     $$(error Unknown value for OPTIMIZATION: $$($1_OPTIMIZATION))
 373   endif
 374 
 375   # Now call add_native_source for each source file we are going to compile.
 376   $$(foreach p,$$($1_SRCS), \
 377       $$(eval $$(call add_native_source,$1,$$p,$$($1_OBJECT_DIR), \
 378           $$($1_CFLAGS) $$($1_EXTRA_CFLAGS),$$($1_CC), \
 379           $$($1_CXXFLAGS) $$($1_EXTRA_CXXFLAGS),$(CXX),$$($1_ASFLAGS))))
 380 
 381   # On windows we need to create a resource file
 382   ifeq ($(OPENJDK_TARGET_OS), windows)
 383     ifneq (,$$($1_VERSIONINFO_RESOURCE))
 384       $1_RES:=$$($1_OBJECT_DIR)/$$($1_BASENAME).res
 385       $$($1_RES): $$($1_VERSIONINFO_RESOURCE)
 386                 $(RC) $$($1_RC_FLAGS) $(CC_OUT_OPTION)$$@ $$($1_VERSIONINFO_RESOURCE)
 387     endif
 388     ifneq (,$$($1_MANIFEST))
 389       $1_GEN_MANIFEST:=$$($1_OBJECT_DIR)/$$($1_PROGRAM).manifest
 390       IMVERSIONVALUE:=$(JDK_MINOR_VERSION).$(JDK_MICRO_VERSION).$(JDK_UPDATE_VERSION).$(COOKED_BUILD_NUMBER)
 391       $$($1_GEN_MANIFEST): $$($1_MANIFEST)
 392                 $(SED) 's%IMVERSION%$$(IMVERSIONVALUE)%g;s%PROGRAM%$$($1_PROGRAM)%g' $$< > $$@
 393     endif
 394   endif
 395 
 396   # mapfile doesnt seem to be implemented on macosx (yet??)
 397   ifneq ($(OPENJDK_TARGET_OS),macosx)
 398     ifneq ($(OPENJDK_TARGET_OS),windows)
 399       $1_REAL_MAPFILE:=$$($1_MAPFILE)
 400       ifneq (,$$($1_REORDER))
 401         $1_REAL_MAPFILE:=$$($1_OBJECT_DIR)/mapfile
 402 
 403         $$($1_REAL_MAPFILE) : $$($1_MAPFILE) $$($1_REORDER)
 404                 $$(MKDIR) -p $$(@D)
 405                 $$(CP) $$($1_MAPFILE) $$@.tmp
 406                 $$(SED) -e 's=OUTPUTDIR=$$($1_OBJECT_DIR)=' $$($1_REORDER) >> $$@.tmp
 407                 $$(MV) $$@.tmp $$@
 408       endif
 409     endif
 410   endif
 411 
 412   # Pickup extra OPENJDK_TARGET_OS_API and/or OPENJDK_TARGET_OS dependent variables
 413   # for LDFLAGS and LDFLAGS_SUFFIX
 414   $1_EXTRA_LDFLAGS:=$$($1_LDFLAGS_$(OPENJDK_TARGET_OS_API)) $$($1_LDFLAGS_$(OPENJDK_TARGET_OS))
 415   $1_EXTRA_LDFLAGS_SUFFIX:=$$($1_LDFLAGS_SUFFIX_$(OPENJDK_TARGET_OS_API)) $$($1_LDFLAGS_SUFFIX_$(OPENJDK_TARGET_OS))
 416   ifneq (,$$($1_REAL_MAPFILE))
 417     $1_EXTRA_LDFLAGS += $(call SET_SHARED_LIBRARY_MAPFILE,$$($1_REAL_MAPFILE))
 418   endif
 419 
 420   $1 := $$($1_TARGET)
 421   ifneq (,$$($1_LIBRARY))
 422     # Generating a dynamic library.
 423     $1_EXTRA_LDFLAGS+=$$(call SET_SHARED_LIBRARY_NAME,$$($1_BASENAME))
 424     ifeq ($(OPENJDK_TARGET_OS), windows)
 425       $1_EXTRA_LDFLAGS+="-implib:$$($1_OBJECT_DIR)/$$($1_LIBRARY).lib"
 426     endif
 427 
 428     $1_EXTRA_LDFLAGS_SUFFIX += $(GLOBAL_LDFLAGS_SUFFIX)
 429 
 430     ifneq (,$$($1_DEBUG_SYMBOLS))
 431       ifeq ($(ENABLE_DEBUG_SYMBOLS), true)
 432         ifeq ($(OPENJDK_TARGET_OS), windows)
 433           $1_EXTRA_LDFLAGS+="-pdb:$$($1_OBJECT_DIR)/$$($1_LIBRARY).pdb" \
 434               "-map:$$($1_OBJECT_DIR)/$$($1_LIBRARY).map"
 435         endif
 436 
 437         ifneq ($$($1_OUTPUT_DIR),$$($1_OBJECT_DIR))
 438           $$($1_OUTPUT_DIR)/% : $$($1_OBJECT_DIR)/%
 439                 $(CP) $$< $$@
 440         endif
 441 
 442         ifneq ($(OPENJDK_TARGET_OS), macosx)   # OBJCOPY is not used on MacOS X
 443           ifneq ($(OPENJDK_TARGET_OS), windows)  # nor on Windows
 444             ifeq ($(OPENJDK_TARGET_OS), solaris)
 445               # gobjcopy crashes on "empty" section headers with the SHF_ALLOC flag set.
 446               # Use $(FIX_EMPTY_SEC_HDR_FLAGS) to clear the SHF_ALLOC flag (if set) from
 447               # empty section headers until a fixed $(OBJCOPY) is available.
 448               # An empty section header has sh_addr == 0 and sh_size == 0.
 449               # This problem has only been seen on Solaris X64, but we call this tool
 450               # on all Solaris builds just in case.
 451               #
 452               # $(OBJCOPY) --add-gnu-debuglink=... corrupts SUNW_* sections.
 453               # Use $(ADD_GNU_DEBUGLINK) until a fixed $(OBJCOPY) is available.
 454               $$($1_OBJECT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).debuginfo : $$($1_TARGET) \
 455                                 $(FIX_EMPTY_SEC_HDR_FLAGS) $(ADD_GNU_DEBUGLINK)
 456                 $(RM) $$@
 457                 $(FIX_EMPTY_SEC_HDR_FLAGS) $(LOG_INFO) $$<
 458                 $(OBJCOPY) --only-keep-debug $$< $$@
 459                 $(CD) $$(@D) && $(ADD_GNU_DEBUGLINK) $(LOG_INFO) $$(@F) $$<
 460             else # not solaris
 461               $$($1_OBJECT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).debuginfo : $$($1_TARGET)
 462                 $(RM) $$@
 463                 $(OBJCOPY) --only-keep-debug $$< $$@
 464                 $(CD) $$(@D) && $(OBJCOPY) --add-gnu-debuglink=$$(@F) $$<
 465             endif # Touch to not retrigger rule on rebuild
 466                 $(TOUCH) $$@
 467           endif # !windows
 468         endif # !macosx
 469 
 470         ifeq ($(ZIP_DEBUGINFO_FILES), true)
 471 ifneq ($(OPENJDK_TARGET_OS), macosx) # no MacOS X support yet
 472           $1 += $$($1_OUTPUT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).diz
 473 
 474           ifeq ($(OPENJDK_TARGET_OS), windows)
 475             $$($1_OBJECT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).diz : $$($1_TARGET)
 476                 $(CD) $$($1_OBJECT_DIR) \
 477                 && $(ZIP) -q $$@ $$($1_LIBRARY).map $$($1_LIBRARY).pdb
 478           else
 479             $$($1_OBJECT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).diz : $$($1_TARGET) \
 480                 $$($1_OBJECT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).debuginfo
 481                 $(CD) $$($1_OBJECT_DIR) \
 482                 && $(ZIP) -q $$@ $$(LIBRARY_PREFIX)$$($1_LIBRARY).debuginfo
 483           endif
 484 endif # no MacOS X support yet
 485         else
 486           ifeq ($(OPENJDK_TARGET_OS), windows)
 487             $1 += $$($1_OUTPUT_DIR)/$$($1_LIBRARY).map \
 488                 $$($1_OUTPUT_DIR)/$$($1_LIBRARY).pdb
 489           else ifneq ($(OPENJDK_TARGET_OS), macosx) # MacOS X does not use .debuginfo files
 490             $1 += $$($1_OUTPUT_DIR)/$$(LIBRARY_PREFIX)$$($1_LIBRARY).debuginfo
 491           endif
 492         endif
 493       endif
 494     endif
 495 
 496     $$($1_TARGET) : $$($1_EXPECTED_OBJS) $$($1_RES) $$($1_REAL_MAPFILE)
 497         $$(call LINKING_MSG,$$($1_BASENAME))
 498         $$($1_LD) $$($1_LDFLAGS) $$($1_EXTRA_LDFLAGS) $(LD_OUT_OPTION)$$@ \
 499         $$($1_EXPECTED_OBJS) $$($1_RES) $$($1_LDFLAGS_SUFFIX) \
 500         $$($1_EXTRA_LDFLAGS_SUFFIX)
 501 
 502   endif
 503 
 504   ifneq (,$$($1_STATIC_LIBRARY))
 505     # Generating a static library, ie object file archive.
 506     $$($1_TARGET) : $$($1_EXPECTED_OBJS) $$($1_RES)
 507         $$(call ARCHIVING_MSG,$$($1_LIBRARY))
 508         $(AR) $$($1_ARFLAGS) $(AR_OUT_OPTION)$$($1_TARGET) $$($1_EXPECTED_OBJS) \
 509             $$($1_RES) $$($1_LDFLAGS_SUFFIX) $$($1_EXTRA_LDFLAGS_SUFFIX)
 510   endif
 511 
 512   ifneq (,$$($1_PROGRAM))
 513     # A executable binary has been specified, setup the target for it.
 514     ifneq (,$$($1_DEBUG_SYMBOLS))
 515       ifeq ($(ENABLE_DEBUG_SYMBOLS), true)
 516         ifeq ($(OPENJDK_TARGET_OS), windows)
 517           $1_EXTRA_LDFLAGS+="-pdb:$$($1_OBJECT_DIR)/$$($1_PROGRAM).pdb" \
 518               "-map:$$($1_OBJECT_DIR)/$$($1_PROGRAM).map"
 519         endif
 520 
 521         ifneq ($$($1_OUTPUT_DIR),$$($1_OBJECT_DIR))
 522           $$($1_OUTPUT_DIR)/% : $$($1_OBJECT_DIR)/%
 523                 $(CP) $$< $$@
 524         endif
 525 
 526         ifneq ($(OPENJDK_TARGET_OS), macosx)   # OBJCOPY is not used on MacOS X
 527           ifneq ($(OPENJDK_TARGET_OS), windows)  # nor on Windows
 528             ifeq ($(OPENJDK_TARGET_OS), solaris)
 529               # gobjcopy crashes on "empty" section headers with the SHF_ALLOC flag set.
 530               # Use $(FIX_EMPTY_SEC_HDR_FLAGS) to clear the SHF_ALLOC flag (if set) from
 531               # empty section headers until a fixed $(OBJCOPY) is available.
 532               # An empty section header has sh_addr == 0 and sh_size == 0.
 533               # This problem has only been seen on Solaris X64, but we call this tool
 534               # on all Solaris builds just in case.
 535               #
 536               # $(OBJCOPY) --add-gnu-debuglink=... corrupts SUNW_* sections.
 537               # Use $(ADD_GNU_DEBUGLINK) until a fixed $(OBJCOPY) is available.
 538               $$($1_OBJECT_DIR)/$$($1_PROGRAM).debuginfo : $$($1_TARGET) \
 539                                 $(FIX_EMPTY_SEC_HDR_FLAGS) $(ADD_GNU_DEBUGLINK)
 540                 $(RM) $$@
 541                 $(FIX_EMPTY_SEC_HDR_FLAGS) $(LOG_INFO) $$<
 542                 $(OBJCOPY) --only-keep-debug $$< $$@
 543                 $(CD) $$(@D) && $(ADD_GNU_DEBUGLINK) $(LOG_INFO) $$(@F) $$<
 544             else # not solaris
 545               $$($1_OBJECT_DIR)/$$($1_PROGRAM).debuginfo : $$($1_TARGET)
 546                 $(RM) $$@
 547                 $(OBJCOPY) --only-keep-debug $$< $$@
 548                 $(CD) $$(@D) && $(OBJCOPY) --add-gnu-debuglink=$$(@F) $$<
 549             endif
 550                 $(TOUCH) $$@
 551           endif # !windows
 552         endif # !macosx
 553 
 554         ifeq ($(ZIP_DEBUGINFO_FILES), true)
 555 ifneq ($(OPENJDK_TARGET_OS), macosx) # no MacOS X support yet
 556           $1 += $$($1_OUTPUT_DIR)/$$($1_PROGRAM).diz
 557 
 558           ifeq ($(OPENJDK_TARGET_OS), windows)
 559             $$($1_OBJECT_DIR)/$$($1_PROGRAM).diz : $$($1_TARGET)
 560                 $(CD) $$($1_OBJECT_DIR) \
 561                 && $(ZIP) -q $$@ $$($1_PROGRAM).map $$($1_PROGRAM).pdb
 562           else
 563             $$($1_OBJECT_DIR)/$$(PROGRAM_PREFIX)$$($1_PROGRAM).diz : $$($1_TARGET) \
 564                 $$($1_OBJECT_DIR)/$$($1_PROGRAM).debuginfo
 565                 $(CD) $$($1_OBJECT_DIR) \
 566                 && $(ZIP) -q $$@ $$($1_PROGRAM).debuginfo
 567           endif
 568 endif # no MacOS X support yet
 569         else
 570           ifeq ($(OPENJDK_TARGET_OS), windows)
 571             $1 += $$($1_OUTPUT_DIR)/$$($1_PROGRAM).map \
 572                 $$($1_OUTPUT_DIR)/$$($1_PROGRAM).pdb
 573           else ifneq ($(OPENJDK_TARGET_OS), macosx) # MacOS X does not use .debuginfo files
 574             $1 += $$($1_OUTPUT_DIR)/$$($1_PROGRAM).debuginfo
 575           endif
 576         endif
 577       endif
 578     endif
 579 
 580     $1_EXTRA_LDFLAGS_SUFFIX += $(GLOBAL_LDFLAGS_SUFFIX)
 581 
 582     $$($1_TARGET) : $$($1_EXPECTED_OBJS) $$($1_RES) $$($1_GEN_MANIFEST)
 583         $$(call LINKING_EXE_MSG,$$($1_BASENAME))
 584         $$($1_LDEXE) $$($1_LDFLAGS) $$($1_EXTRA_LDFLAGS) $(EXE_OUT_OPTION)$$($1_TARGET) \
 585         $$($1_EXPECTED_OBJS) $$($1_RES) $$($1_LDFLAGS_SUFFIX) \
 586         $$($1_EXTRA_LDFLAGS_SUFFIX)
 587         ifneq (,$$($1_GEN_MANIFEST))
 588           $(MT) -nologo -manifest $$($1_GEN_MANIFEST) -outputresource:$$@;#1
 589         endif
 590         # This only works if the openjdk_codesign identity is present on the system. Let
 591         # silently fail otherwise.
 592         ifneq (,$(CODESIGN))
 593           ifneq (,$$($1_CODESIGN))
 594             $(CODESIGN) -s openjdk_codesign $$@
 595           endif
 596         endif
 597   endif
 598 endef