glibc-inst.xml 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
  2. <sect2>
  3. <title>Glibc installation</title>
  4. <para>Before starting to install Glibc, you must <userinput>cd</userinput>
  5. into the <filename>glibc-&glibc-version;</filename> directory and unpack
  6. Glibc-linuxthreads in that directory, not in <filename>/usr/src</filename> as
  7. you would normally do.</para>
  8. <para>This package is known to behave badly when you have changed its
  9. default optimization flags (including the -march and -mcpu options).
  10. Therefore, if you have defined any environment variables that override
  11. default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting
  12. them when building Glibc.</para>
  13. <para>Basically, compiling Glibc in any other way than the book suggests
  14. is putting the stability of your system at risk.</para>
  15. <para>Though it is a harmless message, the install stage of Glibc will
  16. complain about the absence of <filename>/tools/etc/ld.so.conf</filename>.
  17. Fix this annoying little error with:</para>
  18. <para><screen><userinput>mkdir /tools/etc
  19. touch /tools/etc/ld.so.conf</userinput></screen></para>
  20. <para>Also, Glibc has a subtle problem when compiled with GCC 3.3.1.
  21. Apply the following patch to fix this:</para>
  22. <para><screen><userinput>patch -Np1 -i ../glibc-2.3.2-sscanf-1.patch
  23. </userinput></screen></para>
  24. <para>The documentation that comes with Glibc recommends to build the package
  25. not in the source directory but in a separate, dedicated directory:</para>
  26. <para><screen><userinput>mkdir ../glibc-build
  27. cd ../glibc-build</userinput></screen></para>
  28. <para>Next, prepare Glibc to be compiled:</para>
  29. <para><screen><userinput>../glibc-&glibc-version;/configure --prefix=/tools \
  30. &nbsp;&nbsp;&nbsp;&nbsp;--disable-profile --enable-add-ons \
  31. &nbsp;&nbsp;&nbsp;&nbsp;--with-headers=/tools/include \
  32. &nbsp;&nbsp;&nbsp;&nbsp;--with-binutils=/tools/bin \
  33. &nbsp;&nbsp;&nbsp;&nbsp;--without-gd</userinput></screen></para>
  34. <para>The meaning of the new configure options:</para>
  35. <itemizedlist>
  36. <listitem><para><userinput>--disable-profile</userinput>: This disables the
  37. building of the libraries with profiling information. Omit this option if you
  38. plan to do profiling.</para></listitem>
  39. <listitem><para><userinput>--enable-add-ons</userinput>: This enables any
  40. add-ons that were installed with Glibc, in our case Linuxthreads.</para></listitem>
  41. <listitem><para><userinput>--with-binutils=/tools/bin</userinput> and
  42. <userinput>--with-headers=/tools/include</userinput>: Strictly speaking
  43. these switches are not required. But they ensure nothing can go wrong with
  44. regard to what kernel headers and Binutils programs get used during the
  45. Glibc build.</para></listitem>
  46. <listitem><para><userinput> --without-gd</userinput>: This switch ensures
  47. that we don't build the <userinput>memusagestat</userinput> program, which
  48. strangely enough insists on linking against the host's libraries (libgd,
  49. libpng, libz, and so forth).</para></listitem>
  50. </itemizedlist>
  51. <para>During this stage you will see the following warning:</para>
  52. <blockquote><screen>configure: warning:
  53. *** These auxiliary programs are missing or too old: msgfmt
  54. *** some features will be disabled.
  55. *** Check the INSTALL file for required versions.</screen></blockquote>
  56. <para>The missing <filename>msgfmt</filename> program (from the Gettext
  57. package, which we'll install later) won't cause any problems. The
  58. <filename>msgfmt</filename> is used to generate the binary translation
  59. files that can make your system talk in a different language. Because these
  60. translation files have already been generated for you, there is no need for
  61. <filename>msgfmt</filename>. You'd only need the program if you change the
  62. translation source files (the <filename>*.po</filename> files in the
  63. <filename class="directory">po</filename> subdirectory), which
  64. would require you to regenerate the binary files.</para>
  65. <para>Continue with compiling the package:</para>
  66. <para><screen><userinput>make
  67. make check
  68. make install</userinput></screen></para>
  69. <para>The glibc make check process is highly dependent on certain functions
  70. of your host operating system. The most common is a host that fails to mount
  71. a tmpfs filesystem at /dev/shm, which may cause glibc tests to fail.</para>
  72. <para>The locales (used by Glibc to make your Linux system respond in a
  73. different language) weren't installed when you ran the previous command,
  74. so we have to do that ourselves now:</para>
  75. <para><screen><userinput>make localedata/install-locales</userinput></screen></para>
  76. <para>An alternative to running the previous command is to install only
  77. those locales which you need or want. This can be achieved by using the
  78. <userinput>localedef</userinput> command. Information on this can be
  79. found in the <filename>INSTALL</filename> file in the
  80. <filename>glibc-&glibc-version;</filename> tree. However, there are a
  81. number of locales that are essential for the tests of future packages
  82. to pass correctly, in particular, the libstdc++ tests from GCC. The following
  83. instructions, in place of the install-locales command above, will install
  84. the minimum set of locales necessary for the tests to run successfully:</para>
  85. <para><screen><userinput>mkdir -p /tools/lib/locale
  86. localedef -i de_DE -f ISO-8859-1 de_DE
  87. localedef -i de_DE@euro -f ISO-8859-15 de_DE@euro
  88. localedef -i en_HK -f ISO-8859-1 en_HK
  89. localedef -i en_PH -f ISO-8859-1 en_PH
  90. localedef -i en_US -f ISO-8859-1 en_US
  91. localedef -i es_MX -f ISO-8859-1 es_MX
  92. localedef -i fr_FR -f ISO-8859-1 fr_FR
  93. localedef -i fr_FR@euro -f ISO-8859-15 fr_FR@euro
  94. localedef -i it_IT -f ISO-8859-1 it_IT
  95. localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen></para>
  96. </sect2>