Context Navigation

footer.kmk@ 1621

Last change on this file since 1621 was 1621, checked in by bird, 17 years ago
Introduce the concept of units to prevent footer.kmk from growing beyond proportions. Features that are rarely used are put into units and dragged in via the USES property when needed. The first example of this is how lex (.l files) is handled.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 113.7 KB

Line
1	# $Id: footer.kmk 1621 2008-05-12 19:44:45Z 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 and units.
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	_USES := $(USES.$(KBUILD_TARGET)) $(USES.$(KBUILD_TARGET_ARCH)) $(USES.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) \
1087	$(USES.$(KBUILD_HOST)) $(USES.$(KBUILD_HOST_ARCH)) $(USES.$(KBUILD_HOST).$(KBUILD_HOST_ARCH)) \
1088	$(USES.$(KBUILD_TYPE)) \
1089	$(USES)
1090	define def_tools_sdks_target_source
1091	$(eval _TOOLS += $(foreach prop, $(PROPS_TOOLS), \
1092	$($(source)_$(prop).$(_bld_trg)) \
1093	$($(target)_$(source)_$(prop).$(_bld_trg)) \
1094	$($(source)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
1095	$($(target)_$(source)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
1096	$($(source)_$(prop).$(_bld_trg_arch)) \
1097	$($(target)_$(source)_$(prop).$(_bld_trg_arch)) \
1098	$($(source)_$(prop)) \
1099	$($(target)_$(source)_$(prop))))
1100	$(eval _SDKS += \
1101	$($(source)_SDKS.$(_bld_trg)) \
1102	$($(target)_$(source)_SDKS.$(_bld_trg)) \
1103	$($(source)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
1104	$($(target)_$(source)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
1105	$($(source)_SDKS.$(_bld_trg_arch)) \
1106	$($(target)_$(source)_SDKS.$(_bld_trg_arch)) \
1107	$($(source)_SDKS.$(KBUILD_TYPE)) \
1108	$($(target)_$(source)_SDKS.$(KBUILD_TYPE)) \
1109	$($(source)_SDKS) \
1110	$($(target)_$(source)_SDKS))
1111	$(eval _USES += \
1112	$($(source)_USES.$(_bld_trg)) \
1113	$($(target)_$(source)_USES.$(_bld_trg)) \
1114	$($(source)_USES.$(_bld_trg).$(_bld_trg_arch)) \
1115	$($(target)_$(source)_USES.$(_bld_trg).$(_bld_trg_arch)) \
1116	$($(source)_USES.$(_bld_trg_arch)) \
1117	$($(target)_$(source)_USES.$(_bld_trg_arch)) \
1118	$($(source)_USES.$(KBUILD_TYPE)) \
1119	$($(target)_$(source)_USES.$(KBUILD_TYPE)) \
1120	$($(source)_USES) \
1121	$($(target)_$(source)_USES))
1122	endef # def_tools_sdks_target_source
1123
1124	define def_tools_sdks_target
1125	local _bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
1126	local _bld_trg := $(firstword $($(target)_BLD_TRG) $(bld_trg))
1127	local _bld_trg_arch := $(firstword $($(target)_BLD_TRG_ARCH) $(bld_trg_arch))
1128	local _bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(bld_trg_cpu))
1129
1130	$(eval _TOOLS += $(foreach prop, $(PROPS_TOOLS), \
1131	$($(target)_$(prop).$(_bld_trg)) \
1132	$($(target)_$(prop).$(_bld_trg_arch)) \
1133	$($(target)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
1134	$($(target)_$(prop))))
1135	$(eval _SDKS += \
1136	$($(target)_SDKS.$(_bld_trg)) \
1137	$($(target)_SDKS.$(_bld_trg_arch)) \
1138	$($(target)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
1139	$($(target)_SDKS))
1140	$(eval _USES += \
1141	$($(target)_USES.$(_bld_trg)) \
1142	$($(target)_USES.$(_bld_trg_arch)) \
1143	$($(target)_USES.$(_bld_trg).$(_bld_trg_arch)) \
1144	$($(target)_USES))
1145	$(foreach source, \
1146	$($(target)_SOURCES.$(_bld_trg)) \
1147	$($(target)_SOURCES.$(_bld_trg_arch)) \
1148	$($(target)_SOURCES.$(_bld_trg).$(_bld_trg_arch)) \
1149	$($(target)_SOURCES.$(_bld_trg_cpu)) \
1150	$($(target)_SOURCES.$(_bld_type)) \
1151	$($(target)_SOURCES) \
1152	, $(evalval def_tools_sdks_target_source))
1153	endef # def_tools_sdks_target
1154
1155	define def_tools_srcname_target
1156	local _bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
1157	local _bld_trg := $(firstword $($(target)_BLD_TRG) $(bld_trg))
1158	local _bld_trg_arch := $(firstword $($(target)_BLD_TRG_ARCH) $(bld_trg_arch))
1159	local _bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(bld_trg_cpu))
1160
1161	$(foreach source, $(notdir\
1162	$($(target)_SOURCES.$(_bld_trg)) \
1163	$($(target)_SOURCES.$(_bld_trg_arch)) \
1164	$($(target)_SOURCES.$(_bld_trg).$(_bld_trg_arch)) \
1165	$($(target)_SOURCES.$(_bld_trg_cpu)) \
1166	$($(target)_SOURCES.$(_bld_type)) \
1167	$($(target)_SOURCES) \
1168	), $(evalval def_tools_sdks_target_source))
1169	endef # def_tools_srcname_target
1170
1171	bld_trg := $(KBUILD_TARGET)
1172	bld_trg_arch := $(KBUILD_TARGET_ARCH)
1173	bld_trg_cpu := $(KBUILD_TARGET_CPU)
1174	$(foreach target, $(_ALL_TARGET_TARGETS), $(evalval def_tools_sdks_target))
1175	$(foreach target, $(_ALL_SRCNAME_TARGETS), $(evalval def_tools_srcname_target))
1176
1177	bld_trg := $(KBUILD_HOST)
1178	bld_trg_arch := $(KBUILD_HOST_ARCH)
1179	bld_trg_cpu := $(KBUILD_HOST_CPU)
1180	$(foreach target, $(_ALL_HOST_TARGETS), $(evalval def_tools_sdks_target))
1181
1182	_TOOLS := $(sort $(_TOOLS))
1183	_SDKS := $(sort $(_SDKS))
1184
1185	## Tool load function.
1186	# @param loading The tool name
1187	define def_tools_load_function
1188	ifndef TOOL_$(loading)
1189	TOOL_$(loading)_KMK_FILE := $(firstword $(foreach path, $(KBUILD_TOOL_PATHS) $(KBUILD_PATH)/tools $(KBUILD_DEFAULT_PATHS), $(wildcard $(path)/$(loading).kmk)))
1190	ifeq ($(TOOL_$(loading)_KMK_FILE),)
1191	$(error kBuild: Cannot find include file for the tool '$(loading)'! Searched: $(KBUILD_TOOL_PATHS) $(KBUILD_PATH)/tools $(KBUILD_DEFAULT_PATHS))
1192	endif
1193	include $(TOOL_$(loading)_KMK_FILE)
1194	ifndef TOOL_$(loading)
1195	$(warning kBuild: TOOL_$(loading) was not defined by $(TOOL_$(loading)_KMK_FILE)!)
1196	endif
1197	endif
1198	endef # def_tools_include
1199
1200	## SDK load function.
1201	# @param loading The tool name
1202	define def_sdk_load_function
1203	ifndef SDK_$(loading)
1204	SDK_$(loading)_KMK_FILE := $(firstword $(foreach path, $(KBUILD_SDK_PATHS) $(KBUILD_PATH)/sdks $(KBUILD_DEFAULT_PATHS), $(wildcard $(path)/$(loading).kmk)))
1205	ifeq ($(SDK_$(loading)_KMK_FILE),)
1206	$(error kBuild: Cannot find include file for the SDK '$(loading)'! Searched: $(KBUILD_SDK_PATHS) $(KBUILD_PATH)/sdks $(KBUILD_DEFAULT_PATHS))
1207	endif
1208	include $(SDK_$(loading)_KMK_FILE)
1209	ifndef SDK_$(loading)
1210	$(warning kBuild: SDK_$(loading) was not defined by $(SDK_$(loading)_KMK_FILE)!)
1211	endif
1212	endif
1213	endef # def_sdk_load_function
1214
1215	## Unit load function.
1216	# @param loading The unit name
1217	define def_unit_load_function
1218	ifndef UNIT_$(loading)
1219	UNIT_$(loading)_KMK_FILE := $(firstword $(foreach path, $(KBUILD_UNIT_PATHS) $(KBUILD_PATH)/units $(KBUILD_DEFAULT_PATHS), $(wildcard $(path)/$(loading).kmk)))
1220	ifeq ($(UNIT_$(loading)_KMK_FILE),)
1221	$(error kBuild: Cannot find include file for the unit '$(loading)'! Searched: $(KBUILD_UNIT_PATHS) $(KBUILD_PATH)/units $(KBUILD_DEFAULT_PATHS))
1222	endif
1223	include $(UNIT_$(loading)_KMK_FILE)
1224	ifndef UNIT_$(loading)
1225	$(warning kBuild: UNIT_$(loading) was not defined by $(UNIT_$(loading)_KMK_FILE)!)
1226	endif
1227	endif
1228	endef # def_unit_load_function
1229
1230
1231	properties :=
1232	properties_now_l :=
1233	properties_now_r :=
1234	properties_deferred := $(PROPS_SINGLE) $(PROPS_DEFERRED)
1235	properties_deferred_l := $(PROPS_ACCUMULATE_L)
1236	properties_deferred_r := $(PROPS_ACCUMULATE_R)
1237
1238	src_prefix := TOOL_
1239	load_function := def_tools_load_function
1240	$(foreach trg, $(_TOOLS), $(evalval def_inherit))
1241
1242	src_prefix := SDK_
1243	load_function := def_sdk_load_function
1244	$(foreach trg, $(_SDKS) , $(evalval def_inherit))
1245
1246	# done inheriting.
1247	src_prefix :=
1248	load_function :=
1249	properties :=
1250	properties_now_l :=
1251	properties_now_r :=
1252	properties_deferred :=
1253	properties_deferred_l :=
1254	properties_deferred_r :=
1255
1256	# No inheriting for the uses, they're just global 'code'.
1257	$(foreach loading, $(_USES), $(evalval def_unit_load_function))
1258
1259
1260	ifdef KBUILD_PROFILE_SELF
1261	_KBUILD_TS_NOW := $(nanots )
1262	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done tools, sdks and units)
1263	$(info stat: $(make-stats ))
1264	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
1265	endif
1266
1267
1268
1269	#
1270	#
1271	# Target lists - Pass 1
1272	#
1273	# This pass is for defining variables that might be referenced in
1274	# properties of other targets.
1275	#
1276	#
1277
1278	# Don't do anything for fetch targets (yet).
1279
1280	##
1281	# Link prolog for Pass 1.
1282	#
1283	# @param $(target) Normalized target name.
1284	# @param $(EXT) EXE,DLL,SYS,LIB.
1285	# @param $(EXTPRE) HOST or nothing.
1286	# @param $(definst) The default _INST value.
1287	# @param $(tool_prefix) LD or AR.
1288	# @param $(bld_trg_base_var) TARGET or PLATFORM.
1289	define def_pass1_link_common
1290
1291	local bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
1292	local bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_$(bld_trg_base_var)))
1293	local bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_$(bld_trg_base_var)_ARCH))
1294	local bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_$(bld_trg_base_var)_CPU))
1295
1296	local tool := $(call _TARGET_TOOL,$(target),$(tool_prefix))
1297	local name := $(firstword\
1298	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1299	$($(target)_NAME.$(bld_trg_arch))\
1300	$($(target)_NAME.$(bld_trg))\
1301	$($(target)_NAME.$(bld_type))\
1302	$($(target)_NAME)\
1303	$(target))
1304	local outbase := $(call TARGET_BASE,$(name),$(target))
1305	ifndef PATH_$(target)
1306	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
1307	else ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
1308	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
1309	endif
1310	ifeq ($(tool_prefix),AR) ## @todo fix this mess!
1311	local suff := $(firstword\
1312	$($(target)_$(EXT)SUFF.$(bld_trg).$(bld_trg_arch))\
1313	$($(target)_$(EXT)SUFF.$(bld_trg))\
1314	$($(target)_$(EXT)SUFF)\
1315	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF.$(bld_trg).$(bld_trg_arch))\
1316	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF.$(bld_trg))\
1317	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF)\
1318	$(SUFF_LIB))
1319	else
1320	local suff := $(firstword \
1321	$($(target)_$(EXT)SUFF) \
1322	$($(target)_$(EXT)SUFF) \
1323	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF) \
1324	$($(EXTPRE)SUFF_$(EXT)))
1325	endif
1326	local out := $(outbase)$(suff)
1327
1328	# TARGET_*
1329	TARGET_$(target) := $(out)
1330
1331	# INSTARGET_*
1332	ifndef $(target)_NOINST
1333	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
1334	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
1335
1336	else # NOINST
1337	INSTARGET_$(target) :=
1338	endif # NOINST
1339
1340	endef
1341
1342
1343	#
1344	# BLDPROGS (Pass 1)
1345	#
1346	define def_pass1_bldprog
1347	# set NOINST if not forced installation before doing the usual stuff.
1348	ifndef $(target)_INST
1349	$(target)_NOINST := 1
1350	endif
1351	$(evalval def_pass1_link_common)
1352	endef
1353
1354	EXT := EXE
1355	EXTPRE := HOST
1356	definst := $(PATH_BIN)
1357	tool_prefix := LD
1358	bld_trg_base_var := PLATFORM
1359	$(foreach target, $(BLDPROGS) $(BLDPROGS.$(KBUILD_HOST)) $(BLDPROGS.$(KBUILD_HOST).$(KBUILD_HOST_ARCH)), \
1360	$(evalval def_pass1_bldprog))
1361
1362
1363	#
1364	# LIBRARIES (Pass 1)
1365	#
1366	EXT := LIB
1367	EXTPRE :=
1368	definst := $(PATH_LIB)
1369	tool_prefix := AR
1370	bld_trg_base_var := TARGET
1371	$(foreach target, $(LIBRARIES) $(LIBRARIES.$(KBUILD_TARGET)) $(LIBRARIES.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1372	$(evalval def_pass1_link_common))
1373
1374
1375	#
1376	# DLLS (Pass 1)
1377	#
1378	EXT := DLL
1379	EXTPRE :=
1380	definst := $(PATH_DLL)
1381	tool_prefix := LD
1382	bld_trg_base_var := TARGET
1383	$(foreach target, $(DLLS) $(DLLS.$(KBUILD_TARGET)) $(DLLS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1384	$(evalval def_pass1_link_common))
1385
1386
1387	#
1388	# IMPORT LIBRARIES (Pass 1)
1389	#
1390	# - On OS/2 and windows these are libraries.
1391	# - On other platforms they are fake DLLs.
1392	#
1393	if1of ($(KBUILD_TARGET), nt os2 win win64 win32)
1394	EXT := LIB
1395	EXTPRE :=
1396	definst := $(PATH_LIB)
1397	tool_prefix := AR
1398	bld_trg_base_var := TARGET
1399	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(KBUILD_TARGET)) $(IMPORT_LIBS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1400	$(evalval def_pass1_link_common))
1401	else
1402	EXT := DLL
1403	EXTPRE :=
1404	definst := $(PATH_DLL)
1405	tool_prefix := LD
1406	bld_trg_base_var := TARGET
1407	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(KBUILD_TARGET)) $(IMPORT_LIBS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1408	$(evalval def_pass1_link_common))
1409	endif
1410
1411
1412	#
1413	# PROGRAMS (Pass 1)
1414	#
1415	EXT := EXE
1416	EXTPRE :=
1417	definst := $(PATH_BIN)
1418	tool_prefix := LD
1419	bld_trg_base_var := TARGET
1420	$(foreach target, $(PROGRAMS) $(PROGRAMS.$(KBUILD_TARGET)) $(PROGRAMS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1421	$(evalval def_pass1_link_common))
1422
1423
1424	#
1425	# SYSMODS (Pass 1)
1426	#
1427	EXT := SYS
1428	EXTPRE :=
1429	definst := $(PATH_SYS)
1430	tool_prefix := LD
1431	bld_trg_base_var := TARGET
1432	$(foreach target, $(SYSMODS) $(SYSMODS.$(KBUILD_TARGET)) $(SYSMODS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1433	$(evalval def_pass1_link_common))
1434
1435
1436	#
1437	# INSTALLS (Pass 1)
1438	# Note! INSTARGET_* for INSTALLS aren't available until later.
1439	#
1440	define def_pass1_install
1441	local bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
1442	local bld_trg := $(firstword $($(target)_BLD_TRG) $(KBUILD_TARGET))
1443	local bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(KBUILD_TARGET_ARCH))
1444	local bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(KBUILD_TARGET_CPU))
1445	# TARGET_*
1446	TARGET_$(target) := $(PATH_TARGET)/$(target).ins
1447	# INSTARGET_ later.
1448	endef
1449	$(foreach target, $(INSTALLS) $(INSTALLS.$(KBUILD_TARGET)) $(INSTALLS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1450	$(evalval def_pass1_install))
1451
1452	ifdef KBUILD_PROFILE_SELF
1453	_KBUILD_TS_NOW := $(nanots )
1454	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done pass 1)
1455	$(info stat: $(make-stats ))
1456	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
1457	endif
1458
1459
1460
1461
1462	#
1463	#
1464	# Target lists - Pass 2
1465	#
1466	#
1467
1468
1469	## @page pg_fetches Fetching Tools, Sources and Similar.
1470	#
1471	# The targets listed in the the FETCHES target list have the following attributes:
1472	# SOURCES
1473	# INST
1474	# FETCHTOOL
1475	# FETCHFLAGS
1476	# FETCHDIR
1477	# UNPACKTOOL
1478	# UNPACKFLAGS
1479	#
1480	# As usual the target name is an alias for 'creating' the target. Other
1481	# aliases are:
1482	# pass_fetches
1483	# fetch
1484	# unfetch
1485	# download
1486	# unpack
1487	#
1488	# @remark
1489	#
1490	# This is a little bit complex because we must guarantee that if a source file
1491	# changes only sligtly we must refetch it and to a proper unpacking of it. It
1492	# is also a desire that fetched archives and unpacked files can be deleted to
1493	# save space.
1494	#
1495	# Thus, we must be able to cleanup what we've unpacked should any of the
1496	# sources be removed. We do this by maintaining a file listing the files
1497	# and directories that was unpacked. This operation is named 'unfetch'.
1498	#
1499	# We make use of the SIZE and MD5 attributes for each of the sources to
1500	# create a digest that is stored in the primary target file. Subsequent
1501	# runswill compare their digest with it to decide if a refetch is required.
1502	# When a refetch is found necessary, an 'unfetch' is performed first to
1503	# clean out old files and directores. Note even changes in source order
1504	# will cause a refetch due to the way the digest is constructed and
1505	# evaluated.
1506	#
1507	# By not depending directly on the archives (nor on any unpacked files)
1508	# but on a goal made up from the archive name, size and md5, we allow
1509	# the user to delete the archives. Naturally, this means we'll have to
1510	# check and fetch missing archives before attempting to unpack them.
1511	#
1512	# @remark
1513	#
1514	# This feature will NOT work correctly with vanilla GNU make becuase
1515	# it makes use of includedep to avoid too many unnecessary files.
1516	#
1517	# @todo
1518	# 1. Download corruption / continuation.
1519	# 2. It's quite possible that there is one too many indirect dependency now...
1520	#
1521
1522	## generates the fetch rule
1523	define def_fetch_src_fetch_rule
1524	# Indirect goal for downloading something.
1525	.PRECIOUS: $(out)
1526	$(out) + $($(target)_$(srcname)_FETCH_OUTPUT_) +\| $($(target)_$(srcname)_FETCH_OUTPUT_MAYBE_) : \
1527	\| $($(target)_$(srcname)_FETCH_DEPORD_)
1528	%$$(call MSG_FETCH_DL,$(target),$(source),$(out))
1529	@## @todo do fancy stuff like download continuation.
1530	$$(QUIET)$$(RM) -f -- $(out)
1531	$($(target)_$(srcname)_FETCH_CMDS_)
1532	$$(QUIET)$(if $(md5),$$(MD5SUM_EXT) -b -C $(md5) $(out))
1533
1534
1535
1536	# Intermediate goal for making sure the md5 and size matches. it will (re) fetch the archive if necessary.
1537	$(out).checked_$(md5)_$(size): $($(target)_$(srcname)_FETCH_DEPEND_) \| $($(target)_$(srcname)_FETCH_DEPORD_)
1538	%$$(call MSG_FETCH_CHK,$(target),$(source),$(out))
1539	$$(QUIET)$$(RM) -f -- $$@
1540	@# (re)fetch the file if it doesn't exist or if it doesn't matches the md5.
1541	@## @todo do fancy stuff like download continuation.
1542	$$(QUIET)( test -f $(out) && $(if $(md5),$$(MD5SUM_EXT) -b -C $(md5) $(out), true) ) \
1543	\|\| ( $$(RM_EXT) -f $(out) \
1544	&& $$(MAKE) $(out) -f $(MAKEFILE) --no-print-directory )
1545	$$(QUIET2)$$(APPEND) $$@
1546
1547	_TARGET_$(target)_FETCHED += $(out) $(out).checked_$(md5)_$(size)
1548
1549	# Just a little precaution.
1550	.NOTPARALLEL: $(out) $(out).checked_$(md5)_$(size)
1551
1552	endef
1553
1554	## generates the unpack rule
1555	define def_fetch_src_unpack_rule
1556	# This is the unpack rule. it has an order-only dependency on the download check.
1557	$(out) + $($(target)_$(srcname)_UNPACK_OUTPUT_) +\| $($(target)_$(srcname)_UNPACK_OUTPUT_MAYBE_) : \
1558	$($(target)_$(srcname)_UNPACK_DEPEND_) \
1559	\| $($(target)_$(srcname)_UNPACK_DEPORD_) $(archive).checked_$(md5)_$(size)
1560	%$$(call MSG_FETCH_UP,$(target),$(archive),$(inst))
1561	$$(QUIET)$$(RM) -f -- $(out)
1562	@# if the source archive doesn't exist fetch it (can have been deleted to save space).
1563	$$(QUIET)test -f $(archive) \
1564	\|\| ( $$(RM_EXT) -f $(archive).checked_$(md5)_$(size) \
1565	&& $$(MAKE) $(archive).checked_$(md5)_$(size) -f $(MAKEFILE) --no-print-directory )
1566	$($(target)_$(srcname)_UNPACK_CMDS_)
1567	$$(QUIET2)$$(APPEND) $(out) $(notdir $(archive).checked_$(md5)_$(size))
1568	$$(QUIET2)$$(APPEND) $(out) $(notdir $(out))
1569
1570	$(eval _TARGET_$(target)_UNPACKED += $(out))
1571	_TARGET_$(target)_DIGEST := $(_TARGET_$(target)_DIGEST)-$(srcname)_$(md5)_$(size)
1572
1573	.NOTPARALLEL: $(out)
1574
1575	endef
1576
1577	## Processes a fetch source
1578	#
1579	define def_fetch_src
1580	#$ (warning dbg: def_fetch_src: source='$(source)' target='$(target)')
1581
1582	# common
1583	local srcname := $(notdir $(source))
1584	local inst := $(firstword \
1585	$($(target)_$(source)_INST)\
1586	$($(target)_$(srcname)_INST)\
1587	$($(source)_INST)\
1588	$($(srcname)_INST)\
1589	$($(target)_INST)\
1590	)
1591	ifneq ($(patsubst %/,ok,$(inst)),ok)
1592	$(error kBuild: Bad or missing INST property for source '$(source)' in target '$(target)': $(inst))
1593	endif
1594	INSTARGET_$(target)_$(srcname) := $(inst)
1595	local fetchdir := $(firstword \
1596	$($(target)_$(source)_FETCHDIR)\
1597	$($(target)_$(srcname)_FETCHDIR)\
1598	$($(source)_FETCHDIR)\
1599	$($(srcname)_FETCHDIR)\
1600	$($(target)_FETCHDIR)\
1601	$(FETCHDIR)\
1602	$(PATH_TARGET)\
1603	)
1604	local deps := \
1605	$($(target)_$(source)_DEPS)\
1606	$($(target)_$(srcname)_DEPS)\
1607	$($(source)_DEPS)\
1608	$($(srcname)_DEPS)\
1609	$($(target)_DEPS)
1610	local orderdeps := \
1611	$($(target)_$(source)_ORDERDEPS)\
1612	$($(target)_$(srcname)_ORDERDEPS)\
1613	$($(source)_ORDERDEPS)\
1614	$($(srcname)_ORDERDEPS)\
1615	$($(target)_ORDERDEPS)
1616	local md5 := $(firstword \
1617	$($(target)_$(source)_MD5)\
1618	$($(target)_$(srcname)_MD5)\
1619	$($(source)_MD5)\
1620	$($(srcname)_MD5)\
1621	$($(target)_MD5)\
1622	)
1623	local size := $(firstword \
1624	$($(target)_$(source)_SIZE)\
1625	$($(target)_$(srcname)_SIZE)\
1626	$($(source)_SIZE)\
1627	$($(srcname)_SIZE)\
1628	$($(target)_SIZE)\
1629	)
1630	clean_files += \
1631	$($(target)_$(source)_CLEAN)\
1632	$($(target)_$(srcname)_CLEAN)\
1633	$($(source)_CLEAN)\
1634	$($(srcname)_CLEAN)
1635	local dep := # not legal for fetch and unpack tools
1636
1637
1638	#
1639	# The fetching.
1640	#
1641	local out := $(fetchdir)/$(srcname)
1642	local archive := $(out)
1643	TARGET_$(target)_$(srcname) := $(out)
1644	local dirdep := $(call DIRDEP,$(fetchdir))
1645	local tool := $(firstword \
1646	$($(target)_$(source)_FETCHTOOL)\
1647	$($(target)_$(srcname)_FETCHTOOL)\
1648	$($(target)_$(source)_TOOL)\
1649	$($(target)_$(srcname)_TOOL)\
1650	$($(source)_FETCHTOOL)\
1651	$($(srcname)_FETCHTOOL)\
1652	$($(source)_TOOL)\
1653	$($(srcname)_TOOL)\
1654	$($(target)_FETCHTOOL)\
1655	$($(target)_TOOL)\
1656	)
1657	local flags :=\
1658	$(TOOL_$(tool)_FETCHFLAGS)\
1659	$(FETCHFLAGS)\
1660	$($(target)_FETCHFLAGS)\
1661	$($(srcname)_FETCHFLAGS)\
1662	$($(source)_FETCHFLAGS)\
1663	$($(target)_$(srcname)_FETCHFLAGS)\
1664	$($(target)_$(source)_FETCHFLAGS)
1665
1666	#$ (warning dbg: target=$(target) source=$(source) $(srcname)=$(srcname) tool=$(tool) out=$(out) flags=$(flags) dirdep=$(dirdep) fetchdir=$(fetchdir) md5=$(md5) size=$(size))
1667
1668	ifndef TOOL_$(tool)_FETCH_CMDS
1669	$(warning kBuild: tools: \
1670	1 $($(target)_$(source)_FETCHTOOL)\
1671	2 $($(target)_$(srcname)_FETCHTOOL)\
1672	3 $($(target)_$(source)_TOOL)\
1673	4 $($(target)_$(srcname)_TOOL)\
1674	5 $($(source)_FETCHTOOL)\
1675	6 $($(srcname)_FETCHTOOL)\
1676	7 $($(source)_TOOL)\
1677	8 $($(srcname)_TOOL)\
1678	9 $($(target)_FETCHTOOL)\
1679	10 $($(target)_TOOL) )
1680	$(error kBuild: TOOL_$(tool)_FETCH_CMDS is not defined. source=$(source) target=$(target) )
1681	endif
1682
1683	# call the tool
1684	$(target)_$(srcname)_FETCH_CMDS_ := $(TOOL_$(tool)_FETCH_CMDS)
1685	$(target)_$(srcname)_FETCH_OUTPUT_ := $(TOOL_$(tool)_FETCH_OUTPUT)
1686	$(target)_$(srcname)_FETCH_OUTPUT_MAYBE_ := $(TOOL_$(tool)_FETCH_OUTPUT_MAYBE)
1687	$(target)_$(srcname)_FETCH_DEPEND_ := $(TOOL_$(tool)_FETCH_DEPEND) $(deps)
1688	$(target)_$(srcname)_FETCH_DEPORD_ := $(TOOL_$(tool)_FETCH_DEPORD) $(dirdep) $(orderdeps)
1689
1690	# generate the fetch rule.
1691	$(eval $(def_fetch_src_fetch_rule))
1692
1693
1694	#
1695	# The unpacking / installing.
1696	#
1697	local out := $(inst)_kBuild_$(target)_$(srcname)_unpacked.lst
1698	local dirdep := $(call DIRDEP,$(inst))
1699	local tool := $(firstword \
1700	$($(target)_$(source)_UNPACKTOOL)\
1701	$($(target)_$(srcname)_UNPACKTOOL)\
1702	$($(target)_$(source)_TOOL)\
1703	$($(target)_$(srcname)_TOOL)\
1704	$($(source)_UNPACKTOOL)\
1705	$($(srcname)_UNPACKTOOL)\
1706	$($(source)_TOOL)\
1707	$($(srcname)_TOOL)\
1708	$($(target)_UNPACKTOOL)\
1709	$($(target)_TOOL) \
1710	)
1711	ifeq ($(tool),)
1712	local tool := $(toupper $(subst .,,$(suffix $(subst tar.,TAR,$(srcname)))))
1713	$(evalval def_tools_include)
1714	endif
1715	local flags :=\
1716	$(TOOL_$(tool)_UNPACKFLAGS)\
1717	$(UNPACKFLAGS)\
1718	$($(target)_UNPACKFLAGS)\
1719	$($(srcname)_UNPACKFLAGS)\
1720	$($(source)_UNPACKFLAGS)\
1721	$($(target)_$(srcname)_UNPACKFLAGS)\
1722	$($(target)_$(source)_UNPACKFLAGS)
1723
1724	#$ (warning dbg: target=$(target) source=$(source) $(srcname)=$(srcname) tool=$(tool) out=$(out) flags=$(flags) dirdep=$(dirdep) inst=$(inst) md5=$(md5) size=$(size))
1725	ifndef TOOL_$(tool)_UNPACK_CMDS
1726	$(warning kBuild: tools: \
1727	1 $($(target)_$(source)_UNPACKTOOL)\
1728	2 $($(target)_$(srcname)_UNPACKTOOL)\
1729	3 $($(target)_$(source)_TOOL)\
1730	4 $($(target)_$(srcname)_TOOL)\
1731	5 $($(source)_UNPACKTOOL)\
1732	6 $($(srcname)_UNPACKTOOL)\
1733	7 $($(source)_TOOL)\
1734	8 $($(srcname)_TOOL)\
1735	9 $($(target)_UNPACKTOOL)\
1736	10 $($(target)_TOOL) \
1737	11 $(toupper $(subst tar.,TAR,$(ext $(srcname)))) \
1738	)
1739	$(error kBuild: TOOL_$(tool)_UNPACK_CMDS is not defined. source=$(source) target=$(target) )
1740	endif
1741
1742	# call the tool
1743	$(target)_$(srcname)_UNPACK_CMDS_ := $(TOOL_$(tool)_UNPACK_CMDS)
1744	$(target)_$(srcname)_UNPACK_OUTPUT_ := $(TOOL_$(tool)_UNPACK_OUTPUT)
1745	$(target)_$(srcname)_UNPACK_OUTPUT_MAYBE_ := $(TOOL_$(tool)_UNPACK_OUTPUT_MAYBE)
1746	$(target)_$(srcname)_UNPACK_DEPEND_ := $(TOOL_$(tool)_UNPACK_DEPEND) $(deps)
1747	$(target)_$(srcname)_UNPACK_DEPORD_ := $(TOOL_$(tool)_UNPACK_DEPORD) $(dirdep) $(orderdeps)
1748
1749	# generate the fetch rule.
1750	$(eval $(def_fetch_src_unpack_rule))
1751
1752	_DIRS += $(inst) $(fetchdir)
1753
1754	endef
1755
1756
1757	##
1758	# Define the target level rules for a fetch.
1759	# @param target
1760	# @param out
1761	# @param inst
1762	# @param _TARGET_$(target)_UNPACKED
1763	# @param _TARGET_$(target)_DIGEST
1764	# @param bld_trg
1765	# @param bld_trg_arch
1766	define def_fetch_rules
1767
1768	$(out).lst: $(_TARGET_$(target)_UNPACKED) \| $(call DIRDEP,$(inst))
1769	%$$(call MSG_FETCH_OK,$(target))
1770	$$(QUIET)$$(RM) -f -- $$@ $$@.tmp
1771	$$(QUIET2)$$(APPEND) $$@.tmp '$(notdir $(out))'
1772	$$(QUIET)$(if $(_TARGET_$(target)_UNPACKED),$$(CAT_EXT) $(_TARGET_$(target)_UNPACKED) >> $$@.tmp)
1773	$$(QUIET)$$(MV) -f -- $$@.tmp $$@
1774
1775	$(out)_unfetched:
1776	%$$(call MSG_UNFETCH,$(target))
1777	$$(QUIET)$$(RM) -f -- $$(addprefix $(inst),$$(shell $$(CAT_EXT) $(out).lst 2> /dev/null \| $$(SED) -e '/\/$$$$/d'))
1778	$$(QUIET)$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist -- $$(dir $$@) \
1779	$$(addprefix $(inst),$$(sort $$(dir $$(shell $$(CAT_EXT) $(out).lst 2> /dev/null))))
1780	$$(QUIET)$$(RM) -f -- $(out).lst $(out)
1781	$$(QUIET)$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist -- $$(dir $$@)
1782
1783	$(out): $(comp-vars _TARGET_$(target)_DIGEST_PREV,_TARGET_$(target)_DIGEST,FORCE) \| $(call DIRDEP,$(inst))
1784	$$(QUIET)$$(RM) -f -- $$@
1785	%$$(if $$(_TARGET_$(target)_DIGEST),$$(if $$(wildcard $(out).lst)\
1786	,$$(call MSG_REFETCH,$(target)),$$(call MSG_FETCH,$(target))),$$(call MSG_UNFETCH,$(target)))
1787	$$(QUIET)$$(if $$(wildcard $(out).lst ),$$(MAKE) -f $(MAKEFILE) --no-print-directory $(out)_unfetched)
1788	$$(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 $$@))
1789	$$(QUIET2)$$(if $$(_TARGET_$(target)_DIGEST),$$(APPEND) $$@ "_TARGET_$(target)_DIGEST_PREV := $(_TARGET_$(target)_DIGEST)")
1790
1791	.NOTPARALLEL: $(out).lst $(out)_unfetched $(out)
1792
1793	endef
1794
1795
1796	##
1797	# Deal with one fetch target.
1798	# @param target
1799	# @param bld_trg
1800	# @param bld_trg_arch
1801	define def_fetch
1802	# common
1803	INSTARGET_$(target) := $($(target)_INST)
1804	ifneq ($(patsubst %/,ok,$(INSTARGET_$(target))),ok)
1805	$(error kBuild: Bad or missing INST property for target '$(target)'. \
1806	$(target)_INST='$($(target)_INST)' ($(origin $(target)_INST)))
1807	endif
1808	_TARGET_$(target)_FETCHED :=
1809	_TARGET_$(target)_UNPACKED :=
1810	_TARGET_$(target)_DIGEST :=
1811	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))
1812
1813	# The 'sources'.
1814	#$ (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)))
1815	$(foreach source,$($(target)_SOURCES) $($(target)_SOURCES.$(KBUILD_TYPE)) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)),\
1816	$(evalval def_fetch_src))
1817
1818	# The target.
1819	local inst := $(INSTARGET_$(target))
1820	local out := $(inst)_kBuild_fetch_$(target)
1821
1822	$(eval includedep $(out))
1823
1824	$(eval $(def_fetch_rules))
1825
1826	# Define the aliases here (doesn't work if defined in def_fetch_rules, just like includedep).
1827	$(target): $(out)
1828	$(target)_unfetch: $(out)_unfetched
1829
1830	_FETCHES += $(out)
1831	_DOWNLOADS += $(_TARGET_$(target)_FETCHED)
1832	_UNPACKS += $(_TARGET_$(target)_UNPACKED)
1833	_UNFETCHES += $(out)_unfetched
1834	_DIRS += $(inst)
1835	_CLEAN_FILES += $(clean_files)
1836
1837	endef
1838
1839	# Walk the FETCH target lists.
1840	bld_trg := $(KBUILD_TARGET)
1841	bld_trg_arch := $(KBUILD_TARGET_ARCH)
1842	$(foreach target, $(FETCHES) $(FETCHES.$(KBUILD_TARGET)) $(FETCHES.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1843	$(evalvalctx def_fetch))
1844
1845	# some aliases.
1846	download: $(_DOWNLOADS)
1847	unpack: $(_UNPACKS)
1848	fetch: $(_FETCHES)
1849	unfetch: $(_UNFETCHES)
1850
1851	ifdef KBUILD_PROFILE_SELF
1852	_KBUILD_TS_NOW := $(nanots )
1853	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done fetching targets)
1854	$(info stat: $(make-stats ))
1855	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
1856	endif
1857
1858
1859
1860	##
1861	## Patching.
1862	##
1863	##
1864	#define def_patch_src
1865	#
1866	#endef
1867	#
1868	#
1869	## Deal with one patch target.
1870	#define def_patch
1871	#
1872	#$(foreach source,$($(target)_SOURCES) $($(target)_SOURCES.$(KBUILD_TYPE)) $($(target)_SOURCES.$(KBUILD_TARGET)) $($(target)_SOURCES.$(KBUILD_TARGET_ARCH)) $($(target)_SOURCES.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)),\
1873	# $(evalval def_patch_src))
1874	#
1875	#_PATCHES +=
1876	#endef
1877	#
1878	#$(foreach target, $(PATCHES) $(PATCHES.$(KBUILD_TARGET)) $(PATCHES.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
1879	# $(evalval def_patch))
1880	#
1881
1882
1883	#
1884	# Object processing.
1885	#
1886
1887	## wrapper the compile command dependency check.
1888	ifndef NO_COMPILE_CMDS_DEPS
1889	_DEP_COMPILE_CMDS = $$(comp-cmds-ex $$($(target)_$(subst :,_,$(source))_CMDS_PREV_),$$(commands $(obj)),FORCE)
1890	else
1891	_DEP_COMPILE_CMDS =
1892	endif
1893
1894	## Generates the rules for building a specific object, and the aliases
1895	# for building a source file.
1896	# @param $(obj) The object file.
1897	define def_target_source_rule
1898	ifdef TOOL_$(tool)_COMPILE_$(type)_USES_KOBJCACHE
1899	$(outbase).koc +\| $(obj) $($(target)_$(source)_OUTPUT_) $($(target)_$(source)_OUTPUT_MAYBE_) : \
1900	$($(target)_$(source)_DEPEND_) \
1901	$(value _DEP_COMPILE_CMDS) \
1902	\| \
1903	$($(target)_$(source)_DEPORD_) \
1904	$$($(target)_INTERMEDIATES)
1905	%$$(call MSG_COMPILE,$(target),$(source),$$@,$(type))
1906	else
1907	$(obj) + $($(target)_$(source)_OUTPUT_) +\| $($(target)_$(source)_OUTPUT_MAYBE_) : \
1908	$($(target)_$(source)_DEPEND_) \
1909	$(value _DEP_COMPILE_CMDS) \
1910	\| \
1911	$($(target)_$(source)_DEPORD_) \
1912	$$($(target)_INTERMEDIATES)
1913	%$$(call MSG_COMPILE,$(target),$(source),$$@,$(type))
1914	ifdef TOOL_$(tool)_COMPILE_$(type)_DONT_PURGE_OUTPUT
1915	$$(QUIET)$$(RM) -f -- $(dep) $(obj) $($(target)_$(source)_OUTPUT_) $($(target)_OUTPUT_MAYBE_)
1916	endif
1917	endif
1918
1919	$($(target)_$(source)_CMDS_)
1920
1921	ifndef NO_COMPILE_CMDS_DEPS
1922	%$$(QUIET2)$$(APPEND) '$(dep)'
1923	%$$(QUIET2)$$(APPEND) '$(dep)' 'define $(target)_$(subst :,_,$(source))_CMDS_PREV_'
1924	%$$(QUIET2)$$(APPEND) -c '$(dep)' '$(obj)'
1925	%$$(QUIET2)$$(APPEND) '$(dep)' 'endef'
1926	endif
1927
1928	$(basename $(notdir $(obj))).o: $(obj)
1929	$(basename $(notdir $(obj))).obj: $(obj)
1930
1931	## @todo make this 'local cmds' in 0.2.x or when a new kb-src-one is added.
1932	$(target)_$(source)_CMDS_ :=
1933	endef
1934
1935
1936	## wrapper the link command dependency check.
1937	ifndef NO_LINK_CMDS_DEPS
1938	_DEP_LINK_CMDS = $$(comp-cmds-ex $$($(target)_CMDS_PREV_),$$(commands $(out)),FORCE)
1939	else
1940	_DEP_LINK_CMDS =
1941	endif
1942
1943	## Generate the link rule for a target.
1944	# @param $(target) The normalized target name.
1945	# @param $(dirdep) Directories we depend upon begin created before linking.
1946	# @param $(dep) The name of the dependency file.
1947	# @param $(out)
1948	# @param $($(target)_OUTPUT_) Output files from the link.
1949	# @param $($(target)_OUTPUT_MAYBE_) Output files that the link may perhaps create.
1950	# @param $($(target)_DEPEND_) Dependencies.
1951	# @param $($(target)_DEPORD_) Dependencies which should only affect build order.
1952	# @param $(cmds) The link commands.
1953	# @param $($(target)_CMDS_PREV_) The link commands from the previous run.
1954	define def_link_rule
1955	$(out) + $($(target)_OUTPUT_) +\| $($(target)_OUTPUT_MAYBE_) : \
1956	$($(target)_DEPEND_) \
1957	$(value _DEP_LINK_CMDS) \
1958	\| \
1959	$($(target)_DEPORD_)
1960	%$$(call MSG_LINK,$(target),$$@,$(tool_do))
1961	$$(QUIET)$$(RM) -f -- $(dep) $(out) $($(target)_OUTPUT_) $($(target)_OUTPUT_MAYBE_)
1962
1963	$(cmds)
1964
1965	ifndef NO_LINK_CMDS_DEPS
1966	%$$(QUIET2)$$(APPEND) '$(dep)' 'define $(target)_CMDS_PREV_'
1967	%$$(QUIET2)$$(APPEND) -c '$(dep)' '$(out)'
1968	%$$(QUIET2)$$(APPEND) '$(dep)' 'endef'
1969	endif
1970
1971	$(basename $(notdir $(out))): $(out)
1972
1973	endef
1974
1975
1976	## Generate the link & lib install rule
1977	# @param $(target) Normalized target name.
1978	# @param $(out) The build target.
1979	# @param $(INSTARGET_$(target)) The installation targets.
1980	# @param $(mode) The file mode (optional)
1981	define def_link_install_rule
1982	$(INSTARGET_$(target)) : $(out) \| $(call DIRDEP,$(dir $(INSTARGET_$(target))))
1983	%$$(call MSG_INST_TRG,$(target),$(out),$$@)
1984	$$(QUIET)$$(INSTALL) $$(if $(mode),-m $(mode)) -- $(out) $$@
1985
1986	ifdef KBUILD_DO_AUTO_INSTALL
1987	$(basename $(notdir $(out))): $(INSTARGET_$(target))
1988	endif
1989	endef
1990
1991
1992	## def_src_handler_*
1993	#
1994	# @{
1995	define def_src_handler_c
1996	local type := C
1997	$(kb-src-one )
1998	endef
1999
2000	define def_src_handler_cxx
2001	local type := CXX
2002	$(kb-src-one )
2003	endef
2004
2005	define def_src_handler_objc
2006	local type := OBJC
2007	$(kb-src-one )
2008	endef
2009
2010	define def_src_handler_asm
2011	local type := AS
2012	$(kb-src-one )
2013	endef
2014
2015	define def_src_handler_rc
2016	local type := RC
2017	$(kb-src-one )
2018	endef
2019
2020	define def_src_handler_obj
2021	ifeq ($(defpath),)
2022	$(target)_OBJS_ += $(source)
2023	else
2024	$(target)_OBJS_ += $(abspathex $(source), $(defpath))
2025	endif
2026	endef
2027	## @}
2028
2029	## Handle one source.
2030	# .
2031	define def_src_handler_one
2032	local suff := $(suffix $(source))
2033	local src_handler := $(firstword $(filter $(suff):%, $($(target)_$(source)_SRC_HANDLERS) $($(source)_SRC_HANDLERS) $(target_src_handlers) ))
2034	local handler := $(patsubst $(suff):%,%,$(src_handler))
2035	ifneq ($(handler),)
2036	$(evalval $(handler))
2037	else
2038	othersrc += $(source)
2039	endif
2040	endef
2041
2042	## Generic macro for processing all target sources.
2043	# @param $(target) Normalized target name.
2044	# @param $(defpath)
2045	# @param much-more...
2046	# @returns othersrc, $(target)_OBJS_, ++
2047	define def_target_sources
2048	local target_src_handlers := $($(target)_SRC_HANDLERS) $(KBUILD_SRC_HANDLERS)
2049	$(foreach source,\
2050	$($(target)_SOURCES)\
2051	$($(target)_SOURCES.$(bld_trg))\
2052	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch))\
2053	$($(target)_SOURCES.$(bld_trg_arch))\
2054	$($(target)_SOURCES.$(bld_trg_cpu))\
2055	$($(target)_SOURCES.$(bld_type))\
2056	,$(evalval def_src_handler_one) )
2057
2058	$(foreach source,\
2059	$($(target)_GEN_SOURCES_)\
2060	$($(target)_GEN_SOURCES_.$(bld_trg))\
2061	$($(target)_GEN_SOURCES_.$(bld_trg).$(bld_trg_arch))\
2062	$($(target)_GEN_SOURCES_.$(bld_trg_arch))\
2063	$($(target)_GEN_SOURCES_.$(bld_trg_cpu))\
2064	$($(target)_GEN_SOURCES_.$(bld_type))\
2065	,$(evalval def_src_handler_one) )
2066	endef
2067
2068
2069
2070	## Generic macro for generating the install rule(s) for a target
2071	# and update the globals with default out.
2072	#
2073	# @param $(target) Normalized target name.
2074	# @param $(out) The output file.
2075	# @param $(definst) The default _INST value.
2076	# @param $(typevar) The name of the variable with all the root targets of its type.
2077	# @remark Only library uses this now.
2078	define def_target_install_pluss
2079	ifndef $(target)_NOINST
2080	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
2081	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
2082
2083	$(eval $(def_link_install_rule))
2084
2085	_INSTALLS_FILES += $(INSTARGET_$(target))
2086
2087	ifdef KBUILD_DO_AUTO_INSTALL
2088	$(typevar) += $(INSTARGET_$(target))
2089	else
2090	$(typevar) += $(out)
2091	endif
2092	else # _NOINST
2093	$(typevar) += $(out)
2094	endif
2095
2096	_OUT_FILES += $($(target)_OUTPUT_) $($(target)_OUTPUT_MAYBE_) $(out)
2097	_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))
2098	_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))
2099	_OBJS += $($(target)_OBJS_)
2100
2101	endef
2102
2103
2104
2105	#
2106	# LIBRARIES
2107	#
2108
2109	## Library (one).
2110	# @param $(target) Normalized library (target) name.
2111	define def_lib
2112	# library basics
2113	## @todo prefix
2114	local bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
2115	local bld_trg := $(firstword $($(target)_BLD_TRG) $(KBUILD_TARGET))
2116	local bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(KBUILD_TARGET_ARCH))
2117	local bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(KBUILD_TARGET_CPU))
2118	local tool := $(call _TARGET_TOOL,$(target),AR)
2119	ifeq ($(tool),)
2120	$(error kBuild: Library target $(target) does not have a tool defined!)
2121	endif
2122	local name := $(firstword\
2123	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
2124	$($(target)_NAME.$(bld_trg_arch))\
2125	$($(target)_NAME.$(bld_trg))\
2126	$($(target)_NAME.$(bld_type))\
2127	$($(target)_NAME)\
2128	$(target))
2129	local outbase := $(call TARGET_BASE,$(name),$(target))
2130	ifndef PATH_$(target)
2131	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
2132	else
2133	ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
2134	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
2135	endif
2136	endif
2137	local suff := $(firstword\
2138	$($(target)_LIBSUFF.$(bld_trg).$(bld_trg_arch))\
2139	$($(target)_LIBSUFF.$(bld_trg))\
2140	$($(target)_LIBSUFF)\
2141	$(TOOL_$(tool)_ARLIBSUFF.$(bld_trg).$(bld_trg_arch))\
2142	$(TOOL_$(tool)_ARLIBSUFF.$(bld_trg))\
2143	$(TOOL_$(tool)_ARLIBSUFF)\
2144	$(SUFF_LIB))
2145	local out := $(outbase)$(suff)
2146	local defpath := $($(target)_PATH)
2147	TARGET_$(target) := $(out)
2148	# no local here - must be writable across some foreachs.
2149	othersrc :=
2150	$(target)_OBJS_ :=
2151
2152	# source -> object
2153	$(evalval def_target_sources)
2154
2155	# library linking
2156	local tool := $(call _TARGET_TOOL,$(target),AR)
2157	local name := $(firstword\
2158	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
2159	$($(target)_NAME.$(bld_trg_arch))\
2160	$($(target)_NAME.$(bld_trg))\
2161	$($(target)_NAME.$(bld_type))\
2162	$($(target)_NAME)\
2163	$(target))
2164	local outbase := $(call TARGET_BASE,$(name),$(target))
2165	local flags :=\
2166	$(TOOL_$(tool)_ARFLAGS)\
2167	$(TOOL_$(tool)_ARFLAGS.$(bld_type))\
2168	$(ARFLAGS)\
2169	$(ARFLAGS.$(bld_type))\
2170	$($(target)_ARFLAGS)\
2171	$($(target)_ARFLAGS.$(bld_type)) \
2172	$($(target)_ARFLAGS.$(bld_trg)) \
2173	$($(target)_ARFLAGS.$(bld_trg_arch)) \
2174	$($(target)_ARFLAGS.$(bld_trg).$(bld_trg_arch)) \
2175	$($(target)_ARFLAGS.$(bld_trg_cpu))
2176	local dirdep := $(call DIRDEP,$(dir $(out)))
2177	local deps := $($(target)_DEPS)
2178	local orderdeps := $($(target)_ORDERDEPS)
2179
2180	# Adjust paths if we got a default path.
2181	ifneq ($(defpath),)
2182	$(target)_OBJS_ := $(abspathex $($(target)_OBJS_),$(defpath))
2183	local deps := $(abspathex $(deps),$(defpath))
2184	local orderdeps := $(abspathex $(orderdeps),$(defpath))
2185	othersrc := $(abspathex $(othersrc),$(defpath))
2186	endif
2187
2188
2189	# Custom pre-link actions.
2190	ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2191	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2192	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch)
2193	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch))
2194	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_type)
2195	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_type))
2196	else ifdef $(target)_PRE_CMDS.$(bld_trg_arch)
2197	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg_arch))
2198	else ifdef $(target)_PRE_CMDS.$(bld_trg)
2199	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg))
2200	else ifdef $(target)_PRE_CMDS.$(bld_type)
2201	local pre_cmds := $($(target)_PRE_CMDS.$(bld_type))
2202	else ifdef $(target)_PRE_CMDS
2203	local pre_cmds := $($(target)_PRE_CMDS)
2204	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2205	local pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2206	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch)
2207	local pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch))
2208	else ifdef PRE_CMDS.$(bld_trg).$(bld_type)
2209	local pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_type))
2210	else ifdef PRE_CMDS.$(bld_trg_arch)
2211	local pre_cmds := $(PRE_CMDS.$(bld_trg_arch))
2212	else ifdef PRE_CMDS.$(bld_trg)
2213	local pre_cmds := $(PRE_CMDS.$(bld_trg))
2214	else ifdef PRE_CMDS.$(bld_type)
2215	local pre_cmds := $(PRE_CMDS.$(bld_type))
2216	else
2217	local pre_cmds := $(PRE_CMDS)
2218	endif
2219
2220	# Custom post-link actions.
2221	ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2222	local post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2223	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch)
2224	local post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch))
2225	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_type)
2226	local post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_type))
2227	else ifdef $(target)_POST_CMDS.$(bld_trg_arch)
2228	local post_cmds := $($(target)_POST_CMDS.$(bld_trg_arch))
2229	else ifdef $(target)_POST_CMDS.$(bld_trg)
2230	local post_cmds := $($(target)_POST_CMDS.$(bld_trg))
2231	else ifdef $(target)_POST_CMDS.$(bld_type)
2232	local post_cmds := $($(target)_POST_CMDS.$(bld_type))
2233	else ifdef $(target)_POST_CMDS
2234	local post_cmds := $($(target)_POST_CMDS)
2235	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2236	local post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2237	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch)
2238	local post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch))
2239	else ifdef POST_CMDS.$(bld_trg).$(bld_type)
2240	local post_cmds := $(POST_CMDS.$(bld_trg).$(bld_type))
2241	else ifdef POST_CMDS.$(bld_trg_arch)
2242	local post_cmds := $(POST_CMDS.$(bld_trg_arch))
2243	else ifdef POST_CMDS.$(bld_trg)
2244	local post_cmds := $(POST_CMDS.$(bld_trg))
2245	else ifdef POST_CMDS.$(bld_type)
2246	local post_cmds := $(POST_CMDS.$(bld_type))
2247	else
2248	local post_cmds := $(POST_CMDS)
2249	endif
2250
2251	# eliminate this guy?
2252	local objs = $($(target)_OBJS_)
2253
2254	# dependency file
2255	local dep := $(out)$(SUFF_DEP)
2256	ifndef NO_LINK_CMDS_DEPS
2257	_DEPFILES_INCLUDED += $(dep)
2258	$(eval includedep $(dep))
2259	endif
2260
2261	# check that the tool is defined.
2262	ifndef TOOL_$(tool)_LINK_LIBRARY_CMDS
2263	$(warning kBuild: tools: \
2264	1 $($(target)_$(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
2265	2 $($(target)_$(source)TOOL.$(bld_trg)) \
2266	3 $($(target)_$(source)TOOL) \
2267	4 $($(target)_TOOL.$(bld_trg).$(bld_trg_arch)) \
2268	5 $($(target)_TOOL.$(bld_trg)) \
2269	6 $($(target)_TOOL) \
2270	7 $($(source)TOOL) \
2271	8 $($(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
2272	9 $($(source)TOOL.$(bld_trg)) \
2273	10 $(TOOL.$(bld_trg).$(bld_trg_arch)) \
2274	11 $(TOOL.$(bld_trg)) \
2275	12 $(TOOL) )
2276	$(error kBuild: TOOL_$(tool)_LINK_LIBRARY_CMDS isn't defined! target=$(target) )
2277	endif
2278
2279	# call the tool
2280	local cmds := $(TOOL_$(tool)_LINK_LIBRARY_CMDS)
2281	ifneq ($(pre_cmds),)
2282	local cmds := $(TAB)$(pre_cmds)$(NL)$(TAB)$(cmds)
2283	endif
2284	ifneq ($(post_cmds),)
2285	local cmds := $(cmds)$(NL)$(TAB)$(post_cmds)
2286	endif
2287	$(target)_OUTPUT_ := $(TOOL_$(tool)_LINK_LIBRARY_OUTPUT)
2288	$(target)_OUTPUT_MAYBE_ := $(TOOL_$(tool)_LINK_LIBRARY_OUTPUT_MAYBE)
2289	$(target)_DEPEND_ := $(TOOL_$(tool)_LINK_LIBRARY_DEPEND) $(deps) $($(target)_OBJS_)
2290	$(target)_DEPORD_ := $(TOOL_$(tool)_LINK_LIBRARY_DEPORD) $(dirdep) $(orderdeps)
2291
2292	# generate the link rule.
2293	$(eval $(def_link_rule))
2294
2295	# installing and globals
2296	$(evalval def_target_install_pluss)
2297	endef
2298
2299	# Process libraries
2300	definst := $(PATH_LIB)
2301	typevar := _LIBS
2302	tool_do := LINK_LIBRARY
2303	mode := 0644
2304	$(foreach target, $(LIBRARIES) $(LIBRARIES.$(KBUILD_TARGET)) $(LIBRARIES.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), $(evalval def_lib))
2305
2306	ifdef KBUILD_PROFILE_SELF
2307	_KBUILD_TS_NOW := $(nanots )
2308	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done library targets)
2309	$(info stat: $(make-stats ))
2310	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2311	endif
2312
2313
2314	#
2315	# Link operations.
2316	#
2317
2318	##
2319	# Link prolog
2320	#
2321	# @param $(target) Normalized target name.
2322	# @param $(EXT) EXE,DLL,SYS.
2323	# @param $(definst) The default _INST value.
2324	# @param $(typevar) The name of the variable with all the root targets of its type.
2325	define def_link_common
2326	# basics
2327	local bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
2328	local bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_$(bld_trg_base_var)))
2329	local bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_$(bld_trg_base_var)_ARCH))
2330	local bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_$(bld_trg_base_var)_CPU))
2331
2332	local tool := $(call _TARGET_TOOL,$(target),LD)
2333	local name := $(firstword\
2334	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
2335	$($(target)_NAME.$(bld_trg_arch))\
2336	$($(target)_NAME.$(bld_trg))\
2337	$($(target)_NAME.$(bld_type))\
2338	$($(target)_NAME)\
2339	$(target))
2340	local outbase := $(call TARGET_BASE,$(name),$(target))
2341	ifndef PATH_$(target)
2342	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
2343	else
2344	ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
2345	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
2346	endif
2347	endif
2348	local suff := $(firstword \
2349	$($(target)_$(EXT)SUFF) \
2350	$($(target)_$(EXT)SUFF) \
2351	$(TOOL_$(tool)_LD$(EXT)SUFF) \
2352	$($(EXTPRE)SUFF_$(EXT)))
2353	local out := $(outbase)$(suff)
2354	TARGET_$(target) := $(out)
2355	local defpath := $($(target)_PATH)
2356	# no local here - must be writable across some foreachs.
2357	othersrc :=
2358	$(target)_OBJS_ :=
2359
2360	# source -> object
2361	$(evalval def_target_sources)
2362
2363	# more link stuff.
2364	local tool := $(call _TARGET_TOOL,$(target),LD)
2365	local name := $(firstword\
2366	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
2367	$($(target)_NAME.$(bld_trg_arch))\
2368	$($(target)_NAME.$(bld_trg))\
2369	$($(target)_NAME.$(bld_type))\
2370	$($(target)_NAME)\
2371	$(target))
2372	local outbase := $(call TARGET_BASE,$(name),$(target))
2373	local flags :=\
2374	$(TOOL_$(tool)_LDFLAGS)\
2375	$(TOOL_$(tool)_LDFLAGS.$(bld_type))\
2376	$(TOOL_$(tool)_LDFLAGS.$(bld_trg))\
2377	$(TOOL_$(tool)_LDFLAGS.$(bld_trg_arch))\
2378	$(TOOL_$(tool)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
2379	$(TOOL_$(tool)_LDFLAGS.$(bld_trg_cpu))\
2380	$(foreach sdk, $(SDKS) \
2381	$(SDKS.$(bld_type)) \
2382	$(SDKS.$(bld_trg)) \
2383	$(SDKS.$(bld_trg_arch)) \
2384	$(SDKS.$(bld_trg).$(bld_trg_arch)),\
2385	$(SDK_$(sdk)_LDFLAGS)\
2386	$(SDK_$(sdk)_LDFLAGS.$(bld_type))\
2387	$(SDK_$(sdk)_LDFLAGS.$(bld_trg))\
2388	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_arch))\
2389	$(SDK_$(sdk)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
2390	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_cpu)))\
2391	$(LDFLAGS)\
2392	$(LDFLAGS.$(bld_type))\
2393	$(LDFLAGS.$(bld_trg))\
2394	$(LDFLAGS.$(bld_trg_arch))\
2395	$(LDFLAGS.$(bld_trg).$(bld_trg_arch))\
2396	$(LDFLAGS.$(bld_trg_cpu))\
2397	$(foreach sdk, $($(target)_SDKS) \
2398	$($(target)_SDKS.$(bld_type)) \
2399	$($(target)_SDKS.$(bld_trg)) \
2400	$($(target)_SDKS.$(bld_trg_arch)) \
2401	$($(target)_SDKS.$(bld_trg).$(bld_trg_arch)),\
2402	$(SDK_$(sdk)_LDFLAGS)\
2403	$(SDK_$(sdk)_LDFLAGS.$(bld_type))\
2404	$(SDK_$(sdk)_LDFLAGS.$(bld_trg))\
2405	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_arch))\
2406	$(SDK_$(sdk)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
2407	$(SDK_$(sdk)_LDFLAGS.$(bld_trg_cpu)))\
2408	$($(target)_LDFLAGS)\
2409	$($(target)_LDFLAGS.$(bld_type))\
2410	$($(target)_LDFLAGS.$(bld_trg))\
2411	$($(target)_LDFLAGS.$(bld_trg_arch))\
2412	$($(target)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
2413	$($(target)_LDFLAGS.$(bld_trg_cpu))
2414	local libs :=\
2415	$($(target)_LIBS.$(bld_trg_cpu))\
2416	$($(target)_LIBS.$(bld_trg).$(bld_trg_arch))\
2417	$($(target)_LIBS.$(bld_trg_arch))\
2418	$($(target)_LIBS.$(bld_trg))\
2419	$($(target)_LIBS.$(bld_type))\
2420	$($(target)_LIBS)\
2421	$(foreach sdk, $($(target)_SDKS.$(bld_trg).$(bld_trg_arch)) \
2422	$($(target)_SDKS.$(bld_trg_arch)) \
2423	$($(target)_SDKS.$(bld_trg)) \
2424	$($(target)_SDKS.$(bld_type)) \
2425	$($(target)_SDKS),\
2426	$(SDK_$(sdk)_LIBS.$(bld_trg_cpu))\
2427	$(SDK_$(sdk)_LIBS.$(bld_trg).$(bld_trg_arch))\
2428	$(SDK_$(sdk)_LIBS.$(bld_trg_arch))\
2429	$(SDK_$(sdk)_LIBS.$(bld_trg))\
2430	$(SDK_$(sdk)_LIBS.$(bld_type))\
2431	$(SDK_$(sdk)_LIBS))\
2432	$(LIBS.$(bld_trg_cpu))\
2433	$(LIBS.$(bld_trg).$(bld_trg_arch))\
2434	$(LIBS.$(bld_trg_arch))\
2435	$(LIBS.$(bld_trg))\
2436	$(LIBS.$(bld_type))\
2437	$(LIBS)\
2438	$(foreach sdk, $(SDKS.$(bld_trg).$(bld_trg_arch)) \
2439	$(SDKS.$(bld_trg_arch)) \
2440	$(SDKS.$(bld_trg)) \
2441	$(SDKS.$(bld_type)) \
2442	$(SDKS),\
2443	$(SDK_$(sdk)_LIBS.$(bld_trg_cpu))\
2444	$(SDK_$(sdk)_LIBS.$(bld_trg).$(bld_trg_arch))\
2445	$(SDK_$(sdk)_LIBS.$(bld_trg_arch))\
2446	$(SDK_$(sdk)_LIBS.$(bld_trg))\
2447	$(SDK_$(sdk)_LIBS.$(bld_type))\
2448	$(SDK_$(sdk)_LIBS))\
2449	$(TOOL_$(tool)_LIBS.$(bld_trg_cpu))\
2450	$(TOOL_$(tool)_LIBS.$(bld_trg).$(bld_trg_arch))\
2451	$(TOOL_$(tool)_LIBS.$(bld_trg_arch))\
2452	$(TOOL_$(tool)_LIBS.$(bld_trg))\
2453	$(TOOL_$(tool)_LIBS.$(bld_type))\
2454	$(TOOL_$(tool)_LIBS)
2455	local libpath :=\
2456	$($(target)_LIBPATH.$(bld_trg_cpu))\
2457	$($(target)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
2458	$($(target)_LIBPATH.$(bld_trg_arch))\
2459	$($(target)_LIBPATH.$(bld_trg))\
2460	$($(target)_LIBPATH.$(bld_type))\
2461	$($(target)_LIBPATH)\
2462	$(foreach sdk, $($(target)_SDKS.$(bld_trg).$(bld_trg_arch)) \
2463	$($(target)_SDKS.$(bld_trg_arch)) \
2464	$($(target)_SDKS.$(bld_trg)) \
2465	$($(target)_SDKS.$(bld_type)) \
2466	$($(target)_SDKS),\
2467	$(SDK_$(sdk)_LIBPATH.$(bld_trg_cpu))\
2468	$(SDK_$(sdk)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
2469	$(SDK_$(sdk)_LIBPATH.$(bld_trg_arch))\
2470	$(SDK_$(sdk)_LIBPATH.$(bld_trg))\
2471	$(SDK_$(sdk)_LIBPATH.$(bld_type))\
2472	$(SDK_$(sdk)_LIBPATH))\
2473	$(LIBPATH.$(bld_trg_cpu))\
2474	$(LIBPATH.$(bld_trg).$(bld_trg_arch))\
2475	$(LIBPATH.$(bld_trg_arch))\
2476	$(LIBPATH.$(bld_trg))\
2477	$(LIBPATH.$(bld_type))\
2478	$(LIBPATH)\
2479	$(foreach sdk, $(SDKS.$(bld_trg).$(bld_trg_arch)) \
2480	$(SDKS.$(bld_trg_arch)) \
2481	$(SDKS.$(bld_trg)) \
2482	$(SDKS.$(bld_type)) \
2483	$(SDKS),\
2484	$(SDK_$(sdk)_LIBPATH.$(bld_trg_cpu))\
2485	$(SDK_$(sdk)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
2486	$(SDK_$(sdk)_LIBPATH.$(bld_trg_arch))\
2487	$(SDK_$(sdk)_LIBPATH.$(bld_trg))\
2488	$(SDK_$(sdk)_LIBPATH.$(bld_type))\
2489	$(SDK_$(sdk)_LIBPATH))\
2490	$(TOOL_$(tool)_LIBPATH.$(bld_trg_cpu))\
2491	$(TOOL_$(tool)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
2492	$(TOOL_$(tool)_LIBPATH.$(bld_trg_arch))\
2493	$(TOOL_$(tool)_LIBPATH.$(bld_trg))\
2494	$(TOOL_$(tool)_LIBPATH.$(bld_type))\
2495	$(TOOL_$(tool)_LIBPATH)
2496	local dirdep := $(call DIRDEP,$(dir $(out)))
2497	local deps := $($(target)_DEPS)
2498	local orderdeps := $($(target)_ORDERDEPS)
2499
2500	# Adjust paths if we got a default path.
2501	ifneq ($(defpath),)
2502	local libpath := $(abspathex $(libpath),$(defpath))
2503	$(target)_OBJS_ := $(abspathex $($(target)_OBJS_),$(defpath))
2504	local deps := $(abspathex $(deps),$(defpath))
2505	local orderdeps := $(abspathex $(orderdeps),$(defpath))
2506	othersrc := $(abspathex $(othersrc),$(defpath))
2507	# libs are not subject to this because of the the -l<lib> stuff. Use $(<target>_PATH)/lib if relative to current dir!
2508	endif
2509
2510	# Custom pre-link actions.
2511	ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2512	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2513	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch)
2514	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch))
2515	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_type)
2516	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_type))
2517	else ifdef $(target)_PRE_CMDS.$(bld_trg_arch)
2518	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg_arch))
2519	else ifdef $(target)_PRE_CMDS.$(bld_trg)
2520	local pre_cmds := $($(target)_PRE_CMDS.$(bld_trg))
2521	else ifdef $(target)_PRE_CMDS.$(bld_type)
2522	local pre_cmds := $($(target)_PRE_CMDS.$(bld_type))
2523	else ifdef $(target)_PRE_CMDS
2524	local pre_cmds := $($(target)_PRE_CMDS)
2525	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2526	local pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2527	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch)
2528	local pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch))
2529	else ifdef PRE_CMDS.$(bld_trg).$(bld_type)
2530	local pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_type))
2531	else ifdef PRE_CMDS.$(bld_trg_arch)
2532	local pre_cmds := $(PRE_CMDS.$(bld_trg_arch))
2533	else ifdef PRE_CMDS.$(bld_trg)
2534	local pre_cmds := $(PRE_CMDS.$(bld_trg))
2535	else ifdef PRE_CMDS.$(bld_type)
2536	local pre_cmds := $(PRE_CMDS.$(bld_type))
2537	else
2538	local pre_cmds := $(PRE_CMDS)
2539	endif
2540
2541	# Custom post-link actions.
2542	ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2543	local post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2544	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch)
2545	local post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch))
2546	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_type)
2547	local post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_type))
2548	else ifdef $(target)_POST_CMDS.$(bld_trg_arch)
2549	local post_cmds := $($(target)_POST_CMDS.$(bld_trg_arch))
2550	else ifdef $(target)_POST_CMDS.$(bld_trg)
2551	local post_cmds := $($(target)_POST_CMDS.$(bld_trg))
2552	else ifdef $(target)_POST_CMDS.$(bld_type)
2553	local post_cmds := $($(target)_POST_CMDS.$(bld_type))
2554	else ifdef $(target)_POST_CMDS
2555	local post_cmds := $($(target)_POST_CMDS)
2556	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
2557	local post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
2558	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch)
2559	local post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch))
2560	else ifdef POST_CMDS.$(bld_trg).$(bld_type)
2561	local post_cmds := $(POST_CMDS.$(bld_trg).$(bld_type))
2562	else ifdef POST_CMDS.$(bld_trg_arch)
2563	local post_cmds := $(POST_CMDS.$(bld_trg_arch))
2564	else ifdef POST_CMDS.$(bld_trg)
2565	local post_cmds := $(POST_CMDS.$(bld_trg))
2566	else ifdef POST_CMDS.$(bld_type)
2567	local post_cmds := $(POST_CMDS.$(bld_type))
2568	else
2569	local post_cmds := $(POST_CMDS)
2570	endif
2571
2572	# eliminate this guy?
2573	local objs = $($(target)_OBJS_)
2574
2575	# installation targets
2576	ifndef $(target)_NOINST
2577	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
2578	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
2579	ifdef KBUILD_DO_AUTO_INSTALL
2580	$(typevar) += $(INSTARGET_$(target))
2581	else
2582	$(typevar) += $(out)
2583	endif
2584	# generate the install rule
2585	$(eval $(def_link_install_rule))
2586
2587	else # NOINST
2588	INSTARGET_$(target) :=
2589	$(typevar) += $(out)
2590	endif # NOINST
2591
2592	# dependency file
2593	local dep := $(outbase)$(SUFF_DEP)
2594	ifndef NO_LINK_CMDS_DEPS
2595	_DEPFILES_INCLUDED += $(dep)
2596	$(eval includedep $(dep))
2597	endif
2598
2599	# check that the tool is defined.
2600	ifndef TOOL_$(tool)_$(tool_do)_CMDS
2601	$(warning kBuild: tools: \
2602	1 $($(target)_$(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
2603	2 $($(target)_$(source)TOOL.$(bld_trg)) \
2604	3 $($(target)_$(source)TOOL) \
2605	4 $($(target)_TOOL.$(bld_trg).$(bld_trg_arch)) \
2606	5 $($(target)_TOOL.$(bld_trg)) \
2607	6 $($(target)_TOOL) \
2608	7 $($(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
2609	8 $($(source)TOOL.$(bld_trg)) \
2610	9 $($(source)TOOL) \
2611	10 $(TOOL.$(bld_trg).$(bld_trg_arch)) \
2612	11 $(TOOL.$(bld_trg)) \
2613	12 $(TOOL) )
2614	$(error kBuild: TOOL_$(tool)_$(tool_do)_CMDS isn't defined! target=$(target) )
2615	endif
2616
2617	# call the tool
2618	local cmds := $(TOOL_$(tool)_$(tool_do)_CMDS)
2619	ifneq ($(pre_cmds),)
2620	local cmds := $(TAB)$(pre_cmds)$(NL)$(TAB)$(cmds)
2621	endif
2622	ifneq ($(post_cmds),)
2623	local cmds := $(cmds)$(NL)$(TAB)$(post_cmds)
2624	endif
2625	$(target)_OUTPUT_ := $(TOOL_$(tool)_$(tool_do)_OUTPUT)
2626	$(target)_OUTPUT_MAYBE_ := $(TOOL_$(tool)_$(tool_do)_OUTPUT_MAYBE)
2627	$(target)_DEPEND_ := $(TOOL_$(tool)_$(tool_do)_DEPEND) $(deps) $($(target)_OBJS_)
2628	$(target)_DEPORD_ := $(TOOL_$(tool)_$(tool_do)_DEPORD) $(dirdep) $(orderdeps)
2629
2630	# generate the link rule.
2631	$(eval $(def_link_rule))
2632
2633
2634	# Update globals.
2635	_OBJS += $($(target)_OBJS_)
2636	_OUT_FILES += $($(target)_OUTPUT_) $(out)
2637	_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))
2638	_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))
2639	_INSTALLS_FILES += $(INSTARGET_$(target))
2640
2641	endef
2642
2643
2644	#
2645	# BLDPROGS
2646	#
2647
2648	## Build program (one).
2649	# @param $(target) Normalized target (program) name.
2650	define def_bldprog
2651
2652	# set NOINST if not forced installation.
2653	ifndef $(target)_INST
2654	$(target)_NOINST := 1
2655	endif
2656
2657	# do the usual stuff.
2658	$(evalval def_link_common)
2659
2660	endef
2661
2662	# Process build programs.
2663	EXT := EXE
2664	EXTPRE := HOST
2665	tool_do := LINK_PROGRAM
2666	definst := $(PATH_BIN)
2667	typevar := _BLDPROGS
2668	mode := 0755
2669	bld_trg_base_var := PLATFORM
2670	$(foreach target, $(BLDPROGS) $(BLDPROGS.$(KBUILD_HOST)) $(BLDPROGS.$(KBUILD_HOST).$(KBUILD_HOST_ARCH)), $(evalval def_bldprog))
2671
2672	ifdef KBUILD_PROFILE_SELF
2673	_KBUILD_TS_NOW := $(nanots )
2674	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done build program targets)
2675	$(info stat: $(make-stats ))
2676	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2677	endif
2678
2679
2680	#
2681	# DLLS
2682	#
2683
2684	# Process dlls
2685	EXT := DLL
2686	EXTPRE :=
2687	tool_do := LINK_DLL
2688	definst := $(PATH_DLL)
2689	typevar := _DLLS
2690	mode := 0644
2691	bld_trg_base_var := TARGET
2692	$(foreach target, $(DLLS) $(DLLS.$(KBUILD_TARGET)) $(DLLS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), $(evalval def_link_common))
2693
2694	ifdef KBUILD_PROFILE_SELF
2695	_KBUILD_TS_NOW := $(nanots )
2696	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done dll targets)
2697	$(info stat: $(make-stats ))
2698	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2699	endif
2700
2701
2702	#
2703	# IMPORT LIBRARIES
2704	#
2705	# - On OS/2 and windows these are libraries.
2706	# - On other platforms they are fake DLLs.
2707	#
2708	EXTPRE :=
2709	typevar := _IMPORT_LIBS
2710	mode := 0644
2711	bld_trg_base_var := TARGET
2712	ifeq ($(filter-out nt os2 win win64 win32,$(KBUILD_TARGET)),)
2713	EXT := LIB
2714	tool_do := LINK_LIBRARY
2715	definst := $(PATH_LIB)
2716	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(KBUILD_TARGET)) $(IMPORT_LIBS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), $(evalval def_lib))
2717	else
2718	EXT := DLL
2719	tool_do := LINK_DLL
2720	definst := $(PATH_DLL)
2721	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(KBUILD_TARGET)) $(IMPORT_LIBS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), $(evalval def_link_common))
2722	endif
2723
2724	ifdef KBUILD_PROFILE_SELF
2725	_KBUILD_TS_NOW := $(nanots )
2726	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done import library targets)
2727	$(info stat: $(make-stats ))
2728	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2729	endif
2730
2731
2732	#
2733	# PROGRAMS
2734	#
2735
2736	# Process programs
2737	EXT := EXE
2738	EXTPRE :=
2739	tool_do := LINK_PROGRAM
2740	definst := $(PATH_BIN)
2741	typevar := _PROGRAMS
2742	mode := 0755
2743	bld_trg_base_var := TARGET
2744	$(foreach target, $(PROGRAMS) $(PROGRAMS.$(KBUILD_TARGET)) $(PROGRAMS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), $(evalval def_link_common))
2745
2746	ifdef KBUILD_PROFILE_SELF
2747	_KBUILD_TS_NOW := $(nanots )
2748	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done program targets)
2749	$(info stat: $(make-stats ))
2750	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2751	endif
2752
2753
2754	#
2755	# SYSMODS
2756	#
2757
2758	# Process sysmods
2759	EXT := SYS
2760	EXTPRE :=
2761	tool_do := LINK_SYSMOD
2762	definst := $(PATH_SYS)
2763	typevar := _SYSMODS
2764	mode := 0644
2765	bld_trg_base_var := TARGET
2766	$(foreach target, $(SYSMODS) $(SYSMODS.$(KBUILD_TARGET)) $(SYSMODS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), $(evalval def_link_common))
2767
2768	ifdef KBUILD_PROFILE_SELF
2769	_KBUILD_TS_NOW := $(nanots )
2770	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done sysmod targets)
2771	$(info stat: $(make-stats ))
2772	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
2773	endif
2774
2775
2776	#
2777	# OTHERS
2778	#
2779	_OTHERS = $(OTHERS) $(OTHERS.$(KBUILD_TARGET)) $(OTHERS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))
2780
2781
2782	#
2783	# INSTALLS
2784	#
2785
2786	## generate the install rule
2787	define def_install_src_rule
2788	# the install rule
2789	$(insdst) : $(srcsrc) \| $(call DIRDEP,$(dir $(insdst)))
2790	%$$(call MSG_INST_FILE,$(srcsrc),$(insdst))
2791	$$(QUIET)$(inscmd)
2792	endef
2793
2794	## install one file
2795	define def_install_src
2796
2797	# deal with '=>' in the source file name.
2798	local srcdst := $(subst =>, ,$(src))
2799	local srcsrc := $(firstword $(srcdst))
2800	local srcdstdir := $(dir $(word 2,$(srcdst)))
2801	local srcdst := $(word $(words $(srcdst)),$(srcdst))
2802
2803	# _INSTFUN
2804	ifdef $(srcsrc)_INSTFUN
2805	local instfun := $(srcsrc)_INSTFUN
2806	else ifdef $(target)_INSTFUN
2807	local instfun := $(target)_INSTFUN
2808	else
2809	local instfun := _INSTALL_FILE
2810	endif
2811
2812	# _INST
2813	ifdef $(srcsrc)_INST
2814	local inst := $(patsubst %/,%,$($(srcsrc)_INST))/$(dir $(srcdstdir))
2815	else ifdef $(target)_INST
2816	local inst := $(patsubst %/,%,$($(target)_INST))/$(dir $(srcdstdir))
2817	else
2818	local inst := $(dir $(srcdstdir))
2819	endif
2820
2821	# calc target
2822	local insdst := $(call $(instfun),$(srcdst),$(target),$(inst),$(PATH_INS))
2823	#$(warning instfun=$(instfun) srcdst=$(srcdst) target=$(target) inst=$(inst) => insdst=$(insdst))
2824
2825	# mode, uid and gid
2826	local mode := $(firstword \
2827	$($(target)_$(srcsrc)_MODE.$(bld_trg).$(bld_trg_arch)) \
2828	$($(target)_$(srcsrc)_MODE.$(bld_trg)) \
2829	$($(target)_$(srcsrc)_MODE) \
2830	$($(target)_$(srcdst)_MODE.$(bld_trg).$(bld_trg_arch)) \
2831	$($(target)_$(srcdst)_MODE.$(bld_trg)) \
2832	$($(target)_$(srcdst)_MODE) \
2833	$($(srcsrc)_MODE.$(bld_trg).$(bld_trg_arch)) \
2834	$($(srcsrc)_MODE.$(bld_trg)) \
2835	$($(srcsrc)_MODE) \
2836	$($(srcdst)_MODE.$(bld_trg).$(bld_trg_arch)) \
2837	$($(srcdst)_MODE.$(bld_trg)) \
2838	$($(srcdst)_MODE) \
2839	$($(target)_MODE.$(bld_trg).$(bld_trg_arch)) \
2840	$($(target)_MODE.$(bld_trg)) \
2841	$($(target)_MODE))
2842	local uid := $(firstword \
2843	$($(target)_$(srcsrc)_UID.$(bld_trg).$(bld_trg_arch)) \
2844	$($(target)_$(srcsrc)_UID.$(bld_trg)) \
2845	$($(target)_$(srcsrc)_UID) \
2846	$($(target)_$(srcdst)_UID.$(bld_trg).$(bld_trg_arch)) \
2847	$($(target)_$(srcdst)_UID.$(bld_trg)) \
2848	$($(target)_$(srcdst)_UID) \
2849	$($(srcsrc)_UID.$(bld_trg).$(bld_trg_arch)) \
2850	$($(srcsrc)_UID.$(bld_trg)) \
2851	$($(srcsrc)_UID) \
2852	$($(srcdst)_UID.$(bld_trg).$(bld_trg_arch)) \
2853	$($(srcdst)_UID.$(bld_trg)) \
2854	$($(srcdst)_UID) \
2855	$($(target)_UID.$(bld_trg).$(bld_trg_arch)) \
2856	$($(target)_UID.$(bld_trg)) \
2857	$($(target)_UID))
2858	local gid := $(firstword \
2859	$($(target)_$(srcsrc)_GID.$(bld_trg).$(bld_trg_arch)) \
2860	$($(target)_$(srcsrc)_GID.$(bld_trg)) \
2861	$($(target)_$(srcsrc)_GID) \
2862	$($(target)_$(srcdst)_GID.$(bld_trg).$(bld_trg_arch)) \
2863	$($(target)_$(srcdst)_GID.$(bld_trg)) \
2864	$($(target)_$(srcdst)_GID) \
2865	$($(srcsrc)_GID.$(bld_trg).$(bld_trg_arch)) \
2866	$($(srcsrc)_GID.$(bld_trg)) \
2867	$($(srcsrc)_GID) \
2868	$($(srcdst)_GID.$(bld_trg).$(bld_trg_arch)) \
2869	$($(srcdst)_GID.$(bld_trg)) \
2870	$($(srcdst)_GID) \
2871	$($(target)_GID.$(bld_trg).$(bld_trg_arch)) \
2872	$($(target)_GID.$(bld_trg)) \
2873	$($(target)_GID))
2874	local flags := \
2875	$($(target)_IFFLAGS) \
2876	$($(target)_IFFLAGS.$(bld_trg)) \
2877	$($(target)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2878	$($(srcdst)_IFFLAGS) \
2879	$($(srcdst)_IFFLAGS.$(bld_trg)) \
2880	$($(srcdst)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2881	$($(srcsrc)_IFFLAGS) \
2882	$($(srcsrc)_IFFLAGS.$(bld_trg)) \
2883	$($(srcsrc)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2884	$($(target)_$(srcdst)_IFFLAGS) \
2885	$($(target)_$(srcdst)_IFFLAGS.$(bld_trg)) \
2886	$($(target)_$(srcdst)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2887	$($(target)_$(srcsrc)_IFFLAGS) \
2888	$($(target)_$(srcsrc)_IFFLAGS.$(bld_trg)) \
2889	$($(target)_$(srcsrc)_IFFLAGS.$(bld_trg).$(bld_trg_arch))
2890	clean_files += \
2891	$($(srcdst)_CLEAN) \
2892	$($(srcdst)_CLEAN.$(bld_trg)) \
2893	$($(srcdst)_CLEAN.$(bld_trg).$(bld_trg_arch)) \
2894	$($(srcsrc)_CLEAN) \
2895	$($(srcsrc)_CLEAN.$(bld_trg)) \
2896	$($(srcsrc)_CLEAN.$(bld_trg).$(bld_trg_arch)) \
2897	$($(target)_$(srcdst)_CLEAN) \
2898	$($(target)_$(srcdst)_CLEAN.$(bld_trg)) \
2899	$($(target)_$(srcdst)_CLEAN.$(bld_trg).$(bld_trg_arch)) \
2900	$($(target)_$(srcsrc)_CLEAN) \
2901	$($(target)_$(srcsrc)_CLEAN.$(bld_trg)) \
2902	$($(target)_$(srcsrc)_CLEAN.$(bld_trg).$(bld_trg_arch))
2903
2904
2905	# Adjust the source if we got a default PATH. (This must be done this late!)
2906	ifdef $(target)_PATH
2907	local srcsrc := $(abspathex $(srcsrc),$($(target)_PATH))
2908	endif
2909
2910	# create the command
2911	ifdef $(srcsrc)_INSTALLER
2912	local inscmd := $(call $(srcsrc)_INSTALLER,$(srcsrc),$(insdst),$(target),$(flags))
2913	else ifdef $(target)_INSTALLER
2914	local inscmd := $(call $(target)_INSTALLER,$(srcsrc),$(insdst),$(target),$(flags))
2915	else
2916	local inscmd := $$(INSTALL)\
2917	$(if $(uid),-o $(uid))\
2918	$(if $(gid),-g $(gid))\
2919	$(if $(mode),-m $(mode))\
2920	$(flags) -- \
2921	$(srcsrc) $(insdst)
2922	endif
2923
2924	# generate the rule (need double evaluation here)
2925	$(eval $(def_install_src_rule))
2926
2927	INSTARGET_$(target) += $(insdst)
2928	endef
2929
2930
2931	## generate the symlink rule
2932	define def_install_symlink_rule
2933	# the install rule
2934	$(insdst) : \| $(call DIRDEP,$(dir $(insdst)))
2935	%$$(call MSG_INST_SYM,$(insdst),$(symdst))
2936	$$(QUIET)$$(RM) -f -- $$@
2937	$$(QUIET)$$(LN_SYMLINK) $(symdst) $(insdst)
2938	endef
2939
2940	## create one symlink
2941	define def_install_symlink
2942
2943	# deal with '=>' in the source file name.
2944	local symdst := $(subst =>, ,$(src))
2945	local symlnk := $(firstword $(symdst))
2946	local symdst := $(word $(words $(symdst)),$(symdst))
2947
2948	# _INSTFUN
2949	ifdef $(symlnk)_INSTFUN
2950	local instfun := $(symlnk)_INSTFUN
2951	else ifdef $(target)_INSTFUN
2952	local instfun := $(target)_INSTFUN
2953	else
2954	local instfun := _INSTALL_FILE
2955	endif
2956
2957	# _INST
2958	ifdef $(symlnk)_INST
2959	local inst := $(patsubst %/,%,$($(symlnk)_INST))/$(dir $(symlnk))
2960	else ifdef $(target)_INST
2961	local inst := $(patsubst %/,%,$($(target)_INST))/$(dir $(symlnk))
2962	else
2963	local inst := $(dir $(symlnk))
2964	endif
2965
2966	# calc target
2967	local insdst := $(call $(instfun),$(symlnk),$(target),$(inst),$(PATH_INS))
2968	#$(warning symlnk=$(symlnk) symdst=$(symdst) insdst=$(insdst) instfun=$(instfun) inst='$(inst)')
2969
2970	# generate the rule (need double evaluation here)
2971	$(eval $(def_install_symlink_rule))
2972
2973	INSTARGET_$(target) += $(insdst)
2974	endef
2975
2976
2977	## generate the install rule
2978	define def_install_directory_rule
2979	# the install rule
2980	$(insdst):
2981	%$$(call MSG_INST_DIR,$(insdst))
2982	$$(QUIET)$$(INSTALL) -d \
2983	$(if $(uid),-o $(uid))\
2984	$(if $(gid),-g $(gid))\
2985	$(if $(mode),-m $(mode))\
2986	$(flags) -- \
2987	$(insdst)
2988
2989	.NOTPARALLEL: $(insdst)
2990	endef
2991
2992
2993	## create one directory
2994	define def_install_directory
2995
2996	# _INST
2997	ifdef $(directory)_INST
2998	local inst := $(PATH_INS)/$(patsubst %/,%,$($(directory)_INST))
2999	else ifdef $(target)_INST
3000	local inst := $(PATH_INS)/$(patsubst %/,%,$($(target)_INST))
3001	else
3002	local inst := $(PATH_INS)
3003	endif
3004
3005	local mode := $(firstword \
3006	$($(target)_$(directory)_MODE.$(bld_trg).$(bld_trg_arch)) \
3007	$($(target)_$(directory)_MODE.$(bld_trg)) \
3008	$($(target)_$(directory)_MODE) \
3009	$($(directory)_MODE.$(bld_trg).$(bld_trg_arch)) \
3010	$($(directory)_MODE.$(bld_trg)) \
3011	$($(directory)_MODE) \
3012	$($(target)_MODE.$(bld_trg).$(bld_trg_arch)) \
3013	$($(target)_MODE.$(bld_trg)) \
3014	$($(target)_MODE))
3015	local uid := $(firstword \
3016	$($(target)_$(directory)_UID.$(bld_trg).$(bld_trg_arch)) \
3017	$($(target)_$(directory)_UID.$(bld_trg)) \
3018	$($(target)_$(directory)_UID) \
3019	$($(directory)_UID.$(bld_trg).$(bld_trg_arch)) \
3020	$($(directory)_UID.$(bld_trg)) \
3021	$($(directory)_UID) \
3022	$($(target)_UID.$(bld_trg).$(bld_trg_arch)) \
3023	$($(target)_UID.$(bld_trg)) \
3024	$($(target)_UID))
3025	local gid := $(firstword \
3026	$($(target)_$(directory)_GID.$(bld_trg).$(bld_trg_arch)) \
3027	$($(target)_$(directory)_GID.$(bld_trg)) \
3028	$($(target)_$(directory)_GID) \
3029	$($(directory)_GID.$(bld_trg).$(bld_trg_arch)) \
3030	$($(directory)_GID.$(bld_trg)) \
3031	$($(directory)_GID) \
3032	$($(target)_GID.$(bld_trg).$(bld_trg_arch)) \
3033	$($(target)_GID.$(bld_trg)) \
3034	$($(target)_GID))
3035	local flags := \
3036	$($(target)_IDFLAGS)\
3037	$($(target)_IDFLAGS.$(bld_trg)) \
3038	$($(target)_IDFLAGS.$(bld_trg).$(bld_trg_arch)) \
3039	$($(directory)_IDFLAGS) \
3040	$($(directory)_IDFLAGS.$(bld_trg)) \
3041	$($(directory)_IDFLAGS.$(bld_trg).$(bld_trg_arch)) \
3042	$($(target)_$(directory)_IDFLAGS) \
3043	$($(target)_$(directory)_IDFLAGS.$(bld_trg)) \
3044	$($(target)_$(directory)_IDFLAGS.$(bld_trg).$(bld_trg_arch))
3045
3046	local insdst := $(inst)/$(directory)/
3047	#$(warning directory=$(directory) inst=$(inst) insdst=$(insdst) mode=$(mode) gid=$(gid) uid=$(uid))
3048
3049	# generate the rule (need double evaluation here)
3050	$(eval $(def_install_directory_rule))
3051
3052	INSTARGET_DIRS_$(target) += $(insdst)
3053	endef
3054
3055
3056	## process one install target.
3057	define def_install
3058	# the basics.
3059	local bld_type := $(firstword $($(target)_BLD_TYPE) $(KBUILD_TYPE))
3060	local bld_trg := $(firstword $($(target)_BLD_TRG) $(KBUILD_TARGET))
3061	local bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(KBUILD_TARGET_ARCH))
3062	local bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(KBUILD_TARGET_CPU))
3063
3064	INSTARGET_$(target) := $($(target)_GOALS)
3065	INSTARGET_DIRS_$(target) :=
3066
3067	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))
3068
3069	$(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)), \
3070	$(evalval def_install_directory))
3071
3072	$(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)), \
3073	$(evalval def_install_src))
3074
3075	$(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)), \
3076	$(evalval def_install_symlink))
3077
3078	# the collection target
3079	TARGET_$(target) := $(PATH_TARGET)/$(target).ins
3080	$(TARGET_$(target)): $(INSTARGET_$(target)) \| $(INSTARGET_DIRS_$(target)) $(call DIRDEP,$(PATH_TARGET))
3081	@$(QUIET2)$(APPEND) $@
3082
3083	$(target): $(TARGET_$(target))
3084
3085	_INSTALLS += $(TARGET_$(target))
3086	_INSTALLS_FILES += $(INSTARGET_$(target))
3087	_INSTALLS_DIRS += $(INSTARGET_DIRS_$(target))
3088	_CLEAN_FILES += $(clean_files)
3089	_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))
3090	endef
3091
3092	## process all install targets
3093	$(foreach target, $(INSTALLS) $(INSTALLS.$(KBUILD_TARGET)) $(INSTALLS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)), \
3094	$(evalvalctx def_install))
3095
3096	ifdef KBUILD_PROFILE_SELF
3097	_KBUILD_TS_NOW := $(nanots )
3098	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done install targets)
3099	$(info stat: $(make-stats ))
3100	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
3101	endif
3102
3103
3104	#
3105	# PACKING
3106	#
3107	_PACKING += $(PACKING) $(PACKING.$(KBUILD_TARGET)) $(PACKING.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH))
3108
3109
3110	#
3111	# DOCS
3112	#
3113
3114
3115	#
3116	# DIRECTORIES
3117	#
3118	_DIR_ALL := $(sort $(addsuffix /,$(patsubst %/,%,$(_DIRS))) $(dir $(_OUT_FILES) $(_OBJS) $(_INSTALLS_FILES)))
3119	$(foreach directory,$(_INSTALLS_DIRS), $(eval _DIR_ALL := $(filter-out $(directory),$(_DIR_ALL))))
3120
3121
3122	define def_mkdir_rule
3123	$(directory):
3124	%$$(call MSG_MKDIR,$$@)
3125	$$(QUIET)$$(MKDIR) -p -- $$@
3126	endef
3127
3128	$(foreach directory,$(_DIR_ALL),$(eval $(def_mkdir_rule)))
3129
3130	ifdef KBUILD_PROFILE_SELF
3131	_KBUILD_TS_NOW := $(nanots )
3132	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done directories)
3133	$(info stat: $(make-stats ))
3134	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
3135	endif
3136
3137
3138	#
3139	# NOTHING
3140	#
3141	do-nothing:
3142	ifdef KBUILD_PROFILE_SELF
3143	@$(ECHO) 'prof: $(int-sub $(nanots ), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(nanots ), $(_KBUILD_TS_PREV)) - executing $@'
3144	@$(ECHO) 'stat: $(make-stats )'
3145	endif
3146	%$(call MSG_NOTHING)
3147
3148
3149	#
3150	# CLEAN UP
3151	#
3152	do-clean:
3153	%$(call MSG_CLEAN)
3154	$(QUIET)$(RM) -f -- $(_OUT_FILES) $(_OBJS) $(_DEPFILES) $(_DEPFILES_INCLUDED) $(_CLEAN_FILES) $(OTHER_CLEAN)
3155	$(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)))
3156
3157
3158
3159	#
3160	# PASSES (including directory and makefile walking)
3161	#
3162
3163	## Subdir
3164	# @param $(pass) Lowercase pass name.
3165	# @param $(PASS) Uppercase pass name.
3166	# @param $(subdir) Subdirectory
3167	# @param $(tag) tag to attach to the rule name.
3168	define def_pass_subdir
3169	pass_$(pass)$(tag):: $(dep)
3170	+ $$(QUIET)$$(MAKE) -C $(subdir) -f $$(notdir $$(firstword $$(wildcard $$(addprefix $(subdir)/,$$(DEFAULT_MAKEFILE))))) pass_$(pass)
3171	endef
3172
3173	## Submakefile
3174	# @param $(pass) Lowercase pass name.
3175	# @param $(PASS) Uppercase pass name.
3176	# @param $(makefile) Makefile.
3177	# @param $(tag) tag to attach to the rule name.
3178	define def_pass_makefile
3179	pass_$(pass)$(tag):: $(dep)
3180	+ $$(QUIET)$$(MAKE) -C $(patsubst %/,%,$(dir $(makefile))) -f $(notdir $(makefile)) pass_$(pass)
3181	endef
3182
3183	## Execute a pass.
3184	# @param $(pass) Lowercase pass name.
3185	# @param $(PASS) Uppercase pass name.
3186	define def_pass_old
3187	$(eval SUBDIRS_$(PASS) ?= $(SUBDIRS) $(SUBDIRS.$(KBUILD_TARGET)) $(SUBDIRS.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3188	$(eval SUBDIRS_AFTER_$(PASS) ?= $(SUBDIRS_AFTER) $(SUBDIRS_AFTER.$(KBUILD_TARGET)) $(SUBDIRS_AFTER.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3189	$(eval MAKEFILES_BEFORE_$(PASS) ?= $(MAKEFILES_BEFORE) $(MAKEFILES_BEFORE.$(KBUILD_TARGET)) $(MAKEFILES_BEFORE.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3190	$(eval MAKEFILES_AFTER_$(PASS) ?= $(MAKEFILES_AFTER) $(MAKEFILES_AFTER.$(KBUILD_TARGET)) $(MAKEFILES_AFTER.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3191
3192	$(eval tag:=_before)
3193	$(eval dep:=)
3194	$(foreach subdir,$(SUBDIRS_$(PASS)) $(SUBDIRS_$(PASS).$(KBUILD_TARGET)) $(SUBDIRS_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
3195	$(foreach makefile,$(MAKEFILES_BEFORE_$(PASS)) $(MAKEFILES_BEFORE_$(PASS).$(KBUILD_TARGET)) $(MAKEFILES_BEFORE_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)),$(eval $(def_pass_makefile)))
3196
3197	$(eval tag:=_after)
3198	$(eval dep:=pass_$(pass)_doit)
3199	$(foreach subdir,$(SUBDIRS_AFTER_$(PASS)) $(SUBDIRS_AFTER_$(PASS).$(KBUILD_TARGET)) $(SUBDIRS_AFTER_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
3200	$(foreach makefile,$(MAKEFILES_AFTER_$(PASS)) $(MAKEFILES_AFTER_$(PASS).$(KBUILD_TARGET)) $(MAKEFILES_AFTER_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) ,$(eval $(def_pass_makefile)))
3201
3202	.NOTPARALLEL: pass_$(pass)_before pass_$(pass)_after
3203	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_doit pass_$(pass)_after
3204	pass_$(pass)_doit: $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$(var))
3205	pass_$(pass)_this: pass_$(pass)_before
3206	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)_doit
3207	pass_$(pass)_after:: pass_$(pass)_this
3208	pass_$(pass): pass_$(pass)_after
3209
3210	endef
3211
3212	define def_pass
3213	$(eval SUBDIRS_$(PASS) ?= $(SUBDIRS) $(SUBDIRS.$(KBUILD_TARGET)) $(SUBDIRS.$(KBUILD_TARGET.$(KBUILD_TARGET_ARCH))) )
3214	$(eval SUBDIRS_AFTER_$(PASS) ?= $(SUBDIRS_AFTER) $(SUBDIRS_AFTER.$(KBUILD_TARGET)) $(SUBDIRS_AFTER.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3215	$(eval MAKEFILES_BEFORE_$(PASS) ?= $(MAKEFILES_BEFORE) $(MAKEFILES_BEFORE.$(KBUILD_TARGET)) $(MAKEFILES_BEFORE.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3216	$(eval MAKEFILES_AFTER_$(PASS) ?= $(MAKEFILES_AFTER) $(MAKEFILES_AFTER.$(KBUILD_TARGET)) $(MAKEFILES_AFTER.$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) )
3217
3218	$(eval tag:=_before)
3219	$(eval dep:=)
3220	$(foreach subdir,$(SUBDIRS_$(PASS)) $(SUBDIRS_$(PASS).$(KBUILD_TARGET)) $(SUBDIRS_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
3221	$(foreach makefile,$(MAKEFILES_BEFORE_$(PASS)) $(MAKEFILES_BEFORE_$(PASS).$(KBUILD_TARGET)) $(MAKEFILES_BEFORE_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)),$(eval $(def_pass_makefile)))
3222
3223	$(eval tag:=_after)
3224	$(eval dep:=pass_$(pass)_doit)
3225	$(foreach subdir,$(SUBDIRS_AFTER_$(PASS)) $(SUBDIRS_AFTER_$(PASS).$(KBUILD_TARGET)) $(SUBDIRS_AFTER_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
3226	$(foreach makefile,$(MAKEFILES_AFTER_$(PASS)) $(MAKEFILES_AFTER_$(PASS).$(KBUILD_TARGET)) $(MAKEFILES_AFTER_$(PASS).$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)) ,$(eval $(def_pass_makefile)))
3227
3228	ifdef KBUILD_SAFE_PARALLEL
3229	.NOTPARALLEL: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_this
3230	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_this pass_$(pass)_doit
3231	pass_$(pass)_doit: $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$(var))
3232	pass_$(pass)_this: pass_$(pass)_before
3233	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)_doit
3234	pass_$(pass)_after:: pass_$(pass)_this
3235	pass_$(pass): pass_$(pass)_after
3236	else
3237	.NOTPARALLEL: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_doit
3238	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_doit
3239	pass_$(pass)_doit: pass_$(pass)_before \
3240	$(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$($(var)))
3241	pass_$(pass): \
3242	pass_$(pass)_before \
3243	pass_$(pass)_doit \
3244	pass_$(pass)_after
3245	endif
3246
3247	#$ (warning pass=$(pass) PASS=$(PASS): $(PASS_$(PASS)_trgs) $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$($(var))))
3248	endef
3249
3250	# Generate the defined passes.
3251	$(foreach PASS, $(PASSES), \
3252	$(eval pass := $(PASS_$(PASS)_pass)) \
3253	$(eval $(def_pass)))
3254
3255	## Pass order
3256	# @param $(pass) Current pass name.
3257	# @param $(prev_pass) The previous pass name.
3258	define def_pass_order
3259	ifdef KBUILD_SAFE_PARALLEL
3260	.NOTPARALLEL: pass_$(pass)_order
3261	.PHONY: pass_$(pass)_order
3262	pass_$(pass)_order: $(pass_prev)
3263	%$$(call MSG_PASS,$$(if $$(PASS_$(PASS)),$$(PASS_$(PASS)),$(pass)))
3264	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)
3265	else
3266	.NOTPARALLEL: pass_$(pass)_order pass_$(pass)_banner
3267	.PHONY: pass_$(pass)_order pass_$(pass)_banner
3268	pass_$(pass)_banner:
3269	%$$(call MSG_PASS,$$(if $$(PASS_$(PASS)),$$(PASS_$(PASS)),$(pass)))
3270	pass_$(pass)_order: \
3271	$(pass_prev) \
3272	pass_$(pass)_banner \
3273	pass_$(pass)
3274	endif
3275	$(eval pass_prev := pass_$(pass)_order)
3276	endef
3277
3278	## PASS: order
3279	# Use dependencies to ensure correct pass order.
3280	pass_prev :=
3281	$(foreach PASS,$(DEFAULT_PASSES),\
3282	$(eval pass := $(PASS_$(PASS)_pass)) \
3283	$(eval $(def_pass_order)))
3284
3285	ifdef KBUILD_PROFILE_SELF
3286	_KBUILD_TS_NOW := $(nanots )
3287	$(info prof: $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_HEADER_START)) - $(int-sub $(_KBUILD_TS_NOW), $(_KBUILD_TS_PREV)) - done passes)
3288	$(info stat: $(make-stats ))
3289	_KBUILD_TS_PREV := $(_KBUILD_TS_NOW)
3290	endif
3291
3292
3293	#
3294	# THE MAIN RULES
3295	#
3296	all_recursive: $(pass_prev)
3297
3298	rebuild: clean
3299	+ $(MAKE) -f $(firstword $(MAKEFILE_LIST)) all_recursive
3300
3301	# @todo make this a non-default pass!
3302	uninstall:
3303	$(RM) -f -- $(_INSTALLS_FILES)
3304
3305	install: pass_installs
3306
3307	# misc shortcuts.
3308	targets: bldprogs libraries dlls programs sysmods others installs
3309	objects: $(_OBJS)
3310	bldprogs: $(_BLDPROGS)
3311	libraries: $(_LIBS) $(_IMPORT_LIBS) $(_OTHER_LIBRARIES)
3312	dlls: $(_DLLS)
3313	programs: $(_PROGRAMS)
3314	sysmods: $(_SYSMODS)
3315	others: $(_OTHERS)
3316	installs: $(_INSTALLS) $(_INSTALLS_DIRS) $(_INSTALLS_FILES)
3317
3318
3319
3320	#
3321	# kBuild debugging stuff.
3322	#
3323	show_targets:
3324	@$(foreach target, $(_ALL_TARGETS),\
3325	@$(ECHO) "target: $(target)" $(NLTAB)\
3326	@$(ECHO) " PATH_$(target)=$(PATH_$(target))" $(NLTAB)\
3327	@$(ECHO) " TARGET_$(target)=$(TARGET_$(target))" $(NLTAB)\
3328	@$(ECHO) " INSTARGET_$(target)=$(INSTARGET_$(target))" $(NLTAB)\
3329	$(foreach prop,$(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) OBJS_ CLEAN, \
3330	$(eval _tmp:=$(firstword $($(target)_BLD_TRG) $(KBUILD_TARGET))) \
3331	$(if $($(target)_$(prop).$(_tmp)),\
3332	@$(ECHO) " $(target)_$(prop).$(_tmp)=$($(target)_$(prop).$(_tmp))" $(NLTAB)) \
3333	$(if $($(target)_$(prop)), $(NLTAB)@$(ECHO) " $(target)_$(prop)=$($(target)_$(prop))" $(NLTAB)) \
3334	)\
3335	$(foreach prop,$(PROPS_DEFERRED), \
3336	$(eval _tmp:=$(firstword $($(target)_BLD_TRG) $(KBUILD_TARGET))) \
3337	$(if $(value $(target)_$(prop).$(_tmp)),\
3338	@$(ECHO) ' $(target)_$(prop).$(_tmp)=$(value $(TARGET)_$(prop).$(_tmp))' $(NLTAB)) \
3339	$(if $(value $(target)_$(prop)), $(NLTAB)@$(ECHO) ' $(target)_$(prop)=$(value $(target)_$(prop))' $(NLTAB)) \
3340	))
3341
3342
3343
3344	#
3345	# Include dependency files.
3346	#
3347	ifneq ($(_DEPFILES),)
3348	includedep $(_DEPFILES)
3349	endif
3350
3351
3352	ifdef KBUILD_PROFILE_SELF
3353	_KBUILD_TS_FOOTER_END := $(nanots )
3354	$(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)
3355	$(info prof: footer.kmk: $(int-sub $(_KBUILD_TS_FOOTER_END), $(_KBUILD_TS_FOOTER_START)))
3356	$(info stat: $(make-stats ))
3357	_KBUILD_TS_PREV := $(_KBUILD_TS_FOOTER_END)
3358	endif
3359
3360	# end-of-file-content
3361	__footer_kmk__ := target
3362	endif # __footer_kmk__
3363

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

Download in other formats:

Original Format