Context Navigation

footer.kmk@ 2059

Last change on this file since 2059 was 2059, checked in by bird, 17 years ago
footer.kmk: can use strict_unsafe with -j1.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 126.2 KB

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

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

Download in other formats:

Original Format