mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git
synced 2024-12-29 09:12:07 +00:00
798bb342e0
Toolchain and infrastructure:
- Enable a series of lints, including safety-related ones, e.g. the
compiler will now warn about missing safety comments, as well as
unnecessary ones. How safety documentation is organized is a frequent
source of review comments, thus having the compiler guide new
developers on where they are expected (and where not) is very nice.
- Start using '#[expect]': an interesting feature in Rust (stabilized
in 1.81.0) that makes the compiler warn if an expected warning was
_not_ emitted. This is useful to avoid forgetting cleaning up locally
ignored diagnostics ('#[allow]'s).
- Introduce '.clippy.toml' configuration file for Clippy, the Rust
linter, which will allow us to tweak its behaviour. For instance, our
first use cases are declaring a disallowed macro and, more
importantly, enabling the checking of private items.
- Lints-related fixes and cleanups related to the items above.
- Migrate from 'receiver_trait' to 'arbitrary_self_types': to get the
kernel into stable Rust, one of the major pieces of the puzzle is the
support to write custom types that can be used as 'self', i.e. as
receivers, since the kernel needs to write types such as 'Arc' that
common userspace Rust would not. 'arbitrary_self_types' has been
accepted to become stable, and this is one of the steps required to
get there.
- Remove usage of the 'new_uninit' unstable feature.
- Use custom C FFI types. Includes a new 'ffi' crate to contain our
custom mapping, instead of using the standard library 'core::ffi'
one. The actual remapping will be introduced in a later cycle.
- Map '__kernel_{size_t,ssize_t,ptrdiff_t}' to 'usize'/'isize' instead
of 32/64-bit integers.
- Fix 'size_t' in bindgen generated prototypes of C builtins.
- Warn on bindgen < 0.69.5 and libclang >= 19.1 due to a double issue
in the projects, which we managed to trigger with the upcoming
tracepoint support. It includes a build test since some distributions
backported the fix (e.g. Debian -- thanks!). All major distributions
we list should be now OK except Ubuntu non-LTS.
'macros' crate:
- Adapt the build system to be able run the doctests there too; and
clean up and enable the corresponding doctests.
'kernel' crate:
- Add 'alloc' module with generic kernel allocator support and remove
the dependency on the Rust standard library 'alloc' and the extension
traits we used to provide fallible methods with flags.
Add the 'Allocator' trait and its implementations '{K,V,KV}malloc'.
Add the 'Box' type (a heap allocation for a single value of type 'T'
that is also generic over an allocator and considers the kernel's GFP
flags) and its shorthand aliases '{K,V,KV}Box'. Add 'ArrayLayout'
type. Add 'Vec' (a contiguous growable array type) and its shorthand
aliases '{K,V,KV}Vec', including iterator support.
For instance, now we may write code such as:
let mut v = KVec::new();
v.push(1, GFP_KERNEL)?;
assert_eq!(&v, &[1]);
Treewide, move as well old users to these new types.
- 'sync' module: add global lock support, including the
'GlobalLockBackend' trait; the 'Global{Lock,Guard,LockedBy}' types
and the 'global_lock!' macro. Add the 'Lock::try_lock' method.
- 'error' module: optimize 'Error' type to use 'NonZeroI32' and make
conversion functions public.
- 'page' module: add 'page_align' function.
- Add 'transmute' module with the existing 'FromBytes' and 'AsBytes'
traits.
- 'block::mq::request' module: improve rendered documentation.
- 'types' module: extend 'Opaque' type documentation and add simple
examples for the 'Either' types.
drm/panic:
- Clean up a series of Clippy warnings.
Documentation:
- Add coding guidelines for lints and the '#[expect]' feature.
- Add Ubuntu to the list of distributions in the Quick Start guide.
MAINTAINERS:
- Add Danilo Krummrich as maintainer of the new 'alloc' module.
And a few other small cleanups and fixes.
-----BEGIN PGP SIGNATURE-----
iQIzBAABCgAdFiEEPjU5OPd5QIZ9jqqOGXyLc2htIW0FAmdFMIgACgkQGXyLc2ht
IW16hQ/+KX/jmdGoXtNXx7T6yG6SJ/txPOieGAWfhBf6C3bqkGrU9Gnw/O3VWrxf
eyj1QLQaIVUkmumWCefeiy9u3xRXx5fpS0tWJOjUtxC5NcS7vCs0AHQs1skIa6H+
YD6UKDPOy7CB5fVYqo13B5xnFAlciU0dLo6IGB6bB/lSpCudGLE9+nukfn5H3/R1
DTc3/fbSoYQU6Ij/FKscB+D/A7ojdYaReodhbzNw1lChg1MrJlCpqoQvHPE8ijg+
UDljHFFvgKdhSQL9GTa3LC7X4DsnihMWzXt14m6mMOqBa6TqF47WUhhgC77pHEI2
v/Yy8MLq0pdIzT1wFjsqs6opuvXc7K5Yk5Y60HDsDyIyjk2xgOjh6ZlD0EV161gS
7w1NtaKd/Cn7hnL7Ua51yJDxJTMllne3fTWemhs3Zd63j7ham98yOoiw+6L2QaM4
C9nW48vfUuTwDuYJ5HU0uSugubuHW3Ng5JEvMcvd4QjmaI1bQNkgVzefR5j3dLw8
9kEOTzJoxHpu5B7PZVTEd/L95hlmk1csSQObxi7JYCCimMkusF1S+heBzV/SqWD5
5ioEhCnSKE05fhQs0Uxns1HkcFle8Bn6r3aSAWV6yaR8oF94yHcuaZRUKxKMHw+1
cmBE2X8Yvtldw+CYDwEGWjKDtwOStbqk+b/ZzP7f7/p56QH9lSg=
=Kn7b
-----END PGP SIGNATURE-----
Merge tag 'rust-6.13' of https://github.com/Rust-for-Linux/linux
Pull rust updates from Miguel Ojeda:
"Toolchain and infrastructure:
- Enable a series of lints, including safety-related ones, e.g. the
compiler will now warn about missing safety comments, as well as
unnecessary ones. How safety documentation is organized is a
frequent source of review comments, thus having the compiler guide
new developers on where they are expected (and where not) is very
nice.
- Start using '#[expect]': an interesting feature in Rust (stabilized
in 1.81.0) that makes the compiler warn if an expected warning was
_not_ emitted. This is useful to avoid forgetting cleaning up
locally ignored diagnostics ('#[allow]'s).
- Introduce '.clippy.toml' configuration file for Clippy, the Rust
linter, which will allow us to tweak its behaviour. For instance,
our first use cases are declaring a disallowed macro and, more
importantly, enabling the checking of private items.
- Lints-related fixes and cleanups related to the items above.
- Migrate from 'receiver_trait' to 'arbitrary_self_types': to get the
kernel into stable Rust, one of the major pieces of the puzzle is
the support to write custom types that can be used as 'self', i.e.
as receivers, since the kernel needs to write types such as 'Arc'
that common userspace Rust would not. 'arbitrary_self_types' has
been accepted to become stable, and this is one of the steps
required to get there.
- Remove usage of the 'new_uninit' unstable feature.
- Use custom C FFI types. Includes a new 'ffi' crate to contain our
custom mapping, instead of using the standard library 'core::ffi'
one. The actual remapping will be introduced in a later cycle.
- Map '__kernel_{size_t,ssize_t,ptrdiff_t}' to 'usize'/'isize'
instead of 32/64-bit integers.
- Fix 'size_t' in bindgen generated prototypes of C builtins.
- Warn on bindgen < 0.69.5 and libclang >= 19.1 due to a double issue
in the projects, which we managed to trigger with the upcoming
tracepoint support. It includes a build test since some
distributions backported the fix (e.g. Debian -- thanks!). All
major distributions we list should be now OK except Ubuntu non-LTS.
'macros' crate:
- Adapt the build system to be able run the doctests there too; and
clean up and enable the corresponding doctests.
'kernel' crate:
- Add 'alloc' module with generic kernel allocator support and remove
the dependency on the Rust standard library 'alloc' and the
extension traits we used to provide fallible methods with flags.
Add the 'Allocator' trait and its implementations '{K,V,KV}malloc'.
Add the 'Box' type (a heap allocation for a single value of type
'T' that is also generic over an allocator and considers the
kernel's GFP flags) and its shorthand aliases '{K,V,KV}Box'. Add
'ArrayLayout' type. Add 'Vec' (a contiguous growable array type)
and its shorthand aliases '{K,V,KV}Vec', including iterator
support.
For instance, now we may write code such as:
let mut v = KVec::new();
v.push(1, GFP_KERNEL)?;
assert_eq!(&v, &[1]);
Treewide, move as well old users to these new types.
- 'sync' module: add global lock support, including the
'GlobalLockBackend' trait; the 'Global{Lock,Guard,LockedBy}' types
and the 'global_lock!' macro. Add the 'Lock::try_lock' method.
- 'error' module: optimize 'Error' type to use 'NonZeroI32' and make
conversion functions public.
- 'page' module: add 'page_align' function.
- Add 'transmute' module with the existing 'FromBytes' and 'AsBytes'
traits.
- 'block::mq::request' module: improve rendered documentation.
- 'types' module: extend 'Opaque' type documentation and add simple
examples for the 'Either' types.
drm/panic:
- Clean up a series of Clippy warnings.
Documentation:
- Add coding guidelines for lints and the '#[expect]' feature.
- Add Ubuntu to the list of distributions in the Quick Start guide.
MAINTAINERS:
- Add Danilo Krummrich as maintainer of the new 'alloc' module.
And a few other small cleanups and fixes"
* tag 'rust-6.13' of https://github.com/Rust-for-Linux/linux: (82 commits)
rust: alloc: Fix `ArrayLayout` allocations
docs: rust: remove spurious item in `expect` list
rust: allow `clippy::needless_lifetimes`
rust: warn on bindgen < 0.69.5 and libclang >= 19.1
rust: use custom FFI integer types
rust: map `__kernel_size_t` and friends also to usize/isize
rust: fix size_t in bindgen prototypes of C builtins
rust: sync: add global lock support
rust: macros: enable the rest of the tests
rust: macros: enable paste! use from macro_rules!
rust: enable macros::module! tests
rust: kbuild: expand rusttest target for macros
rust: types: extend `Opaque` documentation
rust: block: fix formatting of `kernel::block::mq::request` module
rust: macros: fix documentation of the paste! macro
rust: kernel: fix THIS_MODULE header path in ThisModule doc comment
rust: page: add Rust version of PAGE_ALIGN
rust: helpers: remove unnecessary header includes
rust: exports: improve grammar in commentary
drm/panic: allow verbose version check
...
519 lines
17 KiB
Makefile
519 lines
17 KiB
Makefile
# SPDX-License-Identifier: GPL-2.0
|
|
# ==========================================================================
|
|
# Building
|
|
# ==========================================================================
|
|
|
|
src := $(if $(VPATH),$(VPATH)/)$(obj)
|
|
|
|
PHONY := $(obj)/
|
|
$(obj)/:
|
|
|
|
# Init all relevant variables used in kbuild files so
|
|
# 1) they have correct type
|
|
# 2) they do not inherit any value from the environment
|
|
obj-y :=
|
|
obj-m :=
|
|
lib-y :=
|
|
lib-m :=
|
|
always-y :=
|
|
always-m :=
|
|
targets :=
|
|
subdir-y :=
|
|
subdir-m :=
|
|
EXTRA_AFLAGS :=
|
|
EXTRA_CFLAGS :=
|
|
EXTRA_CPPFLAGS :=
|
|
EXTRA_LDFLAGS :=
|
|
asflags-y :=
|
|
ccflags-y :=
|
|
rustflags-y :=
|
|
cppflags-y :=
|
|
ldflags-y :=
|
|
|
|
subdir-asflags-y :=
|
|
subdir-ccflags-y :=
|
|
|
|
# Read auto.conf if it exists, otherwise ignore
|
|
-include include/config/auto.conf
|
|
|
|
include $(srctree)/scripts/Kbuild.include
|
|
include $(srctree)/scripts/Makefile.compiler
|
|
include $(kbuild-file)
|
|
include $(srctree)/scripts/Makefile.lib
|
|
|
|
ifndef obj
|
|
$(warning kbuild: Makefile.build is included improperly)
|
|
endif
|
|
|
|
ifeq ($(need-modorder),)
|
|
ifneq ($(obj-m),)
|
|
$(warning $(patsubst %.o,'%.ko',$(obj-m)) will not be built even though obj-m is specified.)
|
|
$(warning You cannot use subdir-y/m to visit a module Makefile. Use obj-y/m instead.)
|
|
endif
|
|
endif
|
|
|
|
# ===========================================================================
|
|
|
|
# subdir-builtin and subdir-modorder may contain duplications. Use $(sort ...)
|
|
subdir-builtin := $(sort $(filter %/built-in.a, $(real-obj-y)))
|
|
subdir-modorder := $(sort $(filter %/modules.order, $(obj-m)))
|
|
|
|
targets-for-builtin := $(extra-y)
|
|
|
|
ifneq ($(strip $(lib-y) $(lib-m) $(lib-)),)
|
|
targets-for-builtin += $(obj)/lib.a
|
|
endif
|
|
|
|
ifdef need-builtin
|
|
targets-for-builtin += $(obj)/built-in.a
|
|
endif
|
|
|
|
targets-for-modules := $(foreach x, o mod, \
|
|
$(patsubst %.o, %.$x, $(filter %.o, $(obj-m))))
|
|
|
|
ifdef need-modorder
|
|
targets-for-modules += $(obj)/modules.order
|
|
endif
|
|
|
|
targets += $(targets-for-builtin) $(targets-for-modules)
|
|
|
|
# Linus' kernel sanity checking tool
|
|
ifeq ($(KBUILD_CHECKSRC),1)
|
|
quiet_cmd_checksrc = CHECK $<
|
|
cmd_checksrc = $(CHECK) $(CHECKFLAGS) $(c_flags) $<
|
|
else ifeq ($(KBUILD_CHECKSRC),2)
|
|
quiet_cmd_force_checksrc = CHECK $<
|
|
cmd_force_checksrc = $(CHECK) $(CHECKFLAGS) $(c_flags) $<
|
|
endif
|
|
|
|
ifneq ($(KBUILD_EXTRA_WARN),)
|
|
cmd_checkdoc = $(srctree)/scripts/kernel-doc -none $(KDOCFLAGS) \
|
|
$(if $(findstring 2, $(KBUILD_EXTRA_WARN)), -Wall) \
|
|
$<
|
|
endif
|
|
|
|
# Compile C sources (.c)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
quiet_cmd_cc_s_c = CC $(quiet_modtag) $@
|
|
cmd_cc_s_c = $(CC) $(filter-out $(DEBUG_CFLAGS) $(CC_FLAGS_LTO), $(c_flags)) -fverbose-asm -S -o $@ $<
|
|
|
|
$(obj)/%.s: $(obj)/%.c FORCE
|
|
$(call if_changed_dep,cc_s_c)
|
|
|
|
quiet_cmd_cpp_i_c = CPP $(quiet_modtag) $@
|
|
cmd_cpp_i_c = $(CPP) $(c_flags) -o $@ $<
|
|
|
|
$(obj)/%.i: $(obj)/%.c FORCE
|
|
$(call if_changed_dep,cpp_i_c)
|
|
|
|
genksyms = scripts/genksyms/genksyms \
|
|
$(if $(1), -T $(2)) \
|
|
$(if $(KBUILD_PRESERVE), -p) \
|
|
-r $(or $(wildcard $(2:.symtypes=.symref)), /dev/null)
|
|
|
|
# These mirror gensymtypes_S and co below, keep them in synch.
|
|
cmd_gensymtypes_c = $(CPP) -D__GENKSYMS__ $(c_flags) $< | $(genksyms)
|
|
|
|
quiet_cmd_cc_symtypes_c = SYM $(quiet_modtag) $@
|
|
cmd_cc_symtypes_c = $(call cmd_gensymtypes_c,true,$@) >/dev/null
|
|
|
|
$(obj)/%.symtypes : $(obj)/%.c FORCE
|
|
$(call cmd,cc_symtypes_c)
|
|
|
|
# LLVM assembly
|
|
# Generate .ll files from .c
|
|
quiet_cmd_cc_ll_c = CC $(quiet_modtag) $@
|
|
cmd_cc_ll_c = $(CC) $(c_flags) -emit-llvm -S -fno-discard-value-names -o $@ $<
|
|
|
|
$(obj)/%.ll: $(obj)/%.c FORCE
|
|
$(call if_changed_dep,cc_ll_c)
|
|
|
|
# C (.c) files
|
|
# The C file is compiled and updated dependency information is generated.
|
|
# (See cmd_cc_o_c + relevant part of rule_cc_o_c)
|
|
|
|
is-single-obj-m = $(and $(part-of-module),$(filter $@, $(obj-m)),y)
|
|
|
|
# When a module consists of a single object, there is no reason to keep LLVM IR.
|
|
# Make $(LD) covert LLVM IR to ELF here.
|
|
ifdef CONFIG_LTO_CLANG
|
|
cmd_ld_single_m = $(if $(is-single-obj-m), ; $(LD) $(ld_flags) -r -o $(tmp-target) $@; mv $(tmp-target) $@)
|
|
endif
|
|
|
|
quiet_cmd_cc_o_c = CC $(quiet_modtag) $@
|
|
cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $< \
|
|
$(cmd_ld_single_m) \
|
|
$(cmd_objtool)
|
|
|
|
ifdef CONFIG_MODVERSIONS
|
|
# When module versioning is enabled the following steps are executed:
|
|
# o compile a <file>.o from <file>.c
|
|
# o if <file>.o doesn't contain a __export_symbol_*, i.e. does
|
|
# not export symbols, it's done.
|
|
# o otherwise, we calculate symbol versions using the good old
|
|
# genksyms on the preprocessed source and dump them into the .cmd file.
|
|
# o modpost will extract versions from that file and create *.c files that will
|
|
# be compiled and linked to the kernel and/or modules.
|
|
|
|
gen_symversions = \
|
|
if $(NM) $@ 2>/dev/null | grep -q ' __export_symbol_'; then \
|
|
$(call cmd_gensymtypes_$(1),$(KBUILD_SYMTYPES),$(@:.o=.symtypes)) \
|
|
>> $(dot-target).cmd; \
|
|
fi
|
|
|
|
cmd_gen_symversions_c = $(call gen_symversions,c)
|
|
|
|
endif
|
|
|
|
ifdef CONFIG_FTRACE_MCOUNT_USE_RECORDMCOUNT
|
|
# compiler will not generate __mcount_loc use recordmcount or recordmcount.pl
|
|
ifdef BUILD_C_RECORDMCOUNT
|
|
ifeq ("$(origin RECORDMCOUNT_WARN)", "command line")
|
|
RECORDMCOUNT_FLAGS = -w
|
|
endif
|
|
# Due to recursion, we must skip empty.o.
|
|
# The empty.o file is created in the make process in order to determine
|
|
# the target endianness and word size. It is made before all other C
|
|
# files, including recordmcount.
|
|
sub_cmd_record_mcount = \
|
|
if [ $(@) != "scripts/mod/empty.o" ]; then \
|
|
$(objtree)/scripts/recordmcount $(RECORDMCOUNT_FLAGS) "$(@)"; \
|
|
fi;
|
|
recordmcount_source := $(srctree)/scripts/recordmcount.c \
|
|
$(srctree)/scripts/recordmcount.h
|
|
else
|
|
sub_cmd_record_mcount = perl $(srctree)/scripts/recordmcount.pl "$(ARCH)" \
|
|
"$(if $(CONFIG_CPU_BIG_ENDIAN),big,little)" \
|
|
"$(if $(CONFIG_64BIT),64,32)" \
|
|
"$(OBJDUMP)" "$(OBJCOPY)" "$(CC) $(KBUILD_CPPFLAGS) $(KBUILD_CFLAGS)" \
|
|
"$(LD) $(KBUILD_LDFLAGS)" "$(NM)" "$(RM)" "$(MV)" \
|
|
"$(if $(part-of-module),1,0)" "$(@)";
|
|
recordmcount_source := $(srctree)/scripts/recordmcount.pl
|
|
endif # BUILD_C_RECORDMCOUNT
|
|
cmd_record_mcount = $(if $(findstring $(strip $(CC_FLAGS_FTRACE)),$(_c_flags)), \
|
|
$(sub_cmd_record_mcount))
|
|
endif # CONFIG_FTRACE_MCOUNT_USE_RECORDMCOUNT
|
|
|
|
# 'OBJECT_FILES_NON_STANDARD := y': skip objtool checking for a directory
|
|
# 'OBJECT_FILES_NON_STANDARD_foo.o := 'y': skip objtool checking for a file
|
|
# 'OBJECT_FILES_NON_STANDARD_foo.o := 'n': override directory skip for a file
|
|
|
|
is-standard-object = $(if $(filter-out y%, $(OBJECT_FILES_NON_STANDARD_$(target-stem).o)$(OBJECT_FILES_NON_STANDARD)n),$(is-kernel-object))
|
|
|
|
$(obj)/%.o: private objtool-enabled = $(if $(is-standard-object),$(if $(delay-objtool),$(is-single-obj-m),y))
|
|
|
|
ifneq ($(findstring 1, $(KBUILD_EXTRA_WARN)),)
|
|
cmd_warn_shared_object = $(if $(word 2, $(modname-multi)),$(warning $(kbuild-file): $*.o is added to multiple modules: $(modname-multi)))
|
|
endif
|
|
|
|
define rule_cc_o_c
|
|
$(call cmd_and_fixdep,cc_o_c)
|
|
$(call cmd,checksrc)
|
|
$(call cmd,checkdoc)
|
|
$(call cmd,gen_objtooldep)
|
|
$(call cmd,gen_symversions_c)
|
|
$(call cmd,record_mcount)
|
|
$(call cmd,warn_shared_object)
|
|
endef
|
|
|
|
define rule_as_o_S
|
|
$(call cmd_and_fixdep,as_o_S)
|
|
$(call cmd,gen_objtooldep)
|
|
$(call cmd,gen_symversions_S)
|
|
$(call cmd,warn_shared_object)
|
|
endef
|
|
|
|
# Built-in and composite module parts
|
|
$(obj)/%.o: $(obj)/%.c $(recordmcount_source) FORCE
|
|
$(call if_changed_rule,cc_o_c)
|
|
$(call cmd,force_checksrc)
|
|
|
|
# To make this rule robust against "Argument list too long" error,
|
|
# ensure to add $(obj)/ prefix by a shell command.
|
|
cmd_mod = printf '%s\n' $(call real-search, $*.o, .o, -objs -y -m) | \
|
|
$(AWK) '!x[$$0]++ { print("$(obj)/"$$0) }' > $@
|
|
|
|
$(obj)/%.mod: FORCE
|
|
$(call if_changed,mod)
|
|
|
|
quiet_cmd_cc_lst_c = MKLST $@
|
|
cmd_cc_lst_c = $(CC) $(c_flags) -g -c -o $*.o $< && \
|
|
$(CONFIG_SHELL) $(srctree)/scripts/makelst $*.o \
|
|
System.map $(OBJDUMP) > $@
|
|
|
|
$(obj)/%.lst: $(obj)/%.c FORCE
|
|
$(call if_changed_dep,cc_lst_c)
|
|
|
|
# Compile Rust sources (.rs)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
rust_allowed_features := asm_const,asm_goto,arbitrary_self_types,lint_reasons
|
|
|
|
# `--out-dir` is required to avoid temporaries being created by `rustc` in the
|
|
# current working directory, which may be not accessible in the out-of-tree
|
|
# modules case.
|
|
rust_common_cmd = \
|
|
OBJTREE=$(abspath $(objtree)) \
|
|
RUST_MODFILE=$(modfile) $(RUSTC_OR_CLIPPY) $(rust_flags) \
|
|
-Zallow-features=$(rust_allowed_features) \
|
|
-Zcrate-attr=no_std \
|
|
-Zcrate-attr='feature($(rust_allowed_features))' \
|
|
-Zunstable-options --extern kernel \
|
|
--crate-type rlib -L $(objtree)/rust/ \
|
|
--crate-name $(basename $(notdir $@)) \
|
|
--sysroot=/dev/null \
|
|
--out-dir $(dir $@) --emit=dep-info=$(depfile)
|
|
|
|
# `--emit=obj`, `--emit=asm` and `--emit=llvm-ir` imply a single codegen unit
|
|
# will be used. We explicitly request `-Ccodegen-units=1` in any case, and
|
|
# the compiler shows a warning if it is not 1. However, if we ever stop
|
|
# requesting it explicitly and we start using some other `--emit` that does not
|
|
# imply it (and for which codegen is performed), then we would be out of sync,
|
|
# i.e. the outputs we would get for the different single targets (e.g. `.ll`)
|
|
# would not match each other.
|
|
|
|
quiet_cmd_rustc_o_rs = $(RUSTC_OR_CLIPPY_QUIET) $(quiet_modtag) $@
|
|
cmd_rustc_o_rs = $(rust_common_cmd) --emit=obj=$@ $< $(cmd_objtool)
|
|
|
|
define rule_rustc_o_rs
|
|
$(call cmd_and_fixdep,rustc_o_rs)
|
|
$(call cmd,gen_objtooldep)
|
|
endef
|
|
|
|
$(obj)/%.o: $(obj)/%.rs FORCE
|
|
+$(call if_changed_rule,rustc_o_rs)
|
|
|
|
quiet_cmd_rustc_rsi_rs = $(RUSTC_OR_CLIPPY_QUIET) $(quiet_modtag) $@
|
|
cmd_rustc_rsi_rs = \
|
|
$(rust_common_cmd) -Zunpretty=expanded $< >$@; \
|
|
command -v $(RUSTFMT) >/dev/null && $(RUSTFMT) $@
|
|
|
|
$(obj)/%.rsi: $(obj)/%.rs FORCE
|
|
+$(call if_changed_dep,rustc_rsi_rs)
|
|
|
|
quiet_cmd_rustc_s_rs = $(RUSTC_OR_CLIPPY_QUIET) $(quiet_modtag) $@
|
|
cmd_rustc_s_rs = $(rust_common_cmd) --emit=asm=$@ $<
|
|
|
|
$(obj)/%.s: $(obj)/%.rs FORCE
|
|
+$(call if_changed_dep,rustc_s_rs)
|
|
|
|
quiet_cmd_rustc_ll_rs = $(RUSTC_OR_CLIPPY_QUIET) $(quiet_modtag) $@
|
|
cmd_rustc_ll_rs = $(rust_common_cmd) --emit=llvm-ir=$@ $<
|
|
|
|
$(obj)/%.ll: $(obj)/%.rs FORCE
|
|
+$(call if_changed_dep,rustc_ll_rs)
|
|
|
|
quiet_cmd_rustc_rs_rs_S = RSCPP $(quiet_modtag) $@
|
|
cmd_rustc_rs_rs_S = $(CPP) $(c_flags) -xc -C -P $< | sed '1,/^\/\/ Cut here.$$/d' >$@
|
|
|
|
$(obj)/%.rs: $(obj)/%.rs.S FORCE
|
|
+$(call if_changed_dep,rustc_rs_rs_S)
|
|
|
|
# Compile assembler sources (.S)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
# .S file exports must have their C prototypes defined in asm/asm-prototypes.h
|
|
# or a file that it includes, in order to get versioned symbols. We build a
|
|
# dummy C file that includes asm-prototypes and the EXPORT_SYMBOL lines from
|
|
# the .S file (with trailing ';'), and run genksyms on that, to extract vers.
|
|
#
|
|
# This is convoluted. The .S file must first be preprocessed to run guards and
|
|
# expand names, then the resulting exports must be constructed into plain
|
|
# EXPORT_SYMBOL(symbol); to build our dummy C file, and that gets preprocessed
|
|
# to make the genksyms input.
|
|
#
|
|
# These mirror gensymtypes_c and co above, keep them in synch.
|
|
cmd_gensymtypes_S = \
|
|
{ echo "\#include <linux/kernel.h>" ; \
|
|
echo "\#include <asm/asm-prototypes.h>" ; \
|
|
$(NM) $@ | sed -n 's/.* __export_symbol_\(.*\)/EXPORT_SYMBOL(\1);/p' ; } | \
|
|
$(CPP) -D__GENKSYMS__ $(c_flags) -xc - | $(genksyms)
|
|
|
|
quiet_cmd_cc_symtypes_S = SYM $(quiet_modtag) $@
|
|
cmd_cc_symtypes_S = $(call cmd_gensymtypes_S,true,$@) >/dev/null
|
|
|
|
$(obj)/%.symtypes : $(obj)/%.S FORCE
|
|
$(call cmd,cc_symtypes_S)
|
|
|
|
|
|
quiet_cmd_cpp_s_S = CPP $(quiet_modtag) $@
|
|
cmd_cpp_s_S = $(CPP) $(a_flags) -o $@ $<
|
|
|
|
$(obj)/%.s: $(obj)/%.S FORCE
|
|
$(call if_changed_dep,cpp_s_S)
|
|
|
|
quiet_cmd_as_o_S = AS $(quiet_modtag) $@
|
|
cmd_as_o_S = $(CC) $(a_flags) -c -o $@ $< $(cmd_objtool)
|
|
|
|
ifdef CONFIG_ASM_MODVERSIONS
|
|
|
|
# versioning matches the C process described above, with difference that
|
|
# we parse asm-prototypes.h C header to get function definitions.
|
|
|
|
cmd_gen_symversions_S = $(call gen_symversions,S)
|
|
|
|
endif
|
|
|
|
$(obj)/%.o: $(obj)/%.S FORCE
|
|
$(call if_changed_rule,as_o_S)
|
|
|
|
targets += $(filter-out $(subdir-builtin), $(real-obj-y))
|
|
targets += $(filter-out $(subdir-modorder), $(real-obj-m))
|
|
targets += $(lib-y) $(always-y)
|
|
|
|
# Linker scripts preprocessor (.lds.S -> .lds)
|
|
# ---------------------------------------------------------------------------
|
|
quiet_cmd_cpp_lds_S = LDS $@
|
|
cmd_cpp_lds_S = $(CPP) $(cpp_flags) -P -U$(ARCH) \
|
|
-D__ASSEMBLY__ -DLINKER_SCRIPT -o $@ $<
|
|
|
|
$(obj)/%.lds: $(src)/%.lds.S FORCE
|
|
$(call if_changed_dep,cpp_lds_S)
|
|
|
|
# ASN.1 grammar
|
|
# ---------------------------------------------------------------------------
|
|
quiet_cmd_asn1_compiler = ASN.1 $(basename $@).[ch]
|
|
cmd_asn1_compiler = $(objtree)/scripts/asn1_compiler $< \
|
|
$(basename $@).c $(basename $@).h
|
|
|
|
$(obj)/%.asn1.c $(obj)/%.asn1.h: $(src)/%.asn1 $(objtree)/scripts/asn1_compiler
|
|
$(call cmd,asn1_compiler)
|
|
|
|
# Build the compiled-in targets
|
|
# ---------------------------------------------------------------------------
|
|
|
|
# To build objects in subdirs, we need to descend into the directories
|
|
$(subdir-builtin): $(obj)/%/built-in.a: $(obj)/% ;
|
|
$(subdir-modorder): $(obj)/%/modules.order: $(obj)/% ;
|
|
|
|
#
|
|
# Rule to compile a set of .o files into one .a file (without symbol table)
|
|
#
|
|
# To make this rule robust against "Argument list too long" error,
|
|
# remove $(obj)/ prefix, and restore it by a shell command.
|
|
|
|
quiet_cmd_ar_builtin = AR $@
|
|
cmd_ar_builtin = rm -f $@; \
|
|
$(if $(real-prereqs), printf "$(obj)/%s " $(patsubst $(obj)/%,%,$(real-prereqs)) | xargs) \
|
|
$(AR) cDPrST $@
|
|
|
|
$(obj)/built-in.a: $(real-obj-y) FORCE
|
|
$(call if_changed,ar_builtin)
|
|
|
|
# This is a list of build artifacts from the current Makefile and its
|
|
# sub-directories. The timestamp should be updated when any of the member files.
|
|
|
|
cmd_gen_order = { $(foreach m, $(real-prereqs), \
|
|
$(if $(filter %/$(notdir $@), $m), cat $m, echo $m);) :; } \
|
|
> $@
|
|
|
|
$(obj)/modules.order: $(obj-m) FORCE
|
|
$(call if_changed,gen_order)
|
|
|
|
#
|
|
# Rule to compile a set of .o files into one .a file (with symbol table)
|
|
#
|
|
|
|
$(obj)/lib.a: $(lib-y) FORCE
|
|
$(call if_changed,ar)
|
|
|
|
quiet_cmd_ld_multi_m = LD [M] $@
|
|
cmd_ld_multi_m = $(LD) $(ld_flags) -r -o $@ @$< $(cmd_objtool)
|
|
|
|
define rule_ld_multi_m
|
|
$(call cmd_and_savecmd,ld_multi_m)
|
|
$(call cmd,gen_objtooldep)
|
|
endef
|
|
|
|
$(multi-obj-m): private objtool-enabled := $(delay-objtool)
|
|
$(multi-obj-m): private part-of-module := y
|
|
$(multi-obj-m): %.o: %.mod FORCE
|
|
$(call if_changed_rule,ld_multi_m)
|
|
$(call multi_depend, $(multi-obj-m), .o, -objs -y -m)
|
|
|
|
# Add intermediate targets:
|
|
# When building objects with specific suffix patterns, add intermediate
|
|
# targets that the final targets are derived from.
|
|
intermediate_targets = $(foreach sfx, $(2), \
|
|
$(patsubst %$(strip $(1)),%$(sfx), \
|
|
$(filter %$(strip $(1)), $(targets))))
|
|
# %.asn1.o <- %.asn1.[ch] <- %.asn1
|
|
targets += $(call intermediate_targets, .asn1.o, .asn1.c .asn1.h)
|
|
|
|
# Include additional build rules when necessary
|
|
# ---------------------------------------------------------------------------
|
|
|
|
# $(sort ...) is used here to remove duplicated words and excessive spaces.
|
|
hostprogs := $(sort $(hostprogs))
|
|
ifneq ($(hostprogs),)
|
|
include $(srctree)/scripts/Makefile.host
|
|
endif
|
|
|
|
# $(sort ...) is used here to remove duplicated words and excessive spaces.
|
|
userprogs := $(sort $(userprogs))
|
|
ifneq ($(userprogs),)
|
|
include $(srctree)/scripts/Makefile.userprogs
|
|
endif
|
|
|
|
ifneq ($(need-dtbslist)$(dtb-y)$(dtb-)$(filter %.dtb %.dtb.o %.dtbo.o,$(targets)),)
|
|
include $(srctree)/scripts/Makefile.dtbs
|
|
endif
|
|
|
|
# Build
|
|
# ---------------------------------------------------------------------------
|
|
|
|
$(obj)/: $(if $(KBUILD_BUILTIN), $(targets-for-builtin)) \
|
|
$(if $(KBUILD_MODULES), $(targets-for-modules)) \
|
|
$(subdir-ym) $(always-y)
|
|
@:
|
|
|
|
# Single targets
|
|
# ---------------------------------------------------------------------------
|
|
|
|
single-subdirs := $(foreach d, $(subdir-ym), $(if $(filter $d/%, $(MAKECMDGOALS)), $d))
|
|
single-subdir-goals := $(filter $(addsuffix /%, $(single-subdirs)), $(MAKECMDGOALS))
|
|
|
|
$(single-subdir-goals): $(single-subdirs)
|
|
@:
|
|
|
|
# Descending
|
|
# ---------------------------------------------------------------------------
|
|
|
|
PHONY += $(subdir-ym)
|
|
$(subdir-ym):
|
|
$(Q)$(MAKE) $(build)=$@ \
|
|
need-builtin=$(if $(filter $@/built-in.a, $(subdir-builtin)),1) \
|
|
need-modorder=$(if $(filter $@/modules.order, $(subdir-modorder)),1) \
|
|
$(filter $@/%, $(single-subdir-goals))
|
|
|
|
# Add FORCE to the prerequisites of a target to force it to be always rebuilt.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
PHONY += FORCE
|
|
|
|
FORCE:
|
|
|
|
targets += $(filter-out $(single-subdir-goals), $(MAKECMDGOALS))
|
|
targets := $(filter-out $(PHONY), $(targets))
|
|
|
|
# Read all saved command lines and dependencies for the $(targets) we
|
|
# may be building above, using $(if_changed{,_dep}). As an
|
|
# optimization, we don't need to read them if the target does not
|
|
# exist, we will rebuild anyway in that case.
|
|
|
|
existing-targets := $(wildcard $(sort $(targets)))
|
|
|
|
-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd)
|
|
|
|
# Create directories for object files if they do not exist
|
|
obj-dirs := $(sort $(patsubst %/,%, $(dir $(targets))))
|
|
# If targets exist, their directories apparently exist. Skip mkdir.
|
|
existing-dirs := $(sort $(patsubst %/,%, $(dir $(existing-targets))))
|
|
obj-dirs := $(strip $(filter-out $(existing-dirs), $(obj-dirs)))
|
|
ifneq ($(obj-dirs),)
|
|
$(shell mkdir -p $(obj-dirs))
|
|
endif
|
|
|
|
.PHONY: $(PHONY)
|