mirror of
https://github.com/torvalds/linux.git
synced 2024-12-06 11:01:43 +00:00
39ceda5ce1
- remove headers_{install,check}_all targets - remove unreasonable 'depends on !UML' from CONFIG_SAMPLES - re-implement 'make headers_install' more cleanly - add new header-test-y syntax to compile-test headers - compile-test exported headers to ensure they are compilable in user-space - compile-test headers under include/ to ensure they are self-contained - remove -Waggregate-return, -Wno-uninitialized, -Wno-unused-value flags - add -Werror=unknown-warning-option for Clang - add 128-bit built-in types support to genksyms - fix missed rebuild of modules.builtin - propagate 'No space left on device' error in fixdep to Make - allow Clang to use its integrated assembler - improve some coccinelle scripts - add a new flag KBUILD_ABS_SRCTREE to request Kbuild to use absolute path for $(srctree). - do not ignore errors when compression utility is missing - misc cleanups -----BEGIN PGP SIGNATURE----- iQJSBAABCgA8FiEEbmPs18K1szRHjPqEPYsBB53g2wYFAl0oxNkeHHlhbWFkYS5t YXNhaGlyb0Bzb2Npb25leHQuY29tAAoJED2LAQed4NsGnhcP/AuM8s+3SYFiLitJ ISbznLFP2Xatq0SPXp5+moez/AMTK6Mm1biPcdo20d+TjVEh4+9F2nq12Ii9U8/D tds9A6G8+Bb28r9GMIVQPdFohijW6ijtDziS31iQnIWyPsP/yx6PKfLAD9F4ca1x 7/4btmu+BOMjtN0NrMWSNz5MM47xUzoWIALL40SV4PzGVXLCQZ2PBNPeSRIk22Jt ynDNPuNsmDWcFfwAE+sLSDrhCHZlwM8rg8rf6jmYdc4LcN4cj0oho5+K1TRyC9mn fO3PT25juFejthxQulxEfyGggnyLM6BNTgPDGcCHSP4nD7mlXA9GcpZICtJOgGGu SlDadMZ0GRMK5zcZ0MF0GQboeyViwsbXgrRcYuXt6cUFWX4P/1SeAQ5Mf4u1EKqf hEbwFXV/g81ht0lFS8gyWkvdpoNPtxGHNPusLjp65C4rc0/48/s+7EE/u8JTPl1g dQTeIOds6XUOkJgqhEfuq+8gfngbjKc9bYhs+ACbkCzBltQdnb6m5aLgk0ODxe8I WbGn0+cQcS9VVwre7E5DnFSVWVOHAG5taiUwj0KDcHB0Jxw9Gvorq9WU1ppHHYH2 XQIFBx7XHdn28d+plS8R23vAPgDgrGdvE5RYK5tNQLhTJ6BbjlZ1n/Tmxzu62scK deG3aCOB13Om7OTzTUh9+C3TC9ZQ =E2Rz -----END PGP SIGNATURE----- Merge tag 'kbuild-v5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/masahiroy/linux-kbuild Pull Kbuild updates from Masahiro Yamada: - remove headers_{install,check}_all targets - remove unreasonable 'depends on !UML' from CONFIG_SAMPLES - re-implement 'make headers_install' more cleanly - add new header-test-y syntax to compile-test headers - compile-test exported headers to ensure they are compilable in user-space - compile-test headers under include/ to ensure they are self-contained - remove -Waggregate-return, -Wno-uninitialized, -Wno-unused-value flags - add -Werror=unknown-warning-option for Clang - add 128-bit built-in types support to genksyms - fix missed rebuild of modules.builtin - propagate 'No space left on device' error in fixdep to Make - allow Clang to use its integrated assembler - improve some coccinelle scripts - add a new flag KBUILD_ABS_SRCTREE to request Kbuild to use absolute path for $(srctree). - do not ignore errors when compression utility is missing - misc cleanups * tag 'kbuild-v5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/masahiroy/linux-kbuild: (49 commits) kbuild: use -- separater intead of $(filter-out ...) for cc-cross-prefix kbuild: Inform user to pass ARCH= for make mrproper kbuild: fix compression errors getting ignored kbuild: add a flag to force absolute path for srctree kbuild: replace KBUILD_SRCTREE with boolean building_out_of_srctree kbuild: remove src and obj from the top Makefile scripts/tags.sh: remove unused environment variables from comments scripts/tags.sh: drop SUBARCH support for ARM kbuild: compile-test kernel headers to ensure they are self-contained kheaders: include only headers into kheaders_data.tar.xz kheaders: remove meaningless -R option of 'ls' kbuild: support header-test-pattern-y kbuild: do not create wrappers for header-test-y kbuild: compile-test exported headers to ensure they are self-contained init/Kconfig: add CONFIG_CC_CAN_LINK kallsyms: exclude kasan local symbols on s390 kbuild: add more hints about SUBDIRS replacement coccinelle: api/stream_open: treat all wait_.*() calls as blocking coccinelle: put_device: Add a cast to an expression for an assignment coccinelle: put_device: Adjust a message construction ...
45 lines
2.0 KiB
ReStructuredText
45 lines
2.0 KiB
ReStructuredText
=============================================
|
|
Exporting kernel headers for use by userspace
|
|
=============================================
|
|
|
|
The "make headers_install" command exports the kernel's header files in a
|
|
form suitable for use by userspace programs.
|
|
|
|
The linux kernel's exported header files describe the API for user space
|
|
programs attempting to use kernel services. These kernel header files are
|
|
used by the system's C library (such as glibc or uClibc) to define available
|
|
system calls, as well as constants and structures to be used with these
|
|
system calls. The C library's header files include the kernel header files
|
|
from the "linux" subdirectory. The system's libc headers are usually
|
|
installed at the default location /usr/include and the kernel headers in
|
|
subdirectories under that (most notably /usr/include/linux and
|
|
/usr/include/asm).
|
|
|
|
Kernel headers are backwards compatible, but not forwards compatible. This
|
|
means that a program built against a C library using older kernel headers
|
|
should run on a newer kernel (although it may not have access to new
|
|
features), but a program built against newer kernel headers may not work on an
|
|
older kernel.
|
|
|
|
The "make headers_install" command can be run in the top level directory of the
|
|
kernel source code (or using a standard out-of-tree build). It takes two
|
|
optional arguments::
|
|
|
|
make headers_install ARCH=i386 INSTALL_HDR_PATH=/usr
|
|
|
|
ARCH indicates which architecture to produce headers for, and defaults to the
|
|
current architecture. The linux/asm directory of the exported kernel headers
|
|
is platform-specific, to see a complete list of supported architectures use
|
|
the command::
|
|
|
|
ls -d include/asm-* | sed 's/.*-//'
|
|
|
|
INSTALL_HDR_PATH indicates where to install the headers. It defaults to
|
|
"./usr".
|
|
|
|
An 'include' directory is automatically created inside INSTALL_HDR_PATH and
|
|
headers are installed in 'INSTALL_HDR_PATH/include'.
|
|
|
|
The kernel header export infrastructure is maintained by David Woodhouse
|
|
<dwmw2@infradead.org>.
|