glibc.xml 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. <sect1 id="ch06-glibc">
  2. <title>Installing Glibc-&glibc-version;</title>
  3. <?dbhtml filename="glibc.html" dir="chapter06"?>
  4. <screen>Estimated build time: &glibc-time;
  5. Estimated required disk space: &glibc-compsize;</screen>
  6. &aa-glibc-shortdesc;
  7. &aa-glibc-dep;
  8. <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
  9. <sect2>
  10. <title>Glibc installation</title>
  11. <para>The Glibc build system is very well self-contained and will install
  12. perfectly, even though our compiler specs file and linker are still pointing
  13. at <filename>/tools</filename>. We cannot adjust the specs and linker before
  14. the Glibc install, because the Glibc autoconf tests would then give bogus
  15. results and thus defeat our goal of achieving a clean build.</para>
  16. <note><para>The test suite for Glibc in this section is considered
  17. <emphasis>critical</emphasis>. Our advice is to not skip it under any
  18. circumstance.</para></note>
  19. <para>Before starting to build Glibc, remember to unpack the Glibc-linuxthreads
  20. again inside the <filename>glibc-&glibc-version;</filename> directory, and to
  21. unset any environment variables that override the default optimization
  22. flags.</para>
  23. <para>Though it is a harmless message, the install stage of Glibc will
  24. complain about the absence of <filename>/etc/ld.so.conf</filename>. Fix this
  25. annoying little warning with:</para>
  26. <screen><userinput>touch /etc/ld.so.conf</userinput></screen>
  27. <para>Then apply the same patch we used previously:</para>
  28. <screen><userinput>patch -Np1 -i ../&glibc-sscanf-patch;</userinput></screen>
  29. <para>The Glibc documentation recommends building Glibc outside of the source
  30. directory in a dedicated build directory:</para>
  31. <screen><userinput>mkdir ../glibc-build
  32. cd ../glibc-build</userinput></screen>
  33. <para>Now prepare Glibc for compilation:</para>
  34. <screen><userinput>../glibc-&glibc-version;/configure --prefix=/usr \
  35. &nbsp;&nbsp;&nbsp;&nbsp;--disable-profile --enable-add-ons \
  36. &nbsp;&nbsp;&nbsp;&nbsp;--libexecdir=/usr/bin --with-headers=/usr/include</userinput></screen>
  37. <para>The meaning of the new configure options:</para>
  38. <itemizedlist>
  39. <listitem><para><userinput>--libexecdir=/usr/bin</userinput>: This will
  40. cause the <filename>pt_chown</filename> program to be installed in the
  41. <filename>/usr/bin</filename> directory.</para></listitem>
  42. <listitem><para><userinput>--with-headers=/usr/include</userinput>: This
  43. ensures that the kernel headers in <filename>/usr/include</filename> are used
  44. for this build. If you don't pass this switch then the headers from
  45. <filename>/tools/include</filename> are used which of course is not ideal
  46. (although they should be identical). Using this switch has the advantage
  47. that you will be informed immediately should you have forgotten to install the
  48. kernel headers into <filename>/usr/include</filename>.</para></listitem>
  49. </itemizedlist>
  50. <para>Compile the package:</para>
  51. <screen><userinput>make</userinput></screen>
  52. <para>Test the results:</para>
  53. <screen><userinput>make check</userinput></screen>
  54. <para>The test suite notes from <xref linkend="ch05-glibc"/> are still very much
  55. appropriate here. Be sure to refer back there should you have any doubts.</para>
  56. <para>And install the package:</para>
  57. <screen><userinput>make install</userinput></screen>
  58. <para>The locales that can make your system respond in a different language
  59. weren't installed by the above command. Do it with this:</para>
  60. <screen><userinput>make localedata/install-locales</userinput></screen>
  61. <para>An alternative to running the previous command is to install only those
  62. locales which you need or want. This can be achieved using the
  63. <userinput>localedef</userinput> command. Information on this can be found in
  64. the <filename>INSTALL</filename> file in the
  65. <filename>glibc-&glibc-version;</filename> tree. However, there are a number
  66. of locales that are essential for the tests of future packages to pass
  67. correctly. The following instructions, in place of the install-locales
  68. command above, will install the minimum set of locales necessary for the
  69. tests to run successfully:</para>
  70. <screen><userinput>mkdir -p /usr/lib/locale
  71. localedef -i de_DE -f ISO-8859-1 de_DE
  72. localedef -i de_DE@euro -f ISO-8859-15 de_DE@euro
  73. localedef -i en_HK -f ISO-8859-1 en_HK
  74. localedef -i en_PH -f ISO-8859-1 en_PH
  75. localedef -i en_US -f ISO-8859-1 en_US
  76. localedef -i es_MX -f ISO-8859-1 es_MX
  77. localedef -i fr_FR -f ISO-8859-1 fr_FR
  78. localedef -i fr_FR@euro -f ISO-8859-15 fr_FR@euro
  79. localedef -i it_IT -f ISO-8859-1 it_IT
  80. localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen>
  81. <para>Finally, build the linuxthreads man pages:</para>
  82. <screen><userinput>make -C ../&glibc-dir;/linuxthreads/man</userinput></screen>
  83. <para>And install these pages:</para>
  84. <screen><userinput>make -C ../&glibc-dir;/linuxthreads/man install</userinput></screen>
  85. </sect2>
  86. &c6-cf-glibc;
  87. </sect1>