[mirror_ubuntu-jammy-kernel.git] / scripts / Makefile.lib

# SPDX-License-Identifier: GPL-2.0
# Backward compatibility
asflags-y  += $(EXTRA_AFLAGS)
ccflags-y  += $(EXTRA_CFLAGS)
cppflags-y += $(EXTRA_CPPFLAGS)
ldflags-y  += $(EXTRA_LDFLAGS)

# flags that take effect in current and sub directories
KBUILD_AFLAGS += $(subdir-asflags-y)
KBUILD_CFLAGS += $(subdir-ccflags-y)

# Figure out what we need to build from the various variables
# ===========================================================================

# When an object is listed to be built compiled-in and modular,
# only build the compiled-in version
obj-m := $(filter-out $(obj-y),$(obj-m))

# Libraries are always collected in one lib file.
# Filter out objects already built-in
lib-y := $(filter-out $(obj-y), $(sort $(lib-y) $(lib-m)))

# Subdirectories we need to descend into
subdir-ym := $(sort $(subdir-y) $(subdir-m) \
			$(patsubst %/,%, $(filter %/, $(obj-y) $(obj-m))))

# Handle objects in subdirs:
# - If we encounter foo/ in $(obj-y), replace it by foo/built-in.a and
#   foo/modules.order
# - If we encounter foo/ in $(obj-m), replace it by foo/modules.order
#
# Generate modules.order to determine modorder. Unfortunately, we don't have
# information about ordering between -y and -m subdirs. Just put -y's first.

ifdef need-modorder
obj-m := $(patsubst %/,%/modules.order, $(filter %/, $(obj-y)) $(obj-m))
else
obj-m := $(filter-out %/, $(obj-m))
endif

ifdef need-builtin
obj-y		:= $(patsubst %/, %/built-in.a, $(obj-y))
else
obj-y		:= $(filter-out %/, $(obj-y))
endif

# Expand $(foo-objs) $(foo-y) by calling $(call suffix-search,foo.o,-objs -y)
suffix-search = $(foreach s,$(2),$($(1:.o=$s)))
# If $(foo-objs), $(foo-y), $(foo-m), or $(foo-) exists, foo.o is a composite object
multi-search = $(sort $(foreach m,$(1), $(if $(strip $(call suffix-search,$(m),$(2) -)), $(m))))
multi-used-y := $(call multi-search,$(obj-y),-objs -y)
multi-used-m := $(call multi-search,$(obj-m),-objs -y -m)
multi-used   := $(multi-used-y) $(multi-used-m)

# Replace multi-part objects by their individual parts,
# including built-in.a from subdirectories
real-search = $(foreach m,$(1), $(if $(strip $(call suffix-search,$(m),$(2) -)),$(call suffix-search,$(m),$(2)),$(m)))
real-obj-y := $(call real-search, $(obj-y),-objs -y)
real-obj-m := $(call real-search, $(obj-m),-objs -y -m)

always-y += $(always-m)

# hostprogs-always-y += foo
# ... is a shorthand for
# hostprogs += foo
# always-y  += foo
hostprogs += $(hostprogs-always-y) $(hostprogs-always-m)
always-y += $(hostprogs-always-y) $(hostprogs-always-m)

# userprogs-always-y is likewise.
userprogs += $(userprogs-always-y) $(userprogs-always-m)
always-y += $(userprogs-always-y) $(userprogs-always-m)

# DTB
# If CONFIG_OF_ALL_DTBS is enabled, all DT blobs are built
dtb-$(CONFIG_OF_ALL_DTBS)       += $(dtb-)

always-y			+= $(dtb-y)

ifneq ($(CHECK_DTBS),)
always-y += $(patsubst %.dtb,%.dt.yaml, $(dtb-y))
always-y += $(patsubst %.dtbo,%.dt.yaml, $(dtb-y))
endif

# Add subdir path

extra-y		:= $(addprefix $(obj)/,$(extra-y))
always-y	:= $(addprefix $(obj)/,$(always-y))
targets		:= $(addprefix $(obj)/,$(targets))
obj-m		:= $(addprefix $(obj)/,$(obj-m))
lib-y		:= $(addprefix $(obj)/,$(lib-y))
real-obj-y	:= $(addprefix $(obj)/,$(real-obj-y))
real-obj-m	:= $(addprefix $(obj)/,$(real-obj-m))
multi-used-m	:= $(addprefix $(obj)/,$(multi-used-m))
subdir-ym	:= $(addprefix $(obj)/,$(subdir-ym))

# Finds the multi-part object the current object will be linked into.
# If the object belongs to two or more multi-part objects, list them all.
modname-multi = $(sort $(foreach m,$(multi-used),\
		$(if $(filter $*.o, $($(m:.o=-objs)) $($(m:.o=-y)) $($(m:.o=-m))),$(m:.o=))))

__modname = $(if $(modname-multi),$(modname-multi),$(basetarget))

modname = $(subst $(space),:,$(__modname))
modfile = $(addprefix $(obj)/,$(__modname))

# target with $(obj)/ and its suffix stripped
target-stem = $(basename $(patsubst $(obj)/%,%,$@))

# These flags are needed for modversions and compiling, so we define them here
# $(modname_flags) defines KBUILD_MODNAME as the name of the module it will
# end up in (or would, if it gets compiled in)
name-fix-token = $(subst $(comma),_,$(subst -,_,$1))
name-fix = $(call stringify,$(call name-fix-token,$1))
basename_flags = -DKBUILD_BASENAME=$(call name-fix,$(basetarget))
modname_flags  = -DKBUILD_MODNAME=$(call name-fix,$(modname)) \
		 -D__KBUILD_MODNAME=kmod_$(call name-fix-token,$(modname))
modfile_flags  = -DKBUILD_MODFILE=$(call stringify,$(modfile))

_c_flags       = $(filter-out $(CFLAGS_REMOVE_$(target-stem).o), \
                     $(filter-out $(ccflags-remove-y), \
                         $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(ccflags-y)) \
                     $(CFLAGS_$(target-stem).o))
_a_flags       = $(filter-out $(AFLAGS_REMOVE_$(target-stem).o), \
                     $(filter-out $(asflags-remove-y), \
                         $(KBUILD_CPPFLAGS) $(KBUILD_AFLAGS) $(asflags-y)) \
                     $(AFLAGS_$(target-stem).o))
_cpp_flags     = $(KBUILD_CPPFLAGS) $(cppflags-y) $(CPPFLAGS_$(target-stem).lds)

