<sect1 id="ch05-glibc">
<!--
<title>Installing Glibc-&glibc-version;</title>
-->
<title>Glibc-&glibc-version; のインストール</title>
<?dbhtml filename="glibc.html" dir="chapter05"?>

<!--
<screen>Estimated build time:           &glibc-time-tools;
Estimated required disk space:  &glibc-compsize-tools;</screen>
-->
<screen>推定構築時間:           &glibc-time-tools;
推定必要ディスクスペース:  &glibc-compsize-tools;</screen>

&aa-glibc-shortdesc;
&aa-glibc-dep;

<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>

<sect2>
<!--
<title>Glibc installation</title>
-->
<title>Glibc のインストール</title>

<!--
<para>Before starting to install Glibc, you must <userinput>cd</userinput>
into the <filename>glibc-&glibc-version;</filename> directory and unpack
Glibc-linuxthreads in that directory, not in the directory where you usually
unpack all the sources.</para>
-->
<para>Glibcのインストールを始める前に、通常すべてのソースを解凍しているディレクトリではなく、<filename>glibc-&glibc-version;</filename> という名前のディレクトリにディレクトリを変更して（ <userinput>cd</userinput> して）そこで Glibc-linuxthread を解凍しなければいけません。</para>

<!--
<note><para>We are going to run the test suite for Glibc in this chapter.
However, it's worth pointing out that running the Glibc test suite here
is considered not as important as running it in
<xref linkend="chapter06"/>.</para></note>
-->
<note><para>この章では Glibc にテストスイートを実行するつもりです。
しかし、ここで Glibc テストスイートを実行することは、<xref linkend="chapter06"/>で実行することほど重要ではないと指摘だけしておきます。</para></note>

<!--
<para>This package is known to behave badly when you have changed its
default optimization flags (including the -march and -mcpu options).
Therefore, if you have defined any environment variables that override
default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting
them when building Glibc.</para>
-->
<para>このパッケージはデフォルト最適化フラグ（ -march と -mcpu オプションを含む）を変更するとおかしなふるまいをすると知られています。
ですから、たとえば CFLAGS や CXXFLAGS のような、デフォルトの最適化を書きかえるような何かの環境変数を定義したなら、Glibc を構築する時に、その設定を解除するか、修正するようお勧めします。</para>

<!--
<para>Basically, compiling Glibc in any other way than the book suggests
is putting the stability of your system at risk.</para>
-->
<para>基本的には、本書で示されるやり方以外の方法で Glibc をコンパイルすると、お使いのシステムの安定性を危険に晒すことになります。</para>

<!--
<para>Though it is a harmless message, the install stage of Glibc will
complain about the absence of <filename>/tools/etc/ld.so.conf</filename>.
Fix this annoying little warning with:</para>
-->
<para>害のないメッセージですが、Glibc のインストールの段階で <filename>/tools/etc/ld.so.conf</filename> がないのに不平を言うでしょう。
この煩わしいささいな警告を修正します。</para>

<screen><userinput>mkdir /tools/etc
touch /tools/etc/ld.so.conf</userinput></screen>

<!--
<para>Also, Glibc has a subtle problem when compiled with GCC &gcc-version;.
Apply the following patch to fix this:</para>
-->
<para>また、Glibc は GCC &gcc-version; でコンパイルするとやっかいな問題を持ちます。これを修正するために次のパッチをあてましょう。</para>

<screen><userinput>patch -Np1 -i ../&glibc-sscanf-patch;</userinput></screen>

<!--
<para>The Glibc documentation recommends building Glibc outside of the source
directory in a dedicated build directory:</para>
-->
<para>Glibc の文章は、コンパイルをソースディレクトリとは別の構築専用ディレクトリで行なうことを勧めています。</para>

<screen><userinput>mkdir ../glibc-build
cd ../glibc-build</userinput></screen>

<!--
<para>Next, prepare Glibc for compilation:</para>
-->
<para>次に、Glibc のインストールの準備をします。</para>

<screen><userinput>../glibc-&glibc-version;/configure --prefix=/tools \
&nbsp;&nbsp;&nbsp;&nbsp;--disable-profile --enable-add-ons \
&nbsp;&nbsp;&nbsp;&nbsp;--with-headers=/tools/include \
&nbsp;&nbsp;&nbsp;&nbsp;--with-binutils=/tools/bin \
&nbsp;&nbsp;&nbsp;&nbsp;--without-gd</userinput></screen>

<!--
<para>The meaning of the configure options:</para>
-->
<para>コンフィグオプションの意味</para>

<itemizedlist>
<!--
<listitem><para><userinput>&#045;&#045;disable-profile</userinput>: This disables the
building of the libraries with profiling information. Omit this option if you
plan to do profiling.</para></listitem>
-->
<listitem><para><userinput>--disable-profile</userinput>: これはプロファイル情報付きでライブラリを構築するのを無効にします。もしプロファイルをする予定なのであればこのオプションを除きましょう。</para></listitem>

