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>.