#
# Enable gcov profiling flags for a file, directory or for all files depending
# on variables GCOV_PROFILE_obj.o, GCOV_PROFILE and CONFIG_GCOV_PROFILE_ALL
# (in this order)
#
ifeq ($(CONFIG_GCOV_KERNEL),y)
_c_flags += $(if $(patsubst n%,, \
		$(GCOV_PROFILE_$(basetarget).o)$(GCOV_PROFILE)$(CONFIG_GCOV_PROFILE_ALL)), \
		$(CFLAGS_GCOV))
endif

#
# Enable address sanitizer flags for kernel except some files or directories
# we don't want to check (depends on variables KASAN_SANITIZE_obj.o, KASAN_SANITIZE)
#
ifeq ($(CONFIG_KASAN),y)
ifneq ($(CONFIG_KASAN_HW_TAGS),y)
_c_flags += $(if $(patsubst n%,, \
		$(KASAN_SANITIZE_$(basetarget).o)$(KASAN_SANITIZE)y), \
		$(CFLAGS_KASAN), $(CFLAGS_KASAN_NOSANITIZE))
endif
endif

ifeq ($(CONFIG_UBSAN),y)
_c_flags += $(if $(patsubst n%,, \
		$(UBSAN_SANITIZE_$(basetarget).o)$(UBSAN_SANITIZE)$(CONFIG_UBSAN_SANITIZE_ALL)), \
		$(CFLAGS_UBSAN))
endif

ifeq ($(CONFIG_KCOV),y)
_c_flags += $(if $(patsubst n%,, \
	$(KCOV_INSTRUMENT_$(basetarget).o)$(KCOV_INSTRUMENT)$(CONFIG_KCOV_INSTRUMENT_ALL)), \
	$(CFLAGS_KCOV))
endif

#
# Enable KCSAN flags except some files or directories we don't want to check
# (depends on variables KCSAN_SANITIZE_obj.o, KCSAN_SANITIZE)
#
ifeq ($(CONFIG_KCSAN),y)
_c_flags += $(if $(patsubst n%,, \
	$(KCSAN_SANITIZE_$(basetarget).o)$(KCSAN_SANITIZE)y), \
	$(CFLAGS_KCSAN))
endif

# $(srctree)/$(src) for including checkin headers from generated source files
# $(objtree)/$(obj) for including generated headers from checkin source files
ifeq ($(KBUILD_EXTMOD),)
ifdef building_out_of_srctree
_c_flags   += -I $(srctree)/$(src) -I $(objtree)/$(obj)
_a_flags   += -I $(srctree)/$(src) -I $(objtree)/$(obj)
_cpp_flags += -I $(srctree)/$(src) -I $(objtree)/$(obj)
endif
endif

part-of-module = $(if $(filter $(basename $@).o, $(real-obj-m)),y)
quiet_modtag = $(if $(part-of-module),[M],   )

modkern_cflags =                                          \
	$(if $(part-of-module),                           \
		$(KBUILD_CFLAGS_MODULE) $(CFLAGS_MODULE), \
		$(KBUILD_CFLAGS_KERNEL) $(CFLAGS_KERNEL) $(modfile_flags))

modkern_aflags = $(if $(part-of-module),				\
			$(KBUILD_AFLAGS_MODULE) $(AFLAGS_MODULE),	\
			$(KBUILD_AFLAGS_KERNEL) $(AFLAGS_KERNEL))

c_flags        = -Wp,-MMD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE)     \
		 -include $(srctree)/include/linux/compiler_types.h       \
		 $(_c_flags) $(modkern_cflags)                           \
		 $(basename_flags) $(modname_flags)

a_flags        = -Wp,-MMD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE)     \
		 $(_a_flags) $(modkern_aflags)

cpp_flags      = -Wp,-MMD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE)     \
		 $(_cpp_flags)

ld_flags       = $(KBUILD_LDFLAGS) $(ldflags-y) $(LDFLAGS_$(@F))

DTC_INCLUDE    := $(srctree)/scripts/dtc/include-prefixes

dtc_cpp_flags  = -Wp,-MMD,$(depfile).pre.tmp -nostdinc                    \
		 $(addprefix -I,$(DTC_INCLUDE))                          \
		 -undef -D__DTS__

# Objtool arguments are also needed for modfinal with LTO, so we define
# then here to avoid duplication.
objtool_args =								\
	$(if $(CONFIG_UNWINDER_ORC),orc generate,check)			\
	$(if $(part-of-module), --module,)				\
	$(if $(CONFIG_FRAME_POINTER),, --no-fp)				\
	$(if $(or $(CONFIG_GCOV_KERNEL),$(CONFIG_LTO_CLANG)), 		\
		--no-unreachable,)					\
	$(if $(CONFIG_RETPOLINE), --retpoline,)				\
	$(if $(CONFIG_X86_SMAP), --uaccess,)				\
	$(if $(CONFIG_FTRACE_MCOUNT_USE_OBJTOOL), --mcount,)

# Useful for describing the dependency of composite objects
# Usage:
#   $(call multi_depend, multi_used_targets, suffix_to_remove, suffix_to_add)
define multi_depend
$(foreach m, $(notdir $1), \
	$(eval $(obj)/$m: \
	$(addprefix $(obj)/, $(foreach s, $3, $($(m:%$(strip $2)=%$(s)))))))
endef

quiet_cmd_copy = COPY    $@
      cmd_copy = cp $< $@

# Shipped files
# ===========================================================================

quiet_cmd_shipped = SHIPPED $@
cmd_shipped = cat $< > $@

$(obj)/%: $(src)/%_shipped
	$(call cmd,shipped)

# Commands useful for building a boot image
# ===========================================================================
#
#	Use as following:
#
#	target: source(s) FORCE
#		$(if_changed,ld/objcopy/gzip)
#
#	and add target to 'targets' so that we know we have to
#	read in the saved command line

# Linking
# ---------------------------------------------------------------------------

quiet_cmd_ld = LD      $@
      cmd_ld = $(LD) $(ld_flags) $(real-prereqs) -o $@

# Archive
# ---------------------------------------------------------------------------

quiet_cmd_ar = AR      $@
      cmd_ar = rm -f $@; $(AR) cDPrsT $@ $(real-prereqs)

# Objcopy
# ---------------------------------------------------------------------------

quiet_cmd_objcopy = OBJCOPY $@
cmd_objcopy = $(OBJCOPY) $(OBJCOPYFLAGS) $(OBJCOPYFLAGS_$(@F)) $< $@

# Gzip
# ---------------------------------------------------------------------------

quiet_cmd_gzip = GZIP    $@
      cmd_gzip = cat $(real-prereqs) | $(KGZIP) -n -f -9 > $@

# DTC
# ---------------------------------------------------------------------------
DTC ?= $(objtree)/scripts/dtc/dtc
DTC_FLAGS += -Wno-interrupt_provider

