X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/89b3af67bb32e691275bf6fa803d1834b2284115..c3c9b80d004dbbfdf763edeb97968c6997e3b45b:/makedefs/MakeInc.cmd diff --git a/makedefs/MakeInc.cmd b/makedefs/MakeInc.cmd index 52ee80340..32ac9d6d5 100644 --- a/makedefs/MakeInc.cmd +++ b/makedefs/MakeInc.cmd @@ -1,25 +1,424 @@ +# -*- mode: makefile;-*- +# +# Copyright (C) 1999-2020 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 # -MIG = $(NEXT_ROOT)/usr/bin/mig -MD= /usr/bin/md +# +# Build Logging and Verbosity +# + +ifeq ($(RC_XBS),YES) + VERBOSE = YES +else + VERBOSE = NO +endif + +ECHO = echo + +ERR = $(ECHO) > /dev/stderr +PRINTF = printf + +QUIET ?= 0 +ifneq ($(QUIET),0) + PRINTF = printf > /dev/null + ifeq ($(VERBOSE),YES) + override VERBOSE = NO + endif +endif + +# Helper functions for logging operations. +LOG_PFX_LEN = 15 +LOG_PFX_LEN_ADJ = $(LOG_PFX_LEN) +LOG = $(PRINTF) "$2%$4s$(Color0) $3%s$(Color0)\n" "$1" + +CONCISE ?= 0 +ifneq ($(CONCISE),0) + # Concise logging puts all logs on the same line (CSI K to clear and + # carriage return). + LOG = $(PRINTF) "$2%$4s$(Color0) $3%s$(Color0)\033[K\r" "$1" +endif + +_LOG_COMP = $(call LOG,$1,$(ColorC),$(ColorF),$(LOG_PFX_LEN_ADJ)) +_LOG_HOST = $(call LOG,$1,$(ColorH),$(ColorF),$(LOG_PFX_LEN)) +_LOG_HOST_LINK = $(call LOG,$1,$(ColorH),$(ColorLF),$(LOG_PFX_LEN)) + +# Special operations. +LOG_LDFILELIST = $(call LOG,LDFILELIST,$(ColorL),$(ColorLF),$(LOG_PFX_LEN_ADJ)) +LOG_MIG = $(call LOG,MIG,$(ColorM),$(ColorF),$(LOG_PFX_LEN_ADJ)) +LOG_LD = $(call LOG,LD,$(ColorL),$(ColorF),$(LOG_PFX_LEN_ADJ)) +LOG_ALIGN = $(call LOG,--------->,$(Color0),$(Color0),$(LOG_PFX_LEN)) + +# Compiling/machine-specific operations. +LOG_CC = $(call _LOG_COMP,CC) +LOG_CXX = $(call _LOG_COMP,C++) +LOG_AS = $(call _LOG_COMP,AS) +LOG_LTO = $(call _LOG_COMP,LTO) +LOG_SYMBOLSET = $(call _LOG_COMP,SYMSET) +LOG_SYMBOLSETPLIST = $(call _LOG_COMP,SYMSETPLIST) + +# Host-side operations. +LOG_IIG = $(call _LOG_HOST,IIG) +LOG_HOST_CC = $(call _LOG_HOST,CC) +LOG_HOST_LD = $(call _LOG_HOST,LD) +LOG_HOST_CODESIGN = $(call _LOG_HOST,CODESIGN) +LOG_HOST_BISON = $(call _LOG_HOST,BISON) +LOG_HOST_FLEX = $(call _LOG_HOST,FLEX) +LOG_INSTALL = $(call _LOG_HOST,INSTALL) +LOG_INSTALLSYM = $(call _LOG_HOST,INSTALLSYM) +LOG_INSTALLHDR = $(call _LOG_HOST,INSTALLHDR) +LOG_INSTALLMACROS = $(call _LOG_HOST,INSTALLMACROS) +LOG_INSTALLPY = $(call _LOG_HOST,INSTALLPY) +LOG_MAN = $(call _LOG_HOST,MAN) +LOG_MANLINK = $(call _LOG_HOST,MANLINK) +LOG_ALIAS = $(call _LOG_HOST,ALIAS) +LOG_STRIP = $(call _LOG_HOST,STRIP) +LOG_DSYMUTIL = $(call _LOG_HOST,DSYMUTIL) +LOG_LIBTOOL = $(call _LOG_HOST,LIBTOOL) +LOG_FILEPREP = $(call _LOG_HOST,FILEPREP) + +# Host-side linking operations. +LOG_GENASSYM = $(call _LOG_HOST_LINK,GENASSYM) +LOG_GENERATE= $(call _LOG_HOST_LINK,GENERATE) +LOG_CTFCONVERT = $(call _LOG_HOST_LINK,CTFCONVERT) +LOG_CTFMERGE = $(call _LOG_HOST_LINK,CTFMERGE) +LOG_CTFINSERT = $(call _LOG_HOST_LINK,CTFINSERT) +LOG_DSYMUTIL = $(call _LOG_HOST_LINK,DSYMUTIL) +LOG_SUPPORTED_KPI = $(call _LOG_HOST_LINK,SUPPORTED_KPI) + +ifeq ($(VERBOSE),YES) + _v = + _vstdout = + _vstderr = + XCRUN = /usr/bin/xcrun -verbose +else + _v = @ + _vstdout = > /dev/null + _vstderr = 2&> /dev/null + XCRUN = /usr/bin/xcrun +endif + +VERBOSE_GENERATED_MAKE_FRAGMENTS = NO + +# +# Defaults +# + +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 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) + export CC := $(shell $(XCRUN) -sdk $(SDKROOT) -find clang) +endif +ifeq ($(origin CXX),default) + 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 ($(IIG),) + export IIG := $(shell $(XCRUN) -sdk $(SDKROOT) -find iig) +endif +ifeq ($(STRIP),) + export STRIP := $(shell $(XCRUN) -sdk $(SDKROOT) -find strip) +endif +ifeq ($(LIPO),) + export LIPO := $(shell $(XCRUN) -sdk $(SDKROOT) -find lipo) +endif +ifeq ($(LIBTOOL),) + export LIBTOOL := $(shell $(XCRUN) -sdk $(SDKROOT) -find libtool) +endif +ifeq ($(OTOOL),) + export OTOOL := $(shell $(XCRUN) -sdk $(SDKROOT) -find otool) +endif +ifeq ($(NM),) + export NM := $(shell $(XCRUN) -sdk $(SDKROOT) -find nm) +endif +ifeq ($(UNIFDEF),) + export UNIFDEF := $(shell $(XCRUN) -sdk $(SDKROOT) -find unifdef) +endif +ifeq ($(DSYMUTIL),) + export DSYMUTIL := $(shell $(XCRUN) -sdk $(SDKROOT) -find dsymutil) +endif +ifeq ($(CTFCONVERT),) + export CTFCONVERT := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctfconvert) +endif +ifeq ($(CTFMERGE),) + export CTFMERGE := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctfmerge) +endif +ifeq ($(CTFINSERT),) + export CTFINSERT := $(shell $(XCRUN) -sdk $(SDKROOT) -find ctf_insert) +endif +ifeq ($(NMEDIT),) + export NMEDIT := $(shell $(XCRUN) -sdk $(SDKROOT) -find nmedit) +endif +ifeq ($(SCAN_BUILD),) + export SCAN_BUILD := $(shell $(XCRUN) -sdk $(SDKROOT) -find scan-build) +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 +EDM_DBPATH ?= $(PLATFORMPATH)/usr/local/standalone/firmware/device_map.db + +# Scripts or tools we build ourselves +# +# 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 RM = /bin/rm -f +RMDIR = /bin/rmdir CP = /bin/cp +MV = /bin/mv LN = /bin/ln -fs CAT = /bin/cat MKDIR = /bin/mkdir -p - -TAR = /usr/bin/gnutar -STRIP = /usr/bin/strip -LIPO = /usr/bin/lipo - +CHMOD = /bin/chmod +FIND = /usr/bin/find +XARGS = /usr/bin/xargs +PAX = /bin/pax BASENAME = /usr/bin/basename -export RELPATH = $(NEXT_ROOT)/usr/local/bin/relpath +DIRNAME = /usr/bin/dirname TR = /usr/bin/tr -SEG_HACK = $(NEXT_ROOT)/usr/local/bin/seg_hack +TOUCH = /usr/bin/touch +SLEEP = /bin/sleep +AWK = /usr/bin/awk +SED = /usr/bin/sed +PLUTIL = /usr/bin/plutil +GREP = /usr/bin/grep + +# +# 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 clang) +endif +ifeq ($(HOST_FLEX),) + export HOST_FLEX := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find flex) +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 := /usr/bin/codesign +endif +ifeq ($(HOST_CODESIGN_ALLOCATE),) + export HOST_CODESIGN_ALLOCATE := $(shell $(XCRUN) -sdk $(HOST_SDKROOT) -find codesign_allocate) +endif + +# +# The following variables are functions invoked with "call", and thus +# behave similarly to externally compiled commands +# + +# $(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),) -UNIFDEF = /usr/bin/unifdef -DECOMMENT = /usr/local/bin/decomment +# 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: