xref: /linux/tools/build/Build.include (revision 74ce1896c6c65b2f8cccbf59162d542988835835)
1###
2# build: Generic definitions
3#
4#  Lots of this code have been borrowed or heavily inspired from parts
5#  of kbuild code, which is not credited, but mostly developed by:
6#
7#  Copyright (C) Sam Ravnborg <sam@mars.ravnborg.org>, 2015
8#  Copyright (C) Linus Torvalds <torvalds@linux-foundation.org>, 2015
9#
10
11###
12# Convenient variables
13comma   := ,
14squote  := '
15
16###
17# Name of target with a '.' as filename prefix. foo/bar.o => foo/.bar.o
18dot-target = $(dir $@).$(notdir $@)
19
20###
21# filename of target with directory and extension stripped
22basetarget = $(basename $(notdir $@))
23
24###
25# The temporary file to save gcc -MD generated dependencies must not
26# contain a comma
27depfile = $(subst $(comma),_,$(dot-target).d)
28
29###
30# Check if both arguments has same arguments. Result is empty string if equal.
31arg-check = $(strip $(filter-out $(cmd_$(1)), $(cmd_$@)) \
32                    $(filter-out $(cmd_$@),   $(cmd_$(1))) )
33
34###
35# Escape single quote for use in echo statements
36escsq = $(subst $(squote),'\$(squote)',$1)
37
38# Echo command
39# Short version is used, if $(quiet) equals `quiet_', otherwise full one.
40echo-cmd = $(if $($(quiet)cmd_$(1)),\
41           echo '  $(call escsq,$($(quiet)cmd_$(1)))';)
42
43###
44# Replace >$< with >$$< to preserve $ when reloading the .cmd file
45# (needed for make)
46# Replace >#< with >\#< to avoid starting a comment in the .cmd file
47# (needed for make)
48# Replace >'< with >'\''< to be able to enclose the whole string in '...'
49# (needed for the shell)
50make-cmd = $(call escsq,$(subst \#,\\\#,$(subst $$,$$$$,$(cmd_$(1)))))
51
52###
53# Find any prerequisites that is newer than target or that does not exist.
54# PHONY targets skipped in both cases.
55any-prereq = $(filter-out $(PHONY),$?) $(filter-out $(PHONY) $(wildcard $^),$^)
56
57###
58# Copy dependency data into .cmd file
59#  - gcc -M dependency info
60#  - command line to create object 'cmd_object :='
61dep-cmd = $(if $(wildcard $(fixdep)),                                           \
62           $(fixdep) $(depfile) $@ '$(make-cmd)' > $(dot-target).tmp;           \
63           rm -f $(depfile);                                                    \
64           mv -f $(dot-target).tmp $(dot-target).cmd,                           \
65           printf '\# cannot find fixdep (%s)\n' $(fixdep) > $(dot-target).cmd; \
66           printf '\# using basic dep data\n\n' >> $(dot-target).cmd;           \
67           cat $(depfile) >> $(dot-target).cmd;                                 \
68           printf '\n%s\n' 'cmd_$@ := $(make-cmd)' >> $(dot-target).cmd)
69
70###
71# if_changed_dep  - execute command if any prerequisite is newer than
72#                   target, or command line has changed and update
73#                   dependencies in the cmd file
74if_changed_dep = $(if $(strip $(any-prereq) $(arg-check)),         \
75                  @set -e;                                         \
76                  $(echo-cmd) $(cmd_$(1)) && $(dep-cmd))
77
78# if_changed      - execute command if any prerequisite is newer than
79#                   target, or command line has changed
80if_changed = $(if $(strip $(any-prereq) $(arg-check)),                   \
81              @set -e;                                                   \
82              $(echo-cmd) $(cmd_$(1));                                   \
83              printf '%s\n' 'cmd_$@ := $(make-cmd)' > $(dot-target).cmd)
84
85###
86# C flags to be used in rule definitions, includes:
87# - depfile generation
88# - global $(CFLAGS)
89# - per target C flags
90# - per object C flags
91# - BUILD_STR macro to allow '-D"$(variable)"' constructs
92c_flags_1 = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CFLAGS) -D"BUILD_STR(s)=\#s" $(CFLAGS_$(basetarget).o) $(CFLAGS_$(obj))
93c_flags_2 = $(filter-out $(CFLAGS_REMOVE_$(basetarget).o), $(c_flags_1))
94c_flags   = $(filter-out $(CFLAGS_REMOVE_$(obj)), $(c_flags_2))
95cxx_flags = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CXXFLAGS) -D"BUILD_STR(s)=\#s" $(CXXFLAGS_$(basetarget).o) $(CXXFLAGS_$(obj))
96
97###
98## HOSTCC C flags
99
100host_c_flags = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CHOSTFLAGS) -D"BUILD_STR(s)=\#s" $(CHOSTFLAGS_$(basetarget).o) $(CHOSTFLAGS_$(obj))
101