# Disable noisy checks by default
ifeq ($(findstring 1,$(KBUILD_EXTRA_WARN)),)
DTC_FLAGS += -Wno-unit_address_vs_reg \
	-Wno-unit_address_format \
	-Wno-avoid_unnecessary_addr_size \
	-Wno-alias_paths \
	-Wno-graph_child_address \
	-Wno-simple_bus_reg \
	-Wno-unique_unit_address \
	-Wno-pci_device_reg
endif

ifneq ($(findstring 2,$(KBUILD_EXTRA_WARN)),)
DTC_FLAGS += -Wnode_name_chars_strict \
	-Wproperty_name_chars_strict \
	-Winterrupt_provider
endif

DTC_FLAGS += $(DTC_FLAGS_$(basetarget))

# Generate an assembly file to wrap the output of the device tree compiler
quiet_cmd_dt_S_dtb= DTB     $@
cmd_dt_S_dtb=						\
{							\
	echo '\#include <asm-generic/vmlinux.lds.h>'; 	\
	echo '.section .dtb.init.rodata,"a"';		\
	echo '.balign STRUCT_ALIGNMENT';		\
	echo '.global __dtb_$(subst -,_,$(*F))_begin';	\
	echo '__dtb_$(subst -,_,$(*F))_begin:';		\
	echo '.incbin "$<" ';				\
	echo '__dtb_$(subst -,_,$(*F))_end:';		\
	echo '.global __dtb_$(subst -,_,$(*F))_end';	\
	echo '.balign STRUCT_ALIGNMENT'; 		\
} > $@

$(obj)/%.dtb.S: $(obj)/%.dtb FORCE
	$(call if_changed,dt_S_dtb)

quiet_cmd_dtc = DTC     $@
cmd_dtc = $(HOSTCC) -E $(dtc_cpp_flags) -x assembler-with-cpp -o $(dtc-tmp) $< ; \
	$(DTC) -O $(patsubst .%,%,$(suffix $@)) -o $@ -b 0 \
		$(addprefix -i,$(dir $<) $(DTC_INCLUDE)) $(DTC_FLAGS) \
		-d $(depfile).dtc.tmp $(dtc-tmp) ; \
	cat $(depfile).pre.tmp $(depfile).dtc.tmp > $(depfile)

$(obj)/%.dtb: $(src)/%.dts $(DTC) FORCE
	$(call if_changed_dep,dtc)

$(obj)/%.dtbo: $(src)/%.dts $(DTC) FORCE
	$(call if_changed_dep,dtc)

DT_CHECKER ?= dt-validate
DT_CHECKER_FLAGS ?= $(if $(DT_SCHEMA_FILES),,-m)
DT_BINDING_DIR := Documentation/devicetree/bindings
# DT_TMP_SCHEMA may be overridden from Documentation/devicetree/bindings/Makefile
DT_TMP_SCHEMA ?= $(objtree)/$(DT_BINDING_DIR)/processed-schema.json

quiet_cmd_dtb_check =	CHECK   $@
      cmd_dtb_check =	$(DT_CHECKER) $(DT_CHECKER_FLAGS) -u $(srctree)/$(DT_BINDING_DIR) -p $(DT_TMP_SCHEMA) $@

define rule_dtc
	$(call cmd_and_fixdep,dtc)
	$(call cmd,dtb_check)
endef

$(obj)/%.dt.yaml: $(src)/%.dts $(DTC) $(DT_TMP_SCHEMA) FORCE
	$(call if_changed_rule,dtc,yaml)

dtc-tmp = $(subst $(comma),_,$(dot-target).dts.tmp)

# Bzip2
# ---------------------------------------------------------------------------

# Bzip2 and LZMA do not include size in file... so we have to fake that;
# append the size as a 32-bit littleendian number as gzip does.
size_append = printf $(shell						\
dec_size=0;								\
for F in $(real-prereqs); do					\
	fsize=$$($(CONFIG_SHELL) $(srctree)/scripts/file-size.sh $$F);	\
	dec_size=$$(expr $$dec_size + $$fsize);				\
done;									\
printf "%08x\n" $$dec_size |						\
	sed 's/\(..\)/\1 /g' | {					\
		read ch0 ch1 ch2 ch3;					\
		for ch in $$ch3 $$ch2 $$ch1 $$ch0; do			\
			printf '%s%03o' '\\' $$((0x$$ch)); 		\
		done;							\
	}								\
)

quiet_cmd_bzip2 = BZIP2   $@
      cmd_bzip2 = { cat $(real-prereqs) | $(KBZIP2) -9; $(size_append); } > $@

# Lzma
# ---------------------------------------------------------------------------

quiet_cmd_lzma = LZMA    $@
      cmd_lzma = { cat $(real-prereqs) | $(LZMA) -9; $(size_append); } > $@

quiet_cmd_lzo = LZO     $@
      cmd_lzo = { cat $(real-prereqs) | $(KLZOP) -9; $(size_append); } > $@

quiet_cmd_lz4 = LZ4     $@
      cmd_lz4 = { cat $(real-prereqs) | $(LZ4) -l -c1 stdin stdout; \
                  $(size_append); } > $@

# U-Boot mkimage
# ---------------------------------------------------------------------------

MKIMAGE := $(srctree)/scripts/mkuboot.sh

# SRCARCH just happens to match slightly more than ARCH (on sparc), so reduces
# the number of overrides in arch makefiles
UIMAGE_ARCH ?= $(SRCARCH)
UIMAGE_COMPRESSION ?= $(if $(2),$(2),none)
UIMAGE_OPTS-y ?=
UIMAGE_TYPE ?= kernel
UIMAGE_LOADADDR ?= arch_must_set_this
UIMAGE_ENTRYADDR ?= $(UIMAGE_LOADADDR)
UIMAGE_NAME ?= 'Linux-$(KERNELRELEASE)'

quiet_cmd_uimage = UIMAGE  $@
      cmd_uimage = $(BASH) $(MKIMAGE) -A $(UIMAGE_ARCH) -O linux \
			-C $(UIMAGE_COMPRESSION) $(UIMAGE_OPTS-y) \
			-T $(UIMAGE_TYPE) \
			-a $(UIMAGE_LOADADDR) -e $(UIMAGE_ENTRYADDR) \
			-n $(UIMAGE_NAME) -d $< $@

