linux-libc-headers.xml 2.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-linux-libc-headers" role="wrap">
  7. <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
  8. <?dbhtml filename="linux-libc-headers.html"?>
  9. <indexterm zone="ch-system-linux-libc-headers">
  10. <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
  11. </indexterm>
  12. <sect2 role="package"><title/>
  13. <para>The Linux-Libc-Headers package contains the
  14. <quote>sanitized</quote> kernel headers.</para>
  15. <segmentedlist>
  16. <segtitle>&buildtime;</segtitle>
  17. <segtitle>&diskspace;</segtitle>
  18. <seglistitem><seg>0.1 SBU</seg><seg>26.9 MB</seg></seglistitem>
  19. </segmentedlist>
  20. <segmentedlist>
  21. <segtitle>&dependencies;</segtitle>
  22. <seglistitem><seg>Coreutils</seg></seglistitem>
  23. </segmentedlist>
  24. </sect2>
  25. <sect2 role="installation">
  26. <title>Installation of Linux-Libc-Headers</title>
  27. <para>For years it has been common practice to use <quote>raw</quote>
  28. kernel headers (straight from a kernel tarball) in <filename
  29. class="directory">/usr/include</filename>, but over the last few
  30. years, the kernel developers have taken a strong stance that this
  31. should not be done. This gave birth to the Linux-Libc-Headers Project,
  32. which was designed to maintain an API stable version of the Linux
  33. headers.</para>
  34. <para>Install the header files:</para>
  35. <screen><userinput>cp -Rv include/asm-i386 /usr/include/asm
  36. cp -Rv include/linux /usr/include</userinput></screen>
  37. <para>Ensure that all the headers are owned by root:</para>
  38. <screen><userinput>chown -Rv root:root /usr/include/{asm,linux}</userinput></screen>
  39. <para>Make sure the users can read the headers:</para>
  40. <screen><userinput>find /usr/include/{asm,linux} -type d -exec chmod -v 755 {} \;
  41. find /usr/include/{asm,linux} -type f -exec chmod -v 644 {} \;</userinput></screen>
  42. </sect2>
  43. <sect2 id="contents-linux-libc-headers" role="content"><title>Contents of Linux-Libc-Headers</title>
  44. <segmentedlist>
  45. <segtitle>Installed headers</segtitle>
  46. <seglistitem><seg>/usr/include/{asm,linux}/*.h</seg></seglistitem>
  47. </segmentedlist>
  48. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  49. <?dbfo list-presentation="list"?>
  50. <?dbhtml list-presentation="table"?>
  51. <varlistentry id="linux-libc-headers">
  52. <term><filename class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
  53. <listitem>
  54. <para>The Linux API headers</para>
  55. <indexterm zone="ch-system-linux-libc-headers linux-libc-headers"><primary sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary></indexterm>
  56. </listitem>
  57. </varlistentry>
  58. </variablelist>
  59. </sect2>
  60. </sect1>