Blame view

scripts/Kbuild.include 11.5 KB
ceec4c874   Masahiro Yamada   kbuild: import Kb...
1
2
3
4
5
  ####
  # kbuild: Generic definitions
  
  # Convenient variables
  comma   := ,
598e2d338   Masahiro Yamada   kbuild: sync with...
6
  quote   := "
ceec4c874   Masahiro Yamada   kbuild: import Kb...
7
8
9
  squote  := '
  empty   :=
  space   := $(empty) $(empty)
e5e701c2b   Rasmus Villemoes   Kbuild: fix # esc...
10
  pound := \#
ceec4c874   Masahiro Yamada   kbuild: import Kb...
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
  
  ###
  # Name of target with a '.' as filename prefix. foo/bar.o => foo/.bar.o
  dot-target = $(dir $@).$(notdir $@)
  
  ###
  # The temporary file to save gcc -MD generated dependencies must not
  # contain a comma
  depfile = $(subst $(comma),_,$(dot-target).d)
  
  ###
  # filename of target with directory and extension stripped
  basetarget = $(basename $(notdir $@))
  
  ###
  # filename of first prerequisite with directory and extension stripped
  baseprereq = $(basename $(notdir $<))
  
  ###
  # Escape single quote for use in echo statements
  escsq = $(subst $(squote),'\$(squote)',$1)
  
  ###
  # Easy method for doing a status message
         kecho := :
   quiet_kecho := echo
  silent_kecho := :
  kecho := $($(quiet)kecho)
  
  ###
  # filechk is used to check if the content of a generated file is updated.
  # Sample usage:
  # define filechk_sample
  #	echo $KERNELRELEASE
  # endef
  # version.h : Makefile
  #	$(call filechk,sample)
  # The rule defined shall write to stdout the content of the new file.
  # The existing file will be compared with the new one.
  # - If no file exist it is created
  # - If the content differ the new file is used
  # - If they are equal no change, and no timestamp update
  # - stdin is piped in from the first prerequisite ($<) so one has
  #   to specify a valid file as first prerequisite (often the kbuild file)
  define filechk
  	$(Q)set -e;				\
  	$(kecho) '  CHK     $@';		\
  	mkdir -p $(dir $@);			\
  	$(filechk_$(1)) < $< > $@.tmp;		\
  	if [ -r $@ ] && cmp -s $@ $@.tmp; then	\
  		rm -f $@.tmp;			\
  	else					\
  		$(kecho) '  UPD     $@';	\
  		mv -f $@.tmp $@;		\
  	fi
  endef
  
  ######
  # gcc support functions
  # See documentation in Documentation/kbuild/makefiles.txt
  
  # cc-cross-prefix
  # Usage: CROSS_COMPILE := $(call cc-cross-prefix, m68k-linux-gnu- m68k-linux-)
  # Return first prefix where a prefix$(CC) is found in PATH.
  # If no $(CC) found in PATH with listed prefixes return nothing
  cc-cross-prefix =  \
  	$(word 1, $(foreach c,$(1),                                   \
  		$(shell set -e;                                       \
  		if (which $(strip $(c))$(CC)) > /dev/null 2>&1 ; then \
  			echo $(c);                                    \
  		fi)))
  
  # output directory for tests below
  TMPOUT := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/)
  
  # try-run
  # Usage: option = $(call try-run, $(CC)...-o "$$TMP",option-ok,otherwise)
  # Exit code chooses option. "$$TMP" is can be used as temporary file and
  # is automatically cleaned up.
9a368d0f5   Masahiro Yamada   kbuild: Do not ge...
90
  # modifed for U-Boot: prevent cc-option from leaving .*.su files
ceec4c874   Masahiro Yamada   kbuild: import Kb...
91
92
93
  try-run = $(shell set -e;		\
  	TMP="$(TMPOUT).$$$$.tmp";	\
  	TMPO="$(TMPOUT).$$$$.o";	\
9a368d0f5   Masahiro Yamada   kbuild: Do not ge...
94
  	TMPSU="$(TMPOUT).$$$$.su";	\
ceec4c874   Masahiro Yamada   kbuild: import Kb...
95
96
97
98
  	if ($(1)) >/dev/null 2>&1;	\
  	then echo "$(2)";		\
  	else echo "$(3)";		\
  	fi;				\
9a368d0f5   Masahiro Yamada   kbuild: Do not ge...
99
  	rm -f "$$TMP" "$$TMPO" "$$TMPSU")
ceec4c874   Masahiro Yamada   kbuild: import Kb...
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
  
  # as-option
  # Usage: cflags-y += $(call as-option,-Wa$(comma)-isa=foo,)
  
  as-option = $(call try-run,\
  	$(CC) $(KBUILD_CFLAGS) $(1) -c -x assembler /dev/null -o "$$TMP",$(1),$(2))
  
  # as-instr
  # Usage: cflags-y += $(call as-instr,instr,option1,option2)
  
  as-instr = $(call try-run,\
  	printf "%b
  " "$(1)" | $(CC) $(KBUILD_AFLAGS) -c -x assembler -o "$$TMP" -,$(2),$(3))
  
  # cc-option
  # Usage: cflags-y += $(call cc-option,-march=winchip-c6,-march=i586)
  
  cc-option = $(call try-run,\
1401d87b4   Jeroen Hofstee   cc-option: also d...
118
  	$(CC) -Werror $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(1) -c -x c /dev/null -o "$$TMP",$(1),$(2))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
119
120
121
122
  
  # cc-option-yn
  # Usage: flag := $(call cc-option-yn,-march=winchip-c6)
  cc-option-yn = $(call try-run,\
1401d87b4   Jeroen Hofstee   cc-option: also d...
123
  	$(CC) -Werror $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(1) -c -x c /dev/null -o "$$TMP",y,n)
ceec4c874   Masahiro Yamada   kbuild: import Kb...
124
125
126
127
128
129
130
131
132
133
  
  # cc-option-align
  # Prefix align with either -falign or -malign
  cc-option-align = $(subst -functions=0,,\
  	$(call cc-option,-falign-functions=0,-malign-functions=0))
  
  # cc-disable-warning
  # Usage: cflags-y += $(call cc-disable-warning,unused-but-set-variable)
  cc-disable-warning = $(call try-run,\
  	$(CC) $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) -W$(strip $(1)) -c -x c /dev/null -o "$$TMP",-Wno-$(strip $(1)))
29c4d281b   Tom Rini   kbuild: Add clang...
134
135
136
  # cc-name
  # Expands to either gcc or clang
  cc-name = $(shell $(CC) -v 2>&1 | grep -q "clang version" && echo clang || echo gcc)
ceec4c874   Masahiro Yamada   kbuild: import Kb...
137
  # cc-version
ceec4c874   Masahiro Yamada   kbuild: import Kb...
138
139
140
  cc-version = $(shell $(CONFIG_SHELL) $(srctree)/scripts/gcc-version.sh $(CC))
  
  # cc-fullversion
ceec4c874   Masahiro Yamada   kbuild: import Kb...
141
142
143
144
145
  cc-fullversion = $(shell $(CONFIG_SHELL) \
  	$(srctree)/scripts/gcc-version.sh -p $(CC))
  
  # cc-ifversion
  # Usage:  EXTRA_CFLAGS += $(call cc-ifversion, -lt, 0402, -O1)
98bd0e0d9   Masahiro Yamada   kbuild: sync with...
146
  cc-ifversion = $(shell [ $(cc-version) $(1) $(2) ] && echo $(3) || echo $(4))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
147

bf4b3de10   Masahiro Yamada   kbuild: Use Kbuil...
148
149
150
  # added for U-Boot
  binutils-version = $(shell $(CONFIG_SHELL) $(srctree)/scripts/binutils-version.sh $(AS))
  dtc-version = $(shell $(CONFIG_SHELL) $(srctree)/scripts/dtc-version.sh $(DTC))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
151
152
153
154
155
156
157
158
159
160
161
162
163
164
  # cc-ldoption
  # Usage: ldflags += $(call cc-ldoption, -Wl$(comma)--hash-style=both)
  cc-ldoption = $(call try-run,\
  	$(CC) $(1) -nostdlib -x c /dev/null -o "$$TMP",$(1),$(2))
  
  # ld-option
  # Usage: LDFLAGS += $(call ld-option, -X)
  ld-option = $(call try-run,\
  	$(CC) -x c /dev/null -c -o "$$TMPO" ; $(LD) $(1) "$$TMPO" -o "$$TMP",$(1),$(2))
  
  # ar-option
  # Usage: KBUILD_ARFLAGS := $(call ar-option,D)
  # Important: no spaces around options
  ar-option = $(call try-run, $(AR) rc$(1) "$$TMP",$(1),$(2))
598e2d338   Masahiro Yamada   kbuild: sync with...
165
  # ld-version
598e2d338   Masahiro Yamada   kbuild: sync with...
166
167
168
169
170
  # Note this is mainly for HJ Lu's 3 number binutil versions
  ld-version = $(shell $(LD) --version | $(srctree)/scripts/ld-version.sh)
  
  # ld-ifversion
  # Usage:  $(call ld-ifversion, -ge, 22252, y)
98bd0e0d9   Masahiro Yamada   kbuild: sync with...
171
  ld-ifversion = $(shell [ $(ld-version) $(1) $(2) ] && echo $(3) || echo $(4))
598e2d338   Masahiro Yamada   kbuild: sync with...
172

ceec4c874   Masahiro Yamada   kbuild: import Kb...
173
174
175
176
177
178
  ######
  
  ###
  # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.build obj=
  # Usage:
  # $(Q)$(MAKE) $(build)=dir
176d09827   Masahiro Yamada   kbuild: sync misc...
179
  build := -f $(srctree)/scripts/Makefile.build obj
ceec4c874   Masahiro Yamada   kbuild: import Kb...
180
181
182
183
184
  
  ###
  # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.modbuiltin obj=
  # Usage:
  # $(Q)$(MAKE) $(modbuiltin)=dir
176d09827   Masahiro Yamada   kbuild: sync misc...
185
  modbuiltin := -f $(srctree)/scripts/Makefile.modbuiltin obj
ceec4c874   Masahiro Yamada   kbuild: import Kb...
186

98bd0e0d9   Masahiro Yamada   kbuild: sync with...
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
  ###
  # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.dtbinst obj=
  # Usage:
  # $(Q)$(MAKE) $(dtbinst)=dir
  dtbinst := -f $(if $(KBUILD_SRC),$(srctree)/)scripts/Makefile.dtbinst obj
  
  ###
  # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.clean obj=
  # Usage:
  # $(Q)$(MAKE) $(clean)=dir
  clean := -f $(srctree)/scripts/Makefile.clean obj
  
  ###
  # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.headersinst obj=
  # Usage:
  # $(Q)$(MAKE) $(hdr-inst)=dir
  hdr-inst := -f $(srctree)/scripts/Makefile.headersinst obj
ceec4c874   Masahiro Yamada   kbuild: import Kb...
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
  # Prefix -I with $(srctree) if it is not an absolute path.
  # skip if -I has no parameter
  addtree = $(if $(patsubst -I%,%,$(1)), \
  $(if $(filter-out -I/%,$(1)),$(patsubst -I%,-I$(srctree)/%,$(1))) $(1))
  
  # Find all -I options and call addtree
  flags = $(foreach o,$($(1)),$(if $(filter -I%,$(o)),$(call addtree,$(o)),$(o)))
  
  # echo command.
  # Short version is used, if $(quiet) equals `quiet_', otherwise full one.
  echo-cmd = $(if $($(quiet)cmd_$(1)),\
  	echo '  $(call escsq,$($(quiet)cmd_$(1)))$(echo-why)';)
  
  # printing commands
  cmd = @$(echo-cmd) $(cmd_$(1))
  
  # Add $(obj)/ for paths that are not absolute
  objectify = $(foreach o,$(1),$(if $(filter /%,$(o)),$(o),$(obj)/$(o)))
  
  ###
  # if_changed      - execute command if any prerequisite is newer than
  #                   target, or command line has changed
  # if_changed_dep  - as if_changed, but uses fixdep to reveal dependencies
  #                   including used config symbols
  # if_changed_rule - as if_changed but execute rule instead
  # See Documentation/kbuild/makefiles.txt for more info
  
  ifneq ($(KBUILD_NOCMDDEP),1)
  # Check if both arguments has same arguments. Result is empty string if equal.
  # User may override this check using make KBUILD_NOCMDDEP=1
  arg-check = $(strip $(filter-out $(cmd_$(1)), $(cmd_$@)) \
                      $(filter-out $(cmd_$@),   $(cmd_$(1))) )
  else
  arg-check = $(if $(strip $(cmd_$@)),,1)
  endif
176d09827   Masahiro Yamada   kbuild: sync misc...
239
240
  # Replace >$< with >$$< to preserve $ when reloading the .cmd file
  # (needed for make)
e5e701c2b   Rasmus Villemoes   Kbuild: fix # esc...
241
  # Replace >#< with >$(pound)< to avoid starting a comment in the .cmd file
176d09827   Masahiro Yamada   kbuild: sync misc...
242
243
244
  # (needed for make)
  # Replace >'< with >'\''< to be able to enclose the whole string in '...'
  # (needed for the shell)
e5e701c2b   Rasmus Villemoes   Kbuild: fix # esc...
245
  make-cmd = $(call escsq,$(subst $(pound),$$(pound),$(subst $$,$$$$,$(cmd_$(1)))))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
246
247
248
249
250
251
252
253
254
255
  
  # Find any prerequisites that is newer than target or that does not exist.
  # PHONY targets skipped in both cases.
  any-prereq = $(filter-out $(PHONY),$?) $(filter-out $(PHONY) $(wildcard $^),$^)
  
  # Execute command if command has changed or prerequisite(s) are updated.
  #
  if_changed = $(if $(strip $(any-prereq) $(arg-check)),                       \
  	@set -e;                                                             \
  	$(echo-cmd) $(cmd_$(1));                                             \
176d09827   Masahiro Yamada   kbuild: sync misc...
256
257
  	printf '%s
  ' 'cmd_$@ := $(make-cmd)' > $(dot-target).cmd)
ceec4c874   Masahiro Yamada   kbuild: import Kb...
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
  
  # Execute the command and also postprocess generated .d dependencies file.
  if_changed_dep = $(if $(strip $(any-prereq) $(arg-check) ),                  \
  	@set -e;                                                             \
  	$(echo-cmd) $(cmd_$(1));                                             \
  	scripts/basic/fixdep $(depfile) $@ '$(make-cmd)' > $(dot-target).tmp;\
  	rm -f $(depfile);                                                    \
  	mv -f $(dot-target).tmp $(dot-target).cmd)
  
  # Usage: $(call if_changed_rule,foo)
  # Will check if $(cmd_foo) or any of the prerequisites changed,
  # and if so will execute $(rule_foo).
  if_changed_rule = $(if $(strip $(any-prereq) $(arg-check) ),                 \
  	@set -e;                                                             \
  	$(rule_$(1)))
  
  ###
  # why - tell why a a target got build
  #       enabled by make V=2
  #       Output (listed in the order they are checked):
  #          (1) - due to target is PHONY
  #          (2) - due to target missing
  #          (3) - due to: file1.h file2.h
  #          (4) - due to command line change
  #          (5) - due to missing .cmd file
  #          (6) - due to target not in $(targets)
  # (1) PHONY targets are always build
  # (2) No target, so we better build it
  # (3) Prerequisite is newer than target
  # (4) The command line stored in the file named dir/.target.cmd
  #     differed from actual command line. This happens when compiler
  #     options changes
  # (5) No dir/.target.cmd file (used to store command line)
  # (6) No dir/.target.cmd file and target not listed in $(targets)
  #     This is a good hint that there is a bug in the kbuild file
  ifeq ($(KBUILD_VERBOSE),2)
  why =                                                                        \
      $(if $(filter $@, $(PHONY)),- due to target is PHONY,                    \
          $(if $(wildcard $@),                                                 \
              $(if $(strip $(any-prereq)),- due to: $(any-prereq),             \
                  $(if $(arg-check),                                           \
                      $(if $(cmd_$@),- due to command line change,             \
                          $(if $(filter $@, $(targets)),                       \
                              - due to missing .cmd file,                      \
                              - due to $(notdir $@) not in $$(targets)         \
                           )                                                   \
                       )                                                       \
                   )                                                           \
               ),                                                              \
               - due to target missing                                         \
           )                                                                   \
       )
  
  echo-why = $(call escsq, $(strip $(why)))
  endif
04a5c4060   Masahiro Yamada   kbuild: add a mak...
313

368a0dfbf   Masahiro Yamada   kbuild: add .DELE...
314
315
  # delete partially updated (i.e. corrupted) files on error
  .DELETE_ON_ERROR:
c16b137e4   Masahiro Yamada   kbuild: add .SECO...
316
317
  # do not delete intermediate files automatically
  .SECONDARY:
04a5c4060   Masahiro Yamada   kbuild: add a mak...
318
319
  ifdef CONFIG_SPL_BUILD
  SPL_ := SPL_
001f3142c   Simon Glass   Makefile: Provide...
320
321
322
323
324
  ifeq ($(CONFIG_TPL_BUILD),y)
  SPL_TPL_ := TPL_
  else
  SPL_TPL_ := SPL_
  endif
04a5c4060   Masahiro Yamada   kbuild: add a mak...
325
326
  else
  SPL_ :=
001f3142c   Simon Glass   Makefile: Provide...
327
  SPL_TPL_ :=
04a5c4060   Masahiro Yamada   kbuild: add a mak...
328
  endif