source: trunk/kBuild/header.kmk@ 1418

Last change on this file since 1418 was 1418, checked in by bird, 17 years ago

USE_KOBJCACHE -> KBUILD_USE_KOBJCACHE.

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