Context Navigation

footer.kmk@ 873

Last change on this file since 873 was 859, checked in by bird, 18 years ago
Implemented PRE_CMDS and POST_CMDS for linking.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 83.5 KB

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

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

Download in other formats:

Original Format