Context Navigation

header.kmk@ 828

Last change on this file since 828 was 825, checked in by bird, 18 years ago
Added fake xargs implementation. Retired abspathex to gnumake-header.kmk.
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 23.5 KB

Line
1	# $Id: header.kmk 825 2007-02-01 06:37:56Z bird $
2	## @file
3	#
4	# kBuild - File included at top of 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
27	ifndef __header_kmk__
28	# start-of-file-content
29
30	#
31	# default rule
32	#
33	all: all_recursive
34
35	#
36	# The FORCE rule.
37	#
38	FORCE:
39
40	#
41	# Try avoid inference rules.
42	#
43	.SUFFIXES:
44	SUFFIXES :=
45
46
47	#
48	# General purpose macros.
49	#
50
51	## get last word in a list.
52	# @returns last word in $1.
53	# @param $1 Word list.
54	lastword = $(word $(words $(1)), $(1))
55
56	##
57	# Newline character(s).
58	define NL
59
60
61	endef
62
63	##
64	# Tab character.
65	TAB := $(subst ., ,.)
66
67	##
68	# Space character.
69	SP := $(subst ., ,.)
70
71	##
72	# Checks if two strings are equal.
73	# @returns blank if equal
74	# @returns non-blank if not equal.
75	# @param $1 String 1.
76	# @param $2 String 2
77	STRCMP = $( todo )
78
79	#
80	# Set default build type.
81	#
82	ifndef BUILD_TYPE
83	ifdef BUILD_MODE
84	# BUILD_MODE is legacy from the OS/2 build system. :)
85	BUILD_TYPE := $(tolower $(BUILD_MODE))
86	else
87	BUILD_TYPE := release
88	endif
89	endif
90
91
92	#
93	# Assert build platform.
94	#
95	ifndef BUILD_PLATFORM
96	$(error kBuild: BUILD_PLATFORM is undefined!)
97	else
98	BUILD_PLATFORM := $(strip $(BUILD_PLATFORM))
99	ifneq ($(words $(BUILD_PLATFORM))$(filter-out darwin freebsd l4 linux nt os2 solaris win win32 win64,$(BUILD_PLATFORM)),1)
100	# OS/2 (have uppercase legacy)
101	ifeq ($(BUILD_PLATFORM),OS2)
102	$(error kBuild: BUILD_PLATFORM must be all lowercase!)
103	endif
104	$(error kBuild: BUILD_PLATFORM value '$(BUILD_PLATFORM)' was not recognized!)
105	endif
106	endif
107
108	# Fill in defaults if needed.
109	ifndef BUILD_PLATFORM_ARCH
110	ifeq ($(filter-out win64,$(BUILD_PLATFORM)),)
111	BUILD_PLATFORM_ARCH := amd64
112	else
113	BUILD_PLATFORM_ARCH := x86
114	endif
115	endif
116	ifndef BUILD_PLATFORM_CPU
117	ifeq ($(filter-out amd64,$(BUILD_PLATFORM_ARCH)),)
118	BUILD_PLATFORM_CPU:= k8
119	else
120	BUILD_PLATFORM_CPU:= i586
121	endif
122	endif
123
124
125	#
126	# Assert target platform.
127	#
128	ifndef BUILD_TARGET
129	# not defined, set to the same as build platform
130	BUILD_TARGET := $(BUILD_PLATFORM)
131	else
132	BUILD_TARGET := $(strip $(BUILD_TARGET))
133	ifneq ($(words $(BUILD_TARGET))$(filter-out darwin freebsd l4 linux nt os2 solaris win win32 win64,$(BUILD_TARGET)),1)
134	# OS/2 (have uppercase legacy)
135	ifeq ($(BUILD_TARGET),OS2)
136	$(error kBuild: BUILD_TARGET must be all lowercase!)
137	endif
138	$(error kBuild: BUILD_TARGET value '$(BUILD_TARGET)' was not recognized!)
139	endif
140	endif
141
142	# Fill in defaults if needed.
143	ifndef BUILD_TARGET_ARCH
144	BUILD_TARGET_ARCH := x86
145	endif
146	ifndef BUILD_TARGET_CPU
147	BUILD_TARGET_CPU := i586
148	endif
149
150	# Adjust the DEPTH definition first
151	ifeq ($(strip $(DEPTH)),)
152	DEPTH := .
153	endif
154
155	#
156	# Common definitions.
157	#
158	## PATH_CURRENT is the current directory (getcwd).
159	PATH_CURRENT := $(abspath $(CURDIR))
160	## PATH_SUB_CURRENT points to current directory of the current makefile.
161	# Meaning that it will change value as we enter and exit sub-makefiles.
162	PATH_SUB_CURRENT := $(PATH_CURRENT)
163	## PATH_ROOT points to the project root directory.
164	PATH_ROOT := $(abspath $(PATH_CURRENT)/$(DEPTH))
165	## PATH_SUB_ROOT points to the directory of the top-level makefile.
166	ifneq ($(strip $(SUB_DEPTH)),)
167	PATH_SUB_ROOT := $(abspath $(PATH_CURRENT)/$(SUB_DEPTH))
168	else
169	PATH_SUB_ROOT := $(PATH_CURRENT)
170	endif
171
172	## CURSUBDIR is PATH_SUB_ROOT described relative to PATH_ROOT.
173	# This variable is used to determin where the object files and other output goes.
174	ifneq ($(PATH_ROOT),$(PATH_CURRENT))
175	CURSUBDIR := $(patsubst $(PATH_ROOT)/%,%,$(PATH_SUB_ROOT))
176	else
177	CURSUBDIR := .
178	endif
179
180	# Output directories.
181	ifndef PATH_OUT_BASE
182	PATH_OUT_BASE := $(PATH_ROOT)/out
183	endif
184	ifndef PATH_OUT
185	ifdef BUILD_TARGET_SUB # (BUILD_TARGET_SUB is not currently recognized by kBuild in any other places.)
186	PATH_OUT := $(PATH_OUT_BASE)/$(BUILD_TARGET).$(BUILD_TARGET_ARCH).$(BUILD_TARGET_SUB)/$(BUILD_TYPE)
187	else
188	PATH_OUT := $(PATH_OUT_BASE)/$(BUILD_TARGET).$(BUILD_TARGET_ARCH)/$(BUILD_TYPE)
189	endif
190	endif # !define PATH_OUT
191	PATH_OBJ = $(PATH_OUT)/obj
192	PATH_TARGET = $(PATH_OBJ)/$(CURSUBDIR)
193	PATH_INS = $(PATH_OUT)
194	PATH_BIN = $(PATH_INS)/bin
195	PATH_DLL = $(PATH_INS)/bin
196	PATH_SYS = $(PATH_INS)/bin
197	PATH_LIB = $(PATH_INS)/lib
198	PATH_DOC = $(PATH_INS)/doc
199
200	# Usually kBuild is external to the source tree.
201	ifndef PATH_KBUILD
202	PATH_KBUILD := $(PATH_ROOT)/kBuild
203	endif
204	PATH_KBUILD := $(abspath $(PATH_KBUILD))
205	# kBuild files which might be of interest.
206	FILE_KBUILD_HEADER := $(PATH_KBUILD)/header.kmk
207	#FILE_KBUILD_CONFIG := $(PATH_KBUILD)/config.kmk
208	FILE_KBUILD_FOOTER := $(PATH_KBUILD)/footer.kmk
209
210	SUFF_DEP := .dep
211	## MAKEFILE is the name of the main makefile.
212	MAKEFILE := $(firstword $(MAKEFILE_LIST))
213	## MAKEFILE_CURRENT is the name of the current makefile.
214	# This is updated everything a sub-makefile is included.
215	MAKEFILE_CURRENT := $(MAKEFILE)
216
217
218	#
219	# Check make version.
220	#
221	ifdef KMK_VERSION
222	ifneq ($(KBUILD_VERSION_MAJOR).$(KBUILD_VERSION_MINOR),0.1)
223	ifneq ($(KBUILD_VERSION_MAJOR),0)
224	$(warning kBuild: kmk major version mismatch, expected '0' found '$(KBUILD_VERSION_MAJOR)'!)
225	else
226	$(warning kBuild: kmk minor version mismatch, expected '1' found '$(KBUILD_VERSION_MINOR)'!)
227	endif
228	endif
229	else
230	include $(PATH_KBUILD)/gnumake-header.kmk
231	endif
232
233
234	#
235	# The revision in which this file was last modified.
236	# This can be useful when using development versions of kBuild.
237	#
238	KMK_REVISION := $(patsubst %:,, $Rev: 825 $ )
239
240
241	#
242	# Build platform setup.
243	#
244	# OS/2
245	ifeq ($(BUILD_PLATFORM),os2)
246	EXEC_X86_WIN32 := innopec.exe
247	HOSTSUFF_EXE := .exe
248	endif
249
250	# Linux
251	ifeq ($(BUILD_PLATFORM),linux)
252	EXEC_X86_WIN32 := wine
253	HOSTSUFF_EXE :=
254	endif
255
256	# Win, Win32, Win64, NT.
257	ifeq ($(filter-out win32 win64 win nt,$(BUILD_PLATFORM)),)
258	EXEC_X86_WIN32 :=
259	HOSTSUFF_EXE := .exe
260	endif
261
262	# FreeBSD
263	ifeq ($(BUILD_PLATFORM),freebsd)
264	EXEC_X86_WIN32 := wine
265	HOSTSUFF_EXE :=
266	endif
267
268	# Darwin / Mac OS X
269	ifeq ($(BUILD_PLATFORM),darwin)
270	EXEC_X86_WIN32 := false
271	HOSTSUFF_EXE :=
272	endif
273
274	# Solaris
275	ifeq ($(BUILD_PLATFORM),solaris)
276	EXEC_X86_WIN32 := false
277	HOSTSUFF_EXE :=
278	endif
279
280	ifndef PATH_KBUILD_BIN
281	PATH_KBUILD_BIN := $(PATH_KBUILD)/bin/$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)
282	ifeq ($(wildcard $(PATH_KBUILD_BIN)/kmk_ash$(HOSTSUFF_EXE)),)
283	ifeq ($(BUILD_TARGET_ARCH),amd64)
284	PATH_KBUILD_BIN := $(PATH_KBUILD)/bin/$(BUILD_PLATFORM).x86
285	endif
286	ifeq ($(wildcard $(PATH_KBUILD_BIN)/kmk_ash$(HOSTSUFF_EXE)),)
287	ifeq ($(filter-out win64 win32 win nt ,$(BUILD_PLATFORM)),)
288	PATH_KBUILD_BIN := $(PATH_KBUILD)/bin/win.x86
289	endif
290	endif
291	ifeq ($(wildcard $(PATH_KBUILD_BIN)/kmk_ash$(HOSTSUFF_EXE)),)
292	# give up
293	PATH_KBUILD_BIN := $(PATH_KBUILD)/bin/$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)
294	endif
295	endif
296	endif
297
298
299	#
300	# Build target setup.
301	#
302	ifeq ($(filter-out win32 win64 win nt os2,$(BUILD_TARGET)),)
303	SUFF_OBJ := .obj
304	SUFF_LIB := .lib
305	SUFF_DLL := .dll
306	SUFF_EXE := .exe
307	SUFF_SYS := .sys
308	SUFF_RES := .res
309	endif
310	ifeq ($(BUILD_TARGET),l4)
311	SUFF_OBJ := .o
312	SUFF_LIB := .a
313	SUFF_DLL := .s.so
314	SUFF_EXE :=
315	SUFF_SYS := .a
316	SUFF_RES :=
317	endif
318	ifeq ($(BUILD_TARGET),darwin)
319	SUFF_OBJ := .o
320	SUFF_LIB := .a
321	SUFF_DLL := .dylib
322	SUFF_EXE :=
323	SUFF_SYS :=
324	SUFF_RES :=
325	endif
326	ifndef SUFF_OBJ
327	SUFF_OBJ := .o
328	SUFF_LIB := .a
329	SUFF_DLL := .so
330	SUFF_EXE :=
331	SUFF_SYS := .a
332	SUFF_RES :=
333	endif
334
335	#
336	# Standard kBuild tools.
337	#
338	ifeq ($(MAKE),kmk)
339	MAKE := $(PATH_KBUILD_BIN)/kmk$(HOSTSUFF_EXE)
340	endif
341
342	DEP_EXT := $(PATH_KBUILD_BIN)/kDep$(HOSTSUFF_EXE)
343	ifeq ($(filter kDep,$(KMK_BUILTIN)),kDep)
344	DEP := kmk_builtin_kDep
345	else
346	DEP := $(DEP_EXT)
347	endif
348
349	DEP_IDB_EXT := $(PATH_KBUILD_BIN)/kDepIDB$(HOSTSUFF_EXE)
350	ifeq ($(filter kDepPre,$(KMK_BUILTIN)),kDepIDB)
351	DEP_IDB := $(if kmk_builtin_kDepIDB
352	else
353	DEP_IDB := $(DEP_IDB_EXT)
354	endif
355
356	DEP_PRE_EXT := $(PATH_KBUILD_BIN)/kDepPre$(HOSTSUFF_EXE)
357	ifeq ($(filter kDepPre,$(KMK_BUILTIN)),kDepPre)
358	DEP_PRE := $(if kmk_builtin_kDepPre
359	else
360	DEP_PRE := $(DEP_PRE_EXT)
361	endif
362
363	APPEND_EXT := $(PATH_KBUILD_BIN)/kmk_append$(HOSTSUFF_EXE)
364	ifeq ($(filter append,$(KMK_BUILTIN)),append)
365	APPEND := kmk_builtin_append
366	else
367	APPEND := $(APPEND_EXT)
368	endif
369
370	CAT_EXT := $(PATH_KBUILD_BIN)/kmk_cat$(HOSTSUFF_EXE)
371	ifeq ($(filter cat,$(KMK_BUILTIN)),cat)
372	CAT := kmk_builtin_cat
373	else
374	CAT := $(CAT_EXT)
375	endif
376
377	CP_EXT := $(PATH_KBUILD_BIN)/kmk_cp$(HOSTSUFF_EXE)
378	ifeq ($(filter cp,$(KMK_BUILTIN)),cp)
379	CP := kmk_builtin_cp
380	else
381	CP := $(CP_EXT)
382	endif
383
384	ECHO_EXT := $(PATH_KBUILD_BIN)/kmk_echo$(HOSTSUFF_EXE)
385	ifeq ($(filter echo,$(KMK_BUILTIN)),echo)
386	ECHO := kmk_builtin_echo
387	else
388	ECHO := $(ECHO_EXT)
389	endif
390
391	INSTALL_EXT := $(PATH_KBUILD_BIN)/kmk_install$(HOSTSUFF_EXE)
392	ifeq ($(filter install,$(KMK_BUILTIN)),install)
393	INSTALL := kmk_builtin_install
394	else
395	INSTALL := $(INSTALL_EXT)
396	endif
397
398	LN_EXT := $(PATH_KBUILD_BIN)/kmk_ln$(HOSTSUFF_EXE)
399	ifeq ($(filter ln,$(KMK_BUILTIN)),ln)
400	LN := kmk_builtin_ln
401	else
402	LN := $(LN_EXT)
403	endif
404
405	MKDIR_EXT := $(PATH_KBUILD_BIN)/kmk_mkdir$(HOSTSUFF_EXE)
406	ifeq ($(filter mkdir,$(KMK_BUILTIN)),mkdir)
407	MKDIR := kmk_builtin_mkdir
408	else
409	MKDIR := $(MKDIR_EXT)
410	endif
411
412	MV_EXT := $(PATH_KBUILD_BIN)/kmk_mv$(HOSTSUFF_EXE)
413	ifeq ($(filter mv,$(KMK_BUILTIN)),mv)
414	MV := kmk_builtin_mv
415	else
416	MV := $(MV_EXT)
417	endif
418
419	PRINTF_EXT := $(PATH_KBUILD_BIN)/kmk_printf$(HOSTSUFF_EXE)
420	ifeq ($(filter printf,$(KMK_BUILTIN)),printf)
421	PRINTF := kmk_builtin_printf
422	else
423	PRINTF := $(PRINTF_EXT)
424	endif
425
426	RM_EXT := $(PATH_KBUILD_BIN)/kmk_rm$(HOSTSUFF_EXE)
427	ifeq ($(filter rm,$(KMK_BUILTIN)),rm)
428	RM := kmk_builtin_rm
429	else
430	RM := $(RM_EXT)
431	endif
432
433	RMDIR_EXT := $(PATH_KBUILD_BIN)/kmk_rmdir$(HOSTSUFF_EXE)
434	ifeq ($(filter rmdir,$(KMK_BUILTIN)),rmdir)
435	RMDIR := kmk_builtin_rmdir
436	else
437	RMDIR := $(RMDIR_EXT)
438	endif
439
440	SED_EXT := $(PATH_KBUILD_BIN)/kmk_sed$(HOSTSUFF_EXE)
441	ifeq ($(filter sed,$(KMK_BUILTIN)),sed)
442	SED := kmk_builtin_sed
443	else
444	SED := $(SED_EXT)
445	endif
446
447	# Our default shell is the Almquist shell from *BSD.
448	ASH := $(PATH_KBUILD_BIN)/kmk_ash$(HOSTSUFF_EXE)
449	MAKESHELL := $(ASH)
450	SHELL := $(ASH)
451	export SHELL MAKESHELL
452
453	# Symlinking is problematic on some platforms...
454	LN_SYMLINK := $(LN) -s
455
456
457	#
458	# Some Functions.
459	# The lower cased ones are either fallbacks or candidates for functions.c.
460	#
461
462	## ABSPATH - make paths absolute.
463	# This implementation is clumsy and doesn't resolve '..' and '.' components.
464	#
465	# @param $1 The paths to make absolute.
466	# @obsolete Use the GNU make function $(abspath) directly now.
467	ABSPATH = $(abspath $(1))
468
469	## DIRDEP - make create directory dependencies.
470	#
471	# @param $1 The paths to the directories which must be created.
472	DIRDEP = $(foreach path,$(patsubst %/,%,$(1)),$(path)/)
473
474	## Cygwin kludge.
475	# This converts /cygdrive/x/% to x:%.
476	#
477	# @param $1 The paths to make native.
478	# @remark This macro is pretty much obsolete since we don't use cygwin base make.
479	ifneq ($(patsubst /cygdrive/%,%,$(CURDIR)),$(CURDIR))
480	CYGPATHMIXED = $(foreach path,$(1)\
481	,$(if $(patsubst /cygdrive/%,,$(path)),$(path),$(patsubst $(strip $(firstword $(subst /, ,$(patsubst /cygdrive/%,%,$(path)))))/%,$(strip $(firstword $(subst /, ,$(patsubst /cygdrive/%,%,$(path))))):/%,$(patsubst /cygdrive/%,%,$(path)))))
482	else
483	CYGPATHMIXED = $(1)
484	endif
485
486	ifneq ($(filter xargs,$(KMK_FEATURES)),xargs) ## @todo Retire this to gnumake-header.kmk when it has been implemented.
487	##
488	# Fake xargs without doing any commandline splitting.
489	# @param $1 The initial command.
490	# @param $2 The command for the subseqent command lines. optional
491	# @param $3 The command for the final command lines. optional
492	# @param $($#) The arguments.
493	xargs = $(1) $(if $(4),$(4),$(if $(3),$(3),$(2)))
494	endif
495
496	## Removes the drive letter from a path (if it has one)
497	# @param $1 the path
498	no-drive = $(word $(words $(subst :, ,$(1))),$(subst :, ,$(1)))
499
500	## Removes the root slash from a path (if it has one)
501	# @param $1 the path
502	no-root-slash = $(patsubst /%,%,$(1))
503
504	## Figure out where to put object files.
505	# @param $1 real target name.
506	# @param $2 normalized main target
507	TARGET_BASE = $(PATH_TARGET)/$(2)/$(call no-root-slash,$(call no-drive,$(1)))
508
509	## Figure out where to put object files.
510	# @param $1 normalized main target
511	TARGET_PATH = $(PATH_TARGET)/$(1)
512
513
514	#
515	# Initialize some of the globals which the Config.kmk and
516	# others can add stuff to if they like for processing in the footer.
517	#
518
519	## ALL_TARGET
520	# This is the list of all targets.
521	ALL_TARGETS :=
522
523	## TEMPLATE_PATHS
524	# List a paths (separated by space) where templates can be found.
525	TEMPLATE_PATHS :=
526
527	## TOOL_PATHS
528	# List of paths (separated by space) where tools can be found.
529	TOOL_PATHS :=
530
531	## SDK_PATHS
532	# List of paths (separated by space) where SDKs can be found.
533	SDK_PATHS :=
534
535	## Proritized list of the default makefile when walking subdirectories.
536	# The user can overload this list.
537	DEFAULT_MAKEFILE := Makefile.kmk makefile.kmk Makefile makefile
538
539	## PROPS_TOOLS
540	# This is a subset of the other PROPS
541	PROPS_TOOLS := TOOL CTOOL CXXTOOL ASTOOL RCTOOL ARTOOL LDTOOL FETCHTOOL UNPACKTOOL PATCHTOOL
542
543	## PROPS_SINGLE
544	# The list of non-accumulative target properties.
545	# A Config.kmk file can add it's own properties to this list and kBuild
546	# will do the necessary inheritance from templates to targets.
547	PROPS_SINGLE := $(PROPS_TOOLS) INST NOINST BLD_TYPE BLD_TRG BLD_TRG_ARCH BLD_TRG_CPU FETCHDIR \
548	OBJSUFF COBJSUFF CXXOBJSUFF ASOBJSUFF RCOBJSUFF SYSSUFF EXESUFF DLLSUFF LIBSUFF ARLIBSUFF
549
550	## PROPS_DEFERRED
551	# This list of non-accumulative target properties which are functions,
552	# and thus should not be expanded until the very last moment.
553	PROPS_DEFERRED := INSTFUN INSTALLER
554
555	## PROPS_ACCUMULATE_R
556	# The list of accumulative target properties where the right most value/flag
557	# is the 'most significant'.
558	# A Config.kmk file can add it's own properties to this list and kBuild
559	# will do the necessary inheritance from templates to targets.
560	PROPS_ACCUMULATE_R := \
561	DEFS DEPS \
562	CFLAGS CDEFS \
563	CXXFLAGS CXXDEFS \
564	ASFLAGS ASDEFS \
565	RCFLAGS RCDEFS \
566	LDFLAGS \
567	FETCHFLAGS UNPACKFLAGS PATCHFLAGS
568
569	## PROPS_ACCUMULATE
570	# The list of accumulative target properties where the left most value/flag
571	# is the 'most significant'.
572	# A Config.kmk file can add it's own properties to this list and kBuild
573	# will do the necessary inheritance from templates to targets.
574	PROPS_ACCUMULATE_L := \
575	SDKS SOURCES \
576	INCS CINCS CXXINCX ASINCS RCINCS \
577	LIBS LIBPATH
578
579	## PROPS_ALL
580	# List of all the properties.
581	PROPS_ALL = $(PROPS_SINGLE) $(PROPS_DEFERRED) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R)
582
583
584	#
585	# Here is a special 'hack' to prevent innocent environment variables being
586	# picked up and treated as properties. (The most annoying example of why
587	# this is necessary is the Visual C++ commandline with it's LIBPATH.)
588	#
589	# Define KBUILD_DONT_KILL_ENV_PROPS in the env. or on the commandline to
590	# disable this 'hack'.
591	#
592	ifndef KBUILD_DONT_KILL_ENV_PROPS
593
594	define def_nuke_environment_prop
595	ifeq ($(origin $(prop)),environment)
596	$(prop) =
597	endif
598	endef
599	$(foreach prop, $(PROPS_ALL) \
600	FETCHES PATCHES BLDPROGS LIBRARIES IMPORT_LIBS DLLS PROGRAMS SYSMODS INSTALLS OTHERS \
601	SUBDIRS MAKEFILES \
602	,$(eval $(value def_nuke_environment_prop)))
603
604	endif
605
606
607	#
608	# Pass configuration.
609	#
610	# The PASS_<passname>_trgs variable is listing the targets.
611	# The PASS_<passname>_vars variable is listing the target variables.
612	# The PASS_<passname>_pass variable is the lowercased passname.
613	#
614
615	## PASS: fetches
616	# This pass fetches and unpacks things needed to complete the build.
617	PASS_FETCHES := Fetches
618	PASS_FETCHES_trgs :=
619	PASS_FETCHES_vars := _FETCHES
620	PASS_FETCHES_pass := fetches
621
622	## PASS: patches
623	# This pass applies patches.
624	PASS_PATCHES := Patches
625	PASS_PATCHES_trgs :=
626	PASS_PATCHES_vars := _PATCHES
627	PASS_PATCHES_pass := patches
628
629	## PASS: bldprogs
630	# This pass builds targets which are required for building the rest.
631	PASS_BLDPROGS := Build Programs
632	PASS_BLDPROGS_trgs :=
633	PASS_BLDPROGS_vars := _BLDPROGS
634	PASS_BLDPROGS_pass := bldprogs
635
636	## PASS: libraries
637	# This pass builds library targets.
638	PASS_LIBRARIES := Libraries
639	PASS_LIBRARIES_trgs :=
640	PASS_LIBRARIES_vars := _LIBS _IMPORT_LIBS _OTHER_LIBRARIES
641	PASS_LIBRARIES_pass := libraries
642
643	## PASS: binaries
644	# This pass builds dll targets.
645	PASS_DLLS := DLLs
646	PASS_DLLS_trgs :=
647	PASS_DLLS_vars := _DLLS _OTHER_DLLS
648	PASS_DLLS_pass := dlls
649
650	## PASS: binaries
651	# This pass builds binary targets, i.e. programs, system modules and stuff.
652	PASS_BINARIES := Programs
653	PASS_BINARIES_trgs :=
654	PASS_BINARIES_vars := _PROGRAMS _SYSMODS _OTHER_BINARIES
655	PASS_BINARIES_pass := binaries
656
657	## PASS: others
658	# This pass builds other targets.
659	PASS_OTHERS := Other Stuff
660	PASS_OTHERS_trgs :=
661	PASS_OTHERS_vars := _OTHERS
662	PASS_OTHERS_pass := others
663
664	## PASS: install
665	# This pass installs the built entities to a sandbox area.
666	PASS_INSTALLS := Install
667	PASS_INSTALLS_trgs :=
668	PASS_INSTALLS_vars := _INSTALLS_DIRS _INSTALLS
669	PASS_INSTALLS_pass := installs
670
671	## PASS: packing
672	# This pass processes custom packing rules.
673	PASS_PACKING := Packing
674	PASS_PACKING_trgs :=
675	PASS_PACKING_vars := _PACKING
676	PASS_PACKING_pass := packing
677	#alias
678	packing: pass_packing
679
680	## PASS: clean
681	# This pass removes all generated files.
682	PASS_CLEAN := Clean
683	PASS_CLEAN_trgs := do-clean
684	PASS_CLEAN_vars :=
685	PASS_CLEAN_pass := clean
686	# alias
687	clean: pass_clean
688
689	## PASS: nothing
690	# This pass just walks the tree.
691	PASS_NOTHING := Nothing
692	PASS_NOTHING_trgs := do-nothing
693	PASS_NOTHING_vars :=
694	PASS_NOTHING_pass := nothing
695	# alias
696	nothing: pass_nothing
697
698	## DEFAULT_PASSES
699	# The default passes and their order.
700	DEFAULT_PASSES := BLDPROGS LIBRARIES DLLS BINARIES OTHERS INSTALLS
701
702	## PASSES
703	# The passes that should be defined. This must include
704	# all passes mentioned by DEFAULT_PASSES.
705	PASSES := FETCHES PATCHES $(DEFAULT_PASSES) NOTHING CLEAN
706
707
708	#
709	# This is how we find the closest config.kmk.
710	# It's a little hacky but I think it works fine.
711	#
712	_CFGDIR := .
713	_CFGFILES := ./Config.kmk ./config.kmk
714	define def_include_config
715	$(eval _CFGDIR := $(_CFGDIR)/$(dir))
716	_CFGFILES += $(_CFGDIR)/Config.kmk $(_CFGDIR)/config.kmk
717	endef
718	# walk down the _RELATIVE_ path specified by DEPTH.
719	$(foreach dir,$(subst /, ,$(DEPTH)), $(eval $(def_include_config)) )
720	# add the default config file.
721	_CFGFILE := $(firstword $(wildcard $(_CFGFILES) $(FILE_KBUILD_CONFIG)))
722	_CFGFILES :=
723	_CFGDIR :=
724	ifeq ($(_CFGFILE),)
725	$(error kBuild: no Config.kmk file found! Check the DEPTH: DEPTH='$(DEPTH)' PATH_CURRENT='$(PATH_CURRENT)')
726	endif
727
728	#
729	# Check for --pretty-command-printing before including the Config.kmk
730	# so that anyone overriding the message macros can take the implied
731	# verbosity level change into account.
732	#
733	ifndef KBUILD_VERBOSE
734	ifndef KBUILD_QUIET
735	ifneq ($(filter --pretty-command-printing,$(MAKEFLAGS)),)
736	export KBUILD_VERBOSE := 2
737	endif
738	endif
739	endif
740
741
742	# Include the config.kmk we found file (or the default one).
743	include $(_CFGFILE)
744
745
746	#
747	# Setup the message style. The default one is inlined.
748	#
749	# See kBuild/msgstyles for more styles or use KBUILD_MSG_STYLE_PATHS
750	# to create your own message style.
751	#
752	KBUILD_MSG_STYLE ?= default
753	ifeq ($(KBUILD_MSG_STYLE),default)
754	#
755	# The 'default' style.
756	#
757
758	## Fetch starting.
759	# @param 1 Target name.
760	MSG_FETCH ?= $(call MSG_L1,Fetching $1...)
761	## Re-fetch starting.
762	# @param 1 Target name.
763	MSG_REFETCH ?= $(call MSG_L1,Re-fetching $1...)
764	## Downloading a fetch component.
765	# @param 1 Target name.
766	# @param 2 The source URL.
767	# @param 3 The destination file name.
768	MSG_FETCH_DL ?= $(call MSG_L1,Downloading $1 - $2,=> $3)
769	## Checking a fetch component.
770	# @param 1 Target name.
771	# @param 2 The source URL.
772	# @param 3 The destination file name.
773	MSG_FETCH_CHK?= $(call MSG_L1,Checking $1 - $3, ($2))
774	## Unpacking a fetch component.
775	# @param 1 Target name.
776	# @param 2 The archive file name.
777	# @param 3 The target directory.
778	MSG_FETCH_UP ?= $(call MSG_L1,Unpacking $1 - $2 => $3)
779	## Fetch completed.
780	# @param 1 Target name.
781	MSG_FETCH_OK ?= $(call MSG_L1,Successfully fetched $1)
782	## Unfetch a fetch target.
783	# @param 1 Target name.
784	MSG_UNFETCH ?= $(call MSG_L1,Unfetching $1...)
785	## Compiling a source file.
786	# @param 1 Target name.
787	# @param 2 The source filename.
788	# @param 3 The primary link output file name.
789	# @param 4 The source type (CXX,C,AS,RC,++).
790	MSG_COMPILE ?= $(call MSG_L1,Compiling $1 - $2,=> $3)
791	## Linking a bldprog/dll/program/sysmod target.
792	# @param 1 Target name.
793	# @param 2 The primary link output file name.
794	# @param 3 The link tool operation (LINK_LIBRARY,LINK_PROGRAM,LINK_DLL,LINK_SYSMOD,++).
795	MSG_LINK ?= $(call MSG_L1,Linking $1,=> $2)
796	## Creating a directory (build).
797	# @param 1 Directory name.
798	MSG_MKDIR ?= $(call MSG_L2,Creating directory $1)
799	## Cleaning.
800	MSG_CLEAN ?= $(call MSG_L1,Cleaning...)
801	## Nothing.
802	MSG_NOTHING ?= $(call MSG_L1,Did nothing in $(CURDIR))
803	## Pass
804	# @param 1 The pass name.
805	MSG_PASS ?= $(call MSG_L1,Pass - $1)
806	## Installing a bldprog/lib/dll/program/sysmod target.
807	# @param 1 Target name.
808	# @param 2 The source filename.
809	# @param 3 The destination file name.
810	MSG_INST_TRG ?= $(call MSG_L1,Installing $1 => $3)
811	## Installing a file (install target).
812	# @param 1 The source filename.
813	# @param 2 The destination filename.
814	MSG_INST_FILE?= $(call MSG_L1,Installing $2,(<= $1))
815	## Installing a symlink.
816	# @param 1 Symlink
817	# @param 2 Link target
818	MSG_INST_SYM ?= $(call MSG_L1,Installing symlink $1,=> $2)
819	## Installing a directory.
820	# @param 1 Directory name.
821	MSG_INST_DIR ?= $(call MSG_L1,Installing directory $1)
822
823	else
824	_KBUILD_MSG_STYLE_FILE := $(firstword $(foreach path, $(KBUILD_MSG_STYLE_PATHS) $(PATH_KBUILD)/msgstyles, $(wildcard $(path)/$(KBUILD_MSG_STYLE).kmk)))
825	ifneq ($(_KBUILD_MSG_STYLE_FILE),)
826	include $(_KBUILD_MSG_STYLE_FILE)
827	else
828	$(error kBuild: Can't find the style setup file for KBUILD_MSG_STYLE '$(KBUILD_MSG_STYLE)')
829	endif
830	endif
831
832
833	#
834	# Message macros.
835	#
836	# This is done after including Config.kmk as to allow for
837	# KBUILD_QUIET and KBUILD_VERBOSE to be configurable.
838	#
839	ifdef KBUILD_QUIET
840	# No output
841	QUIET := @
842	QUIET2:= @
843	MSG_L1 =
844	MSG_L2 =
845	else
846	ifndef KBUILD_VERBOSE
847	# Default output level.
848	QUIET := @
849	QUIET2 := @
850	MSG_L1 ?= @$(ECHO) "kBuild: $1"
851	MSG_L2 =
852	else ifeq ($(KBUILD_VERBOSE),1)
853	# A bit more output
854	QUIET := @
855	QUIET2 := @
856	MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
857	MSG_L2 =
858	else ifeq ($(KBUILD_VERBOSE),2)
859	# Lot more output
860	QUIET :=
861	QUIET2 := @
862	MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
863	MSG_L2 ?= @$(ECHO) "kBuild: $1"
864	else
865	# maximal output.
866	QUIET :=
867	QUIET2 :=
868	MSG_L1 ?= @$(ECHO) "kBuild: $1 $2"
869	MSG_L2 ?= @$(ECHO) "kBuild: $1"
870	endif
871	endif
872
873
874
875	# end-of-file-content
876	__header_kmk__ := 1
877	endif # __header_kmk__
878

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format