Skip to contentSkip to conversation

make headers_install

DOCS Rob Landley 2 participants 3 messages Jun 22, 2007

lore
Share & tools
lore
#0 lore raw

Here's a really quick stab at documentation for make headers_install.

Comments?

--------------------

Exporting kernel headers for use by userspace (/usr/include/linux)

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 at /usr/include/linux.

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/include

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/include".

The command "make headers_install_all" exports headers for all architectures simultaneously. (This is mostly of interest to distribution maintainers, who create an architecture-independent tarball from the resulting include directory.) Remember to provide the appropriate linux/asm directory via "mv" or "ln -s" before building a C library with headers exported this way.

The kernel header export infrastructure is maintained by David Woodhouse <[email protected]>.

Signature · 2 lines
"One of my most productive days was throwing away 1000 lines of code."
  - Ken Thompson.
#1 lore raw
Quoted 7 lines · Rob Landley

Here's a really quick stab at documentation for make headers_install.

Comments?

--------------------

Exporting kernel headers for use by userspace (/usr/include/linux)

Also /usr/include/asm (and asm-* on biarch 64-bit architectures), along with a few other directories. See $linux/include/Kbuild.

Other than that it looks relatively sane; thanks.

Signature · 1 line
dwmw2
#2 lore raw
Quoted 5 lines · On Friday 22 June 2007 01:14:50 David Woodhouse wrote:
Quoted 4 lines · Rob Landley

Here's a really quick stab at documentation for make headers_install.

Comments?

Quoted 8 lines
Quoted 3 lines

--------------------

Exporting kernel headers for use by userspace (/usr/include/linux)

Also /usr/include/asm (and asm-* on biarch 64-bit architectures), along with a few other directories. See $linux/include/Kbuild.

Other than that it looks relatively sane; thanks.

For some reason I was thinking that the asm directory was under include/linux even though I know that's not the case. Brain glitch.

This clear things up?

headers.txt 2007-06-22 16:16:22.000000000 -0400 renamed from headers.bak 2007-06-22 16:13:42.000000000 -0400 +3 -2
@@ -9,8 +9,9 @@
 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 at
-/usr/include/linux.
+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

New version attached.

Rob

Signature · 2 lines
"One of my most productive days was throwing away 1000 lines of code."
  - Ken Thompson.

Exporting kernel headers for use by userspace (/usr/include/linux)

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/include

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/include".

The command "make headers_install_all" exports headers for all architectures simultaneously. (This is mostly of interest to distribution maintainers, who create an architecture-independent tarball from the resulting include directory.) Remember to provide the appropriate linux/asm directory via "mv" or "ln -s" before building a C library with headers exported this way.

The kernel header export infrastructure is maintained by David Woodhouse <[email protected]>.