1 ### 1 ###
2 # build: Generic definitions 2 # build: Generic definitions
3 # 3 #
4 # Lots of this code have been borrowed or hea 4 # Lots of this code have been borrowed or heavily inspired from parts
5 # of kbuild code, which is not credited, but 5 # of kbuild code, which is not credited, but mostly developed by:
6 # 6 #
7 # Copyright (C) Sam Ravnborg <sam@mars.ravnbor 7 # Copyright (C) Sam Ravnborg <sam@mars.ravnborg.org>, 2015
8 # Copyright (C) Linus Torvalds <torvalds@linux 8 # Copyright (C) Linus Torvalds <torvalds@linux-foundation.org>, 2015
9 # 9 #
10 10
11 ### 11 ###
12 # Convenient variables 12 # Convenient variables
13 comma := , 13 comma := ,
14 squote := ' 14 squote := '
15 pound := \# <<
16 15
17 ### 16 ###
18 # Name of target with a '.' as filename prefix 17 # Name of target with a '.' as filename prefix. foo/bar.o => foo/.bar.o
19 dot-target = $(dir $@).$(notdir $@) 18 dot-target = $(dir $@).$(notdir $@)
20 19
21 ### 20 ###
22 # filename of target with directory and extens 21 # filename of target with directory and extension stripped
23 basetarget = $(basename $(notdir $@)) 22 basetarget = $(basename $(notdir $@))
24 23
25 ### 24 ###
26 # The temporary file to save gcc -MD generated 25 # The temporary file to save gcc -MD generated dependencies must not
27 # contain a comma 26 # contain a comma
28 depfile = $(subst $(comma),_,$(dot-target).d) 27 depfile = $(subst $(comma),_,$(dot-target).d)
29 28
30 ### 29 ###
31 # Check if both arguments has same arguments. 30 # Check if both arguments has same arguments. Result is empty string if equal.
32 arg-check = $(strip $(filter-out $(cmd_$(1)), 31 arg-check = $(strip $(filter-out $(cmd_$(1)), $(cmd_$@)) \
33 $(filter-out $(cmd_$@), 32 $(filter-out $(cmd_$@), $(cmd_$(1))) )
34 33
35 ### 34 ###
36 # Escape single quote for use in echo statemen 35 # Escape single quote for use in echo statements
37 escsq = $(subst $(squote),'\$(squote)',$1) 36 escsq = $(subst $(squote),'\$(squote)',$1)
38 37
39 # Echo command 38 # Echo command
40 # Short version is used, if $(quiet) equals `q 39 # Short version is used, if $(quiet) equals `quiet_', otherwise full one.
41 echo-cmd = $(if $($(quiet)cmd_$(1)),\ 40 echo-cmd = $(if $($(quiet)cmd_$(1)),\
42 echo ' $(call escsq,$($(quiet)cmd_ 41 echo ' $(call escsq,$($(quiet)cmd_$(1)))';)
43 42
44 ### 43 ###
45 # Replace >$< with >$$< to preserve $ when rel 44 # Replace >$< with >$$< to preserve $ when reloading the .cmd file
46 # (needed for make) 45 # (needed for make)
47 # Replace >#< with >$(pound)< to avoid startin !! 46 # Replace >#< with >\#< to avoid starting a comment in the .cmd file
48 # (needed for make) 47 # (needed for make)
49 # Replace >'< with >'\''< to be able to enclos 48 # Replace >'< with >'\''< to be able to enclose the whole string in '...'
50 # (needed for the shell) 49 # (needed for the shell)
51 make-cmd = $(call escsq,$(subst $(pound),$$(po !! 50 make-cmd = $(call escsq,$(subst \#,\\\#,$(subst $$,$$$$,$(cmd_$(1)))))
52 51
53 ### 52 ###
54 # Find any prerequisites that is newer than ta 53 # Find any prerequisites that is newer than target or that does not exist.
55 # PHONY targets skipped in both cases. 54 # PHONY targets skipped in both cases.
56 any-prereq = $(filter-out $(PHONY),$?) $(filte 55 any-prereq = $(filter-out $(PHONY),$?) $(filter-out $(PHONY) $(wildcard $^),$^)
57 56
58 ### 57 ###
59 # Copy dependency data into .cmd file 58 # Copy dependency data into .cmd file
60 # - gcc -M dependency info 59 # - gcc -M dependency info
61 # - command line to create object 'cmd_object 60 # - command line to create object 'cmd_object :='
62 dep-cmd = $(if $(wildcard $(fixdep)), 61 dep-cmd = $(if $(wildcard $(fixdep)), \
63 $(fixdep) $(depfile) $@ '$(make-cmd 62 $(fixdep) $(depfile) $@ '$(make-cmd)' > $(dot-target).tmp; \
64 rm -f $(depfile); 63 rm -f $(depfile); \
65 mv -f $(dot-target).tmp $(dot-targe 64 mv -f $(dot-target).tmp $(dot-target).cmd, \
66 printf '$(pound) cannot find fixdep !! 65 printf '\# cannot find fixdep (%s)\n' $(fixdep) > $(dot-target).cmd; \
67 printf '$(pound) using basic dep da !! 66 printf '\# using basic dep data\n\n' >> $(dot-target).cmd; \
68 cat $(depfile) >> $(dot-target).cmd 67 cat $(depfile) >> $(dot-target).cmd; \
69 printf '\n%s\n' 'cmd_$@ := $(make-c 68 printf '\n%s\n' 'cmd_$@ := $(make-cmd)' >> $(dot-target).cmd)
70 69
71 ### 70 ###
72 # if_changed_dep - execute command if any pre 71 # if_changed_dep - execute command if any prerequisite is newer than
73 # target, or command line ha 72 # target, or command line has changed and update
74 # dependencies in the cmd fi 73 # dependencies in the cmd file
75 if_changed_dep = $(if $(strip $(any-prereq) $( 74 if_changed_dep = $(if $(strip $(any-prereq) $(arg-check)), \
76 @set -e; 75 @set -e; \
77 $(echo-cmd) $(cmd_$(1)); !! 76 $(echo-cmd) $(cmd_$(1)) && $(dep-cmd))
78 $(dep-cmd)) <<
79 77
80 # if_changed - execute command if any pre 78 # if_changed - execute command if any prerequisite is newer than
81 # target, or command line ha 79 # target, or command line has changed
82 if_changed = $(if $(strip $(any-prereq) $(arg- 80 if_changed = $(if $(strip $(any-prereq) $(arg-check)), \
83 @set -e; 81 @set -e; \
84 $(echo-cmd) $(cmd_$(1)); 82 $(echo-cmd) $(cmd_$(1)); \
85 printf '%s\n' 'cmd_$@ := $(make- 83 printf '%s\n' 'cmd_$@ := $(make-cmd)' > $(dot-target).cmd)
86 84
87 ### 85 ###
88 # C flags to be used in rule definitions, incl 86 # C flags to be used in rule definitions, includes:
89 # - depfile generation 87 # - depfile generation
90 # - global $(CFLAGS) 88 # - global $(CFLAGS)
91 # - per target C flags 89 # - per target C flags
92 # - per object C flags 90 # - per object C flags
93 # - BUILD_STR macro to allow '-D"$(variable)"' 91 # - BUILD_STR macro to allow '-D"$(variable)"' constructs
94 c_flags_1 = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CF 92 c_flags_1 = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CFLAGS) -D"BUILD_STR(s)=\#s" $(CFLAGS_$(basetarget).o) $(CFLAGS_$(obj))
95 c_flags_2 = $(filter-out $(CFLAGS_REMOVE_$(bas 93 c_flags_2 = $(filter-out $(CFLAGS_REMOVE_$(basetarget).o), $(c_flags_1))
96 c_flags = $(filter-out $(CFLAGS_REMOVE_$(obj 94 c_flags = $(filter-out $(CFLAGS_REMOVE_$(obj)), $(c_flags_2))
97 cxx_flags = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CX 95 cxx_flags = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CXXFLAGS) -D"BUILD_STR(s)=\#s" $(CXXFLAGS_$(basetarget).o) $(CXXFLAGS_$(obj))
98 96
99 ### 97 ###
100 ## HOSTCC C flags 98 ## HOSTCC C flags
101 99
102 host_c_flags = -Wp,-MD,$(depfile) -Wp,-MT,$@ $ !! 100 host_c_flags = -Wp,-MD,$(depfile) -Wp,-MT,$@ $(CHOSTFLAGS) -D"BUILD_STR(s)=\#s" $(CHOSTFLAGS_$(basetarget).o) $(CHOSTFLAGS_$(obj))
103 <<
104 # output directory for tests below <<
105 TMPOUT = .tmp_$$$$ <<
106 <<
107 # try-run <<
108 # Usage: option = $(call try-run, $(CC)...-o " <<
109 # Exit code chooses option. "$$TMP" serves as <<
110 # automatically cleaned up. <<
111 try-run = $(shell set -e; \ <<
112 TMP=$(TMPOUT)/tmp; \ <<
113 mkdir -p $(TMPOUT); \ <<
114 trap "rm -rf $(TMPOUT)" EXIT; \ <<
115 if ($(1)) >/dev/null 2>&1; \ <<
116 then echo "$(2)"; \ <<
117 else echo "$(3)"; \ <<
118 fi) <<
119 <<
120 # cc-option <<
121 # Usage: cflags-y += $(call cc-option,-march=w <<
122 cc-option = $(call try-run, \ <<
123 $(CC) -Werror $(1) -c -x c /dev/null - <<
124 <<
125 # delete partially updated (i.e. corrupted) fi <<
126 .DELETE_ON_ERROR: <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.