]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - scripts/Makefile.lib
compiler: introduce __alias(symbol) shortcut
[mirror_ubuntu-bionic-kernel.git] / scripts / Makefile.lib
CommitLineData
f77bf014
SR
1# Backward compatibility
2asflags-y += $(EXTRA_AFLAGS)
3ccflags-y += $(EXTRA_CFLAGS)
4cppflags-y += $(EXTRA_CPPFLAGS)
5ldflags-y += $(EXTRA_LDFLAGS)
6
720097d8
SR
7#
8# flags that take effect in sub directories
9export KBUILD_SUBDIR_ASFLAGS := $(KBUILD_SUBDIR_ASFLAGS) $(subdir-asflags-y)
10export KBUILD_SUBDIR_CCFLAGS := $(KBUILD_SUBDIR_CCFLAGS) $(subdir-ccflags-y)
11
1da177e4
LT
12# Figure out what we need to build from the various variables
13# ===========================================================================
14
15# When an object is listed to be built compiled-in and modular,
16# only build the compiled-in version
17
18obj-m := $(filter-out $(obj-y),$(obj-m))
19
20# Libraries are always collected in one lib file.
21# Filter out objects already built-in
22
23lib-y := $(filter-out $(obj-y), $(sort $(lib-y) $(lib-m)))
24
25
26# Handle objects in subdirs
27# ---------------------------------------------------------------------------
28# o if we encounter foo/ in $(obj-y), replace it by foo/built-in.o
29# and add the directory to the list of dirs to descend into: $(subdir-y)
38385f8f 30# o if we encounter foo/ in $(obj-m), remove it from $(obj-m)
1da177e4
LT
31# and add the directory to the list of dirs to descend into: $(subdir-m)
32
551559e1
TH
33# Determine modorder.
34# Unfortunately, we don't have information about ordering between -y
35# and -m subdirs. Just put -y's first.
36modorder := $(patsubst %/,%/modules.order, $(filter %/, $(obj-y)) $(obj-m:.o=.ko))
37
1da177e4
LT
38__subdir-y := $(patsubst %/,%,$(filter %/, $(obj-y)))
39subdir-y += $(__subdir-y)
40__subdir-m := $(patsubst %/,%,$(filter %/, $(obj-m)))
41subdir-m += $(__subdir-m)
42obj-y := $(patsubst %/, %/built-in.o, $(obj-y))
43obj-m := $(filter-out %/, $(obj-m))
44
45# Subdirectories we need to descend into
46
47subdir-ym := $(sort $(subdir-y) $(subdir-m))
48
38385f8f 49# if $(foo-objs) exists, foo.o is a composite object
1da177e4
LT
50multi-used-y := $(sort $(foreach m,$(obj-y), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))), $(m))))
51multi-used-m := $(sort $(foreach m,$(obj-m), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))), $(m))))
52multi-used := $(multi-used-y) $(multi-used-m)
53single-used-m := $(sort $(filter-out $(multi-used-m),$(obj-m)))
54
55# Build list of the parts of our composite objects, our composite
56# objects depend on those (obviously)
57multi-objs-y := $(foreach m, $(multi-used-y), $($(m:.o=-objs)) $($(m:.o=-y)))
58multi-objs-m := $(foreach m, $(multi-used-m), $($(m:.o=-objs)) $($(m:.o=-y)))
59multi-objs := $(multi-objs-y) $(multi-objs-m)
60
f5fb9765
SR
61# $(subdir-obj-y) is the list of objects in $(obj-y) which uses dir/ to
62# tell kbuild to descend
63subdir-obj-y := $(filter %/built-in.o, $(obj-y))
1da177e4
LT
64
65# $(obj-dirs) is a list of directories that contain object files
4d47dde4 66obj-dirs := $(dir $(multi-objs) $(obj-y))
1da177e4
LT
67
68# Replace multi-part objects by their individual parts, look at local dir only
69real-objs-y := $(foreach m, $(filter-out $(subdir-obj-y), $(obj-y)), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))),$($(m:.o=-objs)) $($(m:.o=-y)),$(m))) $(extra-y)
70real-objs-m := $(foreach m, $(obj-m), $(if $(strip $($(m:.o=-objs)) $($(m:.o=-y))),$($(m:.o=-objs)) $($(m:.o=-y)),$(m)))
71
72# Add subdir path
73
74extra-y := $(addprefix $(obj)/,$(extra-y))
75always := $(addprefix $(obj)/,$(always))
76targets := $(addprefix $(obj)/,$(targets))
551559e1 77modorder := $(addprefix $(obj)/,$(modorder))
1da177e4
LT
78obj-y := $(addprefix $(obj)/,$(obj-y))
79obj-m := $(addprefix $(obj)/,$(obj-m))
80lib-y := $(addprefix $(obj)/,$(lib-y))
81subdir-obj-y := $(addprefix $(obj)/,$(subdir-obj-y))
82real-objs-y := $(addprefix $(obj)/,$(real-objs-y))
83real-objs-m := $(addprefix $(obj)/,$(real-objs-m))
84single-used-m := $(addprefix $(obj)/,$(single-used-m))
85multi-used-y := $(addprefix $(obj)/,$(multi-used-y))
86multi-used-m := $(addprefix $(obj)/,$(multi-used-m))
87multi-objs-y := $(addprefix $(obj)/,$(multi-objs-y))
88multi-objs-m := $(addprefix $(obj)/,$(multi-objs-m))
89subdir-ym := $(addprefix $(obj)/,$(subdir-ym))
90obj-dirs := $(addprefix $(obj)/,$(obj-dirs))
91
1da177e4
LT
92# These flags are needed for modversions and compiling, so we define them here
93# already
38385f8f 94# $(modname_flags) #defines KBUILD_MODNAME as the name of the module it will
1da177e4 95# end up in (or would, if it gets compiled in)
5bb0571b
MM
96# Note: Files that end up in two or more modules are compiled without the
97# KBUILD_MODNAME definition. The reason is that any made-up name would
98# differ in different configs.
f83b5e32 99name-fix = $(subst $(comma),_,$(subst -,_,$1))
5e8d780d 100basename_flags = -D"KBUILD_BASENAME=KBUILD_STR($(call name-fix,$(basetarget)))"
f83b5e32
UR
101modname_flags = $(if $(filter 1,$(words $(modname))),\
102 -D"KBUILD_MODNAME=KBUILD_STR($(call name-fix,$(modname)))")
1da177e4 103
720097d8 104orig_c_flags = $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(KBUILD_SUBDIR_CCFLAGS) \
d8672b40 105 $(ccflags-y) $(CFLAGS_$(basetarget).o)
656ee82c 106_c_flags = $(filter-out $(CFLAGS_REMOVE_$(basetarget).o), $(orig_c_flags))
720097d8 107_a_flags = $(KBUILD_CPPFLAGS) $(KBUILD_AFLAGS) $(KBUILD_SUBDIR_ASFLAGS) \
d8672b40 108 $(asflags-y) $(AFLAGS_$(basetarget).o)
f77bf014 109_cpp_flags = $(KBUILD_CPPFLAGS) $(cppflags-y) $(CPPFLAGS_$(@F))
1da177e4 110
2521f2c2
PO
111#
112# Enable gcov profiling flags for a file, directory or for all files depending
113# on variables GCOV_PROFILE_obj.o, GCOV_PROFILE and CONFIG_GCOV_PROFILE_ALL
114# (in this order)
115#
116ifeq ($(CONFIG_GCOV_KERNEL),y)
117_c_flags += $(if $(patsubst n%,, \
118 $(GCOV_PROFILE_$(basetarget).o)$(GCOV_PROFILE)$(CONFIG_GCOV_PROFILE_ALL)), \
119 $(CFLAGS_GCOV))
120endif
121
1da177e4
LT
122# If building the kernel in a separate objtree expand all occurrences
123# of -Idir to -I$(srctree)/dir except for absolute paths (starting with '/').
124
125ifeq ($(KBUILD_SRC),)
126__c_flags = $(_c_flags)
127__a_flags = $(_a_flags)
128__cpp_flags = $(_cpp_flags)
129else
130
1da177e4
LT
131# -I$(obj) locates generated .h files
132# $(call addtree,-I$(obj)) locates .h files in srctree, from generated .c files
133# and locates generated .h files
134# FIXME: Replace both with specific CFLAGS* statements in the makefiles
135__c_flags = $(call addtree,-I$(obj)) $(call flags,_c_flags)
136__a_flags = $(call flags,_a_flags)
137__cpp_flags = $(call flags,_cpp_flags)
138endif
139
d8672b40
SR
140c_flags = -Wp,-MD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE) \
141 $(__c_flags) $(modkern_cflags) \
52159d98 142 -D"KBUILD_STR(s)=\#s" $(basename_flags) $(modname_flags)
1da177e4 143
d8672b40 144a_flags = -Wp,-MD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE) \
1da177e4
LT
145 $(__a_flags) $(modkern_aflags)
146
d8672b40
SR
147cpp_flags = -Wp,-MD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE) \
148 $(__cpp_flags)
1da177e4 149
f77bf014 150ld_flags = $(LDFLAGS) $(ldflags-y)
1da177e4 151
b0a4d8b3 152dtc_cpp_flags = -Wp,-MD,$(depfile).pre.tmp -nostdinc \
e570d7c1 153 -I$(srctree)/arch/$(SRCARCH)/boot/dts \
c58299aa 154 -I$(srctree)/arch/$(SRCARCH)/boot/dts/include \
b5190516 155 -I$(srctree)/drivers/of/testcase-data \
e570d7c1
SW
156 -undef -D__DTS__
157
1da177e4
LT
158# Finds the multi-part object the current object will be linked into
159modname-multi = $(sort $(foreach m,$(multi-used),\
160 $(if $(filter $(subst $(obj)/,,$*.o), $($(m:.o=-objs)) $($(m:.o=-y))),$(m:.o=))))
161
c8589d1e
MY
162# Useful for describing the dependency of composite objects
163# Usage:
164# $(call multi_depend, multi_used_targets, suffix_to_remove, suffix_to_add)
165define multi_depend
166$(foreach m, $(notdir $1), \
167 $(eval $(obj)/$m: \
168 $(addprefix $(obj)/, $(foreach s, $3, $($(m:%$(strip $2)=%$(s)))))))
169endef
170
7373f4f8
AL
171ifdef REGENERATE_PARSERS
172
173# GPERF
174# ---------------------------------------------------------------------------
175quiet_cmd_gperf = GPERF $@
176 cmd_gperf = gperf -t --output-file $@ -a -C -E -g -k 1,3,$$ -p -t $<
177
58238c81 178.PRECIOUS: $(src)/%.hash.c_shipped
7373f4f8
AL
179$(src)/%.hash.c_shipped: $(src)/%.gperf
180 $(call cmd,gperf)
181
182# LEX
183# ---------------------------------------------------------------------------
184LEX_PREFIX = $(if $(LEX_PREFIX_${baseprereq}),$(LEX_PREFIX_${baseprereq}),yy)
185
186quiet_cmd_flex = LEX $@
187 cmd_flex = flex -o$@ -L -P $(LEX_PREFIX) $<
188
58238c81 189.PRECIOUS: $(src)/%.lex.c_shipped
7373f4f8
AL
190$(src)/%.lex.c_shipped: $(src)/%.l
191 $(call cmd,flex)
192
193# YACC
194# ---------------------------------------------------------------------------
195YACC_PREFIX = $(if $(YACC_PREFIX_${baseprereq}),$(YACC_PREFIX_${baseprereq}),yy)
196
197quiet_cmd_bison = YACC $@
198 cmd_bison = bison -o$@ -t -l -p $(YACC_PREFIX) $<
199
58238c81 200.PRECIOUS: $(src)/%.tab.c_shipped
7373f4f8
AL
201$(src)/%.tab.c_shipped: $(src)/%.y
202 $(call cmd,bison)
203
204quiet_cmd_bison_h = YACC $@
205 cmd_bison_h = bison -o/dev/null --defines=$@ -t -l -p $(YACC_PREFIX) $<
206
58238c81 207.PRECIOUS: $(src)/%.tab.h_shipped
7373f4f8
AL
208$(src)/%.tab.h_shipped: $(src)/%.y
209 $(call cmd,bison_h)
210
211endif
212
1da177e4
LT
213# Shipped files
214# ===========================================================================
215
216quiet_cmd_shipped = SHIPPED $@
217cmd_shipped = cat $< > $@
218
991d76c9 219$(obj)/%: $(src)/%_shipped
1da177e4
LT
220 $(call cmd,shipped)
221
222# Commands useful for building a boot image
223# ===========================================================================
38385f8f 224#
1da177e4
LT
225# Use as following:
226#
227# target: source(s) FORCE
228# $(if_changed,ld/objcopy/gzip)
229#
836caba7 230# and add target to extra-y so that we know we have to
1da177e4
LT
231# read in the saved command line
232
233# Linking
234# ---------------------------------------------------------------------------
235
236quiet_cmd_ld = LD $@
f77bf014 237cmd_ld = $(LD) $(LDFLAGS) $(ldflags-y) $(LDFLAGS_$(@F)) \
38385f8f 238 $(filter-out FORCE,$^) -o $@
1da177e4
LT
239
240# Objcopy
241# ---------------------------------------------------------------------------
242
243quiet_cmd_objcopy = OBJCOPY $@
244cmd_objcopy = $(OBJCOPY) $(OBJCOPYFLAGS) $(OBJCOPYFLAGS_$(@F)) $< $@
245
246# Gzip
247# ---------------------------------------------------------------------------
248
249quiet_cmd_gzip = GZIP $@
6ae9ecb8 250cmd_gzip = (cat $(filter-out FORCE,$^) | gzip -n -f -9 > $@) || \
d3dd3b5a 251 (rm -f $@ ; false)
1da177e4 252
aab94339
DB
253# DTC
254# ---------------------------------------------------------------------------
255
256# Generate an assembly file to wrap the output of the device tree compiler
1c00a47e 257quiet_cmd_dt_S_dtb= DTB $@
aab94339
DB
258cmd_dt_S_dtb= \
259( \
260 echo '\#include <asm-generic/vmlinux.lds.h>'; \
261 echo '.section .dtb.init.rodata,"a"'; \
262 echo '.balign STRUCT_ALIGNMENT'; \
263 echo '.global __dtb_$(*F)_begin'; \
264 echo '__dtb_$(*F)_begin:'; \
265 echo '.incbin "$<" '; \
266 echo '__dtb_$(*F)_end:'; \
267 echo '.global __dtb_$(*F)_end'; \
268 echo '.balign STRUCT_ALIGNMENT'; \
269) > $@
270
271$(obj)/%.dtb.S: $(obj)/%.dtb
272 $(call cmd,dt_S_dtb)
273
274quiet_cmd_dtc = DTC $@
b40b25ff
SW
275cmd_dtc = $(CPP) $(dtc_cpp_flags) -x assembler-with-cpp -o $(dtc-tmp) $< ; \
276 $(objtree)/scripts/dtc/dtc -O dtb -o $@ -b 0 \
ad061568 277 -i $(dir $<) $(DTC_FLAGS) \
b0a4d8b3
IC
278 -d $(depfile).dtc.tmp $(dtc-tmp) ; \
279 cat $(depfile).pre.tmp $(depfile).dtc.tmp > $(depfile)
1da177e4 280
90b335fb
SW
281$(obj)/%.dtb: $(src)/%.dts FORCE
282 $(call if_changed_dep,dtc)
283
b0a4d8b3 284dtc-tmp = $(subst $(comma),_,$(dot-target).dts.tmp)
22435f38 285
bc22c17e
AK
286# Bzip2
287# ---------------------------------------------------------------------------
288
d3dd3b5a
PA
289# Bzip2 and LZMA do not include size in file... so we have to fake that;
290# append the size as a 32-bit littleendian number as gzip does.
4a2ff67c 291size_append = printf $(shell \
d3dd3b5a
PA
292dec_size=0; \
293for F in $1; do \
294 fsize=$$(stat -c "%s" $$F); \
295 dec_size=$$(expr $$dec_size + $$fsize); \
296done; \
1373411a
JN
297printf "%08x\n" $$dec_size | \
298 sed 's/\(..\)/\1 /g' | { \
299 read ch0 ch1 ch2 ch3; \
300 for ch in $$ch3 $$ch2 $$ch1 $$ch0; do \
301 printf '%s%03o' '\\' $$((0x$$ch)); \
302 done; \
303 } \
d3dd3b5a
PA
304)
305
306quiet_cmd_bzip2 = BZIP2 $@
307cmd_bzip2 = (cat $(filter-out FORCE,$^) | \
308 bzip2 -9 && $(call size_append, $(filter-out FORCE,$^))) > $@ || \
309 (rm -f $@ ; false)
bc22c17e
AK
310
311# Lzma
312# ---------------------------------------------------------------------------
313
314quiet_cmd_lzma = LZMA $@
d3dd3b5a
PA
315cmd_lzma = (cat $(filter-out FORCE,$^) | \
316 lzma -9 && $(call size_append, $(filter-out FORCE,$^))) > $@ || \
317 (rm -f $@ ; false)
7dd65feb 318
2d74b2c6 319quiet_cmd_lzo = LZO $@
7dd65feb
AT
320cmd_lzo = (cat $(filter-out FORCE,$^) | \
321 lzop -9 && $(call size_append, $(filter-out FORCE,$^))) > $@ || \
322 (rm -f $@ ; false)
d61931d8 323
e76e1fdf
KL
324quiet_cmd_lz4 = LZ4 $@
325cmd_lz4 = (cat $(filter-out FORCE,$^) | \
326 lz4c -l -c1 stdin stdout && $(call size_append, $(filter-out FORCE,$^))) > $@ || \
327 (rm -f $@ ; false)
328
e3393645
SW
329# U-Boot mkimage
330# ---------------------------------------------------------------------------
331
332MKIMAGE := $(srctree)/scripts/mkuboot.sh
333
334# SRCARCH just happens to match slightly more than ARCH (on sparc), so reduces
335# the number of overrides in arch makefiles
336UIMAGE_ARCH ?= $(SRCARCH)
337UIMAGE_COMPRESSION ?= $(if $(2),$(2),none)
338UIMAGE_OPTS-y ?=
339UIMAGE_TYPE ?= kernel
340UIMAGE_LOADADDR ?= arch_must_set_this
341UIMAGE_ENTRYADDR ?= $(UIMAGE_LOADADDR)
342UIMAGE_NAME ?= 'Linux-$(KERNELRELEASE)'
343UIMAGE_IN ?= $<
344UIMAGE_OUT ?= $@
345
346quiet_cmd_uimage = UIMAGE $(UIMAGE_OUT)
347 cmd_uimage = $(CONFIG_SHELL) $(MKIMAGE) -A $(UIMAGE_ARCH) -O linux \
348 -C $(UIMAGE_COMPRESSION) $(UIMAGE_OPTS-y) \
349 -T $(UIMAGE_TYPE) \
350 -a $(UIMAGE_LOADADDR) -e $(UIMAGE_ENTRYADDR) \
351 -n $(UIMAGE_NAME) -d $(UIMAGE_IN) $(UIMAGE_OUT)
352
24fa0402
LC
353# XZ
354# ---------------------------------------------------------------------------
355# Use xzkern to compress the kernel image and xzmisc to compress other things.
356#
357# xzkern uses a big LZMA2 dictionary since it doesn't increase memory usage
358# of the kernel decompressor. A BCJ filter is used if it is available for
359# the target architecture. xzkern also appends uncompressed size of the data
360# using size_append. The .xz format has the size information available at
361# the end of the file too, but it's in more complex format and it's good to
362# avoid changing the part of the boot code that reads the uncompressed size.
363# Note that the bytes added by size_append will make the xz tool think that
364# the file is corrupt. This is expected.
365#
366# xzmisc doesn't use size_append, so it can be used to create normal .xz
367# files. xzmisc uses smaller LZMA2 dictionary than xzkern, because a very
368# big dictionary would increase the memory usage too much in the multi-call
369# decompression mode. A BCJ filter isn't used either.
370quiet_cmd_xzkern = XZKERN $@
371cmd_xzkern = (cat $(filter-out FORCE,$^) | \
372 sh $(srctree)/scripts/xz_wrap.sh && \
373 $(call size_append, $(filter-out FORCE,$^))) > $@ || \
374 (rm -f $@ ; false)
375
376quiet_cmd_xzmisc = XZMISC $@
377cmd_xzmisc = (cat $(filter-out FORCE,$^) | \
378 xz --check=crc32 --lzma2=dict=1MiB) > $@ || \
379 (rm -f $@ ; false)