Context Navigation

footer.kmk@ 1330

Last change on this file since 1330 was 1311, checked in by bird, 18 years ago
double -> single quotes for APPEND. Dropped check for -v and -n support.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 97.7 KB

Line
1	# $Id: footer.kmk 1311 2007-12-02 05:06:38Z 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 source 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 __footer_kmk__
28	# start-of-file-content
29	ifdef KBUILD_PROFILE_SELF
30	_KBUILD_TS_FOOTER_START := $(nanots )
31	$(info prof: $(int-sub $(_KBUILD_TS_FOOTER_START), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_FOOTER_START), $(_KBUILD_TS_PREV)) - start of footer.kmk)
32	_KBUILD_TS_PREV := $(_KBUILD_TS_FOOTER_START)
33	endif
34
35	#
36	# Variables.
37	# (Some of these need initialization before including definitions using them.)
38	#
39
40	# All targets of each types.
41	_ALL_BLDPROGS := $(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)) $(BLDPROGS.$(BUILD_PLATFORM_ARCH)) $(BLDPROGS.$(BUILD_PLATFORM_CPU)) $(BLDPROGS.$(BUILD_TYPE))
42	_ALL_LIBRARIES := $(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(LIBRARIES.$(BUILD_TARGET_ARCH)) $(LIBRARIES.$(BUILD_TARGET_CPU)) $(LIBRARIES.$(BUILD_TYPE))
43	_ALL_IMPORT_LIBS := $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(IMPORT_LIBS.$(BUILD_TARGET_ARCH)) $(IMPORT_LIBS.$(BUILD_TARGET_CPU)) $(IMPORT_LIBS.$(BUILD_TYPE))
44	_ALL_DLLS := $(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(DLLS.$(BUILD_TARGET_ARCH)) $(DLLS.$(BUILD_TARGET_CPU)) $(DLLS.$(BUILD_TYPE))
45	_ALL_PROGRAMS := $(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(PROGRAMS.$(BUILD_TARGET_ARCH)) $(PROGRAMS.$(BUILD_TARGET_CPU)) $(PROGRAMS.$(BUILD_TYPE))
46	_ALL_SYSMODS := $(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(SYSMODS.$(BUILD_TARGET_ARCH)) $(SYSMODS.$(BUILD_TARGET_CPU)) $(SYSMODS.$(BUILD_TYPE))
47	_ALL_OTHERS := $(OTHERS) $(OTHERS.$(BUILD_TARGET)) $(OTHERS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(OTHERS.$(BUILD_TARGET_ARCH)) $(OTHERS.$(BUILD_TARGET_CPU)) $(OTHERS.$(BUILD_TYPE))
48	_ALL_INSTALLS := $(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(INSTALLS.$(BUILD_TARGET_ARCH)) $(INSTALLS.$(BUILD_TARGET_CPU)) $(INSTALLS.$(BUILD_TYPE))
49	_ALL_FETCHES := $(FETCHES) $(FETCHES.$(BUILD_TARGET)) $(FETCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(FETCHES.$(BUILD_TARGET_ARCH)) $(FETCHES.$(BUILD_TARGET_CPU)) $(FETCHES.$(BUILD_TYPE))
50	_ALL_PATCHES := $(PATCHES) $(PATCHES.$(BUILD_TARGET)) $(PATCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) $(PATCHES.$(BUILD_TARGET_ARCH)) $(PATCHES.$(BUILD_TARGET_CPU)) $(PATCHES.$(BUILD_TYPE))
51
52	# all targets.
53	_ALL_TARGETS = \
54	$(_ALL_FETCHES) \
55	$(_ALL_PATCHES) \
56	$(_ALL_BLDPROGS) \
57	$(_ALL_LIBRARIES) \
58	$(_ALL_IMPORT_LIBS) \
59	$(_ALL_DLLS) \
60	$(_ALL_PROGRAMS) \
61	$(_ALL_SYSMODS) \
62	$(_ALL_INSTALLS) \
63	$(_ALL_OTHERS)
64
65	# all $(BUILD_TARGET) targets.
66	_ALL_BUILD_TARGET_TARGETS = \
67	$(_ALL_FETCHES) \
68	$(_ALL_PATCHES) \
69	$(_ALL_LIBRARIES) \
70	$(_ALL_IMPORT_LIBS) \
71	$(_ALL_DLLS) \
72	$(_ALL_PROGRAMS) \
73	$(_ALL_SYSMODS) \
74	$(_ALL_INSTALLS) \
75	$(_ALL_OTHERS)
76
77	# all $(BUILD_PLATFORM) targets.
78	_ALL_BUILD_PLATFORM_TARGETS = \
79	$(_ALL_BLDPROGS)
80
81	# all targets making use of srcname.
82	_ALL_SRCNAME_TARGETS = \
83	$(_ALL_FETCHES) \
84	$(_ALL_PATCHES)
85
86	# dependency files.
87	_DEPFILES :=
88
89	# included dependency files.
90	_DEPFILES_INCLUDED :=
91
92
93	# All kind of output files except for _OBJS and _DEPFILES.
94	# Compiling or linking definition outputting other things that $@ and any
95	# required dependency file must add those output files to this variable.
96	_OUT_FILES :=
97
98	# Files which only requires cleaning up.
99	_CLEAN_FILES :=
100
101	# all of a type
102	_OBJS :=
103	_FETCHES :=
104	_DOWNLOADS:=
105	_UNPACKS :=
106	_PATCHES :=
107	_UNFETCHES:=
108	_BLDPROGS :=
109	_LIBS :=
110	_DLLS :=
111	_PROGRAMS :=
112	_SYSMODS :=
113	_INSTALLS :=
114	_INSTALLS_FILES :=
115	_INSTALLS_DIRS :=
116	_OTHERS :=
117	_PACKING :=
118	_DIRS := $(PATH_TARGET)/ $(PATH_TARGET) $(BLDDIRS)
119	_IMPORT_LIBS :=
120
121	# misc
122	pass_prev :=
123
124
125
126	#
127	# Footer macros
128	#
129
130	## Figure out the tool for a target.
131	# @param $1 normalized target.
132	# @param $2 tooltype.
133	# @param bld_trg build target.
134	# @param bld_trg_arch build target architecture.
135	_TARGET_TOOL = $(strip $(firstword \
136	$($(1)_$(2)TOOL.$(bld_trg).$(bld_trg_arch)) \
137	$($(1)_$(2)TOOL.$(bld_trg)) \
138	$($(1)_$(2)TOOL) \
139	$($(1)_TOOL.$(bld_trg).$(bld_trg_arch)) \
140	$($(1)_TOOL.$(bld_trg)) \
141	$($(1)_TOOL) \
142	$($(2)TOOL.$(bld_trg).$(bld_trg_arch)) \
143	$($(2)TOOL.$(bld_trg)) \
144	$($(2)TOOL) \
145	$(TOOL.$(bld_trg).$(bld_trg_arch)) \
146	$(TOOL.$(bld_trg)) \
147	$(TOOL) \
148	))
149
150	## Figure out the actual name of an installed file.
151	# @param $1 The file to install.
152	# @param $2 The target name.
153	# @param $3 The _INST value (can be empty).
154	# @param $4 The default directory to use when $3 is empty.
155	_INSTALL_FILE = $(patsubst %/,%/$(notdir $(1)),$(if $(3),$(PATH_INS)/$(3),$(4)/))
156
157
158	## Inherit one template property in a non-accumulative manner.
159	# @param $(prop) Property name
160	# @param $(src) Source (parent) object.
161	# @param $(trg) Target (child) object.
162	# @remark Not all properties has all the variations, but making the correct
163	# exceptions will only complicate matters and probably not gain much speed.
164	define def_inherit_one
165	ifdef $(src)_$(prop)
166	ifndef $(trg)_$(prop)
167	$(trg)_$(prop) = $($(src)_$(prop))
168	#$ (warning dbg-inherit: $(trg)_$(prop) = $($(src)_$(prop)) )
169	endif
170	endif
171	endef # def_inherit_one
172
173	## Inherit one template property in a non-accumulative manner.
174	# @param $(prop) Property name
175	# @param $(src) Source (parent) object.
176	# @param $(trg) Target (child) object.
177	# @remark Not all properties has all the variations, but making the correct
178	# exceptions will only complicate matters and probably not gain much speed.
179	# @todo Check how/if this differs from def_inherit_one.
180	define def_inherit_one_now
181	ifdef $(src)_$(prop)
182	ifndef $(trg)_$(prop)
183	$(trg)_$(prop) := $($(src)_$(prop))
184	#$ (warning dbg-inherit-now: $(trg)_$(prop) = $($(src)_$(prop)) )
185	endif
186	endif
187	endef # def_inherit_one_now
188
189	## Inherit one template property in a non-accumulative manner, deferred expansion.
190	# @param $(prop) Property name
191	# @param $(src) Source
192	# @param $(trg) Target
193	# @remark This define relies on double evaluation
194	define def_inherit_one_deferred
195	ifdef $(src)_$(prop)
196	ifndef $(trg)_$(prop)
197	$(trg)_$(prop) = $$($(src)_$(prop))
198	#$ (warning dbg-inherit-def: $(trg)_$(prop) = $($(src)_$(prop)) )
199	endif
200	endif
201	endef # def_inherit_one_deferred
202
203	## Generic inheritance for use with targets templates and tools.
204	# @param trg Object to consider for inheriting.
205	# @param src_prefix What to prefix the value found in EXTENDS with to get the object.
206	# @param properties List of the properties with straight expansion.
207	# @param properties_now List of the properties with immediate expansion.
208	# @param properties_deferred List of the properties with deferred expansion (e.g. function).
209	define def_inherit
210	src := $(strip $($(trg)_EXTENDS))
211	ifneq ($(src),)
212	ifndef $(trg)_EXTENDS_STATUS_
213	$(trg)_EXTENDS_STATUS_ := 0
214	src := $(src_prefix)$(src)
215
216	# Recursivly process the parent (src) if it's inherting from somebody too.
217	ifdef $(src)_EXTENDS
218	ifneq ($($(src)_EXTENDS_STATUS_),42)
219	# 'foreach' will create 'trg' in a new variable context hiding
220	# out current variable. 'src' OTOH will be overwritten.
221	#$ (warning def_inherit: recursing into $(src) from $(trg))
222	$(foreach trg, $(src), $(eval $(value def_inherit)))
223	src := $(src_prefix)$(strip $($(trg)_EXTENDS))
224	endif
225	endif
226
227	# Inherit the properties and mark the trg done.
228	#$ (warning def_inherit: trg=$(trg) src=$(src))
229	$(foreach prop, $(properties), $(eval $(def_inherit_one)))
230	$(foreach prop, $(properties_now), $(eval $(def_inherit_one_now)))
231	$(foreach prop, $(properties_deferred), $(eval $(def_inherit_one_deferred)))
232	$(trg)_EXTENDS_STATUS_ := 42
233	else
234	# Check for inheritance loops.
235	ifneq ($($(trg)_EXTENDS_STATUS_),42)
236	$(error kBuild: Target inheritance loop! target=$(trg) $(trg)_EXTENDS_STATUS_=$($(trg)_EXTENDS_STATUS_))
237	endif
238	endif
239	endif
240	endef # def_inherit
241
242
243	#
244	# Determin all the templates that is being used and make
245	# sure they are present.
246	#
247	_TEMPLATES := $(TEMPLATE)
248	define def_templates
249	ifdef $(target)_TEMPLATE
250	ifneq ("$($(target)_TEMPLATE)","$(strip $($(target)_TEMPLATE))")
251	$$(error kBuild: The template name of target '$(target)' contains tabs ($($(target)_TEMPLATE))). Please remove them)
252	endif
253	_TEMPLATES += $($(target)_TEMPLATE)
254	endif
255	endef # def_templates
256	$(foreach target, $(_ALL_TARGETS), $(eval $(def_templates)))
257	_TEMPLATES := $(sort $(_TEMPLATES))
258
259	define def_templates_include
260	ifndef TEMPLATE_$(template)
261	TEMPLATE_$(template)_INCLUDE_FILE_ := $(firstword $(foreach path, $(TEMPLATE_PATHS) $(PATH_KBUILD)/templates/, $(wildcard $(path)/$(template).kmk)))
262	ifneq ($(TEMPLATE_$(template)_INCLUDE_FILE_),)
263	include $(TEMPLATE_$(template)_INCLUDE_FILE_)
264	else
265	$$(error kBuild: Cannot find template '$(template)')
266	endif
267	endif
268	endef # def_templates_include
269	$(foreach template, $(_TEMPLATES), $(eval $(def_templates)))
270
271	#$ (warning dbg _TEMPLATES := $(_TEMPLATES))
272
273
274	#
275	# Determin the BLD_TRG_* keywords required for correct inherting.
276	#
277	# This means walking all the template and target lists in order to
278	# pick up all BLD_TRG_* attributes.
279	#
280	_BLD_TYPES := $(BUILD_TYPE)
281	_BLD_TARGETS := $(BUILD_TARGET) $(BUILD_PLATFORMS)
282	_BLD_ARCHES := $(BUILD_TARGET_ARCH) $(BUILD_PLATFORM_ARCH)
283	_BLD_CPUS := $(BUILD_TARGET_CPU) $(BUILD_PLATFORM_CPU)
284
285	define def_collect_bld_xyz
286	ifdef ($(src)_BLD_TYPE)
287	_BLD_TYPE += $($(src)_BLD_TYPE)
288	endif
289	ifdef ($(src)_BLD_TRG)
290	_BLD_TARGETS += $($(src)_BLD_TRG)
291	endif
292	ifdef ($(src)_BLD_TRG_ARCH)
293	_BLD_ARCHES += $($(src)_BLD_TRG_ARCH)
294	endif
295	ifdef ($(src)_BLD_TRG_CPU)
296	_BLD_CPU += $($(src)_BLD_TRG_CPU)
297	endif
298	endef # def_collect_bld_xyz
299	$(foreach src, $(addprefix TEMPLATE_, $(_TEMPLATES)) $(_ALL_TARGETS)\
300	,$(eval $(def_collect_bld_xyz)))
301
302	# drop duplicate values
303	_BLD_TYPES := $(sort $(_BLD_TYPES))
304	_BLD_TARGETS := $(sort $(_BLD_TARGETS))
305	_BLD_ARCHES := $(sort $(_BLD_ARCHES))
306	_BLD_CPUS := $(sort $(_BLD_CPUS))
307
308	# Construct all the possible keywords.
309	_KEYWORDS := $(_BLD_TYPES) $(_BLD_TARGETS) $(_BLD_ARCHES) $(_BLD_CPUS) \
310	$(foreach bld_trg,$(_BLD_TARGETS),$(addprefix $(bld_trg).,$(_BLD_ARCHES)))
311	# $ (warning dbg _KEYWORDS := $(_KEYWORDS))
312
313	ifdef KBUILD_PROFILE_SELF
314	_KBUILD_TS_NOW := $(nanots )
315	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done keywords)
316	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
317	endif
318
319
320	#
321	# Target inheritance.
322	#
323	# This has to be done on a per target list basis as to avoid adding
324	# incorrect properties that will wast memory, time, and may confuse
325	# later strictness checks. This also has to be done before templates
326	# are applied to the targets. Since we're doing that part rather
327	# early on, the target inheritance feature is a bit restricted at
328	# the moment. However, this will be addressed in a little(?) while.
329	#
330
331	src_prefix :=
332	## combines the specified properties $(1) with the $(_KEYWORDS).
333	_COMB_KEY_PROP = $(1) $(foreach keyword,$(_KEYWORDS), $(addsuffix .$(keyword), $(1)))
334
335	# Fetches.
336	properties := $(call _COMB_KEY_PROP,$(PROPS_FETCHES_SINGLE))
337	properties_now := $(call _COMB_KEY_PROP,$(PROPS_FETCHES_ACCUMULATE_R) $(PROPS_FETCHES_ACCUMULATE_L))
338	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_FETCHES_DEFERRED))
339	$(foreach trg, $(_ALL_FETCHES),$(eval $(value def_inherit)))
340
341	## Patches. - not implemented yet.
342	#properties := $(call _COMB_KEY_PROP,$(PROPS_PATCHES_SINGLE))
343	#properties_now := $(call _COMB_KEY_PROP,$(PROPS_PATCHES_ACCUMULATE_R) $(PROPS_PATCHES_ACCUMULATE_L))
344	#properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_PATCHES_DEFERRED))
345	#$(foreach trg, $(_ALL_PATCHES),$(eval $(value def_inherit)))
346
347	# Programs and build programs.
348	properties := $(call _COMB_KEY_PROP,$(PROPS_PROGRAMS_SINGLE))
349	properties_now := $(call _COMB_KEY_PROP,$(PROPS_PROGRAMS_ACCUMULATE_R) $(PROPS_PROGRAMS_ACCUMULATE_L))
350	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_PROGRAMS_DEFERRED))
351	$(foreach trg, $(_ALL_BLDPROGS) $(_ALL_PROGRAMS),$(eval $(value def_inherit)))
352
353	# Libraries and import libraries.
354	properties := $(call _COMB_KEY_PROP,$(PROPS_LIBRARIES_SINGLE))
355	properties_now := $(call _COMB_KEY_PROP,$(PROPS_LIBRARIES_ACCUMULATE_R) $(PROPS_LIBRARIES_ACCUMULATE_L))
356	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_LIBRARIES_DEFERRED))
357	ifeq ($(filter-out nt os2 win win64 win32,$(BUILD_TARGET)),)
358	$(foreach trg, $(_ALL_LIBRARIES) $(_ALL_IMPORT_LIBS),$(eval $(value def_inherit)))
359	else
360	$(foreach trg, $(_ALL_LIBRARIES),$(eval $(value def_inherit)))
361	endif
362
363	# DLLs.
364	properties := $(call _COMB_KEY_PROP,$(PROPS_DLLS_SINGLE))
365	properties_now := $(call _COMB_KEY_PROP,$(PROPS_DLLS_ACCUMULATE_R) $(PROPS_DLLS_ACCUMULATE_L))
366	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_DLLS_DEFERRED))
367	ifeq ($(filter-out nt os2 win win64 win32,$(BUILD_TARGET)),)
368	$(foreach trg, $(_ALL_DLLS),$(eval $(value def_inherit)))
369	else
370	$(foreach trg, $(_ALL_DLLS) $(_ALL_IMPORT_LIBS),$(eval $(value def_inherit)))
371	endif
372
373	# System modules.
374	properties := $(call _COMB_KEY_PROP,$(PROPS_SYSMODS_SINGLE))
375	properties_now := $(call _COMB_KEY_PROP,$(PROPS_SYSMODS_ACCUMULATE_R) $(PROPS_SYSMODS_ACCUMULATE_L))
376	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_SYSMODS_DEFERRED))
377	$(foreach trg, $(_ALL_SYSMODS),$(eval $(value def_inherit)))
378
379	# Installs.
380	properties := $(call _COMB_KEY_PROP,$(PROPS_INSTALLS_SINGLE))
381	properties_now := $(call _COMB_KEY_PROP,$(PROPS_INSTALLS_ACCUMULATE_R) $(PROPS_INSTALLS_ACCUMULATE_L))
382	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_INSTALLS_DEFERRED))
383	$(foreach trg, $(_ALL_INSTALLS),$(eval $(value def_inherit)))
384
385	ifdef KBUILD_PROFILE_SELF
386	_KBUILD_TS_NOW := $(nanots )
387	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done target inheritance)
388	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
389	endif
390
391
392	#
393	# Template Inheritance.
394	#
395	# This is much the same as with target inheritance, except we cannot
396	# restrict the properties involved since we've got a clue which target
397	# types are using them. But, we can drop the instance expansion we're
398	# doing for targets since there won't be any more changes to either the
399	# source nor the target templates beyond this exercise.
400	#
401
402	src_prefix := TEMPLATE_
403	properties :=
404	properties_now :=
405	properties_deferred := $(call _COMB_KEY_PROP,$(PROPS_ALL))
406	$(foreach trg, $(addprefix TEMPLATE_,$(_TEMPLATES)),$(eval $(value def_inherit)))
407
408	# done.
409	src_prefix :=
410	properties :=
411	properties_now :=
412	properties_deferred :=
413
414	ifdef KBUILD_PROFILE_SELF
415	_KBUILD_TS_NOW := $(nanots )
416	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done template inheritance)
417	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
418	endif
419
420
421	#
422	# Common Inheritance
423	#
424
425	## Inherit one template property in a non-accumulative manner.
426	# @param $(prop) Property name
427	# @param $(target) Target name
428	# @todo fix the precedence order for some properties.
429	define def_inherit_template_one
430	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
431	ifndef $(target)_$(prop)
432	$(target)_$(prop) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
433	#$ (warning dbgtarget: $(target)_$(prop):='$(value $(target)_$(prop))' TEMPLATE_$($(target)_TEMPLATE)_$(prop))
434	endif
435	endif
436	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
437	ifndef $(target)_$(prop).$(bld_trg)
438	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
439	$(target)_$(prop).$(bld_trg) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
440	endif
441	endif
442	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
443	ifndef $(target)_$(prop).$(bld_trg).$(bld_trg_arch)
444	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
445	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
446	endif
447	endif
448	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
449	ifndef $(target)_$(prop).$(bld_trg_arch)
450	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
451	$(target)_$(prop).$(bld_trg_arch) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
452	endif
453	endif
454	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
455	ifndef $(target)_$(prop).$(bld_trg_cpu)
456	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_cpu)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
457	$(target)_$(prop).$(bld_trg_cpu) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
458	endif
459	endif
460	endef
461
462	## Inherit one template property in a non-accumulative manner, deferred expansion.
463	# @param 1: $(prop) Property name
464	# @param 2: $(target) Target name
465	# @todo fix the precedence order for some properties.
466	# @remark this define relies on double evaluation
467	define def_inherit_template_one_deferred
468	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
469	ifndef $(target)_$(prop)
470	$(target)_$(prop) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
471	#$ (warning dbgtarget: $(target)_$(prop):='$(value $(target)_$(prop))' TEMPLATE_$($(target)_TEMPLATE)_$(prop))
472	endif
473	endif
474	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
475	ifndef $(target)_$(prop).$(bld_trg)
476	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
477	$(target)_$(prop).$(bld_trg) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
478	endif
479	endif
480	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
481	ifndef $(target)_$(prop).$(bld_trg).$(bld_trg_arch)
482	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
483	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
484	endif
485	endif
486	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
487	ifndef $(target)_$(prop).$(bld_trg_arch)
488	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
489	$(target)_$(prop).$(bld_trg_arch) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
490	endif
491	endif
492	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
493	ifndef $(target)_$(prop).$(bld_trg_cpu)
494	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_cpu)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
495	$(target)_$(prop).$(bld_trg_cpu) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
496	endif
497	endif
498	endef
499
500	## Inherit one acculumlative template property where the 'most significant' items are at the left end.
501	# @param $(prop) Property name
502	# @param $(target) Target name
503	define def_inherit_template_one_accumulate_l
504	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
505	#$ (warning dbgtype: TEMPLATE_$($(target)_TEMPLATE)_$(prop) $(target)_$(prop)=$($(target)_$(prop)) $(TEMPLATE_$($(target)_TEMPLATE)_$(prop)))
506	$(target)_$(prop) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
507	#$ (warning dbgtype: $(target)_$(prop)=$($(target)_$(prop)))
508	endif
509	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE)
510	#$ (warning dbg4: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE))
511	$(target)_$(prop).$(BUILD_TYPE) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE))
512	endif
513	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
514	#$ (warning dbg5: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
515	$(target)_$(prop).$(bld_trg) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
516	endif
517	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
518	#$ (warning dbg4: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
519	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
520	endif
521	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
522	#$ (warning dbg5: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
523	$(target)_$(prop).$(bld_trg_cpu) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
524	endif
525	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
526	#$ (warning dbg6: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
527	$(target)_$(prop).$(bld_trg_arch) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
528	endif
529	endef
530
531	## Inherit one acculumlative template property where the 'most significant' items are at the right end.
532	# @param $(prop) Property name
533	# @param $(target) Target name
534	define def_inherit_template_one_accumulate_r
535	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
536	#$ (warning dbgtype: TEMPLATE_$($(target)_TEMPLATE)_$(prop) $(target)_$(prop)=$($(target)_$(prop)) $(TEMPLATE_$($(target)_TEMPLATE)_$(prop)))
537	$(target)_$(prop) <=$$(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
538	#$ (warning dbgtype: $(target)_$(prop)=$($(target)_$(prop)))
539	endif
540	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE)
541	#$ (warning dbg4: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE))
542	$(target)_$(prop).$(BUILD_TYPE) <=$$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE))
543	endif
544	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
545	#$ (warning dbg5: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
546	$(target)_$(prop).$(bld_trg) <=$$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
547	endif
548	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
549	#$ (warning dbg4: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
550	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) <=$$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
551	endif
552	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
553	#$ (warning dbg5: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
554	$(target)_$(prop).$(bld_trg_cpu) <=$$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
555	endif
556	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
557	#$ (warning dbg6: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
558	$(target)_$(prop).$(bld_trg_arch) <=$$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
559	endif
560	endef
561
562
563	## Inherit template properties for on target.
564	# @param $(target) Target name.
565	define def_inherit_template
566	# sanity check.
567	ifdef _$(target)_ALREADY_PROCESSED
568	$(error kBuild: The target $(target) appears more than once in the target lists! Please correct the makefile(s))
569	endif
570	_$(target)_ALREADY_PROCESSED := 1
571
572	# Inherit any default template.
573	ifdef TEMPLATE
574	ifeq ($($(target)_TEMPLATE),)
575	$(eval $(target)_TEMPLATE:=$(TEMPLATE))
576	endif
577	endif
578	# Expand the template if specified.
579	ifneq ($($(target)_TEMPLATE),)
580	$(foreach prop,$(PROPS_SINGLE),$(eval $(value def_inherit_template_one)))
581	$(foreach prop,$(PROPS_DEFERRED),$(eval $(def_inherit_template_one_deferred))) # exploits the 2 evaluation, so no value!
582	$(foreach prop,$(PROPS_ACCUMULATE_L),$(eval $(def_inherit_template_one_accumulate_l))) # += works fine without value
583	$(foreach prop,$(PROPS_ACCUMULATE_R),$(eval $(def_inherit_template_one_accumulate_r))) # use <= (kmk addition)
584	endif
585	endef
586
587	# Inherit template properties
588	bld_trg := $(BUILD_TARGET)
589	bld_trg_arch := $(BUILD_TARGET_ARCH)
590	bld_trg_cpu := $(BUILD_TARGET_CPU)
591	$(foreach target, $(_ALL_BUILD_TARGET_TARGETS),$(eval $(value def_inherit_template)))
592
593	bld_trg := $(BUILD_PLATFORM)
594	bld_trg_arch := $(BUILD_PLATFORM_ARCH)
595	bld_trg_cpu := $(BUILD_PLATFORM_CPU)
596	$(foreach target, $(_ALL_BUILD_PLATFORM_TARGETS),$(eval $(value def_inherit_template)))
597
598	ifdef KBUILD_PROFILE_SELF
599	_KBUILD_TS_NOW := $(nanots )
600	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done common inheritance)
601	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
602	endif
603
604
605	#
606	# Include tools & sdks
607	#
608	# The first part of this exercise is to figure out which TOOLS and SDKS
609	# that should be included.
610	#
611	_TOOLS := $(TOOL.$(BUILD_TARGET)) $(TOOL.$(BUILD_TARGET_ARCH)) $(TOOL.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
612	$(TOOL.$(BUILD_PLATFORM)) $(TOOL.$(BUILD_PLATFORM_ARCH)) $(TOOL.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)) \
613	$(TOOL)
614	_SDKS := $(SDKS.$(BUILD_TARGET)) $(SDKS.$(BUILD_TARGET_ARCH)) $(SDKS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
615	$(SDKS.$(BUILD_PLATFORM)) $(SDKS.$(BUILD_PLATFORM_ARCH)) $(SDKS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)) \
616	$(SDKS.$(BUILD_TYPE)) \
617	$(SDKS)
618	define def_tools_sdks_target_source
619	$(eval _TOOLS += $(foreach prop, $(PROPS_TOOLS), \
620	$($(source)_$(prop).$(_bld_trg)) \
621	$($(target)_$(source)_$(prop).$(_bld_trg)) \
622	$($(source)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
623	$($(target)_$(source)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
624	$($(source)_$(prop).$(_bld_trg_arch)) \
625	$($(target)_$(source)_$(prop).$(_bld_trg_arch)) \
626	$($(source)_$(prop)) \
627	$($(target)_$(source)_$(prop))))
628	$(eval _SDKS += \
629	$($(source)_SDKS.$(_bld_trg)) \
630	$($(target)_$(source)_SDKS.$(_bld_trg)) \
631	$($(source)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
632	$($(target)_$(source)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
633	$($(source)_SDKS.$(_bld_trg_arch)) \
634	$($(target)_$(source)_SDKS.$(_bld_trg_arch)) \
635	$($(source)_SDKS.$(BUILD_TYPE)) \
636	$($(target)_$(source)_SDKS.$(BUILD_TYPE)) \
637	$($(source)_SDKS) \
638	$($(target)_$(source)_SDKS))
639	endef # def_tools_sdks_target_source
640
641	define def_tools_sdks_target
642	_bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
643	_bld_trg := $(firstword $($(target)_BLD_TRG) $(bld_trg))
644	_bld_trg_arch := $(firstword $($(target)_BLD_TRG_ARCH) $(bld_trg_arch))
645	_bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(bld_trg_cpu))
646
647	$(eval _TOOLS += $(foreach prop, $(PROPS_TOOLS), \
648	$($(target)_$(prop).$(_bld_trg)) \
649	$($(target)_$(prop).$(_bld_trg_arch)) \
650	$($(target)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
651	$($(target)_$(prop))))
652	$(eval _SDKS += \
653	$($(target)_SDKS.$(_bld_trg)) \
654	$($(target)_SDKS.$(_bld_trg_arch)) \
655	$($(target)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
656	$($(target)_SDKS))
657	$(foreach source, \
658	$($(target)_SOURCES.$(_bld_trg)) \
659	$($(target)_SOURCES.$(_bld_trg_arch)) \
660	$($(target)_SOURCES.$(_bld_trg).$(_bld_trg_arch)) \
661	$($(target)_SOURCES.$(_bld_trg_cpu)) \
662	$($(target)_SOURCES.$(_bld_type)) \
663	$($(target)_SOURCES) \
664	, $(eval $(value def_tools_sdks_target_source)))
665	endef # def_tools_sdks_target
666
667	define def_tools_srcname_target
668	_bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
669	_bld_trg := $(firstword $($(target)_BLD_TRG) $(bld_trg))
670	_bld_trg_arch := $(firstword $($(target)_BLD_TRG_ARCH) $(bld_trg_arch))
671	_bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(bld_trg_cpu))
672
673	$(foreach source, $(notdir\
674	$($(target)_SOURCES.$(_bld_trg)) \
675	$($(target)_SOURCES.$(_bld_trg_arch)) \
676	$($(target)_SOURCES.$(_bld_trg).$(_bld_trg_arch)) \
677	$($(target)_SOURCES.$(_bld_trg_cpu)) \
678	$($(target)_SOURCES.$(_bld_type)) \
679	$($(target)_SOURCES) \
680	), $(eval $(value def_tools_sdks_target_source)))
681	endef # def_tools_srcname_target
682
683	bld_trg := $(BUILD_TARGET)
684	bld_trg_arch := $(BUILD_TARGET_ARCH)
685	bld_trg_cpu := $(BUILD_TARGET_CPU)
686	$(foreach target, $(_ALL_BUILD_TARGET_TARGETS), $(eval $(value def_tools_sdks_target)))
687	$(foreach target, $(_ALL_SRCNAME_TARGETS), $(eval $(value def_tools_srcname_target)))
688
689	bld_trg := $(BUILD_PLATFORM)
690	bld_trg_arch := $(BUILD_PLATFORM_ARCH)
691	bld_trg_cpu := $(BUILD_PLATFORM_CPU)
692	$(foreach target, $(_ALL_BUILD_PLATFORM_TARGETS), $(eval $(value def_tools_sdks_target)))
693
694
695	# include TOOLS
696	define def_tools_include
697	ifndef TOOL_$(tool)
698	TOOL_$(tool)_KMK_FILE := $(firstword $(foreach path, $(TOOL_PATHS) $(PATH_KBUILD)/tools, $(wildcard $(path)/$(tool).kmk)))
699	ifeq ($(TOOL_$(tool)_KMK_FILE),)
700	$(error kBuild: Cannot find include file for the tool '$(tool)'! Searched: $(TOOL_PATHS) $(PATH_KBUILD)/tools)
701	endif
702	include $(TOOL_$(tool)_KMK_FILE)
703	ifndef TOOL_$(tool)
704	$(warning kBuild: TOOL_$(tool) was not by $(TOOL_$(tool)_KMK_FILE)!)
705	endif
706	endif
707	endef # def_tools_include
708
709	_TOOLS := $(sort $(_TOOLS))
710	$(foreach tool, $(_TOOLS), $(eval $(value def_tools_include)))
711
712
713	# include SDKS
714	define def_sdks_include_one
715	ifndef SDK_$(sdk)
716	SDK_$(sdk)_KMK_FILE := $(firstword $(foreach path, $(SDK_PATHS) $(PATH_KBUILD)/sdks, $(wildcard $(path)/$(sdk).kmk)))
717	ifeq ($(SDK_$(sdk)_KMK_FILE),)
718	$(error kBuild: Cannot find include file for the SDK '$(sdk)'! Searched: $(SDK_PATHS) $(PATH_KBUILD)/sdks)
719	endif
720	include $(SDK_$(sdk)_KMK_FILE)
721	ifndef SDK_$(sdk)
722	$(warning kBuild: SDK_$(sdk) was not defined by $(SDK_$(sdk)_KMK_FILE)!)
723	endif
724	endif
725	endef # def_sdks_include_one
726
727	_SDKS := $(sort $(_SDKS))
728	$(foreach sdk, $(_SDKS), $(eval $(value def_sdks_include_one)))
729
730	## @todo Execute SDKS and TOOL inhertiance.
731
732	ifdef KBUILD_PROFILE_SELF
733	_KBUILD_TS_NOW := $(nanots )
734	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done tools and sdks)
735	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
736	endif
737
738
739	#
740	#
741	# Target lists - Pass 1
742	#
743	# This pass is for defining variables that might be referenced in
744	# properties of other targets.
745	#
746	#
747
748	# Don't do anything for fetch targets (yet).
749
750	##
751	# Link prolog for Pass 1.
752	#
753	# @param $(target) Normalized target name.
754	# @param $(EXT) EXE,DLL,SYS,LIB.
755	# @param $(EXTPRE) HOST or nothing.
756	# @param $(definst) The default _INST value.
757	# @param $(tool_prefix) LD or AR.
758	# @param $(bld_trg_base_var) TARGET or PLATFORM.
759	define def_pass1_link_common
760
761	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
762	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_$(bld_trg_base_var)))
763	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_$(bld_trg_base_var)_ARCH))
764	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_$(bld_trg_base_var)_CPU))
765
766	tool := $(call _TARGET_TOOL,$(target),$(tool_prefix))
767	name := $(firstword\
768	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
769	$($(target)_NAME.$(bld_trg_arch))\
770	$($(target)_NAME.$(bld_trg))\
771	$($(target)_NAME.$(bld_type))\
772	$($(target)_NAME)\
773	$(target))
774	outbase := $(call TARGET_BASE,$(name),$(target))
775	ifndef PATH_$(target)
776	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
777	else ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
778	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
779	endif
780	ifeq ($(tool_prefix),AR) ## @todo fix this mess!
781	suff := $(firstword\
782	$($(target)_$(EXT)SUFF.$(bld_trg).$(bld_trg_arch))\
783	$($(target)_$(EXT)SUFF.$(bld_trg))\
784	$($(target)_$(EXT)SUFF)\
785	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF.$(bld_trg).$(bld_trg_arch))\
786	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF.$(bld_trg))\
787	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF)\
788	$(SUFF_LIB))
789	else
790	suff := $(firstword \
791	$($(target)_$(EXT)SUFF) \
792	$($(target)_$(EXT)SUFF) \
793	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF) \
794	$($(EXTPRE)SUFF_$(EXT)))
795	endif
796	out := $(outbase)$(suff)
797
798	# TARGET_*
799	TARGET_$(target) := $(out)
800
801	# INSTARGET_*
802	ifndef $(target)_NOINST
803	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
804	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
805
806	else # NOINST
807	INSTARGET_$(target) :=
808	endif # NOINST
809
810	endef
811
812
813	#
814	# BLDPROGS (Pass 1)
815	#
816	define def_pass1_bldprog
817	# set NOINST if not forced installation before doing the usual stuff.
818	ifndef $(target)_INST
819	$(target)_NOINST := 1
820	endif
821	$(eval $(value def_pass1_link_common))
822	endef
823
824	EXT := EXE
825	EXTPRE := HOST
826	definst := $(PATH_BIN)
827	tool_prefix := LD
828	bld_trg_base_var := PLATFORM
829	$(foreach target, $(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)), \
830	$(eval $(value def_pass1_bldprog)))
831
832
833	#
834	# LIBRARIES (Pass 1)
835	#
836	EXT := LIB
837	EXTPRE :=
838	definst := $(PATH_LIB)
839	tool_prefix := AR
840	bld_trg_base_var := TARGET
841	$(foreach target, $(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
842	$(eval $(value def_pass1_link_common)))
843
844
845	#
846	# DLLS (Pass 1)
847	#
848	EXT := DLL
849	EXTPRE :=
850	definst := $(PATH_DLL)
851	tool_prefix := LD
852	bld_trg_base_var := TARGET
853	$(foreach target, $(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
854	$(eval $(value def_pass1_link_common)))
855
856
857	#
858	# IMPORT LIBRARIES (Pass 1)
859	#
860	# - On OS/2 and windows these are libraries.
861	# - On other platforms they are fake DLLs.
862	#
863	if1of ($(BUILD_TARGET), nt os2 win win64 win32)
864	EXT := LIB
865	EXTPRE :=
866	definst := $(PATH_LIB)
867	tool_prefix := AR
868	bld_trg_base_var := TARGET
869	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
870	$(eval $(value def_pass1_link_common)))
871	else
872	EXT := DLL
873	EXTPRE :=
874	definst := $(PATH_DLL)
875	tool_prefix := LD
876	bld_trg_base_var := TARGET
877	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
878	$(eval $(value def_pass1_link_common)))
879	endif
880
881
882	#
883	# PROGRAMS (Pass 1)
884	#
885	EXT := EXE
886	EXTPRE :=
887	definst := $(PATH_BIN)
888	tool_prefix := LD
889	bld_trg_base_var := TARGET
890	$(foreach target, $(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
891	$(eval $(value def_pass1_link_common)))
892
893
894	#
895	# SYSMODS (Pass 1)
896	#
897	EXT := SYS
898	EXTPRE :=
899	definst := $(PATH_SYS)
900	tool_prefix := LD
901	bld_trg_base_var := TARGET
902	$(foreach target, $(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
903	$(eval $(value def_pass1_link_common)))
904
905
906	#
907	# INSTALLS (Pass 1)
908	# Note! INSTARGET_* for INSTALLS aren't available until later.
909	#
910	define def_pass1_install
911	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
912	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))
913	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_TARGET_ARCH))
914	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_TARGET_CPU))
915	# TARGET_*
916	TARGET_$(target) := $(PATH_TARGET)/$(target).ins
917	# INSTARGET_ later.
918	endef
919	$(foreach target, $(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
920	$(eval $(value def_pass1_install)))
921
922	ifdef KBUILD_PROFILE_SELF
923	_KBUILD_TS_NOW := $(nanots )
924	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done pass 1)
925	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
926	endif
927
928
929
930
931	#
932	#
933	# Target lists - Pass 2
934	#
935	#
936
937
938	## @page pg_fetches Fetching Tools, Sources and Similar.
939	#
940	# The targets listed in the the FETCHES target list have the following attributes:
941	# SOURCES
942	# INST
943	# FETCHTOOL
944	# FETCHFLAGS
945	# FETCHDIR
946	# UNPACKTOOL
947	# UNPACKFLAGS
948	#
949	# As usual the target name is an alias for 'creating' the target. Other
950	# aliases are:
951	# pass_fetches
952	# fetch
953	# unfetch
954	# download
955	# unpack
956	#
957	# @remark
958	#
959	# This is a little bit complex because we must guarantee that if a source file
960	# changes only sligtly we must refetch it and to a proper unpacking of it. It
961	# is also a desire that fetched archives and unpacked files can be deleted to
962	# save space.
963	#
964	# Thus, we must be able to cleanup what we've unpacked should any of the
965	# sources be removed. We do this by maintaining a file listing the files
966	# and directories that was unpacked. This operation is named 'unfetch'.
967	#
968	# We make use of the SIZE and MD5 attributes for each of the sources to
969	# create a digest that is stored in the primary target file. Subsequent
970	# runswill compare their digest with it to decide if a refetch is required.
971	# When a refetch is found necessary, an 'unfetch' is performed first to
972	# clean out old files and directores. Note even changes in source order
973	# will cause a refetch due to the way the digest is constructed and
974	# evaluated.
975	#
976	# By not depending directly on the archives (nor on any unpacked files)
977	# but on a goal made up from the archive name, size and md5, we allow
978	# the user to delete the archives. Naturally, this means we'll have to
979	# check and fetch missing archives before attempting to unpack them.
980	#
981	# @remark
982	#
983	# This feature will NOT work correctly with vanilla GNU make becuase
984	# it makes use of includedep to avoid too many unnecessary files.
985	#
986	# @todo
987	# 1. Download corruption / continuation.
988	# 2. It's quite possible that there is one too many indirect dependency now...
989	#
990
991	## generates the fetch rule
992	define def_fetch_src_fetch_rule
993	# Indirect goal for downloading something.
994	.PRECIOUS: $(out)
995	$(out) + $($(target)_$(srcname)_FETCH_OUTPUT_) +\| $($(target)_$(srcname)_FETCH_OUTPUT_MAYBE_) : \
996	\| $($(target)_$(srcname)_FETCH_DEPORD_)
997	$$(call MSG_FETCH_DL,$(target),$(source),$(out))
998	@## @todo do fancy stuff like download continuation.
999	$$(QUIET)$$(RM) -f $(out)
1000	$($(target)_$(srcname)_FETCH_CMDS_)
1001	$$(QUIET)$(if $(md5),$$(MD5SUM_EXT) -b -C $(md5) $(out))
1002
1003
1004
1005	# Intermediate goal for making sure the md5 and size matches. it will (re) fetch the archive if necessary.
1006	$(out).checked_$(md5)_$(size): $($(target)_$(srcname)_FETCH_DEPEND_) \| $($(target)_$(srcname)_FETCH_DEPORD_)
1007	$$(call MSG_FETCH_CHK,$(target),$(source),$(out))
1008	$$(QUIET)$$(RM) -f $$@
1009	@# (re)fetch the file if it doesn't exist or if it doesn't matches the md5.
1010	@## @todo do fancy stuff like download continuation.
1011	$$(QUIET)( test -f $(out) && $(if $(md5),$$(MD5SUM_EXT) -b -C $(md5) $(out), true) ) \
1012	\|\| ( $$(RM_EXT) -f $(out) \
1013	&& $$(MAKE) $(out) -f $(MAKEFILE) --no-print-directory )
1014	$$(QUIET2)$$(APPEND) $$@
1015
1016	_TARGET_$(target)_FETCHED += $(out) $(out).checked_$(md5)_$(size)
1017
1018	# Just a little precaution.
1019	.NOTPARALLEL: $(out) $(out).checked_$(md5)_$(size)
1020
1021	endef
1022
1023	## generates the unpack rule
1024	define def_fetch_src_unpack_rule
1025	# This is the unpack rule. it has an order-only dependency on the download check.
1026	$(out) + $($(target)_$(srcname)_UNPACK_OUTPUT_) +\| $($(target)_$(srcname)_UNPACK_OUTPUT_MAYBE_) : \
1027	$($(target)_$(srcname)_UNPACK_DEPEND_) \
1028	\| $($(target)_$(srcname)_UNPACK_DEPORD_) $(archive).checked_$(md5)_$(size)
1029	$$(call MSG_FETCH_UP,$(target),$(archive),$(inst))
1030	$$(QUIET)$$(RM) -f $(out)
1031	@# if the source archive doesn't exist fetch it (can have been deleted to save space).
1032	$$(QUIET)test -f $(archive) \
1033	\|\| ( $$(RM_EXT) -f $(archive).checked_$(md5)_$(size) \
1034	&& $$(MAKE) $(archive).checked_$(md5)_$(size) -f $(MAKEFILE) --no-print-directory )
1035	$($(target)_$(srcname)_UNPACK_CMDS_)
1036	$$(QUIET2)$$(APPEND) $(out) $(notdir $(archive).checked_$(md5)_$(size))
1037	$$(QUIET2)$$(APPEND) $(out) $(notdir $(out))
1038
1039	$(eval _TARGET_$(target)_UNPACKED += $(out))
1040	_TARGET_$(target)_DIGEST := $(_TARGET_$(target)_DIGEST)-$(srcname)_$(md5)_$(size)
1041
1042	.NOTPARALLEL: $(out)
1043
1044	endef
1045
1046	## Processes a fetch source
1047	#
1048	define def_fetch_src
1049	#$ (warning dbg: def_fetch_src: source='$(source)' target='$(target)')
1050
1051	# common
1052	srcname := $(notdir $(source))
1053	inst := $(firstword \
1054	$($(target)_$(source)_INST)\
1055	$($(target)_$(srcname)_INST)\
1056	$($(source)_INST)\
1057	$($(srcname)_INST)\
1058	$($(target)_INST)\
1059	)
1060	ifneq ($(patsubst %/,ok,$(inst)),ok)
1061	$(error kBuild: Bad or missing INST property for source '$(source)' in target '$(target)': $(inst))
1062	endif
1063	INSTARGET_$(target)_$(srcname) := $(inst)
1064	fetchdir := $(firstword \
1065	$($(target)_$(source)_FETCHDIR)\
1066	$($(target)_$(srcname)_FETCHDIR)\
1067	$($(source)_FETCHDIR)\
1068	$($(srcname)_FETCHDIR)\
1069	$($(target)_FETCHDIR)\
1070	$(FETCHDIR)\
1071	$(PATH_TARGET)\
1072	)
1073	deps := \
1074	$($(target)_$(source)_DEPS)\
1075	$($(target)_$(srcname)_DEPS)\
1076	$($(source)_DEPS)\
1077	$($(srcname)_DEPS)\
1078	$($(target)_DEPS)
1079	orderdeps := \
1080	$($(target)_$(source)_ORDERDEPS)\
1081	$($(target)_$(srcname)_ORDERDEPS)\
1082	$($(source)_ORDERDEPS)\
1083	$($(srcname)_ORDERDEPS)\
1084	$($(target)_ORDERDEPS)
1085	md5 := $(firstword \
1086	$($(target)_$(source)_MD5)\
1087	$($(target)_$(srcname)_MD5)\
1088	$($(source)_MD5)\
1089	$($(srcname)_MD5)\
1090	$($(target)_MD5)\
1091	)
1092	size := $(firstword \
1093	$($(target)_$(source)_SIZE)\
1094	$($(target)_$(srcname)_SIZE)\
1095	$($(source)_SIZE)\
1096	$($(srcname)_SIZE)\
1097	$($(target)_SIZE)\
1098	)
1099	dep := # not legal for fetch and unpack tools
1100
1101
1102	#
1103	# The fetching.
1104	#
1105	out := $(fetchdir)/$(srcname)
1106	archive := $(out)
1107	TARGET_$(target)_$(srcname) := $(out)
1108	dirdep := $(call DIRDEP,$(fetchdir))
1109	tool := $(firstword \
1110	$($(target)_$(source)_FETCHTOOL)\
1111	$($(target)_$(srcname)_FETCHTOOL)\
1112	$($(target)_$(source)_TOOL)\
1113	$($(target)_$(srcname)_TOOL)\
1114	$($(source)_FETCHTOOL)\
1115	$($(srcname)_FETCHTOOL)\
1116	$($(source)_TOOL)\
1117	$($(srcname)_TOOL)\
1118	$($(target)_FETCHTOOL)\
1119	$($(target)_TOOL)\
1120	)
1121	flags :=\
1122	$(TOOL_$(tool)_FETCHFLAGS)\
1123	$(FETCHFLAGS)\
1124	$($(target)_FETCHFLAGS)\
1125	$($(srcname)_FETCHFLAGS)\
1126	$($(source)_FETCHFLAGS)\
1127	$($(target)_$(srcname)_FETCHFLAGS)\
1128	$($(target)_$(source)_FETCHFLAGS)
1129
1130	#$ (warning dbg: target=$(target) source=$(source) $(srcname)=$(srcname) tool=$(tool) out=$(out) flags=$(flags) dirdep=$(dirdep) fetchdir=$(fetchdir) md5=$(md5) size=$(size))
1131
1132	ifndef TOOL_$(tool)_FETCH_CMDS
1133	$(warning kBuild: tools: \
1134	1 $($(target)_$(source)_FETCHTOOL)\
1135	2 $($(target)_$(srcname)_FETCHTOOL)\
1136	3 $($(target)_$(source)_TOOL)\
1137	4 $($(target)_$(srcname)_TOOL)\
1138	5 $($(source)_FETCHTOOL)\
1139	6 $($(srcname)_FETCHTOOL)\
1140	7 $($(source)_TOOL)\
1141	8 $($(srcname)_TOOL)\
1142	9 $($(target)_FETCHTOOL)\
1143	10 $($(target)_TOOL) )
1144	$(error kBuild: TOOL_$(tool)_FETCH_CMDS is not defined. source=$(source) target=$(target) )
1145	endif
1146
1147	# call the tool
1148	$(target)_$(srcname)_FETCH_CMDS_ := $(TOOL_$(tool)_FETCH_CMDS)
1149	$(target)_$(srcname)_FETCH_OUTPUT_ := $(TOOL_$(tool)_FETCH_OUTPUT)
1150	$(target)_$(srcname)_FETCH_OUTPUT_MAYBE_ := $(TOOL_$(tool)_FETCH_OUTPUT_MAYBE)
1151	$(target)_$(srcname)_FETCH_DEPEND_ := $(TOOL_$(tool)_FETCH_DEPEND) $(deps)
1152	$(target)_$(srcname)_FETCH_DEPORD_ := $(TOOL_$(tool)_FETCH_DEPORD) $(dirdep) $(orderdeps)
1153
1154	# generate the fetch rule.
1155	$(eval $(def_fetch_src_fetch_rule))
1156
1157
1158	#
1159	# The unpacking / installing.
1160	#
1161	out := $(inst)_kBuild_$(target)_$(srcname)_unpacked.lst
1162	dirdep := $(call DIRDEP,$(inst))
1163	tool := $(firstword \
1164	$($(target)_$(source)_UNPACKTOOL)\
1165	$($(target)_$(srcname)_UNPACKTOOL)\
1166	$($(target)_$(source)_TOOL)\
1167	$($(target)_$(srcname)_TOOL)\
1168	$($(source)_UNPACKTOOL)\
1169	$($(srcname)_UNPACKTOOL)\
1170	$($(source)_TOOL)\
1171	$($(srcname)_TOOL)\
1172	$($(target)_UNPACKTOOL)\
1173	$($(target)_TOOL) \
1174	)
1175	ifeq ($(tool),)
1176	tool := $(toupper $(subst .,,$(suffix $(subst tar.,TAR,$(srcname)))))
1177	$(eval $(value def_tools_include))
1178	endif
1179	flags :=\
1180	$(TOOL_$(tool)_UNPACKFLAGS)\
1181	$(UNPACKFLAGS)\
1182	$($(target)_UNPACKFLAGS)\
1183	$($(srcname)_UNPACKFLAGS)\
1184	$($(source)_UNPACKFLAGS)\
1185	$($(target)_$(srcname)_UNPACKFLAGS)\
1186	$($(target)_$(source)_UNPACKFLAGS)
1187
1188	#$ (warning dbg: target=$(target) source=$(source) $(srcname)=$(srcname) tool=$(tool) out=$(out) flags=$(flags) dirdep=$(dirdep) inst=$(inst) md5=$(md5) size=$(size))
1189	ifndef TOOL_$(tool)_UNPACK_CMDS
1190	$(warning kBuild: tools: \
1191	1 $($(target)_$(source)_UNPACKTOOL)\
1192	2 $($(target)_$(srcname)_UNPACKTOOL)\
1193	3 $($(target)_$(source)_TOOL)\
1194	4 $($(target)_$(srcname)_TOOL)\
1195	5 $($(source)_UNPACKTOOL)\
1196	6 $($(srcname)_UNPACKTOOL)\
1197	7 $($(source)_TOOL)\
1198	8 $($(srcname)_TOOL)\
1199	9 $($(target)_UNPACKTOOL)\
1200	10 $($(target)_TOOL) \
1201	11 $(toupper $(subst tar.,TAR,$(ext $(srcname)))) \
1202	)
1203	$(error kBuild: TOOL_$(tool)_UNPACK_CMDS is not defined. source=$(source) target=$(target) )
1204	endif
1205
1206	# call the tool
1207	$(target)_$(srcname)_UNPACK_CMDS_ := $(TOOL_$(tool)_UNPACK_CMDS)
1208	$(target)_$(srcname)_UNPACK_OUTPUT_ := $(TOOL_$(tool)_UNPACK_OUTPUT)
1209	$(target)_$(srcname)_UNPACK_OUTPUT_MAYBE_ := $(TOOL_$(tool)_UNPACK_OUTPUT_MAYBE)
1210	$(target)_$(srcname)_UNPACK_DEPEND_ := $(TOOL_$(tool)_UNPACK_DEPEND) $(deps)
1211	$(target)_$(srcname)_UNPACK_DEPORD_ := $(TOOL_$(tool)_UNPACK_DEPORD) $(dirdep) $(orderdeps)
1212
1213	# generate the fetch rule.
1214	$(eval $(def_fetch_src_unpack_rule))
1215
1216	_DIRS += $(inst) $(fetchdir)
1217
1218	endef
1219
1220
1221	##
1222	# Define the target level rules for a fetch.
1223	# @param target
1224	# @param out
1225	# @param inst
1226	# @param _TARGET_$(target)_UNPACKED
1227	# @param _TARGET_$(target)_DIGEST
1228	# @param bld_trg
1229	# @param bld_trg_arch
1230	define def_fetch_rules
1231
1232	$(out).lst: $(_TARGET_$(target)_UNPACKED) \| $(call DIRDEP,$(inst))
1233	$$(call MSG_FETCH_OK,$(target))
1234	$$(QUIET)$$(RM) -f $$@ $$@.tmp
1235	$$(QUIET2)$$(APPEND) $$@.tmp '$(notdir $(out))'
1236	$$(QUIET)$(if $(_TARGET_$(target)_UNPACKED),$$(CAT_EXT) $(_TARGET_$(target)_UNPACKED) >> $$@.tmp)
1237	$$(QUIET)$$(MV) -f $$@.tmp $$@
1238
1239	$(out)_unfetched:
1240	$$(call MSG_UNFETCH,$(target))
1241	$$(QUIET)$$(RM) -f $$(addprefix $(inst),$$(shell $$(CAT_EXT) $(out).lst 2> /dev/null \| $$(SED) -e '/\/$$$$/d'))
1242	$$(QUIET)$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $$(dir $$@) \
1243	$$(addprefix $(inst),$$(sort $$(dir $$(shell $$(CAT_EXT) $(out).lst 2> /dev/null))))
1244	$$(QUIET)$$(RM) -f $(out).lst $(out)
1245	$$(QUIET)$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $$(dir $$@)
1246
1247	$(out): $(comp-vars _TARGET_$(target)_DIGEST_PREV,_TARGET_$(target)_DIGEST,FORCE) \| $(call DIRDEP,$(inst))
1248	$$(QUIET)$$(RM) -f $$@
1249	$$(if $$(_TARGET_$(target)_DIGEST),$$(if $$(wildcard $(out).lst)\
1250	,$$(call MSG_REFETCH,$(target)),$$(call MSG_FETCH,$(target))),$$(call MSG_UNFETCH,$(target)))
1251	$$(QUIET)$$(if $$(wildcard $(out).lst ),$$(MAKE) -f $(MAKEFILE) --no-print-directory $(out)_unfetched)
1252	$$(QUIET)$$(if $$(_TARGET_$(target)_DIGEST),$$(MAKE) -f $(MAKEFILE) --no-print-directory $(out).lst,$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $$(dir $$@))
1253	$$(QUIET2)$$(if $$(_TARGET_$(target)_DIGEST),$$(APPEND) $$@ "_TARGET_$(target)_DIGEST_PREV := $(_TARGET_$(target)_DIGEST)")
1254
1255	.NOTPARALLEL: $(out).lst $(out)_unfetched $(out)
1256
1257	endef
1258
1259
1260	##
1261	# Deal with one fetch target.
1262	# @param target
1263	# @param bld_trg
1264	# @param bld_trg_arch
1265	define def_fetch
1266	# common
1267	INSTARGET_$(target) := $($(target)_INST)
1268	ifneq ($(patsubst %/,ok,$(INSTARGET_$(target))),ok)
1269	$(error kBuild: Bad or missing INST property for target '$(target)'. \
1270	$(target)_INST='$($(target)_INST)' ($(origin $(target)_INST)))
1271	endif
1272	_TARGET_$(target)_FETCHED :=
1273	_TARGET_$(target)_UNPACKED :=
1274	_TARGET_$(target)_DIGEST :=
1275
1276	# The 'sources'.
1277	#$ (warning dbg fetch: target=$(target) sources=$($(target)_SOURCES) $($(target)_SOURCES.$(BUILD_TYPE)) $($(target)_SOURCES.$(BUILD_TARGET)) $($(target)_SOURCES.$(BUILD_TARGET_ARCH)) $($(target)_SOURCES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)))
1278	$(foreach source,$($(target)_SOURCES) $($(target)_SOURCES.$(BUILD_TYPE)) $($(target)_SOURCES.$(BUILD_TARGET)) $($(target)_SOURCES.$(BUILD_TARGET_ARCH)) $($(target)_SOURCES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),\
1279	$(eval $(value def_fetch_src)))
1280
1281	# The target.
1282	inst := $(INSTARGET_$(target))
1283	out := $(inst)_kBuild_fetch_$(target)
1284
1285	$(eval includedep $(out))
1286
1287	$(eval $(def_fetch_rules))
1288
1289	# Define the aliases here (doesn't work if defined in def_fetch_rules, just like includedep).
1290	$(target): $(out)
1291	$(target)_unfetch: $(out)_unfetched
1292
1293	_FETCHES += $(out)
1294	_DOWNLOADS += $(_TARGET_$(target)_FETCHED)
1295	_UNPACKS += $(_TARGET_$(target)_UNPACKED)
1296	_UNFETCHES += $(out)_unfetched
1297	_DIRS += $(inst)
1298
1299	endef
1300
1301	# Walk the FETCH target lists.
1302	bld_trg := $(BUILD_TARGET)
1303	bld_trg_arch := $(BUILD_TARGET_ARCH)
1304	$(foreach target, $(FETCHES) $(FETCHES.$(BUILD_TARGET)) $(FETCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
1305	$(eval $(value def_fetch)))
1306
1307	# some aliases.
1308	download: $(_DOWNLOADS)
1309	unpack: $(_UNPACKS)
1310	fetch: $(_FETCHES)
1311	unfetch: $(_UNFETCHES)
1312
1313	ifdef KBUILD_PROFILE_SELF
1314	_KBUILD_TS_NOW := $(nanots )
1315	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done fetching targets)
1316	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
1317	endif
1318
1319
1320
1321	##
1322	## Patching.
1323	##
1324	##
1325	#define def_patch_src
1326	#
1327	#endef
1328	#
1329	#
1330	## Deal with one patch target.
1331	#define def_patch
1332	#
1333	#$(foreach source,$($(target)_SOURCES) $($(target)_SOURCES.$(BUILD_TYPE)) $($(target)_SOURCES.$(BUILD_TARGET)) $($(target)_SOURCES.$(BUILD_TARGET_ARCH)) $($(target)_SOURCES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),\
1334	# $(eval $(value def_patch_src)))
1335	#
1336	#_PATCHES +=
1337	#endef
1338	#
1339	#$(foreach target, $(PATCHES) $(PATCHES.$(BUILD_TARGET)) $(PATCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
1340	# $(eval $(value def_patch)))
1341	#
1342
1343
1344	#
1345	# Object processing.
1346	#
1347
1348	## wrapper the compile command dependency check.
1349	ifndef NO_COMPILE_CMDS_DEPS
1350	_DEP_COMPILE_CMDS = $(comp-cmds $(target)_$(source)_CMDS_PREV_,$(target)_$(source)_CMDS_,FORCE)
1351	else
1352	_DEP_COMPILE_CMDS =
1353	endif
1354
1355	## Generates the rules for building a specific object, and the aliases
1356	# for building a source file.
1357	# @param $(obj) The object file.
1358	define def_target_source_rule
1359
1360	ifdef TOOL_$(tool)_COMPILE_$(type)_USES_KOBJCACHE
1361	$(outbase).koc +\| $(obj) $($(target)_$(source)_OUTPUT_) $($(target)_$(source)_OUTPUT_MAYBE_) : \
1362	$($(target)_$(source)_DEPEND_) \
1363	$(_DEP_COMPILE_CMDS) \
1364	\| \
1365	$($(target)_$(source)_DEPORD_)
1366	$$(call MSG_COMPILE,$(target),$(source),$$@,$(type))
1367	else
1368	$(obj) + $($(target)_$(source)_OUTPUT_) +\| $($(target)_$(source)_OUTPUT_MAYBE_) : \
1369	$($(target)_$(source)_DEPEND_) \
1370	$(_DEP_COMPILE_CMDS) \
1371	\| \
1372	$($(target)_$(source)_DEPORD_)
1373	$$(call MSG_COMPILE,$(target),$(source),$$@,$(type))
1374	ifdef TOOL_$(tool)_COMPILE_$(type)_DONT_PURGE_OUTPUT
1375	$$(QUIET)$$(RM) -f $(dep) $(obj) $($(target)_$(source)_OUTPUT_) $($(target)_OUTPUT_MAYBE_)
1376	endif
1377	endif
1378
1379	$($(target)_$(source)_CMDS_)
1380
1381	ifndef NO_COMPILE_CMDS_DEPS
1382	$$(QUIET2)$$(APPEND) '$(dep)'
1383	$$(QUIET2)$$(APPEND) '$(dep)' 'define $(target)_$(source)_CMDS_PREV_'
1384	$$(QUIET2)$$(APPEND) -v '$(dep)' '$(target)_$(source)_CMDS_'
1385	$$(QUIET2)$$(APPEND) '$(dep)' 'endef'
1386	endif
1387
1388	$(basename $(notdir $(obj))).o: $(obj)
1389	$(basename $(notdir $(obj))).obj: $(obj)
1390	endef
1391
1392
1393	## wrapper the link command dependency check.
1394	ifndef NO_COMPILE_CMDS_DEPS
1395	_DEP_LINK_CMDS = $(comp-cmds $(target)_CMDS_PREV_,$(target)_CMDS_,FORCE)
1396	else
1397	_DEP_LINK_CMDS =
1398	endif
1399
1400	## Generate the link rule for a target.
1401	# @param $(target) The normalized target name.
1402	# @param $(dirdep) Directories we depend upon begin created before linking.
1403	# @param $(dep) The name of the dependency file.
1404	# @param $(out)
1405	# @param $($(target)_OUTPUT_) Output files from the link.
1406	# @param $($(target)_OUTPUT_MAYBE_) Output files that the link may perhaps create.
1407	# @param $($(target)_DEPEND_) Dependencies.
1408	# @param $($(target)_DEPORD_) Dependencies which should only affect build order.
1409	# @param $($(target)_CMDS_) The link commands.
1410	# @param $($(target)_CMDS_PREV_) The link commands from the previous run.
1411	define def_link_rule
1412	$(out) + $($(target)_OUTPUT_) +\| $($(target)_OUTPUT_MAYBE_) : \
1413	$($(target)_DEPEND_) \
1414	$(_DEP_LINK_CMDS) \
1415	\| \
1416	$($(target)_DEPORD_)
1417	$$(call MSG_LINK,$(target),$$@,$(tool_do))
1418	$$(QUIET)$$(RM) -f $(dep) $(out) $($(target)_OUTPUT_) $($(target)_OUTPUT_MAYBE_)
1419
1420	$($(target)_CMDS_)
1421
1422	ifndef NO_LINK_CMDS_DEPS
1423	$$(QUIET2)$$(APPEND) '$(dep)' 'define $(target)_CMDS_PREV_'
1424	$$(QUIET2)$$(APPEND) -v '$(dep)' '$(target)_CMDS_'
1425	$$(QUIET2)$$(APPEND) '$(dep)' 'endef'
1426	endif
1427
1428	$(basename $(notdir $(out))): $(out)
1429
1430	endef
1431
1432
1433	## Generate the link & lib install rule
1434	# @param $(target) Normalized target name.
1435	# @param $(out) The build target.
1436	# @param $(INSTARGET_$(target)) The installation targets.
1437	# @param $(mode) The file mode (optional)
1438	define def_link_install_rule
1439	$(INSTARGET_$(target)) : $(out) \| $(call DIRDEP,$(dir $(INSTARGET_$(target))))
1440	$$(call MSG_INST_TRG,$(target),$(out),$$@)
1441	$$(QUIET)$$(INSTALL) $$(if $(mode),-m $(mode)) $(out) $$@
1442
1443	ifdef KBUILD_DO_AUTO_INSTALL
1444	$(basename $(notdir $(out))): $(INSTARGET_$(target))
1445	endif
1446	endef
1447
1448
1449	## Generic macro for processing C, C++ and Assembly sources.
1450	# @param $(target) Normalized target name.
1451	# @param $(source) Source file name.
1452	# @param $(type) Source type. {C,CXX,AS,OBJC}
1453	# @param bld_type Build type.
1454	# @param bld_trg Build target.
1455	# @param bld_trg_arch Build target arch.
1456	# @param bld_trg_cpu Build target cpu.
1457	def_target_source_c_cpp_objc_asm_rc_new = $(kb-src-one )
1458	ifdef KMK_VERSION
1459	def_target_source_c_cpp_objc_asm_rc_var = def_target_source_c_cpp_objc_asm_rc_new
1460	else
1461	def_target_source_c_cpp_objc_asm_rc_var = def_target_source_c_cpp_objc_asm_rc_old
1462	endif
1463
1464	## Generic macro for processing all target sources.
1465	# @param $(target) Normalized target name.
1466	# @param $(defpath)
1467	# @param much-more...
1468	define def_target_sources
1469	#$ (warning def_target_sources)
1470	# C sources
1471	type := C
1472	$(foreach source, $(filter %.c , $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1473	,$(eval $(value $(def_target_source_c_cpp_objc_asm_rc_var))) )
1474
1475	# C++ sources
1476	type := CXX
1477	$(foreach source, $(filter %.cpp %.cxx %.xx, $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1478	,$(eval $(value $(def_target_source_c_cpp_objc_asm_rc_var))) )
1479
1480	# Objective-C sources
1481	type := OBJC
1482	$(foreach source, $(filter %.m, $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1483	,$(eval $(value $(def_target_source_c_cpp_objc_asm_rc_var))) )
1484
1485	# ASM sources
1486	type := AS
1487	$(foreach source, $(filter %.asm %.s %.S , $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1488	,$(eval $(value $(def_target_source_c_cpp_objc_asm_rc_var))) )
1489
1490	# Resource sources
1491	type := RC
1492	$(foreach source, $(filter %.rc , $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1493	,$(eval $(value $(def_target_source_c_cpp_objc_asm_rc_var))) )
1494
1495	endef
1496
1497
1498
1499	## Generic macro for generating the install rule(s) for a target
1500	# and update the globals with default out.
1501	#
1502	# @param $(target) Normalized target name.
1503	# @param $(out) The output file.
1504	# @param $(definst) The default _INST value.
1505	# @param $(typevar) The name of the variable with all the root targets of its type.
1506	# @remark Only library uses this now.
1507	define def_target_install_pluss
1508	ifndef $(target)_NOINST
1509	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
1510	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
1511
1512	$(eval $(def_link_install_rule))
1513
1514	_INSTALLS_FILES += $(INSTARGET_$(target))
1515
1516	ifdef KBUILD_DO_AUTO_INSTALL
1517	$(typevar) += $(INSTARGET_$(target))
1518	else
1519	$(typevar) += $(out)
1520	endif
1521	else # _NOINST
1522	$(typevar) += $(out)
1523	endif
1524
1525	_OUT_FILES += $($(target)_OUTPUT_) $($(target)_OUTPUT_MAYBE_) $(out)
1526	_CLEAN_FILES += $($(target)_CLEAN) $($(target)_CLEAN.$(bld_trg)) $($(target)_CLEAN.$(bld_trg).$(bld_trg_arch)) $($(target)_CLEAN.$(bld_trg_arch)) $($(target)_CLEAN.$(bld_trg_cpu)) $($(target)_CLEAN.$(bld_type))
1527	_DIRS += $($(target)_BLDDIRS) $($(target)_BLDDIRS.$(bld_trg)) $($(target)_BLDDIRS.$(bld_trg).$(bld_trg_arch)) $($(target)_BLDDIRS.$(bld_trg_arch)) $($(target)_BLDDIRS.$(bld_trg_cpu)) $($(target)_BLDDIRS.$(bld_type))
1528	_OBJS += $($(target)_OBJS_)
1529
1530	endef
1531
1532
1533
1534	#
1535	# LIBRARIES
1536	#
1537
1538	## Library (one).
1539	# @param $(target) Normalized library (target) name.
1540	define def_lib
1541	# library basics
1542	## @todo prefix
1543	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
1544	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))
1545	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_TARGET_ARCH))
1546	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_TARGET_CPU))
1547	tool := $(call _TARGET_TOOL,$(target),AR)
1548	ifeq ($(tool),)
1549	$(error kBuild: Library target $(target) does not have a tool defined!)
1550	endif
1551	name := $(firstword\
1552	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1553	$($(target)_NAME.$(bld_trg_arch))\
1554	$($(target)_NAME.$(bld_trg))\
1555	$($(target)_NAME.$(bld_type))\
1556	$($(target)_NAME)\
1557	$(target))
1558	outbase := $(call TARGET_BASE,$(name),$(target))
1559	ifndef PATH_$(target)
1560	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
1561	else
1562	ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
1563	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
1564	endif
1565	endif
1566	suff := $(firstword\
1567	$($(target)_LIBSUFF.$(bld_trg).$(bld_trg_arch))\
1568	$($(target)_LIBSUFF.$(bld_trg))\
1569	$($(target)_LIBSUFF)\
1570	$(TOOL_$(tool)_ARLIBSUFF.$(bld_trg).$(bld_trg_arch))\
1571	$(TOOL_$(tool)_ARLIBSUFF.$(bld_trg))\
1572	$(TOOL_$(tool)_ARLIBSUFF)\
1573	$(SUFF_LIB))
1574	out := $(outbase)$(suff)
1575	TARGET_$(target) := $(out)
1576	$(target)_OBJS_ :=
1577	defpath := $($(target)_PATH)
1578
1579	# source -> object
1580	$(eval $(value def_target_sources))
1581
1582	# library linking
1583	tool := $(call _TARGET_TOOL,$(target),AR)
1584	name := $(firstword\
1585	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1586	$($(target)_NAME.$(bld_trg_arch))\
1587	$($(target)_NAME.$(bld_trg))\
1588	$($(target)_NAME.$(bld_type))\
1589	$($(target)_NAME)\
1590	$(target))
1591	outbase := $(call TARGET_BASE,$(name),$(target))
1592	flags :=\
1593	$(TOOL_$(tool)_ARFLAGS)\
1594	$(TOOL_$(tool)_ARFLAGS.$(bld_type))\
1595	$(ARFLAGS)\
1596	$(ARFLAGS.$(bld_type))\
1597	$($(target)_ARFLAGS)\
1598	$($(target)_ARFLAGS.$(bld_type)) \
1599	$($(target)_ARFLAGS.$(bld_trg)) \
1600	$($(target)_ARFLAGS.$(bld_trg_arch)) \
1601	$($(target)_ARFLAGS.$(bld_trg).$(bld_trg_arch)) \
1602	$($(target)_ARFLAGS.$(bld_trg_cpu))
1603	othersrc := $(filter-out %.c %.cpp %.cxx %.cc %.m %.s %.S %.asm %.rc %.o %.obj %.res,\
1604	$($(target)_SOURCES) \
1605	$($(target)_SOURCES.$(bld_trg)) \
1606	$($(target)_SOURCES.$(bld_trg_arch)) \
1607	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1608	$($(target)_SOURCES.$(bld_trg_cpu)) \
1609	$($(target)_SOURCES.$(bld_type)))
1610	objs = $(filter %.o %.obj %.res, \
1611	$($(target)_SOURCES) \
1612	$($(target)_SOURCES.$(bld_trg)) \
1613	$($(target)_SOURCES.$(bld_trg_arch)) \
1614	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1615	$($(target)_SOURCES.$(bld_trg_cpu)) \
1616	$($(target)_SOURCES.$(bld_type))) \
1617	$($(target)_OBJS_)
1618	dirdep := $(call DIRDEP,$(dir $(out)))
1619	deps := $($(target)_DEPS)
1620	orderdeps := $($(target)_ORDERDEPS)
1621
1622	# Adjust paths if we got a default path.
1623	ifneq ($(defpath),)
1624	objs := $(abspathex $(objs),$(defpath))
1625	deps := $(abspathex $(deps),$(defpath))
1626	orderdeps := $(abspathex $(orderdeps),$(defpath))
1627	othersrc := $(abspathex $(othersrc),$(defpath))
1628	endif
1629
1630
1631	# Custom pre-link actions.
1632	ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1633	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1634	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1635	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1636	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_type)
1637	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_type))
1638	else ifdef $(target)_PRE_CMDS.$(bld_trg_arch)
1639	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg_arch))
1640	else ifdef $(target)_PRE_CMDS.$(bld_trg)
1641	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg))
1642	else ifdef $(target)_PRE_CMDS.$(bld_type)
1643	pre_cmds := $($(target)_PRE_CMDS.$(bld_type))
1644	else ifdef $(target)_PRE_CMDS
1645	pre_cmds := $($(target)_PRE_CMDS)
1646	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1647	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1648	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1649	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1650	else ifdef PRE_CMDS.$(bld_trg).$(bld_type)
1651	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_type))
1652	else ifdef PRE_CMDS.$(bld_trg_arch)
1653	pre_cmds := $(PRE_CMDS.$(bld_trg_arch))
1654	else ifdef PRE_CMDS.$(bld_trg)
1655	pre_cmds := $(PRE_CMDS.$(bld_trg))
1656	else ifdef PRE_CMDS.$(bld_type)
1657	pre_cmds := $(PRE_CMDS.$(bld_type))
1658	else
1659	pre_cmds := $(PRE_CMDS)
1660	endif
1661
1662	# Custom post-link actions.
1663	ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1664	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1665	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch)
1666	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch))
1667	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_type)
1668	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_type))
1669	else ifdef $(target)_POST_CMDS.$(bld_trg_arch)
1670	post_cmds := $($(target)_POST_CMDS.$(bld_trg_arch))
1671	else ifdef $(target)_POST_CMDS.$(bld_trg)
1672	post_cmds := $($(target)_POST_CMDS.$(bld_trg))
1673	else ifdef $(target)_POST_CMDS.$(bld_type)
1674	post_cmds := $($(target)_POST_CMDS.$(bld_type))
1675	else ifdef $(target)_POST_CMDS
1676	post_cmds := $($(target)_POST_CMDS)
1677	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1678	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1679	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch)
1680	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch))
1681	else ifdef POST_CMDS.$(bld_trg).$(bld_type)
1682	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_type))
1683	else ifdef POST_CMDS.$(bld_trg_arch)
1684	post_cmds := $(POST_CMDS.$(bld_trg_arch))
1685	else ifdef POST_CMDS.$(bld_trg)
1686	post_cmds := $(POST_CMDS.$(bld_trg))
1687	else ifdef POST_CMDS.$(bld_type)
1688	post_cmds := $(POST_CMDS.$(bld_type))
1689	else
1690	post_cmds := $(POST_CMDS)
1691	endif
1692
1693	# dependency file
1694	dep := $(out)$(SUFF_DEP)
1695	ifndef NO_LINK_CMDS_DEPS
1696	_DEPFILES_INCLUDED += $(dep)
1697	$(eval includedep $(dep))
1698	endif
1699
1700	# check that the tool is defined.
1701	ifndef TOOL_$(tool)_LINK_LIBRARY_CMDS
1702	$(warning kBuild: tools: \
1703	1 $($(target)_$(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
1704	2 $($(target)_$(source)TOOL.$(bld_trg)) \
1705	3 $($(target)_$(source)TOOL) \
1706	4 $($(target)_TOOL.$(bld_trg).$(bld_trg_arch)) \
1707	5 $($(target)_TOOL.$(bld_trg)) \
1708	6 $($(target)_TOOL) \
1709	7 $($(source)TOOL) \
1710	8 $($(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
1711	9 $($(source)TOOL.$(bld_trg)) \
1712	10 $(TOOL.$(bld_trg).$(bld_trg_arch)) \
1713	11 $(TOOL.$(bld_trg)) \
1714	12 $(TOOL) )
1715	$(error kBuild: TOOL_$(tool)_LINK_LIBRARY_CMDS isn't defined! target=$(target) )
1716	endif
1717
1718	# call the tool
1719	$(target)_CMDS_ := $(TOOL_$(tool)_LINK_LIBRARY_CMDS)
1720	ifneq ($(pre_cmds),)
1721	$(target)_CMDS_ := $(TAB)$(pre_cmds)$(NL)$(TAB)$($(target)_CMDS_)
1722	endif
1723	ifneq ($(post_cmds),)
1724	$(target)_CMDS_ := $($(target)_CMDS_)$(NL)$(TAB)$(post_cmds)
1725	endif
1726	$(target)_OUTPUT_ := $(TOOL_$(tool)_LINK_LIBRARY_OUTPUT)
1727	$(target)_OUTPUT_MAYBE_ := $(TOOL_$(tool)_LINK_LIBRARY_OUTPUT_MAYBE)
1728	$(target)_DEPEND_ := $(TOOL_$(tool)_LINK_LIBRARY_DEPEND) $(deps) $(objs)
1729	$(target)_DEPORD_ := $(TOOL_$(tool)_LINK_LIBRARY_DEPORD) $(dirdep) $(orderdeps)
1730
1731	# generate the link rule.
1732	$(eval $(def_link_rule))
1733
1734	# installing and globals
1735	$(eval $(value def_target_install_pluss))
1736	endef
1737
1738	# Process libraries
1739	definst := $(PATH_LIB)
1740	typevar := _LIBS
1741	tool_do := LINK_LIBRARY
1742	mode := 0644
1743	$(foreach target, $(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_lib)))
1744
1745	ifdef KBUILD_PROFILE_SELF
1746	_KBUILD_TS_NOW := $(nanots )
1747	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done library targets)
1748	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
1749	endif
1750
1751
1752	#
1753	# Link operations.
1754	#
1755
1756	##
1757	# Link prolog
1758	#
1759	# @param $(target) Normalized target name.
1760	# @param $(EXT) EXE,DLL,SYS.
1761	# @param $(definst) The default _INST value.
1762	# @param $(typevar) The name of the variable with all the root targets of its type.
1763	define def_link_common
1764	# basics
1765	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
1766	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_$(bld_trg_base_var)))
1767	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_$(bld_trg_base_var)_ARCH))
1768	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_$(bld_trg_base_var)_CPU))
1769
1770	tool := $(call _TARGET_TOOL,$(target),LD)
1771	name := $(firstword\
1772	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1773	$($(target)_NAME.$(bld_trg_arch))\
1774	$($(target)_NAME.$(bld_trg))\
1775	$($(target)_NAME.$(bld_type))\
1776	$($(target)_NAME)\
1777	$(target))
1778	outbase := $(call TARGET_BASE,$(name),$(target))
1779	ifndef PATH_$(target)
1780	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
1781	else
1782	ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
1783	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
1784	endif
1785	endif
1786	suff := $(firstword \
1787	$($(target)_$(EXT)SUFF) \
1788	$($(target)_$(EXT)SUFF) \
1789	$(TOOL_$(tool)_LD$(EXT)SUFF) \
1790	$($(EXTPRE)SUFF_$(EXT)))
1791	out := $(outbase)$(suff)
1792	TARGET_$(target) := $(out)
1793	$(target)_OBJS_ :=
1794	defpath := $($(target)_PATH)
1795
1796	# source -> object
1797	$(eval $(value def_target_sources))
1798
1799	# more link stuff.
1800	tool := $(call _TARGET_TOOL,$(target),LD)
1801	name := $(firstword\
1802	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1803	$($(target)_NAME.$(bld_trg_arch))\
1804	$($(target)_NAME.$(bld_trg))\
1805	$($(target)_NAME.$(bld_type))\
1806	$($(target)_NAME)\
1807	$(target))
1808	outbase := $(call TARGET_BASE,$(name),$(target))
1809	flags :=\
1810	$(TOOL_$(tool)_LDFLAGS)\
1811	$(TOOL_$(tool)_LDFLAGS.$(bld_type))\
1812	$(TOOL_$(tool)_LDFLAGS.$(bld_trg))\
1813	$(TOOL_$(tool)_LDFLAGS.$(bld_trg_arch))\
1814	$(TOOL_$(tool)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1815	$(TOOL_$(tool)_LDFLAGS.$(bld_trg_cpu))\
1816	$(foreach sdk, $(SDKS) \
1817	$(SDKS.$(bld_type)) \
1818	$(SDKS.$(bld_trg)) \
1819	$(SDKS.$(bld_trg_arch)) \
1820	$(SDKS.$(bld_trg).$(bld_trg_arch)),\
1821	$(SDK_$(sdk)_LDFLAGS)\
1822	$(SDK_$(sdk)_LDFLAGS.$(bld_type))\
1823	$(SDK_$(sdk)_LDFLAGS.$(bld_trg))\
1824	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_arch))\
1825	$(SDK_$(sdk)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1826	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_cpu)))\
1827	$(LDFLAGS)\
1828	$(LDFLAGS.$(bld_type))\
1829	$(LDFLAGS.$(bld_trg))\
1830	$(LDFLAGS.$(bld_trg_arch))\
1831	$(LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1832	$(LDFLAGS.$(bld_trg_cpu))\
1833	$(foreach sdk, $($(target)_SDKS) \
1834	$($(target)_SDKS.$(bld_type)) \
1835	$($(target)_SDKS.$(bld_trg)) \
1836	$($(target)_SDKS.$(bld_trg_arch)) \
1837	$($(target)_SDKS.$(bld_trg).$(bld_trg_arch)),\
1838	$(SDK_$(sdk)_LDFLAGS)\
1839	$(SDK_$(sdk)_LDFLAGS.$(bld_type))\
1840	$(SDK_$(sdk)_LDFLAGS.$(bld_trg))\
1841	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_arch))\
1842	$(SDK_$(sdk)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1843	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_cpu)))\
1844	$($(target)_LDFLAGS)\
1845	$($(target)_LDFLAGS.$(bld_type))\
1846	$($(target)_LDFLAGS.$(bld_trg))\
1847	$($(target)_LDFLAGS.$(bld_trg_arch))\
1848	$($(target)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1849	$($(target)_LDFLAGS.$(bld_trg_cpu))
1850	othersrc := $(filter-out %.c %.cpp %.cxx %.cc %.m %.s %.S %.asm %.rc %.o %.obj %.res,\
1851	$($(target)_SOURCES)\
1852	$($(target)_SOURCES.$(bld_trg)) \
1853	$($(target)_SOURCES.$(bld_trg_arch)) \
1854	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1855	$($(target)_SOURCES.$(bld_trg_cpu)) \
1856	$($(target)_SOURCES.$(bld_type)))
1857	objs = $(filter %.o %.obj %.res, \
1858	$($(target)_SOURCES) \
1859	$($(target)_SOURCES.$(bld_trg)) \
1860	$($(target)_SOURCES.$(bld_trg_arch)) \
1861	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1862	$($(target)_SOURCES.$(bld_trg_cpu)) \
1863	$($(target)_SOURCES.$(bld_type))) \
1864	$($(target)_OBJS_)
1865	libs :=\
1866	$($(target)_LIBS.$(bld_trg_cpu))\
1867	$($(target)_LIBS.$(bld_trg).$(bld_trg_arch))\
1868	$($(target)_LIBS.$(bld_trg_arch))\
1869	$($(target)_LIBS.$(bld_trg))\
1870	$($(target)_LIBS.$(bld_type))\
1871	$($(target)_LIBS)\
1872	$(foreach sdk, $($(target)_SDKS.$(bld_trg).$(bld_trg_arch)) \
1873	$($(target)_SDKS.$(bld_trg_arch)) \
1874	$($(target)_SDKS.$(bld_trg)) \
1875	$($(target)_SDKS.$(bld_type)) \
1876	$($(target)_SDKS),\
1877	$(SDK_$(sdk)_LIBS.$(bld_trg_cpu))\
1878	$(SDK_$(sdk)_LIBS.$(bld_trg).$(bld_trg_arch))\
1879	$(SDK_$(sdk)_LIBS.$(bld_trg_arch))\
1880	$(SDK_$(sdk)_LIBS.$(bld_trg))\
1881	$(SDK_$(sdk)_LIBS.$(bld_type))\
1882	$(SDK_$(sdk)_LIBS))\
1883	$(LIBS.$(bld_trg_cpu))\
1884	$(LIBS.$(bld_trg).$(bld_trg_arch))\
1885	$(LIBS.$(bld_trg_arch))\
1886	$(LIBS.$(bld_trg))\
1887	$(LIBS.$(bld_type))\
1888	$(LIBS)\
1889	$(foreach sdk, $(SDKS.$(bld_trg).$(bld_trg_arch)) \
1890	$(SDKS.$(bld_trg_arch)) \
1891	$(SDKS.$(bld_trg)) \
1892	$(SDKS.$(bld_type)) \
1893	$(SDKS),\
1894	$(SDK_$(sdk)_LIBS.$(bld_trg_cpu))\
1895	$(SDK_$(sdk)_LIBS.$(bld_trg).$(bld_trg_arch))\
1896	$(SDK_$(sdk)_LIBS.$(bld_trg_arch))\
1897	$(SDK_$(sdk)_LIBS.$(bld_trg))\
1898	$(SDK_$(sdk)_LIBS.$(bld_type))\
1899	$(SDK_$(sdk)_LIBS))\
1900	$(TOOL_$(tool)_LIBS.$(bld_trg_cpu))\
1901	$(TOOL_$(tool)_LIBS.$(bld_trg).$(bld_trg_arch))\
1902	$(TOOL_$(tool)_LIBS.$(bld_trg_arch))\
1903	$(TOOL_$(tool)_LIBS.$(bld_trg))\
1904	$(TOOL_$(tool)_LIBS.$(bld_type))\
1905	$(TOOL_$(tool)_LIBS)
1906	libpath :=\
1907	$($(target)_LIBPATH.$(bld_trg_cpu))\
1908	$($(target)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1909	$($(target)_LIBPATH.$(bld_trg_arch))\
1910	$($(target)_LIBPATH.$(bld_trg))\
1911	$($(target)_LIBPATH.$(bld_type))\
1912	$($(target)_LIBPATH)\
1913	$(foreach sdk, $($(target)_SDKS.$(bld_trg).$(bld_trg_arch)) \
1914	$($(target)_SDKS.$(bld_trg_arch)) \
1915	$($(target)_SDKS.$(bld_trg)) \
1916	$($(target)_SDKS.$(bld_type)) \
1917	$($(target)_SDKS),\
1918	$(SDK_$(sdk)_LIBPATH.$(bld_trg_cpu))\
1919	$(SDK_$(sdk)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1920	$(SDK_$(sdk)_LIBPATH.$(bld_trg_arch))\
1921	$(SDK_$(sdk)_LIBPATH.$(bld_trg))\
1922	$(SDK_$(sdk)_LIBPATH.$(bld_type))\
1923	$(SDK_$(sdk)_LIBPATH))\
1924	$(LIBPATH.$(bld_trg_cpu))\
1925	$(LIBPATH.$(bld_trg).$(bld_trg_arch))\
1926	$(LIBPATH.$(bld_trg_arch))\
1927	$(LIBPATH.$(bld_trg))\
1928	$(LIBPATH.$(bld_type))\
1929	$(LIBPATH)\
1930	$(foreach sdk, $(SDKS.$(bld_trg).$(bld_trg_arch)) \
1931	$(SDKS.$(bld_trg_arch)) \
1932	$(SDKS.$(bld_trg)) \
1933	$(SDKS.$(bld_type)) \
1934	$(SDKS),\
1935	$(SDK_$(sdk)_LIBPATH.$(bld_trg_cpu))\
1936	$(SDK_$(sdk)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1937	$(SDK_$(sdk)_LIBPATH.$(bld_trg_arch))\
1938	$(SDK_$(sdk)_LIBPATH.$(bld_trg))\
1939	$(SDK_$(sdk)_LIBPATH.$(bld_type))\
1940	$(SDK_$(sdk)_LIBPATH))\
1941	$(TOOL_$(tool)_LIBPATH.$(bld_trg_cpu))\
1942	$(TOOL_$(tool)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1943	$(TOOL_$(tool)_LIBPATH.$(bld_trg_arch))\
1944	$(TOOL_$(tool)_LIBPATH.$(bld_trg))\
1945	$(TOOL_$(tool)_LIBPATH.$(bld_type))\
1946	$(TOOL_$(tool)_LIBPATH)
1947	dirdep := $(call DIRDEP,$(dir $(out)))
1948	deps := $($(target)_DEPS)
1949	orderdeps := $($(target)_ORDERDEPS)
1950
1951	# Adjust paths if we got a default path.
1952	ifneq ($(defpath),)
1953	libpath := $(abspathex $(libpath),$(defpath))
1954	objs := $(abspathex $(objs),$(defpath))
1955	deps := $(abspathex $(deps),$(defpath))
1956	orderdeps := $(abspathex $(orderdeps),$(defpath))
1957	othersrc := $(abspathex $(othersrc),$(defpath))
1958	# libs are not subject to this because of the the -l<lib> stuff. Use $(<target>_PATH)/lib if relative to current dir!
1959	endif
1960
1961	# Custom pre-link actions.
1962	ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1963	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1964	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1965	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1966	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_type)
1967	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_type))
1968	else ifdef $(target)_PRE_CMDS.$(bld_trg_arch)
1969	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg_arch))
1970	else ifdef $(target)_PRE_CMDS.$(bld_trg)
1971	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg))
1972	else ifdef $(target)_PRE_CMDS.$(bld_type)
1973	pre_cmds := $($(target)_PRE_CMDS.$(bld_type))
1974	else ifdef $(target)_PRE_CMDS
1975	pre_cmds := $($(target)_PRE_CMDS)
1976	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1977	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1978	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1979	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1980	else ifdef PRE_CMDS.$(bld_trg).$(bld_type)
1981	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_type))
1982	else ifdef PRE_CMDS.$(bld_trg_arch)
1983	pre_cmds := $(PRE_CMDS.$(bld_trg_arch))
1984	else ifdef PRE_CMDS.$(bld_trg)
1985	pre_cmds := $(PRE_CMDS.$(bld_trg))
1986	else ifdef PRE_CMDS.$(bld_type)
1987	pre_cmds := $(PRE_CMDS.$(bld_type))
1988	else
1989	pre_cmds := $(PRE_CMDS)
1990	endif
1991
1992	# Custom post-link actions.
1993	ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1994	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1995	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch)
1996	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch))
1997	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_type)
1998	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_type))
1999	else ifdef $(target)_POST_CMDS.$(bld_trg_arch)
2000	post_cmds := $($(target)_POST_CMDS.$(bld_trg_arch))
2001	else ifdef $(target)_POST_CMDS.$(bld_trg)
2002	post_cmds := $($(target)_POST_CMDS.$(bld_trg))
2003	else ifdef $(target)_POST_CMDS.$(bld_type)
2004	post_cmds := $($(target)_POST_CMDS.$(bld_type))
2005	else ifdef $(target)_POST_CMDS
2006	post_cmds := $($(target)_POST_CMDS)
2007	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2008	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2009	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch)
2010	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch))
2011	else ifdef POST_CMDS.$(bld_trg).$(bld_type)
2012	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_type))
2013	else ifdef POST_CMDS.$(bld_trg_arch)
2014	post_cmds := $(POST_CMDS.$(bld_trg_arch))
2015	else ifdef POST_CMDS.$(bld_trg)
2016	post_cmds := $(POST_CMDS.$(bld_trg))
2017	else ifdef POST_CMDS.$(bld_type)
2018	post_cmds := $(POST_CMDS.$(bld_type))
2019	else
2020	post_cmds := $(POST_CMDS)
2021	endif
2022
2023	# installation targets
2024	ifndef $(target)_NOINST
2025	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
2026	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
2027	ifdef KBUILD_DO_AUTO_INSTALL
2028	$(typevar) += $(INSTARGET_$(target))
2029	else
2030	$(typevar) += $(out)
2031	endif
2032	# generate the install rule
2033	$(eval $(def_link_install_rule))
2034
2035	else # NOINST
2036	INSTARGET_$(target) :=
2037	$(typevar) += $(out)
2038	endif # NOINST
2039
2040	# dependency file
2041	dep := $(outbase)$(SUFF_DEP)
2042	ifndef NO_LINK_CMDS_DEPS
2043	_DEPFILES_INCLUDED += $(dep)
2044	$(eval includedep $(dep))
2045	endif
2046
2047	# check that the tool is defined.
2048	ifndef TOOL_$(tool)_$(tool_do)_CMDS
2049	$(warning kBuild: tools: \
2050	1 $($(target)_$(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
2051	2 $($(target)_$(source)TOOL.$(bld_trg)) \
2052	3 $($(target)_$(source)TOOL) \
2053	4 $($(target)_TOOL.$(bld_trg).$(bld_trg_arch)) \
2054	5 $($(target)_TOOL.$(bld_trg)) \
2055	6 $($(target)_TOOL) \
2056	7 $($(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
2057	8 $($(source)TOOL.$(bld_trg)) \
2058	9 $($(source)TOOL) \
2059	10 $(TOOL.$(bld_trg).$(bld_trg_arch)) \
2060	11 $(TOOL.$(bld_trg)) \
2061	12 $(TOOL) )
2062	$(error kBuild: TOOL_$(tool)_$(tool_do)_CMDS isn't defined! target=$(target) )
2063	endif
2064
2065	# call the tool
2066	$(target)_CMDS_ := $(TOOL_$(tool)_$(tool_do)_CMDS)
2067	ifneq ($(pre_cmds),)
2068	$(target)_CMDS_ := $(TAB)$(pre_cmds)$(NL)$(TAB)$($(target)_CMDS_)
2069	endif
2070	ifneq ($(post_cmds),)
2071	$(target)_CMDS_ := $($(target)_CMDS_)$(NL)$(TAB)$(post_cmds)
2072	endif
2073	$(target)_OUTPUT_ := $(TOOL_$(tool)_$(tool_do)_OUTPUT)
2074	$(target)_OUTPUT_MAYBE_ := $(TOOL_$(tool)_$(tool_do)_OUTPUT_MAYBE)
2075	$(target)_DEPEND_ := $(TOOL_$(tool)_$(tool_do)_DEPEND) $(deps) $(objs)
2076	$(target)_DEPORD_ := $(TOOL_$(tool)_$(tool_do)_DEPORD) $(dirdep) $(orderdeps)
2077
2078	# generate the link rule.
2079	$(eval $(def_link_rule))
2080
2081
2082	# Update globals.
2083	_OBJS += $($(target)_OBJS_)
2084	_OUT_FILES += $($(target)_OUTPUT_) $(out)
2085	_CLEAN_FILES += $($(target)_CLEAN) $($(target)_CLEAN.$(bld_trg)) $($(target)_CLEAN.$(bld_trg).$(bld_trg_arch)) $($(target)_CLEAN.$(bld_trg_arch)) $($(target)_CLEAN.$(bld_trg_cpu)) $($(target)_CLEAN.$(bld_type))
2086	_DIRS += $($(target)_BLDDIRS) $($(target)_BLDDIRS.$(bld_trg)) $($(target)_BLDDIRS.$(bld_trg).$(bld_trg_arch)) $($(target)_BLDDIRS.$(bld_trg_arch)) $($(target)_BLDDIRS.$(bld_trg_cpu)) $($(target)_BLDDIRS.$(bld_type))
2087	_INSTALLS_FILES += $(INSTARGET_$(target))
2088
2089	endef
2090
2091
2092	#
2093	# BLDPROGS
2094	#
2095
2096	## Build program (one).
2097	# @param $(target) Normalized target (program) name.
2098	define def_bldprog
2099
2100	# set NOINST if not forced installation.
2101	ifndef $(target)_INST
2102	$(target)_NOINST := 1
2103	endif
2104
2105	# do the usual stuff.
2106	$(eval $(value def_link_common))
2107
2108	endef
2109
2110	# Process build programs.
2111	EXT := EXE
2112	EXTPRE := HOST
2113	tool_do := LINK_PROGRAM
2114	definst := $(PATH_BIN)
2115	typevar := _BLDPROGS
2116	mode := 0755
2117	bld_trg_base_var := PLATFORM
2118	$(foreach target, $(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)), $(eval $(value def_bldprog)))
2119
2120	ifdef KBUILD_PROFILE_SELF
2121	_KBUILD_TS_NOW := $(nanots )
2122	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done build program targets)
2123	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2124	endif
2125
2126
2127	#
2128	# DLLS
2129	#
2130
2131	# Process dlls
2132	EXT := DLL
2133	EXTPRE :=
2134	tool_do := LINK_DLL
2135	definst := $(PATH_DLL)
2136	typevar := _DLLS
2137	mode := 0644
2138	bld_trg_base_var := TARGET
2139	$(foreach target, $(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
2140
2141	ifdef KBUILD_PROFILE_SELF
2142	_KBUILD_TS_NOW := $(nanots )
2143	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done dll targets)
2144	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2145	endif
2146
2147
2148	#
2149	# IMPORT LIBRARIES
2150	#
2151	# - On OS/2 and windows these are libraries.
2152	# - On other platforms they are fake DLLs.
2153	#
2154	EXTPRE :=
2155	typevar := _IMPORT_LIBS
2156	mode := 0644
2157	bld_trg_base_var := TARGET
2158	ifeq ($(filter-out nt os2 win win64 win32,$(BUILD_TARGET)),)
2159	EXT := LIB
2160	tool_do := LINK_LIBRARY
2161	definst := $(PATH_LIB)
2162	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_lib)))
2163	else
2164	EXT := DLL
2165	tool_do := LINK_DLL
2166	definst := $(PATH_DLL)
2167	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
2168	endif
2169
2170	ifdef KBUILD_PROFILE_SELF
2171	_KBUILD_TS_NOW := $(nanots )
2172	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done import library targets)
2173	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2174	endif
2175
2176
2177	#
2178	# PROGRAMS
2179	#
2180
2181	# Process programs
2182	EXT := EXE
2183	EXTPRE :=
2184	tool_do := LINK_PROGRAM
2185	definst := $(PATH_BIN)
2186	typevar := _PROGRAMS
2187	mode := 0755
2188	bld_trg_base_var := TARGET
2189	$(foreach target, $(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
2190
2191	ifdef KBUILD_PROFILE_SELF
2192	_KBUILD_TS_NOW := $(nanots )
2193	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done program targets)
2194	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2195	endif
2196
2197
2198	#
2199	# SYSMODS
2200	#
2201
2202	# Process sysmods
2203	EXT := SYS
2204	EXTPRE :=
2205	tool_do := LINK_SYSMOD
2206	definst := $(PATH_SYS)
2207	typevar := _SYSMODS
2208	mode := 0644
2209	bld_trg_base_var := TARGET
2210	$(foreach target, $(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
2211
2212	ifdef KBUILD_PROFILE_SELF
2213	_KBUILD_TS_NOW := $(nanots )
2214	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done sysmod targets)
2215	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2216	endif
2217
2218
2219	#
2220	# OTHERS
2221	#
2222	_OTHERS = $(OTHERS) $(OTHERS.$(BUILD_TARGET)) $(OTHERS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
2223
2224
2225	#
2226	# INSTALLS
2227	#
2228
2229	## generate the install rule
2230	define def_install_src_rule
2231	# the install rule
2232	$(insdst) : $(srcsrc) \| $(call DIRDEP,$(dir $(insdst)))
2233	$$(call MSG_INST_FILE,$(srcsrc),$(insdst))
2234	$$(QUIET)$(inscmd)
2235	endef
2236
2237	## install one file
2238	define def_install_src
2239
2240	# deal with '=>' in the source file name.
2241	srcdst := $(subst =>, ,$(src))
2242	srcsrc := $(firstword $(srcdst))
2243	srcdstdir := $(dir $(word 2,$(srcdst)))
2244	srcdst := $(word $(words $(srcdst)),$(srcdst))
2245
2246	# _INSTFUN
2247	ifdef $(srcsrc)_INSTFUN
2248	instfun := $(srcsrc)_INSTFUN
2249	else
2250	ifdef $(target)_INSTFUN
2251	instfun := $(target)_INSTFUN
2252	else
2253	instfun := _INSTALL_FILE
2254	endif
2255	endif
2256
2257	# _INST
2258	ifdef $(srcsrc)_INST
2259	inst := $(patsubst %/,%,$($(srcsrc)_INST))/$(dir $(srcdstdir))
2260	else
2261	ifdef $(target)_INST
2262	inst := $(patsubst %/,%,$($(target)_INST))/$(dir $(srcdstdir))
2263	else
2264	inst := $(dir $(srcdstdir))
2265	endif
2266	endif
2267
2268	# calc target
2269	insdst := $(call $(instfun),$(srcdst),$(target),$(inst),$(PATH_INS))
2270	#$(warning instfun=$(instfun) srcdst=$(srcdst) target=$(target) inst=$(inst) => insdst=$(insdst))
2271
2272	# mode, uid and gid
2273	mode := $(firstword \
2274	$($(target)_$(srcsrc)_MODE.$(bld_trg).$(bld_trg_arch)) \
2275	$($(target)_$(srcsrc)_MODE.$(bld_trg)) \
2276	$($(target)_$(srcsrc)_MODE) \
2277	$($(target)_$(srcdst)_MODE.$(bld_trg).$(bld_trg_arch)) \
2278	$($(target)_$(srcdst)_MODE.$(bld_trg)) \
2279	$($(target)_$(srcdst)_MODE) \
2280	$($(srcsrc)_MODE.$(bld_trg).$(bld_trg_arch)) \
2281	$($(srcsrc)_MODE.$(bld_trg)) \
2282	$($(srcsrc)_MODE) \
2283	$($(srcdst)_MODE.$(bld_trg).$(bld_trg_arch)) \
2284	$($(srcdst)_MODE.$(bld_trg)) \
2285	$($(srcdst)_MODE) \
2286	$($(target)_MODE.$(bld_trg).$(bld_trg_arch)) \
2287	$($(target)_MODE.$(bld_trg)) \
2288	$($(target)_MODE))
2289	uid := $(firstword \
2290	$($(target)_$(srcsrc)_UID.$(bld_trg).$(bld_trg_arch)) \
2291	$($(target)_$(srcsrc)_UID.$(bld_trg)) \
2292	$($(target)_$(srcsrc)_UID) \
2293	$($(target)_$(srcdst)_UID.$(bld_trg).$(bld_trg_arch)) \
2294	$($(target)_$(srcdst)_UID.$(bld_trg)) \
2295	$($(target)_$(srcdst)_UID) \
2296	$($(srcsrc)_UID.$(bld_trg).$(bld_trg_arch)) \
2297	$($(srcsrc)_UID.$(bld_trg)) \
2298	$($(srcsrc)_UID) \
2299	$($(srcdst)_UID.$(bld_trg).$(bld_trg_arch)) \
2300	$($(srcdst)_UID.$(bld_trg)) \
2301	$($(srcdst)_UID) \
2302	$($(target)_UID.$(bld_trg).$(bld_trg_arch)) \
2303	$($(target)_UID.$(bld_trg)) \
2304	$($(target)_UID))
2305	gid := $(firstword \
2306	$($(target)_$(srcsrc)_GID.$(bld_trg).$(bld_trg_arch)) \
2307	$($(target)_$(srcsrc)_GID.$(bld_trg)) \
2308	$($(target)_$(srcsrc)_GID) \
2309	$($(target)_$(srcdst)_GID.$(bld_trg).$(bld_trg_arch)) \
2310	$($(target)_$(srcdst)_GID.$(bld_trg)) \
2311	$($(target)_$(srcdst)_GID) \
2312	$($(srcsrc)_GID.$(bld_trg).$(bld_trg_arch)) \
2313	$($(srcsrc)_GID.$(bld_trg)) \
2314	$($(srcsrc)_GID) \
2315	$($(srcdst)_GID.$(bld_trg).$(bld_trg_arch)) \
2316	$($(srcdst)_GID.$(bld_trg)) \
2317	$($(srcdst)_GID) \
2318	$($(target)_GID.$(bld_trg).$(bld_trg_arch)) \
2319	$($(target)_GID.$(bld_trg)) \
2320	$($(target)_GID))
2321	flags := \
2322	$($(target)_IFFLAGS) \
2323	$($(target)_IFFLAGS.$(bld_trg)) \
2324	$($(target)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2325	$($(srcdst)_IFFLAGS) \
2326	$($(srcdst)_IFFLAGS.$(bld_trg)) \
2327	$($(srcdst)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2328	$($(srcsrc)_IFFLAGS) \
2329	$($(srcsrc)_IFFLAGS.$(bld_trg)) \
2330	$($(srcsrc)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2331	$($(target)_$(srcdst)_IFFLAGS) \
2332	$($(target)_$(srcdst)_IFFLAGS.$(bld_trg)) \
2333	$($(target)_$(srcdst)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2334	$($(target)_$(srcsrc)_IFFLAGS) \
2335	$($(target)_$(srcsrc)_IFFLAGS.$(bld_trg)) \
2336	$($(target)_$(srcsrc)_IFFLAGS.$(bld_trg).$(bld_trg_arch))
2337
2338
2339	# Adjust the source if we got a default PATH. (This must be done this late!)
2340	ifdef $(target)_PATH
2341	srcsrc := $(abspathex $(srcsrc),$($(target)_PATH))
2342	endif
2343
2344	# create the command
2345	ifdef $(srcsrc)_INSTALLER
2346	inscmd := $(call $(srcsrc)_INSTALLER,$(srcsrc),$(insdst),$(target),$(flags))
2347	else ifdef $(target)_INSTALLER
2348	inscmd := $(call $(target)_INSTALLER,$(srcsrc),$(insdst),$(target),$(flags))
2349	else
2350	inscmd := $$(INSTALL)\
2351	$(if $(uid),-o $(uid))\
2352	$(if $(gid),-g $(gid))\
2353	$(if $(mode),-m $(mode))\
2354	$(flags)\
2355	$(srcsrc) $(insdst)
2356	endif
2357
2358	# generate the rule (need double evaluation here)
2359	$(eval $(def_install_src_rule))
2360
2361	INSTARGET_$(target) += $(insdst)
2362	endef
2363
2364
2365	## generate the symlink rule
2366	define def_install_symlink_rule
2367	# the install rule
2368	$(insdst) : \| $(call DIRDEP,$(dir $(insdst)))
2369	$$(call MSG_INST_SYM,$(insdst),$(symdst))
2370	$$(QUIET)$$(RM) -f $$@
2371	$$(QUIET)$$(LN_SYMLINK) $(symdst) $(insdst)
2372	endef
2373
2374	## create one symlink
2375	define def_install_symlink
2376
2377	# deal with '=>' in the source file name.
2378	symdst := $(subst =>, ,$(src))
2379	symlnk := $(firstword $(symdst))
2380	symdst := $(word $(words $(symdst)),$(symdst))
2381
2382	# _INSTFUN
2383	ifdef $(symlnk)_INSTFUN
2384	instfun := $(symlnk)_INSTFUN
2385	else ifdef $(target)_INSTFUN
2386	instfun := $(target)_INSTFUN
2387	else
2388	instfun := _INSTALL_FILE
2389	endif
2390
2391	# _INST
2392	ifdef $(symlnk)_INST
2393	inst := $(patsubst %/,%,$($(symlnk)_INST))/$(dir $(symlnk))
2394	else ifdef $(target)_INST
2395	inst := $(patsubst %/,%,$($(target)_INST))/$(dir $(symlnk))
2396	else
2397	inst := $(dir $(symlnk))
2398	endif
2399
2400	# calc target
2401	insdst := $(call $(instfun),$(symlnk),$(target),$(inst),$(PATH_INS))
2402	#$(warning symlnk=$(symlnk) symdst=$(symdst) insdst=$(insdst) instfun=$(instfun) inst='$(inst)')
2403
2404	# generate the rule (need double evaluation here)
2405	$(eval $(def_install_symlink_rule))
2406
2407	INSTARGET_$(target) += $(insdst)
2408	endef
2409
2410
2411	## generate the install rule
2412	define def_install_directory_rule
2413	# the install rule
2414	$(insdst):
2415	$$(call MSG_INST_DIR,$(insdst))
2416	$$(QUIET)$$(INSTALL) -d \
2417	$(if $(uid),-o $(uid))\
2418	$(if $(gid),-g $(gid))\
2419	$(if $(mode),-m $(mode))\
2420	$(flags)\
2421	$(insdst)
2422
2423	.NOTPARALLEL: $(insdst)
2424	endef
2425
2426
2427	## create one directory
2428	define def_install_directory
2429
2430	# _INST
2431	ifdef $(directory)_INST
2432	inst := $(PATH_INS)/$(patsubst %/,%,$($(directory)_INST))
2433	else ifdef $(target)_INST
2434	inst := $(PATH_INS)/$(patsubst %/,%,$($(target)_INST))
2435	else
2436	inst := $(PATH_INS)
2437	endif
2438
2439	mode := $(firstword \
2440	$($(target)_$(directory)_MODE.$(bld_trg).$(bld_trg_arch)) \
2441	$($(target)_$(directory)_MODE.$(bld_trg)) \
2442	$($(target)_$(directory)_MODE) \
2443	$($(directory)_MODE.$(bld_trg).$(bld_trg_arch)) \
2444	$($(directory)_MODE.$(bld_trg)) \
2445	$($(directory)_MODE) \
2446	$($(target)_MODE.$(bld_trg).$(bld_trg_arch)) \
2447	$($(target)_MODE.$(bld_trg)) \
2448	$($(target)_MODE))
2449	uid := $(firstword \
2450	$($(target)_$(directory)_UID.$(bld_trg).$(bld_trg_arch)) \
2451	$($(target)_$(directory)_UID.$(bld_trg)) \
2452	$($(target)_$(directory)_UID) \
2453	$($(directory)_UID.$(bld_trg).$(bld_trg_arch)) \
2454	$($(directory)_UID.$(bld_trg)) \
2455	$($(directory)_UID) \
2456	$($(target)_UID.$(bld_trg).$(bld_trg_arch)) \
2457	$($(target)_UID.$(bld_trg)) \
2458	$($(target)_UID))
2459	gid := $(firstword \
2460	$($(target)_$(directory)_GID.$(bld_trg).$(bld_trg_arch)) \
2461	$($(target)_$(directory)_GID.$(bld_trg)) \
2462	$($(target)_$(directory)_GID) \
2463	$($(directory)_GID.$(bld_trg).$(bld_trg_arch)) \
2464	$($(directory)_GID.$(bld_trg)) \
2465	$($(directory)_GID) \
2466	$($(target)_GID.$(bld_trg).$(bld_trg_arch)) \
2467	$($(target)_GID.$(bld_trg)) \
2468	$($(target)_GID))
2469	flags := \
2470	$($(target)_IDFLAGS)\
2471	$($(target)_IDFLAGS.$(bld_trg)) \
2472	$($(target)_IDFLAGS.$(bld_trg).$(bld_trg_arch)) \
2473	$($(directory)_IDFLAGS) \
2474	$($(directory)_IDFLAGS.$(bld_trg)) \
2475	$($(directory)_IDFLAGS.$(bld_trg).$(bld_trg_arch)) \
2476	$($(target)_$(directory)_IDFLAGS) \
2477	$($(target)_$(directory)_IDFLAGS.$(bld_trg)) \
2478	$($(target)_$(directory)_IDFLAGS.$(bld_trg).$(bld_trg_arch))
2479
2480	insdst := $(inst)/$(directory)/
2481	#$(warning directory=$(directory) inst=$(inst) insdst=$(insdst) mode=$(mode) gid=$(gid) uid=$(uid))
2482
2483	# generate the rule (need double evaluation here)
2484	$(eval $(def_install_directory_rule))
2485
2486	INSTARGET_DIRS_$(target) += $(insdst)
2487	endef
2488
2489
2490	## process one install target.
2491	define def_install
2492	# the basics.
2493	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
2494	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))
2495	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_TARGET_ARCH))
2496	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_TARGET_CPU))
2497
2498	INSTARGET_$(target) := $($(target)_GOALS)
2499	INSTARGET_DIRS_$(target) :=
2500
2501	$(foreach directory,$($(target)_DIRS) $($(target)_DIRS.$(bld_trg)) $($(target)_DIRS.$(bld_trg).$(bld_trg_arch)) $($(target)_DIRS.$(bld_trg_arch)) $($(target)_DIRS.$(bld_trg_cpu)) $($(target)_DIRS.$(bld_type)), \
2502	$(eval $(value def_install_directory)))
2503
2504	$(foreach src,$($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)), \
2505	$(eval $(value def_install_src)))
2506
2507	$(foreach src,$($(target)_SYMLINKS) $($(target)_SYMLINKS.$(bld_trg)) $($(target)_SYMLINKS.$(bld_trg).$(bld_trg_arch)) $($(target)_SYMLINKS.$(bld_trg_arch)) $($(target)_SYMLINKS.$(bld_trg_cpu)) $($(target)_SYMLINKS.$(bld_type)), \
2508	$(eval $(value def_install_symlink)))
2509
2510	# the collection target
2511	TARGET_$(target) := $(PATH_TARGET)/$(target).ins
2512	$(TARGET_$(target)): $(INSTARGET_$(target)) \| $(INSTARGET_DIRS_$(target)) $(call DIRDEP,$(PATH_TARGET))
2513	@$(QUIET2)$(APPEND) $@
2514
2515	$(target): $(TARGET_$(target))
2516
2517	_INSTALLS += $(TARGET_$(target))
2518	_INSTALLS_FILES += $(INSTARGET_$(target))
2519	_INSTALLS_DIRS += $(INSTARGET_DIRS_$(target))
2520	_CLEAN_FILES += $($(target)_CLEAN) $($(target)_CLEAN.$(bld_trg)) $($(target)_CLEAN.$(bld_trg).$(bld_trg_arch)) $($(target)_CLEAN.$(bld_trg_arch)) $($(target)_CLEAN.$(bld_trg_cpu)) $($(target)_CLEAN.$(bld_type))
2521	_DIRS += $($(target)_BLDDIRS) $($(target)_BLDDIRS.$(bld_trg)) $($(target)_BLDDIRS.$(bld_trg).$(bld_trg_arch)) $($(target)_BLDDIRS.$(bld_trg_arch)) $($(target)_BLDDIRS.$(bld_trg_cpu)) $($(target)_BLDDIRS.$(bld_type))
2522	endef
2523
2524	## process all install targets
2525	$(foreach target, $(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
2526	$(eval $(value def_install)))
2527
2528	ifdef KBUILD_PROFILE_SELF
2529	_KBUILD_TS_NOW := $(nanots )
2530	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done install targets)
2531	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2532	endif
2533
2534
2535	#
2536	# PACKING
2537	#
2538	_PACKING += $(PACKING) $(PACKING.$(BUILD_TARGET)) $(PACKING.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
2539
2540
2541	#
2542	# DOCS
2543	#
2544
2545
2546	#
2547	# DIRECTORIES
2548	#
2549	_DIR_ALL := $(sort $(addsuffix /,$(patsubst %/,%,$(_DIRS))) $(dir $(_OUT_FILES) $(_OBJS) $(_INSTALLS_FILES)))
2550	$(foreach directory,$(_INSTALLS_DIRS), $(eval _DIR_ALL := $(filter-out $(directory),$(_DIR_ALL))))
2551
2552
2553	define def_mkdir_rule
2554	$(directory):
2555	$$(call MSG_MKDIR,$$@)
2556	$$(QUIET)$$(MKDIR) -p $$@
2557	endef
2558
2559	$(foreach directory,$(_DIR_ALL),$(eval $(def_mkdir_rule)))
2560
2561	ifdef KBUILD_PROFILE_SELF
2562	_KBUILD_TS_NOW := $(nanots )
2563	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done directories)
2564	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2565	endif
2566
2567
2568	#
2569	# NOTHING
2570	#
2571	do-nothing:
2572	ifdef KBUILD_PROFILE_SELF
2573	@$(ECHO) 'prof: $(int-sub $(nanots ), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(nanots ), $(_KBUILD_TS_PREV)) - executing $@'
2574	endif
2575	$(call MSG_NOTHING)
2576
2577
2578	#
2579	# CLEAN UP
2580	#
2581	do-clean:
2582	$(call MSG_CLEAN)
2583	$(QUIET)$(RM) -f $(_OUT_FILES) $(_OBJS) $(_DEPFILES) $(_DEPFILES_INCLUDED) $(_CLEAN_FILES) $(OTHER_CLEAN)
2584	$(QUIET)$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $(rsort $(dir $(_OUT_FILES) $(_OBJS) $(_DEPFILES) $(_DEPFILES_INCLUDED) $(_CLEAN_FILES) $(OTHER_CLEAN)))
2585
2586
2587
2588	#
2589	# PASSES (including directory and makefile walking)
2590	#
2591
2592	## Subdir
2593	# @param $(pass) Lowercase pass name.
2594	# @param $(PASS) Uppercase pass name.
2595	# @param $(subdir) Subdirectory
2596	# @param $(tag) tag to attach to the rule name.
2597	define def_pass_subdir
2598	pass_$(pass)$(tag):: $(dep)
2599	+ $$(QUIET)$$(MAKE) -C $(subdir) -f $$(notdir $$(firstword $$(wildcard $$(addprefix $(subdir)/,$$(DEFAULT_MAKEFILE))))) pass_$(pass)
2600	endef
2601
2602	## Submakefile
2603	# @param $(pass) Lowercase pass name.
2604	# @param $(PASS) Uppercase pass name.
2605	# @param $(makefile) Makefile.
2606	# @param $(tag) tag to attach to the rule name.
2607	define def_pass_makefile
2608	pass_$(pass)$(tag):: $(dep)
2609	+ $$(QUIET)$$(MAKE) -C $(patsubst %/,%,$(dir $(makefile))) -f $(notdir $(makefile)) pass_$(pass)
2610	endef
2611
2612	## Execute a pass.
2613	# @param $(pass) Lowercase pass name.
2614	# @param $(PASS) Uppercase pass name.
2615	define def_pass_old
2616	$(eval SUBDIRS_$(PASS) ?= $(SUBDIRS) $(SUBDIRS.$(BUILD_TARGET)) $(SUBDIRS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2617	$(eval SUBDIRS_AFTER_$(PASS) ?= $(SUBDIRS_AFTER) $(SUBDIRS_AFTER.$(BUILD_TARGET)) $(SUBDIRS_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2618	$(eval MAKEFILES_BEFORE_$(PASS) ?= $(MAKEFILES_BEFORE) $(MAKEFILES_BEFORE.$(BUILD_TARGET)) $(MAKEFILES_BEFORE.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2619	$(eval MAKEFILES_AFTER_$(PASS) ?= $(MAKEFILES_AFTER) $(MAKEFILES_AFTER.$(BUILD_TARGET)) $(MAKEFILES_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2620
2621	$(eval tag:=_before)
2622	$(eval dep:=)
2623	$(foreach subdir,$(SUBDIRS_$(PASS)) $(SUBDIRS_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2624	$(foreach makefile,$(MAKEFILES_BEFORE_$(PASS)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),$(eval $(def_pass_makefile)))
2625
2626	$(eval tag:=_after)
2627	$(eval dep:=pass_$(pass)_doit)
2628	$(foreach subdir,$(SUBDIRS_AFTER_$(PASS)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2629	$(foreach makefile,$(MAKEFILES_AFTER_$(PASS)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_makefile)))
2630
2631	.NOTPARALLEL: pass_$(pass)_before pass_$(pass)_after
2632	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_doit pass_$(pass)_after
2633	pass_$(pass)_doit: $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$(var))
2634	pass_$(pass)_this: pass_$(pass)_before
2635	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)_doit
2636	pass_$(pass)_after:: pass_$(pass)_this
2637	pass_$(pass): pass_$(pass)_after
2638
2639	endef
2640
2641	define def_pass
2642	$(eval SUBDIRS_$(PASS) ?= $(SUBDIRS) $(SUBDIRS.$(BUILD_TARGET)) $(SUBDIRS.$(BUILD_TARGET.$(BUILD_TARGET_ARCH))) )
2643	$(eval SUBDIRS_AFTER_$(PASS) ?= $(SUBDIRS_AFTER) $(SUBDIRS_AFTER.$(BUILD_TARGET)) $(SUBDIRS_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2644	$(eval MAKEFILES_BEFORE_$(PASS) ?= $(MAKEFILES_BEFORE) $(MAKEFILES_BEFORE.$(BUILD_TARGET)) $(MAKEFILES_BEFORE.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2645	$(eval MAKEFILES_AFTER_$(PASS) ?= $(MAKEFILES_AFTER) $(MAKEFILES_AFTER.$(BUILD_TARGET)) $(MAKEFILES_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2646
2647	$(eval tag:=_before)
2648	$(eval dep:=)
2649	$(foreach subdir,$(SUBDIRS_$(PASS)) $(SUBDIRS_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2650	$(foreach makefile,$(MAKEFILES_BEFORE_$(PASS)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),$(eval $(def_pass_makefile)))
2651
2652	$(eval tag:=_after)
2653	$(eval dep:=pass_$(pass)_doit)
2654	$(foreach subdir,$(SUBDIRS_AFTER_$(PASS)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2655	$(foreach makefile,$(MAKEFILES_AFTER_$(PASS)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_makefile)))
2656
2657	ifdef KBUILD_SAFE_PARALLEL
2658	.NOTPARALLEL: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_this
2659	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_this pass_$(pass)_doit
2660	pass_$(pass)_doit: $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$(var))
2661	pass_$(pass)_this: pass_$(pass)_before
2662	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)_doit
2663	pass_$(pass)_after:: pass_$(pass)_this
2664	pass_$(pass): pass_$(pass)_after
2665	else
2666	.NOTPARALLEL: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_doit
2667	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_doit
2668	pass_$(pass)_doit: pass_$(pass)_before \
2669	$(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$($(var)))
2670	pass_$(pass): \
2671	pass_$(pass)_before \
2672	pass_$(pass)_doit \
2673	pass_$(pass)_after
2674	endif
2675
2676	#$ (warning pass=$(pass) PASS=$(PASS): $(PASS_$(PASS)_trgs) $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$($(var))))
2677	endef
2678
2679	# Generate the defined passes.
2680	$(foreach PASS, $(PASSES), \
2681	$(eval pass := $(PASS_$(PASS)_pass)) \
2682	$(eval $(def_pass)))
2683
2684	## Pass order
2685	# @param $(pass) Current pass name.
2686	# @param $(prev_pass) The previous pass name.
2687	define def_pass_order
2688	ifdef KBUILD_SAFE_PARALLEL
2689	.NOTPARALLEL: pass_$(pass)_order
2690	.PHONY: pass_$(pass)_order
2691	pass_$(pass)_order: $(pass_prev)
2692	$$(call MSG_PASS,$$(if $$(PASS_$(PASS)),$$(PASS_$(PASS)),$(pass)))
2693	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)
2694	else
2695	.NOTPARALLEL: pass_$(pass)_order pass_$(pass)_banner
2696	.PHONY: pass_$(pass)_order pass_$(pass)_banner
2697	pass_$(pass)_banner:
2698	$$(call MSG_PASS,$$(if $$(PASS_$(PASS)),$$(PASS_$(PASS)),$(pass)))
2699	pass_$(pass)_order: \
2700	$(pass_prev) \
2701	pass_$(pass)_banner \
2702	pass_$(pass)
2703	endif
2704	$(eval pass_prev := pass_$(pass)_order)
2705	endef
2706
2707	## PASS: order
2708	# Use dependencies to ensure correct pass order.
2709	pass_prev :=
2710	$(foreach PASS,$(DEFAULT_PASSES),\
2711	$(eval pass := $(PASS_$(PASS)_pass)) \
2712	$(eval $(def_pass_order)))
2713
2714	ifdef KBUILD_PROFILE_SELF
2715	_KBUILD_TS_NOW := $(nanots )
2716	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done passes)
2717	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2718	endif
2719
2720
2721	#
2722	# THE MAIN RULES
2723	#
2724	all_recursive: $(pass_prev)
2725
2726	rebuild: clean
2727	+ $(MAKE) -f $(firstword $(MAKEFILE_LIST)) all_recursive
2728
2729	# @todo make this a non-default pass!
2730	uninstall:
2731	$(RM) -f $(_INSTALLS_FILES)
2732
2733	install: pass_installs
2734
2735	# misc shortcuts.
2736	targets: bldprogs libraries dlls programs sysmods others installs
2737	objects: $(_OBJS)
2738	bldprogs: $(_BLDPROGS)
2739	libraries: $(_LIBS) $(_IMPORT_LIBS) $(_OTHER_LIBRARIES)
2740	dlls: $(_DLLS)
2741	programs: $(_PROGRAMS)
2742	sysmods: $(_SYSMODS)
2743	others: $(_OTHERS)
2744	installs: $(_INSTALLS) $(_INSTALLS_DIRS) $(_INSTALLS_FILES)
2745
2746
2747
2748	#
2749	# kBuild debugging stuff.
2750	#
2751	show_targets:
2752	@$(foreach target, $(_ALL_TARGETS),\
2753	@$(ECHO) "target: $(target)" $(NLTAB)\
2754	@$(ECHO) " PATH_$(target)=$(PATH_$(target))" $(NLTAB)\
2755	@$(ECHO) " TARGET_$(target)=$(TARGET_$(target))" $(NLTAB)\
2756	@$(ECHO) " INSTARGET_$(target)=$(INSTARGET_$(target))" $(NLTAB)\
2757	$(foreach prop,$(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) OBJS_ CLEAN, \
2758	$(eval _tmp:=$(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))) \
2759	$(if $($(target)_$(prop).$(_tmp)),\
2760	@$(ECHO) " $(target)_$(prop).$(_tmp)=$($(target)_$(prop).$(_tmp))" $(NLTAB)) \
2761	$(if $($(target)_$(prop)), $(NLTAB)@$(ECHO) " $(target)_$(prop)=$($(target)_$(prop))" $(NLTAB)) \
2762	)\
2763	$(foreach prop,$(PROPS_DEFERRED), \
2764	$(eval _tmp:=$(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))) \
2765	$(if $(value $(target)_$(prop).$(_tmp)),\
2766	@$(ECHO) ' $(target)_$(prop).$(_tmp)=$(value $(TARGET)_$(prop).$(_tmp))' $(NLTAB)) \
2767	$(if $(value $(target)_$(prop)), $(NLTAB)@$(ECHO) ' $(target)_$(prop)=$(value $(target)_$(prop))' $(NLTAB)) \
2768	))
2769
2770
2771
2772	#
2773	# Include dependency files.
2774	#
2775	ifneq ($(_DEPFILES),)
2776	includedep $(_DEPFILES)
2777	endif
2778
2779
2780	ifdef KBUILD_PROFILE_SELF
2781	_KBUILD_TS_FOOTER_END := $(nanots )
2782	$(info prof: $(int-sub $(_KBUILD_TS_FOOTER_END), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_FOOTER_END), $(_KBUILD_TS_PREV)) - end of footer.kmk)
2783	$(info prof: footer.kmk: $(int-sub $(_KBUILD_TS_FOOTER_END), $(_KBUILD_TS_FOOTER_START)))
2784	_KBUILD_TS_PREV := $(_KBUILD_TS_FOOTER_END)
2785	endif
2786
2787	# end-of-file-content
2788	__footer_kmk__ := target
2789	endif # __footer_kmk__
2790

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

Download in other formats:

Original Format