Context Navigation

footer.kmk@ 731

Last change on this file since 731 was 730, checked in by bird, 19 years ago
Added a variation on the $(comp-vars_{) function called $(comp-cmds}) which compares command by command instead of the string as a whole ignoring spaces and job control chars.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 72.7 KB

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

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

Download in other formats:

Original Format