source: trunk/kBuild/header.kmk@ 1410

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

Added KBUILD_BLD_TYPES for the valid build types and the corresponding tests of BUILD_TYPE ++.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id Revision
File size: 30.9 KB
Line 
1# $Id: header.kmk 1403 2008-03-16 23:34:00Z 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: 1403 $ )
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## TEMPLATE_PATHS
567# List a paths (separated by space) where templates can be found.
568TEMPLATE_PATHS :=
569
570## TOOL_PATHS
571# List of paths (separated by space) where tools can be found.
572TOOL_PATHS :=
573
574## SDK_PATHS
575# List of paths (separated by space) where SDKs can be found.
576SDK_PATHS :=
577
578## Proritized list of the default makefile when walking subdirectories.
579# The user can overload this list.
580DEFAULT_MAKEFILE := Makefile.kmk makefile.kmk Makefile makefile
581
582
583## PROPS_TOOLS
584# This is a subset of PROPS_SINGLE.
585PROPS_TOOLS := TOOL CTOOL CXXTOOL OBJCTOOL ASTOOL RCTOOL ARTOOL LDTOOL FETCHTOOL UNPACKTOOL PATCHTOOL
586
587## PROPS_SINGLE
588# The list of non-accumulative target properties.
589# A Config.kmk file can add it's own properties to this list and kBuild
590# will do the necessary inheritance for templates, sdks, tools and targets.
591PROPS_SINGLE := $(PROPS_TOOLS) TEMPLATE INST NOINST BLD_TYPE BLD_TRG BLD_TRG_ARCH BLD_TRG_CPU FETCHDIR \
592 OBJSUFF COBJSUFF CXXOBJSUFF OBJCOBJSUFF ASOBJSUFF RCOBJSUFF SYSSUFF EXESUFF DLLSUFF LIBSUFF ARLIBSUFF
593## PROPS_SINGLE_LNK
594# Subset of PROPS_SINGLE which applies to all linkable targets.
595PROPS_SINGLE_LNK := TOOL TEMPLATE CTOOL CXXTOOL OBJCTOOL ASTOOL RCTOOL \
596 INST NOINST BLD_TYPE BLD_TRG BLD_TRG_ARCH BLD_TRG_CPU \
597 OBJSUFF COBJSUFF CXXOBJSUFF OBJCOBJSUFF ASOBJSUFF RCOBJSUFF
598
599## PROPS_DEFERRED
600# This list of non-accumulative target properties which are or may be
601# functions, and thus should not be expanded until the very last moment.
602PROPS_DEFERRED := INSTFUN INSTALLER PRE_CMDS POST_CMDS NAME SONAME
603
604## PROPS_ACCUMULATE_R
605# The list of accumulative target properties where the right most value/flag
606# is the 'most significant'.
607# A Config.kmk file can add it's own properties to this list and kBuild
608# will do the necessary inheritance from templates to targets.
609PROPS_ACCUMULATE_R := \
610 DEPS ORDERDEPS DEFS \
611 ARFLAGS \
612 CFLAGS CDEFS \
613 CXXFLAGS CXXDEFS \
614 OBJCFLAGS OBJCDEFS \
615 ASFLAGS ASDEFS \
616 RCFLAGS RCDEFS \
617 LDFLAGS \
618 IDFLAGS IFDLAGS ISFLAGS \
619 FETCHFLAGS UNPACKFLAGS PATCHFLAGS
620## PROPS_ACCUMULATE_R_LNK
621# Subset of PROPS_ACCUMULATE_R which applies to all linkable targets.
622PROPS_ACCUMULATE_R_LNK := \
623 DEPS ORDERDEPS DEFS \
624 CFLAGS CDEFS \
625 CXXFLAGS CXXDEFS \
626 OBJCFLAGS OBJCDEFS \
627 ASFLAGS ASDEFS \
628 RCFLAGS RCDEFS \
629 IDFLAGS IFDLAGS ISFLAGS
630
631## PROPS_ACCUMULATE
632# The list of accumulative target properties where the left most value/flag
633# is the 'most significant'.
634# A Config.kmk file can add it's own properties to this list and kBuild
635# will do the necessary inheritance from templates to targets.
636PROPS_ACCUMULATE_L := \
637 SDKS SOURCES \
638 INCS CINCS CXXINCS OBJCINCS ASINCS RCINCS \
639 LIBS LIBPATH \
640 DIRS BLDDIRS CLEAN
641## PROPS_ACCUMULATE_L_LNK
642# Subset of PROPS_ACCUMULATE_L which applies to all linkable targets.
643PROPS_ACCUMULATE_L_LNK := \
644 SDKS SOURCES \
645 INCS CINCS CXXINCS OBJCINCS ASINCS RCINCS \
646 BLDDIRS CLEAN
647
648## PROPS_ALL
649# List of all the properties.
650PROPS_ALL = $(PROPS_SINGLE) $(PROPS_DEFERRED) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R)
651
652
653## @name Properties valid on programs (BLDPROGS and PROGRAMS)
654## @{
655PROPS_PROGRAMS_SINGLE := $(PROPS_SINGLE_LNK) LDTOOL EXESUFF
656PROPS_PROGRAMS_DEFERRED := $(PROPS_DEFERRED)
657PROPS_PROGRAMS_ACCUMULATE_R := $(PROPS_ACCUMULATE_R_LNK) LDFLAGS
658PROPS_PROGRAMS_ACCUMULATE_L := $(PROPS_ACCUMULATE_L_LNK) LIBS LIBPATH
659## @}
660
661## @name Properties valid on libraries (LIBRARIES and IMPORT_LIBS)
662## @{
663PROPS_LIBRARIES_SINGLE := $(PROPS_SINGLE_LNK) ARTOOL LIBSUFF ARLIBSUFF LIBSUFF
664PROPS_LIBRARIES_DEFERRED := $(filter-out SONAME,$(PROPS_DEFERRED))
665PROPS_LIBRARIES_ACCUMULATE_R := $(PROPS_ACCUMULATE_R_LNK) ARFLAGS
666PROPS_LIBRARIES_ACCUMULATE_L := $(PROPS_ACCUMULATE_L_LNK)
667## @}
668
669## @name Properties valid on dlls (DLLS)
670## @{
671PROPS_DLLS_SINGLE := $(PROPS_SINGLE_LNK) LDTOOL DLLSUFF LIBSUFF
672PROPS_DLLS_DEFERRED := $(PROPS_DEFERRED)
673PROPS_DLLS_ACCUMULATE_R := $(PROPS_ACCUMULATE_R_LNK) LDFLAGS
674PROPS_DLLS_ACCUMULATE_L := $(PROPS_ACCUMULATE_L_LNK) LIBS LIBPATH
675## @}
676
677## @name Properties valid on system modules (SYSMODS)
678## @{
679PROPS_SYSMODS_SINGLE := $(PROPS_SINGLE_LNK) LDTOOL SYSSUFF
680PROPS_SYSMODS_DEFERRED := $(PROPS_DEFERRED)
681PROPS_SYSMODS_ACCUMULATE_R := $(PROPS_ACCUMULATE_R_LNK) LDFLAGS
682PROPS_SYSMODS_ACCUMULATE_L := $(PROPS_ACCUMULATE_L_LNK) LIBS LIBPATH
683## @}
684
685## @name Properties valid on installs (INSTALLS)
686## @{
687PROPS_INSTALLS_SINGLE := TOOL TEMPLATE INST NOINST
688PROPS_INSTALLS_DEFERRED := INSTFUN INSTALLER
689PROPS_INSTALLS_ACCUMULATE_R := DEPS ORDERDEPS
690PROPS_INSTALLS_ACCUMULATE_L := SOURCES DIRS CLEAN
691## @}
692
693## @name Properties valid on fetches (INSTALLS)
694## @{
695PROPS_FETCHES_SINGLE := TOOL TEMPLATE FETCHTOOL UNPACKTOOL PATCHTOOL INST FETCHDIR
696PROPS_FETCHES_DEFERRED :=
697PROPS_FETCHES_ACCUMULATE_R := FETCHFLAGS UNPACKFLAGS PATCHFLAGS
698PROPS_FETCHES_ACCUMULATE_L := SOURCES
699## @}
700
701
702#
703# Here is a special 'hack' to prevent innocent environment variables being
704# picked up and treated as properties. (The most annoying example of why
705# this is necessary is the Visual C++ commandline with it's LIBPATH.)
706#
707# Define KBUILD_DONT_KILL_ENV_PROPS in the env. or on the commandline to
708# disable this 'hack'.
709#
710ifndef KBUILD_DONT_KILL_ENV_PROPS
711
712define def_nuke_environment_prop
713ifeq ($(origin $(prop)),environment)
714$(prop) =
715endif
716endef
717$(foreach prop, $(PROPS_ALL) \
718 FETCHES PATCHES BLDPROGS LIBRARIES IMPORT_LIBS DLLS PROGRAMS SYSMODS INSTALLS OTHERS \
719 SUBDIRS MAKEFILES BLDDIRS \
720 ,$(eval $(value def_nuke_environment_prop)))
721
722endif # KBUILD_DONT_KILL_ENV_PROPS
723
724
725#
726# Pass configuration.
727#
728# The PASS_<passname>_trgs variable is listing the targets.
729# The PASS_<passname>_vars variable is listing the target variables.
730# The PASS_<passname>_pass variable is the lowercased passname.
731#
732
733## PASS: fetches
734# This pass fetches and unpacks things needed to complete the build.
735PASS_FETCHES := Fetches
736PASS_FETCHES_trgs :=
737PASS_FETCHES_vars := _FETCHES
738PASS_FETCHES_pass := fetches
739
740## PASS: patches
741# This pass applies patches.
742PASS_PATCHES := Patches
743PASS_PATCHES_trgs :=
744PASS_PATCHES_vars := _PATCHES
745PASS_PATCHES_pass := patches
746
747## PASS: bldprogs
748# This pass builds targets which are required for building the rest.
749PASS_BLDPROGS := Build Programs
750PASS_BLDPROGS_trgs :=
751PASS_BLDPROGS_vars := _BLDPROGS
752PASS_BLDPROGS_pass := bldprogs
753
754## PASS: libraries
755# This pass builds library targets.
756PASS_LIBRARIES := Libraries
757PASS_LIBRARIES_trgs :=
758PASS_LIBRARIES_vars := _LIBS _IMPORT_LIBS _OTHER_LIBRARIES
759PASS_LIBRARIES_pass := libraries
760
761## PASS: binaries
762# This pass builds dll targets.
763PASS_DLLS := DLLs
764PASS_DLLS_trgs :=
765PASS_DLLS_vars := _DLLS _OTHER_DLLS
766PASS_DLLS_pass := dlls
767
768## PASS: binaries
769# This pass builds binary targets, i.e. programs, system modules and stuff.
770PASS_BINARIES := Programs
771PASS_BINARIES_trgs :=
772PASS_BINARIES_vars := _PROGRAMS _SYSMODS _OTHER_BINARIES
773PASS_BINARIES_pass := binaries
774
775## PASS: others
776# This pass builds other targets.
777PASS_OTHERS := Other Stuff
778PASS_OTHERS_trgs :=
779PASS_OTHERS_vars := _OTHERS
780PASS_OTHERS_pass := others
781
782## PASS: install
783# This pass installs the built entities to a sandbox area.
784PASS_INSTALLS := Install
785PASS_INSTALLS_trgs :=
786PASS_INSTALLS_vars := _INSTALLS_DIRS _INSTALLS _INSTALLS_FILES
787PASS_INSTALLS_pass := installs
788
789## PASS: packing
790# This pass processes custom packing rules.
791PASS_PACKING := Packing
792PASS_PACKING_trgs :=
793PASS_PACKING_vars := _PACKING
794PASS_PACKING_pass := packing
795#alias
796packing: pass_packing
797
798## PASS: clean
799# This pass removes all generated files.
800PASS_CLEAN := Clean
801PASS_CLEAN_trgs := do-clean
802PASS_CLEAN_vars :=
803PASS_CLEAN_pass := clean
804# alias
805clean: pass_clean
806
807## PASS: nothing
808# This pass just walks the tree.
809PASS_NOTHING := Nothing
810PASS_NOTHING_trgs := do-nothing
811PASS_NOTHING_vars :=
812PASS_NOTHING_pass := nothing
813# alias
814nothing: pass_nothing
815
816## DEFAULT_PASSES
817# The default passes and their order.
818DEFAULT_PASSES := BLDPROGS LIBRARIES DLLS BINARIES OTHERS INSTALLS
819
820## PASSES
821# The passes that should be defined. This must include
822# all passes mentioned by DEFAULT_PASSES.
823PASSES := FETCHES PATCHES $(DEFAULT_PASSES) NOTHING CLEAN
824
825
826#
827# Check for --pretty-command-printing before including the Config.kmk
828# so that anyone overriding the message macros can take the implied
829# verbosity level change into account.
830#
831ifndef KBUILD_VERBOSE
832 ifndef KBUILD_QUIET
833 ifneq ($(filter --pretty-command-printing,$(MAKEFLAGS)),)
834 export KBUILD_VERBOSE := 2
835 endif
836 endif
837endif
838
839
840#
841# This is how we find the closest config.kmk.
842# It's a little hacky but I think it works fine.
843#
844_CFGDIR := .
845_CFGFILES := ./Config.kmk ./config.kmk
846define def_include_config
847$(eval _CFGDIR := $(_CFGDIR)/$(dir))
848_CFGFILES += $(_CFGDIR)/Config.kmk $(_CFGDIR)/config.kmk
849endef
850# walk down the _RELATIVE_ path specified by DEPTH.
851$(foreach dir,$(subst /, ,$(DEPTH)), $(eval $(def_include_config)) )
852# add the default config file.
853_CFGFILE := $(firstword $(wildcard $(_CFGFILES) $(FILE_KBUILD_CONFIG)))
854_CFGFILES :=
855_CFGDIR :=
856ifeq ($(_CFGFILE),)
857$(error kBuild: no Config.kmk file found! Check the DEPTH: DEPTH='$(DEPTH)' PATH_CURRENT='$(PATH_CURRENT)')
858endif
859
860# Include the config.kmk we found file (or the default one).
861ifdef KBUILD_PROFILE_SELF
862 _KBUILD_TS_NOW := $(nanots )
863 $(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - including $(_CFGFILE))
864 _KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
865
866 include $(_CFGFILE)
867
868 _KBUILD_TS_NOW := $(nanots )
869 $(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - included $(_CFGFILE))
870 _KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
871else
872 include $(_CFGFILE)
873endif
874
875
876
877#
878# Finalize a the central path variables now that we've included the Config.kmk file.
879#
880# This prevents some trouble when users override the defaults for these
881# variables and uses relative paths or paths with incorrect case.
882#
883PATH_OUT := $(abspath $(PATH_OUT))
884PATH_OBJ := $(abspath $(PATH_OBJ))
885PATH_TARGET := $(abspath $(PATH_TARGET))
886PATH_INS := $(abspath $(PATH_INS))
887PATH_BIN := $(abspath $(PATH_BIN))
888PATH_DLL := $(abspath $(PATH_DLL))
889PATH_SYS := $(abspath $(PATH_SYS))
890PATH_LIB := $(abspath $(PATH_LIB))
891PATH_DOC := $(abspath $(PATH_DOC))
892
893
894#
895# Setup the message style. The default one is inlined.
896#
897# See kBuild/msgstyles for more styles or use KBUILD_MSG_STYLE_PATHS
898# to create your own message style.
899#
900KBUILD_MSG_STYLE ?= default
901ifeq ($(KBUILD_MSG_STYLE),default)
902 #
903 # The 'default' style.
904 #
905
906 ## Fetch starting.
907 # @param 1 Target name.
908 MSG_FETCH ?= $(call MSG_L1,Fetching $1...)
909 ## Re-fetch starting.
910 # @param 1 Target name.
911 MSG_REFETCH ?= $(call MSG_L1,Re-fetching $1...)
912 ## Downloading a fetch component.
913 # @param 1 Target name.
914 # @param 2 The source URL.
915 # @param 3 The destination file name.
916 MSG_FETCH_DL ?= $(call MSG_L1,Downloading $1 - $2,=> $3)
917 ## Checking a fetch component.
918 # @param 1 Target name.
919 # @param 2 The source URL.
920 # @param 3 The destination file name.
921 MSG_FETCH_CHK?= $(call MSG_L1,Checking $1 - $3, ($2))
922 ## Unpacking a fetch component.
923 # @param 1 Target name.
924 # @param 2 The archive file name.
925 # @param 3 The target directory.
926 MSG_FETCH_UP ?= $(call MSG_L1,Unpacking $1 - $2 => $3)
927 ## Fetch completed.
928 # @param 1 Target name.
929 MSG_FETCH_OK ?= $(call MSG_L1,Successfully fetched $1)
930 ## Unfetch a fetch target.
931 # @param 1 Target name.
932 MSG_UNFETCH ?= $(call MSG_L1,Unfetching $1...)
933 ## Compiling a source file.
934 # @param 1 Target name.
935 # @param 2 The source filename.
936 # @param 3 The primary link output file name.
937 # @param 4 The source type (C,CXX,OBJC,AS,RC,++).
938 MSG_COMPILE ?= $(call MSG_L1,Compiling $1 - $2,=> $3)
939 ## Tool
940 # @param 1 The tool name (bin2c,...)
941 # @param 2 Target name.
942 # @param 3 The source filename.
943 # @param 4 The primary output file name.
944 MSG_TOOL ?= $(call MSG_L1,$1 $2 - $3,=> $4)
945 ## Generate a file, typically a source file.
946 # @param 1 Target name if applicable.
947 # @param 2 Output file name.
948 # @param 3 What it's generated from
949 MSG_GENERATE ?= $(call MSG_L1,Generating $(if $1,$1 - )$2,$(if $3,from $3))
950 ## Linking a bldprog/dll/program/sysmod target.
951 # @param 1 Target name.
952 # @param 2 The primary link output file name.
953 # @param 3 The link tool operation (LINK_LIBRARY,LINK_PROGRAM,LINK_DLL,LINK_SYSMOD,++).
954 MSG_LINK ?= $(call MSG_L1,Linking $1,=> $2)
955 ## Merging a library into the target (during library linking).
956 # @param 1 Target name.
957 # @param 2 The output library name.
958 # @param 3 The input library name.
959 MSG_AR_MERGE ?= $(call MSG_L1,Merging $3 into $1, ($2))
960 ## Creating a directory (build).
961 # @param 1 Directory name.
962 MSG_MKDIR ?= $(call MSG_L2,Creating directory $1)
963 ## Cleaning.
964 MSG_CLEAN ?= $(call MSG_L1,Cleaning...)
965 ## Nothing.
966 MSG_NOTHING ?= $(call MSG_L1,Did nothing in $(CURDIR))
967 ## Pass
968 # @param 1 The pass name.
969 MSG_PASS ?= $(call MSG_L1,Pass - $1)
970 ## Installing a bldprog/lib/dll/program/sysmod target.
971 # @param 1 Target name.
972 # @param 2 The source filename.
973 # @param 3 The destination file name.
974 MSG_INST_TRG ?= $(call MSG_L1,Installing $1 => $3)
975 ## Installing a file (install target).
976 # @param 1 The source filename.
977 # @param 2 The destination filename.
978 MSG_INST_FILE?= $(call MSG_L1,Installing $2,(<= $1))
979 ## Installing a symlink.
980 # @param 1 Symlink
981 # @param 2 Link target
982 MSG_INST_SYM ?= $(call MSG_L1,Installing symlink $1,=> $2)
983 ## Installing a directory.
984 # @param 1 Directory name.
985 MSG_INST_DIR ?= $(call MSG_L1,Installing directory $1)
986
987else
988 _KBUILD_MSG_STYLE_FILE := $(firstword $(foreach path, $(KBUILD_MSG_STYLE_PATHS) $(PATH_KBUILD)/msgstyles, $(wildcard $(path)/$(KBUILD_MSG_STYLE).kmk)))
989 ifneq ($(_KBUILD_MSG_STYLE_FILE),)
990 include $(_KBUILD_MSG_STYLE_FILE)
991 else
992 $(error kBuild: Can't find the style setup file for KBUILD_MSG_STYLE '$(KBUILD_MSG_STYLE)')
993 endif
994endif
995
996
997#
998# Message macros.
999#
1000# This is done after including Config.kmk as to allow for
1001# KBUILD_QUIET and KBUILD_VERBOSE to be configurable.
1002#
1003ifdef KBUILD_QUIET
1004 # No output
1005 QUIET := @
1006 QUIET2:= @
1007 MSG_L1 =
1008 MSG_L2 =
1009else
1010 ifndef KBUILD_VERBOSE
1011 # Default output level.
1012 QUIET := @
1013 QUIET2 := @
1014 MSG_L1 ?= @$(ECHO) "kBuild: $1"
1015 MSG_L2 =
1016 else ifeq ($(KBUILD_VERBOSE),1)
1017 # A bit more output
1018 QUIET := @
1019 QUIET2 := @
1020 MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
1021 MSG_L2 =
1022 else ifeq ($(KBUILD_VERBOSE),2)
1023 # Lot more output
1024 QUIET :=
1025 QUIET2 := @
1026 MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
1027 MSG_L2 ?= @$(ECHO) "kBuild: $1"
1028 else
1029 # maximal output.
1030 QUIET :=
1031 QUIET2 :=
1032 MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
1033 MSG_L2 ?= @$(ECHO) "kBuild: $1"
1034 endif
1035endif
1036
1037
1038#
1039# Validate any KBUILD_BLD_TYPES additions and finally the BUILD_TYPE.
1040#
1041if1of ($(KBUILD_BLD_TYPES), $(KBUILD_OSES))
1042 $(error kBuild: found KBUILD_BLD_TYPES in KBUILD_OSES!)
1043endif
1044if1of ($(KBUILD_BLD_TYPES), $(KBUILD_ARCHES))
1045 $(error kBuild: found KBUILD_BLD_TYPES in KBUILD_ARCHES!)
1046endif
1047if1of ($(KBUILD_OSES), $(KBUILD_ARCHES))
1048 $(error kBuild: found KBUILD_OSES in KBUILD_ARCHES!)
1049endif
1050ifn1of ($(BUILD_TYPE), $(KBUILD_BLD_TYPES))
1051 $(error kBuild: BUILD_TYPE(=$(BUILD_TYPE)) is not found in KBUILD_BLD_TYPES(=$(KBUILD_BLD_TYPES))!)
1052endif
1053
1054
1055
1056ifdef KBUILD_PROFILE_SELF
1057 _KBUILD_TS_HEADER_END := $(nanots )
1058 $(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)
1059 _KBUILD_TS_PREV := $(_KBUILD_TS_HEADER_END)
1060endif
1061
1062# end-of-file-content
1063__header_kmk__ := 1
1064endif # __header_kmk__
1065
Note: See TracBrowser for help on using the repository browser.