Documentation/make/headers_install.txt

Chinese translated version of Documentation/filesystems/ecryptfs.txt

If you have any comment or update to the content, please contact the

original document maintainer directly.  However, if you have a problem

communicating in English you can also ask the Chinese maintainer for

help.  Contact the Chinese maintainer if this translation is outdated

or if there is a problem with the translation.

Chinese maintainer: 谢尚敬 <1479201451@qq.com>

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

Documentation/make/headers_install.txt的中文翻译

如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文

交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻

译存在问题，请联系中文版维护者。

中文版维护者： 谢尚敬 <1479201451@qq.com>

中文版翻译者： 谢尚敬 <1479201451@qq.com>

中文版校译者： 谢尚敬 <1479201451@qq.com>

以下为正文

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

 

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.

   " make headers_install "命令可以将适合使用窗体的内核头文件导到用户空间的程序中。

 

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

      Linux 内核导出的头文件描述了，用于用户空间的程序，在试图使用内核服务的 API。通过系统的 C 库 （如 glibc 或 uClibc），这些内核头文件既可以用于定义可用的系统调用以及常数和结构，也可用于这些系统的调用。C 库的头文件包含了在"linux"的子目录里德内核头文件。该系统的 libc 标头，通常安装在默认位置为/usr/include，而内核头文件是在子目录当中 （特别注意/usr/include/linux和 /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.

      内核头文件不是向前兼容，而是向后兼容的。这就意味着，反对使用旧内核头文件的 C 库，其构建的程序应该运行在一个较新的内核中，（即便它不可以使用新功能），但生成针对较新内核头文件的程序，将可能无法在旧的内核上工作了。

 

  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"命令可以在，有内核源代码 （或者可以用标准输出树生成） 的顶级目录中运行。它有两个可选参数：

 

    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:

      ARCH指示了哪部分结构产生了标头，并将其默认为当前的体系结构。导出的内核头文件 linux/asm 的目录是平台特定的，接着来看看支持完整列表的结构，所使用的命令：

 

    ls -d include/asm-* | sed 's/.*-//'

 

  INSTALL_HDR_PATH indicates where to install the headers.  It defaults to "./usr/include".

      INSTALL_HDR_PATH 指示了标头的安装位置。其默认值为"./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.)  You also can use HDR_ARCH_LIST to specify list of architectures. Remember to provide the appropriate linux/asm directory via "mv" or "ln -s"      before building a C library with headers exported this way.

      命令"make headers_install_all"，同时输出了，所有体系结构的标头。(这是各个创建了，一个独立的体系结构的、包括目录的压缩包的维护者的一个兴趣.)您还可以使用 HDR_ARCH_LIST 来指定列表中的体系结构。记住，在生成带有头的 C 库用这种方式输出前，需要提供 linux/asm 目录中相应的"mv"或者"ln-s"。

 

The kernel header export infrastructure is maintained by David Woodhouse<dwmw2@infradead.org>.

  内核头输出的基础设施，是由大卫 · 伍德豪斯 < dwmw2@infradead.org > 来维护的。

 

 

 

原文地址：http://lxr.linux.no/linux+v3.11.6/Documentation/make/headers_install.txt