Context Navigation

footer.kmk@ 975

Last change on this file since 975 was 966, checked in by bird, 18 years ago
Fix the clean rule
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 85.6 KB

Line
1	# $Id: footer.kmk 966 2007-05-27 13:47:57Z bird $
2	## @file
3	#
4	# kBuild - File included at top of makefile.
5	#
6	# Copyright (c) 2004-2007 knut st. osmundsen <bird-kBuild-spam@anduin.net>
7	#
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
27	ifndef __footer_kmk__
28	# start-of-file-content
29
30	#
31	# Variables.
32	# (Some of these need initialization before including definitions using them.)
33	#
34
35	# all targets.
36	ALL_TARGETS += \
37	$(FETCHES) $(FETCHES.$(BUILD_TARGET)) $(FETCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
38	$(PATCHES) $(PATCHES.$(BUILD_TARGET)) $(PATCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
39	$(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)) \
40	$(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
41	$(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
42	$(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
43	$(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
44	$(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
45	$(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
46	$(OTHERS) $(OTHERS.$(BUILD_TARGET)) $(OTHERS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
47
48	# all $(BUILD_TARGET) targets.
49	_ALL_BUILD_TARGET_TARGETS += \
50	$(FETCHES) $(FETCHES.$(BUILD_TARGET)) $(FETCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
51	$(PATCHES) $(PATCHES.$(BUILD_TARGET)) $(PATCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
52	$(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
53	$(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
54	$(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
55	$(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
56	$(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
57	$(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
58	$(OTHERS) $(OTHERS.$(BUILD_TARGET)) $(OTHERS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
59
60	# all $(BUILD_TARGET) targets.
61	_ALL_BUILD_PLATFORM_TARGETS += \
62	$(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH))
63
64	# all targets making use of srcname.
65	_ALL_SRCNAME_TARGETS += \
66	$(FETCHES) $(FETCHES.$(BUILD_TARGET)) $(FETCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
67	$(PATCHES) $(PATCHES.$(BUILD_TARGET)) $(PATCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
68
69	# dependency files.
70	_DEPFILES :=
71
72	# included dependency files.
73	_DEPFILES_INCLUDED :=
74
75
76	# All kind of output files except for _OBJS and _DEPFILES.
77	# Compiling or linking definition outputting other things that $@ and any
78	# required dependency file must add those output files to this variable.
79	_OUT_FILES :=
80
81	# Files which only requires cleaning up.
82	_CLEAN_FILES :=
83
84	# all of a type
85	_OBJS :=
86	_FETCHES :=
87	_DOWNLOADS:=
88	_UNPACKS :=
89	_PATCHES :=
90	_UNFETCHES:=
91	_BLDPROGS :=
92	_LIBS :=
93	_DLLS :=
94	_PROGRAMS :=
95	_SYSMODS :=
96	_INSTALLS :=
97	_INSTALLS_FILES :=
98	_INSTALLS_DIRS :=
99	_OTHERS :=
100	_PACKING :=
101	_DIRS := $(PATH_TARGET)/ $(PATH_TARGET) $(BLDDIRS)
102	_IMPORT_LIBS :=
103
104	# misc
105	pass_prev :=
106
107
108	#
109	# Basic macros
110	#
111
112	## Figure out the tool for a target.
113	# @param $1 normalized target.
114	# @param $2 tooltype.
115	# @param bld_trg build target.
116	# @param bld_trg_arch build target architecture.
117	_TARGET_TOOL = $(strip $(firstword \
118	$($(1)_$(2)TOOL.$(bld_trg).$(bld_trg_arch)) \
119	$($(1)_$(2)TOOL.$(bld_trg)) \
120	$($(1)_$(2)TOOL) \
121	$($(1)_TOOL.$(bld_trg).$(bld_trg_arch)) \
122	$($(1)_TOOL.$(bld_trg)) \
123	$($(1)_TOOL) \
124	$($(2)TOOL.$(bld_trg).$(bld_trg_arch)) \
125	$($(2)TOOL.$(bld_trg)) \
126	$($(2)TOOL) \
127	$(TOOL.$(bld_trg).$(bld_trg_arch)) \
128	$(TOOL.$(bld_trg)) \
129	$(TOOL) \
130	))
131
132	## Figure out the actual name of an installed file.
133	# @param $1 The file to install.
134	# @param $2 The target name.
135	# @param $3 The _INST value (can be empty).
136	# @param $4 The default directory to use when $3 is empty.
137	_INSTALL_FILE = $(patsubst %/,%/$(notdir $(1)),$(if $(3),$(PATH_INS)/$(3),$(4)/))
138
139
140	#
141	# Include the additional footer macros when bootstrapping kBuild.
142	#
143	ifndef KMK_VERSION
144	include $(PATH_KBUILD)/gnumake-footer.kmk
145	endif
146
147
148
149	#
150	# Check syntax which leads to weird syntax errors.
151	#
152
153	## Check
154	# @param $(target) Target name.
155	define def_check_target
156	ifneq ("$($(target)_TEMPLATE)","$(strip $($(target)_TEMPLATE))")
157	$$(error $(target) have an incorrect template name. Remove any tabs!)
158	endif
159	endef
160	$(foreach target, $(ALL_TARGETS),$(eval $(def_check_target)))
161
162
163	#
164	# Include templates
165	#
166	_TEMPLATES := $(TEMPLATE)
167	define def_templates
168	ifdef $(target)_TEMPLATE
169	_TEMPLATES += $($(target)_TEMPLATE)
170	endif
171	endef
172	$(foreach target, $(ALL_TARGETS), $(eval $(def_templates)))
173	_TEMPLATES := $(sort $(_TEMPLATES))
174	# $ (warning dbg: _TEMPLATES=$(_TEMPLATES))
175
176	define def_templates_include
177	ifndef TEMPLATE_$(template)
178	include $(firstword $(foreach path, $(TEMPLATE_PATHS) $(PATH_KBUILD)/templates/, $(wildcard $(path)/$(template).kmk)))
179	endif
180	endef
181	$(foreach template, $(_TEMPLATES), $(eval $(def_templates)))
182
183
184	#
185	# Template Inheritance.
186	#
187	define def_template_extends_prop
188	ifndef TEMPLATE_$(template)_$(prop)
189	ifdef TEMPLATE_$(parent)_$(prop)
190	TEMPLATE_$(template)_$(prop) = $$(TEMPLATE_$(parent)_$(prop))
191	endif
192	endif
193	endef
194
195
196	define def_template_extends
197	ifdef TEMPLATE_$(template)_EXTENDS
198	ifndef TEMPLATE_$(template)_EXTENDS_STATUS_
199	TEMPLATE_$(template)_EXTENDS_STATUS_ := 0
200	parent := $(strip $(TEMPLATE_$(template)_EXTENDS))
201
202	# recursivly process the parent if it's inherting from somebody too.
203	ifdef TEMPLATE_$(parent)_EXTENDS
204	ifneq ($(TEMPLATE_$(parent)_EXTENDS_STATUS_),42)
205	# foreach will create 'template' in a new variable context hiding our current variable.
206	$(foreach template, $(parent), $(eval $(value def_template_extends)))
207	parent := $(strip $(TEMPLATE_$(template)_EXTENDS))
208	endif
209	endif
210
211	# inherit properties.
212	$(foreach prop, $(PROPS_SINGLE) $(PROPS_ACCUMULATE_R) $(PROPS_ACCUMULATE_L) $(PROPS_DEFERRED)\
213	$(addsuffix .$(BUILD_TARGET), $(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) $(PROPS_DEFERRED))\
214	$(addsuffix .$(BUILD_TARGET).$(BUILD_TARGET_ARCH), $(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) $(PROPS_DEFERRED))\
215	$(addsuffix .$(BUILD_TARGET_ARCH), $(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) $(PROPS_DEFERRED))\
216	$(addsuffix .$(BUILD_TARGET_CPU), $(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) $(PROPS_DEFERRED))\
217	$(addsuffix .$(BUILD_TYPE), $(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) $(PROPS_DEFERRED))\
218	,$(eval $(def_template_extends_prop))) # exploits the 2 evaluation, so no value!
219
220	TEMPLATE_$(template)_EXTENDS_STATUS_ := 42
221	else
222	# protect against inheritance loops.
223	ifneq ($(TEMPLATE_$(template)_EXTENDS_STATUS_),42)
224	$(error kBuild: inheritance loop! template=$(template))
225	endif
226	endif
227	endif
228	endef
229
230	# $ (foreach template, $(_TEMPLATES), $(if TEMPLATE_$(template)_EXTENDS, $(eval $(value def_template_extends))))
231	$(foreach template, $(_TEMPLATES), $(eval $(value def_template_extends)))
232
233
234	#
235	# Common Inheritance
236	#
237
238	## Inherit one template property in a non-accumulative manner.
239	# @param $(prop) Property name
240	# @param $(target) Target name
241	# @todo fix the precedence order for some properties.
242	define def_inherit_template_one
243	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
244	ifndef $(target)_$(prop)
245	$(target)_$(prop) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
246	#$ (warning dbgtarget: $(target)_$(prop):='$(value $(target)_$(prop))' TEMPLATE_$($(target)_TEMPLATE)_$(prop))
247	endif
248	endif
249	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
250	ifndef $(target)_$(prop).$(bld_trg)
251	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
252	$(target)_$(prop).$(bld_trg) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
253	endif
254	endif
255	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
256	ifndef $(target)_$(prop).$(bld_trg).$(bld_trg_arch)
257	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
258	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
259	endif
260	endif
261	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
262	ifndef $(target)_$(prop).$(bld_trg_arch)
263	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
264	$(target)_$(prop).$(bld_trg_arch) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
265	endif
266	endif
267	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
268	ifndef $(target)_$(prop).$(bld_trg_cpu)
269	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_cpu)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
270	$(target)_$(prop).$(bld_trg_cpu) := $(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
271	endif
272	endif
273	endef
274
275	## Inherit one template property in a non-accumulative manner, deferred expansion.
276	# @param 1: $(prop) Property name
277	# @param 2: $(target) Target name
278	# @todo fix the precedence order for some properties.
279	# @remark this define relies on double evaluation
280	define def_inherit_template_one_deferred
281	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
282	ifndef $(target)_$(prop)
283	$(target)_$(prop) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
284	#$ (warning dbgtarget: $(target)_$(prop):='$(value $(target)_$(prop))' TEMPLATE_$($(target)_TEMPLATE)_$(prop))
285	endif
286	endif
287	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
288	ifndef $(target)_$(prop).$(bld_trg)
289	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
290	$(target)_$(prop).$(bld_trg) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
291	endif
292	endif
293	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
294	ifndef $(target)_$(prop).$(bld_trg).$(bld_trg_arch)
295	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
296	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
297	endif
298	endif
299	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
300	ifndef $(target)_$(prop).$(bld_trg_arch)
301	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_arch)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
302	$(target)_$(prop).$(bld_trg_arch) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
303	endif
304	endif
305	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
306	ifndef $(target)_$(prop).$(bld_trg_cpu)
307	#$ (warning dbgsource: $(target)_$(prop).$(bld_trg_cpu)="TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)" TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
308	$(target)_$(prop).$(bld_trg_cpu) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
309	endif
310	endif
311	endef
312
313	## Inherit one acculumlative template property where the 'most significant' items are at the left end.
314	# @param $(prop) Property name
315	# @param $(target) Target name
316	define def_inherit_template_one_accumulate_l
317	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
318	#$ (warning dbgtype: TEMPLATE_$($(target)_TEMPLATE)_$(prop) $(target)_$(prop)=$($(target)_$(prop)) $(TEMPLATE_$($(target)_TEMPLATE)_$(prop)))
319	$(target)_$(prop) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop))
320	#$ (warning dbgtype: $(target)_$(prop)=$($(target)_$(prop)))
321	endif
322	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE)
323	#$ (warning dbg4: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE))
324	$(target)_$(prop).$(BUILD_TYPE) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE))
325	endif
326	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
327	#$ (warning dbg5: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
328	$(target)_$(prop).$(bld_trg) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg))
329	endif
330	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
331	#$ (warning dbg4: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
332	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch))
333	endif
334	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
335	#$ (warning dbg5: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
336	$(target)_$(prop).$(bld_trg_cpu) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu))
337	endif
338	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
339	#$ (warning dbg6: TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
340	$(target)_$(prop).$(bld_trg_arch) += $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch))
341	endif
342	endef
343
344	## Inherit one acculumlative template property where the 'most significant' items are at the right end.
345	# First pass, $(value) referenced.
346	# @param $(prop) Property name
347	# @param $(target) Target name
348	define def_inherit_template_one_accumulate_r1
349	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
350	$(eval _$(target)_$(prop)_R = $(value $(target)_$(prop)))
351	endif
352	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE)
353	$(eval _$(target)_$(prop).$(BUILD_TYPE)_R = $(value $(target)_$(prop).$(BUILD_TYPE)))
354	endif
355	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
356	$(eval _$(target)_$(prop).$(bld_trg)_R = $(value $(target)_$(prop).$(bld_trg)))
357	endif
358	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
359	$(eval _$(target)_$(prop).$(bld_trg).$(bld_trg_arch)_R = $(value $(target)_$(prop).$(bld_trg).$(bld_trg_arch)))
360	endif
361	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
362	$(eval _$(target)_$(prop).$(bld_trg_cpu)_R = $(value $(target)_$(prop).$(bld_trg_cpu)))
363	endif
364	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
365	$(eval _$(target)_$(prop).$(bld_trg_arch)_R = $(value $(target)_$(prop).$(bld_trg_arch)))
366	endif
367	endef
368
369	## Inherit one template property the other way around.
370	# Second pass, not $(value) referenced.
371	# @param $(prop) Property name
372	# @param $(target) Target name
373	define def_inherit_template_one_accumulate_r2
374	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop)
375	$(target)_$(prop) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop)) $$(_$(target)_$(prop)_R)
376	endif
377	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE)
378	$(target)_$(prop).$(BUILD_TYPE) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(BUILD_TYPE)) $$(_$(target)_$(prop).$(BUILD_TYPE)_R)
379	endif
380	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)
381	$(target)_$(prop).$(bld_trg) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg)) $$(_$(target)_$(prop).$(bld_trg)_R)
382	endif
383	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)
384	$(target)_$(prop).$(bld_trg).$(bld_trg_arch) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg).$(bld_trg_arch)) $$(_$(target)_$(prop).$(bld_trg).$(bld_trg_arch)_R)
385	endif
386	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)
387	$(target)_$(prop).$(bld_trg_cpu) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_cpu)) $$(_$(target)_$(prop).$(bld_trg_cpu)_R)
388	endif
389	ifdef TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)
390	$(target)_$(prop).$(bld_trg_arch) = $$(TEMPLATE_$($(target)_TEMPLATE)_$(prop).$(bld_trg_arch)) $$(_$(target)_$(prop).$(bld_trg_arch)_R)
391	endif
392	endef
393
394
395	## Inherit template properties for on target.
396	# @param $(target) Target name.
397	define def_inherit_template
398	# sanity check.
399	ifdef _$(target)_ALREADY_PROCESSED
400	$(error kBuild: The target $(target) appears more than once in the target lists! Please correct the makefile(s))
401	endif
402	_$(target)_ALREADY_PROCESSED := 1
403
404	# Inherit any default template.
405	ifdef TEMPLATE
406	ifeq ($($(target)_TEMPLATE),)
407	$(eval $(target)_TEMPLATE:=$(TEMPLATE))
408	endif
409	endif
410	# Expand the template if specified.
411	ifneq ($($(target)_TEMPLATE),)
412	$(foreach prop,$(PROPS_SINGLE),$(eval $(value def_inherit_template_one)))
413	$(foreach prop,$(PROPS_DEFERRED),$(eval $(def_inherit_template_one_deferred))) # exploits the 2 evaluation, so no value!
414	$(foreach prop,$(PROPS_ACCUMULATE_L),$(eval $(def_inherit_template_one_accumulate_l))) # += works fine (better) without value.
415	$(foreach prop,$(PROPS_ACCUMULATE_R),\
416	$(eval $(value def_inherit_template_one_accumulate_r1))\
417	$(eval $(def_inherit_template_one_accumulate_r2))\
418	) # This is a hack! (but it appears to work)
419	endif
420	endef
421
422	# Inherit template properties
423	bld_trg := $(BUILD_TARGET)
424	bld_trg_arch := $(BUILD_TARGET_ARCH)
425	bld_trg_cpu := $(BUILD_TARGET_CPU)
426	$(foreach target, $(_ALL_BUILD_TARGET_TARGETS),$(eval $(value def_inherit_template)))
427
428	bld_trg := $(BUILD_PLATFORM)
429	bld_trg_arch := $(BUILD_PLATFORM_ARCH)
430	bld_trg_cpu := $(BUILD_PLATFORM_CPU)
431	$(foreach target, $(_ALL_BUILD_PLATFORM_TARGETS),$(eval $(value def_inherit_template)))
432
433
434	#
435	# Include tools & sdks
436	#
437	_TOOLS := $(TOOL.$(BUILD_TARGET)) $(TOOL.$(BUILD_TARGET_ARCH)) $(TOOL.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
438	$(TOOL.$(BUILD_PLATFORM)) $(TOOL.$(BUILD_PLATFORM_ARCH)) $(TOOL.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)) \
439	$(TOOL)
440	_SDKS := $(SDKS.$(BUILD_TARGET)) $(SDKS.$(BUILD_TARGET_ARCH)) $(SDKS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) \
441	$(SDKS.$(BUILD_PLATFORM)) $(SDKS.$(BUILD_PLATFORM_ARCH)) $(SDKS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)) \
442	$(SDKS.$(BUILD_TYPE)) \
443	$(SDKS)
444	define def_tools_sdks_target_source
445	$(eval _TOOLS += $(foreach prop, $(PROPS_TOOLS), \
446	$($(source)_$(prop).$(_bld_trg)) \
447	$($(target)_$(source)_$(prop).$(_bld_trg)) \
448	$($(source)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
449	$($(target)_$(source)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
450	$($(source)_$(prop).$(_bld_trg_arch)) \
451	$($(target)_$(source)_$(prop).$(_bld_trg_arch)) \
452	$($(source)_$(prop)) \
453	$($(target)_$(source)_$(prop))))
454	$(eval _SDKS += \
455	$($(source)_SDKS.$(_bld_trg)) \
456	$($(target)_$(source)_SDKS.$(_bld_trg)) \
457	$($(source)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
458	$($(target)_$(source)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
459	$($(source)_SDKS.$(_bld_trg_arch)) \
460	$($(target)_$(source)_SDKS.$(_bld_trg_arch)) \
461	$($(source)_SDKS.$(BUILD_TYPE)) \
462	$($(target)_$(source)_SDKS.$(BUILD_TYPE)) \
463	$($(source)_SDKS) \
464	$($(target)_$(source)_SDKS))
465	endef
466
467	define def_tools_sdks_target
468	_bld_trg := $(firstword $($(target)_BLD_TRG) $(bld_trg))
469	_bld_trg_arch := $(firstword $($(target)_BLD_TRG_ARCH) $(bld_trg_arch))
470	_bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(bld_trg_cpu))
471
472	$(eval _TOOLS += $(foreach prop, $(PROPS_TOOLS), \
473	$($(target)_$(prop).$(_bld_trg)) \
474	$($(target)_$(prop).$(_bld_trg_arch)) \
475	$($(target)_$(prop).$(_bld_trg).$(_bld_trg_arch)) \
476	$($(target)_$(prop))))
477	$(eval _SDKS += \
478	$($(target)_SDKS.$(_bld_trg)) \
479	$($(target)_SDKS.$(_bld_trg_arch)) \
480	$($(target)_SDKS.$(_bld_trg).$(_bld_trg_arch)) \
481	$($(target)_SDKS))
482	$(foreach source, \
483	$($(target)_SOURCES.$(_bld_trg)) \
484	$($(target)_SOURCES.$(_bld_trg_arch)) \
485	$($(target)_SOURCES.$(_bld_trg).$(_bld_trg_arch)) \
486	$($(target)_SOURCES.$(_bld_trg_cpu)) \
487	$($(target)_SOURCES.$(BUILD_TYPE)) \
488	$($(target)_SOURCES) \
489	, $(eval $(value def_tools_sdks_target_source)))
490	endef
491
492	define def_tools_srcname_target
493	_bld_trg := $(firstword $($(target)_BLD_TRG) $(bld_trg))
494	_bld_trg_arch := $(firstword $($(target)_BLD_TRG_ARCH) $(bld_trg_arch))
495	_bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(bld_trg_cpu))
496
497	$(foreach source, $(notdir\
498	$($(target)_SOURCES.$(_bld_trg)) \
499	$($(target)_SOURCES.$(_bld_trg_arch)) \
500	$($(target)_SOURCES.$(_bld_trg).$(_bld_trg_arch)) \
501	$($(target)_SOURCES.$(_bld_trg_cpu)) \
502	$($(target)_SOURCES.$(BUILD_TYPE)) \
503	$($(target)_SOURCES) \
504	), $(eval $(value def_tools_sdks_target_source)))
505	endef
506
507	bld_trg := $(BUILD_TARGET)
508	bld_trg_arch := $(BUILD_TARGET_ARCH)
509	bld_trg_cpu := $(BUILD_TARGET_CPU)
510	$(foreach target, $(_ALL_BUILD_TARGET_TARGETS), $(eval $(value def_tools_sdks_target)))
511	$(foreach target, $(_ALL_SRCNAME_TARGETS), $(eval $(value def_tools_srcname_target)))
512
513	bld_trg := $(BUILD_PLATFORM)
514	bld_trg_arch := $(BUILD_PLATFORM_ARCH)
515	bld_trg_cpu := $(BUILD_PLATFORM_CPU)
516	$(foreach target, $(_ALL_BUILD_PLATFORM_TARGETS), $(eval $(value def_tools_sdks_target)))
517
518
519	# include TOOLS
520	define def_tools_include
521	ifndef TOOL_$(tool)
522	TOOL_$(tool)_KMK_FILE := $(firstword $(foreach path, $(TOOL_PATHS) $(PATH_KBUILD)/tools, $(wildcard $(path)/$(tool).kmk)))
523	ifeq ($(TOOL_$(tool)_KMK_FILE),)
524	$(error kBuild: Cannot find include file for the tool '$(tool)'! Searched: $(TOOL_PATHS) $(PATH_KBUILD)/tools)
525	endif
526	include $(TOOL_$(tool)_KMK_FILE)
527	ifndef TOOL_$(tool)
528	$(warning kBuild: TOOL_$(tool) was not by $(TOOL_$(tool)_KMK_FILE)!)
529	endif
530	endif
531	endef
532
533	_TOOLS := $(sort $(_TOOLS))
534	$(foreach tool, $(_TOOLS), $(eval $(value def_tools_include)))
535
536
537	# include SDKS
538	define def_sdks_include_one
539	ifndef SDK_$(sdk)
540	SDK_$(sdk)_KMK_FILE := $(firstword $(foreach path, $(SDK_PATHS) $(PATH_KBUILD)/sdks, $(wildcard $(path)/$(sdk).kmk)))
541	ifeq ($(SDK_$(sdk)_KMK_FILE),)
542	$(error kBuild: Cannot find include file for the SDK '$(sdk)'! Searched: $(SDK_PATHS) $(PATH_KBUILD)/sdks)
543	endif
544	include $(SDK_$(sdk)_KMK_FILE)
545	ifndef SDK_$(sdk)
546	$(warning kBuild: SDK_$(sdk) was not defined by $(SDK_$(sdk)_KMK_FILE)!)
547	endif
548	endif
549	endef
550
551	_SDKS := $(sort $(_SDKS))
552	$(foreach sdk, $(_SDKS), $(eval $(value def_sdks_include_one)))
553
554
555
556	#
557	#
558	# Target lists - Pass 1
559	#
560	# This pass is for defining variables that might be referenced in
561	# properties of other targets.
562	#
563	#
564
565	# Don't do anything for fetch targets (yet).
566
567	##
568	# Link prolog for Pass 1.
569	#
570	# @param $(target) Normalized target name.
571	# @param $(EXT) EXE,DLL,SYS,LIB.
572	# @param $(EXTPRE) HOST or nothing.
573	# @param $(definst) The default _INST value.
574	# @param $(tool_prefix) LD or AR.
575	# @param $(bld_trg_base_var) TARGET or PLATFORM.
576	define def_pass1_link_common
577
578	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
579	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_$(bld_trg_base_var)))
580	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_$(bld_trg_base_var)_ARCH))
581	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_$(bld_trg_base_var)_CPU))
582
583	tool := $(call _TARGET_TOOL,$(target),$(tool_prefix))
584	name := $(firstword\
585	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
586	$($(target)_NAME.$(bld_trg_arch))\
587	$($(target)_NAME.$(bld_trg))\
588	$($(target)_NAME.$(bld_type))\
589	$($(target)_NAME)\
590	$(target))
591	outbase := $(call TARGET_BASE,$(name),$(target))
592	ifndef PATH_$(target)
593	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
594	else ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
595	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
596	endif
597	ifeq ($(tool_prefix),AR) ## @todo fix this mess!
598	suff := $(firstword\
599	$($(target)_$(EXT)SUFF.$(bld_trg).$(bld_trg_arch))\
600	$($(target)_$(EXT)SUFF.$(bld_trg))\
601	$($(target)_$(EXT)SUFF)\
602	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF.$(bld_trg).$(bld_trg_arch))\
603	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF.$(bld_trg))\
604	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF)\
605	$(SUFF_LIB))
606	else
607	suff := $(firstword \
608	$($(target)_$(EXT)SUFF) \
609	$($(target)_$(EXT)SUFF) \
610	$(TOOL_$(tool)_$(tool_prefix)$(EXT)SUFF) \
611	$($(EXTPRE)SUFF_$(EXT)))
612	endif
613	out := $(outbase)$(suff)
614
615	# TARGET_*
616	TARGET_$(target) := $(out)
617
618	# INSTARGET_*
619	ifndef $(target)_NOINST
620	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
621	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
622
623	else # NOINST
624	INSTARGET_$(target) :=
625	endif # NOINST
626
627	endef
628
629
630	#
631	# BLDPROGS (Pass 1)
632	#
633	define def_pass1_bldprog
634	# set NOINST if not forced installation before doing the usual stuff.
635	ifndef $(target)_INST
636	$(target)_NOINST := 1
637	endif
638	$(eval $(value def_pass1_link_common))
639	endef
640
641	EXT := EXE
642	EXTPRE := HOST
643	definst := $(PATH_BIN)
644	tool_prefix := LD
645	bld_trg_base_var := PLATFORM
646	$(foreach target, $(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)), \
647	$(eval $(value def_pass1_bldprog)))
648
649
650	#
651	# LIBRARIES (Pass 1)
652	#
653	EXT := LIB
654	EXTPRE :=
655	definst := $(PATH_LIB)
656	tool_prefix := AR
657	bld_trg_base_var := TARGET
658	$(foreach target, $(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
659	$(eval $(value def_pass1_link_common)))
660
661
662	#
663	# DLLS (Pass 1)
664	#
665	EXT := DLL
666	EXTPRE :=
667	definst := $(PATH_DLL)
668	tool_prefix := LD
669	bld_trg_base_var := TARGET
670	$(foreach target, $(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
671	$(eval $(value def_pass1_link_common)))
672
673
674	#
675	# IMPORT LIBRARIES (Pass 1)
676	#
677	# - On OS/2 and windows these are libraries.
678	# - On other platforms they are fake DLLs.
679	#
680	ifeq ($(filter-out nt os2 win win64 win32,$(BUILD_TARGET)),)
681	EXT := LIB
682	EXTPRE :=
683	definst := $(PATH_LIB)
684	tool_prefix := AR
685	bld_trg_base_var := TARGET
686	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
687	$(eval $(value def_pass1_lib)))
688	else
689	EXT := DLL
690	EXTPRE :=
691	definst := $(PATH_DLL)
692	tool_prefix := LD
693	bld_trg_base_var := TARGET
694	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
695	$(eval $(value def_pass1_link_common)))
696	endif
697
698
699	#
700	# PROGRAMS (Pass 1)
701	#
702	EXT := EXE
703	EXTPRE :=
704	definst := $(PATH_BIN)
705	tool_prefix := LD
706	bld_trg_base_var := TARGET
707	$(foreach target, $(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
708	$(eval $(value def_pass1_link_common)))
709
710
711	#
712	# SYSMODS (Pass 1)
713	#
714	EXT := SYS
715	EXTPRE :=
716	definst := $(PATH_SYS)
717	tool_prefix := LD
718	bld_trg_base_var := TARGET
719	$(foreach target, $(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
720	$(eval $(value def_pass1_link_common)))
721
722
723	#
724	# INSTALLS (Pass 1)
725	# Note! INSTARGET_* for INSTALLS aren't available until later.
726	#
727	define def_pass1_install
728	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
729	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))
730	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_TARGET_ARCH))
731	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_TARGET_CPU))
732	# TARGET_*
733	TARGET_$(target) := $(PATH_TARGET)/$(target).ins
734	# INSTARGET_ later.
735	endef
736	$(foreach target, $(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
737	$(eval $(value def_pass1_install)))
738
739
740
741
742	#
743	#
744	# Target lists - Pass 2
745	#
746	#
747
748
749	## @page pg_fetches Fetching Tools, Sources and Similar.
750	#
751	# The targets listed in the the FETCHES target list have the following attributes:
752	# SOURCES
753	# INST
754	# FETCHTOOL
755	# FETCHFLAGS
756	# FETCHDIR
757	# UNPACKTOOL
758	# UNPACKFLAGS
759	#
760	# As usual the target name is an alias for 'creating' the target. Other
761	# aliases are:
762	# pass_fetches
763	# fetch
764	# unfetch
765	# download
766	# unpack
767	#
768	# @remark
769	#
770	# This is a little bit complex because we must guarantee that if a source file
771	# changes only sligtly we must refetch it and to a proper unpacking of it. It
772	# is also a desire that fetched archives and unpacked files can be deleted to
773	# save space.
774	#
775	# Thus, we must be able to cleanup what we've unpacked should any of the
776	# sources be removed. We do this by maintaining a file listing the files
777	# and directories that was unpacked. This operation is named 'unfetch'.
778	#
779	# We make use of the SIZE and MD5 attributes for each of the sources to
780	# create a digest that is stored in the primary target file. Subsequent
781	# runswill compare their digest with it to decide if a refetch is required.
782	# When a refetch is found necessary, an 'unfetch' is performed first to
783	# clean out old files and directores. Note even changes in source order
784	# will cause a refetch due to the way the digest is constructed and
785	# evaluated.
786	#
787	# By not depending directly on the archives (nor on any unpacked files)
788	# but on a goal made up from the archive name, size and md5, we allow
789	# the user to delete the archives. Naturally, this means we'll have to
790	# check and fetch missing archives before attempting to unpack them.
791	#
792	# @remark
793	#
794	# This feature will NOT work correctly with vanilla GNU make becuase
795	# it makes use of includedep to avoid too many unnecessary files.
796	#
797	# @todo
798	# 1. Port md5sum or some equivalent tool and include it in kBuild.
799	# 2. Download corruption / continuation.
800	# 3. It's quite possible that there is one too many indirect dependency now...
801	#
802
803	## @todo move this!
804	MD5SUM := md5sum
805
806	## generates the fetch rule
807	define def_fetch_src_fetch_rule
808	# Indirect goal for downloading something.
809	.PRECIOUS: $(out)
810	$(out) $($(target)_$(srcname)_FETCH_OUTPUT_): \| $($(target)_$(srcname)_FETCH_DEPORD_)
811	$$(call MSG_FETCH_DL,$(target),$(source),$(out))
812	@## @todo do fancy stuff like download continuation.
813	$$(QUIET)$$(RM) -f $(out) $(out).md5
814	$($(target)_$(srcname)_FETCH_CMDS_)
815	$$(QUIET2)$(if $(md5),$$(APPEND) $(out).md5 "$(md5) *$(out)")
816	$$(QUIET)$(if $(md5),$$(MD5SUM) -c $(out).md5)
817
818
819
820	# Intermediate goal for making sure the md5 and size matches. it will (re) fetch the archive if necessary.
821	$(out).checked_$(md5)_$(size): $($(target)_$(srcname)_FETCH_DEPEND_) \| $($(target)_$(srcname)_FETCH_DEPORD_)
822	$$(call MSG_FETCH_CHK,$(target),$(source),$(out))
823	$$(QUIET)$$(RM) -f $$@ $(out).md5
824	@# creates the .md5 we pass to md5sum.
825	$$(QUIET2)$(if $(md5),$$(APPEND) $(out).md5 "$(md5) *$(out)")
826	@# (re)fetch the file if it doesn't exist or if it doesn't matches the md5.
827	@## @todo do fancy stuff like download continuation.
828	$$(QUIET)( test -f $(out) && $(if $(md5),$$(MD5SUM) -c $(out).md5, true) ) \
829	\|\| ( $$(RM_EXT) -f $(out) \
830	&& $$(MAKE) $(out) -f $(MAKEFILE) --no-print-directory )
831	$$(QUIET2)$$(APPEND) $$@
832
833	_TARGET_$(target)_FETCHED += $(out) $(out).checked_$(md5)_$(size)
834
835	# Just a little precaution.
836	.NOTPARALLEL: $(out) $(out).checked_$(md5)_$(size)
837
838	endef
839
840	## generates the unpack rule
841	define def_fetch_src_unpack_rule
842	# This is the unpack rule. it has an order-only dependency on the download check.
843	$(out) $($(target)_$(srcname)_UNPACK_OUTPUT_): $($(target)_$(srcname)_UNPACK_DEPEND_) \
844	\| $($(target)_$(srcname)_UNPACK_DEPORD_) $(archive).checked_$(md5)_$(size)
845	$$(call MSG_FETCH_UP,$(target),$(archive),$(inst))
846	$$(QUIET)$$(RM) -f $(out)
847	@# if the source archive doesn't exist fetch it (can have been deleted to save space).
848	$$(QUIET)test -f $(archive) \
849	\|\| ( $$(RM_EXT) -f $(archive).checked_$(md5)_$(size) \
850	&& $$(MAKE) $(archive).checked_$(md5)_$(size) -f $(MAKEFILE) --no-print-directory )
851	$($(target)_$(srcname)_UNPACK_CMDS_)
852	$$(QUIET2)$$(APPEND) $(out) $(notdir $(archive).checked_$(md5)_$(size))
853	$$(QUIET2)$$(APPEND) $(out) $(notdir $(out))
854
855	$(eval _TARGET_$(target)_UNPACKED += $(out))
856	_TARGET_$(target)_DIGEST := $(_TARGET_$(target)_DIGEST)-$(srcname)_$(md5)_$(size)
857
858	.NOTPARALLEL: $(out)
859
860	endef
861
862	## Processes a fetch source
863	#
864	define def_fetch_src
865	#$ (warning dbg: def_fetch_src: source='$(source)' target='$(target)')
866
867	# common
868	srcname := $(notdir $(source))
869	inst := $(firstword \
870	$($(target)_$(source)_INST)\
871	$($(target)_$(srcname)_INST)\
872	$($(source)_INST)\
873	$($(srcname)_INST)\
874	$($(target)_INST)\
875	)
876	ifneq ($(patsubst %/,ok,$(inst)),ok)
877	$(error kBuild: Bad or missing INST property for source '$(source)' in target '$(target)': $(inst))
878	endif
879	INSTARGET_$(target)_$(srcname) := $(inst)
880	fetchdir := $(firstword \
881	$($(target)_$(source)_FETCHDIR)\
882	$($(target)_$(srcname)_FETCHDIR)\
883	$($(source)_FETCHDIR)\
884	$($(srcname)_FETCHDIR)\
885	$($(target)_FETCHDIR)\
886	$(FETCHDIR)\
887	$(PATH_TARGET)\
888	)
889	deps := \
890	$($(target)_$(source)_DEPS)\
891	$($(target)_$(srcname)_DEPS)\
892	$($(source)_DEPS)\
893	$($(srcname)_DEPS)\
894	$($(target)_DEPS)
895	orderdeps := \
896	$($(target)_$(source)_ORDERDEPS)\
897	$($(target)_$(srcname)_ORDERDEPS)\
898	$($(source)_ORDERDEPS)\
899	$($(srcname)_ORDERDEPS)\
900	$($(target)_ORDERDEPS)
901	md5 := $(firstword \
902	$($(target)_$(source)_MD5)\
903	$($(target)_$(srcname)_MD5)\
904	$($(source)_MD5)\
905	$($(srcname)_MD5)\
906	$($(target)_MD5)\
907	)
908	size := $(firstword \
909	$($(target)_$(source)_SIZE)\
910	$($(target)_$(srcname)_SIZE)\
911	$($(source)_SIZE)\
912	$($(srcname)_SIZE)\
913	$($(target)_SIZE)\
914	)
915	dep := # not legal for fetch and unpack tools
916
917
918	#
919	# The fetching.
920	#
921	out := $(fetchdir)/$(srcname)
922	archive := $(out)
923	TARGET_$(target)_$(srcname) := $(out)
924	dirdep := $(call DIRDEP,$(fetchdir))
925	tool := $(firstword \
926	$($(target)_$(source)_FETCHTOOL)\
927	$($(target)_$(srcname)_FETCHTOOL)\
928	$($(target)_$(source)_TOOL)\
929	$($(target)_$(srcname)_TOOL)\
930	$($(source)_FETCHTOOL)\
931	$($(srcname)_FETCHTOOL)\
932	$($(source)_TOOL)\
933	$($(srcname)_TOOL)\
934	$($(target)_FETCHTOOL)\
935	$($(target)_TOOL)\
936	)
937	flags :=\
938	$(TOOL_$(tool)_FETCHFLAGS)\
939	$(FETCHFLAGS)\
940	$($(target)_FETCHFLAGS)\
941	$($(srcname)_FETCHFLAGS)\
942	$($(source)_FETCHFLAGS)\
943	$($(target)_$(srcname)_FETCHFLAGS)\
944	$($(target)_$(source)_FETCHFLAGS)
945
946	#$ (warning dbg: target=$(target) source=$(source) $(srcname)=$(srcname) tool=$(tool) out=$(out) flags=$(flags) dirdep=$(dirdep) fetchdir=$(fetchdir) md5=$(md5) size=$(size))
947
948	ifndef TOOL_$(tool)_FETCH_CMDS
949	$(warning kBuild: tools: \
950	1 $($(target)_$(source)_FETCHTOOL)\
951	2 $($(target)_$(srcname)_FETCHTOOL)\
952	3 $($(target)_$(source)_TOOL)\
953	4 $($(target)_$(srcname)_TOOL)\
954	5 $($(source)_FETCHTOOL)\
955	6 $($(srcname)_FETCHTOOL)\
956	7 $($(source)_TOOL)\
957	8 $($(srcname)_TOOL)\
958	9 $($(target)_FETCHTOOL)\
959	10 $($(target)_TOOL) )
960	$(error kBuild: TOOL_$(tool)_FETCH_CMDS is not defined. source=$(source) target=$(target) )
961	endif
962
963	# call the tool
964	$(target)_$(srcname)_FETCH_CMDS_ := $(TOOL_$(tool)_FETCH_CMDS)
965	$(target)_$(srcname)_FETCH_OUTPUT_ := $(TOOL_$(tool)_FETCH_OUTPUT)
966	$(target)_$(srcname)_FETCH_DEPEND_ := $(TOOL_$(tool)_FETCH_DEPEND) $(deps)
967	$(target)_$(srcname)_FETCH_DEPORD_ := $(TOOL_$(tool)_FETCH_DEPORD) $(dirdep) $(orderdeps)
968
969	# generate the fetch rule.
970	$(eval $(def_fetch_src_fetch_rule))
971
972
973	#
974	# The unpacking / installing.
975	#
976	out := $(inst)_kBuild_$(target)_$(srcname)_unpacked.lst
977	dirdep := $(call DIRDEP,$(inst))
978	tool := $(firstword \
979	$($(target)_$(source)_UNPACKTOOL)\
980	$($(target)_$(srcname)_UNPACKTOOL)\
981	$($(target)_$(source)_TOOL)\
982	$($(target)_$(srcname)_TOOL)\
983	$($(source)_UNPACKTOOL)\
984	$($(srcname)_UNPACKTOOL)\
985	$($(source)_TOOL)\
986	$($(srcname)_TOOL)\
987	$($(target)_UNPACKTOOL)\
988	$($(target)_TOOL) \
989	)
990	ifeq ($(tool),)
991	tool := $(toupper $(subst .,,$(suffix $(subst tar.,TAR,$(srcname)))))
992	$(eval $(value def_tools_include))
993	endif
994	flags :=\
995	$(TOOL_$(tool)_UNPACKFLAGS)\
996	$(UNPACKFLAGS)\
997	$($(target)_UNPACKFLAGS)\
998	$($(srcname)_UNPACKFLAGS)\
999	$($(source)_UNPACKFLAGS)\
1000	$($(target)_$(srcname)_UNPACKFLAGS)\
1001	$($(target)_$(source)_UNPACKFLAGS)
1002
1003	#$ (warning dbg: target=$(target) source=$(source) $(srcname)=$(srcname) tool=$(tool) out=$(out) flags=$(flags) dirdep=$(dirdep) inst=$(inst) md5=$(md5) size=$(size))
1004	ifndef TOOL_$(tool)_UNPACK_CMDS
1005	$(warning kBuild: tools: \
1006	1 $($(target)_$(source)_UNPACKTOOL)\
1007	2 $($(target)_$(srcname)_UNPACKTOOL)\
1008	3 $($(target)_$(source)_TOOL)\
1009	4 $($(target)_$(srcname)_TOOL)\
1010	5 $($(source)_UNPACKTOOL)\
1011	6 $($(srcname)_UNPACKTOOL)\
1012	7 $($(source)_TOOL)\
1013	8 $($(srcname)_TOOL)\
1014	9 $($(target)_UNPACKTOOL)\
1015	10 $($(target)_TOOL) \
1016	11 $(toupper $(subst tar.,TAR,$(ext $(srcname)))) \
1017	)
1018	$(error kBuild: TOOL_$(tool)_UNPACK_CMDS is not defined. source=$(source) target=$(target) )
1019	endif
1020
1021	# call the tool
1022	$(target)_$(srcname)_UNPACK_CMDS_ := $(TOOL_$(tool)_UNPACK_CMDS)
1023	$(target)_$(srcname)_UNPACK_OUTPUT_ := $(TOOL_$(tool)_UNPACK_OUTPUT)
1024	$(target)_$(srcname)_UNPACK_DEPEND_ := $(TOOL_$(tool)_UNPACK_DEPEND) $(deps)
1025	$(target)_$(srcname)_UNPACK_DEPORD_ := $(TOOL_$(tool)_UNPACK_DEPORD) $(dirdep) $(orderdeps)
1026
1027	# generate the fetch rule.
1028	$(eval $(def_fetch_src_unpack_rule))
1029
1030	_DIRS += $(inst) $(fetchdir)
1031
1032	endef
1033
1034
1035	##
1036	# Define the target level rules for a fetch.
1037	# @param target
1038	# @param out
1039	# @param inst
1040	# @param _TARGET_$(target)_UNPACKED
1041	# @param _TARGET_$(target)_DIGEST
1042	# @param bld_trg
1043	# @param bld_trg_arch
1044	define def_fetch_rules
1045
1046	$(out).lst: $(_TARGET_$(target)_UNPACKED) \| $(call DIRDEP,$(inst))
1047	$$(call MSG_FETCH_OK,$(target))
1048	$$(QUIET)$$(RM) -f $$@ $$@.tmp
1049	$$(QUIET2)$$(APPEND) $$@.tmp "$(notdir $(out))"
1050	$$(QUIET)$(if $(_TARGET_$(target)_UNPACKED),$$(CAT_EXT) $(_TARGET_$(target)_UNPACKED) >> $$@.tmp)
1051	$$(QUIET)$$(MV) -f $$@.tmp $$@
1052
1053	$(out)_unfetched:
1054	$$(call MSG_UNFETCH,$(target))
1055	$$(QUIET)$$(RM) -f $$(addprefix $(inst),$$(shell $$(CAT_EXT) $(out).lst 2> /dev/null \| $$(SED) -e '/\/$$$$/d'))
1056	$$(QUIET)$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $$(dir $$@) \
1057	$$(addprefix $(inst),$$(sort $$(dir $$(shell $$(CAT_EXT) $(out).lst 2> /dev/null))))
1058	$$(QUIET)$$(RM) -f $(out).lst $(out)
1059	$$(QUIET)$$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $$(dir $$@)
1060
1061	$(out): $(comp-vars _TARGET_$(target)_DIGEST_PREV,_TARGET_$(target)_DIGEST,FORCE) \| $(call DIRDEP,$(inst))
1062	$$(QUIET)$$(RM) -f $$@
1063	$$(if $$(_TARGET_$(target)_DIGEST),$$(if $$(wildcard $(out).lst)\
1064	,$$(call MSG_REFETCH,$(target)),$$(call MSG_FETCH,$(target))),$$(call MSG_UNFETCH,$(target)))
1065	$$(QUIET)$$(if $$(wildcard $(out).lst ),$$(MAKE) -f $(MAKEFILE) --no-print-directory $(out)_unfetched)
1066	$$(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 $$@))
1067	$$(QUIET2)$$(if $$(_TARGET_$(target)_DIGEST),$$(APPEND) $$@ "_TARGET_$(target)_DIGEST_PREV := $(_TARGET_$(target)_DIGEST)")
1068
1069	.NOTPARALLEL: $(out).lst $(out)_unfetched $(out)
1070
1071	endef
1072
1073
1074	##
1075	# Deal with one fetch target.
1076	# @param target
1077	# @param bld_trg
1078	# @param bld_trg_arch
1079	define def_fetch
1080	# common
1081	INSTARGET_$(target) := $($(target)_INST)
1082	ifneq ($(patsubst %/,ok,$(INSTARGET_$(target))),ok)
1083	$(error kBuild: Bad or missing INST property for target '$(target)'. \
1084	$(target)_INST='$($(target)_INST)' ($(origin $(target)_INST)))
1085	endif
1086	_TARGET_$(target)_FETCHED :=
1087	_TARGET_$(target)_UNPACKED :=
1088	_TARGET_$(target)_DIGEST :=
1089
1090	# The 'sources'.
1091	#$ (warning dbg fetch: target=$(target) sources=$($(target)_SOURCES) $($(target)_SOURCES.$(BUILD_TYPE)) $($(target)_SOURCES.$(BUILD_TARGET)) $($(target)_SOURCES.$(BUILD_TARGET_ARCH)) $($(target)_SOURCES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)))
1092	$(foreach source,$($(target)_SOURCES) $($(target)_SOURCES.$(BUILD_TYPE)) $($(target)_SOURCES.$(BUILD_TARGET)) $($(target)_SOURCES.$(BUILD_TARGET_ARCH)) $($(target)_SOURCES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),\
1093	$(eval $(value def_fetch_src)))
1094
1095	# The target.
1096	inst := $(INSTARGET_$(target))
1097	out := $(inst)_kBuild_fetch_$(target)
1098
1099	$(eval includedep $(out))
1100
1101	$(eval $(def_fetch_rules))
1102
1103	# Define the aliases here (doesn't work if defined in def_fetch_rules, just like includedep).
1104	$(target): $(out)
1105	$(target)_unfetch: $(out)_unfetched
1106
1107	_FETCHES += $(out)
1108	_DOWNLOADS += $(_TARGET_$(target)_FETCHED)
1109	_UNPACKS += $(_TARGET_$(target)_UNPACKED)
1110	_UNFETCHES += $(out)_unfetched
1111	_DIRS += $(inst)
1112
1113	endef
1114
1115	# Walk the FETCH target lists.
1116	bld_trg := $(BUILD_TARGET)
1117	bld_trg_arch := $(BUILD_TARGET_ARCH)
1118	$(foreach target, $(FETCHES) $(FETCHES.$(BUILD_TARGET)) $(FETCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
1119	$(eval $(value def_fetch)))
1120
1121	# some aliases.
1122	download: $(_DOWNLOADS)
1123	unpack: $(_UNPACKS)
1124	fetch: $(_FETCHES)
1125	unfetch: $(_UNFETCHES)
1126
1127
1128
1129	##
1130	## Patching.
1131	##
1132	##
1133	#define def_patch_src
1134	#
1135	#endef
1136	#
1137	#
1138	## Deal with one patch target.
1139	#define def_patch
1140	#
1141	#$(foreach source,$($(target)_SOURCES) $($(target)_SOURCES.$(BUILD_TYPE)) $($(target)_SOURCES.$(BUILD_TARGET)) $($(target)_SOURCES.$(BUILD_TARGET_ARCH)) $($(target)_SOURCES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),\
1142	# $(eval $(value def_patch_src)))
1143	#
1144	#_PATCHES +=
1145	#endef
1146	#
1147	#$(foreach target, $(PATCHES) $(PATCHES.$(BUILD_TARGET)) $(PATCHES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
1148	# $(eval $(value def_patch)))
1149	#
1150
1151
1152	#
1153	# Object processing.
1154	#
1155
1156	## wrapper the compile command dependency check.
1157	ifndef NO_COMPILE_CMDS_DEPS
1158	_DEP_COMPILE_CMDS = $(comp-cmds $(target)_$(source)_CMDS_PREV_,$(target)_$(source)_CMDS_,FORCE)
1159	else
1160	_DEP_COMPILE_CMDS =
1161	endif
1162
1163	## Temporary macro for testing the new multi target rules.
1164	ifdef USE_MULTI_TARGET
1165	_M_PLUSS=+
1166	else
1167	_M_PLUSS=
1168	endif
1169
1170	## Generates the rules for building a specific object, and the aliases
1171	# for building a source file.
1172	# @param $(obj) The object file.
1173	define def_target_source_rule
1174	$(obj) $(_M_PLUSS) $($(target)_$(source)_OUTPUT_): \
1175	$($(target)_$(source)_DEPEND_) \
1176	$(_DEP_COMPILE_CMDS) \
1177	\| \
1178	$($(target)_$(source)_DEPORD_)
1179	$$(call MSG_COMPILE,$(target),$(source),$$@,$(type))
1180	$$(QUIET)$$(RM) -f $(dep) $(obj) $($(target)_$(source)_OUTPUT_)
1181
1182	$($(target)_$(source)_CMDS_)
1183
1184	ifndef NO_COMPILE_CMDS_DEPS
1185	$$(QUIET2)$$(APPEND) "$(dep)"
1186	$$(QUIET2)$$(APPEND) "$(dep)" 'define $(target)_$(source)_CMDS_PREV_'
1187	ifeq ($(filter append-dash-n,$(KMK_FEATURES)),append-dash-n)
1188	$$(QUIET2)$$(APPEND) -v "$(dep)" '$(target)_$(source)_CMDS_'
1189	else
1190	$$(QUIET2)$$(APPEND) "$(dep)" '$(subst $(NL),'$(NL)$(TAB)@$(APPEND) "$(dep)" ',$($(target)_$(source)_CMDS_))'
1191	endif
1192	$$(QUIET2)$$(APPEND) "$(dep)" 'endef'
1193	endif
1194
1195	$(basename $(notdir $(obj))).o: $(obj)
1196	$(basename $(notdir $(obj))).obj: $(obj)
1197	endef
1198
1199
1200	## wrapper the link command dependency check.
1201	ifndef NO_COMPILE_CMDS_DEPS
1202	_DEP_LINK_CMDS = $(comp-cmds $(target)_CMDS_PREV_,$(target)_CMDS_,FORCE)
1203	else
1204	_DEP_LINK_CMDS =
1205	endif
1206
1207	## Generate the link rule for a target.
1208	# @param $(target) The normalized target name.
1209	# @param $(dirdep) Directories we depend upon begin created before linking.
1210	# @param $(dep) The name of the dependency file.
1211	# @param $(out)
1212	# @param $($(target)_OUTPUT_) Output files from the link.
1213	# @param $($(target)_DEPEND_) Dependencies.
1214	# @param $($(target)_DEPORD_) Dependencies which should only affect build order.
1215	# @param $($(target)_CMDS_) The link commands.
1216	# @param $($(target)_CMDS_PREV_) The link commands from the previous run.
1217	define def_link_rule
1218	$(out) $(_M_PLUSS) $($(target)_OUTPUT_): \
1219	$($(target)_DEPEND_) \
1220	$(_DEP_LINK_CMDS) \
1221	\| \
1222	$($(target)_DEPORD_)
1223	$$(call MSG_LINK,$(target),$$@,$(tool_do))
1224	$$(QUIET)$$(RM) -f $(dep) $(out) $($(target)_OUTPUT_)
1225
1226	$($(target)_CMDS_)
1227
1228	ifndef NO_LINK_CMDS_DEPS
1229	$$(QUIET2)$$(APPEND) "$(dep)" 'define $(target)_CMDS_PREV_'
1230	ifeq ($(filter append-dash-n,$(KMK_FEATURES)),append-dash-n)
1231	$$(QUIET2)$$(APPEND) -v "$(dep)" '$(target)_CMDS_'
1232	else
1233	$$(QUIET2)$$(APPEND) "$(dep)" '$(subst $(NL),'$(NL)$(TAB)@$(APPEND) "$(dep)" ',$($(target)_CMDS_))'
1234	endif
1235	$$(QUIET2)$$(APPEND) "$(dep)" 'endef'
1236	endif
1237
1238	$(basename $(notdir $(out))): $(out)
1239
1240	endef
1241
1242
1243	## Generate the link & lib install rule
1244	# @param $(target) Normalized target name.
1245	# @param $(out) The build target.
1246	# @param $(INSTARGET_$(target)) The installation targets.
1247	# @param $(mode) The file mode (optional)
1248	define def_link_install_rule
1249	$(INSTARGET_$(target)) : $(out) \| $(call DIRDEP,$(dir $(INSTARGET_$(target))))
1250	$$(call MSG_INST_TRG,$(target),$(out),$$@)
1251	$$(QUIET)$$(INSTALL) $$(if $(mode),-m $(mode)) $(out) $$@
1252
1253	ifdef KBUILD_DO_AUTO_INSTALL
1254	$(basename $(notdir $(out))): $(INSTARGET_$(target))
1255	endif
1256	endef
1257
1258
1259	## Generic macro for processing C, C++ and Assembly sources.
1260	# @param $(target) Normalized target name.
1261	# @param $(source) Source file name.
1262	# @param $(type) Source type. {C,CXX,AS}
1263	# @param bld_type Build type.
1264	# @param bld_trg Build target.
1265	# @param bld_trg_arch Build target arch.
1266	# @param bld_trg_cpu Build target cpu.
1267	def_target_source_c_cpp_asm_rc_new = $(kb-src-one )
1268	ifdef KMK_VERSION
1269	def_target_source_c_cpp_asm_rc_var = def_target_source_c_cpp_asm_rc_new
1270	else
1271	def_target_source_c_cpp_asm_rc_var = def_target_source_c_cpp_asm_rc_old
1272	endif
1273
1274	## Generic macro for processing all target sources.
1275	# @param $(target) Normalized target name.
1276	# @param $(defpath)
1277	# @param much-more...
1278	define def_target_sources
1279	#$ (warning def_target_sources)
1280	# C sources
1281	type := C
1282	$(foreach source, $(filter %.c , $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1283	,$(eval $(value $(def_target_source_c_cpp_asm_rc_var))) )
1284
1285	# C++ sources
1286	type := CXX
1287	$(foreach source, $(filter %.cpp %.cxx %.xx, $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1288	,$(eval $(value $(def_target_source_c_cpp_asm_rc_var))) )
1289
1290	# ASM sources
1291	type := AS
1292	$(foreach source, $(filter %.asm %.s %.S , $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1293	,$(eval $(value $(def_target_source_c_cpp_asm_rc_var))) )
1294
1295	# Resource sources
1296	type := RC
1297	$(foreach source, $(filter %.rc , $($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)))\
1298	,$(eval $(value $(def_target_source_c_cpp_asm_rc_var))) )
1299
1300	endef
1301
1302
1303
1304	## Generic macro for generating the install rule(s) for a target
1305	# and update the globals with default out.
1306	#
1307	# @param $(target) Normalized target name.
1308	# @param $(out) The output file.
1309	# @param $(definst) The default _INST value.
1310	# @param $(typevar) The name of the variable with all the root targets of its type.
1311	# @remark Only library uses this now.
1312	define def_target_install_pluss
1313	ifndef $(target)_NOINST
1314	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
1315	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
1316
1317	$(eval $(def_link_install_rule))
1318
1319	_INSTALLS_FILES += $(INSTARGET_$(target))
1320
1321	ifdef KBUILD_DO_AUTO_INSTALL
1322	$(typevar) += $(INSTARGET_$(target))
1323	else
1324	$(typevar) += $(out)
1325	endif
1326	else # _NOINST
1327	$(typevar) += $(out)
1328	endif
1329
1330	_OUT_FILES += $($(target)_OUTPUT_) $(out)
1331	_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))
1332	_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))
1333	_OBJS += $($(target)_OBJS_)
1334
1335	endef
1336
1337
1338
1339	#
1340	# LIBRARIES
1341	#
1342
1343	## Library (one).
1344	# @param $(target) Normalized library (target) name.
1345	define def_lib
1346	# library basics
1347	## @todo prefix
1348	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
1349	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))
1350	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_TARGET_ARCH))
1351	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_TARGET_CPU))
1352	tool := $(call _TARGET_TOOL,$(target),AR)
1353	ifeq ($(tool),)
1354	$(error kBuild: Library target $(target) does not have a tool defined!)
1355	endif
1356	name := $(firstword\
1357	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1358	$($(target)_NAME.$(bld_trg_arch))\
1359	$($(target)_NAME.$(bld_trg))\
1360	$($(target)_NAME.$(bld_type))\
1361	$($(target)_NAME)\
1362	$(target))
1363	outbase := $(call TARGET_BASE,$(name),$(target))
1364	ifndef PATH_$(target)
1365	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
1366	else
1367	ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
1368	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
1369	endif
1370	endif
1371	suff := $(firstword\
1372	$($(target)_LIBSUFF.$(bld_trg).$(bld_trg_arch))\
1373	$($(target)_LIBSUFF.$(bld_trg))\
1374	$($(target)_LIBSUFF)\
1375	$(TOOL_$(tool)_ARLIBSUFF.$(bld_trg).$(bld_trg_arch))\
1376	$(TOOL_$(tool)_ARLIBSUFF.$(bld_trg))\
1377	$(TOOL_$(tool)_ARLIBSUFF)\
1378	$(SUFF_LIB))
1379	out := $(outbase)$(suff)
1380	TARGET_$(target) := $(out)
1381	$(target)_OBJS_ :=
1382	defpath := $($(target)_PATH)
1383
1384	# source -> object
1385	$(eval $(value def_target_sources))
1386
1387	# library linking
1388	tool := $(call _TARGET_TOOL,$(target),AR)
1389	name := $(firstword\
1390	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1391	$($(target)_NAME.$(bld_trg_arch))\
1392	$($(target)_NAME.$(bld_trg))\
1393	$($(target)_NAME.$(bld_type))\
1394	$($(target)_NAME)\
1395	$(target))
1396	outbase := $(call TARGET_BASE,$(name),$(target))
1397	flags :=\
1398	$(TOOL_$(tool)_ARFLAGS)\
1399	$(TOOL_$(tool)_ARFLAGS.$(bld_type))\
1400	$(ARFLAGS)\
1401	$(ARFLAGS.$(bld_type))\
1402	$($(target)_ARFLAGS)\
1403	$($(target)_ARFLAGS.$(bld_type)) \
1404	$($(target)_ARFLAGS.$(bld_trg)) \
1405	$($(target)_ARFLAGS.$(bld_trg_arch)) \
1406	$($(target)_ARFLAGS.$(bld_trg).$(bld_trg_arch)) \
1407	$($(target)_ARFLAGS.$(bld_trg_cpu))
1408	othersrc := $(filter-out %.c %.cpp %.cxx %.cc %.s %.S %.asm %.o %.obj,\
1409	$($(target)_SOURCES) \
1410	$($(target)_SOURCES.$(bld_trg)) \
1411	$($(target)_SOURCES.$(bld_trg_arch)) \
1412	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1413	$($(target)_SOURCES.$(bld_trg_cpu)) \
1414	$($(target)_SOURCES.$(bld_type)))
1415	objs = $(filter %.o %.obj, \
1416	$($(target)_SOURCES) \
1417	$($(target)_SOURCES.$(bld_trg)) \
1418	$($(target)_SOURCES.$(bld_trg_arch)) \
1419	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1420	$($(target)_SOURCES.$(bld_trg_cpu)) \
1421	$($(target)_SOURCES.$(bld_type))) \
1422	$($(target)_OBJS_)
1423	dirdep := $(call DIRDEP,$(dir $(out)))
1424	deps := $($(target)_DEPS)
1425	orderdeps := $($(target)_ORDERDEPS)
1426
1427	# Adjust paths if we got a default path.
1428	ifneq ($(defpath),)
1429	objs := $(call abspathex,$(objs),$(defpath))
1430	deps := $(call abspathex,$(deps),$(defpath))
1431	orderdeps := $(call abspathex,$(orderdeps),$(defpath))
1432	othersrc := $(call abspathex,$(othersrc),$(defpath))
1433	endif
1434
1435
1436	# Custom pre-link actions.
1437	ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1438	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1439	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1440	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1441	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_type)
1442	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_type))
1443	else ifdef $(target)_PRE_CMDS.$(bld_trg_arch)
1444	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg_arch))
1445	else ifdef $(target)_PRE_CMDS.$(bld_trg)
1446	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg))
1447	else ifdef $(target)_PRE_CMDS.$(bld_type)
1448	pre_cmds := $($(target)_PRE_CMDS.$(bld_type))
1449	else ifdef $(target)_PRE_CMDS
1450	pre_cmds := $($(target)_PRE_CMDS)
1451	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1452	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1453	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1454	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1455	else ifdef PRE_CMDS.$(bld_trg).$(bld_type)
1456	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_type))
1457	else ifdef PRE_CMDS.$(bld_trg_arch)
1458	pre_cmds := $(PRE_CMDS.$(bld_trg_arch))
1459	else ifdef PRE_CMDS.$(bld_trg)
1460	pre_cmds := $(PRE_CMDS.$(bld_trg))
1461	else ifdef PRE_CMDS.$(bld_type)
1462	pre_cmds := $(PRE_CMDS.$(bld_type))
1463	else
1464	pre_cmds := $(PRE_CMDS)
1465	endif
1466
1467	# Custom post-link actions.
1468	ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1469	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1470	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch)
1471	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch))
1472	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_type)
1473	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_type))
1474	else ifdef $(target)_POST_CMDS.$(bld_trg_arch)
1475	post_cmds := $($(target)_POST_CMDS.$(bld_trg_arch))
1476	else ifdef $(target)_POST_CMDS.$(bld_trg)
1477	post_cmds := $($(target)_POST_CMDS.$(bld_trg))
1478	else ifdef $(target)_POST_CMDS.$(bld_type)
1479	post_cmds := $($(target)_POST_CMDS.$(bld_type))
1480	else ifdef $(target)_POST_CMDS
1481	post_cmds := $($(target)_POST_CMDS)
1482	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1483	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1484	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch)
1485	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch))
1486	else ifdef POST_CMDS.$(bld_trg).$(bld_type)
1487	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_type))
1488	else ifdef POST_CMDS.$(bld_trg_arch)
1489	post_cmds := $(POST_CMDS.$(bld_trg_arch))
1490	else ifdef POST_CMDS.$(bld_trg)
1491	post_cmds := $(POST_CMDS.$(bld_trg))
1492	else ifdef POST_CMDS.$(bld_type)
1493	post_cmds := $(POST_CMDS.$(bld_type))
1494	else
1495	post_cmds := $(POST_CMDS)
1496	endif
1497
1498	# dependency file
1499	dep := $(out)$(SUFF_DEP)
1500	ifndef NO_LINK_CMDS_DEPS
1501	_DEPFILES_INCLUDED += $(dep)
1502	$(eval includedep $(dep))
1503	endif
1504
1505	# check that the tool is defined.
1506	ifndef TOOL_$(tool)_LINK_LIBRARY_CMDS
1507	$(warning kBuild: tools: \
1508	1 $($(target)_$(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
1509	2 $($(target)_$(source)TOOL.$(bld_trg)) \
1510	3 $($(target)_$(source)TOOL) \
1511	4 $($(target)_TOOL.$(bld_trg).$(bld_trg_arch)) \
1512	5 $($(target)_TOOL.$(bld_trg)) \
1513	6 $($(target)_TOOL) \
1514	7 $($(source)TOOL) \
1515	8 $($(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
1516	9 $($(source)TOOL.$(bld_trg)) \
1517	10 $(TOOL.$(bld_trg).$(bld_trg_arch)) \
1518	11 $(TOOL.$(bld_trg)) \
1519	12 $(TOOL) )
1520	$(error kBuild: TOOL_$(tool)_LINK_LIBRARY_CMDS isn't defined! target=$(target) )
1521	endif
1522
1523	# call the tool
1524	$(target)_CMDS_ := $(TOOL_$(tool)_LINK_LIBRARY_CMDS)
1525	ifneq ($(pre_cmds),)
1526	$(target)_CMDS_ := $(TAB)$(pre_cmds)$(NL)$(TAB)$($(target)_CMDS_)
1527	endif
1528	ifneq ($(post_cmds),)
1529	$(target)_CMDS_ := $($(target)_CMDS_)$(NL)$(TAB)$(post_cmds)
1530	endif
1531	$(target)_OUTPUT_ := $(TOOL_$(tool)_LINK_LIBRARY_OUTPUT)
1532	$(target)_DEPEND_ := $(TOOL_$(tool)_LINK_LIBRARY_DEPEND) $(deps) $(objs)
1533	$(target)_DEPORD_ := $(TOOL_$(tool)_LINK_LIBRARY_DEPORD) $(dirdep) $(orderdeps)
1534
1535	# generate the link rule.
1536	$(eval $(def_link_rule))
1537
1538	# installing and globals
1539	$(eval $(value def_target_install_pluss))
1540	endef
1541
1542	# Process libraries
1543	definst := $(PATH_LIB)
1544	typevar := _LIBS
1545	tool_do := LINK_LIBRARY
1546	mode := 0644
1547	$(foreach target, $(LIBRARIES) $(LIBRARIES.$(BUILD_TARGET)) $(LIBRARIES.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_lib)))
1548
1549
1550	#
1551	# Link operations.
1552	#
1553
1554	##
1555	# Link prolog
1556	#
1557	# @param $(target) Normalized target name.
1558	# @param $(EXT) EXE,DLL,SYS.
1559	# @param $(definst) The default _INST value.
1560	# @param $(typevar) The name of the variable with all the root targets of its type.
1561	define def_link_common
1562	# basics
1563	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
1564	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_$(bld_trg_base_var)))
1565	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_$(bld_trg_base_var)_ARCH))
1566	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_$(bld_trg_base_var)_CPU))
1567
1568	tool := $(call _TARGET_TOOL,$(target),LD)
1569	name := $(firstword\
1570	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1571	$($(target)_NAME.$(bld_trg_arch))\
1572	$($(target)_NAME.$(bld_trg))\
1573	$($(target)_NAME.$(bld_type))\
1574	$($(target)_NAME)\
1575	$(target))
1576	outbase := $(call TARGET_BASE,$(name),$(target))
1577	ifndef PATH_$(target)
1578	PATH_$(target) := $(patsubst %/,%,$(dir $(outbase)))
1579	else
1580	ifneq ($(PATH_$(target)),$(patsubst %/,%,$(dir $(outbase))))
1581	$(error kBuild internal error: PATH_$(target)=$(PATH_$(target)) expected $(patsubst %/,%,$(dir $(outbase))))
1582	endif
1583	endif
1584	suff := $(firstword \
1585	$($(target)_$(EXT)SUFF) \
1586	$($(target)_$(EXT)SUFF) \
1587	$(TOOL_$(tool)_LD$(EXT)SUFF) \
1588	$($(EXTPRE)SUFF_$(EXT)))
1589	out := $(outbase)$(suff)
1590	TARGET_$(target) := $(out)
1591	$(target)_OBJS_ :=
1592	defpath := $($(target)_PATH)
1593
1594	# source -> object
1595	$(eval $(value def_target_sources))
1596
1597	# more link stuff.
1598	tool := $(call _TARGET_TOOL,$(target),LD)
1599	name := $(firstword\
1600	$($(target)_NAME.$(bld_trg).$(bld_trg_arch))\
1601	$($(target)_NAME.$(bld_trg_arch))\
1602	$($(target)_NAME.$(bld_trg))\
1603	$($(target)_NAME.$(bld_type))\
1604	$($(target)_NAME)\
1605	$(target))
1606	outbase := $(call TARGET_BASE,$(name),$(target))
1607	flags :=\
1608	$(TOOL_$(tool)_LDFLAGS)\
1609	$(TOOL_$(tool)_LDFLAGS.$(bld_type))\
1610	$(TOOL_$(tool)_LDFLAGS.$(bld_trg))\
1611	$(TOOL_$(tool)_LDFLAGS.$(bld_trg_arch))\
1612	$(TOOL_$(tool)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1613	$(TOOL_$(tool)_LDFLAGS.$(bld_trg_cpu))\
1614	$(LDFLAGS)\
1615	$(LDFLAGS.$(bld_type))\
1616	$(LDFLAGS.$(bld_trg))\
1617	$(LDFLAGS.$(bld_trg_arch))\
1618	$(LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1619	$(LDFLAGS.$(bld_trg_cpu))\
1620	$($(target)_LDFLAGS)\
1621	$($(target)_LDFLAGS.$(bld_type))\
1622	$($(target)_LDFLAGS.$(bld_trg))\
1623	$($(target)_LDFLAGS.$(bld_trg_arch))\
1624	$($(target)_LDFLAGS.$(bld_trg).$(bld_trg_arch))\
1625	$($(target)_LDFLAGS.$(bld_trg_cpu))
1626	othersrc := $(filter-out %.c %.cpp %.cxx %.cc %.s %.S %.asm %.o %.obj,\
1627	$($(target)_SOURCES)\
1628	$($(target)_SOURCES.$(bld_trg)) \
1629	$($(target)_SOURCES.$(bld_trg_arch)) \
1630	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1631	$($(target)_SOURCES.$(bld_trg_cpu)) \
1632	$($(target)_SOURCES.$(bld_type)))
1633	objs = $(filter %.o %.obj, \
1634	$($(target)_SOURCES) \
1635	$($(target)_SOURCES.$(bld_trg)) \
1636	$($(target)_SOURCES.$(bld_trg_arch)) \
1637	$($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) \
1638	$($(target)_SOURCES.$(bld_trg_cpu)) \
1639	$($(target)_SOURCES.$(bld_type))) \
1640	$($(target)_OBJS_)
1641	libs :=\
1642	$($(target)_LIBS.$(bld_trg_cpu))\
1643	$($(target)_LIBS.$(bld_trg).$(bld_trg_arch))\
1644	$($(target)_LIBS.$(bld_trg_arch))\
1645	$($(target)_LIBS.$(bld_trg))\
1646	$($(target)_LIBS.$(bld_type))\
1647	$($(target)_LIBS)\
1648	$(foreach sdk, $($(target)_SDKS.$(bld_trg).$(bld_trg_arch)) \
1649	$($(target)_SDKS.$(bld_trg_arch)) \
1650	$($(target)_SDKS.$(bld_trg)) \
1651	$($(target)_SDKS.$(bld_type)) \
1652	$($(target)_SDKS),\
1653	$(SDK_$(sdk)_LIBS.$(bld_trg_cpu))\
1654	$(SDK_$(sdk)_LIBS.$(bld_trg).$(bld_trg_arch))\
1655	$(SDK_$(sdk)_LIBS.$(bld_trg_arch))\
1656	$(SDK_$(sdk)_LIBS.$(bld_trg))\
1657	$(SDK_$(sdk)_LIBS.$(bld_type))\
1658	$(SDK_$(sdk)_LIBS))\
1659	$(LIBS.$(bld_trg_cpu))\
1660	$(LIBS.$(bld_trg).$(bld_trg_arch))\
1661	$(LIBS.$(bld_trg_arch))\
1662	$(LIBS.$(bld_trg))\
1663	$(LIBS.$(bld_type))\
1664	$(LIBS)\
1665	$(foreach sdk, $(SDKS.$(bld_trg).$(bld_trg_arch)) \
1666	$(SDKS.$(bld_trg_arch)) \
1667	$(SDKS.$(bld_trg)) \
1668	$(SDKS.$(bld_type)) \
1669	$(SDKS),\
1670	$(SDK_$(sdk)_LIBS.$(bld_trg_cpu))\
1671	$(SDK_$(sdk)_LIBS.$(bld_trg).$(bld_trg_arch))\
1672	$(SDK_$(sdk)_LIBS.$(bld_trg_arch))\
1673	$(SDK_$(sdk)_LIBS.$(bld_trg))\
1674	$(SDK_$(sdk)_LIBS.$(bld_type))\
1675	$(SDK_$(sdk)_LIBS))\
1676	$(TOOL_$(tool)_LIBS.$(bld_trg_cpu))\
1677	$(TOOL_$(tool)_LIBS.$(bld_trg).$(bld_trg_arch))\
1678	$(TOOL_$(tool)_LIBS.$(bld_trg_arch))\
1679	$(TOOL_$(tool)_LIBS.$(bld_trg))\
1680	$(TOOL_$(tool)_LIBS.$(bld_type))\
1681	$(TOOL_$(tool)_LIBS)
1682	libpath :=\
1683	$($(target)_LIBPATH.$(bld_trg_cpu))\
1684	$($(target)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1685	$($(target)_LIBPATH.$(bld_trg_arch))\
1686	$($(target)_LIBPATH.$(bld_trg))\
1687	$($(target)_LIBPATH.$(bld_type))\
1688	$($(target)_LIBPATH)\
1689	$(foreach sdk, $($(target)_SDKS.$(bld_trg).$(bld_trg_arch)) \
1690	$($(target)_SDKS.$(bld_trg_arch)) \
1691	$($(target)_SDKS.$(bld_trg)) \
1692	$($(target)_SDKS.$(bld_type)) \
1693	$($(target)_SDKS),\
1694	$(SDK_$(sdk)_LIBPATH.$(bld_trg_cpu))\
1695	$(SDK_$(sdk)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1696	$(SDK_$(sdk)_LIBPATH.$(bld_trg_arch))\
1697	$(SDK_$(sdk)_LIBPATH.$(bld_trg))\
1698	$(SDK_$(sdk)_LIBPATH.$(bld_type))\
1699	$(SDK_$(sdk)_LIBPATH))\
1700	$(LIBPATH.$(bld_trg_cpu))\
1701	$(LIBPATH.$(bld_trg).$(bld_trg_arch))\
1702	$(LIBPATH.$(bld_trg_arch))\
1703	$(LIBPATH.$(bld_trg))\
1704	$(LIBPATH.$(bld_type))\
1705	$(LIBPATH)\
1706	$(foreach sdk, $(SDKS.$(bld_trg).$(bld_trg_arch)) \
1707	$(SDKS.$(bld_trg_arch)) \
1708	$(SDKS.$(bld_trg)) \
1709	$(SDKS.$(bld_type)) \
1710	$(SDKS),\
1711	$(SDK_$(sdk)_LIBPATH.$(bld_trg_cpu))\
1712	$(SDK_$(sdk)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1713	$(SDK_$(sdk)_LIBPATH.$(bld_trg_arch))\
1714	$(SDK_$(sdk)_LIBPATH.$(bld_trg))\
1715	$(SDK_$(sdk)_LIBPATH.$(bld_type))\
1716	$(SDK_$(sdk)_LIBPATH))\
1717	$(TOOL_$(tool)_LIBPATH.$(bld_trg_cpu))\
1718	$(TOOL_$(tool)_LIBPATH.$(bld_trg).$(bld_trg_arch))\
1719	$(TOOL_$(tool)_LIBPATH.$(bld_trg_arch))\
1720	$(TOOL_$(tool)_LIBPATH.$(bld_trg))\
1721	$(TOOL_$(tool)_LIBPATH.$(bld_type))\
1722	$(TOOL_$(tool)_LIBPATH)
1723	dirdep := $(call DIRDEP,$(dir $(out)))
1724	deps := $($(target)_DEPS)
1725	orderdeps := $($(target)_ORDERDEPS)
1726
1727	# Adjust paths if we got a default path.
1728	ifneq ($(defpath),)
1729	libpath := $(call abspathex,$(libpath),$(defpath))
1730	objs := $(call abspathex,$(objs),$(defpath))
1731	deps := $(call abspathex,$(deps),$(defpath))
1732	orderdeps := $(call abspathex,$(orderdeps),$(defpath))
1733	othersrc := $(call abspathex,$(othersrc),$(defpath))
1734	# libs are not subject to this because of the the -l<lib> stuff. Use $(<target>_PATH)/lib if relative to current dir!
1735	endif
1736
1737	# Custom pre-link actions.
1738	ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1739	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1740	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1741	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1742	else ifdef $(target)_PRE_CMDS.$(bld_trg).$(bld_type)
1743	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg).$(bld_type))
1744	else ifdef $(target)_PRE_CMDS.$(bld_trg_arch)
1745	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg_arch))
1746	else ifdef $(target)_PRE_CMDS.$(bld_trg)
1747	pre_cmds := $($(target)_PRE_CMDS.$(bld_trg))
1748	else ifdef $(target)_PRE_CMDS.$(bld_type)
1749	pre_cmds := $($(target)_PRE_CMDS.$(bld_type))
1750	else ifdef $(target)_PRE_CMDS
1751	pre_cmds := $($(target)_PRE_CMDS)
1752	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1753	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1754	else ifdef PRE_CMDS.$(bld_trg).$(bld_trg_arch)
1755	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_trg_arch))
1756	else ifdef PRE_CMDS.$(bld_trg).$(bld_type)
1757	pre_cmds := $(PRE_CMDS.$(bld_trg).$(bld_type))
1758	else ifdef PRE_CMDS.$(bld_trg_arch)
1759	pre_cmds := $(PRE_CMDS.$(bld_trg_arch))
1760	else ifdef PRE_CMDS.$(bld_trg)
1761	pre_cmds := $(PRE_CMDS.$(bld_trg))
1762	else ifdef PRE_CMDS.$(bld_type)
1763	pre_cmds := $(PRE_CMDS.$(bld_type))
1764	else
1765	pre_cmds := $(PRE_CMDS)
1766	endif
1767
1768	# Custom post-link actions.
1769	ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1770	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1771	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch)
1772	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_trg_arch))
1773	else ifdef $(target)_POST_CMDS.$(bld_trg).$(bld_type)
1774	post_cmds := $($(target)_POST_CMDS.$(bld_trg).$(bld_type))
1775	else ifdef $(target)_POST_CMDS.$(bld_trg_arch)
1776	post_cmds := $($(target)_POST_CMDS.$(bld_trg_arch))
1777	else ifdef $(target)_POST_CMDS.$(bld_trg)
1778	post_cmds := $($(target)_POST_CMDS.$(bld_trg))
1779	else ifdef $(target)_POST_CMDS.$(bld_type)
1780	post_cmds := $($(target)_POST_CMDS.$(bld_type))
1781	else ifdef $(target)_POST_CMDS
1782	post_cmds := $($(target)_POST_CMDS)
1783	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type)
1784	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch).$(bld_type))
1785	else ifdef POST_CMDS.$(bld_trg).$(bld_trg_arch)
1786	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_trg_arch))
1787	else ifdef POST_CMDS.$(bld_trg).$(bld_type)
1788	post_cmds := $(POST_CMDS.$(bld_trg).$(bld_type))
1789	else ifdef POST_CMDS.$(bld_trg_arch)
1790	post_cmds := $(POST_CMDS.$(bld_trg_arch))
1791	else ifdef POST_CMDS.$(bld_trg)
1792	post_cmds := $(POST_CMDS.$(bld_trg))
1793	else ifdef POST_CMDS.$(bld_type)
1794	post_cmds := $(POST_CMDS.$(bld_type))
1795	else
1796	post_cmds := $(POST_CMDS)
1797	endif
1798
1799	# installation targets
1800	ifndef $(target)_NOINST
1801	INSTARGET_$(target) := $(patsubst %/,%/$(notdir $(out)), \
1802	$(if $($(target)_INST), $(addprefix $(PATH_INS)/,$($(target)_INST)), $(definst)/))
1803	ifdef KBUILD_DO_AUTO_INSTALL
1804	$(typevar) += $(INSTARGET_$(target))
1805	else
1806	$(typevar) += $(out)
1807	endif
1808	# generate the install rule
1809	$(eval $(def_link_install_rule))
1810
1811	else # NOINST
1812	INSTARGET_$(target) :=
1813	$(typevar) += $(out)
1814	endif # NOINST
1815
1816	# dependency file
1817	dep := $(outbase)$(SUFF_DEP)
1818	ifndef NO_LINK_CMDS_DEPS
1819	_DEPFILES_INCLUDED += $(dep)
1820	$(eval includedep $(dep))
1821	endif
1822
1823	# check that the tool is defined.
1824	ifndef TOOL_$(tool)_$(tool_do)_CMDS
1825	$(warning kBuild: tools: \
1826	1 $($(target)_$(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
1827	2 $($(target)_$(source)TOOL.$(bld_trg)) \
1828	3 $($(target)_$(source)TOOL) \
1829	4 $($(target)_TOOL.$(bld_trg).$(bld_trg_arch)) \
1830	5 $($(target)_TOOL.$(bld_trg)) \
1831	6 $($(target)_TOOL) \
1832	7 $($(source)TOOL.$(bld_trg).$(bld_trg_arch)) \
1833	8 $($(source)TOOL.$(bld_trg)) \
1834	9 $($(source)TOOL) \
1835	10 $(TOOL.$(bld_trg).$(bld_trg_arch)) \
1836	11 $(TOOL.$(bld_trg)) \
1837	12 $(TOOL) )
1838	$(error kBuild: TOOL_$(tool)_$(tool_do)_CMDS isn't defined! target=$(target) )
1839	endif
1840
1841	# call the tool
1842	$(target)_CMDS_ := $(TOOL_$(tool)_$(tool_do)_CMDS)
1843	ifneq ($(pre_cmds),)
1844	$(target)_CMDS_ := $(TAB)$(pre_cmds)$(NL)$(TAB)$($(target)_CMDS_)
1845	endif
1846	ifneq ($(post_cmds),)
1847	$(target)_CMDS_ := $($(target)_CMDS_)$(NL)$(TAB)$(post_cmds)
1848	endif
1849	$(target)_OUTPUT_ := $(TOOL_$(tool)_$(tool_do)_OUTPUT)
1850	$(target)_DEPEND_ := $(TOOL_$(tool)_$(tool_do)_DEPEND) $(deps) $(objs)
1851	$(target)_DEPORD_ := $(TOOL_$(tool)_$(tool_do)_DEPORD) $(dirdep) $(orderdeps)
1852
1853	# generate the link rule.
1854	$(eval $(def_link_rule))
1855
1856
1857	# Update globals.
1858	_OBJS += $($(target)_OBJS_)
1859	_OUT_FILES += $($(target)_OUTPUT_) $(out)
1860	_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))
1861	_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))
1862	_INSTALLS_FILES += $(INSTARGET_$(target))
1863
1864	endef
1865
1866
1867	#
1868	# BLDPROGS
1869	#
1870
1871	## Build program (one).
1872	# @param $(target) Normalized target (program) name.
1873	define def_bldprog
1874
1875	# set NOINST if not forced installation.
1876	ifndef $(target)_INST
1877	$(target)_NOINST := 1
1878	endif
1879
1880	# do the usual stuff.
1881	$(eval $(value def_link_common))
1882
1883	endef
1884
1885	# Process build programs.
1886	EXT := EXE
1887	EXTPRE := HOST
1888	tool_do := LINK_PROGRAM
1889	definst := $(PATH_BIN)
1890	typevar := _BLDPROGS
1891	mode := 0755
1892	bld_trg_base_var := PLATFORM
1893	$(foreach target, $(BLDPROGS) $(BLDPROGS.$(BUILD_PLATFORM)) $(BLDPROGS.$(BUILD_PLATFORM).$(BUILD_PLATFORM_ARCH)), $(eval $(value def_bldprog)))
1894
1895
1896
1897	#
1898	# DLLS
1899	#
1900
1901	# Process dlls
1902	EXT := DLL
1903	EXTPRE :=
1904	tool_do := LINK_DLL
1905	definst := $(PATH_DLL)
1906	typevar := _DLLS
1907	mode := 0644
1908	bld_trg_base_var := TARGET
1909	$(foreach target, $(DLLS) $(DLLS.$(BUILD_TARGET)) $(DLLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
1910
1911
1912	#
1913	# IMPORT LIBRARIES
1914	#
1915	# - On OS/2 and windows these are libraries.
1916	# - On other platforms they are fake DLLs.
1917	#
1918	EXTPRE :=
1919	typevar := _IMPORT_LIBS
1920	mode := 0644
1921	bld_trg_base_var := TARGET
1922	ifeq ($(filter-out nt os2 win win64 win32,$(BUILD_TARGET)),)
1923	EXT := LIB
1924	tool_do := LINK_LIBRARY
1925	definst := $(PATH_LIB)
1926	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_lib)))
1927	else
1928	EXT := DLL
1929	tool_do := LINK_DLL
1930	definst := $(PATH_DLL)
1931	$(foreach target, $(IMPORT_LIBS) $(IMPORT_LIBS.$(BUILD_TARGET)) $(IMPORT_LIBS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
1932	endif
1933
1934
1935	#
1936	# PROGRAMS
1937	#
1938
1939	# Process programs
1940	EXT := EXE
1941	EXTPRE :=
1942	tool_do := LINK_PROGRAM
1943	definst := $(PATH_BIN)
1944	typevar := _PROGRAMS
1945	mode := 0755
1946	bld_trg_base_var := TARGET
1947	$(foreach target, $(PROGRAMS) $(PROGRAMS.$(BUILD_TARGET)) $(PROGRAMS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
1948
1949
1950
1951	#
1952	# SYSMODS
1953	#
1954
1955	# Process sysmods
1956	EXT := SYS
1957	EXTPRE :=
1958	tool_do := LINK_SYSMOD
1959	definst := $(PATH_SYS)
1960	typevar := _SYSMODS
1961	mode := 0644
1962	bld_trg_base_var := TARGET
1963	$(foreach target, $(SYSMODS) $(SYSMODS.$(BUILD_TARGET)) $(SYSMODS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), $(eval $(value def_link_common)))
1964
1965
1966	#
1967	# OTHERS
1968	#
1969	_OTHERS = $(OTHERS) $(OTHERS.$(BUILD_TARGET)) $(OTHERS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
1970
1971
1972	#
1973	# INSTALLS
1974	#
1975
1976	## generate the install rule
1977	define def_install_src_rule
1978	# the install rule
1979	$(insdst) : $(srcsrc) \| $(call DIRDEP,$(dir $(insdst)))
1980	$$(call MSG_INST_FILE,$(srcsrc),$(insdst))
1981	$$(QUIET)$$(if $$(filter $(INSTALL),$(inscmd)),,$$(RM) -f $$@)
1982	$$(QUIET)$(inscmd)
1983	endef
1984
1985	## install one file
1986	define def_install_src
1987
1988	# deal with '=>' in the source file name.
1989	srcdst := $(subst =>, ,$(src))
1990	srcsrc := $(firstword $(srcdst))
1991	srcdstdir := $(dir $(word 2,$(srcdst)))
1992	srcdst := $(word $(words $(srcdst)),$(srcdst))
1993
1994	# _INSTFUN
1995	ifdef $(srcsrc)_INSTFUN
1996	instfun := $(srcsrc)_INSTFUN
1997	else
1998	ifdef $(target)_INSTFUN
1999	instfun := $(target)_INSTFUN
2000	else
2001	instfun := _INSTALL_FILE
2002	endif
2003	endif
2004
2005	# _INST
2006	ifdef $(srcsrc)_INST
2007	inst := $(patsubst %/,%,$($(srcsrc)_INST))/$(dir $(srcdstdir))
2008	else
2009	ifdef $(target)_INST
2010	inst := $(patsubst %/,%,$($(target)_INST))/$(dir $(srcdstdir))
2011	else
2012	inst := $(dir $(srcdstdir))
2013	endif
2014	endif
2015
2016	# calc target
2017	insdst := $(call $(instfun),$(srcdst),$(target),$(inst),$(PATH_INS))
2018	#$(warning instfun=$(instfun) srcdst=$(srcdst) target=$(target) inst=$(inst) => insdst=$(insdst))
2019
2020	# mode, uid and gid
2021	mode := $(firstword \
2022	$($(target)_$(srcsrc)_MODE.$(bld_trg).$(bld_trg_arch)) \
2023	$($(target)_$(srcsrc)_MODE.$(bld_trg)) \
2024	$($(target)_$(srcsrc)_MODE) \
2025	$($(target)_$(srcdst)_MODE.$(bld_trg).$(bld_trg_arch)) \
2026	$($(target)_$(srcdst)_MODE.$(bld_trg)) \
2027	$($(target)_$(srcdst)_MODE) \
2028	$($(srcsrc)_MODE.$(bld_trg).$(bld_trg_arch)) \
2029	$($(srcsrc)_MODE.$(bld_trg)) \
2030	$($(srcsrc)_MODE) \
2031	$($(srcdst)_MODE.$(bld_trg).$(bld_trg_arch)) \
2032	$($(srcdst)_MODE.$(bld_trg)) \
2033	$($(srcdst)_MODE) \
2034	$($(target)_MODE.$(bld_trg).$(bld_trg_arch)) \
2035	$($(target)_MODE.$(bld_trg)) \
2036	$($(target)_MODE))
2037	uid := $(firstword \
2038	$($(target)_$(srcsrc)_UID.$(bld_trg).$(bld_trg_arch)) \
2039	$($(target)_$(srcsrc)_UID.$(bld_trg)) \
2040	$($(target)_$(srcsrc)_UID) \
2041	$($(target)_$(srcdst)_UID.$(bld_trg).$(bld_trg_arch)) \
2042	$($(target)_$(srcdst)_UID.$(bld_trg)) \
2043	$($(target)_$(srcdst)_UID) \
2044	$($(srcsrc)_UID.$(bld_trg).$(bld_trg_arch)) \
2045	$($(srcsrc)_UID.$(bld_trg)) \
2046	$($(srcsrc)_UID) \
2047	$($(srcdst)_UID.$(bld_trg).$(bld_trg_arch)) \
2048	$($(srcdst)_UID.$(bld_trg)) \
2049	$($(srcdst)_UID) \
2050	$($(target)_UID.$(bld_trg).$(bld_trg_arch)) \
2051	$($(target)_UID.$(bld_trg)) \
2052	$($(target)_UID))
2053	gid := $(firstword \
2054	$($(target)_$(srcsrc)_GID.$(bld_trg).$(bld_trg_arch)) \
2055	$($(target)_$(srcsrc)_GID.$(bld_trg)) \
2056	$($(target)_$(srcsrc)_GID) \
2057	$($(target)_$(srcdst)_GID.$(bld_trg).$(bld_trg_arch)) \
2058	$($(target)_$(srcdst)_GID.$(bld_trg)) \
2059	$($(target)_$(srcdst)_GID) \
2060	$($(srcsrc)_GID.$(bld_trg).$(bld_trg_arch)) \
2061	$($(srcsrc)_GID.$(bld_trg)) \
2062	$($(srcsrc)_GID) \
2063	$($(srcdst)_GID.$(bld_trg).$(bld_trg_arch)) \
2064	$($(srcdst)_GID.$(bld_trg)) \
2065	$($(srcdst)_GID) \
2066	$($(target)_GID.$(bld_trg).$(bld_trg_arch)) \
2067	$($(target)_GID.$(bld_trg)) \
2068	$($(target)_GID))
2069	flags := \
2070	$($(target)_IFFLAGS) \
2071	$($(target)_IFFLAGS.$(bld_trg)) \
2072	$($(target)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2073	$($(srcdst)_IFFLAGS) \
2074	$($(srcdst)_IFFLAGS.$(bld_trg)) \
2075	$($(srcdst)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2076	$($(srcsrc)_IFFLAGS) \
2077	$($(srcsrc)_IFFLAGS.$(bld_trg)) \
2078	$($(srcsrc)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2079	$($(target)_$(srcdst)_IFFLAGS) \
2080	$($(target)_$(srcdst)_IFFLAGS.$(bld_trg)) \
2081	$($(target)_$(srcdst)_IFFLAGS.$(bld_trg).$(bld_trg_arch)) \
2082	$($(target)_$(srcsrc)_IFFLAGS) \
2083	$($(target)_$(srcsrc)_IFFLAGS.$(bld_trg)) \
2084	$($(target)_$(srcsrc)_IFFLAGS.$(bld_trg).$(bld_trg_arch))
2085
2086
2087	# Adjust the source if we got a default PATH. (This must be done this late!)
2088	ifdef $(target)_PATH
2089	srcsrc := $(call abspathex,$(srcsrc),$($(target)_PATH))
2090	endif
2091
2092	# create the command
2093	ifdef $(srcsrc)_INSTALLER
2094	inscmd := $(call $(srcsrc)_INSTALLER,$(srcsrc),$(insdst),$(target),$(flags))
2095	else ifdef $(target)_INSTALLER
2096	inscmd := $(call $(target)_INSTALLER,$(srcsrc),$(insdst),$(target),$(flags))
2097	else
2098	inscmd := $$(INSTALL)\
2099	$(if $(uid),-o $(uid))\
2100	$(if $(gid),-g $(gid))\
2101	$(if $(mode),-m $(mode))\
2102	$(flags)\
2103	$(srcsrc) $(insdst)
2104	endif
2105
2106	# generate the rule (need double evaluation here)
2107	$(eval $(def_install_src_rule))
2108
2109	INSTARGET_$(target) += $(insdst)
2110	endef
2111
2112
2113	## generate the symlink rule
2114	define def_install_symlink_rule
2115	# the install rule
2116	$(insdst) : \| $(call DIRDEP,$(dir $(insdst)))
2117	$$(call MSG_INST_SYM,$(insdst),$(symdst))
2118	$$(QUIET)$$(RM) -f $$@
2119	$$(QUIET)$$(LN_SYMLINK) $(symdst) $(insdst)
2120	endef
2121
2122	## create one symlink
2123	define def_install_symlink
2124
2125	# deal with '=>' in the source file name.
2126	symdst := $(subst =>, ,$(src))
2127	symlnk := $(firstword $(symdst))
2128	symdst := $(word $(words $(symdst)),$(symdst))
2129
2130	# _INSTFUN
2131	ifdef $(symlnk)_INSTFUN
2132	instfun := $(symlnk)_INSTFUN
2133	else ifdef $(target)_INSTFUN
2134	instfun := $(target)_INSTFUN
2135	else
2136	instfun := _INSTALL_FILE
2137	endif
2138
2139	# _INST
2140	ifdef $(symlnk)_INST
2141	inst := $(patsubst %/,%,$($(symlnk)_INST))/$(dir $(symlnk))
2142	else ifdef $(target)_INST
2143	inst := $(patsubst %/,%,$($(target)_INST))/$(dir $(symlnk))
2144	else
2145	inst := $(dir $(symlnk))
2146	endif
2147
2148	# calc target
2149	insdst := $(call $(instfun),$(symlnk),$(target),$(inst),$(PATH_INS))
2150	#$(warning symlnk=$(symlnk) symdst=$(symdst) insdst=$(insdst) instfun=$(instfun) inst='$(inst)')
2151
2152	# generate the rule (need double evaluation here)
2153	$(eval $(def_install_symlink_rule))
2154
2155	INSTARGET_$(target) += $(insdst)
2156	endef
2157
2158
2159	## generate the install rule
2160	define def_install_directory_rule
2161	# the install rule
2162	$(insdst):
2163	$$(call MSG_INST_DIR,$(insdst))
2164	$$(QUIET)$$(INSTALL) -d \
2165	$(if $(uid),-o $(uid))\
2166	$(if $(gid),-g $(gid))\
2167	$(if $(mode),-m $(mode))\
2168	$(flags)\
2169	$(insdst)
2170
2171	.NOTPARALLEL: $(insdst)
2172	endef
2173
2174
2175	## create one directory
2176	define def_install_directory
2177
2178	# _INST
2179	ifdef $(directory)_INST
2180	inst := $(PATH_INS)/$(patsubst %/,%,$($(directory)_INST))
2181	else ifdef $(target)_INST
2182	inst := $(PATH_INS)/$(patsubst %/,%,$($(target)_INST))
2183	else
2184	inst := $(PATH_INS)
2185	endif
2186
2187	mode := $(firstword \
2188	$($(target)_$(directory)_MODE.$(bld_trg).$(bld_trg_arch)) \
2189	$($(target)_$(directory)_MODE.$(bld_trg)) \
2190	$($(target)_$(directory)_MODE) \
2191	$($(directory)_MODE.$(bld_trg).$(bld_trg_arch)) \
2192	$($(directory)_MODE.$(bld_trg)) \
2193	$($(directory)_MODE) \
2194	$($(target)_MODE.$(bld_trg).$(bld_trg_arch)) \
2195	$($(target)_MODE.$(bld_trg)) \
2196	$($(target)_MODE))
2197	uid := $(firstword \
2198	$($(target)_$(directory)_UID.$(bld_trg).$(bld_trg_arch)) \
2199	$($(target)_$(directory)_UID.$(bld_trg)) \
2200	$($(target)_$(directory)_UID) \
2201	$($(directory)_UID.$(bld_trg).$(bld_trg_arch)) \
2202	$($(directory)_UID.$(bld_trg)) \
2203	$($(directory)_UID) \
2204	$($(target)_UID.$(bld_trg).$(bld_trg_arch)) \
2205	$($(target)_UID.$(bld_trg)) \
2206	$($(target)_UID))
2207	gid := $(firstword \
2208	$($(target)_$(directory)_GID.$(bld_trg).$(bld_trg_arch)) \
2209	$($(target)_$(directory)_GID.$(bld_trg)) \
2210	$($(target)_$(directory)_GID) \
2211	$($(directory)_GID.$(bld_trg).$(bld_trg_arch)) \
2212	$($(directory)_GID.$(bld_trg)) \
2213	$($(directory)_GID) \
2214	$($(target)_GID.$(bld_trg).$(bld_trg_arch)) \
2215	$($(target)_GID.$(bld_trg)) \
2216	$($(target)_GID))
2217	flags := \
2218	$($(target)_IDFLAGS)\
2219	$($(target)_IDFLAGS.$(bld_trg)) \
2220	$($(target)_IDFLAGS.$(bld_trg).$(bld_trg_arch)) \
2221	$($(directory)_IDFLAGS) \
2222	$($(directory)_IDFLAGS.$(bld_trg)) \
2223	$($(directory)_IDFLAGS.$(bld_trg).$(bld_trg_arch)) \
2224	$($(target)_$(directory)_IDFLAGS) \
2225	$($(target)_$(directory)_IDFLAGS.$(bld_trg)) \
2226	$($(target)_$(directory)_IDFLAGS.$(bld_trg).$(bld_trg_arch))
2227
2228	insdst := $(inst)/$(directory)/
2229	#$(warning directory=$(directory) inst=$(inst) insdst=$(insdst) mode=$(mode) gid=$(gid) uid=$(uid))
2230
2231	# generate the rule (need double evaluation here)
2232	$(eval $(def_install_directory_rule))
2233
2234	INSTARGET_DIRS_$(target) += $(insdst)
2235	endef
2236
2237
2238	## process one install target.
2239	define def_install
2240	# the basics.
2241	bld_type := $(firstword $($(target)_BLD_TYPE) $(BUILD_TYPE))
2242	bld_trg := $(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))
2243	bld_trg_arch:= $(firstword $($(target)_BLD_TRG_ARCH) $(BUILD_TARGET_ARCH))
2244	bld_trg_cpu := $(firstword $($(target)_BLD_TRG_CPU) $(BUILD_TARGET_CPU))
2245
2246	INSTARGET_$(target) := $($(target)_GOALS)
2247	INSTARGET_DIRS_$(target) :=
2248
2249	$(foreach directory,$($(target)_DIRS) $($(target)_DIRS.$(bld_trg)) $($(target)_DIRS.$(bld_trg).$(bld_trg_arch)) $($(target)_DIRS.$(bld_trg_arch)) $($(target)_DIRS.$(bld_trg_cpu)) $($(target)_DIRS.$(bld_type)), \
2250	$(eval $(value def_install_directory)))
2251
2252	$(foreach src,$($(target)_SOURCES) $($(target)_SOURCES.$(bld_trg)) $($(target)_SOURCES.$(bld_trg).$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_arch)) $($(target)_SOURCES.$(bld_trg_cpu)) $($(target)_SOURCES.$(bld_type)), \
2253	$(eval $(value def_install_src)))
2254
2255	$(foreach src,$($(target)_SYMLINKS) $($(target)_SYMLINKS.$(bld_trg)) $($(target)_SYMLINKS.$(bld_trg).$(bld_trg_arch)) $($(target)_SYMLINKS.$(bld_trg_arch)) $($(target)_SYMLINKS.$(bld_trg_cpu)) $($(target)_SYMLINKS.$(bld_type)), \
2256	$(eval $(value def_install_symlink)))
2257
2258	# the collection target
2259	TARGET_$(target) := $(PATH_TARGET)/$(target).ins
2260	$(TARGET_$(target)): $(INSTARGET_$(target)) \| $(INSTARGET_DIRS_$(target)) $(call DIRDEP,$(PATH_TARGET))
2261	@$(QUIET2)$(APPEND) $@
2262
2263	$(target): $(TARGET_$(target))
2264
2265	_INSTALLS += $(TARGET_$(target))
2266	_INSTALLS_FILES += $(INSTARGET_$(target))
2267	_INSTALLS_DIRS += $(INSTARGET_DIRS_$(target))
2268	_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))
2269	_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))
2270	endef
2271
2272	## process all install targets
2273	$(foreach target, $(INSTALLS) $(INSTALLS.$(BUILD_TARGET)) $(INSTALLS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)), \
2274	$(eval $(value def_install)))
2275
2276
2277	#
2278	# PACKING
2279	#
2280	_PACKING += $(PACKING) $(PACKING.$(BUILD_TARGET)) $(PACKING.$(BUILD_TARGET).$(BUILD_TARGET_ARCH))
2281
2282
2283	#
2284	# DOCS
2285	#
2286
2287
2288	#
2289	# DIRECTORIES
2290	#
2291	_DIR_ALL := $(sort $(addsuffix /,$(patsubst %/,%,$(_DIRS))) $(dir $(_OUT_FILES) $(_OBJS) $(_INSTALLS_FILES)))
2292	$(foreach directory,$(_INSTALLS_DIRS), $(eval _DIR_ALL := $(filter-out $(directory),$(_DIR_ALL))))
2293
2294
2295	define def_mkdir_rule
2296	$(directory):
2297	$$(call MSG_MKDIR,$$@)
2298	$$(QUIET)$$(MKDIR) -p $$@
2299	endef
2300
2301	$(foreach directory,$(_DIR_ALL),$(eval $(def_mkdir_rule)))
2302
2303
2304	#
2305	# NOTHING
2306	#
2307	do-nothing:
2308	$(call MSG_NOTHING)
2309
2310
2311	#
2312	# CLEAN UP
2313	#
2314	do-clean:
2315	$(call MSG_CLEAN)
2316	$(QUIET)$(RM) -f $(_OUT_FILES) $(_OBJS) $(_DEPFILES) $(_DEPFILES_INCLUDED) $(_CLEAN_FILES) $(OTHER_CLEAN)
2317	ifeq ($(RMDIR),kmk_builtin_rmdir)
2318	ifeq ($(filter rsort,$(KMK_FEATURES)),rsort) # TODO: Drop this when switching gmake to the gmakenew code!
2319	$(QUIET)$(RMDIR) -p --ignore-fail-on-non-empty --ignore-fail-on-not-exist $(rsort $(dir $(_OUT_FILES) $(_OBJS) $(_DEPFILES) $(_DEPFILES_INCLUDED) $(_CLEAN_FILES) $(OTHER_CLEAN)))
2320	endif
2321	endif
2322
2323
2324
2325	#
2326	# PASSES (including directory and makefile walking)
2327	#
2328
2329	## Subdir
2330	# @param $(pass) Lowercase pass name.
2331	# @param $(PASS) Uppercase pass name.
2332	# @param $(subdir) Subdirectory
2333	# @param $(tag) tag to attach to the rule name.
2334	define def_pass_subdir
2335	pass_$(pass)$(tag):: $(dep)
2336	+ $$(QUIET)$$(MAKE) -C $(subdir) -f $$(notdir $$(firstword $$(wildcard $$(addprefix $(subdir)/,$$(DEFAULT_MAKEFILE))))) pass_$(pass)
2337	endef
2338
2339	## Submakefile
2340	# @param $(pass) Lowercase pass name.
2341	# @param $(PASS) Uppercase pass name.
2342	# @param $(makefile) Makefile.
2343	# @param $(tag) tag to attach to the rule name.
2344	define def_pass_makefile
2345	pass_$(pass)$(tag):: $(dep)
2346	+ $$(QUIET)$$(MAKE) -C $(patsubst %/,%,$(dir $(makefile))) -f $(notdir $(makefile)) pass_$(pass)
2347	endef
2348
2349	## Execute a pass.
2350	# @param $(pass) Lowercase pass name.
2351	# @param $(PASS) Uppercase pass name.
2352	define def_pass_old
2353	$(eval SUBDIRS_$(PASS) ?= $(SUBDIRS) $(SUBDIRS.$(BUILD_TARGET)) $(SUBDIRS.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2354	$(eval SUBDIRS_AFTER_$(PASS) ?= $(SUBDIRS_AFTER) $(SUBDIRS_AFTER.$(BUILD_TARGET)) $(SUBDIRS_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2355	$(eval MAKEFILES_BEFORE_$(PASS) ?= $(MAKEFILES_BEFORE) $(MAKEFILES_BEFORE.$(BUILD_TARGET)) $(MAKEFILES_BEFORE.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2356	$(eval MAKEFILES_AFTER_$(PASS) ?= $(MAKEFILES_AFTER) $(MAKEFILES_AFTER.$(BUILD_TARGET)) $(MAKEFILES_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2357
2358	$(eval tag:=_before)
2359	$(eval dep:=)
2360	$(foreach subdir,$(SUBDIRS_$(PASS)) $(SUBDIRS_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2361	$(foreach makefile,$(MAKEFILES_BEFORE_$(PASS)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),$(eval $(def_pass_makefile)))
2362
2363	$(eval tag:=_after)
2364	$(eval dep:=pass_$(pass)_doit)
2365	$(foreach subdir,$(SUBDIRS_AFTER_$(PASS)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2366	$(foreach makefile,$(MAKEFILES_AFTER_$(PASS)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_makefile)))
2367
2368	.NOTPARALLEL: pass_$(pass)_before pass_$(pass)_after
2369	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_doit pass_$(pass)_after
2370	pass_$(pass)_doit: $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$(var))
2371	pass_$(pass)_this: pass_$(pass)_before
2372	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)_doit
2373	pass_$(pass)_after:: pass_$(pass)_this
2374	pass_$(pass): pass_$(pass)_after
2375
2376	endef
2377
2378	define def_pass
2379	$(eval SUBDIRS_$(PASS) ?= $(SUBDIRS) $(SUBDIRS.$(BUILD_TARGET)) $(SUBDIRS.$(BUILD_TARGET.$(BUILD_TARGET_ARCH))) )
2380	$(eval SUBDIRS_AFTER_$(PASS) ?= $(SUBDIRS_AFTER) $(SUBDIRS_AFTER.$(BUILD_TARGET)) $(SUBDIRS_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2381	$(eval MAKEFILES_BEFORE_$(PASS) ?= $(MAKEFILES_BEFORE) $(MAKEFILES_BEFORE.$(BUILD_TARGET)) $(MAKEFILES_BEFORE.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2382	$(eval MAKEFILES_AFTER_$(PASS) ?= $(MAKEFILES_AFTER) $(MAKEFILES_AFTER.$(BUILD_TARGET)) $(MAKEFILES_AFTER.$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) )
2383
2384	$(eval tag:=_before)
2385	$(eval dep:=)
2386	$(foreach subdir,$(SUBDIRS_$(PASS)) $(SUBDIRS_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2387	$(foreach makefile,$(MAKEFILES_BEFORE_$(PASS)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_BEFORE_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)),$(eval $(def_pass_makefile)))
2388
2389	$(eval tag:=_after)
2390	$(eval dep:=pass_$(pass)_doit)
2391	$(foreach subdir,$(SUBDIRS_AFTER_$(PASS)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET)) $(SUBDIRS_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_subdir)))
2392	$(foreach makefile,$(MAKEFILES_AFTER_$(PASS)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET)) $(MAKEFILES_AFTER_$(PASS).$(BUILD_TARGET).$(BUILD_TARGET_ARCH)) ,$(eval $(def_pass_makefile)))
2393
2394	ifdef KBUILD_SAFE_PARALLEL
2395	.NOTPARALLEL: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_this
2396	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_this pass_$(pass)_doit
2397	pass_$(pass)_doit: $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$(var))
2398	pass_$(pass)_this: pass_$(pass)_before
2399	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)_doit
2400	pass_$(pass)_after:: pass_$(pass)_this
2401	pass_$(pass): pass_$(pass)_after
2402	else
2403	.NOTPARALLEL: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_doit
2404	.PHONY: pass_$(pass) pass_$(pass)_before pass_$(pass)_after pass_$(pass)_doit
2405	pass_$(pass)_doit: pass_$(pass)_before \
2406	$(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$($(var)))
2407	pass_$(pass): \
2408	pass_$(pass)_before \
2409	pass_$(pass)_doit \
2410	pass_$(pass)_after
2411	endif
2412
2413	#$ (warning pass=$(pass) PASS=$(PASS): $(PASS_$(PASS)_trgs) $(PASS_$(PASS)_trgs) $(foreach var,$(PASS_$(PASS)_vars),$($(var))))
2414	endef
2415
2416	# Generate the defined passes.
2417	$(foreach PASS, $(PASSES), \
2418	$(eval pass := $(PASS_$(PASS)_pass)) \
2419	$(eval $(def_pass)))
2420
2421	## Pass order
2422	# @param $(pass) Current pass name.
2423	# @param $(prev_pass) The previous pass name.
2424	define def_pass_order
2425	ifdef KBUILD_SAFE_PARALLEL
2426	.NOTPARALLEL: pass_$(pass)_order
2427	.PHONY: pass_$(pass)_order
2428	pass_$(pass)_order: $(pass_prev)
2429	$$(call MSG_PASS,$$(if $$(PASS_$(PASS)),$$(PASS_$(PASS)),$(pass)))
2430	+ $$(QUIET)$$(MAKE) -f $$(MAKEFILE) pass_$(pass)
2431	else
2432	.NOTPARALLEL: pass_$(pass)_order pass_$(pass)_banner
2433	.PHONY: pass_$(pass)_order pass_$(pass)_banner
2434	pass_$(pass)_banner:
2435	$$(call MSG_PASS,$$(if $$(PASS_$(PASS)),$$(PASS_$(PASS)),$(pass)))
2436	pass_$(pass)_order: \
2437	$(pass_prev) \
2438	pass_$(pass)_banner \
2439	pass_$(pass)
2440	endif
2441	$(eval pass_prev := pass_$(pass)_order)
2442	endef
2443
2444	## PASS: order
2445	# Use dependencies to ensure correct pass order.
2446	pass_prev :=
2447	$(foreach PASS,$(DEFAULT_PASSES),\
2448	$(eval pass := $(PASS_$(PASS)_pass)) \
2449	$(eval $(def_pass_order)))
2450
2451
2452
2453	#
2454	# THE MAIN RULES
2455	#
2456	all_recursive: $(pass_prev)
2457
2458	rebuild: clean
2459	+ $(MAKE) -f $(firstword $(MAKEFILE_LIST)) all_recursive
2460
2461	# @todo make this a non-default pass!
2462	uninstall:
2463	$(RM) -f $(_INSTALLS_FILES)
2464
2465	install: pass_installs
2466
2467	# misc shortcuts.
2468	targets: bldprogs libraries dlls programs sysmods others installs
2469	objects: $(_OBJS)
2470	bldprogs: $(_BLDPROGS)
2471	libraries: $(_LIBS) $(_IMPORT_LIBS) $(_OTHER_LIBRARIES)
2472	dlls: $(_DLLS)
2473	programs: $(_PROGRAMS)
2474	sysmods: $(_SYSMODS)
2475	others: $(_OTHERS)
2476	installs: $(_INSTALLS) $(_INSTALLS_DIRS) $(_INSTALLS_FILES)
2477
2478
2479
2480	#
2481	# kBuild debugging stuff.
2482	#
2483	show_targets:
2484	@$(foreach target, $(ALL_TARGETS),\
2485	@$(ECHO) "target: $(target)" $(NLTAB)\
2486	@$(ECHO) " PATH_$(target)=$(PATH_$(target))" $(NLTAB)\
2487	@$(ECHO) " TARGET_$(target)=$(TARGET_$(target))" $(NLTAB)\
2488	@$(ECHO) " INSTARGET_$(target)=$(INSTARGET_$(target))" $(NLTAB)\
2489	$(foreach prop,$(PROPS_SINGLE) $(PROPS_ACCUMULATE_L) $(PROPS_ACCUMULATE_R) OBJS_ CLEAN, \
2490	$(eval _tmp:=$(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))) \
2491	$(if $($(target)_$(prop).$(_tmp)),\
2492	@$(ECHO) " $(target)_$(prop).$(_tmp)=$($(target)_$(prop).$(_tmp))" $(NLTAB)) \
2493	$(if $($(target)_$(prop)), $(NLTAB)@$(ECHO) " $(target)_$(prop)=$($(target)_$(prop))" $(NLTAB)) \
2494	)\
2495	$(foreach prop,$(PROPS_DEFERRED), \
2496	$(eval _tmp:=$(firstword $($(target)_BLD_TRG) $(BUILD_TARGET))) \
2497	$(if $(value $(target)_$(prop).$(_tmp)),\
2498	@$(ECHO) ' $(target)_$(prop).$(_tmp)=$(value $(TARGET)_$(prop).$(_tmp))' $(NLTAB)) \
2499	$(if $(value $(target)_$(prop)), $(NLTAB)@$(ECHO) ' $(target)_$(prop)=$(value $(target)_$(prop))' $(NLTAB)) \
2500	))
2501
2502
2503
2504	#
2505	# Include dependency files.
2506	#
2507	ifneq ($(_DEPFILES),)
2508	includedep $(_DEPFILES)
2509	endif
2510
2511
2512	# end-of-file-content
2513	__footer_kmk__ := target
2514	endif # __footer_kmk__
2515

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

Download in other formats:

Original Format