Context Navigation

footer.kmk@ 1614

Last change on this file since 1614 was 1614, checked in by bird, 17 years ago
Added a CLEAN attribute to the install sources. Extended the cleaning of fetches a bit so it matches the others.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 111.8 KB

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

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

Download in other formats:

Original Format