source: trunk/kBuild/header.kmk@ 577

Last change on this file since 577 was 576, checked in by bird, 19 years ago

versioning. fixes #5

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 16.0 KB
Line 
1# $Id: header.kmk 576 2006-11-23 09:58:23Z bird $
2## @file
3#
4# kBuild - File included at top of makefile.
5#
6# Copyright (c) 2004-2005 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 2 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
27ifndef __header_kmk__
28# start-of-file-content
29
30#
31# default rule
32#
33all: all_recursive
34
35#
36# The FORCE rule.
37#
38FORCE:
39
40#
41# Try avoid inference rules.
42#
43.SUFFIXES:
44SUFFIXES :=
45
46
47#
48# General purpose macros.
49#
50
51## get last word in a list.
52# @returns last word in $1.
53# @param $1 Word list.
54lastword = $(word $(words $(1)), $(1))
55
56##
57# Newline character(s).
58define NL
59
60
61endef
62
63##
64# Tab character.
65TAB := $(subst ., ,.)
66
67##
68# Space character.
69SP := $(subst ., ,.)
70
71##
72# Checks if two strings are equal.
73# @returns blank if equal
74# @returns non-blank if not equal.
75# @param $1 String 1.
76# @param $2 String 2
77STRCMP = $( todo )
78
79#
80# Assert build type.
81#
82ifndef BUILD_TYPE
83ifndef BUILD_MODE
84$(error kBuild: You must define BUILD_TYPE!)
85endif
86BUILD_TYPE := $(BUILD_MODE)
87endif
88ifeq ($(BUILD_TYPE),DEBUG)
89BUILD_TYPE := debug
90endif
91ifeq ($(BUILD_TYPE),RELEASE)
92BUILD_TYPE := release
93endif
94ifeq ($(BUILD_TYPE),PROFILE)
95BUILD_TYPE := profile
96endif
97
98
99#
100# Assert build platform.
101#
102ifndef BUILD_PLATFORM
103 $(error kBuild: BUILD_PLATFORM is undefined!)
104else
105 BUILD_PLATFORM := $(strip $(BUILD_PLATFORM))
106 ifneq ($(words $(BUILD_PLATFORM))$(filter-out darwin freebsd l4 linux nt os2 win win32 win64,$(BUILD_PLATFORM)),1)
107 # OS/2 (have uppercase legacy)
108 ifeq ($(BUILD_PLATFORM),OS2)
109 $(error kBuild: BUILD_PLATFORM must be all lowercase!)
110 endif
111 $(error kBuild: BUILD_PLATFORM value '$(BUILD_PLATFORM)' was not recognized!)
112 endif
113endif
114
115# Fill in defaults if needed.
116ifndef BUILD_PLATFORM_ARCH
117 ifeq ($(filter-out win64,$(BUILD_PLATFORM)),)
118 BUILD_PLATFORM_ARCH := amd64
119 else
120 BUILD_PLATFORM_ARCH := x86
121 endif
122endif
123ifndef BUILD_PLATFORM_CPU
124 ifeq ($(filter-out amd64,$(BUILD_PLATFORM_ARCH)),)
125 BUILD_PLATFORM_CPU:= k8
126 else
127 BUILD_PLATFORM_CPU:= i586
128 endif
129endif
130
131
132#
133# Assert target platform.
134#
135ifndef BUILD_TARGET
136# not defined, set to the same as build platform
137BUILD_TARGET := $(BUILD_PLATFORM)
138else
139 BUILD_TARGET := $(strip $(BUILD_TARGET))
140 ifneq ($(words $(BUILD_TARGET))$(filter-out darwin freebsd l4 linux nt os2 win win32 win64,$(BUILD_TARGET)),1)
141 # OS/2 (have uppercase legacy)
142 ifeq ($(BUILD_TARGET),OS2)
143 $(error kBuild: BUILD_TARGET must be all lowercase!)
144 endif
145 $(error kBuild: BUILD_TARGET value '$(BUILD_TARGET)' was not recognized!)
146 endif
147endif
148
149# Fill in defaults if needed.
150ifndef BUILD_TARGET_ARCH
151 BUILD_TARGET_ARCH := x86
152endif
153ifndef BUILD_TARGET_CPU
154 BUILD_TARGET_CPU := i586
155endif
156
157# Adjust the DEPTH definition first
158ifeq ($(strip $(DEPTH)),)
159DEPTH := .
160endif
161
162#
163# Common definitions.
164#
165PATH_CURRENT := $(abspath $(CURDIR))
166ifneq ($(strip $(SUB_DEPTH)),)
167PATH_SUB_CURRENT := $(abspath $(PATH_CURRENT)/$(SUB_DEPTH))
168else
169PATH_SUB_CURRENT := $(PATH_CURRENT)
170endif
171PATH_ROOT := $(abspath $(PATH_CURRENT)/$(DEPTH))
172
173# Subdirectory relative to the root.
174ifneq ($(PATH_ROOT),$(PATH_CURRENT))
175CURSUBDIR := $(patsubst $(PATH_ROOT)/%,%,$(PATH_SUB_CURRENT))
176else
177CURSUBDIR := .
178endif
179
180# Output directories.
181ifndef PATH_OUT_BASE
182PATH_OUT_BASE := $(PATH_ROOT)/out
183endif
184ifndef PATH_OUT
185ifdef BUILD_TARGET_SUB # (BUILD_TARGET_SUB is not currently recognized by kBuild in any other places.)
186PATH_OUT := $(PATH_OUT_BASE)/$(BUILD_TARGET).$(BUILD_TARGET_ARCH).$(BUILD_TARGET_SUB)/$(BUILD_TYPE)
187else
188PATH_OUT := $(PATH_OUT_BASE)/$(BUILD_TARGET).$(BUILD_TARGET_ARCH)/$(BUILD_TYPE)
189endif
190endif # !define PATH_OUT
191PATH_OBJ = $(PATH_OUT)/obj
192PATH_TARGET = $(PATH_OBJ)/$(CURSUBDIR)
193PATH_INS = $(PATH_OUT)
194PATH_BIN = $(PATH_INS)/bin
195PATH_DLL = $(PATH_INS)/bin
196PATH_SYS = $(PATH_INS)/bin
197PATH_LIB = $(PATH_INS)/lib
198PATH_DOC = $(PATH_INS)/doc
199
200# Usually kBuild is external to the source tree.
201ifndef PATH_KBUILD
202PATH_KBUILD := $(PATH_ROOT)/kBuild
203endif
204PATH_KBUILD := $(abspath $(PATH_KBUILD))
205# kBuild files which might be of interest.
206FILE_KBUILD_HEADER := $(PATH_KBUILD)/header.kmk
207FILE_KBUILD_CONFIG := $(PATH_KBUILD)/config.kmk
208FILE_KBUILD_FOOTER := $(PATH_KBUILD)/footer.kmk
209
210SUFF_DEP := .dep
211MAKEFILE := $(firstword $(MAKEFILE_LIST))
212
213
214#
215# Check make version.
216#
217ifdef KMK_VERSION
218 ifneq ($(KBUILD_VERSION_MAJOR).$(KBUILD_VERSION_MINOR),0.1)
219 ifneq ($(KBUILD_VERSION_MAJOR),0)
220 $(warning kBuild: kmk major version mismatch, expected '0' found '$(KBUILD_VERSION_MAJOR)'!)
221 else
222 $(warning kBuild: kmk minor version mismatch, expected '1' found '$(KBUILD_VERSION_MINOR)'!)
223 endif
224 endif
225else
226 # Vanilla GNU Make. Only supported for kBuild bootstrapping. Disable some features to make it work.
227 NO_COMPILE_CMDS_DEPS:= 1
228 NO_LINK_CMDS_DEPS := 1
229 sinclude $(PATH_KBUILD)/StampOutPredefines.kmk
230 ifndef IS_BOOTSTRAPPING_KBUILD_NOW
231 $(warning kBuild: Using vanilla GNU make isn't safe for anything but kBuild bootstrapping!)
232 endif
233endif
234
235
236#
237# Build platform setup.
238#
239# OS/2
240ifeq ($(BUILD_PLATFORM),os2)
241EXEC_X86_WIN32 := innopec.exe
242HOSTSUFF_EXE := .exe
243endif
244
245# Linux
246ifeq ($(BUILD_PLATFORM),linux)
247EXEC_X86_WIN32 := wine
248HOSTSUFF_EXE :=
249endif
250
251# Win, Win32, Win64, NT.
252ifeq ($(filter-out win32 win64 win nt,$(BUILD_PLATFORM)),)
253EXEC_X86_WIN32 :=
254HOSTSUFF_EXE := .exe
255endif
256
257# FreeBSD
258ifeq ($(BUILD_PLATFORM),freebsd)
259EXEC_X86_WIN32 := wine
260HOSTSUFF_EXE :=
261endif
262
263# Darwin / Mac OS X
264ifeq ($(BUILD_PLATFORM),darwin)
265EXEC_X86_WIN32 := false
266HOSTSUFF_EXE :=
267endif
268
269
270PATH_TOOLS := $(PATH_KBUILD)/bin/$(BUILD_PLATFORM_ARCH).$(BUILD_PLATFORM)
271ifeq ($(wildcard $(PATH_TOOLS)/kmk_ash$(HOSTSUFF_EXE)),)
272 ifeq ($(BUILD_TARGET_ARCH),amd64)
273 PATH_TOOLS := $(PATH_KBUILD)/bin/x86.$(BUILD_PLATFORM)
274 endif
275 ifeq ($(wildcard $(PATH_TOOLS)/kmk_ash$(HOSTSUFF_EXE)),)
276 ifeq ($(filter-out win64 win nt ,$(BUILD_PLATFORM)),)
277 PATH_TOOLS := $(PATH_KBUILD)/bin/x86.win32
278 endif
279 endif
280 ifeq ($(wildcard $(PATH_TOOLS)/kmk_ash$(HOSTSUFF_EXE)),)
281 # give up
282 PATH_TOOLS := $(PATH_KBUILD)/bin/$(BUILD_PLATFORM_ARCH).$(BUILD_PLATFORM)
283 endif
284endif
285
286
287#
288# Build target setup.
289#
290ifeq ($(filter-out win32 win64 win nt os2,$(BUILD_TARGET)),)
291SUFF_OBJ := .obj
292SUFF_LIB := .lib
293SUFF_DLL := .dll
294SUFF_EXE := .exe
295SUFF_SYS := .sys
296SUFF_RES := .res
297endif
298ifeq ($(BUILD_TARGET),l4)
299SUFF_OBJ := .o
300SUFF_LIB := .a
301SUFF_DLL := .s.so
302SUFF_EXE :=
303SUFF_SYS := .a
304SUFF_RES :=
305endif
306ifeq ($(BUILD_TARGET),darwin)
307SUFF_OBJ := .o
308SUFF_LIB := .a
309SUFF_DLL := .dylib
310SUFF_EXE :=
311SUFF_SYS := .a
312SUFF_RES :=
313endif
314ifndef SUFF_OBJ
315SUFF_OBJ := .o
316SUFF_LIB := .a
317SUFF_DLL := .so
318SUFF_EXE :=
319SUFF_SYS := .a
320SUFF_RES :=
321endif
322
323#
324# Standard kBuild tools.
325#
326ifeq ($(MAKE),kmk)
327MAKE := $(PATH_TOOLS)/kmk$(HOSTSUFF_EXE)
328endif
329
330DEP_EXT := $(PATH_TOOLS)/kDep$(HOSTSUFF_EXE)
331ifeq ($(filter kDep,$(KMK_BUILTIN)),kDep)
332DEP := kmk_builtin_kDep
333else
334DEP := $(DEP_EXT)
335endif
336
337DEP_IDB_EXT := $(PATH_TOOLS)/kDepIDB$(HOSTSUFF_EXE)
338ifeq ($(filter kDepPre,$(KMK_BUILTIN)),kDepIDB)
339DEP_IDB := $(if kmk_builtin_kDepIDB
340else
341DEP_IDB := $(DEP_IDB_EXT)
342endif
343
344DEP_PRE_EXT := $(PATH_TOOLS)/kDepPre$(HOSTSUFF_EXE)
345ifeq ($(filter kDepPre,$(KMK_BUILTIN)),kDepPre)
346DEP_PRE := $(if kmk_builtin_kDepPre
347else
348DEP_PRE := $(DEP_PRE_EXT)
349endif
350
351APPEND_EXT := $(PATH_TOOLS)/kmk_append$(HOSTSUFF_EXE)
352ifeq ($(filter append,$(KMK_BUILTIN)),append)
353APPEND := kmk_builtin_append
354else
355APPEND := $(APPEND_EXT)
356endif
357
358CAT_EXT := $(PATH_TOOLS)/kmk_cat$(HOSTSUFF_EXE)
359ifeq ($(filter cat,$(KMK_BUILTIN)),cat)
360CAT := kmk_builtin_cat
361else
362CAT := $(CAT_EXT)
363endif
364
365CP_EXT := $(PATH_TOOLS)/kmk_cp$(HOSTSUFF_EXE)
366ifeq ($(filter cp,$(KMK_BUILTIN)),cp)
367CP := kmk_builtin_cp
368else
369CP := $(CP_EXT)
370endif
371
372ECHO_EXT := $(PATH_TOOLS)/kmk_echo$(HOSTSUFF_EXE)
373ifeq ($(filter echo,$(KMK_BUILTIN)),echo)
374ECHO := kmk_builtin_echo
375else
376ECHO := $(ECHO_EXT)
377endif
378
379INSTALL_EXT := $(PATH_TOOLS)/kmk_install$(HOSTSUFF_EXE)
380ifeq ($(filter install,$(KMK_BUILTIN)),install)
381INSTALL := kmk_builtin_install
382else
383INSTALL := $(INSTALL_EXT)
384endif
385
386LN_EXT := $(PATH_TOOLS)/kmk_ln$(HOSTSUFF_EXE)
387ifeq ($(filter ln,$(KMK_BUILTIN)),ln)
388LN := kmk_builtin_ln
389else
390LN := $(LN_EXT)
391endif
392
393MKDIR_EXT := $(PATH_TOOLS)/kmk_mkdir$(HOSTSUFF_EXE)
394ifeq ($(filter mkdir,$(KMK_BUILTIN)),mkdir)
395MKDIR := kmk_builtin_mkdir
396else
397MKDIR := $(MKDIR_EXT)
398endif
399
400MV_EXT := $(PATH_TOOLS)/kmk_mv$(HOSTSUFF_EXE)
401ifeq ($(filter mv,$(KMK_BUILTIN)),mv)
402MV := kmk_builtin_mv
403else
404MV := $(MV_EXT)
405endif
406
407RM_EXT := $(PATH_TOOLS)/kmk_rm$(HOSTSUFF_EXE)
408ifeq ($(filter rm,$(KMK_BUILTIN)),rm)
409RM := kmk_builtin_rm
410else
411RM := $(RM_EXT)
412endif
413
414SED_EXT := $(PATH_TOOLS)/kmk_sed$(HOSTSUFF_EXE)
415ifeq ($(filter sed,$(KMK_BUILTIN)),sed)
416SED := kmk_builtin_sed
417else
418SED := $(SED_EXT)
419endif
420
421# Our default shell is the Almquist shell from *BSD.
422ASH := $(PATH_TOOLS)/kmk_ash$(HOSTSUFF_EXE)
423MAKESHELL := $(ASH)
424SHELL := $(ASH)
425export SHELL MAKESHELL
426
427# Symlinking is problematic on some platforms...
428LN_SYMLINK := $(LN) -s
429
430
431
432#
433# Message macros.
434#
435
436ifndef BUILD_QUIET
437ifdef BUILD_DEBUG
438BUILD_VERBOSE := 9
439endif
440MSG_L1 = @$(ECHO) "kBuild: $1"
441ifdef BUILD_VERBOSE
442MSG_L2 = @$(ECHO) "kBuild: $1"
443QUIET :=
444else
445QUIET := @
446MSG_L2 =
447endif
448ifdef BUILD_DEBUG
449MSG_L3 = @$(ECHO) "kBuild: $1"
450else
451MSG_L3 =
452endif
453else
454QUIET :=
455MSG_L1 =
456MSG_L2 =
457MSG_L3 =
458endif
459
460## ABSPATH - make paths absolute.
461# This implementation is clumsy and doesn't resolve '..' and '.' components.
462#
463# @param $1 The paths to make absolute.
464ABSPATH = $(abspath $(1))
465
466## DIRDEP - make create directory dependencies.
467#
468# @param $1 The paths to the directories which must be created.
469DIRDEP = $(foreach path,$(patsubst %/,%,$(1)),$(path)/)
470
471
472## Cygwin kludge.
473# This converts /cygdrive/x/% to x:%.
474#
475# @param $1 The paths to make native.
476# @remark This macro is pretty much obsolete since we don't use cygwin base make.
477ifneq ($(patsubst /cygdrive/%,%,$(CURDIR)),$(CURDIR))
478CYGPATHMIXED = $(foreach path,$(1)\
479 ,$(if $(patsubst /cygdrive/%,,$(path)),$(path),$(patsubst $(strip $(firstword $(subst /, ,$(patsubst /cygdrive/%,%,$(path)))))/%,$(strip $(firstword $(subst /, ,$(patsubst /cygdrive/%,%,$(path))))):/%,$(patsubst /cygdrive/%,%,$(path)))))
480else
481CYGPATHMIXED = $(1)
482endif
483
484#
485# Initialize some of the globals which the Config.kmk and
486# others can add stuff to if they like for processing in the footer.
487#
488
489## ALL_TARGET
490# This is the list of all targets.
491ALL_TARGETS :=
492
493## TEMPLATE_PATHS
494# List a paths (separated by space) where templates can be found.
495TEMPLATE_PATHS :=
496
497## TOOL_PATHS
498# List of paths (separated by space) where tools can be found.
499TOOL_PATHS :=
500
501## SDK_PATHS
502# List of paths (separated by space) where SDKs can be found.
503SDK_PATHS :=
504
505## Proritized list of the default makefile when walking subdirectories.
506# The user can overload this list.
507DEFAULT_MAKEFILE := Makefile.kmk makefile.kmk Makefile makefile
508
509## PROPS_SINGLE
510# The list of non-accumulative target properties.
511# A Config.kmk file can add it's own properties to this list and kBuild
512# will do the necessary inheritance from templates to targets.
513PROPS_SINGLE := TOOL ARTOOL CTOOL CXXTOOL ASTOOL LDTOOL INST NOINST
514
515## PROPS_DEFERRED
516# This list of non-accumulative target properties which are functions,
517# and thus should not be expanded until the very last moment.
518PROPS_DEFERRED := INSTFUN INSTALLER
519
520## PROPS_ACCUMULATE
521# The list of accumulative target properties.
522# A Config.kmk file can add it's own properties to this list and kBuild
523# will do the necessary inheritance from templates to targets.
524PROPS_ACCUMULATE := \
525 SDKS DEFS DEPS INCS SOURCES \
526 COPTS CFLAGS CDEFS CINCS CXXOPTS CXXFLAGS CXXDEFS CXXINCS \
527 ASOPTS ASFLAGS ASDEFS ASINCS \
528 LDFLAGS LIBS LIBPATH \
529 BLD_TYPE BLD_TRG BLD_TRG_ARCH BLD_TRG_CPU \
530 SYSSUFF EXESUFF DLLSUFF LIBSUFF ARLIBSUFF \
531
532
533## PROPS_TOOLS
534# This is a subset of the other PROPS
535PROPS_TOOLS := TOOL CTOOL CXXTOOL ASTOOL ARTOOL LDTOOL
536
537
538#
539# Pass configuration.
540#
541# The PASS_<passname>_trgs variable is listing the targets.
542# The PASS_<passname>_vars variable is listing the target variables.
543# The PASS_<passname>_pass variable is the lowercased passname.
544#
545
546## PASS: bldprogs
547# This pass builds targets which are required for building the rest.
548PASS_BLDPROGS := Build Programs
549PASS_BLDPROGS_trgs :=
550PASS_BLDPROGS_vars := _BLDPROGS
551PASS_BLDPROGS_pass := bldprogs
552
553## PASS: libraries
554# This pass builds library targets.
555PASS_LIBRARIES := Libraries
556PASS_LIBRARIES_trgs :=
557PASS_LIBRARIES_vars := _LIBS _IMPORT_LIBS _OTHER_LIBRARIES
558PASS_LIBRARIES_pass := libraries
559
560## PASS: binaries
561# This pass builds dll targets.
562PASS_DLLS := DLLs
563PASS_DLLS_trgs :=
564PASS_DLLS_vars := _DLLS _OTHER_DLLS
565PASS_DLLS_pass := dlls
566
567## PASS: binaries
568# This pass builds binary targets, i.e. programs, system modules and stuff.
569PASS_BINARIES := Programs
570PASS_BINARIES_trgs :=
571PASS_BINARIES_vars := _PROGRAMS _SYSMODS _OTHER_BINARIES
572PASS_BINARIES_pass := binaries
573
574## PASS: others
575# This pass builds other targets.
576PASS_OTHERS := Other Stuff
577PASS_OTHERS_trgs :=
578PASS_OTHERS_vars := _OTHERS
579PASS_OTHERS_pass := others
580
581## PASS: install
582# This pass installs the built entities to a sandbox area.
583PASS_INSTALLS := Install
584PASS_INSTALLS_trgs :=
585PASS_INSTALLS_vars := _INSTALLS_DIRS _INSTALLS
586PASS_INSTALLS_pass := installs
587
588## PASS: packing
589# This pass processes custom packing rules.
590PASS_PACKING := Packing
591PASS_PACKING_trgs :=
592PASS_PACKING_vars := _PACKING
593PASS_PACKING_pass := packing
594#alias
595packing: pass_packing
596
597## PASS: clean
598# This pass removes all generated files.
599PASS_CLEAN := Clean
600PASS_CLEAN_trgs := do-clean
601PASS_CLEAN_vars :=
602PASS_CLEAN_pass := clean
603# alias
604clean: pass_clean
605
606## PASS: nothing
607# This pass just walks the tree.
608PASS_NOTHING := Nothing
609PASS_NOTHING_trgs := do-nothing
610PASS_NOTHING_vars :=
611PASS_NOTHING_pass := nothing
612# alias
613nothing: pass_nothing
614
615## DEFAULT_PASSES
616# The default passes and their order.
617DEFAULT_PASSES := BLDPROGS LIBRARIES DLLS BINARIES OTHERS INSTALLS
618
619## PASSES
620# The passes that should be defined. This must include
621# all passes mentioned by DEFAULT_PASSES.
622PASSES := $(DEFAULT_PASSES) NOTHING CLEAN
623
624
625#
626# This is how we find the closest config.kmk.
627# It's a little hacky but I think it works fine.
628#
629_CFGDIR := .
630_CFGFILES := ./Config.kmk ./config.kmk
631define def_include_config
632$(eval _CFGDIR := $(_CFGDIR)/$(dir))
633_CFGFILES += $(_CFGDIR)/Config.kmk $(_CFGDIR)/config.kmk
634endef
635# walk down the _RELATIVE_ path specified by DEPTH.
636$(foreach dir,$(subst /, ,$(DEPTH)), $(eval $(def_include_config)) )
637# add the default config file.
638_CFGFILE := $(firstword $(wildcard $(_CFGFILES) $(FILE_KBUILD_CONFIG)))
639_CFGFILES :=
640_CFGDIR :=
641ifeq ($(_CFGFILE),)
642$(error kBuild: no Config.kmk file found! Check the DEPTH: DEPTH='$(DEPTH)' PATH_CURRENT='$(PATH_CURRENT)')
643endif
644
645# Include the config.kmk we found file (or the default one).
646include $(_CFGFILE)
647
648
649# end-of-file-content
650__header_kmk__ := 1
651endif # __header_kmk__
652
Note: See TracBrowser for help on using the repository browser.