| 1 | # $Id: header.kmk 2018 2008-11-02 00:08:56Z bird $ | 
|---|
| 2 | ## @file | 
|---|
| 3 | # kBuild - File included at top of a makefile. | 
|---|
| 4 | # | 
|---|
| 5 |  | 
|---|
| 6 | # | 
|---|
| 7 | # Copyright (c) 2004-2008 knut st. osmundsen <bird-kBuild-spam@anduin.net> | 
|---|
| 8 | # | 
|---|
| 9 | # This file is part of kBuild. | 
|---|
| 10 | # | 
|---|
| 11 | # kBuild is free software; you can redistribute it and/or modify | 
|---|
| 12 | # it under the terms of the GNU General Public License as published by | 
|---|
| 13 | # the Free Software Foundation; either version 2 of the License, or | 
|---|
| 14 | # (at your option) any later version. | 
|---|
| 15 | # | 
|---|
| 16 | # kBuild is distributed in the hope that it will be useful, | 
|---|
| 17 | # but WITHOUT ANY WARRANTY; without even the implied warranty of | 
|---|
| 18 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
|---|
| 19 | # GNU General Public License for more details. | 
|---|
| 20 | # | 
|---|
| 21 | # You should have received a copy of the GNU General Public License | 
|---|
| 22 | # along with kBuild; if not, write to the Free Software | 
|---|
| 23 | # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA | 
|---|
| 24 | # | 
|---|
| 25 | # | 
|---|
| 26 | # As a special exception you are granted permission to include this file, via | 
|---|
| 27 | # the kmk include directive, as you wish without this in itself causing the | 
|---|
| 28 | # resulting makefile, program or whatever to be covered by the GPL license. | 
|---|
| 29 | # This exception does not however invalidate any other reasons why the makefile, | 
|---|
| 30 | # program, whatever should not be covered the GPL. | 
|---|
| 31 | # | 
|---|
| 32 | # | 
|---|
| 33 |  | 
|---|
| 34 | ifndef __header_kmk__ | 
|---|
| 35 | # start-of-file-content | 
|---|
| 36 | ifdef KBUILD_PROFILE_SELF | 
|---|
| 37 | _KBUILD_TS_HEADER_START := $(nanots ) # just a dummy warm up query | 
|---|
| 38 | $(info prof: since start - since previous -- event description) | 
|---|
| 39 | ifeq ($(KBUILD_PROFILE_SELF),2) | 
|---|
| 40 | $(info stat: $(make-stats )) | 
|---|
| 41 | endif | 
|---|
| 42 | _KBUILD_TS_HEADER_START := $(nanots ) | 
|---|
| 43 | _KBUILD_TS_PREV := $(_KBUILD_TS_HEADER_START) | 
|---|
| 44 |  | 
|---|
| 45 | _KBUILD_FMT_ELAPSED_EX = $(int-div $(int-add $(int-sub $1, $2),500000),1000000)ms | 
|---|
| 46 | _KBUILD_FMT_ELAPSED = $(call _KBUILD_FMT_ELAPSED_EX,$(_KBUILD_TS_NOW),$1) | 
|---|
| 47 |  | 
|---|
| 48 | define def_profile_self | 
|---|
| 49 | _KBUILD_TS_NOW := $(nanots ) | 
|---|
| 50 | $(info prof: $(call _KBUILD_FMT_ELAPSED,$(_KBUILD_TS_HEADER_START)) - $(call _KBUILD_FMT_ELAPSED, $(_KBUILD_TS_PREV)) -- $(strip $1)) | 
|---|
| 51 | ifeq ($(KBUILD_PROFILE_SELF),2) | 
|---|
| 52 | $(info stat: $(make-stats )) | 
|---|
| 53 | endif | 
|---|
| 54 | _KBUILD_TS_PREV := $(_KBUILD_TS_NOW) | 
|---|
| 55 | endef | 
|---|
| 56 |  | 
|---|
| 57 | endif | 
|---|
| 58 |  | 
|---|
| 59 |  | 
|---|
| 60 | # | 
|---|
| 61 | # Check make version before we do anything else. | 
|---|
| 62 | # | 
|---|
| 63 | ifndef KMK_VERSION | 
|---|
| 64 | $(error kBuild: The kmk default variable KMK_VERSION isn't defined! Make sure you are using 'kmk' and not 'make', 'gmake', 'kmk_gmake', 'dmake' or any other make program) | 
|---|
| 65 | endif | 
|---|
| 66 | ifneq ($(KBUILD_VERSION_MAJOR).$(KBUILD_VERSION_MINOR),0.1) | 
|---|
| 67 | ifneq ($(KBUILD_VERSION_MAJOR),0) | 
|---|
| 68 | $(warning kBuild: kmk major version mismatch! Expected '0' but found '$(KBUILD_VERSION_MAJOR)'!) | 
|---|
| 69 | else | 
|---|
| 70 | $(warning kBuild: kmk minor version mismatch! Expected '1' but found '$(KBUILD_VERSION_MINOR)'!) | 
|---|
| 71 | endif | 
|---|
| 72 | else | 
|---|
| 73 | ifneq ($(int-ge $(KBUILD_VERSION_PATCH),4),1) | 
|---|
| 74 | $(warning kBuild: kmk version mismatch! Expected 0.1.4 or later. Actual version is $(KBUILD_VERSION_MAJOR).$(KBUILD_VERSION_MINOR).$(KBUILD_VERSION_PATCH).) | 
|---|
| 75 | endif | 
|---|
| 76 | endif | 
|---|
| 77 |  | 
|---|
| 78 | # | 
|---|
| 79 | # The revision in which this file was last modified. | 
|---|
| 80 | # This can be useful when using development versions of kBuild. | 
|---|
| 81 | # | 
|---|
| 82 | KMK_REVISION := $(patsubst %:,,  $Rev: 2018 $  ) | 
|---|
| 83 |  | 
|---|
| 84 |  | 
|---|
| 85 | # | 
|---|
| 86 | # Define the default goal. | 
|---|
| 87 | # | 
|---|
| 88 | .PHONY: all all_recursive | 
|---|
| 89 | all: all_recursive | 
|---|
| 90 |  | 
|---|
| 91 | # | 
|---|
| 92 | # The phony FORCE target. | 
|---|
| 93 | # | 
|---|
| 94 | .PHONY: FORCE | 
|---|
| 95 | FORCE: | 
|---|
| 96 |  | 
|---|
| 97 |  | 
|---|
| 98 | # | 
|---|
| 99 | # Enable delete on error and second expansion of prerequisites and targets. | 
|---|
| 100 | # | 
|---|
| 101 | .DELETE_ON_ERROR: | 
|---|
| 102 |  | 
|---|
| 103 | .SECONDEXPANSION: | 
|---|
| 104 |  | 
|---|
| 105 | .SECONDTARGETEXPANSION: | 
|---|
| 106 |  | 
|---|
| 107 |  | 
|---|
| 108 | # | 
|---|
| 109 | # General purpose macros. | 
|---|
| 110 | # | 
|---|
| 111 |  | 
|---|
| 112 | ## | 
|---|
| 113 | # Newline character(s). | 
|---|
| 114 | define NL | 
|---|
| 115 |  | 
|---|
| 116 |  | 
|---|
| 117 | endef | 
|---|
| 118 |  | 
|---|
| 119 | ## | 
|---|
| 120 | # Tab character. | 
|---|
| 121 | TAB := $(subst .,       ,.) | 
|---|
| 122 |  | 
|---|
| 123 | ## | 
|---|
| 124 | # Newline + tab characters (for generating commands). | 
|---|
| 125 | NLTAB = $(NL)$(TAB) | 
|---|
| 126 |  | 
|---|
| 127 | ## | 
|---|
| 128 | # Space character. | 
|---|
| 129 | SP := $(subst ., ,.) | 
|---|
| 130 |  | 
|---|
| 131 | ## | 
|---|
| 132 | # Hash character. | 
|---|
| 133 | define HASH | 
|---|
| 134 | # | 
|---|
| 135 | endef | 
|---|
| 136 |  | 
|---|
| 137 | ## | 
|---|
| 138 | # Colon character. | 
|---|
| 139 | COLON := : | 
|---|
| 140 |  | 
|---|
| 141 | ## | 
|---|
| 142 | # Semicolon character. | 
|---|
| 143 | SEMICOLON := ; | 
|---|
| 144 |  | 
|---|
| 145 | ## | 
|---|
| 146 | # Comma character. | 
|---|
| 147 | COMMA := , | 
|---|
| 148 |  | 
|---|
| 149 | ## | 
|---|
| 150 | # Dot character. | 
|---|
| 151 | DOT := . | 
|---|
| 152 |  | 
|---|
| 153 | ## | 
|---|
| 154 | # Dollar character. | 
|---|
| 155 | DOLLAR := $$ | 
|---|
| 156 |  | 
|---|
| 157 | ## | 
|---|
| 158 | # Equal character. | 
|---|
| 159 | EQUAL := = | 
|---|
| 160 |  | 
|---|
| 161 |  | 
|---|
| 162 | # | 
|---|
| 163 | # The list of standard build types in kBuild. | 
|---|
| 164 | # | 
|---|
| 165 | # This list can be extended in Config.kmk and it's possible to extend | 
|---|
| 166 | # (inherit) another build type. | 
|---|
| 167 | # | 
|---|
| 168 | KBUILD_BLD_TYPES := release profile debug | 
|---|
| 169 |  | 
|---|
| 170 |  | 
|---|
| 171 | # | 
|---|
| 172 | # The OSes, Architectures and CPUs that kBuild recognizes. | 
|---|
| 173 | # | 
|---|
| 174 | # When kBuild is ported to a new OS or architecture a unique keyword needs | 
|---|
| 175 | # to be assigned to it and added here. This strictness is required because | 
|---|
| 176 | # this keyword namespace is shared between OSes, architectures, cpus and | 
|---|
| 177 | # build types. (PORTME) | 
|---|
| 178 | # | 
|---|
| 179 | KBUILD_OSES   := darwin dragonfly freebsd l4 linux netbsd nt openbsd os2 solaris win | 
|---|
| 180 | KBUILD_ARCHES := x86 amd64 sparc32 sparc64 s390 s390x ppc32 ppc64 mips32 mips64 ia64 hppa32 hppa64 arm alpha | 
|---|
| 181 |  | 
|---|
| 182 |  | 
|---|
| 183 | # | 
|---|
| 184 | # Set default build type. | 
|---|
| 185 | # | 
|---|
| 186 | ifndef KBUILD_TYPE | 
|---|
| 187 | ifdef BUILD_TYPE | 
|---|
| 188 | KBUILD_TYPE := $(BUILD_TYPE) | 
|---|
| 189 | endif | 
|---|
| 190 | else ifdef BUILD_TYPE | 
|---|
| 191 | ifneq ($(KBUILD_TYPE),$(BUILD_TYPE)) | 
|---|
| 192 | ifeq ($(origin KBUILD_TYPE):$(origin BUILD_TYPE),environment:command line) | 
|---|
| 193 | KBUILD_TYPE := $(BUILD_TYPE) | 
|---|
| 194 | else ifneq ($(origin KBUILD_TYPE):$(origin BUILD_TYPE),command line:environment) | 
|---|
| 195 | $(error kBuild: KBUILD_TYPE and BUILD_TYPE disagree.) | 
|---|
| 196 | endif | 
|---|
| 197 | endif | 
|---|
| 198 | endif | 
|---|
| 199 | override BUILD_TYPE = $(KBUILD_TYPE) | 
|---|
| 200 |  | 
|---|
| 201 | ifndef KBUILD_TYPE | 
|---|
| 202 | KBUILD_TYPE := release | 
|---|
| 203 | else | 
|---|
| 204 | if1of ($(KBUILD_TYPE), $(KBUILD_OSES) $(KBUILD_ARCHES)) | 
|---|
| 205 | $(error kBuild: The KBUILD_TYPE value '$(KBUILD_TYPE)' is an OS or architecture!) | 
|---|
| 206 | endif | 
|---|
| 207 | ifneq (.$(words $(KBUILD_TYPE)).$(KBUILD_TYPE).,.1.$(strip $(KBUILD_TYPE)).) | 
|---|
| 208 | $(error kBuild: The KBUILD_TYPE value '$(KBUILD_TYPE)' contains spaces/tabs!) | 
|---|
| 209 | endif | 
|---|
| 210 | endif | 
|---|
| 211 |  | 
|---|
| 212 |  | 
|---|
| 213 | # | 
|---|
| 214 | # Host platform legacy | 
|---|
| 215 | # kmk deals with this, so this is only temporary until I've rebuilt everything. | 
|---|
| 216 | # | 
|---|
| 217 | ifndef KBUILD_HOST | 
|---|
| 218 | KBUILD_HOST := $(BUILD_PLATFORM) | 
|---|
| 219 | endif | 
|---|
| 220 | ifndef KBUILD_HOST_ARCH | 
|---|
| 221 | KBUILD_HOST_ARCH := $(BUILD_PLATFORM_ARCH) | 
|---|
| 222 | endif | 
|---|
| 223 | ifndef KBUILD_HOST_CPU | 
|---|
| 224 | KBUILD_HOST_CPU := $(BUILD_PLATFORM_CPU) | 
|---|
| 225 | endif | 
|---|
| 226 |  | 
|---|
| 227 |  | 
|---|
| 228 | # | 
|---|
| 229 | # Assert valid build platform variables. | 
|---|
| 230 | # | 
|---|
| 231 | # All these are set by kmk so they shouldn't be any trouble | 
|---|
| 232 | # unless the user starts messing about with environment variables. | 
|---|
| 233 | # | 
|---|
| 234 | ifneq (.$(words $(KBUILD_HOST)).$(KBUILD_HOST).,.1.$(strip $(KBUILD_HOST)).) | 
|---|
| 235 | $(error kBuild: The KBUILD_HOST value '$(KBUILD_HOST)' contains spaces/tabs!) | 
|---|
| 236 | endif | 
|---|
| 237 | ifneq ($(words $(filter $(KBUILD_HOST),$(KBUILD_OSES))),1) | 
|---|
| 238 | $(error kBuild: KBUILD_HOST value '$(KBUILD_HOST)' is not recognized (valid: $(KBUILD_OSES))) | 
|---|
| 239 | endif | 
|---|
| 240 |  | 
|---|
| 241 | ifneq (.$(words $(KBUILD_HOST_ARCH)).$(KBUILD_HOST_ARCH).,.1.$(strip $(KBUILD_HOST_ARCH)).) | 
|---|
| 242 | $(error kBuild: The KBUILD_HOST_ARCH value '$(KBUILD_HOST_ARCH)' contains spaces/tabs!) | 
|---|
| 243 | endif | 
|---|
| 244 | ifneq ($(words $(filter $(KBUILD_HOST_ARCH),$(KBUILD_ARCHES))),1) | 
|---|
| 245 | $(error kBuild: KBUILD_HOST_ARCH value '$(KBUILD_HOST_ARCH)' is not recognized (valid: $(KBUILD_ARCHES))) | 
|---|
| 246 | endif | 
|---|
| 247 |  | 
|---|
| 248 | ifeq ($(strip $(KBUILD_HOST_CPU)),) | 
|---|
| 249 | KBUILD_HOST_CPU := blend | 
|---|
| 250 | else | 
|---|
| 251 | ifneq (.$(words $(KBUILD_HOST_CPU)).$(KBUILD_HOST_CPU).,.1.$(strip $(KBUILD_HOST_CPU)).) | 
|---|
| 252 | $(error kBuild: The KBUILD_HOST_CPU value '$(KBUILD_HOST_CPU)' contains spaces/tabs!) | 
|---|
| 253 | endif | 
|---|
| 254 | if1of ($(KBUILD_HOST_CPU), $(KBUILD_OSES) $(BUILD_ARCHES)) | 
|---|
| 255 | $(error kBuild: The KBUILD_HOST_CPU value '$(KBUILD_HOST_CPU)' was found in the OS or architecture keywords!) | 
|---|
| 256 | endif | 
|---|
| 257 | ifeq ($(KBUILD_HOST_CPU),$(KBUILD_TYPE)) | 
|---|
| 258 | $(error kBuild: The KBUILD_HOST_CPU value '$(KBUILD_HOST_CPU)' is the same as the KBUILD_TYPE!) | 
|---|
| 259 | endif | 
|---|
| 260 | endif | 
|---|
| 261 |  | 
|---|
| 262 |  | 
|---|
| 263 | # | 
|---|
| 264 | # Deal with target platform legacy. | 
|---|
| 265 | # | 
|---|
| 266 | ifndef KBUILD_TARGET | 
|---|
| 267 | ifdef BUILD_TARGET | 
|---|
| 268 | KBUILD_TARGET := $(BUILD_TARGET) | 
|---|
| 269 | endif | 
|---|
| 270 | else ifdef BUILD_TARGET | 
|---|
| 271 | ifneq ($(KBUILD_TARGET),$(BUILD_TARGET)) | 
|---|
| 272 | ifeq ($(origin KBUILD_TARGET):$(origin BUILD_TARGET),environment:command line) | 
|---|
| 273 | KBUILD_TARGET := $(BUILD_TARGET) | 
|---|
| 274 | else ifneq ($(origin KBUILD_TARGET):$(origin BUILD_TARGET),command line:environment) | 
|---|
| 275 | $(error kBuild: KBUILD_TARGET and BUILD_TARGET disagree) | 
|---|
| 276 | endif | 
|---|
| 277 | endif | 
|---|
| 278 | endif | 
|---|
| 279 | override BUILD_TARGET = $(KBUILD_TARGET) | 
|---|
| 280 |  | 
|---|
| 281 | ifndef KBUILD_TARGET_ARCH | 
|---|
| 282 | ifdef BUILD_TARGET_ARCH | 
|---|
| 283 | KBUILD_TARGET_ARCH := $(BUILD_TARGET_ARCH) | 
|---|
| 284 | endif | 
|---|
| 285 | else ifdef BUILD_TARGET_ARCH | 
|---|
| 286 | ifneq ($(KBUILD_TARGET_ARCH),$(BUILD_TARGET_ARCH)) | 
|---|
| 287 | ifeq ($(origin KBUILD_TARGET_ARCH):$(origin BUILD_TARGET_ARCH),environment:command line) | 
|---|
| 288 | KBUILD_TARGET_ARCH := $(BUILD_TARGET_ARCH) | 
|---|
| 289 | else ifneq ($(origin KBUILD_TARGET_ARCH):$(origin BUILD_TARGET_ARCH),command line:environment) | 
|---|
| 290 | $(error kBuild: KBUILD_TARGET_ARCH and BUILD_TARGET_ARCH disagree) | 
|---|
| 291 | endif | 
|---|
| 292 | endif | 
|---|
| 293 | endif | 
|---|
| 294 | override BUILD_TARGET_ARCH = $(KBUILD_TARGET_ARCH) | 
|---|
| 295 |  | 
|---|
| 296 | ifndef KBUILD_TARGET_CPU | 
|---|
| 297 | ifdef BUILD_TARGET_CPU | 
|---|
| 298 | KBUILD_TARGET_CPU := $(BUILD_TARGET_CPU) | 
|---|
| 299 | endif | 
|---|
| 300 | else ifdef BUILD_TARGET_CPU | 
|---|
| 301 | ifneq ($(KBUILD_TARGET_CPU),$(BUILD_TARGET_CPU)) | 
|---|
| 302 | ifeq ($(origin KBUILD_TARGET_CPU):$(origin BUILD_TARGET_CPU),environment:command line) | 
|---|
| 303 | KBUILD_TARGET_CPU := $(BUILD_TARGET_CPU) | 
|---|
| 304 | else ifneq ($(origin KBUILD_TARGET_CPU):$(origin BUILD_TARGET_CPU),command line:environment) | 
|---|
| 305 | $(error kBuild: KBUILD_TARGET_CPU and BUILD_TARGET_CPU disagree) | 
|---|
| 306 | endif | 
|---|
| 307 | endif | 
|---|
| 308 | endif | 
|---|
| 309 | override BUILD_TARGET_CPU = $(KBUILD_TARGET_CPU) | 
|---|
| 310 |  | 
|---|
| 311 |  | 
|---|
| 312 | # | 
|---|
| 313 | # Assert or set default target platform. | 
|---|
| 314 | # When not defined use the corresponding KBUILD_HOST value. | 
|---|
| 315 | # | 
|---|
| 316 | ifndef KBUILD_TARGET | 
|---|
| 317 | KBUILD_TARGET := $(KBUILD_HOST) | 
|---|
| 318 | else | 
|---|
| 319 | ifneq (.$(words $(KBUILD_TARGET)).$(KBUILD_TARGET).,.1.$(strip $(KBUILD_TARGET)).) | 
|---|
| 320 | $(error kBuild: The KBUILD_TARGET value '$(KBUILD_TARGET)' contains spaces/tabs!) | 
|---|
| 321 | endif | 
|---|
| 322 | ifneq ($(words $(filter $(KBUILD_TARGET),$(KBUILD_OSES))),1) | 
|---|
| 323 | $(error kBuild: KBUILD_TARGET value '$(KBUILD_TARGET)' is not recognized (valid: $(KBUILD_OSES))) | 
|---|
| 324 | endif | 
|---|
| 325 | endif | 
|---|
| 326 |  | 
|---|
| 327 | ifndef KBUILD_TARGET_ARCH | 
|---|
| 328 | KBUILD_TARGET_ARCH := $(KBUILD_HOST_ARCH) | 
|---|
| 329 | else | 
|---|
| 330 | ifneq (.$(words $(KBUILD_TARGET_ARCH)).$(KBUILD_TARGET_ARCH).,.1.$(strip $(KBUILD_TARGET_ARCH)).) | 
|---|
| 331 | $(error kBuild: The KBUILD_TARGET_ARCH value '$(KBUILD_TARGET_ARCH)' contains spaces/tabs!) | 
|---|
| 332 | endif | 
|---|
| 333 | ifneq ($(words $(filter $(KBUILD_TARGET_ARCH),$(KBUILD_ARCHES))),1) | 
|---|
| 334 | $(error kBuild: KBUILD_TARGET_ARCH value '$(KBUILD_TARGET_ARCH)' is not recognized (valid: $(KBUILD_ARCHES))) | 
|---|
| 335 | endif | 
|---|
| 336 | endif | 
|---|
| 337 |  | 
|---|
| 338 | ifndef KBUILD_TARGET_CPU | 
|---|
| 339 | KBUILD_TARGET_CPU := $(KBUILD_HOST_CPU) | 
|---|
| 340 | else ifeq ($(strip $(KBUILD_TARGET_CPU)),) | 
|---|
| 341 | ifeq ($(KBUILD_TARGET_ARCH),$(KBUILD_HOST_ARCH)) | 
|---|
| 342 | KBUILD_TARGET_CPU := $(KBUILD_HOST_CPU) | 
|---|
| 343 | else | 
|---|
| 344 | KBUILD_TARGET_CPU := blend | 
|---|
| 345 | endif | 
|---|
| 346 | else | 
|---|
| 347 | ifneq (.$(words $(KBUILD_TARGET_CPU)).$(KBUILD_TARGET_CPU).,.1.$(strip $(KBUILD_TARGET_CPU)).) | 
|---|
| 348 | $(error kBuild: The KBUILD_TARGET_CPU value '$(KBUILD_TARGET_CPU)' contains spaces/tabs!) | 
|---|
| 349 | endif | 
|---|
| 350 | if1of ($(KBUILD_TARGET_CPU), $(KBUILD_OSES) $(BUILD_ARCHES)) | 
|---|
| 351 | $(error kBuild: The KBUILD_TARGET_CPU value was found in the OS or architecture keywords!) | 
|---|
| 352 | endif | 
|---|
| 353 | ifeq ($(KBUILD_TARGET_CPU),$(KBUILD_TYPE)) | 
|---|
| 354 | $(error kBuild: The KBUILD_TARGET_CPU value '$(KBUILD_TARGET_CPU)' is the same as the KBUILD_TYPE!) | 
|---|
| 355 | endif | 
|---|
| 356 | endif | 
|---|
| 357 |  | 
|---|
| 358 |  | 
|---|
| 359 | # | 
|---|
| 360 | # Paths and stuff. | 
|---|
| 361 | # | 
|---|
| 362 |  | 
|---|
| 363 | # Adjust DEPTH first. | 
|---|
| 364 | DEPTH := $(strip $(DEPTH)) | 
|---|
| 365 | ifeq ($(DEPTH),) | 
|---|
| 366 | DEPTH := . | 
|---|
| 367 | endif | 
|---|
| 368 |  | 
|---|
| 369 | ## PATH_CURRENT is the current directory (getcwd). | 
|---|
| 370 | PATH_CURRENT        := $(abspath $(CURDIR)) | 
|---|
| 371 | ## PATH_SUB_CURRENT points to current directory of the current makefile. | 
|---|
| 372 | # Meaning that it will change value as we enter and exit sub-makefiles. | 
|---|
| 373 | PATH_SUB_CURRENT    := $(PATH_CURRENT) | 
|---|
| 374 | ## PATH_ROOT points to the project root directory. | 
|---|
| 375 | PATH_ROOT           := $(abspath $(PATH_CURRENT)/$(DEPTH)) | 
|---|
| 376 | ## PATH_SUB_ROOT points to the directory of the top-level makefile. | 
|---|
| 377 | ifneq ($(strip $(SUB_DEPTH)),) | 
|---|
| 378 | SUB_DEPTH          := $(strip $(SUB_DEPTH)) | 
|---|
| 379 | PATH_SUB_ROOT      := $(abspath $(PATH_CURRENT)/$(SUB_DEPTH)) | 
|---|
| 380 | else | 
|---|
| 381 | PATH_SUB_ROOT      := $(PATH_CURRENT) | 
|---|
| 382 | endif | 
|---|
| 383 |  | 
|---|
| 384 | ## CURSUBDIR is PATH_SUB_ROOT described relative to PATH_ROOT. | 
|---|
| 385 | # This variable is used to determin where the object files and other output goes. | 
|---|
| 386 | ifneq ($(PATH_ROOT),$(PATH_SUB_ROOT)) | 
|---|
| 387 | CURSUBDIR          := $(patsubst $(PATH_ROOT)/%,%,$(PATH_SUB_ROOT)) | 
|---|
| 388 | else | 
|---|
| 389 | CURSUBDIR          := . | 
|---|
| 390 | endif | 
|---|
| 391 |  | 
|---|
| 392 | # Output directories. | 
|---|
| 393 | ifndef PATH_OUT_BASE | 
|---|
| 394 | PATH_OUT_BASE      := $(PATH_ROOT)/out | 
|---|
| 395 | endif | 
|---|
| 396 | ifndef PATH_OUT | 
|---|
| 397 | ifdef BUILD_TARGET_SUB # (BUILD_TARGET_SUB is not currently recognized by kBuild in any other places - obsolete) | 
|---|
| 398 | PATH_OUT           = $(PATH_OUT_BASE)/$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH).$(BUILD_TARGET_SUB)/$(KBUILD_TYPE) | 
|---|
| 399 | else | 
|---|
| 400 | PATH_OUT           = $(PATH_OUT_BASE)/$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)/$(KBUILD_TYPE) | 
|---|
| 401 | endif | 
|---|
| 402 | endif # !define PATH_OUT | 
|---|
| 403 | PATH_OBJCACHE        = $(PATH_OUT_BASE)/kObjCache | 
|---|
| 404 | PATH_OBJ             = $(PATH_OUT)/obj | 
|---|
| 405 | PATH_TARGET          = $(PATH_OBJ)/$(CURSUBDIR) | 
|---|
| 406 | PATH_INS             = $(PATH_OUT) | 
|---|
| 407 | PATH_BIN             = $(PATH_INS)/bin | 
|---|
| 408 | PATH_DLL             = $(PATH_INS)/bin | 
|---|
| 409 | PATH_SYS             = $(PATH_INS)/bin | 
|---|
| 410 | PATH_LIB             = $(PATH_INS)/lib | 
|---|
| 411 | PATH_DOC             = $(PATH_INS)/doc | 
|---|
| 412 |  | 
|---|
| 413 | # KBUILD_PATH / PATH_KBUILD is determined by kmk. | 
|---|
| 414 | ifndef KBUILD_PATH | 
|---|
| 415 | KBUILD_PATH := $(PATH_KBUILD) | 
|---|
| 416 | endif | 
|---|
| 417 | ifeq ($(strip $(KBUILD_PATH)),) | 
|---|
| 418 | $(error kBuild: KBUILD_PATH is missing or empty! kmk is supposed to set it.) | 
|---|
| 419 | endif | 
|---|
| 420 | # KBUILD_BIN_PATH / PATH_KBUILD_BIN is determined by kmk. | 
|---|
| 421 | ifndef KBUILD_BIN_PATH | 
|---|
| 422 | KBUILD_BIN_PATH := $(PATH_KBUILD_BIN) | 
|---|
| 423 | endif | 
|---|
| 424 | ifeq ($(strip $(KBUILD_BIN_PATH)),) | 
|---|
| 425 | $(error kBuild: KBUILD_BIN_PATH is missing or empty! kmk is supposed to set it.) | 
|---|
| 426 | endif | 
|---|
| 427 |  | 
|---|
| 428 | # kBuild files which might be of interest. | 
|---|
| 429 | FILE_KBUILD_HEADER := $(KBUILD_PATH)/header.kmk | 
|---|
| 430 | #FILE_KBUILD_CONFIG := $(KBUILD_PATH)/config.kmk | 
|---|
| 431 | FILE_KBUILD_FOOTER := $(KBUILD_PATH)/footer.kmk | 
|---|
| 432 | FILE_KBUILD_SUB_HEADER := $(KBUILD_PATH)/subheader.kmk | 
|---|
| 433 | FILE_KBUILD_SUB_FOOTER := $(KBUILD_PATH)/subfooter.kmk | 
|---|
| 434 |  | 
|---|
| 435 | ## MAKEFILE is the name of the main makefile. | 
|---|
| 436 | MAKEFILE            := $(firstword $(MAKEFILE_LIST)) | 
|---|
| 437 | ## MAKEFILE_CURRENT is the name of the current makefile. | 
|---|
| 438 | # This is updated everything a sub-makefile is included. | 
|---|
| 439 | MAKEFILE_CURRENT    := $(MAKEFILE) | 
|---|
| 440 |  | 
|---|
| 441 |  | 
|---|
| 442 | ## @todo this should be done via SUFF_XYZ.target/host... | 
|---|
| 443 |  | 
|---|
| 444 | # | 
|---|
| 445 | # Build platform setup. | 
|---|
| 446 | # (PORTME) | 
|---|
| 447 | # | 
|---|
| 448 | if1of ($(KBUILD_HOST), win nt) | 
|---|
| 449 | # Win, Win32, Win64, NT. | 
|---|
| 450 | EXEC_X86_WIN32      := | 
|---|
| 451 | HOSTSUFF_EXE        := .exe | 
|---|
| 452 |  | 
|---|
| 453 | # OS/2. | 
|---|
| 454 | else ifeq ($(KBUILD_HOST),os2) | 
|---|
| 455 | EXEC_X86_WIN32      := innopec.exe | 
|---|
| 456 | HOSTSUFF_EXE        := .exe | 
|---|
| 457 |  | 
|---|
| 458 | else if1of ($(KBUILD_HOST), freebsd dragonfly linux openbsd netbsd) | 
|---|
| 459 | # Unix (like) systems with wine. | 
|---|
| 460 | EXEC_X86_WIN32      := wine | 
|---|
| 461 | HOSTSUFF_EXE        := | 
|---|
| 462 |  | 
|---|
| 463 | else | 
|---|
| 464 | # Unix (like) systems without wine. | 
|---|
| 465 | EXEC_X86_WIN32      := false | 
|---|
| 466 | HOSTSUFF_EXE        := | 
|---|
| 467 | endif | 
|---|
| 468 |  | 
|---|
| 469 |  | 
|---|
| 470 | # | 
|---|
| 471 | # Build target setup. | 
|---|
| 472 | # (PORTME) | 
|---|
| 473 | # | 
|---|
| 474 | SUFF_DEP    := .dep | 
|---|
| 475 | if1of ($(KBUILD_TARGET), win nt os2) | 
|---|
| 476 | SUFF_OBJ    := .obj | 
|---|
| 477 | SUFF_LIB    := .lib | 
|---|
| 478 | SUFF_DLL    := .dll | 
|---|
| 479 | SUFF_EXE    := .exe | 
|---|
| 480 | SUFF_SYS    := .sys | 
|---|
| 481 | SUFF_RES    := .res | 
|---|
| 482 | else ifeq ($(KBUILD_TARGET),l4) | 
|---|
| 483 | SUFF_OBJ    := .o | 
|---|
| 484 | SUFF_LIB    := .a | 
|---|
| 485 | SUFF_DLL    := .s.so | 
|---|
| 486 | SUFF_EXE    := | 
|---|
| 487 | SUFF_SYS    := .a | 
|---|
| 488 | SUFF_RES    := | 
|---|
| 489 | else ifeq ($(KBUILD_TARGET),darwin) | 
|---|
| 490 | SUFF_OBJ    := .o | 
|---|
| 491 | SUFF_LIB    := .a | 
|---|
| 492 | SUFF_DLL    := .dylib | 
|---|
| 493 | SUFF_EXE    := | 
|---|
| 494 | SUFF_SYS    := | 
|---|
| 495 | SUFF_RES    := | 
|---|
| 496 | else | 
|---|
| 497 | SUFF_OBJ    := .o | 
|---|
| 498 | SUFF_LIB    := .a | 
|---|
| 499 | SUFF_DLL    := .so | 
|---|
| 500 | SUFF_EXE    := | 
|---|
| 501 | if1of ($(KBUILD_TARGET), dragonfly freebsd linux netbsd openbsd) ## @todo check netbsd and openbsd. | 
|---|
| 502 | SUFF_SYS    := .ko | 
|---|
| 503 | else | 
|---|
| 504 | SUFF_SYS    := | 
|---|
| 505 | endif | 
|---|
| 506 | SUFF_RES    := | 
|---|
| 507 | endif | 
|---|
| 508 |  | 
|---|
| 509 | # | 
|---|
| 510 | # Standard kBuild tools. | 
|---|
| 511 | # | 
|---|
| 512 | ifeq ($(KMK),kmk) | 
|---|
| 513 | KMK         := $(KBUILD_BIN_PATH)/kmk$(HOSTSUFF_EXE) | 
|---|
| 514 | endif | 
|---|
| 515 | MAKE        := $(KMK) | 
|---|
| 516 |  | 
|---|
| 517 | GMAKE       := $(KBUILD_BIN_PATH)/kmk_gmake$(HOSTSUFF_EXE) | 
|---|
| 518 |  | 
|---|
| 519 | DEP_EXT     := $(KBUILD_BIN_PATH)/kDep$(HOSTSUFF_EXE) | 
|---|
| 520 | if1of (kDep, $(KMK_BUILTIN)) | 
|---|
| 521 | DEP         := kmk_builtin_kDep | 
|---|
| 522 | else | 
|---|
| 523 | DEP         := $(DEP_EXT) | 
|---|
| 524 | endif | 
|---|
| 525 |  | 
|---|
| 526 | DEP_IDB_EXT := $(KBUILD_BIN_PATH)/kDepIDB$(HOSTSUFF_EXE) | 
|---|
| 527 | if1of (kDepIDB, $(KMK_BUILTIN)) | 
|---|
| 528 | DEP_IDB     := kmk_builtin_kDepIDB | 
|---|
| 529 | else | 
|---|
| 530 | DEP_IDB     := $(DEP_IDB_EXT) | 
|---|
| 531 | endif | 
|---|
| 532 |  | 
|---|
| 533 | DEP_PRE_EXT := $(KBUILD_BIN_PATH)/kDepPre$(HOSTSUFF_EXE) | 
|---|
| 534 | if1of (kDepPre, $(KMK_BUILTIN)) | 
|---|
| 535 | DEP_PRE     := kmk_builtin_kDepPre | 
|---|
| 536 | else | 
|---|
| 537 | DEP_PRE     := $(DEP_PRE_EXT) | 
|---|
| 538 | endif | 
|---|
| 539 |  | 
|---|
| 540 | KOBJCACHE_EXT := $(KBUILD_BIN_PATH)/kObjCache$(HOSTSUFF_EXE) | 
|---|
| 541 | if1of (kObjCache, $(KMK_BUILTIN)) | 
|---|
| 542 | KOBJCACHE   := kmk_builtin_kObjCache | 
|---|
| 543 | else | 
|---|
| 544 | KOBJCACHE   := $(KOBJCACHE_EXT) | 
|---|
| 545 | endif | 
|---|
| 546 |  | 
|---|
| 547 | APPEND_EXT  := $(KBUILD_BIN_PATH)/kmk_append$(HOSTSUFF_EXE) | 
|---|
| 548 | APPEND      := kmk_builtin_append | 
|---|
| 549 |  | 
|---|
| 550 | CAT_EXT     := $(KBUILD_BIN_PATH)/kmk_cat$(HOSTSUFF_EXE) | 
|---|
| 551 | CAT         := kmk_builtin_cat | 
|---|
| 552 |  | 
|---|
| 553 | CHMOD_EXT   := $(KBUILD_BIN_PATH)/kmk_chmod$(HOSTSUFF_EXE) | 
|---|
| 554 | CHMOD       := kmk_builtin_chmod | 
|---|
| 555 |  | 
|---|
| 556 | CMP_EXT     := $(KBUILD_BIN_PATH)/kmk_cmp$(HOSTSUFF_EXE) | 
|---|
| 557 | CMP         := kmk_builtin_cmp | 
|---|
| 558 |  | 
|---|
| 559 | CP_EXT      := $(KBUILD_BIN_PATH)/kmk_cp$(HOSTSUFF_EXE) | 
|---|
| 560 | CP          := kmk_builtin_cp | 
|---|
| 561 |  | 
|---|
| 562 | ECHO_EXT    := $(KBUILD_BIN_PATH)/kmk_echo$(HOSTSUFF_EXE) | 
|---|
| 563 | ECHO        := kmk_builtin_echo | 
|---|
| 564 |  | 
|---|
| 565 | EXPR_EXT    := $(KBUILD_BIN_PATH)/kmk_expr$(HOSTSUFF_EXE) | 
|---|
| 566 | EXPR        := kmk_builtin_expr | 
|---|
| 567 |  | 
|---|
| 568 | INSTALL_EXT := $(KBUILD_BIN_PATH)/kmk_install$(HOSTSUFF_EXE) | 
|---|
| 569 | INSTALL     := kmk_builtin_install | 
|---|
| 570 |  | 
|---|
| 571 | LN_EXT      := $(KBUILD_BIN_PATH)/kmk_ln$(HOSTSUFF_EXE) | 
|---|
| 572 | LN          := kmk_builtin_ln | 
|---|
| 573 |  | 
|---|
| 574 | MD5SUM_EXT  := $(KBUILD_BIN_PATH)/kmk_md5sum$(HOSTSUFF_EXE) | 
|---|
| 575 | MD5SUM      := kmk_builtin_md5sum | 
|---|
| 576 |  | 
|---|
| 577 | MKDIR_EXT   := $(KBUILD_BIN_PATH)/kmk_mkdir$(HOSTSUFF_EXE) | 
|---|
| 578 | MKDIR       := kmk_builtin_mkdir | 
|---|
| 579 |  | 
|---|
| 580 | MV_EXT      := $(KBUILD_BIN_PATH)/kmk_mv$(HOSTSUFF_EXE) | 
|---|
| 581 | MV          := kmk_builtin_mv | 
|---|
| 582 |  | 
|---|
| 583 | PRINTF_EXT  := $(KBUILD_BIN_PATH)/kmk_printf$(HOSTSUFF_EXE) | 
|---|
| 584 | PRINTF      := kmk_builtin_printf | 
|---|
| 585 |  | 
|---|
| 586 | REDIRECT_EXT:= $(KBUILD_BIN_PATH)/kmk_redirect$(HOSTSUFF_EXE) | 
|---|
| 587 | if1of (redirect, $(KMK_BUILTIN)) | 
|---|
| 588 | REDIRECT    := kmk_builtin_redirect | 
|---|
| 589 | else | 
|---|
| 590 | REDIRECT    := $(REDIRECT_EXT) | 
|---|
| 591 | endif | 
|---|
| 592 |  | 
|---|
| 593 | RM_EXT      := $(KBUILD_BIN_PATH)/kmk_rm$(HOSTSUFF_EXE) | 
|---|
| 594 | RM          := kmk_builtin_rm | 
|---|
| 595 |  | 
|---|
| 596 | RMDIR_EXT   := $(KBUILD_BIN_PATH)/kmk_rmdir$(HOSTSUFF_EXE) | 
|---|
| 597 | RMDIR       := kmk_builtin_rmdir | 
|---|
| 598 |  | 
|---|
| 599 | SED_EXT     := $(KBUILD_BIN_PATH)/kmk_sed$(HOSTSUFF_EXE) | 
|---|
| 600 | if1of (sed, $(KMK_BUILTIN)) | 
|---|
| 601 | SED_INT     := kmk_builtin_sed | 
|---|
| 602 | else | 
|---|
| 603 | SED_INT     := $(SED_EXT) | 
|---|
| 604 | endif | 
|---|
| 605 | SED         := $(SED_EXT) | 
|---|
| 606 |  | 
|---|
| 607 | TEST_EXT    := $(KBUILD_BIN_PATH)/kmk_test$(HOSTSUFF_EXE) | 
|---|
| 608 | TEST        := kmk_builtin_test | 
|---|
| 609 |  | 
|---|
| 610 | # Our default shell is the Almquist shell from *BSD. | 
|---|
| 611 | ASH         := $(KBUILD_BIN_PATH)/kmk_ash$(HOSTSUFF_EXE) | 
|---|
| 612 | MAKESHELL   := $(ASH) | 
|---|
| 613 | SHELL       := $(ASH) | 
|---|
| 614 | export SHELL MAKESHELL | 
|---|
| 615 |  | 
|---|
| 616 | # Symlinking is problematic on some platforms... | 
|---|
| 617 | LN_SYMLINK  := $(LN) -s | 
|---|
| 618 |  | 
|---|
| 619 |  | 
|---|
| 620 | # | 
|---|
| 621 | # Some Functions. | 
|---|
| 622 | # The lower cased ones are either fallbacks or candidates for functions.c. | 
|---|
| 623 | # | 
|---|
| 624 |  | 
|---|
| 625 | ## ABSPATH - make paths absolute. | 
|---|
| 626 | # This implementation is clumsy and doesn't resolve '..' and '.' components. | 
|---|
| 627 | # | 
|---|
| 628 | # @param        $1      The paths to make absolute. | 
|---|
| 629 | # @obsolete Use the GNU make function $(abspath) directly now. | 
|---|
| 630 | ABSPATH = $(abspath $(1))$(warning ABSPATH is deprecated, use abspath directly!) | 
|---|
| 631 |  | 
|---|
| 632 | ## DIRDEP - make create directory dependencies. | 
|---|
| 633 | # | 
|---|
| 634 | # @param        $1      The paths to the directories which must be created. | 
|---|
| 635 | DIRDEP = $(foreach path,$(patsubst %/,%,$(1)),$(path)/) | 
|---|
| 636 |  | 
|---|
| 637 | ## Cygwin kludge. | 
|---|
| 638 | # This converts /cygdrive/x/% to x:%. | 
|---|
| 639 | # | 
|---|
| 640 | # @param        $1      The paths to make native. | 
|---|
| 641 | # @remark       This macro is pretty much obsolete since we don't use cygwin base make. | 
|---|
| 642 | ifneq ($(patsubst /cygdrive/%,%,$(CURDIR)),$(CURDIR)) | 
|---|
| 643 | CYGPATHMIXED = $(foreach path,$(1)\ | 
|---|
| 644 | ,$(if $(patsubst /cygdrive/%,,$(path)),$(path),$(patsubst $(strip $(firstword $(subst /, ,$(patsubst /cygdrive/%,%,$(path)))))/%,$(strip $(firstword $(subst /, ,$(patsubst /cygdrive/%,%,$(path))))):/%,$(patsubst /cygdrive/%,%,$(path))))) | 
|---|
| 645 | else | 
|---|
| 646 | CYGPATHMIXED = $(1) | 
|---|
| 647 | endif | 
|---|
| 648 |  | 
|---|
| 649 | ## Removes the drive letter from a path (if it has one) | 
|---|
| 650 | # @param        $1              the path | 
|---|
| 651 | no-drive    = $(word $(words $(subst :, ,$(1))),$(subst :, ,$(1))) | 
|---|
| 652 |  | 
|---|
| 653 | ## Removes the root slash from a path (if it has one) | 
|---|
| 654 | # @param        $1              the path | 
|---|
| 655 | no-root-slash = $(patsubst /%,%,$(1)) | 
|---|
| 656 |  | 
|---|
| 657 | ## Figure out where to put object files. | 
|---|
| 658 | # @param    $1      real target name. | 
|---|
| 659 | # @param    $2      normalized main target | 
|---|
| 660 | TARGET_BASE = $(PATH_TARGET)/$(2)/$(call no-root-slash,$(call no-drive,$(1))) | 
|---|
| 661 |  | 
|---|
| 662 | ## Figure out where to put object files. | 
|---|
| 663 | # @param    $1      normalized main target | 
|---|
| 664 | TARGET_PATH = $(PATH_TARGET)/$(1) | 
|---|
| 665 |  | 
|---|
| 666 |  | 
|---|
| 667 | # | 
|---|
| 668 | # Initialize some of the globals which the Config.kmk and | 
|---|
| 669 | # others can add stuff to if they like for processing in the footer. | 
|---|
| 670 | # | 
|---|
| 671 |  | 
|---|
| 672 | ## KBUILD_TEMPLATE_PATHS | 
|---|
| 673 | # List a paths (separated by space) where templates can be found. | 
|---|
| 674 | KBUILD_TEMPLATE_PATHS := | 
|---|
| 675 |  | 
|---|
| 676 | ## KBUILD_TOOL_PATHS | 
|---|
| 677 | # List of paths (separated by space) where tools can be found. | 
|---|
| 678 | KBUILD_TOOL_PATHS := | 
|---|
| 679 |  | 
|---|
| 680 | ## KBUILD_SDK_PATHS | 
|---|
| 681 | # List of paths (separated by space) where SDKs can be found. | 
|---|
| 682 | KBUILD_SDK_PATHS := | 
|---|
| 683 |  | 
|---|
| 684 | ## KBUILD_UNIT_PATHS | 
|---|
| 685 | # List of paths (separated by space) where units (USES) can be found. | 
|---|
| 686 | KBUILD_UNIT_PATHS := | 
|---|
| 687 |  | 
|---|
| 688 | ## KBUILD_DEFAULT_PATHS | 
|---|
| 689 | # List of paths (separated by space) to search for stuff as a last resort. | 
|---|
| 690 | KBUILD_DEFAULT_PATHS := | 
|---|
| 691 |  | 
|---|
| 692 | ## Proritized list of the default makefile when walking subdirectories. | 
|---|
| 693 | # The user can overload this list. | 
|---|
| 694 | DEFAULT_MAKEFILE := Makefile.kmk makefile.kmk Makefile makefile | 
|---|
| 695 |  | 
|---|
| 696 | ## KBUILD_SRC_HANDLERS | 
|---|
| 697 | # The list of source handlers, pair of extension and handler. | 
|---|
| 698 | # The user can overload this list to provide additional or custom | 
|---|
| 699 | # handlers. On a per-target/template see SRC_HANDLERS. | 
|---|
| 700 | KBUILD_SRC_HANDLERS := \ | 
|---|
| 701 | .c:def_src_handler_c \ | 
|---|
| 702 | .C:def_src_handler_c \ | 
|---|
| 703 | .cxx:def_src_handler_cxx \ | 
|---|
| 704 | .CXX:def_src_handler_cxx \ | 
|---|
| 705 | .cpp:def_src_handler_cxx \ | 
|---|
| 706 | .CPP:def_src_handler_cxx \ | 
|---|
| 707 | .cc:def_src_handler_cxx \ | 
|---|
| 708 | .CC:def_src_handler_cxx \ | 
|---|
| 709 | .m:def_src_handler_objc \ | 
|---|
| 710 | .asm:def_src_handler_asm \ | 
|---|
| 711 | .ASM:def_src_handler_asm \ | 
|---|
| 712 | .s:def_src_handler_asm \ | 
|---|
| 713 | .S:def_src_handler_asm \ | 
|---|
| 714 | .rc:def_src_handler_rc \ | 
|---|
| 715 | .obj:def_src_handler_obj \ | 
|---|
| 716 | .o:def_src_handler_obj \ | 
|---|
| 717 | .res:def_src_handler_obj | 
|---|
| 718 |  | 
|---|
| 719 | ## PROPS_TOOLS | 
|---|
| 720 | # This is a subset of PROPS_SINGLE. | 
|---|
| 721 | PROPS_TOOLS := TOOL CTOOL CXXTOOL OBJCTOOL ASTOOL RCTOOL ARTOOL LDTOOL LEXTOOL FETCHTOOL UNPACKTOOL PATCHTOOL | 
|---|
| 722 |  | 
|---|
| 723 | ## PROPS_SINGLE | 
|---|
| 724 | # The list of non-accumulative target properties. | 
|---|
| 725 | # A Config.kmk file can add it's own properties to this list and kBuild | 
|---|
| 726 | # will do the necessary inheritance for templates, sdks, tools and targets. | 
|---|
| 727 | PROPS_SINGLE := $(PROPS_TOOLS) TEMPLATE INST NOINST BLD_TYPE BLD_TRG BLD_TRG_ARCH BLD_TRG_CPU FETCHDIR \ | 
|---|
| 728 | OBJSUFF COBJSUFF CXXOBJSUFF OBJCOBJSUFF ASOBJSUFF RCOBJSUFF SYSSUFF EXESUFF DLLSUFF LIBSUFF ARLIBSUFF | 
|---|
| 729 | ## PROPS_SINGLE_LNK | 
|---|
| 730 | # Subset of PROPS_SINGLE which applies to all linkable targets. | 
|---|
| 731 | PROPS_SINGLE_LNK := TOOL TEMPLATE CTOOL CXXTOOL OBJCTOOL ASTOOL RCTOOL \ | 
|---|
| 732 | INST NOINST BLD_TYPE BLD_TRG BLD_TRG_ARCH BLD_TRG_CPU \ | 
|---|
| 733 | OBJSUFF COBJSUFF CXXOBJSUFF OBJCOBJSUFF ASOBJSUFF RCOBJSUFF | 
|---|
| 734 |  | 
|---|
| 735 | ## PROPS_DEFERRED | 
|---|
| 736 | # This list of non-accumulative target properties which are or may be | 
|---|
| 737 | # functions, and thus should not be expanded until the very last moment. | 
|---|
| 738 | PROPS_DEFERRED := INSTFUN INSTALLER PRE_CMDS POST_CMDS NAME SONAME | 
|---|
| 739 |  | 
|---|
| 740 | ## PROPS_ACCUMULATE_R | 
|---|
| 741 | # The list of accumulative target properties where the right most value/flag | 
|---|
| 742 | # is the 'most significant'. | 
|---|
| 743 | # A Config.kmk file can add it's own properties to this list and kBuild | 
|---|
| 744 | # will do the necessary inheritance from templates to targets. | 
|---|
| 745 | PROPS_ACCUMULATE_R := \ | 
|---|
| 746 | DEPS LNK_DEPS ORDERDEPS LNK_ORDERDEPS DEFS \ | 
|---|
| 747 | ARFLAGS \ | 
|---|
| 748 | CFLAGS CDEFS \ | 
|---|
| 749 | CXXFLAGS CXXDEFS \ | 
|---|
| 750 | OBJCFLAGS OBJCDEFS \ | 
|---|
| 751 | ASFLAGS ASDEFS \ | 
|---|
| 752 | RCFLAGS RCDEFS \ | 
|---|
| 753 | LDFLAGS \ | 
|---|
| 754 | IDFLAGS IFDLAGS ISFLAGS \ | 
|---|
| 755 | FETCHFLAGS UNPACKFLAGS PATCHFLAGS | 
|---|
| 756 | ## PROPS_ACCUMULATE_R_LNK | 
|---|
| 757 | # Subset of PROPS_ACCUMULATE_R which applies to all linkable targets. | 
|---|
| 758 | PROPS_ACCUMULATE_R_LNK := \ | 
|---|
| 759 | DEPS LNK_DEPS ORDERDEPS LNK_ORDERDEPS DEFS \ | 
|---|
| 760 | CFLAGS CDEFS \ | 
|---|
| 761 | CXXFLAGS CXXDEFS \ | 
|---|
| 762 | OBJCFLAGS OBJCDEFS \ | 
|---|
| 763 | ASFLAGS ASDEFS \ | 
|---|
| 764 | RCFLAGS RCDEFS \ | 
|---|
| 765 | IDFLAGS IFDLAGS ISFLAGS | 
|---|
| 766 |  | 
|---|
| 767 | ## PROPS_ACCUMULATE | 
|---|
| 768 | # The list of accumulative target properties where the left most value/flag | 
|---|
| 769 | # is the 'most significant'. | 
|---|
| 770 | # A Config.kmk file can add it's own properties to this list and kBuild | 
|---|
| 771 | # will do the necessary inheritance from templates to targets. | 
|---|
| 772 | PROPS_ACCUMULATE_L := \ | 
|---|
| 773 | SDKS USES SOURCES SRC_HANDLERS INTERMEDIATES \ | 
|---|
| 774 | INCS CINCS CXXINCS OBJCINCS ASINCS RCINCS \ | 
|---|
| 775 | LIBS LIBPATH \ | 
|---|
| 776 | DIRS BLDDIRS CLEAN | 
|---|
| 777 | ## PROPS_ACCUMULATE_L_LNK | 
|---|
| 778 | # Subset of PROPS_ACCUMULATE_L which applies to all linkable targets. | 
|---|
| 779 | PROPS_ACCUMULATE_L_LNK := \ | 
|---|
| 780 | SDKS SOURCES SRC_HANDLERS \ | 
|---|
| 781 | INCS CINCS CXXINCS OBJCINCS ASINCS RCINCS \ | 
|---|
| 782 | BLDDIRS CLEAN | 
|---|
| 783 |  | 
|---|
| 784 | ## PROPS_ALL | 
|---|
| 785 | # List of all the properties. | 
|---|
| 786 | PROPS_ALL = $(PROPS_SINGLE) $(PROPS_DEFERRED) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) | 
|---|
| 787 |  | 
|---|
| 788 |  | 
|---|
| 789 | ## @name Properties valid on programs (BLDPROGS and PROGRAMS) | 
|---|
| 790 | ## @{ | 
|---|
| 791 | PROPS_PROGRAMS_SINGLE        := $(PROPS_SINGLE_LNK) LDTOOL EXESUFF | 
|---|
| 792 | PROPS_PROGRAMS_DEFERRED      := $(PROPS_DEFERRED) | 
|---|
| 793 | PROPS_PROGRAMS_ACCUMULATE_R  := $(PROPS_ACCUMULATE_R_LNK) LDFLAGS | 
|---|
| 794 | PROPS_PROGRAMS_ACCUMULATE_L  := $(PROPS_ACCUMULATE_L_LNK) LIBS LIBPATH | 
|---|
| 795 | ## @} | 
|---|
| 796 |  | 
|---|
| 797 | ## @name Properties valid on libraries (LIBRARIES and IMPORT_LIBS) | 
|---|
| 798 | ## @{ | 
|---|
| 799 | PROPS_LIBRARIES_SINGLE       := $(PROPS_SINGLE_LNK) ARTOOL LIBSUFF ARLIBSUFF LIBSUFF | 
|---|
| 800 | PROPS_LIBRARIES_DEFERRED     := $(filter-out SONAME,$(PROPS_DEFERRED)) | 
|---|
| 801 | PROPS_LIBRARIES_ACCUMULATE_R := $(PROPS_ACCUMULATE_R_LNK) ARFLAGS | 
|---|
| 802 | PROPS_LIBRARIES_ACCUMULATE_L := $(PROPS_ACCUMULATE_L_LNK) | 
|---|
| 803 | ## @} | 
|---|
| 804 |  | 
|---|
| 805 | ## @name Properties valid on dlls (DLLS) | 
|---|
| 806 | ## @{ | 
|---|
| 807 | PROPS_DLLS_SINGLE            := $(PROPS_SINGLE_LNK) LDTOOL DLLSUFF LIBSUFF | 
|---|
| 808 | PROPS_DLLS_DEFERRED          := $(PROPS_DEFERRED) | 
|---|
| 809 | PROPS_DLLS_ACCUMULATE_R      := $(PROPS_ACCUMULATE_R_LNK) LDFLAGS | 
|---|
| 810 | PROPS_DLLS_ACCUMULATE_L      := $(PROPS_ACCUMULATE_L_LNK) LIBS LIBPATH | 
|---|
| 811 | ## @} | 
|---|
| 812 |  | 
|---|
| 813 | ## @name Properties valid on system modules (SYSMODS) | 
|---|
| 814 | ## @{ | 
|---|
| 815 | PROPS_SYSMODS_SINGLE         := $(PROPS_SINGLE_LNK) LDTOOL SYSSUFF | 
|---|
| 816 | PROPS_SYSMODS_DEFERRED       := $(PROPS_DEFERRED) | 
|---|
| 817 | PROPS_SYSMODS_ACCUMULATE_R   := $(PROPS_ACCUMULATE_R_LNK) LDFLAGS | 
|---|
| 818 | PROPS_SYSMODS_ACCUMULATE_L   := $(PROPS_ACCUMULATE_L_LNK) LIBS LIBPATH | 
|---|
| 819 | ## @} | 
|---|
| 820 |  | 
|---|
| 821 | ## @name Properties valid on installs (INSTALLS) | 
|---|
| 822 | ## @{ | 
|---|
| 823 | PROPS_INSTALLS_SINGLE        := TOOL TEMPLATE INST NOINST | 
|---|
| 824 | PROPS_INSTALLS_DEFERRED      := INSTFUN INSTALLER | 
|---|
| 825 | PROPS_INSTALLS_ACCUMULATE_R  := DEPS ORDERDEPS | 
|---|
| 826 | PROPS_INSTALLS_ACCUMULATE_L  := SOURCES DIRS CLEAN | 
|---|
| 827 | ## @} | 
|---|
| 828 |  | 
|---|
| 829 | ## @name Properties valid on fetches (INSTALLS) | 
|---|
| 830 | ## @{ | 
|---|
| 831 | PROPS_FETCHES_SINGLE         := TOOL TEMPLATE FETCHTOOL UNPACKTOOL PATCHTOOL INST FETCHDIR | 
|---|
| 832 | PROPS_FETCHES_DEFERRED       := | 
|---|
| 833 | PROPS_FETCHES_ACCUMULATE_R   := FETCHFLAGS UNPACKFLAGS PATCHFLAGS | 
|---|
| 834 | PROPS_FETCHES_ACCUMULATE_L   := SOURCES CLEAN | 
|---|
| 835 | ## @} | 
|---|
| 836 |  | 
|---|
| 837 |  | 
|---|
| 838 | # | 
|---|
| 839 | # Here is a special 'hack' to prevent innocent environment variables being | 
|---|
| 840 | # picked up and treated as properties. (The most annoying example of why | 
|---|
| 841 | # this is necessary is the Visual C++ commandline with it's LIBPATH.) | 
|---|
| 842 | # | 
|---|
| 843 | # Define KBUILD_DONT_KILL_ENV_PROPS in the env. or on the commandline to | 
|---|
| 844 | # disable this 'hack'. | 
|---|
| 845 | # | 
|---|
| 846 | ifndef KBUILD_DONT_KILL_ENV_PROPS | 
|---|
| 847 |  | 
|---|
| 848 | define def_nuke_environment_prop | 
|---|
| 849 | ifeq ($(origin $(prop)),environment) | 
|---|
| 850 | $(prop) = | 
|---|
| 851 | endif | 
|---|
| 852 | endef | 
|---|
| 853 | $(foreach prop, $(PROPS_ALL) \ | 
|---|
| 854 | FETCHES PATCHES BLDPROGS LIBRARIES IMPORT_LIBS DLLS PROGRAMS SYSMODS INSTALLS OTHERS \ | 
|---|
| 855 | SUBDIRS MAKEFILES BLDDIRS \ | 
|---|
| 856 | ,$(eval $(value def_nuke_environment_prop))) | 
|---|
| 857 |  | 
|---|
| 858 | endif # KBUILD_DONT_KILL_ENV_PROPS | 
|---|
| 859 |  | 
|---|
| 860 |  | 
|---|
| 861 | # | 
|---|
| 862 | # Pass configuration. | 
|---|
| 863 | # | 
|---|
| 864 | # The PASS_<passname>_trgs variable is listing the targets. | 
|---|
| 865 | # The PASS_<passname>_vars variable is listing the target variables. | 
|---|
| 866 | # The PASS_<passname>_pass variable is the lowercased passname. | 
|---|
| 867 | # | 
|---|
| 868 |  | 
|---|
| 869 | ## PASS: fetches | 
|---|
| 870 | # This pass fetches and unpacks things needed to complete the build. | 
|---|
| 871 | PASS_FETCHES        := Fetches | 
|---|
| 872 | PASS_FETCHES_trgs   := | 
|---|
| 873 | PASS_FETCHES_vars   := _FETCHES | 
|---|
| 874 | PASS_FETCHES_pass   := fetches | 
|---|
| 875 |  | 
|---|
| 876 | ## PASS: patches | 
|---|
| 877 | # This pass applies patches. | 
|---|
| 878 | PASS_PATCHES        := Patches | 
|---|
| 879 | PASS_PATCHES_trgs   := | 
|---|
| 880 | PASS_PATCHES_vars   := _PATCHES | 
|---|
| 881 | PASS_PATCHES_pass   := patches | 
|---|
| 882 |  | 
|---|
| 883 | ## PASS: bldprogs | 
|---|
| 884 | # This pass builds targets which are required for building the rest. | 
|---|
| 885 | PASS_BLDPROGS       := Build Programs | 
|---|
| 886 | PASS_BLDPROGS_trgs  := | 
|---|
| 887 | PASS_BLDPROGS_vars  := _BLDPROGS | 
|---|
| 888 | PASS_BLDPROGS_pass  := bldprogs | 
|---|
| 889 |  | 
|---|
| 890 | ## PASS: libraries | 
|---|
| 891 | # This pass builds library targets. | 
|---|
| 892 | PASS_LIBRARIES      := Libraries | 
|---|
| 893 | PASS_LIBRARIES_trgs := | 
|---|
| 894 | PASS_LIBRARIES_vars := _LIBS _IMPORT_LIBS _OTHER_LIBRARIES | 
|---|
| 895 | PASS_LIBRARIES_pass := libraries | 
|---|
| 896 |  | 
|---|
| 897 | ## PASS: binaries | 
|---|
| 898 | # This pass builds dll targets. | 
|---|
| 899 | PASS_DLLS           := DLLs | 
|---|
| 900 | PASS_DLLS_trgs      := | 
|---|
| 901 | PASS_DLLS_vars      := _DLLS _OTHER_DLLS | 
|---|
| 902 | PASS_DLLS_pass      := dlls | 
|---|
| 903 |  | 
|---|
| 904 | ## PASS: binaries | 
|---|
| 905 | # This pass builds binary targets, i.e. programs, system modules and stuff. | 
|---|
| 906 | PASS_BINARIES       := Programs | 
|---|
| 907 | PASS_BINARIES_trgs  := | 
|---|
| 908 | PASS_BINARIES_vars  := _PROGRAMS _SYSMODS _OTHER_BINARIES | 
|---|
| 909 | PASS_BINARIES_pass  := binaries | 
|---|
| 910 |  | 
|---|
| 911 | ## PASS: others | 
|---|
| 912 | # This pass builds other targets. | 
|---|
| 913 | PASS_OTHERS         := Other Stuff | 
|---|
| 914 | PASS_OTHERS_trgs    := | 
|---|
| 915 | PASS_OTHERS_vars    := _OTHERS | 
|---|
| 916 | PASS_OTHERS_pass    := others | 
|---|
| 917 |  | 
|---|
| 918 | ## PASS: install | 
|---|
| 919 | # This pass installs the built entities to a sandbox area. | 
|---|
| 920 | ## @todo split this up into build install (to sandbox) and real installation. | 
|---|
| 921 | PASS_INSTALLS       := Install | 
|---|
| 922 | PASS_INSTALLS_trgs  := | 
|---|
| 923 | PASS_INSTALLS_vars  := _INSTALLS_DIRS _INSTALLS _INSTALLS_FILES | 
|---|
| 924 | PASS_INSTALLS_pass  := installs | 
|---|
| 925 |  | 
|---|
| 926 | ## PASS: testing | 
|---|
| 927 | # This pass processes custom rules for executing tests. | 
|---|
| 928 | PASS_TESTING        := Tests | 
|---|
| 929 | PASS_TESTING_trgs   := | 
|---|
| 930 | PASS_TESTING_vars   := _TESTING | 
|---|
| 931 | PASS_TESTING_pass   := testing | 
|---|
| 932 | # aliases | 
|---|
| 933 | .PHONY: check test | 
|---|
| 934 | check test: pass_testing | 
|---|
| 935 |  | 
|---|
| 936 | ## PASS: packing | 
|---|
| 937 | # This pass processes custom packing rules. | 
|---|
| 938 | PASS_PACKING        := Packing | 
|---|
| 939 | PASS_PACKING_trgs   := | 
|---|
| 940 | PASS_PACKING_vars   := _PACKING | 
|---|
| 941 | PASS_PACKING_pass   := packing | 
|---|
| 942 | # alias | 
|---|
| 943 | .PHONY: packing | 
|---|
| 944 | packing: pass_packing | 
|---|
| 945 |  | 
|---|
| 946 | ## PASS: clean | 
|---|
| 947 | # This pass removes all generated files. | 
|---|
| 948 | PASS_CLEAN          := Clean | 
|---|
| 949 | PASS_CLEAN_trgs     := do-clean | 
|---|
| 950 | PASS_CLEAN_vars     := | 
|---|
| 951 | PASS_CLEAN_pass     := clean | 
|---|
| 952 | # alias | 
|---|
| 953 | .PHONY: clean | 
|---|
| 954 | clean: pass_clean | 
|---|
| 955 |  | 
|---|
| 956 | ## PASS: nothing | 
|---|
| 957 | # This pass just walks the tree. | 
|---|
| 958 | PASS_NOTHING        := Nothing | 
|---|
| 959 | PASS_NOTHING_trgs   := do-nothing | 
|---|
| 960 | PASS_NOTHING_vars   := | 
|---|
| 961 | PASS_NOTHING_pass   := nothing | 
|---|
| 962 | # alias | 
|---|
| 963 | .PHONY: nothing | 
|---|
| 964 | nothing: pass_nothing | 
|---|
| 965 |  | 
|---|
| 966 | ## DEFAULT_PASSES | 
|---|
| 967 | # The default passes and their order. | 
|---|
| 968 | DEFAULT_PASSES := BLDPROGS LIBRARIES DLLS BINARIES OTHERS INSTALLS | 
|---|
| 969 |  | 
|---|
| 970 | ## PASSES | 
|---|
| 971 | # The passes that should be defined. This must include | 
|---|
| 972 | # all passes mentioned by DEFAULT_PASSES. | 
|---|
| 973 | PASSES := FETCHES PATCHES $(DEFAULT_PASSES) TESTING PACKING CLEAN NOTHING | 
|---|
| 974 |  | 
|---|
| 975 |  | 
|---|
| 976 | # | 
|---|
| 977 | # Check for --pretty-command-printing before including the Config.kmk | 
|---|
| 978 | # so that anyone overriding the message macros can take the implied | 
|---|
| 979 | # verbosity level change into account. | 
|---|
| 980 | # | 
|---|
| 981 | ifndef KBUILD_VERBOSE | 
|---|
| 982 | ifndef KBUILD_QUIET | 
|---|
| 983 | ifeq ($(KMK_OPTS_PRETTY_COMMAND_PRINTING),1) | 
|---|
| 984 | export KBUILD_VERBOSE := 2 | 
|---|
| 985 | endif | 
|---|
| 986 | endif | 
|---|
| 987 | endif | 
|---|
| 988 |  | 
|---|
| 989 |  | 
|---|
| 990 | # | 
|---|
| 991 | # Legacy variable translation. | 
|---|
| 992 | # These will be eliminated when switching to the next version. | 
|---|
| 993 | # | 
|---|
| 994 | ifdef USE_KOBJCACHE | 
|---|
| 995 | ifndef KBUILD_USE_KOBJCACHE | 
|---|
| 996 | export KBUILD_USE_KOBJCACHE := $(USE_KOBJCACHE) | 
|---|
| 997 | endif | 
|---|
| 998 | endif | 
|---|
| 999 |  | 
|---|
| 1000 |  | 
|---|
| 1001 | # | 
|---|
| 1002 | # This is how we find the closest config.kmk. | 
|---|
| 1003 | # It's a little hacky but I think it works fine. | 
|---|
| 1004 | # | 
|---|
| 1005 | _CFGDIR     := . | 
|---|
| 1006 | _CFGFILES   := ./Config.kmk ./config.kmk | 
|---|
| 1007 | define def_include_config | 
|---|
| 1008 | $(eval _CFGDIR := $(_CFGDIR)/$(dir)) | 
|---|
| 1009 | _CFGFILES   += $(_CFGDIR)/Config.kmk $(_CFGDIR)/config.kmk | 
|---|
| 1010 | endef | 
|---|
| 1011 | # walk down the _RELATIVE_ path specified by DEPTH. | 
|---|
| 1012 | $(foreach dir,$(subst /, ,$(DEPTH)), $(eval $(def_include_config)) ) | 
|---|
| 1013 | # add the default config file. | 
|---|
| 1014 | _CFGFILE    := $(firstword $(wildcard $(_CFGFILES) $(FILE_KBUILD_CONFIG))) | 
|---|
| 1015 | _CFGFILES   := | 
|---|
| 1016 | _CFGDIR     := | 
|---|
| 1017 | ifeq ($(_CFGFILE),) | 
|---|
| 1018 | $(error kBuild: no Config.kmk file found! Check the DEPTH: DEPTH='$(DEPTH)' PATH_CURRENT='$(PATH_CURRENT)') | 
|---|
| 1019 | endif | 
|---|
| 1020 |  | 
|---|
| 1021 | # Include the config.kmk we found file (or the default one). | 
|---|
| 1022 | ifdef KBUILD_PROFILE_SELF | 
|---|
| 1023 | $(evalcall def_profile_self, including $(_CFGFILE)) | 
|---|
| 1024 | include $(_CFGFILE) | 
|---|
| 1025 | $(evalcall def_profile_self, included $(_CFGFILE)) | 
|---|
| 1026 | else | 
|---|
| 1027 | include $(_CFGFILE) | 
|---|
| 1028 | endif | 
|---|
| 1029 |  | 
|---|
| 1030 |  | 
|---|
| 1031 |  | 
|---|
| 1032 | # | 
|---|
| 1033 | # Finalize a the central path variables now that we've included the Config.kmk file. | 
|---|
| 1034 | # | 
|---|
| 1035 | # This prevents some trouble when users override the defaults for these | 
|---|
| 1036 | # variables and uses relative paths or paths with incorrect case. | 
|---|
| 1037 | # | 
|---|
| 1038 | PATH_OUT_BASE := $(abspath $(PATH_OUT_BASE)) | 
|---|
| 1039 | PATH_OUT    := $(abspath $(PATH_OUT)) | 
|---|
| 1040 | PATH_OBJ    := $(abspath $(PATH_OBJ)) | 
|---|
| 1041 | PATH_TARGET := $(abspath $(PATH_TARGET)) | 
|---|
| 1042 | PATH_INS    := $(abspath $(PATH_INS)) | 
|---|
| 1043 | PATH_BIN    := $(abspath $(PATH_BIN)) | 
|---|
| 1044 | PATH_DLL    := $(abspath $(PATH_DLL)) | 
|---|
| 1045 | PATH_SYS    := $(abspath $(PATH_SYS)) | 
|---|
| 1046 | PATH_LIB    := $(abspath $(PATH_LIB)) | 
|---|
| 1047 | PATH_DOC    := $(abspath $(PATH_DOC)) | 
|---|
| 1048 |  | 
|---|
| 1049 |  | 
|---|
| 1050 | # | 
|---|
| 1051 | # Setup the message style. The default one is inlined. | 
|---|
| 1052 | # | 
|---|
| 1053 | # See kBuild/msgstyles for more styles or use KBUILD_MSG_STYLE_PATHS | 
|---|
| 1054 | # to create your own message style. | 
|---|
| 1055 | # | 
|---|
| 1056 | KBUILD_MSG_STYLE ?= default | 
|---|
| 1057 | ifeq ($(KBUILD_MSG_STYLE),default) | 
|---|
| 1058 | # | 
|---|
| 1059 | # The 'default' style. | 
|---|
| 1060 | # | 
|---|
| 1061 |  | 
|---|
| 1062 | ## Fetch starting. | 
|---|
| 1063 | # @param 1     Target name. | 
|---|
| 1064 | MSG_FETCH    ?= $(call MSG_L1,Fetching $1...) | 
|---|
| 1065 | ## Re-fetch starting. | 
|---|
| 1066 | # @param 1     Target name. | 
|---|
| 1067 | MSG_REFETCH  ?= $(call MSG_L1,Re-fetching $1...) | 
|---|
| 1068 | ## Downloading a fetch component. | 
|---|
| 1069 | # @param 1     Target name. | 
|---|
| 1070 | # @param 2     The source URL. | 
|---|
| 1071 | # @param 3     The destination file name. | 
|---|
| 1072 | MSG_FETCH_DL ?= $(call MSG_L1,Downloading $1 - $2,=> $3) | 
|---|
| 1073 | ## Checking a fetch component. | 
|---|
| 1074 | # @param 1     Target name. | 
|---|
| 1075 | # @param 2     The source URL. | 
|---|
| 1076 | # @param 3     The destination file name. | 
|---|
| 1077 | MSG_FETCH_CHK?= $(call MSG_L1,Checking $1 - $3, ($2)) | 
|---|
| 1078 | ## Unpacking a fetch component. | 
|---|
| 1079 | # @param 1     Target name. | 
|---|
| 1080 | # @param 2     The archive file name. | 
|---|
| 1081 | # @param 3     The target directory. | 
|---|
| 1082 | MSG_FETCH_UP ?= $(call MSG_L1,Unpacking $1 - $2 => $3) | 
|---|
| 1083 | ## Fetch completed. | 
|---|
| 1084 | # @param 1     Target name. | 
|---|
| 1085 | MSG_FETCH_OK ?= $(call MSG_L1,Successfully fetched $1) | 
|---|
| 1086 | ## Unfetch a fetch target. | 
|---|
| 1087 | # @param 1     Target name. | 
|---|
| 1088 | MSG_UNFETCH  ?= $(call MSG_L1,Unfetching $1...) | 
|---|
| 1089 | ## Compiling a source file. | 
|---|
| 1090 | # @param 1     Target name. | 
|---|
| 1091 | # @param 2     The source filename. | 
|---|
| 1092 | # @param 3     The primary link output file name. | 
|---|
| 1093 | # @param 4     The source type (C,CXX,OBJC,AS,RC,++). | 
|---|
| 1094 | MSG_COMPILE  ?= $(call MSG_L1,Compiling $1 - $2,=> $3) | 
|---|
| 1095 | ## Tool | 
|---|
| 1096 | # @param 1     The tool name (bin2c,...) | 
|---|
| 1097 | # @param 2     Target name. | 
|---|
| 1098 | # @param 3     The source filename. | 
|---|
| 1099 | # @param 4     The primary output file name. | 
|---|
| 1100 | MSG_TOOL     ?= $(call MSG_L1,$1 $2 - $3,=> $4) | 
|---|
| 1101 | ## Generate a file, typically a source file. | 
|---|
| 1102 | # @param 1     Target name if applicable. | 
|---|
| 1103 | # @param 2     Output file name. | 
|---|
| 1104 | # @param 3     What it's generated from | 
|---|
| 1105 | MSG_GENERATE ?= $(call MSG_L1,Generating $(if $1,$1 - )$2,$(if $3,from $3)) | 
|---|
| 1106 | ## Linking a bldprog/dll/program/sysmod target. | 
|---|
| 1107 | # @param 1     Target name. | 
|---|
| 1108 | # @param 2     The primary link output file name. | 
|---|
| 1109 | # @param 3     The link tool operation (LINK_LIBRARY,LINK_PROGRAM,LINK_DLL,LINK_SYSMOD,++). | 
|---|
| 1110 | MSG_LINK     ?= $(call MSG_L1,Linking $1,=> $2) | 
|---|
| 1111 | ## Merging a library into the target (during library linking). | 
|---|
| 1112 | # @param 1     Target name. | 
|---|
| 1113 | # @param 2     The output library name. | 
|---|
| 1114 | # @param 3     The input library name. | 
|---|
| 1115 | MSG_AR_MERGE ?= $(call MSG_L1,Merging $3 into $1, ($2)) | 
|---|
| 1116 | ## Creating a directory (build). | 
|---|
| 1117 | # @param 1     Directory name. | 
|---|
| 1118 | MSG_MKDIR    ?= $(call MSG_L2,Creating directory $1) | 
|---|
| 1119 | ## Cleaning. | 
|---|
| 1120 | MSG_CLEAN    ?= $(call MSG_L1,Cleaning...) | 
|---|
| 1121 | ## Nothing. | 
|---|
| 1122 | MSG_NOTHING  ?= $(call MSG_L1,Did nothing in $(CURDIR)) | 
|---|
| 1123 | ## Pass | 
|---|
| 1124 | # @param 1     The pass name. | 
|---|
| 1125 | MSG_PASS     ?= $(call MSG_L1,Pass - $1) | 
|---|
| 1126 | ## Installing a bldprog/lib/dll/program/sysmod target. | 
|---|
| 1127 | # @param 1     Target name. | 
|---|
| 1128 | # @param 2     The source filename. | 
|---|
| 1129 | # @param 3     The destination file name. | 
|---|
| 1130 | MSG_INST_TRG ?= $(call MSG_L1,Installing $1 => $3) | 
|---|
| 1131 | ## Installing a file (install target). | 
|---|
| 1132 | # @param 1     The source filename. | 
|---|
| 1133 | # @param 2     The destination filename. | 
|---|
| 1134 | MSG_INST_FILE?= $(call MSG_L1,Installing $2,(<= $1)) | 
|---|
| 1135 | ## Installing a symlink. | 
|---|
| 1136 | # @param 1     Symlink | 
|---|
| 1137 | # @param 2     Link target | 
|---|
| 1138 | MSG_INST_SYM ?= $(call MSG_L1,Installing symlink $1,=> $2) | 
|---|
| 1139 | ## Installing a directory. | 
|---|
| 1140 | # @param 1     Directory name. | 
|---|
| 1141 | MSG_INST_DIR ?= $(call MSG_L1,Installing directory $1) | 
|---|
| 1142 |  | 
|---|
| 1143 | else | 
|---|
| 1144 | _KBUILD_MSG_STYLE_FILE := $(firstword $(foreach path, $(KBUILD_MSG_STYLE_PATHS) $(KBUILD_PATH)/msgstyles, $(wildcard $(path)/$(KBUILD_MSG_STYLE).kmk))) | 
|---|
| 1145 | ifneq ($(_KBUILD_MSG_STYLE_FILE),) | 
|---|
| 1146 | include $(_KBUILD_MSG_STYLE_FILE) | 
|---|
| 1147 | else | 
|---|
| 1148 | $(error kBuild: Can't find the style setup file for KBUILD_MSG_STYLE '$(KBUILD_MSG_STYLE)') | 
|---|
| 1149 | endif | 
|---|
| 1150 | endif | 
|---|
| 1151 |  | 
|---|
| 1152 |  | 
|---|
| 1153 | # | 
|---|
| 1154 | # Message macros. | 
|---|
| 1155 | # | 
|---|
| 1156 | # This is done after including Config.kmk as to allow for | 
|---|
| 1157 | # KBUILD_QUIET and KBUILD_VERBOSE to be configurable. | 
|---|
| 1158 | # | 
|---|
| 1159 | ifdef KBUILD_QUIET | 
|---|
| 1160 | # No output | 
|---|
| 1161 | QUIET := @ | 
|---|
| 1162 | QUIET2:= @ | 
|---|
| 1163 | MSG_L1 = | 
|---|
| 1164 | MSG_L2 = | 
|---|
| 1165 | else | 
|---|
| 1166 | ifndef KBUILD_VERBOSE | 
|---|
| 1167 | # Default output level. | 
|---|
| 1168 | QUIET  := @ | 
|---|
| 1169 | QUIET2 := @ | 
|---|
| 1170 | MSG_L1 ?= %@$(ECHO) "kBuild: $1" | 
|---|
| 1171 | MSG_L2  = | 
|---|
| 1172 | else ifeq ($(KBUILD_VERBOSE),1) | 
|---|
| 1173 | # A bit more output | 
|---|
| 1174 | QUIET  := @ | 
|---|
| 1175 | QUIET2 := @ | 
|---|
| 1176 | MSG_L1 ?= %@$(ECHO) "kBuild: $1 $2" | 
|---|
| 1177 | MSG_L2  = | 
|---|
| 1178 | else ifeq ($(KBUILD_VERBOSE),2) | 
|---|
| 1179 | # Lot more output | 
|---|
| 1180 | QUIET  := | 
|---|
| 1181 | QUIET2 := @ | 
|---|
| 1182 | MSG_L1 ?= %@$(ECHO) "kBuild: $1 $2" | 
|---|
| 1183 | MSG_L2 ?= %@$(ECHO) "kBuild: $1" | 
|---|
| 1184 | else | 
|---|
| 1185 | # maximal output. | 
|---|
| 1186 | QUIET  := | 
|---|
| 1187 | QUIET2 := | 
|---|
| 1188 | MSG_L1 ?= %@$(ECHO) "kBuild: $1 $2" | 
|---|
| 1189 | MSG_L2 ?= %@$(ECHO) "kBuild: $1" | 
|---|
| 1190 | endif | 
|---|
| 1191 | endif | 
|---|
| 1192 |  | 
|---|
| 1193 |  | 
|---|
| 1194 | # | 
|---|
| 1195 | # Validate any KBUILD_BLD_TYPES additions and finally the KBUILD_TYPE. | 
|---|
| 1196 | # | 
|---|
| 1197 | if1of ($(KBUILD_BLD_TYPES), $(KBUILD_OSES)) | 
|---|
| 1198 | $(error kBuild: found KBUILD_BLD_TYPES in KBUILD_OSES!) | 
|---|
| 1199 | endif | 
|---|
| 1200 | if1of ($(KBUILD_BLD_TYPES), $(KBUILD_ARCHES)) | 
|---|
| 1201 | $(error kBuild: found KBUILD_BLD_TYPES in KBUILD_ARCHES!) | 
|---|
| 1202 | endif | 
|---|
| 1203 | if1of ($(KBUILD_OSES), $(KBUILD_ARCHES)) | 
|---|
| 1204 | $(error kBuild: found KBUILD_OSES in KBUILD_ARCHES!) | 
|---|
| 1205 | endif | 
|---|
| 1206 | ifn1of ($(KBUILD_TYPE), $(KBUILD_BLD_TYPES)) | 
|---|
| 1207 | $(error kBuild: KBUILD_TYPE(=$(KBUILD_TYPE)) is not found in KBUILD_BLD_TYPES(=$(KBUILD_BLD_TYPES))!) | 
|---|
| 1208 | endif | 
|---|
| 1209 |  | 
|---|
| 1210 |  | 
|---|
| 1211 |  | 
|---|
| 1212 | ifdef KBUILD_PROFILE_SELF | 
|---|
| 1213 | $(evalcall def_profile_self, end of header.kmk) | 
|---|
| 1214 | _KBUILD_TS_HEADER_END := $(_KBUILD_TS_PREV) | 
|---|
| 1215 | endif | 
|---|
| 1216 |  | 
|---|
| 1217 | # end-of-file-content | 
|---|
| 1218 | __header_kmk__ := 1 | 
|---|
| 1219 | endif # __header_kmk__ | 
|---|
| 1220 |  | 
|---|
| 1221 |  | 
|---|