<sect1 id="ch06-adjustingtoolchain">
<!--
<title>Re-adjusting the toolchain</title>
-->
<title>Toolchain を再調整する</title>
<?dbhtml filename="adjustingtoolchain.html" dir="chapter06"?>

<!--
<para>Now that the new C libraries have been installed, it's time to re-adjust
our toolchain. We'll adjust it so that it will link any newly compiled program
against the new C libraries. Basically, this is the reverse of what we did
in the "locking in" stage in the beginning of the previous chapter.</para>
-->
<para>さて新しい C ライブラリがインストールされたので toolchain を再調整します。
新しくコンパイルされたプログラムは、すべて新しい C ライブラリに対してリンクされるよう調整します。
基本的にこれは前の章の "閉じ込め" 段階でやったことの逆です。</para>

<!--
<para>The first thing to do is to adjust the linker. For this we retained the
source and build directories from the second pass over Binutils. Install the
adjusted linker by running the following from within the
<filename class="directory">binutils-build</filename> directory:</para>
-->
<para>まず初めにリンカを調整します。このために Binutils の第 2 段階でソースと構築ディレクトリを残しておきました。
<filename class="directory">binutils-build</filename> ディレクトリの中で以下のコマンドを実行して、調整されたリンカをインストールします。</para>

<screen><userinput>make -C ld INSTALL=/tools/bin/install install</userinput></screen>

<!--
<note><para>If you somehow missed the earlier warning to retain the Binutils
source and build directories from the second pass in Chapter 5 or otherwise
accidentally deleted them or just don't have access to them, don't worry, all is
not lost. Just ignore the above command. The result will be that the next
package, Binutils, will link against the Glibc libraries in
<filename class="directory">/tools</filename> rather than
<filename class="directory">/usr</filename>. This is not ideal, however, our
testing has shown that the resulting Binutils program binaries should be
identical.</para></note>
-->
<note><para>もし何かの理由で、第 5 章の第 2 段階での Binutils のソースと構築ディレクトリを残しておくという以前の警告を見逃してしまったり、誤って消してしまったり、アクセスできなくなってしまっていたりしても心配はいりません。
すべてがなくなってしまったわけではありません。上のコマンドを無視して下さい。これは次のパッケージである Binutils が <filename class="directory">/usr</filename> ではなく <filename class="directory">/tools</filename> にある Glibc ライブラリに対してリンクされるという結果になります。
これは理想的ではありませんが、テストでは結果としてできる Binutils プログラムのバイナリ類は同一になるはずだということをを示しています。</para></note>

<!--
<para>From now on every compiled program will link <emphasis>only</emphasis>
against the libraries in <filename>/usr/lib</filename> and
<filename>/lib</filename>. The extra
<userinput>INSTALL=/tools/bin/install</userinput> is needed because the Makefile
created during the second pass still contains the reference to
<filename>/usr/bin/install</filename>, which we obviously haven't installed yet.
Some host distributions contain a <filename class="symlink">ginstall</filename>
symbolic link which takes precedence in the Makefile and thus can cause a
problem here. The above command takes care of this also.</para>
-->
<para>これからすべてのコンパイルされたプログラムが <filename>/usr/lib</filename> と <filename>/lib</filename> にあるライブラリに対して<emphasis>のみ</emphasis>リンクされます。
第 2 段階で作られる Makefile は /usr/bin/install への参照をまだ含んでいるので、<userinput>INSTALL=/tools/bin/install</userinput> が別に必要とされます。
あるホストディストリビューションは Makefile に、優先する <filename class="symlink">ginstall</filename> シンボリックリンクを持っているので、ここで問題を引き起こします。
上のコマンドはこれもまた対処します。</para>

<!--
<para>You can now remove the Binutils source and build directories.</para>
-->
<para>これで、Binutils のソースと構築ディレクトリを削除することができます。</para>

<!--
<para>The next thing to do is to amend our GCC specs file so that it points
to the new dynamic linker. Just like earlier on, we use a sed to accomplish
this:</para>
-->
<para>次に行うのは GCC スペックファイルが新しい動的リンカを示すように修正することです。ちょうど以前にやったように、これを行うのに、sed を使います。</para>

