]> git.saurik.com Git - apple/xnu.git/blobdiff - makedefs/MakeInc.cmd
xnu-6153.121.1.tar.gz
[apple/xnu.git] / makedefs / MakeInc.cmd
index 5fea21d308e697c3a1df5fff029f244ecc5287eb..0c8420d13b839aeecfe77d222ac1ed3a6e42aeaf 100644 (file)
+# -*- mode: makefile;-*-
+#
+# Copyright (C) 1999-2016 Apple Inc. All rights reserved.
+#
+# MakeInc.cmd contains command paths for use during
+# the build, as well as make fragments and text
+# strings that may be evaluated as utility functions.
+#
+
 #
 # Commands for the build environment
 #
+
 ##
 # Verbosity
 ##
+
 ifeq ($(RC_XBS),YES)
-VERBOSE = YES
+       VERBOSE = YES
 else
-VERBOSE = NO
+       VERBOSE = NO
 endif
-ifeq ($(VERBOSE),YES)
-_v =
-_vstdout =
-else
-_v = @
-_vstdout = > /dev/null
+
+ECHO = echo
+
+LOG = echo
+makelog = $(info $1)
+ERR = $(ECHO) > /dev/stderr
+
+QUIET ?= 0
+ifneq ($(QUIET),0)
+       LOG = :
+       makelog =
+       ifeq ($(VERBOSE),YES)
+               override VERBOSE = NO
+       endif
 endif
 
 ifeq ($(VERBOSE),YES)
-       XCRUN = /usr/bin/xcrun -verbose -log
+       _v =
+       _vstdout =
+       XCRUN = /usr/bin/xcrun -verbose
 else
+       _v = @
+       _vstdout = > /dev/null
        XCRUN = /usr/bin/xcrun
 endif
 
-SDKROOT ?= /
-HOST_SDKROOT ?= /
+VERBOSE_GENERATED_MAKE_FRAGMENTS = NO
+
+SDKROOT ?= macosx
+HOST_SDKROOT ?= macosx
+
+# SDKROOT may be passed as a shorthand like "iphoneos.internal". We
+# must resolve these to a full path and override SDKROOT.
+
+ifeq ($(SDKROOT_RESOLVED),)
+export SDKROOT_RESOLVED := $(shell $(XCRUN) -sdk $(SDKROOT) -show-sdk-path)
+ifeq ($(strip $(SDKROOT)_$(SDKROOT_RESOLVED)),/_)
+export SDKROOT_RESOLVED := /
+endif
+endif
+override SDKROOT = $(SDKROOT_RESOLVED)
+
+ifeq ($(HOST_SDKROOT_RESOLVED),)
+export HOST_SDKROOT_RESOLVED := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -show-sdk-path)
+ifeq ($(strip $(HOST_SDKROOT_RESOLVED)),)
+export HOST_SDKROOT_RESOLVED := /
+endif
+endif
+override HOST_SDKROOT = $(HOST_SDKROOT_RESOLVED)
 
 ifeq ($(PLATFORM),)
-       export PLATFORM := $(shell xcodebuild -sdk $(SDKROOT) -version PlatformPath | head -1 | sed 's,^.*/\([^/]*\)\.platform$$,\1,')
+       export PLATFORMPATH := $(shell $(XCRUN) -sdk $(SDKROOT) -show-sdk-platform-path)
+       export PLATFORM := $(shell echo $(PLATFORMPATH) | sed 's,^.*/\([^/]*\)\.platform$$,\1,')
        ifeq ($(PLATFORM),)
                export PLATFORM := MacOSX
+       else ifeq ($(shell echo $(PLATFORM) | tr A-Z a-z),watchos)
+               export PLATFORM := WatchOS
+       endif
+endif
+
+ifeq ($(PLATFORM),MacOSX)
+       ifeq (DriverKit,$(shell echo $(SDKROOT_RESOLVED) | sed 's,^.*/\([^/1-9]*\)[1-9][^/]*\.sdk$$,\1,'))
+               export PLATFORM := DriverKit
+               export DRIVERKIT ?= 1
+               export DRIVERKITROOT ?= /System/DriverKit
+               export DRIVERKITRUNTIMEROOT = $(DRIVERKITROOT)/Runtime
        endif
 endif
 