# XZ
# ---------------------------------------------------------------------------
# Use xzkern to compress the kernel image and xzmisc to compress other things.
#
# xzkern uses a big LZMA2 dictionary since it doesn't increase memory usage
# of the kernel decompressor. A BCJ filter is used if it is available for
# the target architecture. xzkern also appends uncompressed size of the data
# using size_append. The .xz format has the size information available at
# the end of the file too, but it's in more complex format and it's good to
# avoid changing the part of the boot code that reads the uncompressed size.
# Note that the bytes added by size_append will make the xz tool think that
# the file is corrupt. This is expected.
#
# xzmisc doesn't use size_append, so it can be used to create normal .xz
# files. xzmisc uses smaller LZMA2 dictionary than xzkern, because a very
# big dictionary would increase the memory usage too much in the multi-call
# decompression mode. A BCJ filter isn't used either.
quiet_cmd_xzkern = XZKERN  $@
      cmd_xzkern = { cat $(real-prereqs) | sh $(srctree)/scripts/xz_wrap.sh; \
                     $(size_append); } > $@

quiet_cmd_xzmisc = XZMISC  $@
      cmd_xzmisc = cat $(real-prereqs) | $(XZ) --check=crc32 --lzma2=dict=1MiB > $@

# ZSTD
# ---------------------------------------------------------------------------
# Appends the uncompressed size of the data using size_append. The .zst
# format has the size information available at the beginning of the file too,
# but it's in a more complex format and it's good to avoid changing the part
# of the boot code that reads the uncompressed size.
#
# Note that the bytes added by size_append will make the zstd tool think that
# the file is corrupt. This is expected.
#
# zstd uses a maximum window size of 8 MB. zstd22 uses a maximum window size of
# 128 MB. zstd22 is used for kernel compression because it is decompressed in a
# single pass, so zstd doesn't need to allocate a window buffer. When streaming
# decompression is used, like initramfs decompression, zstd22 should likely not
# be used because it would require zstd to allocate a 128 MB buffer.

quiet_cmd_zstd = ZSTD    $@
      cmd_zstd = { cat $(real-prereqs) | $(ZSTD) -19; $(size_append); } > $@

quiet_cmd_zstd22 = ZSTD22  $@
      cmd_zstd22 = { cat $(real-prereqs) | $(ZSTD) -22 --ultra; $(size_append); } > $@

# ASM offsets
# ---------------------------------------------------------------------------

# Default sed regexp - multiline due to syntax constraints
#
# Use [:space:] because LLVM's integrated assembler inserts <tab> around
# the .ascii directive whereas GCC keeps the <space> as-is.
define sed-offsets
	's:^[[:space:]]*\.ascii[[:space:]]*"\(.*\)".*:\1:; \
	/^->/{s:->#\(.*\):/* \1 */:; \
	s:^->\([^ ]*\) [\$$#]*\([^ ]*\) \(.*\):#define \1 \2 /* \3 */:; \
	s:->::; p;}'
endef

# Use filechk to avoid rebuilds when a header changes, but the resulting file
# does not
define filechk_offsets
	 echo "#ifndef $2"; \
	 echo "#define $2"; \
	 echo "/*"; \
	 echo " * DO NOT MODIFY."; \
	 echo " *"; \
	 echo " * This file was generated by Kbuild"; \
	 echo " */"; \
	 echo ""; \
	 sed -ne $(sed-offsets) < $<; \
	 echo ""; \
	 echo "#endif"
endef
Commit	Line	Data
b2441318	1	# SPDX-License-Identifier: GPL-2.0
f77bf014 SR	2	# Backward compatibility
	3	asflags-y += $(EXTRA_AFLAGS)
	4	ccflags-y += $(EXTRA_CFLAGS)
	5	cppflags-y += $(EXTRA_CPPFLAGS)
	6	ldflags-y += $(EXTRA_LDFLAGS)
	7
8fdc3fbb	8	# flags that take effect in current and sub directories
4e13d47c MY	9	KBUILD_AFLAGS += $(subdir-asflags-y)
4e13d47c MY	10	KBUILD_CFLAGS += $(subdir-ccflags-y)
720097d8	11
1da177e4 LT	12	# Figure out what we need to build from the various variables
	13	# ===========================================================================
	14
	15	# When an object is listed to be built compiled-in and modular,
	16	# only build the compiled-in version
1da177e4 LT	17	obj-m := $(filter-out $(obj-y),$(obj-m))
	18
	19	# Libraries are always collected in one lib file.
	20	# Filter out objects already built-in
1da177e4 LT	21	lib-y := $(filter-out $(obj-y), $(sort $(lib-y) $(lib-m)))
1da177e4 LT	22
0a8820e7 MY	23	# Subdirectories we need to descend into
	24	subdir-ym := $(sort $(subdir-y) $(subdir-m) \
	25	$(patsubst %/,%, $(filter %/, $(obj-y) $(obj-m))))
	26
b2c88554 MY	27	# Handle objects in subdirs:
	28	# - If we encounter foo/ in $(obj-y), replace it by foo/built-in.a and
	29	# foo/modules.order
	30	# - If we encounter foo/ in $(obj-m), replace it by foo/modules.order
	31	#
	32	# Generate modules.order to determine modorder. Unfortunately, we don't have
	33	# information about ordering between -y and -m subdirs. Just put -y's first.
	34
	35	ifdef need-modorder
	36	obj-m := $(patsubst %/,%/modules.order, $(filter %/, $(obj-y)) $(obj-m))
	37	else
	38	obj-m := $(filter-out %/, $(obj-m))
	39	endif
	40
56d58936	41	ifdef need-builtin
f49821ee	42	obj-y := $(patsubst %/, %/built-in.a, $(obj-y))
56d58936 MY	43	else
	44	obj-y := $(filter-out %/, $(obj-y))
	45	endif
1da177e4	46
1c3fae74 EB	47	# Expand $(foo-objs) $(foo-y) by calling $(call suffix-search,foo.o,-objs -y)
1c3fae74 EB	48	suffix-search = $(foreach s,$(2),$($(1:.o=$s)))
33e84f2e	49	# If $(foo-objs), $(foo-y), $(foo-m), or $(foo-) exists, foo.o is a composite object
1c3fae74 EB	50	multi-search = $(sort $(foreach m,$(1), $(if $(strip $(call suffix-search,$(m),$(2) -)), $(m))))
	51	multi-used-y := $(call multi-search,$(obj-y),-objs -y)
	52	multi-used-m := $(call multi-search,$(obj-m),-objs -y -m)
1da177e4	53	multi-used := $(multi-used-y) $(multi-used-m)
1da177e4	54
f98fe47c MY	55	# Replace multi-part objects by their individual parts,
f98fe47c MY	56	# including built-in.a from subdirectories
1c3fae74 EB	57	real-search = $(foreach m,$(1), $(if $(strip $(call suffix-search,$(m),$(2) -)),$(call suffix-search,$(m),$(2)),$(m)))
	58	real-obj-y := $(call real-search, $(obj-y),-objs -y)
	59	real-obj-m := $(call real-search, $(obj-m),-objs -y -m)
1da177e4	60
5f2fb52f MY	61	always-y += $(always-m)
5f2fb52f MY	62
faabed29 MY	63	# hostprogs-always-y += foo
	64	# ... is a shorthand for
	65	# hostprogs += foo
	66	# always-y += foo
	67	hostprogs += $(hostprogs-always-y) $(hostprogs-always-m)
	68	always-y += $(hostprogs-always-y) $(hostprogs-always-m)
	69
	70	# userprogs-always-y is likewise.
	71	userprogs += $(userprogs-always-y) $(userprogs-always-m)
	72	always-y += $(userprogs-always-y) $(userprogs-always-m)
	73
7e7962dd MY	74	# DTB
7e7962dd MY	75	# If CONFIG_OF_ALL_DTBS is enabled, all DT blobs are built
9ca29e41 VK	76	dtb-$(CONFIG_OF_ALL_DTBS) += $(dtb-)
9ca29e41 VK	77
2047ace9	78	always-y += $(dtb-y)
7e7962dd	79
4f0e3a57	80	ifneq ($(CHECK_DTBS),)
2047ace9	81	always-y += $(patsubst %.dtb,%.dt.yaml, $(dtb-y))
6fbd6cf8	82	always-y += $(patsubst %.dtbo,%.dt.yaml, $(dtb-y))
4f0e3a57 RH	83	endif
4f0e3a57 RH	84
1da177e4 LT	85	# Add subdir path
	86
	87	extra-y := $(addprefix $(obj)/,$(extra-y))
5f2fb52f	88	always-y := $(addprefix $(obj)/,$(always-y))
1da177e4	89	targets := $(addprefix $(obj)/,$(targets))
1da177e4 LT	90	obj-m := $(addprefix $(obj)/,$(obj-m))
1da177e4 LT	91	lib-y := $(addprefix $(obj)/,$(lib-y))
f5f33681 MY	92	real-obj-y := $(addprefix $(obj)/,$(real-obj-y))
f5f33681 MY	93	real-obj-m := $(addprefix $(obj)/,$(real-obj-m))
1da177e4	94	multi-used-m := $(addprefix $(obj)/,$(multi-used-m))
1da177e4	95	subdir-ym := $(addprefix $(obj)/,$(subdir-ym))
1da177e4	96
c0152e9a	97	# Finds the multi-part object the current object will be linked into.
1664a377 MY	98	# If the object belongs to two or more multi-part objects, list them all.
	99	modname-multi = $(sort $(foreach m,$(multi-used),\
	100	$(if $(filter $*.o, $($(m:.o=-objs)) $($(m:.o=-y)) $($(m:.o=-m))),$(m:.o=))))
c0152e9a	101
1664a377 MY	102	__modname = $(if $(modname-multi),$(modname-multi),$(basetarget))
	103
	104	modname = $(subst $(space),:,$(__modname))
	105	modfile = $(addprefix $(obj)/,$(__modname))
c0152e9a	106
54b8ae66 MY	107	# target with $(obj)/ and its suffix stripped
	108	target-stem = $(basename $(patsubst $(obj)/%,%,$@))
	109
1da177e4	110	# These flags are needed for modversions and compiling, so we define them here
8fdc3fbb	111	# $(modname_flags) defines KBUILD_MODNAME as the name of the module it will
1da177e4	112	# end up in (or would, if it gets compiled in)
a8cccdd9 ST	113	name-fix-token = $(subst $(comma),_,$(subst -,_,$1))
a8cccdd9 ST	114	name-fix = $(call stringify,$(call name-fix-token,$1))
b42841b7	115	basename_flags = -DKBUILD_BASENAME=$(call name-fix,$(basetarget))
a8cccdd9 ST	116	modname_flags = -DKBUILD_MODNAME=$(call name-fix,$(modname)) \
a8cccdd9 ST	117	-D__KBUILD_MODNAME=kmod_$(call name-fix-token,$(modname))
1664a377	118	modfile_flags = -DKBUILD_MODFILE=$(call stringify,$(modfile))
1da177e4	119
15d5761a MY	120	_c_flags = $(filter-out $(CFLAGS_REMOVE_$(target-stem).o), \
	121	$(filter-out $(ccflags-remove-y), \
	122	$(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS) $(ccflags-y)) \
	123	$(CFLAGS_$(target-stem).o))
	124	_a_flags = $(filter-out $(AFLAGS_REMOVE_$(target-stem).o), \
	125	$(filter-out $(asflags-remove-y), \
	126	$(KBUILD_CPPFLAGS) $(KBUILD_AFLAGS) $(asflags-y)) \
	127	$(AFLAGS_$(target-stem).o))
54b8ae66	128	_cpp_flags = $(KBUILD_CPPFLAGS) $(cppflags-y) $(CPPFLAGS_$(target-stem).lds)
1da177e4	129
2521f2c2 PO	130	#
	131	# Enable gcov profiling flags for a file, directory or for all files depending
	132	# on variables GCOV_PROFILE_obj.o, GCOV_PROFILE and CONFIG_GCOV_PROFILE_ALL
	133	# (in this order)
	134	#
	135	ifeq ($(CONFIG_GCOV_KERNEL),y)
	136	_c_flags += $(if $(patsubst n%,, \
	137	$(GCOV_PROFILE_$(basetarget).o)$(GCOV_PROFILE)$(CONFIG_GCOV_PROFILE_ALL)), \
	138	$(CFLAGS_GCOV))
	139	endif
	140
0b24becc AR	141	#
	142	# Enable address sanitizer flags for kernel except some files or directories
	143	# we don't want to check (depends on variables KASAN_SANITIZE_obj.o, KASAN_SANITIZE)
	144	#
	145	ifeq ($(CONFIG_KASAN),y)
0fea6e9a	146	ifneq ($(CONFIG_KASAN_HW_TAGS),y)
0b24becc AR	147	_c_flags += $(if $(patsubst n%,, \
0b24becc AR	148	$(KASAN_SANITIZE_$(basetarget).o)$(KASAN_SANITIZE)y), \
0e410e15	149	$(CFLAGS_KASAN), $(CFLAGS_KASAN_NOSANITIZE))
0b24becc	150	endif
0fea6e9a	151	endif
0b24becc	152
c6d30853 AR	153	ifeq ($(CONFIG_UBSAN),y)
	154	_c_flags += $(if $(patsubst n%,, \
	155	$(UBSAN_SANITIZE_$(basetarget).o)$(UBSAN_SANITIZE)$(CONFIG_UBSAN_SANITIZE_ALL)), \
	156	$(CFLAGS_UBSAN))
	157	endif
	158
5c9a8750 DV	159	ifeq ($(CONFIG_KCOV),y)
5c9a8750 DV	160	_c_flags += $(if $(patsubst n%,, \
a4691dea	161	$(KCOV_INSTRUMENT_$(basetarget).o)$(KCOV_INSTRUMENT)$(CONFIG_KCOV_INSTRUMENT_ALL)), \
5c9a8750 DV	162	$(CFLAGS_KCOV))
	163	endif
	164
dfd402a4 ME	165	#
	166	# Enable KCSAN flags except some files or directories we don't want to check
	167	# (depends on variables KCSAN_SANITIZE_obj.o, KCSAN_SANITIZE)
	168	#
	169	ifeq ($(CONFIG_KCSAN),y)
	170	_c_flags += $(if $(patsubst n%,, \
	171	$(KCSAN_SANITIZE_$(basetarget).o)$(KCSAN_SANITIZE)y), \
	172	$(CFLAGS_KCSAN))
	173	endif
5c9a8750	174
cdd750bf MY	175	# $(srctree)/$(src) for including checkin headers from generated source files
cdd750bf MY	176	# $(objtree)/$(obj) for including generated headers from checkin source files
58156ba4	177	ifeq ($(KBUILD_EXTMOD),)
051f278e	178	ifdef building_out_of_srctree
cdd750bf MY	179	_c_flags += -I $(srctree)/$(src) -I $(objtree)/$(obj)
	180	_a_flags += -I $(srctree)/$(src) -I $(objtree)/$(obj)
	181	_cpp_flags += -I $(srctree)/$(src) -I $(objtree)/$(obj)
1da177e4	182	endif
58156ba4	183	endif
1da177e4	184
eb27ea5c MY	185	part-of-module = $(if $(filter $(basename $@).o, $(real-obj-m)),y)
	186	quiet_modtag = $(if $(part-of-module),[M], )
	187
	188	modkern_cflags = \
	189	$(if $(part-of-module), \
	190	$(KBUILD_CFLAGS_MODULE) $(CFLAGS_MODULE), \
1664a377	191	$(KBUILD_CFLAGS_KERNEL) $(CFLAGS_KERNEL) $(modfile_flags))
eb27ea5c MY	192
	193	modkern_aflags = $(if $(part-of-module), \
	194	$(KBUILD_AFLAGS_MODULE) $(AFLAGS_MODULE), \
	195	$(KBUILD_AFLAGS_KERNEL) $(AFLAGS_KERNEL))
	196
30a77297	197	c_flags = -Wp,-MMD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE) \
a95b37e2	198	-include $(srctree)/include/linux/compiler_types.h \
cdd750bf	199	$(_c_flags) $(modkern_cflags) \
b42841b7	200	$(basename_flags) $(modname_flags)
1da177e4	201
30a77297	202	a_flags = -Wp,-MMD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE) \
cdd750bf	203	$(_a_flags) $(modkern_aflags)
1da177e4	204
30a77297	205	cpp_flags = -Wp,-MMD,$(depfile) $(NOSTDINC_FLAGS) $(LINUXINCLUDE) \
cdd750bf	206	$(_cpp_flags)
1da177e4	207
d503ac53	208	ld_flags = $(KBUILD_LDFLAGS) $(ldflags-y) $(LDFLAGS_$(@F))
1da177e4	209
50f9ddaf MY	210	DTC_INCLUDE := $(srctree)/scripts/dtc/include-prefixes
50f9ddaf MY	211
30a77297	212	dtc_cpp_flags = -Wp,-MMD,$(depfile).pre.tmp -nostdinc \
50f9ddaf	213	$(addprefix -I,$(DTC_INCLUDE)) \
e570d7c1 SW	214	-undef -D__DTS__
e570d7c1 SW	215
b1a1a1a0 ST	216	# Objtool arguments are also needed for modfinal with LTO, so we define
	217	# then here to avoid duplication.
	218	objtool_args = \
	219	$(if $(CONFIG_UNWINDER_ORC),orc generate,check) \
	220	$(if $(part-of-module), --module,) \
	221	$(if $(CONFIG_FRAME_POINTER),, --no-fp) \
	222	$(if $(or $(CONFIG_GCOV_KERNEL),$(CONFIG_LTO_CLANG)), \
	223	--no-unreachable,) \
	224	$(if $(CONFIG_RETPOLINE), --retpoline,) \
	225	$(if $(CONFIG_X86_SMAP), --uaccess,) \
	226	$(if $(CONFIG_FTRACE_MCOUNT_USE_OBJTOOL), --mcount,)
	227
c8589d1e MY	228	# Useful for describing the dependency of composite objects
	229	# Usage:
	230	# $(call multi_depend, multi_used_targets, suffix_to_remove, suffix_to_add)
	231	define multi_depend
	232	$(foreach m, $(notdir $1), \
	233	$(eval $(obj)/$m: \
	234	$(addprefix $(obj)/, $(foreach s, $3, $($(m:%$(strip $2)=%$(s)))))))
	235	endef
	236
dee9c0b5 MY	237	quiet_cmd_copy = COPY $@
	238	cmd_copy = cp $< $@
	239
1da177e4 LT	240	# Shipped files
	241	# ===========================================================================
	242
	243	quiet_cmd_shipped = SHIPPED $@
	244	cmd_shipped = cat $< > $@
	245
991d76c9	246	$(obj)/%: $(src)/%_shipped
1da177e4 LT	247	$(call cmd,shipped)
	248
	249	# Commands useful for building a boot image
	250	# ===========================================================================
38385f8f	251	#
1da177e4 LT	252	# Use as following:
	253	#
	254	# target: source(s) FORCE
	255	# $(if_changed,ld/objcopy/gzip)
	256	#
2047ace9	257	# and add target to 'targets' so that we know we have to
1da177e4 LT	258	# read in the saved command line
	259
	260	# Linking
	261	# ---------------------------------------------------------------------------
	262
	263	quiet_cmd_ld = LD $@
afa974b7	264	cmd_ld = $(LD) $(ld_flags) $(real-prereqs) -o $@
1da177e4	265
898f5a00 MY	266	# Archive
	267	# ---------------------------------------------------------------------------
	268
	269	quiet_cmd_ar = AR $@
13dc8c02	270	cmd_ar = rm -f $@; $(AR) cDPrsT $@ $(real-prereqs)
898f5a00	271
1da177e4 LT	272	# Objcopy
	273	# ---------------------------------------------------------------------------
	274
	275	quiet_cmd_objcopy = OBJCOPY $@
	276	cmd_objcopy = $(OBJCOPY) $(OBJCOPYFLAGS) $(OBJCOPYFLAGS_$(@F)) $< $@
	277
	278	# Gzip
	279	# ---------------------------------------------------------------------------
	280
	281	quiet_cmd_gzip = GZIP $@
e4a42c82	282	cmd_gzip = cat $(real-prereqs) \| $(KGZIP) -n -f -9 > $@
1da177e4	283
aab94339 DB	284	# DTC
aab94339 DB	285	# ---------------------------------------------------------------------------
6b22b3d1	286	DTC ?= $(objtree)/scripts/dtc/dtc
3eb619b2	287	DTC_FLAGS += -Wno-interrupt_provider
aab94339	288
bc553986	289	# Disable noisy checks by default
e27128db	290	ifeq ($(findstring 1,$(KBUILD_EXTRA_WARN)),)
8654cb8d	291	DTC_FLAGS += -Wno-unit_address_vs_reg \
8654cb8d	292	-Wno-unit_address_format \
4fd98e37 RH	293	-Wno-avoid_unnecessary_addr_size \
4fd98e37 RH	294	-Wno-alias_paths \
74656b68	295	-Wno-graph_child_address \
70523a3c	296	-Wno-simple_bus_reg \
74656b68	297	-Wno-unique_unit_address \
8654cb8d	298	-Wno-pci_device_reg
bc553986 RH	299	endif
bc553986 RH	300
e27128db	301	ifneq ($(findstring 2,$(KBUILD_EXTRA_WARN)),)
8654cb8d	302	DTC_FLAGS += -Wnode_name_chars_strict \
3eb619b2 RH	303	-Wproperty_name_chars_strict \
3eb619b2 RH	304	-Winterrupt_provider
bc553986 RH	305	endif
bc553986 RH	306
331f7416 FR	307	DTC_FLAGS += $(DTC_FLAGS_$(basetarget))
331f7416 FR	308
aab94339	309	# Generate an assembly file to wrap the output of the device tree compiler
1c00a47e	310	quiet_cmd_dt_S_dtb= DTB $@
aab94339	311	cmd_dt_S_dtb= \
b79c6aa6	312	{ \
aab94339 DB	313	echo '\#include <asm-generic/vmlinux.lds.h>'; \
	314	echo '.section .dtb.init.rodata,"a"'; \
	315	echo '.balign STRUCT_ALIGNMENT'; \
55fe6da9 JH	316	echo '.global __dtb_$(subst -,_,$(*F))_begin'; \
55fe6da9 JH	317	echo '__dtb_$(subst -,_,$(*F))_begin:'; \
aab94339	318	echo '.incbin "$<" '; \
55fe6da9 JH	319	echo '__dtb_$(subst -,_,$(*F))_end:'; \
55fe6da9 JH	320	echo '.global __dtb_$(subst -,_,$(*F))_end'; \
aab94339	321	echo '.balign STRUCT_ALIGNMENT'; \
b79c6aa6	322	} > $@
aab94339	323
a7f92419 MY	324	$(obj)/%.dtb.S: $(obj)/%.dtb FORCE
a7f92419 MY	325	$(call if_changed,dt_S_dtb)
aab94339 DB	326
aab94339 DB	327	quiet_cmd_dtc = DTC $@
dd7699e3	328	cmd_dtc = $(HOSTCC) -E $(dtc_cpp_flags) -x assembler-with-cpp -o $(dtc-tmp) $< ; \
78046fab	329	$(DTC) -O $(patsubst .%,%,$(suffix $@)) -o $@ -b 0 \
50f9ddaf	330	$(addprefix -i,$(dir $<) $(DTC_INCLUDE)) $(DTC_FLAGS) \
b0a4d8b3 IC	331	-d $(depfile).dtc.tmp $(dtc-tmp) ; \
b0a4d8b3 IC	332	cat $(depfile).pre.tmp $(depfile).dtc.tmp > $(depfile)
1da177e4	333
b8fc5b21	334	$(obj)/%.dtb: $(src)/%.dts $(DTC) FORCE
78046fab	335	$(call if_changed_dep,dtc)
4f0e3a57	336
ce88c9c7 VK	337	$(obj)/%.dtbo: $(src)/%.dts $(DTC) FORCE
	338	$(call if_changed_dep,dtc)
	339
4f0e3a57	340	DT_CHECKER ?= dt-validate
c59773d2	341	DT_CHECKER_FLAGS ?= $(if $(DT_SCHEMA_FILES),,-m)
4f0e3a57	342	DT_BINDING_DIR := Documentation/devicetree/bindings
2ba06cd8	343	# DT_TMP_SCHEMA may be overridden from Documentation/devicetree/bindings/Makefile
b8a49399	344	DT_TMP_SCHEMA ?= $(objtree)/$(DT_BINDING_DIR)/processed-schema.json
4f0e3a57 RH	345
4f0e3a57 RH	346	quiet_cmd_dtb_check = CHECK $@
c59773d2	347	cmd_dtb_check = $(DT_CHECKER) $(DT_CHECKER_FLAGS) -u $(srctree)/$(DT_BINDING_DIR) -p $(DT_TMP_SCHEMA) $@
4f0e3a57	348
7a049605	349	define rule_dtc
78046fab	350	$(call cmd_and_fixdep,dtc)
f5688663	351	$(call cmd,dtb_check)
4f0e3a57 RH	352	endef
	353
	354	$(obj)/%.dt.yaml: $(src)/%.dts $(DTC) $(DT_TMP_SCHEMA) FORCE
3d4b2238	355	$(call if_changed_rule,dtc,yaml)
90b335fb	356
b0a4d8b3	357	dtc-tmp = $(subst $(comma),_,$(dot-target).dts.tmp)
22435f38	358
bc22c17e AK	359	# Bzip2
	360	# ---------------------------------------------------------------------------
	361
d3dd3b5a PA	362	# Bzip2 and LZMA do not include size in file... so we have to fake that;
d3dd3b5a PA	363	# append the size as a 32-bit littleendian number as gzip does.
4a2ff67c	364	size_append = printf $(shell \
d3dd3b5a	365	dec_size=0; \
afa974b7	366	for F in $(real-prereqs); do \
a670b0b4	367	fsize=$$($(CONFIG_SHELL) $(srctree)/scripts/file-size.sh $$F); \
d3dd3b5a PA	368	dec_size=$$(expr $$dec_size + $$fsize); \
d3dd3b5a PA	369	done; \
1373411a JN	370	printf "%08x\n" $$dec_size \| \
	371	sed 's/\(..\)/\1 /g' \| { \
	372	read ch0 ch1 ch2 ch3; \
	373	for ch in $$ch3 $$ch2 $$ch1 $$ch0; do \
	374	printf '%s%03o' '\\' $$((0x$$ch)); \
	375	done; \
	376	} \
d3dd3b5a PA	377	)
	378
	379	quiet_cmd_bzip2 = BZIP2 $@
