tools/scripts/Makefile.include

   1 # SPDX-License-Identifier: GPL-2.0
   2 ifneq ($(O),)
   3 ifeq ($(origin O), command line)
   4         $(if $(shell cd $(PWD); test -d $(O) || echo $(O)),$(error O=$(O) does not exist),)
   5         ABSOLUTE_O := $(shell cd $(PWD); cd $(O) ; pwd)
   6         OUTPUT := $(ABSOLUTE_O)/$(if $(subdir),$(subdir)/)
   7         COMMAND_O := O=$(ABSOLUTE_O)
   8 ifeq ($(objtree),)
   9         objtree := $(O)
  10 endif
  11 endif
  12 endif
  13
  14 # check that the output directory actually exists
  15 ifneq ($(OUTPUT),)
  16 OUTDIR := $(shell cd $(OUTPUT) && pwd)
  17 $(if $(OUTDIR),, $(error output directory "$(OUTPUT)" does not exist))
  18 endif
  19
  20 #
  21 # Include saner warnings here, which can catch bugs:
  22 #
  23 EXTRA_WARNINGS := -Wbad-function-cast
  24 EXTRA_WARNINGS += -Wdeclaration-after-statement
  25 EXTRA_WARNINGS += -Wformat-security
  26 EXTRA_WARNINGS += -Wformat-y2k
  27 EXTRA_WARNINGS += -Winit-self
  28 EXTRA_WARNINGS += -Wmissing-declarations
  29 EXTRA_WARNINGS += -Wmissing-prototypes
  30 EXTRA_WARNINGS += -Wnested-externs
  31 EXTRA_WARNINGS += -Wno-system-headers
  32 EXTRA_WARNINGS += -Wold-style-definition
  33 EXTRA_WARNINGS += -Wpacked
  34 EXTRA_WARNINGS += -Wredundant-decls
  35 EXTRA_WARNINGS += -Wstrict-prototypes
  36 EXTRA_WARNINGS += -Wswitch-default
  37 EXTRA_WARNINGS += -Wswitch-enum
  38 EXTRA_WARNINGS += -Wundef
  39 EXTRA_WARNINGS += -Wwrite-strings
  40 EXTRA_WARNINGS += -Wformat
  41 EXTRA_WARNINGS += -Wno-type-limits
  42
  43 # Makefiles suck: This macro sets a default value of $(2) for the
  44 # variable named by $(1), unless the variable has been set by
  45 # environment or command line. This is necessary for CC and AR
  46 # because make sets default values, so the simpler ?= approach
  47 # won't work as expected.
  48 define allow-override
  49   $(if $(or $(findstring environment,$(origin $(1))),\
  50             $(findstring command line,$(origin $(1)))),,\
  51     $(eval $(1) = $(2)))
  52 endef
  53
  54 ifneq ($(LLVM),)
  55 ifneq ($(filter %/,$(LLVM)),)
  56 LLVM_PREFIX := $(LLVM)
  57 else ifneq ($(filter -%,$(LLVM)),)
  58 LLVM_SUFFIX := $(LLVM)
  59 endif
  60
  61 $(call allow-override,CC,$(LLVM_PREFIX)clang$(LLVM_SUFFIX))
  62 $(call allow-override,AR,$(LLVM_PREFIX)llvm-ar$(LLVM_SUFFIX))
  63 $(call allow-override,LD,$(LLVM_PREFIX)ld.lld$(LLVM_SUFFIX))
  64 $(call allow-override,CXX,$(LLVM_PREFIX)clang++$(LLVM_SUFFIX))
  65 $(call allow-override,STRIP,$(LLVM_PREFIX)llvm-strip$(LLVM_SUFFIX))
  66 else
  67 # Allow setting various cross-compile vars or setting CROSS_COMPILE as a prefix.
  68 $(call allow-override,CC,$(CROSS_COMPILE)gcc)
  69 $(call allow-override,AR,$(CROSS_COMPILE)ar)
  70 $(call allow-override,LD,$(CROSS_COMPILE)ld)
  71 $(call allow-override,CXX,$(CROSS_COMPILE)g++)
  72 $(call allow-override,STRIP,$(CROSS_COMPILE)strip)
  73 endif
  74
  75 CC_NO_CLANG := $(shell $(CC) -dM -E -x c /dev/null | grep -Fq "__clang__"; echo $$?)
  76
  77 ifneq ($(LLVM),)
  78 HOSTAR  ?= $(LLVM_PREFIX)llvm-ar$(LLVM_SUFFIX)
  79 HOSTCC  ?= $(LLVM_PREFIX)clang$(LLVM_SUFFIX)
  80 HOSTLD  ?= $(LLVM_PREFIX)ld.lld$(LLVM_SUFFIX)
  81 else
  82 HOSTAR  ?= ar
  83 HOSTCC  ?= gcc
  84 HOSTLD  ?= ld
  85 endif
  86
  87 # Some tools require Clang, LLC and/or LLVM utils
  88 CLANG           ?= clang
  89 LLC             ?= llc
  90 LLVM_CONFIG     ?= llvm-config
  91 LLVM_OBJCOPY    ?= llvm-objcopy
  92 LLVM_STRIP      ?= llvm-strip
  93
  94 # Some tools require bpftool
  95 SYSTEM_BPFTOOL  ?= bpftool
  96
  97 ifeq ($(CC_NO_CLANG), 1)
  98 EXTRA_WARNINGS += -Wstrict-aliasing=3
  99
 100 else ifneq ($(CROSS_COMPILE),)
 101 # Allow userspace to override CLANG_CROSS_FLAGS to specify their own
 102 # sysroots and flags or to avoid the GCC call in pure Clang builds.
 103 ifeq ($(CLANG_CROSS_FLAGS),)
 104 CLANG_CROSS_FLAGS := --target=$(notdir $(CROSS_COMPILE:%-=%))
 105 GCC_TOOLCHAIN_DIR := $(dir $(shell which $(CROSS_COMPILE)gcc 2>/dev/null))
 106 ifneq ($(GCC_TOOLCHAIN_DIR),)
 107 CLANG_CROSS_FLAGS += --prefix=$(GCC_TOOLCHAIN_DIR)$(notdir $(CROSS_COMPILE))
 108 CLANG_CROSS_FLAGS += --sysroot=$(shell $(CROSS_COMPILE)gcc -print-sysroot)
 109 CLANG_CROSS_FLAGS += --gcc-toolchain=$(realpath $(GCC_TOOLCHAIN_DIR)/..)
 110 endif # GCC_TOOLCHAIN_DIR
 111 endif # CLANG_CROSS_FLAGS
 112 CFLAGS += $(CLANG_CROSS_FLAGS)
 113 AFLAGS += $(CLANG_CROSS_FLAGS)
 114 else
 115 CLANG_CROSS_FLAGS :=
 116 endif # CROSS_COMPILE
 117
 118 # Hack to avoid type-punned warnings on old systems such as RHEL5:
 119 # We should be changing CFLAGS and checking gcc version, but this
 120 # will do for now and keep the above -Wstrict-aliasing=3 in place
 121 # in newer systems.
 122 # Needed for the __raw_cmpxchg in tools/arch/x86/include/asm/cmpxchg.h
 123 #
 124 # See https://lore.kernel.org/lkml/9a8748490611281710g78402fbeh8ff7fcc162dbcbca@mail.gmail.com/
 125 # and https://gcc.gnu.org/gcc-4.8/changes.html,
 126 # that takes into account Linus's comments (search for Wshadow) for the reasoning about
 127 # -Wshadow not being interesting before gcc 4.8.
 128
 129 ifneq ($(filter 3.%,$(MAKE_VERSION)),)  # make-3
 130 EXTRA_WARNINGS += -fno-strict-aliasing
 131 EXTRA_WARNINGS += -Wno-shadow
 132 else
 133 EXTRA_WARNINGS += -Wshadow
 134 endif
 135
 136 ifneq ($(findstring $(MAKEFLAGS), w),w)
 137 PRINT_DIR = --no-print-directory
 138 else
 139 NO_SUBDIR = :
 140 endif
 141
 142 # Beautify output
 143 # ---------------------------------------------------------------------------
 144 #
 145 # Most of build commands in Kbuild start with "cmd_". You can optionally define
 146 # "quiet_cmd_*". If defined, the short log is printed. Otherwise, no log from
 147 # that command is printed by default.
 148 #
 149 # e.g.)
 150 #    quiet_cmd_depmod = DEPMOD  $(MODLIB)
 151 #          cmd_depmod = $(srctree)/scripts/depmod.sh $(DEPMOD) $(KERNELRELEASE)
 152 #
 153 # A simple variant is to prefix commands with $(Q) - that's useful
 154 # for commands that shall be hidden in non-verbose mode.
 155 #
 156 #    $(Q)$(MAKE) $(build)=scripts/basic
 157 #
 158 # To put more focus on warnings, be less verbose as default
 159 # Use 'make V=1' to see the full commands
 160
 161 ifeq ($(V),1)
 162   quiet =
 163   Q =
 164 else
 165   quiet = quiet_
 166   Q = @
 167 endif
 168
 169 # If the user is running make -s (silent mode), suppress echoing of commands
 170 # make-4.0 (and later) keep single letter options in the 1st word of MAKEFLAGS.
 171 ifeq ($(filter 3.%,$(MAKE_VERSION)),)
 172 short-opts := $(firstword -$(MAKEFLAGS))
 173 else
 174 short-opts := $(filter-out --%,$(MAKEFLAGS))
 175 endif
 176
 177 ifneq ($(findstring s,$(short-opts)),)
 178   silent=1
 179   quiet=silent_
 180 endif
 181
 182 export quiet Q
 183
 184 #
 185 # Define a callable command for descending to a new directory
 186 #
 187 # Call by doing: $(call descend,directory[,target])
 188 #
 189 descend = \
 190         +mkdir -p $(OUTPUT)$(1) && \
 191         $(MAKE) $(COMMAND_O) subdir=$(if $(subdir),$(subdir)/$(1),$(1)) $(PRINT_DIR) -C $(1) $(2)
 192
 193 QUIET_SUBDIR0  = +$(MAKE) $(COMMAND_O) -C # space to separate -C and subdir
 194 QUIET_SUBDIR1  =
 195
 196 ifneq ($(silent),1)
 197   ifneq ($(V),1)
 198         QUIET_CC       = @echo '  CC      '$@;
 199         QUIET_CC_FPIC  = @echo '  CC FPIC '$@;
 200         QUIET_CLANG    = @echo '  CLANG   '$@;
 201         QUIET_AR       = @echo '  AR      '$@;
 202         QUIET_LINK     = @echo '  LINK    '$@;
 203         QUIET_MKDIR    = @echo '  MKDIR   '$@;
 204         QUIET_GEN      = @echo '  GEN     '$@;
 205         QUIET_SUBDIR0  = +@subdir=
 206         QUIET_SUBDIR1  = ;$(NO_SUBDIR) \
 207                           echo '  SUBDIR  '$$subdir; \
 208                          $(MAKE) $(PRINT_DIR) -C $$subdir
 209         QUIET_FLEX     = @echo '  FLEX    '$@;
 210         QUIET_BISON    = @echo '  BISON   '$@;
 211         QUIET_GENSKEL  = @echo '  GENSKEL '$@;
 212
 213         descend = \
 214                 +@echo         '  DESCEND '$(1); \
 215                 mkdir -p $(OUTPUT)$(1) && \
 216                 $(MAKE) $(COMMAND_O) subdir=$(if $(subdir),$(subdir)/$(1),$(1)) $(PRINT_DIR) -C $(1) $(2)
 217
 218         QUIET_CLEAN    = @printf '  CLEAN   %s\n' $1;
 219         QUIET_INSTALL  = @printf '  INSTALL %s\n' $1;
 220         QUIET_UNINST   = @printf '  UNINST  %s\n' $1;
 221   endif
 222 endif
 223
 224 pound := \#