1 # -*- mode: makefile;-*-
3 # Copyright (C) 1999-2016 Apple Inc. All rights reserved.
5 # MakeInc.rule defines the targets and rules for
6 # leaf directories once MakeInc.dir has recursed
7 # into them. "do_XXX" may be double-colon rules
8 # to allow the Makefile in the source directory
9 # to augment the actions that will be performed.
13 # Generic Install rules
16 ifndef INSTALL_KF_MI_LCL_LIST
17 INSTALL_KF_MI_LCL_LIST = $(EXPORT_MI_LIST)
20 ifndef INSTALL_KF_MI_LCL_GEN_LIST
21 INSTALL_KF_MI_LCL_GEN_LIST = $(EXPORT_MI_GEN_LIST)
24 ifndef INSTALL_KF_MD_LCL_LIST
25 INSTALL_KF_MD_LCL_LIST = $(EXPORT_MD_LIST)
28 ifndef INSTALL_KF_MD_LCL_GEN_LIST
29 INSTALL_KF_MD_LCL_GEN_LIST = $(EXPORT_MD_GEN_LIST)
32 ifndef INSTALL_KF_MI_LIST
33 INSTALL_KF_MI_LIST = $(EXPORT_MI_LIST)
36 ifndef INSTALL_KF_MI_GEN_LIST
37 INSTALL_KF_MI_GEN_LIST = $(EXPORT_MI_GEN_LIST)
40 ifndef INSTALL_KF_MD_LIST
41 INSTALL_KF_MD_LIST = $(EXPORT_MD_LIST)
44 ifndef INSTALL_KF_MD_GEN_LIST
45 INSTALL_KF_MD_GEN_LIST = $(EXPORT_MD_GEN_LIST)
48 ifeq (${XNU_LOGCOLORS},y)
53 # Get a nice list of device code names associated with the build platform
55 #ifdef EMBEDDED_DEVICE_MAP
56 # export CDevs := $(shell $(EMBEDDED_DEVICE_MAP) -db $(EDM_DBPATH) -query "SELECT DISTINCT TargetType FROM Targets WHERE KernelPlatform = '$(CURRENT_MACHINE_CONFIG_LC)'" | tr '[\r\n]' ':' | sed 's,:$$,,')
60 export _MACHINE := $(CURRENT_MACHINE_CONFIG_LC)
61 ifeq ($(CURRENT_MACHINE_CONFIG),NONE)
62 export _MACHINE := $(subst Mac,,$(PLATFORM))
64 export CMD_MC := \\033[1m$(shell __A="$(CURRENT_ARCH_CONFIG_LC)"; \
65 __As=$$((6-$${\#__A})); \
66 printf "%-.6s%*.*s %9.9s" \
68 $${__As} $${__As} " " \
71 # Turn off colored output
73 # Start a host command: bold, underlined pink text
75 # Start a compilation-related command: bold, underlined blue text
76 ColorC=[$(CMD_MC)] \\033[1;4;34m
77 # Start a MIG command: bold, green text on light grey background
78 ColorM=[$(CMD_MC)] \\033[1;32;40m
79 # Start a linking command: bold, white text on blue background
80 ColorL=[$(CMD_MC)] \\033[1;37;44m
81 # Start a filename: bold, white text
83 # Start a linked file name: yellow text on light grey background
84 ColorLF=\\033[1;33;40m
85 # Error strings: underlined bold white text on red background
86 ColorErr=\033[1;4;37;41m
93 # $(1) is the list of install paths
94 # $(2) is "1" if it's a "GEN"-style rule that looks locally, or else $(SOURCE)
95 # $(3) is the local temp directory for processing
96 # $(4) is the unifdef flags
98 # $$$$$$$$ is a double-escaped "$$" to represent the current pid
99 # of the shell process for creating uniquely named temporary files
101 define INSTALLHDRS_RULE_template
106 $$(_v)$$(MKDIR) ./$(3)
107 $$(_v)$$(MKDIR) $(dir $(firstword $(1)))
109 # Rebuild if unifdef flags change
110 $(1): $(3)/.UNIFDEF_FLAGS
111 $(3)/.UNIFDEF_FLAGS: ALWAYS | $(3)_MKDIR
112 $$(_v)$$(REPLACECONTENTS) $$@ $$(UNIFDEF) $(4)
114 $(1): $(dir $(firstword $(1)))% : $(if $(2),%,$$(SOURCE)/%) | $(3)_MKDIR
115 @echo "$$(ColorH)INSTALLHDR$$(Color0) $$(ColorF)$$*$$(Color0)"
116 $$(_v)$$(UNIFDEF) $(4) $$< > ./$(3)/$$*.unifdef.$$$$$$$$; \
117 if [ $$$$? -eq 2 ]; then \
118 echo Parse failure for $$<; \
121 $$(DECOMMENT) ./$(3)/$$*.unifdef.$$$$$$$$ r > \
122 ./$(3)/$$*.strip.$$$$$$$$ || exit 1; \
123 if [ -s ./$(3)/$$*.strip.$$$$$$$$ ]; then \
124 $$(INSTALL) $$(INSTALL_FLAGS) ./$(3)/$$*.unifdef.$$$$$$$$ $$@ || exit 1; \
126 $$(RM) ./$(3)/$$*.unifdef.$$$$$$$$ ./$(3)/$$*.strip.$$$$$$$$
129 # $(1) is the list of install paths
130 # $(2) is the source path pattern (using % to match with $(5)) or source file
131 # $(3) is the local temp directory for processing
132 # $(4) is the unifdef flags
133 # $(5) is the destination directory (when pattern matching) or empty
135 # $$$$$$$$ is a double-escaped "$$" to represent the current pid
136 # of the shell process for creating uniquely named temporary files
138 define INSTALLPYTHON_RULE_template
143 $$(_v)$$(MKDIR) ./$(3)
145 # Rebuild if unifdef flags change
146 $(1): $(3)/.UNIFDEF_FLAGS
147 $(3)/.UNIFDEF_FLAGS: ALWAYS | $(3)_MKDIR
148 $$(_v)$$(REPLACECONTENTS) $$@ $$(UNIFDEF) -t $(4)
150 $(1): $(5)% : $(2) | $(3)_MKDIR
151 @echo "$$(ColorH)INSTALLPY$$(Color0) $$(ColorF)$$*$$(Color0)"
152 $$(_v)$$(MKDIR) $$(dir $$@) $$(dir ./$(3)/$$*)
153 $$(_v)$$(UNIFDEF) -t $(4) $$< > ./$(3)/$$*.unifdef.$$$$$$$$$$(suffix $$*); \
154 if [ $$$$? -eq 2 ]; then \
155 echo Parse failure for $$<; \
158 $$(INSTALL) $$(DATA_INSTALL_FLAGS) \
159 ./$(3)/$$*.unifdef.$$$$$$$$$$(suffix $$*) $$@ || exit 1; \
160 $$(PYTHON) $$(LLDBMACROS_SOURCE)/core/syntax_checker.py \
161 ./$(3)/$$*.unifdef.$$$$$$$$$$(suffix $$*) $$(_vstdout) || exit 1; \
162 $$(RM) ./$(3)/$$*.unifdef.$$$$$$$$$$(suffix $$*)
163 $$(_v)if [ -n "$(5)" ]; then $$(TOUCH) "$(5)"; fi
167 # Machine-independent (public) files
170 INSTALL_MI_INC_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MI_DIR)/, $(INSTALL_MI_LIST))
171 INSTALL_MI_INC_GEN_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MI_DIR)/, $(INSTALL_MI_GEN_LIST))
173 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_INC_FILES),,incmidir,$(SINCFRAME_UNIFDEF)))
174 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_INC_GEN_FILES),1,incmigendir,$(SINCFRAME_UNIFDEF)))
176 INSTALL_KF_MI_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_LIST))
177 INSTALL_KF_MI_GEN_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_GEN_LIST))
179 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_FILES),,kincmidir,$(KINCFRAME_UNIFDEF)))
180 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_GEN_FILES),1,kincmigendir,$(KINCFRAME_UNIFDEF)))
183 # Machine-independent local (private) files
186 INSTALL_MI_LCL_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MI_DIR)/, $(sort $(INSTALL_MI_LCL_LIST) $(INSTALL_MI_LIST)))
187 INSTALL_MI_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MI_DIR)/, $(sort $(INSTALL_MI_LCL_GEN_LIST) $(INSTALL_MI_GEN_LIST)))
189 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_LCL_FILES),,pincmidir,$(SPINCFRAME_UNIFDEF)))
190 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_LCL_GEN_FILES),1,pincmigendir,$(SPINCFRAME_UNIFDEF)))
192 INSTALL_KF_MI_LCL_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_LCL_LIST))
193 INSTALL_KF_MI_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_LCL_GEN_LIST))
195 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_LCL_FILES),,kpincmidir,$(KPINCFRAME_UNIFDEF)))
196 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_LCL_GEN_FILES),1,kpincmigendir,$(KPINCFRAME_UNIFDEF)))
199 # Machine-dependent (public) files
202 INSTALL_MD_INC_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MD_DIR)/, $(INSTALL_MD_LIST))
203 INSTALL_MD_INC_GEN_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MD_DIR)/, $(INSTALL_MD_GEN_LIST))
205 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_INC_FILES),,incdir,$(SINCFRAME_UNIFDEF)))
206 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_INC_GEN_FILES),1,incgendir,$(SINCFRAME_UNIFDEF)))
208 INSTALL_KF_MD_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_LIST))
209 INSTALL_KF_MD_GEN_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_GEN_LIST))
211 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_FILES),,kincdir,$(KINCFRAME_UNIFDEF)))
212 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_GEN_FILES),1,kincgendir,$(KINCFRAME_UNIFDEF)))
215 # Machine-dependent local (private) files
218 INSTALL_MD_LCL_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MD_DIR)/, $(sort $(INSTALL_MD_LCL_LIST) $(INSTALL_MD_LIST)))
219 INSTALL_MD_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MD_DIR)/, $(sort $(INSTALL_MD_LCL_GEN_LIST) $(INSTALL_MD_GEN_LIST)))
221 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_LCL_FILES),,pincdir,$(SPINCFRAME_UNIFDEF)))
222 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_LCL_GEN_FILES),1,pincgendir,$(SPINCFRAME_UNIFDEF)))
224 INSTALL_KF_MD_LCL_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_LCL_LIST))
225 INSTALL_KF_MD_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_LCL_GEN_LIST))
227 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_LCL_FILES),,kpincdir,$(KPINCFRAME_UNIFDEF)))
228 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_LCL_GEN_FILES),1,kpincgendir,$(KPINCFRAME_UNIFDEF)))
230 .PHONY: do_installhdrs_mi
232 # Double-colon rule so that MakeInc.kernel can add custom behaviors
233 do_installhdrs_mi:: $(INSTALL_MI_INC_FILES) $(INSTALL_MI_INC_GEN_FILES) $(INSTALL_KF_MI_FILES) $(INSTALL_KF_MI_GEN_FILES) \
234 $(INSTALL_MI_LCL_FILES) $(INSTALL_MI_LCL_GEN_FILES) $(INSTALL_KF_MI_LCL_FILES) $(INSTALL_KF_MI_LCL_GEN_FILES)
237 .PHONY: do_installhdrs_md
239 do_installhdrs_md: $(INSTALL_MD_INC_FILES) $(INSTALL_MD_INC_GEN_FILES) $(INSTALL_KF_MD_FILES) $(INSTALL_KF_MD_GEN_FILES) \
240 $(INSTALL_MD_LCL_FILES) $(INSTALL_MD_LCL_GEN_FILES) $(INSTALL_KF_MD_LCL_FILES) $(INSTALL_KF_MD_LCL_GEN_FILES)
244 # Generic Export rules
246 EXPORT_MI_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/, $(EXPORT_MI_LIST))
247 EXPORT_MI_GEN_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/, $(EXPORT_MI_GEN_LIST))
249 .PHONY: EXP_MI_INC_DIR
252 $(_v)$(MKDIR) $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)
254 $(EXPORT_MI_GEN_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/% : % | EXP_MI_INC_DIR
255 $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
257 $(EXPORT_MI_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/% : $(SOURCE)/% | EXP_MI_INC_DIR
258 $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
260 EXPORT_MD_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/, $(EXPORT_MD_LIST))
261 EXPORT_MD_GEN_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/, $(EXPORT_MD_GEN_LIST))
263 .PHONY: EXP_MD_INC_DIR
266 $(_v)$(MKDIR) $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)
268 $(EXPORT_MD_GEN_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/% : % | EXP_MD_INC_DIR
269 $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
271 $(EXPORT_MD_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/% : $(SOURCE)/% | EXP_MD_INC_DIR
272 $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
274 .PHONY: do_exporthdrs_mi
276 do_exporthdrs_mi: $(EXPORT_MI_GEN_INC_FILES) $(EXPORT_MI_INC_FILES)
279 .PHONY: do_exporthdrs_md
281 do_exporthdrs_md: $(EXPORT_MD_GEN_INC_FILES) $(EXPORT_MD_INC_FILES)
285 # Generic Compilation rules
289 # Compilation rules to generate .o from .s
292 S_RULE_0=@echo "$(ColorC)AS$(Color0) $(ColorF)$@$(Color0)"
293 S_RULE_1A=$(_v)${S_KCC} -c ${SFLAGS} -MD -MF $(@:o=d) -MP ${$@_SFLAGS_ADD} ${INCFLAGS} ${$@_INCFLAGS}
298 # Compilation rules to generate .o from .c for normal files
300 C_RULE_0=@echo "$(ColorC)CC$(Color0) $(ColorF)$@$(Color0)"
301 C_RULE_1A=$(_v)${KCC} -c ${filter-out ${$@_CFLAGS_RM}, ${CFLAGS} ${CWARNFLAGS}} -MD -MF $(@:o=d) -MP ${$@_CFLAGS_ADD} ${$@_CWARNFLAGS_ADD} ${INCFLAGS} ${$@_INCFLAGS}
303 ifeq ($(BUILD_MACHO_OBJ),0)
305 else ifeq ($(DO_CTFCONVERT),1)
306 C_RULE_2=$(_v)if [ -z "${$@_SKIP_CTFCONVERT}" ]; then \
307 ctferr=`${CTFCONVERT} -l xnu -v -o $@.ctf $@ 2>&1 > /dev/null || true`; \
308 if [ ! -z "$${ctferr}" ]; then \
309 echo "[$(CMD_MC)] $(ColorErr)$@$(Color0) $(ColorErr)$${ctferr}$(Color0)"; \
315 ifeq ($(DO_CTFMACHO), 1)
316 C_CTFRULE_1A=$(_v)${KCC} -o $@.non_lto -c ${filter-out ${$@_CFLAGS_RM}, ${CFLAGS} ${CWARNFLAGS}} ${$@_CFLAGS_ADD} ${$@_CWARNFLAGS_ADD} ${INCFLAGS} $(CFLAGS_NOLTO_FLAG) ${$@_INCFLAGS}
318 C_CTFRULE_2=$(_v)if [ -z "${$@_SKIP_CTFCONVERT}" ]; then \
319 ctferr=`${CTFCONVERT} -l xnu -v -o $@.non_lto.ctf $@.non_lto 2>&1 > /dev/null || true`; \
320 if [ ! -z "$${ctferr}" ]; then \
321 echo "[$(CMD_MC)] $(ColorErr)$@$(Color0) $(ColorErr)$${ctferr}$(Color0)"; \
335 # Compilation rules to generate .o from .c for driver files
337 C_RULE_0_D=${C_RULE_0}
338 C_RULE_1A_D=${C_RULE_1A}
339 C_RULE_1B_D=${C_RULE_1B}
340 C_RULE_2_D=${C_RULE_2}
341 C_RULE_3_D=${C_RULE_3}
342 C_RULE_4A_D=${C_RULE_4A}
343 C_RULE_4B_D=${C_RULE_4B}
344 C_CTFRULE_1A_D=${C_CTFRULE_1A}
345 C_CTFRULE_1B_D=${C_CTFRULE_1B}
346 C_CTFRULE_2_D=${C_CTFRULE_2}
347 C_CTFRULE_3_D=${C_CTFRULE_3}
350 # Compilation rules to generate .co from .cp or .cpo from .cpp
351 # The config tool slickly changes the last source filename char to 'o'
352 # for the object filename.
353 P_RULE_0=@echo "$(ColorC)C++$(Color0) $(ColorF)$@$(Color0)"
354 P_RULE_1A=$(_v)${KC++} -o $@ -c ${CXXFLAGS} ${filter-out ${$@_CFLAGS_RM}, ${CFLAGS} ${CXXWARNFLAGS}} -MD -MF $(@:o=d) -MP ${$@_CFLAGS_ADD} ${$@_CXXWARNFLAGS_ADD} ${INCFLAGS} ${$@_INCFLAGS}
366 # This isn't the right place to put this, but we need to := override some settings
367 # in Makefiles that include the generic helper fragments (like this file)
369 ifeq ($(BUILD_JSON_COMPILATION_DATABASE),1)
377 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
378 # in their local Makefiles. Those that do will use a "::" rule to augment this.
382 .PHONY: do_build_install_primary
384 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
385 # in their local Makefiles. Those that do will use a "::" rule to augment this.
386 do_build_install_primary::
389 .PHONY: do_build_install_non_primary
391 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
392 # in their local Makefiles. Those that do will use a "::" rule to augment this.
393 do_build_install_non_primary::
396 INSTALL_MAN_FILES = $(addprefix $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)/, $(INSTALL_MAN_LIST))
398 .PHONY: INSTALL_MAN_DIR
401 $(_v)$(MKDIR) $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)
403 $(INSTALL_MAN_FILES): $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)/% : % | INSTALL_MAN_DIR
404 @echo "$(ColorH)MAN$(Color0) $(ColorF)$*$(Color0)"
405 $(_v)$(INSTALL) $(INSTALL_FLAGS) $< $@
407 define MAN_LINKS_RULE_template
408 $$(DSTROOT)/$$(MANDIR)/$$(INSTALL_MAN_DIR)/$(2): $$(DSTROOT)/$$(MANDIR)/$$(INSTALL_MAN_DIR)/$(1)
409 @echo "$$(ColorH)MANLINK$$(Color0) $$(ColorF)$(2)$$(Color0)"
413 function_generate_man_links_rules = $(if $(word 1,$(1)),$(eval $(call MAN_LINKS_RULE_template,$(word 1,$(1)),$(word 2,$(1)))) $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)/$(word 2,$(1)) $(call function_generate_man_links_rules,$(wordlist 3,$(words $(1)),$(1))))
415 INSTALL_MAN_FILES_LINKS = $(call function_generate_man_links_rules,$(INSTALL_MAN_LINKS))
417 .PHONY: do_installman
419 do_installman: $(INSTALL_MAN_FILES) $(INSTALL_MAN_FILES_LINKS)
422 .PHONY: do_textfiles_install
424 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
425 # in their local Makefiles. Those that do will use a "::" rule to augment this.
426 do_textfiles_install:: do_installman
429 .PHONY: do_build_setup
431 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
432 # in their local Makefiles. Those that do will use a "::" rule to augment this.
436 .PHONY: do_config_all
438 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
439 # in their local Makefiles. Those that do will use a "::" rule to augment this.
443 .PHONY: do_config_install
445 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
446 # in their local Makefiles. Those that do will use a "::" rule to augment this.