+ifeq ($(SDKVERSION),)
+     export SDKVERSION := $(shell $(XCRUN) -sdk $(SDKROOT) -show-sdk-version)
+endif
+
 # CC/CXX get defined by make(1) by default, so we can't check them
 # against the empty string to see if they haven't been set
 ifeq ($(origin CC),default)
-ifneq ($(findstring iPhone,$(PLATFORM)),)
-       export CC := $(shell $(XCRUN) -sdk $(SDKROOT) -find gcc-4.2)
-else
-       export CC := $(shell $(XCRUN) -sdk $(SDKROOT) -find cc)
-endif
+       export CC := $(shell $(XCRUN) -sdk $(SDKROOT) -find clang)
 endif
 ifeq ($(origin CXX),default)
-ifneq ($(findstring iPhone,$(PLATFORM)),)
-       export CXX := $(shell $(XCRUN) -sdk $(SDKROOT) -find g++-4.2)
-else
-       export CXX := $(shell $(XCRUN) -sdk $(SDKROOT) -find c++)
-endif
+       export CXX := $(shell $(XCRUN) -sdk $(SDKROOT) -find clang++)
 endif
 ifeq ($(MIG),)
        export MIG := $(shell $(XCRUN) -sdk $(SDKROOT) -find mig)
 endif
+ifeq ($(MIGCOM),)
+       export MIGCOM := $(shell $(XCRUN) -sdk $(SDKROOT) -find migcom)
+endif
 ifeq ($(MIGCC),)
        export MIGCC := $(CC)
 endif
-ifeq ($(RELPATH),)
-       export RELPATH := $(shell $(XCRUN) -sdk $(SDKROOT) -find relpath)
+ifeq ($(IIG),)
+       export IIG := $(shell $(XCRUN) -sdk $(SDKROOT) -find iig)
 endif
 ifeq ($(STRIP),)
        export STRIP := $(shell $(XCRUN) -sdk $(SDKROOT) -find strip)
@@ -73,9 +128,6 @@ endif
 ifeq ($(UNIFDEF),)
        export UNIFDEF := $(shell $(XCRUN) -sdk $(SDKROOT) -find unifdef)
 endif
-ifeq ($(DECOMMENT),)
-       export DECOMMENT := $(shell $(XCRUN) -sdk $(SDKROOT) -find decomment)
-endif
 ifeq ($(DSYMUTIL),)
        export DSYMUTIL := $(shell $(XCRUN) -sdk $(SDKROOT) -find dsymutil)
 endif
@@ -85,54 +137,76 @@ endif
 ifeq ($(CTFMERGE),)
        export CTFMERGE :=  $(shell $(XCRUN) -sdk $(SDKROOT) -find ctfmerge)
 endif
-ifeq ($(CTFSCRUB),)
-       export CTFSCRUB := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctfdump) -r
+ifeq ($(CTFINSERT),)
+       export CTFINSERT := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctf_insert)
 endif
 ifeq ($(NMEDIT),)
        export NMEDIT := $(shell $(XCRUN) -sdk $(SDKROOT) -find nmedit)
 endif
 
+#
+# Platform options
+#
+SUPPORTED_EMBEDDED_PLATFORMS := iPhoneOS iPhoneOSNano tvOS AppleTVOS WatchOS BridgeOS
+SUPPORTED_SIMULATOR_PLATFORMS := iPhoneSimulator iPhoneNanoSimulator tvSimulator AppleTVSimulator WatchSimulator
+SUPPORTED_PLATFORMS := MacOSX DriverKit $(SUPPORTED_SIMULATOR_PLATFORMS) $(SUPPORTED_EMBEDDED_PLATFORMS)
+
 # Platform-specific tools
-ifneq ($(findstring iPhone,$(PRODUCT)),)
-ifeq ($(IPHONEOS_OPTIMIZE),)
-       export IPHONEOS_OPTIMIZE := $(shell $(XCRUN) -sdk $(SDKROOT) -find iphoneos-optimize)
+ifneq ($(filter $(SUPPORTED_EMBEDDED_PLATFORMS),$(PLATFORM)),)
+ifeq ($(EMBEDDED_DEVICE_MAP),)
+       export EMBEDDED_DEVICE_MAP := $(shell $(XCRUN) -sdk $(SDKROOT) -find embedded_device_map)
 endif
+EDM_DBPATH ?= $(PLATFORMPATH)/usr/local/standalone/firmware/device_map.db
 endif
 
 # Scripts or tools we build ourselves
-SEG_HACK := $(OBJROOT)/SETUP/setsegname/setsegname
-KEXT_CREATE_SYMBOL_SET := $(OBJROOT)/SETUP/kextsymboltool/kextsymboltool
+#
+# setsegname - Rename segments in a Mach-O object file
+# kextsymboltool - Create kext pseudo-kext Mach-O kexts binaries
+# decomment - Strip out comments to detect whether a file is comments-only
+# installfile - Atomically copy files, esp. when multiple architectures
+#               are trying to install the same target header
+# replacecontents - Write contents to a file and update modtime *only* if
+#               contents differ
+#
+SEG_HACK = $(OBJROOT)/SETUP/setsegname/setsegname
+KEXT_CREATE_SYMBOL_SET = $(OBJROOT)/SETUP/kextsymboltool/kextsymboltool
+DECOMMENT = $(OBJROOT)/SETUP/decomment/decomment
 NEWVERS = $(SRCROOT)/config/newvers.pl
+INSTALL = $(OBJROOT)/SETUP/installfile/installfile
+REPLACECONTENTS = $(OBJROOT)/SETUP/replacecontents/replacecontents
+JSONCOMPILATIONDB = $(OBJROOT)/SETUP/json_compilation_db/json_compilation_db
 
 # Standard BSD tools
-MD = /usr/bin/md
 RM = /bin/rm -f
+RMDIR = /bin/rmdir
 CP = /bin/cp
 MV = /bin/mv
 LN = /bin/ln -fs
 CAT = /bin/cat
 MKDIR = /bin/mkdir -p
+CHMOD = /bin/chmod
 FIND = /usr/bin/find
-INSTALL = /usr/bin/install
-TAR = /usr/bin/gnutar
+XARGS = /usr/bin/xargs
+PAX = /bin/pax
 BASENAME = /usr/bin/basename
+DIRNAME = /usr/bin/dirname
 TR = /usr/bin/tr
-
-# Platform-specific tools
-ifeq (iPhoneOS,$(PLATFORM))
-ifeq ($(IPHONEOS_OPTIMIZE),)
-       export IPHONEOS_OPTIMIZE := $(shell $(XCRUN) -sdk $(SDKROOT) -find iphoneos-optimize || echo /usr/bin/true)
-endif
-endif
-
-CTFINSERT = $(XCRUN) -sdk $(SDKROOT) ctf_insert
+TOUCH = /usr/bin/touch
+SLEEP = /bin/sleep
+AWK = /usr/bin/awk
+SED = /usr/bin/sed
+PLUTIL = /usr/bin/plutil
 
 #
 # Command to generate host binaries. Intentionally not
 # $(CC), which controls the target compiler
 #
+ifeq ($(HOST_OS_VERSION),)
+       export HOST_OS_VERSION  := $(shell sw_vers -productVersion)
+endif
 ifeq ($(HOST_CC),)
-       export HOST_CC          := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find cc)
+       export HOST_CC          := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find clang)
 endif
 ifeq ($(HOST_FLEX),)
        export HOST_FLEX        := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find flex)