e4a42c82	380	cmd_bzip2 = { cat $(real-prereqs) \| $(KBZIP2) -9; $(size_append); } > $@
bc22c17e AK	381
	382	# Lzma
	383	# ---------------------------------------------------------------------------
	384
	385	quiet_cmd_lzma = LZMA $@
8dfb61dc	386	cmd_lzma = { cat $(real-prereqs) \| $(LZMA) -9; $(size_append); } > $@
7dd65feb	387
2d74b2c6	388	quiet_cmd_lzo = LZO $@
e4a42c82	389	cmd_lzo = { cat $(real-prereqs) \| $(KLZOP) -9; $(size_append); } > $@
d61931d8	390
e76e1fdf	391	quiet_cmd_lz4 = LZ4 $@
8dfb61dc	392	cmd_lz4 = { cat $(real-prereqs) \| $(LZ4) -l -c1 stdin stdout; \
b79c6aa6	393	$(size_append); } > $@
e76e1fdf	394
e3393645 SW	395	# U-Boot mkimage
	396	# ---------------------------------------------------------------------------
	397
	398	MKIMAGE := $(srctree)/scripts/mkuboot.sh
	399
	400	# SRCARCH just happens to match slightly more than ARCH (on sparc), so reduces
	401	# the number of overrides in arch makefiles
	402	UIMAGE_ARCH ?= $(SRCARCH)
	403	UIMAGE_COMPRESSION ?= $(if $(2),$(2),none)
	404	UIMAGE_OPTS-y ?=
	405	UIMAGE_TYPE ?= kernel
	406	UIMAGE_LOADADDR ?= arch_must_set_this
	407	UIMAGE_ENTRYADDR ?= $(UIMAGE_LOADADDR)
	408	UIMAGE_NAME ?= 'Linux-$(KERNELRELEASE)'
e3393645	409
786ac51a	410	quiet_cmd_uimage = UIMAGE $@
858805b3	411	cmd_uimage = $(BASH) $(MKIMAGE) -A $(UIMAGE_ARCH) -O linux \
e3393645 SW	412	-C $(UIMAGE_COMPRESSION) $(UIMAGE_OPTS-y) \
	413	-T $(UIMAGE_TYPE) \
	414	-a $(UIMAGE_LOADADDR) -e $(UIMAGE_ENTRYADDR) \
786ac51a	415	-n $(UIMAGE_NAME) -d $< $@
e3393645	416
24fa0402 LC	417	# XZ
	418	# ---------------------------------------------------------------------------
	419	# Use xzkern to compress the kernel image and xzmisc to compress other things.
	420	#
	421	# xzkern uses a big LZMA2 dictionary since it doesn't increase memory usage
	422	# of the kernel decompressor. A BCJ filter is used if it is available for
	423	# the target architecture. xzkern also appends uncompressed size of the data
	424	# using size_append. The .xz format has the size information available at
	425	# the end of the file too, but it's in more complex format and it's good to
	426	# avoid changing the part of the boot code that reads the uncompressed size.
	427	# Note that the bytes added by size_append will make the xz tool think that
	428	# the file is corrupt. This is expected.
	429	#
	430	# xzmisc doesn't use size_append, so it can be used to create normal .xz
	431	# files. xzmisc uses smaller LZMA2 dictionary than xzkern, because a very
	432	# big dictionary would increase the memory usage too much in the multi-call
	433	# decompression mode. A BCJ filter isn't used either.
	434	quiet_cmd_xzkern = XZKERN $@
b956c7a6	435	cmd_xzkern = { cat $(real-prereqs) \| sh $(srctree)/scripts/xz_wrap.sh; \
b79c6aa6	436	$(size_append); } > $@
24fa0402 LC	437
24fa0402 LC	438	quiet_cmd_xzmisc = XZMISC $@
8dfb61dc	439	cmd_xzmisc = cat $(real-prereqs) \| $(XZ) --check=crc32 --lzma2=dict=1MiB > $@
ebf003f0	440
48f7ddf7 NT	441	# ZSTD
	442	# ---------------------------------------------------------------------------
	443	# Appends the uncompressed size of the data using size_append. The .zst
	444	# format has the size information available at the beginning of the file too,
	445	# but it's in a more complex format and it's good to avoid changing the part
	446	# of the boot code that reads the uncompressed size.
	447	#
	448	# Note that the bytes added by size_append will make the zstd tool think that
	449	# the file is corrupt. This is expected.
	450	#
	451	# zstd uses a maximum window size of 8 MB. zstd22 uses a maximum window size of
	452	# 128 MB. zstd22 is used for kernel compression because it is decompressed in a
	453	# single pass, so zstd doesn't need to allocate a window buffer. When streaming
	454	# decompression is used, like initramfs decompression, zstd22 should likely not
	455	# be used because it would require zstd to allocate a 128 MB buffer.
	456
	457	quiet_cmd_zstd = ZSTD $@
	458	cmd_zstd = { cat $(real-prereqs) \| $(ZSTD) -19; $(size_append); } > $@
	459
	460	quiet_cmd_zstd22 = ZSTD22 $@
	461	cmd_zstd22 = { cat $(real-prereqs) \| $(ZSTD) -22 --ultra; $(size_append); } > $@
	462
ebf003f0 MK	463	# ASM offsets
	464	# ---------------------------------------------------------------------------
	465
	466	# Default sed regexp - multiline due to syntax constraints
cf0c3e68 JH	467	#
	468	# Use [:space:] because LLVM's integrated assembler inserts <tab> around
	469	# the .ascii directive whereas GCC keeps the <space> as-is.
ebf003f0	470	define sed-offsets
cf0c3e68 JH	471	's:^[[:space:]]\.ascii[[:space:]]"\(.\)".:\1:; \
cf0c3e68 JH	472	/^->/{s:->#\(.\):/ \1 */:; \
ebf003f0	473	s:^->\([^ ]\) [\$$#]\([^ ]\) \(.\):#define \1 \2 /* \3 */:; \
cf0c3e68	474	s:->::; p;}'
ebf003f0 MK	475	endef
	476
	477	# Use filechk to avoid rebuilds when a header changes, but the resulting file
	478	# does not
	479	define filechk_offsets
ebf003f0 MK	480	echo "#ifndef $2"; \
	481	echo "#define $2"; \
	482	echo "/*"; \
	483	echo " * DO NOT MODIFY."; \
	484	echo " *"; \
	485	echo " * This file was generated by Kbuild"; \
	486	echo " */"; \
	487	echo ""; \
43fee2b2	488	sed -ne $(sed-offsets) < $<; \
ebf003f0	489	echo ""; \
ad774086	490	echo "#endif"
ebf003f0	491	endef