linux

mirror of https://github.com/torvalds/linux.git synced 2024-11-10 22:21:40 +00:00

A mirror of the official Linux kernel repository just in case

Go to file

Masahiro Yamada 67d7c3023a kbuild: remove --include-dir MAKEFLAG from top Makefile I added $(srctree)/ to some included Makefiles in the following commits: - `3204a7fb98` ("kbuild: prefix $(srctree)/ to some included Makefiles") - `d828563955` ("kbuild: do not require sub-make for separate output tree builds") They were a preparation for removing --include-dir flag. I have never thought --include-dir useful. Rather, it _is_ harmful. For example, run the following commands: $ make -s ARCH=x86 mrproper defconfig $ make ARCH=arm O=foo dtbs make[1]: Entering directory '/tmp/linux/foo' HOSTCC scripts/basic/fixdep Error: kernelrelease not valid - run 'make prepare' to update it UPD include/config/kernel.release make[1]: Leaving directory '/tmp/linux/foo' The first command configures the source tree for x86. The next command tries to build ARM device trees in the separate foo/ directory - this must stop because the directory foo/ has not been configured yet. However, due to --include-dir=$(abs_srctree), the top Makefile includes the wrong include/config/auto.conf from the source tree and continues building. Kbuild traverses the directory tree, but of course it does not work correctly. The Error message is also pointless - 'make prepare' does not help at all for fixing the issue. This commit fixes more arch Makefile, and finally removes --include-dir from the top Makefile. There are more breakages under drivers/, but I do not volunteer to fix them all. I just moved --include-dir to drivers/Makefile. With this commit, the second command will stop with a sensible message. $ make -s ARCH=x86 mrproper defconfig $ make ARCH=arm O=foo dtbs make[1]: Entering directory '/tmp/linux/foo' SYNC include/config/auto.conf.cmd * * The source tree is not clean, please run 'make ARCH=arm mrproper' * in /tmp/linux * make[2]: * [../Makefile:646: outputmakefile] Error 1 /tmp/linux/Makefile:770: include/config/auto.conf.cmd: No such file or directory make[1]: * [/tmp/linux/Makefile:793: include/config/auto.conf.cmd] Error 2 make[1]: Leaving directory '/tmp/linux/foo' make: *** [Makefile:226: __sub-make] Error 2 Signed-off-by: Masahiro Yamada <masahiroy@kernel.org>		2023-02-05 18:51:22 +09:00
arch	kbuild: remove --include-dir MAKEFLAG from top Makefile	2023-02-05 18:51:22 +09:00
block	block-6.2-2023-01-20	2023-01-20 12:44:41 -08:00
certs	kbuild: do not print extra logs for V=2	2023-01-22 23:43:32 +09:00
crypto	This update includes the following changes:	2022-12-14 12:31:09 -08:00
Documentation	scripts: remove bin2c	2023-01-26 12:43:33 +09:00
drivers	kbuild: remove --include-dir MAKEFLAG from top Makefile	2023-02-05 18:51:22 +09:00
fs	kbuild: remove --include-dir MAKEFLAG from top Makefile	2023-02-05 18:51:22 +09:00
include	USB / Thunderbolt fixes for 6.2-rc5	2023-01-21 11:10:03 -08:00
init	scripts: remove bin2c	2023-01-26 12:43:33 +09:00
io_uring	io_uring/poll: don't reissue in case of poll race on multishot request	2023-01-20 15:11:54 -07:00
ipc	Non-MM patches for 6.2-rc1.	2022-12-12 17:28:58 -08:00
kernel	kheaders: use standard naming for the temporary directory	2023-01-22 23:43:34 +09:00
lib	v6.2 second rc pull request	2023-01-20 14:15:51 -08:00
LICENSES	LICENSES: Add the copyleft-next-0.3.1 license	2022-11-08 15:44:01 +01:00
mm	slab fixes for 6.2-rc5	2023-01-19 12:24:39 -08:00
net	tcp: fix rate_app_limited to default to 1	2023-01-20 13:23:35 +00:00
rust	kbuild: rust: move rust/target.json to scripts/	2023-01-22 23:43:33 +09:00
samples	Char/Misc driver changes for 6.2-rc1	2022-12-16 03:49:24 -08:00
scripts	kbuild: do not automatically add -w option to modpost	2023-02-05 18:51:22 +09:00
security	tomoyo: Update website link	2023-01-13 23:11:38 +09:00
sound	sound fixes for 6.2-rc4	2023-01-13 08:20:29 -06:00
tools	linux-kselftest-fixes-6.2-rc5	2023-01-20 11:35:21 -08:00
usr	usr/gen_init_cpio.c: remove unnecessary -1 values from int file	2022-10-03 14:21:44 -07:00
virt	KVM: Ensure lockdep knows about kvm->lock vs. vcpu->mutex ordering rule	2023-01-11 13:32:21 -05:00
.clang-format	iommufd for 6.2	2022-12-14 09:15:43 -08:00
.cocciconfig
.get_maintainer.ignore	get_maintainer: add Alan to .get_maintainer.ignore	2022-08-20 15:17:44 -07:00
.gitattributes	.gitattributes: use 'dts' diff driver for dts files	2019-12-04 19:44:11 -08:00
.gitignore	.gitignore: update the command to check tracked files being ignored	2023-01-22 23:43:32 +09:00
.mailmap	21 hotfixes. Thirteen of these address pre-6.1 issues and hence have	2023-01-16 16:36:39 -08:00
.rustfmt.toml	rust: add `.rustfmt.toml`	2022-09-28 09:02:20 +02:00
COPYING	COPYING: state that all contributions really are covered by this file	2020-02-10 13:32:20 -08:00
CREDITS	MAINTAINERS: zram: zsmalloc: Add an additional co-maintainer	2022-12-15 16:37:49 -08:00
Kbuild	Kbuild updates for v6.1	2022-10-10 12:00:45 -07:00
Kconfig	kbuild: ensure full rebuild when the compiler is updated	2020-05-12 13:28:33 +09:00
MAINTAINERS	MAINTAINERS: fix kbuild repo branch	2023-01-22 23:43:33 +09:00
Makefile	kbuild: remove --include-dir MAKEFLAG from top Makefile	2023-02-05 18:51:22 +09:00
README	Drop all 00-INDEX files from Documentation/	2018-09-09 15:08:58 -06:00

README

Linux kernel
============

There are several guides for kernel developers and users. These guides can
be rendered in a number of formats, like HTML and PDF. Please read
Documentation/admin-guide/README.rst first.

In order to build the documentation, use ``make htmldocs`` or
``make pdfdocs``.  The formatted documentation can also be read online at:

    https://www.kernel.org/doc/html/latest/

There are various text files in the Documentation/ subdirectory,
several of them using the Restructured Text markup notation.

Please read the Documentation/process/changes.rst file, as it contains the
requirements for building and running the kernel, and information about
the problems which may result by upgrading your kernel.