In Linux build system, build targets and installation targets are separated. Examples are: - 'make vmlinux' -> 'make install' - 'make modules' -> 'make modules_install' - 'make dtbs' -> 'make dtbs_install' - 'make vdso' -> 'make vdso_install' The intention is to run the build targets under the normal privilege, then the installation targets under the root privilege since we need the write permission to the system directories. We have 'make headers_install' but the corresponding 'make headers' stage does not exist. The purpose of headers_install is to provide the kernel interface to C library. So, nobody would try to install headers to /usr/include directly. If 'sudo make INSTALL_HDR_PATH=/usr/include headers_install' were run, some build artifacts in the kernel tree would be owned by root because some of uapi headers are generated by 'uapi-asm-generic', 'archheaders' targets. Anyway, I believe it makes sense to split the header installation into two stages. [1] 'make headers' Process headers in uapi directories by scripts/headers_install.sh and copy them to usr/include [2] 'make headers_install' Copy '*.h' verbatim from usr/include to $(INSTALL_HDR_PATH)/include For the backward compatibility, 'headers_install' depends on 'headers'. Some samples expect uapi headers in usr/include. So, the 'headers' target is useful to build up them in the fixed location usr/include irrespective of INSTALL_HDR_PATH. Another benefit is to stop polluting the final destination with the time-stamp files '.install' and '.check'. Maybe you can see them in your toolchains. Lastly, my main motivation is to prepare for compile-testing uapi headers. To build something, we have to save an object and .*.cmd somewhere. The usr/include/ will be the work directory for that.
Unified · Split
| @@ -262,7 +262,7 @@ old_version_h := include/linux/version.h · 261 unmodified lines | |||
| 262 | clean-targets := %clean mrproper cleandocs | 262 | clean-targets := %clean mrproper cleandocs |
| 263 | no-dot-config-targets := $(clean-targets) \ | 263 | no-dot-config-targets := $(clean-targets) \ |
| 264 | cscope gtags TAGS tags help% %docs check% coccicheck \ | 264 | cscope gtags TAGS tags help% %docs check% coccicheck \ |
| 265 | $(version_h) headers_% archheaders archscripts \ | 265 | $(version_h) headers headers_% archheaders archscripts \ |
| 266 | %asm-generic kernelversion %src-pkg | 266 | %asm-generic kernelversion %src-pkg |
| 267 | no-sync-config-targets := $(no-dot-config-targets) install %install \ | 267 | no-sync-config-targets := $(no-dot-config-targets) install %install \ |
| 268 | kernelrelease | 268 | kernelrelease |
| @@ -1178,25 +1178,32 @@ headerdep: · 909 unmodified lines | |||
| 1178 | #Default location for installed headers | 1178 | #Default location for installed headers |
| 1179 | export INSTALL_HDR_PATH = $(objtree)/usr | 1179 | export INSTALL_HDR_PATH = $(objtree)/usr |
| 1180 | 1180 | ||
| 1181 | PHONY += archheaders archscripts | 1181 | quiet_cmd_headers_install = INSTALL $(INSTALL_HDR_PATH)/include |
| 1182 | 1182 | cmd_headers_install = \ | |
| 1183 | PHONY += __headers | 1183 | mkdir -p $(INSTALL_HDR_PATH); \ |
| 1184 | __headers: $(version_h) scripts_unifdef uapi-asm-generic archheaders archscripts | 1184 | rsync -mrl --include='*/' --include='*\.h' --exclude='*' \ |
| 1185 | usr/include $(INSTALL_HDR_PATH) | ||
| 1185 | 1186 | ||
| 1186 | PHONY += headers_install | 1187 | PHONY += headers_install |
| 1187 | headers_install: __headers | 1188 | headers_install: headers |
| 1189 | $(call cmd,headers_install) | ||
| 1190 | |||
| 1191 | PHONY += archheaders archscripts | ||
| 1192 | |||
| 1193 | PHONY += headers | ||
| 1194 | headers: $(version_h) scripts_unifdef uapi-asm-generic archheaders archscripts | ||
| 1188 | $(if $(wildcard $(srctree)/arch/$(SRCARCH)/include/uapi/asm/Kbuild),, \ | 1195 | $(if $(wildcard $(srctree)/arch/$(SRCARCH)/include/uapi/asm/Kbuild),, \ |
| 1189 | $(error Headers not exportable for the $(SRCARCH) architecture)) | 1196 | $(error Headers not exportable for the $(SRCARCH) architecture)) |
| 1190 | $(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include | 1197 | $(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include |
| 1191 | $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi dst=include | 1198 | $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi dst=include |
| 1192 | 1199 | ||
| 1193 | PHONY += headers_check | 1200 | PHONY += headers_check |
| 1194 | headers_check: headers_install | 1201 | headers_check: headers |
| 1195 | $(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include HDRCHECK=1 | 1202 | $(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include HDRCHECK=1 |
| 1196 | $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi dst=include HDRCHECK=1 | 1203 | $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi dst=include HDRCHECK=1 |
| 1197 | 1204 | ||
| 1198 | ifdef CONFIG_HEADERS_INSTALL | 1205 | ifdef CONFIG_HEADERS_INSTALL |
| 1199 | prepare: headers_install | 1206 | prepare: headers |
| 1200 | endif | 1207 | endif |
| 1201 | 1208 | ||
| 1202 | ifdef CONFIG_HEADERS_CHECK | 1209 | ifdef CONFIG_HEADERS_CHECK |
| @@ -324,9 +324,7 @@ config HEADERS_CHECK · 323 unmodified lines | |||
| 324 | attempt to include files which were not exported, etc. | 324 | attempt to include files which were not exported, etc. |
| 325 | 325 | ||
| 326 | If you're making modifications to header files which are | 326 | If you're making modifications to header files which are |
| 327 | relevant for userspace, say 'Y', and check the headers | 327 | relevant for userspace, say 'Y'. |
| 328 | exported to $(INSTALL_HDR_PATH) (usually 'usr/include' in | ||
| 329 | your build tree), to make sure they're suitable. | ||
| 330 | 328 | ||
| 331 | config OPTIMIZE_INLINING | 329 | config OPTIMIZE_INLINING |
| 332 | bool "Allow compiler to uninline functions marked 'inline'" | 330 | bool "Allow compiler to uninline functions marked 'inline'" |
| @@ -41,7 +41,7 @@ ifeq ($(skip-inst),) · 40 unmodified lines | |||
| 41 | kbuild-file := $(srctree)/$(obj)/Kbuild | 41 | kbuild-file := $(srctree)/$(obj)/Kbuild |
| 42 | -include $(kbuild-file) | 42 | -include $(kbuild-file) |
| 43 | 43 | ||
| 44 | installdir := $(INSTALL_HDR_PATH)/$(dst) | 44 | installdir := usr/$(dst) |
| 45 | gendir := $(objtree)/$(subst include/,include/generated/,$(obj)) | 45 | gendir := $(objtree)/$(subst include/,include/generated/,$(obj)) |
| 46 | header-files := $(notdir $(wildcard $(srcdir)/*.h)) | 46 | header-files := $(notdir $(wildcard $(srcdir)/*.h)) |
| 47 | header-files := $(filter-out $(no-export-headers), $(header-files)) | 47 | header-files := $(filter-out $(no-export-headers), $(header-files)) |
| @@ -60,10 +60,10 @@ output-files := $(addprefix $(installdir)/, $(all-files)) · 12 unmodified lines | |||
| 60 | oldheaders := $(patsubst $(installdir)/%,%,$(wildcard $(installdir)/*.h)) | 60 | oldheaders := $(patsubst $(installdir)/%,%,$(wildcard $(installdir)/*.h)) |
| 61 | unwanted := $(filter-out $(all-files),$(oldheaders)) | 61 | unwanted := $(filter-out $(all-files),$(oldheaders)) |
| 62 | 62 | ||
| 63 | # Prefix unwanted with full paths to $(INSTALL_HDR_PATH) | 63 | # Prefix unwanted with full paths to objtree |
| 64 | unwanted-file := $(addprefix $(installdir)/, $(unwanted)) | 64 | unwanted-file := $(addprefix $(installdir)/, $(unwanted)) |
| 65 | 65 | ||
| 66 | printdir = $(patsubst $(INSTALL_HDR_PATH)/%/,%,$(dir $@)) | 66 | printdir = $(patsubst %/,%,$(dir $@)) |
| 67 | 67 | ||
| 68 | quiet_cmd_install = INSTALL $(printdir) ($(words $(all-files))\ | 68 | quiet_cmd_install = INSTALL $(printdir) ($(words $(all-files))\ |
| 69 | file$(if $(word 2, $(all-files)),s)) | 69 | file$(if $(word 2, $(all-files)),s)) |
| @@ -81,7 +81,7 @@ quiet_cmd_check = CHECK $(printdir) ($(words $(all-files)) files) · 11 unmodified lines | |||
| 81 | cmd_check = for f in $(all-files); do \ | 81 | cmd_check = for f in $(all-files); do \ |
| 82 | echo "$(installdir)/$${f}"; done \ | 82 | echo "$(installdir)/$${f}"; done \ |
| 83 | | xargs \ | 83 | | xargs \ |
| 84 | $(PERL) $< $(INSTALL_HDR_PATH)/include $(SRCARCH); \ | 84 | $(PERL) $< usr/include $(SRCARCH); \ |
| 85 | touch $@ | 85 | touch $@ |
| 86 | 86 | ||
| 87 | ifndef HDRCHECK | 87 | ifndef HDRCHECK |