<!--
<listitem><para><userinput>&#045;&#045;enable-add-ons</userinput>: This enables any
add-ons that were installed with Glibc, in our case Linuxthreads.</para></listitem>
-->
<listitem><para><userinput>--enable-add-ons</userinput>:これは Glibc とともにインストールされたすべての追加物をも有効にします。この場合は、Linuxthreads になります。</para></listitem>

<!--
<listitem><para><userinput>&#045;&#045;with-binutils=/tools/bin</userinput> and
<userinput>&#045;&#045;with-headers=/tools/include</userinput>: Strictly speaking
these switches are not required. But they ensure nothing can go wrong with
regard to what kernel headers and Binutils programs get used during the
Glibc build.</para></listitem>
-->
<listitem><para><userinput>--with-binutils=/tools/bin</userinput> と <userinput>--with-headers=/tools/include</userinput>: 率直に言ってこれらのスイッチは必要ではありません。
しかしこれらは、Glibc の構築の間にカーネルヘッダと Binutils プログラムが使われるということについて間違いがないようにします。</para></listitem>

<!--
<listitem><para><userinput> &#045;&#045without-gd</userinput>: This switch ensures
that we don't build the <userinput>memusagestat</userinput> program, which
strangely enough insists on linking against the host's libraries (libgd,
libpng, libz, and so forth).</para></listitem>
-->
<listitem><para><userinput> --without-gd</userinput>:このスイッチは <userinput>memusagestat</userinput> プログラムを構築しないようにします。
<userinput>memusagestat</userinput> は、不可解なことにホストのライブラリ（ libgd, libpng, libz など）へのリンクを強く要求します。</para></listitem>
</itemizedlist>

<!--
<para>During this stage you might see the following warning:</para>
-->
<para>この段階で以下の警告を見るかもしれません。</para>

<blockquote><screen>configure: WARNING:
*** These auxiliary programs are missing or incompatible versions: msgfmt
*** some features will be disabled.
*** Check the INSTALL file for required versions.
（参考訳：
警告：
*** これらの予備プログラムは存在しないか、互換性のないバージョンです： msgfmt
*** いくつかの機能が無効になります。
*** 必要なバージョンを調べるのに INSTALL ファイルを見てください。）</screen></blockquote>

<!--
<para>The missing or incompatible <filename>msgfmt</filename> program is
generally harmless, but it's believed it can sometimes cause problems when
running the test suite.</para>
-->
<para><filename>msgfmt</filename> プログラムが存在しない、または互換性がないことは通常無害ですが、しかしテストスイートを実行しているときにときどき問題を引き起こすと思われています。</para>

<!--
<para>Compile the package:</para>
-->
<para>パッケージをコンパイルします。</para>

<screen><userinput>make</userinput></screen>

<!--
<para>Run the test suite:</para>
-->
<para>テストスイーツを実行します。</para>

<screen><userinput>make check</userinput></screen>

<!--
<para>The Glibc test suite is highly dependent on certain functions of your host
system, in particular the kernel. Additionally, here in this chapter some tests
can be adversely affected by existing tools or environmental issues on the host
system. Of course, these won't be a problem when we run the Glibc test suite
inside the chroot environment of <xref linkend="chapter06"/>. In general, the
Glibc test suite is always expected to pass. However, as mentioned above, some
failures are unavoidable in certain circumstances. Here is a list of the most
common issues we are aware of:</para>
-->
<para>Glibc のテストスイートは、お使いのホストシステムのある機能、とりわけカーネルに強く依存します。
加えて、この章でのあるテストは、ホストシステム上に存在するツール、あるいは環境的な問題に影響を与えます。
もちろん、これらは<xref linkend="chapter06"/>の chroot 環境の中で Glibc のテストスイートを実行するときには問題とはなりません。
一般的に、Glibc テストスイートはいつもテストに通過するものと予想されます。しかし、先に述べたように、ある環境ではいくつかの失敗が避けがたいものです。私達が把握している、最もよくある問題を列挙しておきます。</para>

<itemizedlist>
<!--
<listitem><para>The <emphasis>math</emphasis> tests sometimes fail when running
on systems where the CPU is not a relatively new genuine Intel or authentic AMD.
Certain optimization settings are also known to be a factor here.</para></listitem>
-->
<listitem><para>CPU が比較的新しい Intel 純正か AMD 純正でない場合に、<emphasis>math</emphasis> テストがときどき失敗します。一部の最適化設定がここでの原因と知られています。</para></listitem>

<!--
<listitem><para>The <emphasis>gettext</emphasis> test sometimes fails due to
host system issues. The exact reasons are not yet clear.</para></listitem>
-->
<listitem><para>ホストシステムの問題により <emphasis>gettext</emphasis> テストがときどき失敗します。明確な理由は未だ定かではありません。</para></listitem>

<!--
<listitem><para>The <emphasis>atime</emphasis> test sometimes fails when the
LFS partition is mounted with the <emphasis>noatime</emphasis> option, or due
to other file system quirks.</para></listitem>
-->
<listitem><para>LFS パーティションが <emphasis>noatime</emphasis> オプションでマウントされているか、ファイルシステムのそのほかの妙な挙動のため、<emphasis>atime</emphasis> テストがときどき失敗することがあります。</para></listitem>

