makedefs/MakeInc.cmd

   1 # -*- mode: makefile;-*-
   2 #
   3 # Copyright (C) 1999-2016 Apple Inc. All rights reserved.
   4 #
   5 # MakeInc.cmd contains command paths for use during
   6 # the build, as well as make fragments and text
   7 # strings that may be evaluated as utility functions.
   8 #
   9
  10 #
  11 # Commands for the build environment
  12 #
  13 ##
  14 # Verbosity
  15 ##
  16 ifeq ($(RC_XBS),YES)
  17 VERBOSE = YES
  18 else
  19 VERBOSE = NO
  20 endif
  21 ifeq ($(VERBOSE),YES)
  22 _v =
  23 _vstdout =
  24 else
  25 _v = @
  26 _vstdout = > /dev/null
  27 endif
  28
  29 VERBOSE_GENERATED_MAKE_FRAGMENTS = NO
  30
  31 ifeq ($(VERBOSE),YES)
  32         XCRUN = /usr/bin/xcrun -verbose
  33 else
  34         XCRUN = /usr/bin/xcrun
  35 endif
  36
  37 SDKROOT ?= macosx
  38 HOST_SDKROOT ?= macosx
  39
  40 # SDKROOT may be passed as a shorthand like "iphoneos.internal". We
  41 # must resolve these to a full path and override SDKROOT.
  42
  43 ifeq ($(SDKROOT_RESOLVED),)
  44 export SDKROOT_RESOLVED := $(shell $(XCRUN) -sdk $(SDKROOT) -show-sdk-path)
  45 ifeq ($(strip $(SDKROOT)_$(SDKROOT_RESOLVED)),/_)
  46 export SDKROOT_RESOLVED := /
  47 endif
  48 endif
  49 override SDKROOT = $(SDKROOT_RESOLVED)
  50
  51 ifeq ($(HOST_SDKROOT_RESOLVED),)
  52 export HOST_SDKROOT_RESOLVED := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -show-sdk-path)
  53 ifeq ($(strip $(HOST_SDKROOT_RESOLVED)),)
  54 export HOST_SDKROOT_RESOLVED := /
  55 endif
  56 endif
  57 override HOST_SDKROOT = $(HOST_SDKROOT_RESOLVED)
  58
  59 ifeq ($(PLATFORM),)
  60         export PLATFORMPATH := $(shell $(XCRUN) -sdk $(SDKROOT) -show-sdk-platform-path)
  61         export PLATFORM := $(shell echo $(PLATFORMPATH) | sed 's,^.*/\([^/]*\)\.platform$$,\1,')
  62         ifeq ($(PLATFORM),)
  63                 export PLATFORM := MacOSX
  64         else ifeq ($(shell echo $(PLATFORM) | tr A-Z a-z),watchos)
  65                 export PLATFORM := WatchOS
  66         endif
  67 endif
  68
  69 ifeq ($(SDKVERSION),)
  70      export SDKVERSION := $(shell $(XCRUN) -sdk $(SDKROOT) -show-sdk-version)
  71 endif
  72
  73 # CC/CXX get defined by make(1) by default, so we can't check them
  74 # against the empty string to see if they haven't been set
  75 ifeq ($(origin CC),default)
  76         export CC := $(shell $(XCRUN) -sdk $(SDKROOT) -find clang)
  77 endif
  78 ifeq ($(origin CXX),default)
  79         export CXX := $(shell $(XCRUN) -sdk $(SDKROOT) -find clang++)
  80 endif
  81 ifeq ($(MIG),)
  82         export MIG := $(shell $(XCRUN) -sdk $(SDKROOT) -find mig)
  83 endif
  84 ifeq ($(MIGCOM),)
  85         export MIGCOM := $(shell $(XCRUN) -sdk $(SDKROOT) -find migcom)
  86 endif
  87 ifeq ($(MIGCC),)
  88         export MIGCC := $(CC)
  89 endif
  90 ifeq ($(STRIP),)
  91         export STRIP := $(shell $(XCRUN) -sdk $(SDKROOT) -find strip)
  92 endif
  93 ifeq ($(LIPO),)
  94         export LIPO := $(shell $(XCRUN) -sdk $(SDKROOT) -find lipo)
  95 endif
  96 ifeq ($(LIBTOOL),)
  97         export LIBTOOL := $(shell $(XCRUN) -sdk $(SDKROOT) -find libtool)
  98 endif
  99 ifeq ($(NM),)
 100         export NM := $(shell $(XCRUN) -sdk $(SDKROOT) -find nm)
 101 endif
 102 ifeq ($(UNIFDEF),)
 103         export UNIFDEF := $(shell $(XCRUN) -sdk $(SDKROOT) -find unifdef)
 104 endif
 105 ifeq ($(DSYMUTIL),)
 106         export DSYMUTIL := $(shell $(XCRUN) -sdk $(SDKROOT) -find dsymutil)
 107 endif
 108 ifeq ($(CTFCONVERT),)
 109         export CTFCONVERT := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctfconvert)
 110 endif
 111 ifeq ($(CTFMERGE),)
 112         export CTFMERGE :=  $(shell $(XCRUN) -sdk $(SDKROOT) -find ctfmerge)
 113 endif
 114 ifeq ($(CTFINSERT),)
 115         export CTFINSERT := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctf_insert)
 116 endif
 117 ifeq ($(NMEDIT),)
 118         export NMEDIT := $(shell $(XCRUN) -sdk $(SDKROOT) -find nmedit)
 119 endif
 120
 121 #
 122 # Platform options
 123 #
 124 SUPPORTED_EMBEDDED_PLATFORMS := iPhoneOS iPhoneOSNano tvOS AppleTVOS WatchOS BridgeOS
 125 SUPPORTED_SIMULATOR_PLATFORMS := iPhoneSimulator iPhoneNanoSimulator tvSimulator AppleTVSimulator WatchSimulator
 126 SUPPORTED_PLATFORMS := MacOSX $(SUPPORTED_SIMULATOR_PLATFORMS) $(SUPPORTED_EMBEDDED_PLATFORMS)
 127
 128 # Platform-specific tools
 129 ifneq ($(filter $(SUPPORTED_EMBEDDED_PLATFORMS),$(PLATFORM)),)
 130 ifeq ($(EMBEDDED_DEVICE_MAP),)
 131         export EMBEDDED_DEVICE_MAP := $(shell $(XCRUN) -sdk $(SDKROOT) -find embedded_device_map)
 132 endif
 133 EDM_DBPATH ?= $(PLATFORMPATH)/usr/local/standalone/firmware/device_map.db
 134 endif
 135
 136 # Scripts or tools we build ourselves
 137 #
 138 # setsegname - Rename segments in a Mach-O object file
 139 # kextsymboltool - Create kext pseudo-kext Mach-O kexts binaries
 140 # decomment - Strip out comments to detect whether a file is comments-only
 141 # installfile - Atomically copy files, esp. when multiple architectures
 142 #               are trying to install the same target header
 143 # replacecontents - Write contents to a file and update modtime *only* if
 144 #               contents differ
 145 #
 146 SEG_HACK = $(OBJROOT)/SETUP/setsegname/setsegname
 147 KEXT_CREATE_SYMBOL_SET = $(OBJROOT)/SETUP/kextsymboltool/kextsymboltool
 148 DECOMMENT = $(OBJROOT)/SETUP/decomment/decomment
 149 NEWVERS = $(SRCROOT)/config/newvers.pl
 150 INSTALL = $(OBJROOT)/SETUP/installfile/installfile
 151 REPLACECONTENTS = $(OBJROOT)/SETUP/replacecontents/replacecontents
 152 JSONCOMPILATIONDB = $(OBJROOT)/SETUP/json_compilation_db/json_compilation_db
 153
 154 # Standard BSD tools
 155 RM = /bin/rm -f
 156 RMDIR = /bin/rmdir
 157 CP = /bin/cp
 158 MV = /bin/mv
 159 LN = /bin/ln -fs
 160 CAT = /bin/cat
 161 MKDIR = /bin/mkdir -p
 162 CHMOD = /bin/chmod
 163 FIND = /usr/bin/find
 164 XARGS = /usr/bin/xargs
 165 PAX = /bin/pax
 166 BASENAME = /usr/bin/basename
 167 DIRNAME = /usr/bin/dirname
 168 TR = /usr/bin/tr
 169 TOUCH = /usr/bin/touch
 170 SLEEP = /bin/sleep
 171 AWK = /usr/bin/awk
 172 SED = /usr/bin/sed
 173 ECHO = /bin/echo
 174 PLUTIL = /usr/bin/plutil
 175
 176 #
 177 # Command to generate host binaries. Intentionally not
 178 # $(CC), which controls the target compiler
 179 #
 180 ifeq ($(HOST_OS_VERSION),)
 181         export HOST_OS_VERSION  := $(shell sw_vers -productVersion)
 182 endif
 183 ifeq ($(HOST_CC),)
 184         export HOST_CC          := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find clang)
 185 endif
 186 ifeq ($(HOST_FLEX),)
 187         export HOST_FLEX        := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find flex)
 188 endif
 189 ifeq ($(HOST_BISON),)
 190         export HOST_BISON       := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find bison)
 191 endif
 192 ifeq ($(HOST_GM4),)
 193         export HOST_GM4         := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find gm4)
 194 endif
 195 ifeq ($(HOST_CODESIGN),)
 196         export HOST_CODESIGN    := /usr/bin/codesign
 197 endif
 198 ifeq ($(HOST_CODESIGN_ALLOCATE),)
 199         export HOST_CODESIGN_ALLOCATE   := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find codesign_allocate)
 200 endif
 201
 202 #
 203 # The following variables are functions invoked with "call", and thus
 204 # behave similarly to externally compiled commands
 205 #
 206
 207 # $(1) is an expanded kernel config from a TARGET_CONFIGS_UC tuple
 208 # $(2) is an expanded arch config from a TARGET_CONFIGS_UC tuple
 209 # $(3) is an expanded machine config from a TARGET_CONFIGS_UC tuple
 210 _function_create_build_configs_join = $(strip $(1))^$(strip $(2))^$(strip $(3))
 211
 212 # $(1) is an un-expanded kernel config from a TARGET_CONFIGS_UC tuple
 213 # $(2) is an un-expanded arch config from a TARGET_CONFIGS_UC tuple
 214 # $(3) is an un-expanded machine config from a TARGET_CONFIGS_UC tuple
 215 _function_create_build_configs_do_expand =          $(call _function_create_build_configs_join, \
 216                                                            $(if $(filter DEFAULT,$(1)), \
 217                                                                 $(DEFAULT_KERNEL_CONFIG), \
 218                                                                 $(1) \
 219                                                             ), \
 220                                                            $(if $(filter DEFAULT,$(2)), \
 221                                                                 $(DEFAULT_ARCH_CONFIG), \
 222                                                                 $(2) \
 223                                                             ), \
 224                                                            $(if $(filter DEFAULT,$(3)), \
 225                                                                 $(if $(filter DEFAULT,$(2)), \
 226                                                                      $(DEFAULT_$(DEFAULT_ARCH_CONFIG)_MACHINE_CONFIG), \
 227                                                                      $(DEFAULT_$(strip $(2))_MACHINE_CONFIG) \
 228                                                                 ), \
 229                                                                 $(3) \
 230                                                             ) \
 231                                                      )
 232
 233 # $(1) is an un-expanded TARGET_CONFIGS_UC list, which must be consumed
 234 #      3 elements at a time
 235 function_create_build_configs = $(sort \
 236                                         $(strip \
 237                                                  $(call _function_create_build_configs_do_expand, \
 238                                                         $(word 1,$(1)), \
 239                                                         $(word 2,$(1)), \
 240                                                         $(word 3,$(1)), \
 241                                                   ) \
 242                                                  $(if $(word 4,$(1)), \
 243                                                       $(call function_create_build_configs, \
 244                                                              $(wordlist 4,$(words $(1)),$(1)) \
 245                                                        ), \
 246                                                   ) \
 247                                           ) \
 248                                    )
 249
 250 # Similar to build configs, but alias configs are a 4-tuple
 251
 252 # $(1) is an expanded kernel config from a TARGET_CONFIGS_ALIASES_UC tuple
 253 # $(2) is an expanded arch config from a TARGET_CONFIGS_ALIASES_UC tuple
 254 # $(3) is an expanded kernel machine config from a TARGET_CONFIGS_ALIASES_UC tuple
 255 # $(4) is an expanded SoC platform config from a TARGET_CONFIGS_ALIASES_UC tuple,
 256 #      which should be an alias of $(3)
 257 _function_create_alias_configs_join = $(strip $(1))^$(strip $(2))^$(strip $(3))^$(strip $(4))
 258
 259 _function_create_alias_configs_do_expand =          $(call _function_create_alias_configs_join, \
 260                                                            $(if $(filter DEFAULT,$(1)), \
 261                                                                 $(DEFAULT_KERNEL_CONFIG), \
 262                                                                 $(1) \
 263                                                             ), \
 264                                                            $(if $(filter DEFAULT,$(2)), \
 265                                                                 $(DEFAULT_ARCH_CONFIG), \
 266                                                                 $(2) \
 267                                                             ), \
 268                                                            $(3), \
 269                                                            $(4) \
 270                                                      )
 271
 272 function_create_alias_configs = $(sort \
 273                                         $(strip \
 274                                                  $(call _function_create_alias_configs_do_expand, \
 275                                                         $(word 1,$(1)), \
 276                                                         $(word 2,$(1)), \
 277                                                         $(word 3,$(1)), \
 278                                                         $(word 4,$(1)), \
 279                                                   ) \
 280                                                  $(if $(word 5,$(1)), \
 281                                                       $(call function_create_alias_configs, \
 282                                                              $(wordlist 5,$(words $(1)),$(1)) \
 283                                                        ), \
 284                                                   ) \
 285                                          ) \
 286                                  )
 287
 288 # $(1) is a fully-expanded kernel config
 289 # $(2) is a fully-expanded arch config
 290 # $(3) is a fully-expanded machine config. "NONE" is not represented in the objdir path
 291 function_convert_target_config_uc_to_objdir = $(if $(filter NONE,$(3)),$(strip $(1))_$(strip $(2)),$(strip $(1))_$(strip $(2))_$(strip $(3)))
 292
 293 # $(1) is a fully-expanded build config (like "RELEASE^X86_64^NONE")
 294 function_convert_build_config_to_objdir = $(call function_convert_target_config_uc_to_objdir, \
 295                                                  $(word 1,$(subst ^, ,$(1))), \
 296                                                  $(word 2,$(subst ^, ,$(1))), \
 297                                                  $(word 3,$(subst ^, ,$(1))) \
 298                                            )
 299
 300 # $(1) is a fully-expanded build config (like "RELEASE^X86_64^NONE")
 301 function_extract_kernel_config_from_build_config  = $(word 1,$(subst ^, ,$(1)))
 302 function_extract_arch_config_from_build_config    = $(word 2,$(subst ^, ,$(1)))
 303 function_extract_machine_config_from_build_config = $(word 3,$(subst ^, ,$(1)))
 304
 305 # $(1) is an input word
 306 # $(2) is a list of colon-separate potential substitutions like "FOO:BAR BAZ:QUX"
 307 # $(3) is a fallback if no substitutions were made
 308 function_substitute_word_with_replacement = $(strip $(if $(2),                                                          \
 309                                                          $(if $(filter $(word 1,$(subst :, ,$(word 1,$(2)))),$(1)),     \
 310                                                               $(word 2,$(subst :, ,$(word 1,$(2)))),            \
 311                                                               $(call function_substitute_word_with_replacement,$(1),$(wordlist 2,$(words $(2)),$(2)),$(3))), \
 312                                                          $(3)                                                           \
 313                                                      )                                                                  \
 314                                              )
 315
 316 # You can't assign a variable to an empty space without these
 317 # shenanigans
 318 empty :=
 319 space := $(empty) $(empty)
 320
 321 # Arithmetic
 322 # $(1) is the number to increment
 323 NUM32 = x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
 324 increment = $(words x $(wordlist 1,$(1),$(NUM32)))
 325 decrement = $(words $(wordlist 2,$(1),$(NUM32)))
 326
 327 # Create a sequence from 1 to $(1)
 328 # F(N) = if N > 0: return F(N-1) + "N" else: return ""
 329 sequence = $(if $(wordlist 1,$(1),$(NUM32)),$(call sequence,$(call decrement,$(1))) $(1),)
 330
 331 # Reverse a list of words in $(1)
 332 reverse = $(if $(word 2,$(1)),$(call reverse,$(wordlist 2,$(words $(1)),$(1)))) $(word 1,$(1))
 333
 334 # vim: set ft=make: