Blame view

scripts/Kbuild.include 11.4 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
10
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
  squote  := '
  empty   :=
  space   := $(empty) $(empty)
  
  ###
  # 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...
89
  # modifed for U-Boot: prevent cc-option from leaving .*.su files
ceec4c874   Masahiro Yamada   kbuild: import Kb...
90
91
92
  try-run = $(shell set -e;		\
  	TMP="$(TMPOUT).$$$$.tmp";	\
  	TMPO="$(TMPOUT).$$$$.o";	\
9a368d0f5   Masahiro Yamada   kbuild: Do not ge...
93
  	TMPSU="$(TMPOUT).$$$$.su";	\
ceec4c874   Masahiro Yamada   kbuild: import Kb...
94
95
96
97
  	if ($(1)) >/dev/null 2>&1;	\
  	then echo "$(2)";		\
  	else echo "$(3)";		\
  	fi;				\
9a368d0f5   Masahiro Yamada   kbuild: Do not ge...
98
  	rm -f "$$TMP" "$$TMPO" "$$TMPSU")
ceec4c874   Masahiro Yamada   kbuild: import Kb...
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
  
  # 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...
117
  	$(CC) -Werror $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(1) -c -x c /dev/null -o "$$TMP",$(1),$(2))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
118
119
120
121
  
  # 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...
122
  	$(CC) -Werror $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(1) -c -x c /dev/null -o "$$TMP",y,n)
ceec4c874   Masahiro Yamada   kbuild: import Kb...
123
124
125
126
127
128
129
130
131
132
  
  # 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...
133
134
135
  # 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...
136
  # cc-version
ceec4c874   Masahiro Yamada   kbuild: import Kb...
137
138
139
  cc-version = $(shell $(CONFIG_SHELL) $(srctree)/scripts/gcc-version.sh $(CC))
  
  # cc-fullversion
ceec4c874   Masahiro Yamada   kbuild: import Kb...
140
141
142
143
144
  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...
145
  cc-ifversion = $(shell [ $(cc-version) $(1) $(2) ] && echo $(3) || echo $(4))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
146

bf4b3de10   Masahiro Yamada   kbuild: Use Kbuil...
147
148
149
  # 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...
150
151
152
153
154
155
156
157
158
159
160
161
162
163
  # 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...
164
  # ld-version
598e2d338   Masahiro Yamada   kbuild: sync with...
165
166
167
168
169
  # 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...
170
  ld-ifversion = $(shell [ $(ld-version) $(1) $(2) ] && echo $(3) || echo $(4))
598e2d338   Masahiro Yamada   kbuild: sync with...
171

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

98bd0e0d9   Masahiro Yamada   kbuild: sync with...
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
  ###
  # 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...
203
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
  # 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...
238
239
240
241
242
243
244
  # Replace >$< with >$$< to preserve $ when reloading the .cmd file
  # (needed for make)
  # Replace >#< with >\#< to avoid starting a comment in the .cmd file
  # (needed for make)
  # Replace >'< with >'\''< to be able to enclose the whole string in '...'
  # (needed for the shell)
  make-cmd = $(call escsq,$(subst \#,\\\#,$(subst $$,$$$$,$(cmd_$(1)))))
ceec4c874   Masahiro Yamada   kbuild: import Kb...
245
246
247
248
249
250
251
252
253
254
  
  # 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...
255
256
  	printf '%s
  ' 'cmd_$@ := $(make-cmd)' > $(dot-target).cmd)
ceec4c874   Masahiro Yamada   kbuild: import Kb...
257
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
  
  # 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...
312
313
314
  
  ifdef CONFIG_SPL_BUILD
  SPL_ := SPL_
001f3142c   Simon Glass   Makefile: Provide...
315
316
317
318
319
  ifeq ($(CONFIG_TPL_BUILD),y)
  SPL_TPL_ := TPL_
  else
  SPL_TPL_ := SPL_
  endif
04a5c4060   Masahiro Yamada   kbuild: add a mak...
320
321
  else
  SPL_ :=
001f3142c   Simon Glass   Makefile: Provide...
322
  SPL_TPL_ :=
04a5c4060   Masahiro Yamada   kbuild: add a mak...
323
  endif