aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorMasahiro Yamada <masahiroy@kernel.org>2025-06-03 03:12:53 +0900
committerMasahiro Yamada <masahiroy@kernel.org>2025-06-07 14:37:50 +0900
commit1bf807b8f7e0eada62007f9f1966f3d22329eef9 (patch)
treee61387c6b92f9bd9631b881d26a2684da1b05f6c /Documentation
parentefi/libstub: use 'targets' instead of extra-y in Makefile (diff)
downloadlinux-rng-1bf807b8f7e0eada62007f9f1966f3d22329eef9.tar.xz
linux-rng-1bf807b8f7e0eada62007f9f1966f3d22329eef9.zip
kbuild: set y instead of 1 to KBUILD_{BUILTIN,MODULES}
KBUILD_BUILTIN is set to 1 unless you are building only modules. KBUILD_MODULES is set to 1 when you are building only modules (a typical use case is "make modules"). It is more useful to set them to 'y' instead, so we can do something like: always-$(KBUILD_BUILTIN) += vmlinux.lds This works equivalently to: extra-y += vmlinux.lds This allows us to deprecate extra-y. extra-y and always-y are quite similar, and we do not need both. Signed-off-by: Masahiro Yamada <masahiroy@kernel.org> Reviewed-by: Nathan Chancellor <nathan@kernel.org> Reviewed-by: Nicolas Schier <n.schier@avm.de>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/kbuild/makefiles.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/Documentation/kbuild/makefiles.rst b/Documentation/kbuild/makefiles.rst
index 3b9a8bc671e2..18ef339f687b 100644
--- a/Documentation/kbuild/makefiles.rst
+++ b/Documentation/kbuild/makefiles.rst
@@ -291,6 +291,10 @@ Example::
# arch/x86/kernel/Makefile
extra-y += vmlinux.lds
+extra-y is now deprecated because this is equivalent to:
+
+ always-$(KBUILD_BUILTIN) += vmlinux.lds
+
$(extra-y) should only contain targets needed for vmlinux.
Kbuild skips extra-y when vmlinux is apparently not a final goal.