Context Navigation

footer.kmk@ 1465

Last change on this file since 1465 was 1457, checked in by bird, 17 years ago
Fixed another template loading bug.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 112.1 KB

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

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

Download in other formats:

Original Format