<!--
<listitem><para>The <emphasis>shm</emphasis> test might fail when the host
system is running the devfs file system but doesn't have the tmpfs file system
mounted at <filename>/dev/shm</filename> due to lack of support for tmpfs in
the kernel.</para></listitem>
-->
<listitem><para>ホストシステムが devfs ファイルシステムを実行していても、カーネルが tmpfs をサポートしていないために <filename>/dev/shm</filename> にマウントされた tmpfs ファイルシステムを持っていない場合には、<emphasis>shm</emphasis> テストが失敗するかもしれません。</para></listitem>

<!--
<listitem><para>When running on older and slower hardware, some tests might
fail due to test timeouts being exceeded.</para></listitem>
-->
<listitem><para>古くて遅いハードウェア上で実行していると、いくつかのテストはテストタイムアウト時間を超過するために失敗するかもしれません。</para></listitem>
</itemizedlist>

<!--
<para>In summary, don't worry too much if you see Glibc test suite failures
here in this chapter. The Glibc in <xref linkend="chapter06"/> is the one we'll
ultimately end up using so that is the one we would really like to see pass.
But please keep in mind, even in <xref linkend="chapter06"/> some failures
could still occur &#045;&#045 the <emphasis>math</emphasis>
tests for example. When experiencing a failure, make a note of it, then
continue by reissuing the <userinput>make check</userinput>. The test suite
should pick up where it left off and continue on. You can circumvent this
stop-start sequence by issuing a <userinput>make -k check</userinput>. But if
you do that, be sure to log the output so that you can later peruse the log
file and examine the total number of failures.</para>
-->
<para>要するに、この章で Glibc のテストスイーツの失敗を目にしてもそんなに心配しなくて大丈夫です。
<xref linkend="chapter06"/>での Glibc が最終的に使うものとなるので、本当にテストを通過するのを見たいのはそちらの方になります。
しかし憶えておいて下さい、<xref linkend="chapter06"/>でもいくつかの失敗、たとえば <emphasis>math</emphasis> テストなどでの失敗は同様に発生するのです。
失敗を経験したら、それをメモして、再び <userinput>make check</userinput> を実行して続けましょう。
テストスイートはどこで終ったかを調べて、それを続けます。この止ったり、動いたりの連続は <userinput>make -k check</userinput> を実行することで避けることができます。
しかしそうするのなら、あとで追跡して失敗の総数を調べられるように出力のログを取ることを確認して下さい。</para>

<!--
<para>Now install the package:</para>
-->
<para>それではパッケージをインストールします。</para>

<screen><userinput>make install</userinput></screen>

<!--
<para>Different countries and cultures have varying conventions for how to
communicate. These conventions range from very simple ones, such as the format
for representing dates and times, to very complex ones, such as the language
spoken. The "internationalization" of GNU programs works by means of
<emphasis>locales</emphasis>. We'll install the Glibc locales now:</para>
-->
<para>さまざまな国や文化では、理解しあう方法にいろいろな約束事があります。
これらの習慣の範囲は、日付と時間の表記のようなとても単純なものから、話しことばのような非常に複雑なものにまで渡ります。
GNU の "国際化" されたプログラムはロケールという手段を使っています。それでは Glibc ロケールをインストールします。</para>

<screen><userinput>make localedata/install-locales</userinput></screen>

<!--
<para>An alternative to running the previous command is to install only
those locales which you need or want. This can be achieved by using the
<userinput>localedef</userinput> command. Information on this can be
found in the <filename>INSTALL</filename> file in the
<filename>glibc-&glibc-version;</filename> source. However, there are a number
of locales that are essential for the tests of future packages to pass, in
particular, the <emphasis>libstdc++</emphasis> tests from GCC.  The following
instructions, instead of the install-locales target above, will install
the minimum set of locales necessary for the tests to run successfully:</para>
-->
<para>このコマンドを実行する代わりに、必要なものまたは望むロケールのみをインストールすることも可能です。
これは <userinput>localedef</userinput> コマンドを使うことで行います。これについての情報は <filename>glibc-&glibc-version;</filename> のソースファイルの中にある <filename>INSTALL</filename> というファイルのにあります。
しかし、この先のパッケージのテストを通過するために重要となる沢山のロケールがあります。特に、GCCからの <emphasis>libstdc++</emphasis> テストがそうです。
以下の説明は、上の install-locales ターゲットを用いない場合、テストをうまく実行するために必要な最小限のロケールをインストールするための手引です。</para>

<screen><userinput>mkdir -p /tools/lib/locale
localedef -i de_DE -f ISO-8859-1 de_DE
localedef -i de_DE@euro -f ISO-8859-15 de_DE@euro
localedef -i en_HK -f ISO-8859-1 en_HK
localedef -i en_PH -f ISO-8859-1 en_PH
localedef -i en_US -f ISO-8859-1 en_US
localedef -i es_MX -f ISO-8859-1 es_MX
localedef -i fr_FR -f ISO-8859-1 fr_FR
localedef -i fr_FR@euro -f ISO-8859-15 fr_FR@euro
localedef -i it_IT -f ISO-8859-1 it_IT
localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen>

</sect2>

</sect1>

