scripts/Makefile.headersinst

   1 # SPDX-License-Identifier: GPL-2.0
   2 # ==========================================================================
   3 # Installing headers
   4 #
   5 # All headers under include/uapi, include/generated/uapi,
   6 # arch/<arch>/include/uapi and arch/<arch>/include/generated/uapi are
   7 # exported.
   8 # They are preprocessed to remove __KERNEL__ section of the file.
   9 #
  10 # ==========================================================================
  11
  12 PHONY := __headers
  13 __headers:
  14
  15 include scripts/Kbuild.include
  16
  17 srcdir        := $(srctree)/$(obj)
  18
  19 # When make is run under a fakechroot environment, the function
  20 # $(wildcard $(srcdir)/*/.) doesn't only return directories, but also regular
  21 # files. So, we are using a combination of sort/dir/wildcard which works
  22 # with fakechroot.
  23 subdirs       := $(patsubst $(srcdir)/%/,%,\
  24                  $(filter-out $(srcdir)/,\
  25                  $(sort $(dir $(wildcard $(srcdir)/*/)))))
  26
  27 # Recursion
  28 __headers: $(subdirs)
  29
  30 .PHONY: $(subdirs)
  31 $(subdirs):
  32         $(Q)$(MAKE) $(hdr-inst)=$(obj)/$@ dst=$(dst)/$@
  33
  34 # Skip header install/check for include/uapi and arch/$(hdr-arch)/include/uapi.
  35 # We have only sub-directories there.
  36 skip-inst := $(if $(filter %/uapi,$(obj)),1)
  37
  38 ifeq ($(skip-inst),)
  39
  40 # Kbuild file is optional
  41 kbuild-file := $(srctree)/$(obj)/Kbuild
  42 -include $(kbuild-file)
  43
  44 installdir    := $(INSTALL_HDR_PATH)/$(dst)
  45 gendir        := $(objtree)/$(subst include/,include/generated/,$(obj))
  46 header-files  := $(notdir $(wildcard $(srcdir)/*.h))
  47 header-files  += $(notdir $(wildcard $(srcdir)/*.agh))
  48 header-files  := $(filter-out $(no-export-headers), $(header-files))
  49 genhdr-files  := $(notdir $(wildcard $(gendir)/*.h))
  50 genhdr-files  := $(filter-out $(header-files), $(genhdr-files))
  51
  52 # files used to track state of install/check
  53 install-file  := $(installdir)/.install
  54 check-file    := $(installdir)/.check
  55
  56 # all headers files for this dir
  57 all-files     := $(header-files) $(genhdr-files)
  58 output-files  := $(addprefix $(installdir)/, $(all-files))
  59
  60 ifneq ($(mandatory-y),)
  61 missing       := $(filter-out $(all-files),$(mandatory-y))
  62 ifneq ($(missing),)
  63 $(error Some mandatory headers ($(missing)) are missing in $(obj))
  64 endif
  65 endif
  66
  67 # Work out what needs to be removed
  68 oldheaders    := $(patsubst $(installdir)/%,%,$(wildcard $(installdir)/*.h))
  69 unwanted      := $(filter-out $(all-files),$(oldheaders))
  70
  71 # Prefix unwanted with full paths to $(INSTALL_HDR_PATH)
  72 unwanted-file := $(addprefix $(installdir)/, $(unwanted))
  73
  74 printdir = $(patsubst $(INSTALL_HDR_PATH)/%/,%,$(dir $@))
  75
  76 quiet_cmd_install = INSTALL $(printdir) ($(words $(all-files))\
  77                             file$(if $(word 2, $(all-files)),s))
  78       cmd_install = \
  79         $(CONFIG_SHELL) $< $(installdir) $(srcdir) $(header-files); \
  80         $(CONFIG_SHELL) $< $(installdir) $(gendir) $(genhdr-files); \
  81         touch $@
  82
  83 quiet_cmd_remove = REMOVE  $(unwanted)
  84       cmd_remove = rm -f $(unwanted-file)
  85
  86 quiet_cmd_check = CHECK   $(printdir) ($(words $(all-files)) files)
  87 # Headers list can be pretty long, xargs helps to avoid
  88 # the "Argument list too long" error.
  89       cmd_check = for f in $(all-files); do                          \
  90                   echo "$(installdir)/$${f}"; done                      \
  91                   | xargs                                            \
  92                   $(PERL) $< $(INSTALL_HDR_PATH)/include $(SRCARCH); \
  93                   touch $@
  94
  95 ifndef HDRCHECK
  96 # Rules for installing headers
  97 __headers: $(install-file)
  98         @:
  99
 100 targets += $(install-file)
 101 $(install-file): scripts/headers_install.sh \
 102                  $(addprefix $(srcdir)/,$(header-files)) \
 103                  $(addprefix $(gendir)/,$(genhdr-files)) FORCE
 104         $(if $(unwanted),$(call cmd,remove),)
 105         $(if $(wildcard $(dir $@)),,$(shell mkdir -p $(dir $@)))
 106         $(call if_changed,install)
 107
 108 else
 109 __headers: $(check-file)
 110         @:
 111
 112 targets += $(check-file)
 113 $(check-file): scripts/headers_check.pl $(output-files) FORCE
 114         $(call if_changed,check)
 115
 116 endif
 117
 118 targets := $(wildcard $(sort $(targets)))
 119 cmd_files := $(wildcard \
 120              $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
 121
 122 ifneq ($(cmd_files),)
 123         include $(cmd_files)
 124 endif
 125
 126 endif # skip-inst
 127
 128 .PHONY: $(PHONY)
 129 PHONY += FORCE
 130 FORCE: ;