<sect1 id="ch05-binutils-pass1">
<!--
<title>Installing Binutils-&binutils-version; - Pass 1</title>
-->
<title>Binutils-&binutils-version; のインストール - 第 1 段階</title>
<?dbhtml filename="binutils-pass1.html" dir="chapter05"?>

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

&aa-binutils-shortdesc;
&aa-binutils-dep;

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

<sect2>
<!--
<title>Installation of Binutils</title>
-->
<title>Binutils のインストール</title>

<!--
<para>It is important that Binutils be the first package to get compiled,
because both Glibc and GCC perform various tests on the available linker and
assembler to determine which of their own features to enable.</para>
-->
<para>Glibc と GCC の二つは、それらのどの機能を有効にするかを決定するため、利用できるリンカとアセンブラについてさまざまなテストを行うので、Binutils が最初にコンパイルするパッケージであるのは重要なことです。</para>

<!--
<note><para>Even though Binutils is an important toolchain package, we are not
going to run the test suite at this early stage. First, the test suite framework
is not yet in place and second, the programs from this first pass will soon be
overwritten by those installed in the second pass.</para></note>
-->
<note><para>Binutils が重要な toolchain パッケージであっても、初期段階ではテストスイートを実行するつもりはありません。まず、テストスイートのひとそろいはまだ本来の位置に置かれていませんし、二つ目の理由は、第 1 段階でのプログラムはすぐにその第 2 段階インストールで上書きされてしまうからです。</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 or
modifying them when building Binutils.</para>
-->
<para>このパッケージはデフォルト最適化フラグ（ -march と -mcpu オプションを含む）を変更するとおかしなふるまいをすると知られています。
ですから、たとえば CFLAGS や CXXFLAGS のような、デフォルトの最適化を書きかえるような何かの環境変数を定義したなら、Binutils を構築する時に、その設定を解除するか、修正するようお勧めします。</para>

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

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

<!--
<note><para>If you want the SBU values listed in the rest of the book to be of
any use, you will have to measure the time it takes to build this package. To
achieve this easily, you could do something like:
<userinput>time { ./configure ... &amp;&amp; ... &amp;&amp; ... &amp;&amp; make install; }</userinput>.</para></note>
-->
<note><para>本書の最後に、少しでも役立つようにと一覧にした SBU の値を使いたいなら、このパッケージを構築するのにかかる時間を測る必要があります。
これを簡単に行うには、次のようにすることができます。

time {./configure ... &amp;&amp; ...&amp;&amp; ...&amp;&amp; make install;}</para></note>

<!--
<para>Now prepare Binutils for compilation:</para>
-->
<para>それでは コンパイルのために Binutils を準備しましょう。</para>

<screen><userinput>../binutils-&binutils-version;/configure \
&nbsp;&nbsp;&nbsp;&nbsp;--prefix=/tools --disable-nls</userinput></screen>

<!--
<para>The meaning of the configure options:</para>
-->
<para>設定オプションの意味</para>

<itemizedlist>
<!--
<listitem><para><userinput>&#045;&#045;prefix=/tools</userinput>: This tells the
configure script to prepare to install the Binutils programs in the
<filename>/tools</filename> directory.</para></listitem>
-->
<listitem><para><userinput>--prefix=/tools</userinput>: これはコンフィグスクリプトに Binutils プログラムを <filename>/tools</filename> ディレクトリにインストールするように指示します。</para></listitem>

<!--
<listitem><para><userinput>&#045;disable-nls</userinput>: This disables
internationalization (a word often shortened to i18n). We don't need this
for our static programs and <emphasis>nls</emphasis> often causes problems
when linking statically.</para></listitem>
-->
<listitem><para><userinput>--disable-nls</userinput>: これは国際化（この言葉はよく i18n と省略されます）を無効します。
静的プログラムにはこれは不用で、また <emphasis>nls</emphasis> は静的リンクを行なう時によく問題を引き起こします。</para></listitem>
</itemizedlist>

<!--
<para>Continue with compiling the package:</para>
-->
<para>パッケージのコンパイルを続行します。</para>

<screen><userinput>make configure-host
make LDFLAGS="-all-static"</userinput></screen>

<!--
<para>The meaning of the make parameters:</para>
-->
<para>make のパラメータの意味</para>

<itemizedlist>
<!--
<listitem><para><userinput>configure-host</userinput>: This forces all the
subdirectories to be configured immediately. A statically linked build will
fail without it. We therefore use this option to work around the
problem.</para></listitem>
-->
<listitem><para><userinput>configure-host</userinput>: このオプションは、ただちにすべてのサブディレクトリ郡の設定を強制的に作成します。
静的リンクされた構築はこれなしでは失敗します。ですから、問題に対処するためこのオプションを使います。</para></listitem>

<!--
<listitem><para><userinput>LDFLAGS="-all-static"</userinput>: This tells the
linker that all the Binutils programs should be linked statically. However,
strictly speaking, <userinput>"-all-static"</userinput> is first passed to the
<emphasis>libtool</emphasis> program which then passes
<userinput>"-static"</userinput> on to the linker.</para></listitem>
-->
<listitem><para><userinput>LDFLAGS="-all-static"</userinput>: これはリンカにすべての Binutils プログラムが静的にリンクされるべきであると伝えます。
しかし率直に言えば、<userinput>"-all-static"</userinput> は初めに <emphasis>libtool</emphasis> プログラムに渡され、それからそれがリンカに <userinput>"-static"</userinput> を渡します。</para></listitem>
</itemizedlist>

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

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

<!--
<para>Now prepare the linker for the "locking in" of Glibc later on:</para>
-->
<para>それでは Glibc の "閉じ込め" のためにリンカを用意します。</para>

<screen><userinput>make -C ld clean
make -C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput></screen>

<!--
<para>The meaning of the make parameters:</para>
-->
<para>make のパラメータの意味</para>

<itemizedlist>
<!--
<listitem><para><userinput>-C ld clean</userinput>: This tells the make program
to remove all the compiled files, but only in the <filename>ld</filename>
subdirectory.</para></listitem>
-->
<listitem><para><userinput>-C ld clean</userinput>: これは make プログラムに ld サブディレクトリの中だけにあるコンパイルされたファイルをすべて削除するように伝えます。</para></listitem>

<!--
<listitem><para><userinput>-C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput>:
This option rebuilds everything in the <filename>ld</filename> subdirectory.
Specifying the LIB_PATH makefile variable on the command line allows us to
override the default value and have it point to our temporary tools location.
The value of this variable specifies the linker's default library search path.
You'll see how this preparation is used later on in the
chapter.</para></listitem>
-->
<listitem><para><userinput>-C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput>: これは <filename>ld</filename> サブディレクトリの中にあるすべてを再構築するオプションです。
コマンドラインで LIB_PATH makefile 変数を指定すると、デフォルトの値を上書きし、暫定的にツールを置いてある場所に変更します。
この変数の値はリンカのデフォルトのライブラリ検索パスを指定します。この章のあとでこの準備がどのように使われるかが分るでしょう。</para></listitem>
</itemizedlist>

<!-- HACK - Force some whitespace to appease tidy -->
<literallayout></literallayout>

<!--
<warning><para>Do not yet remove the Binutils build and source directories. You
will need them again in their current state a bit further on in this
chapter.</para></warning>
-->
<warning><para>この段階ではまだ Binutils の構築とソースのディレクトリを削除しないで下さい。この章のもう少し先で、再び現状のまま必要となります。</para></warning>

<!-- HACK - Force some whitespace to appease tidy -->
<literallayout></literallayout>

</sect2>

</sect1>