<!-- Ampersands are needed to allow cut and paste -->

<screen><userinput>SPECFILE=/tools/lib/gcc-lib/*/*/specs &amp;&amp;
sed -e 's@ /tools/lib/ld-linux.so.2@ /lib/ld-linux.so.2@g' \
&nbsp;&nbsp;&nbsp;&nbsp;$SPECFILE &gt; newspecfile &amp;&amp;
mv -f newspecfile $SPECFILE &amp;&amp;
unset SPECFILE</userinput></screen>

<!--
<para>Again, cutting and pasting the above is recommended. And just like
before, it is a good idea to check the specs file to ensure the intended
changes were actually made.</para>
-->
<para>再度、上述のコマンドコマンドはカットアンドペーストがお勧めです。そして以前のように、意図された変更が実際に行われたことを確認するため、スペックファイルを調べるというのはよいことです。</para>

<!--
<important><para>If you are working on a platform where the name of the dynamic
linker is something other than <filename>ld-linux.so.2</filename>, you
<emphasis>must</emphasis> substitute <filename>ld-linux.so.2</filename> with the
name of your platform's dynamic linker in the above commands. Refer back to
<xref linkend="ch05-toolchaintechnotes"/> if necessary.</para></important>
-->
<important><para>動的リンカの名前が <filename>ld-linux.so.2</filename> とは何か異なるプラットフォーム上で作業をしているなら、上のコマンドでお使いのプラットフォームの動的リンカの名前を <filename>ld-linux.so.2</filename> の代わりに用いましょう。
必要ならば<xref linkend="ch05-toolchaintechnotes"/>という節を参照してください。</para></important>

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

<!--
<caution><para>It is imperative at this point to stop and ensure that the
basic functions (compiling and linking) of the adjusted toolchain are working
as expected. For this we are going to perform a simple sanity check:</para>
-->
<caution><para>この段階で、調整された toolchain の基本的な機能（コンパイルとリンク）が期待通り動いていることを確認するのは必須事項です。このための簡単な完成度チェックを行ないます。</para>

<screen><userinput>echo 'main(){}' &gt; dummy.c
gcc dummy.c
readelf -l a.out | grep ': /lib'</userinput></screen>

<!--
<para>If everything is working correctly, there should be no errors, and the
output of the last command will be:</para>
-->
<para>すべてがうまく行っているのなら、エラーはないはずで、結果の出力は以下のようになるはずです。</para>

<blockquote><screen>[Requesting program interpreter: /lib/ld-linux.so.2]</screen></blockquote>

<!--
<para>If you did not receive the output as shown above, or received no output at
all, then something is seriously wrong. You will need to investigate and retrace
your steps to find out where the problem is and correct it. There is no point in
continuing until this is done. Most likely something went wrong with the specs
file amendment above. Note especially that <filename>/lib</filename> now appears
as the prefix of our dynamic linker. Of course, if you are working on a platform
where the name of the dynamic linker is something other than
<filename>ld-linux.so.2</filename>, then the output will be slightly
different.</para>
-->
<para>上に示したような出力結果がでない、あるいは出力結果がない場合、何か重大な間違いがあります。
どこに問題があるかを見つけだし、修正するために、これまでやったことを振り返ってみなければいけません。
これが完了するまでは続けても意味がありません。特に、今や <filename>/lib</filename> がお使いの動的リンカのプリフィックスとなっていることに注意しましょう。
もちろん、<filename>ld-linux.so.2</filename> とは何か別の名前の動的リンカを使ったプラットフォーム上で作業しているなら、結果の出力は少し異なったものになるでしょう。</para>

<!--
<para>Once you are satisfied that all is well, clean up the test files:</para>
-->
<para>すべてが問題ないとわかったなら、テストファイルを削除します。</para>

<screen><userinput>rm dummy.c a.out</userinput></screen>
</caution>

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

</sect1>