@@ -140,17 +214,146 @@ endif
 ifeq ($(HOST_BISON),)
        export HOST_BISON       := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find bison)
 endif
+ifeq ($(HOST_GM4),)
+       export HOST_GM4         := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find gm4)
+endif
 ifeq ($(HOST_CODESIGN),)
-       export HOST_CODESIGN    := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find codesign)
+       export HOST_CODESIGN    := /usr/bin/codesign
+endif
+ifeq ($(HOST_CODESIGN_ALLOCATE),)
+       export HOST_CODESIGN_ALLOCATE   := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find codesign_allocate)
 endif
 
 #
-# Command to build libkmod.a/libkmodc++.a, which are
-# linked into kext binaries, and should be built as if
-# they followed system-wide policies
+# The following variables are functions invoked with "call", and thus
+# behave similarly to externally compiled commands
 #
-ifeq ($(LIBKMOD_CC),)
-       export LIBKMOD_CC       := $(shell $(XCRUN) -sdk $(SDKROOT) -find cc)
-endif
+
+# $(1) is an expanded kernel config from a TARGET_CONFIGS_UC tuple
+# $(2) is an expanded arch config from a TARGET_CONFIGS_UC tuple
+# $(3) is an expanded machine config from a TARGET_CONFIGS_UC tuple
+_function_create_build_configs_join = $(strip $(1))^$(strip $(2))^$(strip $(3))
+
+# $(1) is an un-expanded kernel config from a TARGET_CONFIGS_UC tuple
+# $(2) is an un-expanded arch config from a TARGET_CONFIGS_UC tuple
+# $(3) is an un-expanded machine config from a TARGET_CONFIGS_UC tuple
+_function_create_build_configs_do_expand =          $(call _function_create_build_configs_join, \
+                                                          $(if $(filter DEFAULT,$(1)), \
+                                                               $(DEFAULT_KERNEL_CONFIG), \
+                                                               $(1) \
+                                                           ), \
+                                                          $(if $(filter DEFAULT,$(2)), \
+                                                               $(DEFAULT_ARCH_CONFIG), \
+                                                               $(2) \
+                                                           ), \
+                                                          $(if $(filter DEFAULT,$(3)), \
+                                                               $(if $(filter DEFAULT,$(2)), \
+                                                                    $(DEFAULT_$(DEFAULT_ARCH_CONFIG)_MACHINE_CONFIG), \
+                                                                    $(DEFAULT_$(strip $(2))_MACHINE_CONFIG) \
+                                                               ), \
+                                                               $(3) \
+                                                           ) \
+                                                    )
+
+# $(1) is an un-expanded TARGET_CONFIGS_UC list, which must be consumed
+#      3 elements at a time
+function_create_build_configs = $(sort \
+                                       $(strip \
+                                                $(call _function_create_build_configs_do_expand, \
+                                                       $(word 1,$(1)), \
+                                                       $(word 2,$(1)), \
+                                                       $(word 3,$(1)), \
+                                                 ) \
+                                                $(if $(word 4,$(1)), \
+                                                     $(call function_create_build_configs, \
+                                                            $(wordlist 4,$(words $(1)),$(1)) \
+                                                      ), \
+                                                 ) \
+                                         ) \
+                                  )
+
+# Similar to build configs, but alias configs are a 4-tuple
+
+# $(1) is an expanded kernel config from a TARGET_CONFIGS_ALIASES_UC tuple
+# $(2) is an expanded arch config from a TARGET_CONFIGS_ALIASES_UC tuple
+# $(3) is an expanded kernel machine config from a TARGET_CONFIGS_ALIASES_UC tuple
+# $(4) is an expanded SoC platform config from a TARGET_CONFIGS_ALIASES_UC tuple,
+#      which should be an alias of $(3)
+_function_create_alias_configs_join = $(strip $(1))^$(strip $(2))^$(strip $(3))^$(strip $(4))
+
+_function_create_alias_configs_do_expand =         $(call _function_create_alias_configs_join, \
+                                                          $(if $(filter DEFAULT,$(1)), \
+                                                               $(DEFAULT_KERNEL_CONFIG), \
+                                                               $(1) \
+                                                           ), \
+                                                          $(if $(filter DEFAULT,$(2)), \
+                                                               $(DEFAULT_ARCH_CONFIG), \
+                                                               $(2) \
+                                                           ), \
+                                                          $(3), \
+                                                          $(4) \
+                                                    )
+
+function_create_alias_configs = $(sort \
+                                       $(strip \
+                                                $(call _function_create_alias_configs_do_expand, \
+                                                       $(word 1,$(1)), \
+                                                       $(word 2,$(1)), \
+                                                       $(word 3,$(1)), \
+                                                       $(word 4,$(1)), \
+                                                 ) \
+                                                $(if $(word 5,$(1)), \
+                                                     $(call function_create_alias_configs, \
+                                                            $(wordlist 5,$(words $(1)),$(1)) \
+                                                      ), \
+                                                 ) \
+                                        ) \
+                                )
+
+# $(1) is a fully-expanded kernel config
+# $(2) is a fully-expanded arch config
+# $(3) is a fully-expanded machine config. "NONE" is not represented in the objdir path
+function_convert_target_config_uc_to_objdir = $(if $(filter NONE,$(3)),$(strip $(1))_$(strip $(2)),$(strip $(1))_$(strip $(2))_$(strip $(3)))
+
+# $(1) is a fully-expanded build config (like "RELEASE^X86_64^NONE")
+function_convert_build_config_to_objdir = $(call function_convert_target_config_uc_to_objdir, \
+                                                $(word 1,$(subst ^, ,$(1))), \
+                                                $(word 2,$(subst ^, ,$(1))), \
+                                                $(word 3,$(subst ^, ,$(1))) \
+                                          )
+
+# $(1) is a fully-expanded build config (like "RELEASE^X86_64^NONE")
+function_extract_kernel_config_from_build_config  = $(word 1,$(subst ^, ,$(1)))
+function_extract_arch_config_from_build_config    = $(word 2,$(subst ^, ,$(1)))
+function_extract_machine_config_from_build_config = $(word 3,$(subst ^, ,$(1)))
+
+# $(1) is an input word
+# $(2) is a list of colon-separate potential substitutions like "FOO:BAR BAZ:QUX"
+# $(3) is a fallback if no substitutions were made
+function_substitute_word_with_replacement = $(strip $(if $(2),                                                         \
+                                                        $(if $(filter $(word 1,$(subst :, ,$(word 1,$(2)))),$(1)),     \
+                                                             $(word 2,$(subst :, ,$(word 1,$(2)))),            \
+                                                             $(call function_substitute_word_with_replacement,$(1),$(wordlist 2,$(words $(2)),$(2)),$(3))), \
+                                                        $(3)                                                           \
+                                                    )                                                                  \
+                                            )
+
+# You can't assign a variable to an empty space without these
+# shenanigans
+empty :=
+space := $(empty) $(empty)
+
+# Arithmetic
+# $(1) is the number to increment
+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
+increment = $(words x $(wordlist 1,$(1),$(NUM32)))
+decrement = $(words $(wordlist 2,$(1),$(NUM32)))
+
+# Create a sequence from 1 to $(1)
+# F(N) = if N > 0: return F(N-1) + "N" else: return ""
+sequence = $(if $(wordlist 1,$(1),$(NUM32)),$(call sequence,$(call decrement,$(1))) $(1),)
+
+# Reverse a list of words in $(1)
+reverse = $(if $(word 2,$(1)),$(call reverse,$(wordlist 2,$(words $(1)),$(1)))) $(word 1,$(1))
 
 # vim: set ft=make: