source: trunk/kBuild/header.kmk@ 1416

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

prefix the search paths for templates, sdks, tools and stuff. Added KBUILD_DEFAULT_PATHS as a common last resort.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id Revision
File size: 31.0 KB
Line 
1# $Id: header.kmk 1416 2008-03-18 22:37:29Z 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: 1416 $ )
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# This is how we find the closest config.kmk.
846# It's a little hacky but I think it works fine.
847#
848_CFGDIR := .
849_CFGFILES := ./Config.kmk ./config.kmk
850define def_include_config
851$(eval _CFGDIR := $(_CFGDIR)/$(dir))
852_CFGFILES += $(_CFGDIR)/Config.kmk $(_CFGDIR)/config.kmk
853endef
854# walk down the _RELATIVE_ path specified by DEPTH.
855$(foreach dir,$(subst /, ,$(DEPTH)), $(eval $(def_include_config)) )
856# add the default config file.
857_CFGFILE := $(firstword $(wildcard $(_CFGFILES) $(FILE_KBUILD_CONFIG)))
858_CFGFILES :=
859_CFGDIR :=
860ifeq ($(_CFGFILE),)
861$(error kBuild: no Config.kmk file found! Check the DEPTH: DEPTH='$(DEPTH)' PATH_CURRENT='$(PATH_CURRENT)')
862endif
863
864# Include the config.kmk we found file (or the default one).
865ifdef KBUILD_PROFILE_SELF
866 _KBUILD_TS_NOW := $(nanots )
867 $(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - including $(_CFGFILE))
868 _KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
869
870 include $(_CFGFILE)
871
872 _KBUILD_TS_NOW := $(nanots )
873 $(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - included $(_CFGFILE))
874 _KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
875else
876 include $(_CFGFILE)
877endif
878
879
880
881#
882# Finalize a the central path variables now that we've included the Config.kmk file.
883#
884# This prevents some trouble when users override the defaults for these
885# variables and uses relative paths or paths with incorrect case.
886#
887PATH_OUT := $(abspath $(PATH_OUT))
888PATH_OBJ := $(abspath $(PATH_OBJ))
889PATH_TARGET := $(abspath $(PATH_TARGET))
890PATH_INS := $(abspath $(PATH_INS))
891PATH_BIN := $(abspath $(PATH_BIN))
892PATH_DLL := $(abspath $(PATH_DLL))
893PATH_SYS := $(abspath $(PATH_SYS))
894PATH_LIB := $(abspath $(PATH_LIB))
895PATH_DOC := $(abspath $(PATH_DOC))
896
897
898#
899# Setup the message style. The default one is inlined.
900#
901# See kBuild/msgstyles for more styles or use KBUILD_MSG_STYLE_PATHS
902# to create your own message style.
903#
904KBUILD_MSG_STYLE ?= default
905ifeq ($(KBUILD_MSG_STYLE),default)
906 #
907 # The 'default' style.
908 #
909
910 ## Fetch starting.
911 # @param 1 Target name.
912 MSG_FETCH ?= $(call MSG_L1,Fetching $1...)
913 ## Re-fetch starting.
914 # @param 1 Target name.
915 MSG_REFETCH ?= $(call MSG_L1,Re-fetching $1...)
916 ## Downloading a fetch component.
917 # @param 1 Target name.
918 # @param 2 The source URL.
919 # @param 3 The destination file name.
920 MSG_FETCH_DL ?= $(call MSG_L1,Downloading $1 - $2,=> $3)
921 ## Checking a fetch component.
922 # @param 1 Target name.
923 # @param 2 The source URL.
924 # @param 3 The destination file name.
925 MSG_FETCH_CHK?= $(call MSG_L1,Checking $1 - $3, ($2))
926 ## Unpacking a fetch component.
927 # @param 1 Target name.
928 # @param 2 The archive file name.
929 # @param 3 The target directory.
930 MSG_FETCH_UP ?= $(call MSG_L1,Unpacking $1 - $2 => $3)
931 ## Fetch completed.
932 # @param 1 Target name.
933 MSG_FETCH_OK ?= $(call MSG_L1,Successfully fetched $1)
934 ## Unfetch a fetch target.
935 # @param 1 Target name.
936 MSG_UNFETCH ?= $(call MSG_L1,Unfetching $1...)
937 ## Compiling a source file.
938 # @param 1 Target name.
939 # @param 2 The source filename.
940 # @param 3 The primary link output file name.
941 # @param 4 The source type (C,CXX,OBJC,AS,RC,++).
942 MSG_COMPILE ?= $(call MSG_L1,Compiling $1 - $2,=> $3)
943 ## Tool
944 # @param 1 The tool name (bin2c,...)
945 # @param 2 Target name.
946 # @param 3 The source filename.
947 # @param 4 The primary output file name.
948 MSG_TOOL ?= $(call MSG_L1,$1 $2 - $3,=> $4)
949 ## Generate a file, typically a source file.
950 # @param 1 Target name if applicable.
951 # @param 2 Output file name.
952 # @param 3 What it's generated from
953 MSG_GENERATE ?= $(call MSG_L1,Generating $(if $1,$1 - )$2,$(if $3,from $3))
954 ## Linking a bldprog/dll/program/sysmod target.
955 # @param 1 Target name.
956 # @param 2 The primary link output file name.
957 # @param 3 The link tool operation (LINK_LIBRARY,LINK_PROGRAM,LINK_DLL,LINK_SYSMOD,++).
958 MSG_LINK ?= $(call MSG_L1,Linking $1,=> $2)
959 ## Merging a library into the target (during library linking).
960 # @param 1 Target name.
961 # @param 2 The output library name.
962 # @param 3 The input library name.
963 MSG_AR_MERGE ?= $(call MSG_L1,Merging $3 into $1, ($2))
964 ## Creating a directory (build).
965 # @param 1 Directory name.
966 MSG_MKDIR ?= $(call MSG_L2,Creating directory $1)
967 ## Cleaning.
968 MSG_CLEAN ?= $(call MSG_L1,Cleaning...)
969 ## Nothing.
970 MSG_NOTHING ?= $(call MSG_L1,Did nothing in $(CURDIR))
971 ## Pass
972 # @param 1 The pass name.
973 MSG_PASS ?= $(call MSG_L1,Pass - $1)
974 ## Installing a bldprog/lib/dll/program/sysmod target.
975 # @param 1 Target name.
976 # @param 2 The source filename.
977 # @param 3 The destination file name.
978 MSG_INST_TRG ?= $(call MSG_L1,Installing $1 => $3)
979 ## Installing a file (install target).
980 # @param 1 The source filename.
981 # @param 2 The destination filename.
982 MSG_INST_FILE?= $(call MSG_L1,Installing $2,(<= $1))
983 ## Installing a symlink.
984 # @param 1 Symlink
985 # @param 2 Link target
986 MSG_INST_SYM ?= $(call MSG_L1,Installing symlink $1,=> $2)
987 ## Installing a directory.
988 # @param 1 Directory name.
989 MSG_INST_DIR ?= $(call MSG_L1,Installing directory $1)
990
991else
992 _KBUILD_MSG_STYLE_FILE := $(firstword $(foreach path, $(KBUILD_MSG_STYLE_PATHS) $(PATH_KBUILD)/msgstyles, $(wildcard $(path)/$(KBUILD_MSG_STYLE).kmk)))
993 ifneq ($(_KBUILD_MSG_STYLE_FILE),)
994 include $(_KBUILD_MSG_STYLE_FILE)
995 else
996 $(error kBuild: Can't find the style setup file for KBUILD_MSG_STYLE '$(KBUILD_MSG_STYLE)')
997 endif
998endif
999
1000
1001#
1002# Message macros.
1003#
1004# This is done after including Config.kmk as to allow for
1005# KBUILD_QUIET and KBUILD_VERBOSE to be configurable.
1006#
1007ifdef KBUILD_QUIET
1008 # No output
1009 QUIET := @
1010 QUIET2:= @
1011 MSG_L1 =
1012 MSG_L2 =
1013else
1014 ifndef KBUILD_VERBOSE
1015 # Default output level.
1016 QUIET := @
1017 QUIET2 := @
1018 MSG_L1 ?= @$(ECHO) "kBuild: $1"
1019 MSG_L2 =
1020 else ifeq ($(KBUILD_VERBOSE),1)
1021 # A bit more output
1022 QUIET := @
1023 QUIET2 := @
1024 MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
1025 MSG_L2 =
1026 else ifeq ($(KBUILD_VERBOSE),2)
1027 # Lot more output
1028 QUIET :=
1029 QUIET2 := @
1030 MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
1031 MSG_L2 ?= @$(ECHO) "kBuild: $1"
1032 else
1033 # maximal output.
1034 QUIET :=
1035 QUIET2 :=
1036 MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
1037 MSG_L2 ?= @$(ECHO) "kBuild: $1"
1038 endif
1039endif
1040
1041
1042#
1043# Validate any KBUILD_BLD_TYPES additions and finally the BUILD_TYPE.
1044#
1045if1of ($(KBUILD_BLD_TYPES), $(KBUILD_OSES))
1046 $(error kBuild: found KBUILD_BLD_TYPES in KBUILD_OSES!)
1047endif
1048if1of ($(KBUILD_BLD_TYPES), $(KBUILD_ARCHES))
1049 $(error kBuild: found KBUILD_BLD_TYPES in KBUILD_ARCHES!)
1050endif
1051if1of ($(KBUILD_OSES), $(KBUILD_ARCHES))
1052 $(error kBuild: found KBUILD_OSES in KBUILD_ARCHES!)
1053endif
1054ifn1of ($(BUILD_TYPE), $(KBUILD_BLD_TYPES))
1055 $(error kBuild: BUILD_TYPE(=$(BUILD_TYPE)) is not found in KBUILD_BLD_TYPES(=$(KBUILD_BLD_TYPES))!)
1056endif
1057
1058
1059
1060ifdef KBUILD_PROFILE_SELF
1061 _KBUILD_TS_HEADER_END := $(nanots )
1062 $(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)
1063 _KBUILD_TS_PREV := $(_KBUILD_TS_HEADER_END)
1064endif
1065
1066# end-of-file-content
1067__header_kmk__ := 1
1068endif # __header_kmk__
1069
Note: See TracBrowser for help on using the repository browser.