Context Navigation

footer.kmk@ 2511

Last change on this file since 2511 was 2511, checked in by bird, 14 years ago
footer.kmk: Another link target install fix.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 130.0 KB

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

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

Download in other formats:

Original Format