Context Navigation

footer.kmk@ 2413

Last change on this file since 2413 was 2413, checked in by bird, 15 years ago
copyright year update.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 130.9 KB

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

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

Download in other formats:

Original Format