Context Navigation

footer.kmk@ 2434

Last change on this file since 2434 was 2434, checked in by bird, 15 years ago
kBuild: Deprecating PATH_<target> and <target>_PATH in favor of <target>_0_OUTDIR and <target>_DEFPATH.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 126.5 KB

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

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

Download in other formats:

Original Format