makedefs/MakeInc.rule

   1 # -*- mode: makefile;-*-
   2 #
   3 # Copyright (C) 1999-2012 Apple Inc. All rights reserved.
   4 #
   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.
  10 #
  11
  12 #
  13 # Generic Install rules
  14 #
  15
  16 ifndef INSTALL_KF_MI_LCL_LIST
  17     INSTALL_KF_MI_LCL_LIST = $(EXPORT_MI_LIST)
  18 endif
  19
  20 ifndef INSTALL_KF_MI_LCL_GEN_LIST
  21     INSTALL_KF_MI_LCL_GEN_LIST = $(EXPORT_MI_GEN_LIST)
  22 endif
  23
  24 ifndef INSTALL_KF_MD_LCL_LIST
  25     INSTALL_KF_MD_LCL_LIST = $(EXPORT_MD_LIST)
  26 endif
  27
  28 ifndef INSTALL_KF_MD_LCL_GEN_LIST
  29     INSTALL_KF_MD_LCL_GEN_LIST = $(EXPORT_MD_GEN_LIST)
  30 endif
  31
  32 ifndef INSTALL_KF_MI_LIST
  33     INSTALL_KF_MI_LIST = $(EXPORT_MI_LIST)
  34 endif
  35
  36 ifndef INSTALL_KF_MI_GEN_LIST
  37     INSTALL_KF_MI_GEN_LIST = $(EXPORT_MI_GEN_LIST)
  38 endif
  39
  40 ifndef INSTALL_KF_MD_LIST
  41     INSTALL_KF_MD_LIST = $(EXPORT_MD_LIST)
  42 endif
  43
  44 ifndef INSTALL_KF_MD_GEN_LIST
  45     INSTALL_KF_MD_GEN_LIST = $(EXPORT_MD_GEN_LIST)
  46 endif
  47
  48 .PHONY: ALWAYS
  49
  50 ALWAYS:
  51
  52 # $(1) is the list of install paths
  53 # $(2) is "1" if it's a "GEN"-style rule that looks locally, or else $(SOURCE)
  54 # $(3) is the local temp directory for processing
  55 # $(4) is the unifdef flags
  56 #
  57 # $$$$$$$$ is a double-escaped "$$" to represent the current pid
  58 # of the shell process for creating uniquely named temporary files
  59
  60 define INSTALLHDRS_RULE_template
  61
  62 .PHONY: $(3)_MKDIR
  63
  64 $(3)_MKDIR:
  65         $$(_v)$$(MKDIR) ./$(3)
  66         $$(_v)$$(MKDIR) $(dir $(firstword $(1)))
  67
  68 # Rebuild if unifdef flags change
  69 $(1): $(3)/.UNIFDEF_FLAGS
  70 $(3)/.UNIFDEF_FLAGS: ALWAYS | $(3)_MKDIR
  71         $$(_v)$$(REPLACECONTENTS) $$@ $$(UNIFDEF) $(4)
  72
  73 $(1): $(dir $(firstword $(1)))% : $(if $(2),%,$$(SOURCE)/%) | $(3)_MKDIR
  74         @echo INSTALLHDR $$*
  75         $$(_v)$$(UNIFDEF) $(4) $$< > ./$(3)/$$*.unifdef.$$$$$$$$;       \
  76         if [ $$$$? -eq 2 ]; then                                                \
  77                 echo Parse failure for $$<;                             \
  78                 exit 1;                                                 \
  79         fi;                                                             \
  80         $$(DECOMMENT) ./$(3)/$$*.unifdef.$$$$$$$$ r >                   \
  81                 ./$(3)/$$*.strip.$$$$$$$$ || exit 1;                    \
  82         if [ -s ./$(3)/$$*.strip.$$$$$$$$ ]; then                       \
  83                 $$(INSTALL) $$(INSTALL_FLAGS) ./$(3)/$$*.unifdef.$$$$$$$$ $$@ || exit 1;        \
  84         fi;                                                             \
  85         $$(RM) ./$(3)/$$*.unifdef.$$$$$$$$ ./$(3)/$$*.strip.$$$$$$$$
  86 endef
  87
  88 #
  89 # Machine-independent (public) files
  90 #
  91
  92 INSTALL_MI_INC_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MI_DIR)/, $(INSTALL_MI_LIST))
  93 INSTALL_MI_INC_GEN_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MI_DIR)/, $(INSTALL_MI_GEN_LIST))
  94
  95 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_INC_FILES),,incmidir,$(SINCFRAME_UNIFDEF)))
  96 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_INC_GEN_FILES),1,incmigendir,$(SINCFRAME_UNIFDEF)))
  97
  98 INSTALL_KF_MI_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_LIST))
  99 INSTALL_KF_MI_GEN_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_GEN_LIST))
 100
 101 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_FILES),,kincmidir,$(KINCFRAME_UNIFDEF)))
 102 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_GEN_FILES),1,kincmigendir,$(KINCFRAME_UNIFDEF)))
 103
 104 #
 105 # Machine-independent local (private) files
 106 #
 107
 108 INSTALL_MI_LCL_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MI_DIR)/, $(sort $(INSTALL_MI_LCL_LIST) $(INSTALL_MI_LIST)))
 109 INSTALL_MI_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MI_DIR)/, $(sort $(INSTALL_MI_LCL_GEN_LIST) $(INSTALL_MI_GEN_LIST)))
 110
 111 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_LCL_FILES),,pincmidir,$(SPINCFRAME_UNIFDEF)))
 112 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MI_LCL_GEN_FILES),1,pincmigendir,$(SPINCFRAME_UNIFDEF)))
 113
 114 INSTALL_KF_MI_LCL_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_LCL_LIST))
 115 INSTALL_KF_MI_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MI_DIR)/, $(INSTALL_KF_MI_LCL_GEN_LIST))
 116
 117 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_LCL_FILES),,kpincmidir,$(KPINCFRAME_UNIFDEF)))
 118 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MI_LCL_GEN_FILES),1,kpincmigendir,$(KPINCFRAME_UNIFDEF)))
 119
 120 #
 121 # Machine-dependent (public) files
 122 #
 123
 124 INSTALL_MD_INC_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MD_DIR)/, $(INSTALL_MD_LIST))
 125 INSTALL_MD_INC_GEN_FILES = $(addprefix $(DSTROOT)/$(INCDIR)/$(INSTALL_MD_DIR)/, $(INSTALL_MD_GEN_LIST))
 126
 127 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_INC_FILES),,incdir,$(SINCFRAME_UNIFDEF)))
 128 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_INC_GEN_FILES),1,incgendir,$(SINCFRAME_UNIFDEF)))
 129
 130 INSTALL_KF_MD_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_LIST))
 131 INSTALL_KF_MD_GEN_FILES = $(addprefix $(DSTROOT)/$(KINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_GEN_LIST))
 132
 133 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_FILES),,kincdir,$(KINCFRAME_UNIFDEF)))
 134 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_GEN_FILES),1,kincgendir,$(KINCFRAME_UNIFDEF)))
 135
 136 #
 137 # Machine-dependent local (private) files
 138 #
 139
 140 INSTALL_MD_LCL_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MD_DIR)/, $(sort $(INSTALL_MD_LCL_LIST) $(INSTALL_MD_LIST)))
 141 INSTALL_MD_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(LCLDIR)/$(INSTALL_MD_DIR)/, $(sort $(INSTALL_MD_LCL_GEN_LIST) $(INSTALL_MD_GEN_LIST)))
 142
 143 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_LCL_FILES),,pincdir,$(SPINCFRAME_UNIFDEF)))
 144 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_MD_LCL_GEN_FILES),1,pincgendir,$(SPINCFRAME_UNIFDEF)))
 145
 146 INSTALL_KF_MD_LCL_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_LCL_LIST))
 147 INSTALL_KF_MD_LCL_GEN_FILES = $(addprefix $(DSTROOT)/$(KPINCDIR)/$(EXPORT_MD_DIR)/, $(INSTALL_KF_MD_LCL_GEN_LIST))
 148
 149 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_LCL_FILES),,kpincdir,$(KPINCFRAME_UNIFDEF)))
 150 $(eval $(call INSTALLHDRS_RULE_template,$(INSTALL_KF_MD_LCL_GEN_FILES),1,kpincgendir,$(KPINCFRAME_UNIFDEF)))
 151
 152 .PHONY: do_installhdrs_mi
 153
 154 # Double-colon rule so that MakeInc.kernel can add custom behaviors
 155 do_installhdrs_mi:: $(INSTALL_MI_INC_FILES) $(INSTALL_MI_INC_GEN_FILES) $(INSTALL_KF_MI_FILES) $(INSTALL_KF_MI_GEN_FILES) \
 156                     $(INSTALL_MI_LCL_FILES) $(INSTALL_MI_LCL_GEN_FILES) $(INSTALL_KF_MI_LCL_FILES) $(INSTALL_KF_MI_LCL_GEN_FILES)
 157         @:
 158
 159 .PHONY: do_installhdrs_md
 160
 161 do_installhdrs_md: $(INSTALL_MD_INC_FILES) $(INSTALL_MD_INC_GEN_FILES) $(INSTALL_KF_MD_FILES) $(INSTALL_KF_MD_GEN_FILES) \
 162                    $(INSTALL_MD_LCL_FILES) $(INSTALL_MD_LCL_GEN_FILES) $(INSTALL_KF_MD_LCL_FILES) $(INSTALL_KF_MD_LCL_GEN_FILES)
 163         @:
 164
 165 #
 166 # Generic Export rules
 167 #
 168 EXPORT_MI_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/, $(EXPORT_MI_LIST))
 169 EXPORT_MI_GEN_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/, $(EXPORT_MI_GEN_LIST))
 170
 171 .PHONY: EXP_MI_INC_DIR
 172
 173 EXP_MI_INC_DIR:
 174         $(_v)$(MKDIR) $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)
 175
 176 $(EXPORT_MI_GEN_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/% : % | EXP_MI_INC_DIR
 177         $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
 178
 179 $(EXPORT_MI_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MI_DIR)/% : $(SOURCE)/% | EXP_MI_INC_DIR
 180         $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
 181
 182 EXPORT_MD_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/, $(EXPORT_MD_LIST))
 183 EXPORT_MD_GEN_INC_FILES = $(addprefix $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/, $(EXPORT_MD_GEN_LIST))
 184
 185 .PHONY: EXP_MD_INC_DIR
 186
 187 EXP_MD_INC_DIR:
 188         $(_v)$(MKDIR) $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)
 189
 190 $(EXPORT_MD_GEN_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/% : % | EXP_MD_INC_DIR
 191         $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
 192
 193 $(EXPORT_MD_INC_FILES): $(OBJROOT)/$(EXPDIR)/$(EXPORT_MD_DIR)/% : $(SOURCE)/% | EXP_MD_INC_DIR
 194         $(_v)$(INSTALL) $(DATA_INSTALL_FLAGS) $< $@
 195
 196 .PHONY: do_exporthdrs_mi
 197
 198 do_exporthdrs_mi: $(EXPORT_MI_GEN_INC_FILES) $(EXPORT_MI_INC_FILES)
 199         @:
 200
 201 .PHONY: do_exporthdrs_md
 202
 203 do_exporthdrs_md: $(EXPORT_MD_GEN_INC_FILES)  $(EXPORT_MD_INC_FILES)
 204         @:
 205
 206 #
 207 # Generic Compilation rules
 208 #
 209
 210 #
 211 # Compilation rules to generate .o from .s
 212 #
 213
 214 S_RULE_0=@echo AS $@
 215 S_RULE_1A=$(_v)${S_KCC} -c ${SFLAGS} -MD -MF $(@:o=d) -MP ${$@_SFLAGS_ADD} ${INCFLAGS} ${$@_INCFLAGS}
 216 S_RULE_1B=$(<F)
 217 S_RULE_2=
 218
 219 #
 220 # Compilation rules to generate .o from .c for normal files
 221 #
 222 C_RULE_0=@echo CC $@
 223 C_RULE_1A=$(_v)${KCC} -c ${filter-out ${$@_CFLAGS_RM}, ${CFLAGS} ${CWARNFLAGS}} -MD -MF $(@:o=d) -MP ${$@_CFLAGS_ADD} ${$@_CWARNFLAGS_ADD} ${INCFLAGS} ${$@_INCFLAGS}
 224 C_RULE_1B=$(<F)
 225 ifeq ($(BUILD_MACHO_OBJ),0)
 226 C_RULE_2=
 227 else ifeq ($(DO_CTFCONVERT),1)
 228 C_RULE_2=$(_v)if [ -z "${$@_SKIP_CTFCONVERT}" ]; then ${CTFCONVERT} -l xnu -v -o $@.ctf $@ > /dev/null || true; fi
 229 else
 230 C_RULE_2=
 231 endif
 232 ifeq ($(DO_CTFMACHO), 1)
 233 C_CTFRULE_1A=$(_v)${KCC} -o $@.non_lto -c ${filter-out ${$@_CFLAGS_RM}, ${CFLAGS} ${CWARNFLAGS}} ${$@_CFLAGS_ADD} ${$@_CWARNFLAGS_ADD} ${INCFLAGS} ${$@_INCFLAGS} $(CFLAGS_NOLTO_FLAG)
 234 C_CTFRULE_1B=$(<F)
 235 C_CTFRULE_2=$(_v)if [ -z "${$@_SKIP_CTFCONVERT}" ]; then ${CTFCONVERT} -l xnu -v -o $@.non_lto.ctf $@.non_lto > /dev/null || true; fi
 236 else
 237 C_CTFRULE_1A=@true
 238 C_CTFRULE_1B=
 239 C_CTFRULE_2=@true
 240 endif
 241
 242 #
 243 # Compilation rules to generate .o from .c for driver files
 244 #
 245 C_RULE_0_D=${C_RULE_0}
 246 C_RULE_1A_D=${C_RULE_1A}
 247 C_RULE_1B_D=${C_RULE_1B}
 248 C_RULE_2_D=${C_RULE_2}
 249 C_CTFRULE_1A_D=${C_CTFRULE_1A}
 250 C_CTFRULE_1B_D=${C_CTFRULE_1B}
 251 C_CTFRULE_2_D=${C_CTFRULE_2}
 252
 253 #
 254 # Compilation rules to generate .co from .cp or .cpo from .cpp
 255 #   The config tool slickly changes the last source filename char to 'o'
 256 #   for the object filename.
 257 P_RULE_0=@echo C++ $@
 258 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}
 259 P_RULE_1B=$(<F)
 260 P_RULE_2=
 261 P_CTFRULE_1A=@true
 262 P_CTFRULE_1B=
 263 P_CTFRULE_2=@true
 264
 265
 266 #
 267 # This isn't the right place to put this, but we need to := override some settings
 268 # in Makefiles that include the generic helper fragments (like this file)
 269 #
 270 ifeq ($(BUILD_JSON_COMPILATION_DATABASE),1)
 271 HIB_FILES :=
 272 LAST_FILES :=
 273 KLD_FILES :=
 274 endif
 275
 276 .PHONY: do_build_all
 277
 278 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 279 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 280 do_build_all::
 281         @:
 282
 283 .PHONY: do_build_install_primary
 284
 285 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 286 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 287 do_build_install_primary::
 288         @:
 289
 290 .PHONY: do_build_install_non_primary
 291
 292 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 293 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 294 do_build_install_non_primary::
 295         @:
 296
 297 INSTALL_MAN_FILES = $(addprefix $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)/, $(INSTALL_MAN_LIST))
 298
 299 .PHONY: INSTALL_MAN_DIR
 300
 301 INSTALL_MAN_DIR:
 302         $(_v)$(MKDIR) $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)
 303
 304 $(INSTALL_MAN_FILES): $(DSTROOT)/$(MANDIR)/$(INSTALL_MAN_DIR)/% : % | INSTALL_MAN_DIR
 305         @echo MAN $*
 306         $(_v)$(INSTALL) $(INSTALL_FLAGS) $< $@
 307
 308 define MAN_LINKS_RULE_template
 309 $$(DSTROOT)/$$(MANDIR)/$$(INSTALL_MAN_DIR)/$(2): $$(DSTROOT)/$$(MANDIR)/$$(INSTALL_MAN_DIR)/$(1)
 310         @echo MANLINK $(2)
 311         $(_v)ln -f $$< $$@
 312 endef
 313
 314 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))))
 315
 316 INSTALL_MAN_FILES_LINKS = $(call function_generate_man_links_rules,$(INSTALL_MAN_LINKS))
 317
 318 .PHONY: do_installman
 319
 320 do_installman: $(INSTALL_MAN_FILES) $(INSTALL_MAN_FILES_LINKS)
 321         @:
 322
 323 .PHONY: do_textfiles_install
 324
 325 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 326 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 327 do_textfiles_install:: do_installman
 328         @:
 329
 330 .PHONY: do_build_setup
 331
 332 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 333 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 334 do_build_setup::
 335         @:
 336
 337 .PHONY: do_config_all
 338
 339 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 340 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 341 do_config_all::
 342         @:
 343
 344 .PHONY: do_config_install
 345
 346 # Do-nothing rule, since not all levels of the recursive hierarchy might implement this
 347 # in their local Makefiles. Those that do will use a "::" rule to augment this.
 348 do_config_install::
 349         @:
 350
 351 # vim: set ft=make: