src/final-system/common/gcc.ch

   1 %
   2 % This is part of CLFSja package.
   3 %
   4 % This is a CTIE change file for the original XML source of the CLFSbook.
   5 %
   6 @x
   7 <?xml version="1.0" encoding="ISO-8859-1"?>
   8 @y
   9 <?xml version="1.0" encoding="UTF-8"?>
  10 @z
  11
  12 @x
  13     <para>The GCC package contains the GNU compiler collection, which includes
  14     the C and C++ compilers.</para>
  15 @y
  16     <para>
  17     GCC パッケージは C コンパイラーや C++ コンパイラーなどの GNU コンパイラーコレクションを提供します。
  18     </para>
  19 @z
  20
  21 @x
  22     <title>Installation of GCC</title>
  23 @y
  24     <title>&InstallationOf1;GCC &InstallationOf2;</title>
  25 @z
  26
  27 @x
  28     <para os="p1">The following patch contains a number of updates to the
  29     &gcc-version; branch by the GCC developers:</para>
  30 @y
  31     <para os="p1">
  32     以下のパッチは、GCC 開発者による &gcc-version; ブランチの数々の更新を提供するものです。
  33     </para>
  34 @z
  35
  36 @x
  37     <para os="fix1">Apply a <command>sed</command> substitution that will
  38     suppress the execution of the <command>fixincludes</command> script:</para>
  39 @y
  40     <para os="fix1">
  41     以下の <command>sed</command> コマンド置換によって、<command>fixincludes</command> スクリプトを実行しないようにします。
  42     </para>
  43 @z
  44
  45 @x
  46     <para os="f">The GCC documentation recommends building GCC outside of the source
  47     directory in a dedicated build directory:</para>
  48 @y
  49     <para os="f">
  50     GCC のドキュメントによると GCC のビルドにあたっては、ソースディレクトリ以外の専用のビルドディレクトリを作成することが推奨されています。
  51     </para>
  52 @z
  53
  54 @x
  55     <para os="h">Prepare GCC for compilation:</para>
  56 @y
  57     <para os="h">&PreparePackage1;GCC &PreparePackage2;</para>
  58 @z
  59
  60 @x
  61       <title>The meaning of the new configure options:</title>
  62 @y
  63       <title>&MeaningOfOption1;configure &MeaningOfOption2;</title>
  64 @z
  65
  66 @x SED=sed
  67           <para>This prevents a hard-coded path to
  68           <filename>/tools/bin/sed</filename> in the <command>fixincl</command>
  69           program.</para>
  70 @y
  71           <para>
  72           <command>fixincl</command> プログラムにおいて <filename>/tools/bin/sed</filename> へのパスがハードコーディングされないようにします。
  73           </para>
  74 @z
  75
  76 @x --disable-bootstrap
  77           <para>For a native build, GCC defaults to performing a 3-stage
  78           "bootstrap" of the compiler. This means that GCC is compiled a total
  79           of 3 times - it is compiled once, the first stage compiler is used
  80           to build itself again, and the second stage compiler builds itself
  81           once more. The second and third passes are then compared, verifying
  82           that GCC is able to reproduce itself successfully. However, there is
  83           no need for this with the CLFS build process so we disable it here.</para>
  84 @y
  85           <para>
  86           ネイティブビルドにおいて GCC はデフォルトでは3ステージめの "ブートストラップ" コンパイラーを用います。
  87           これにより GCC は計3回コンパイルされるわけです。
  88           1回めのコンパイルの後、このコンパイラーを用いて2回めが処理され、2回めのコンパイラーを使って再度コンパイルします。
  89           そして2回めと3回めのコンパイラーが比較検証されて初めて、GCC が自分自身を生み出すことができることになります。
  90           しかし CLFS のビルド手順においてこのようなことは不要です。
  91           ここでそれを無効とします。
  92           </para>
  93 @z
  94
  95 @x
  96     <para os="j">Compile the package:</para>
  97 @y
  98     <para os="j">&CompileThePackage;</para>
  99 @z
 100
 101 @x
 102       <para>Due to GCC's critical role in a properly functioning system,
 103       the CLFS developers strongly recommend running the testsuite.</para>
 104 @y
 105       <para>
 106       GCC はシステムを適切に動作させるための重要な役割を持っています。
 107       したがって CLFS 開発者としてはテストスイートの実行を強く勧めます。
 108       </para>
 109 @z
 110
 111 @x
 112    <para os="s1">Increase the stack size prior to running the tests:</para>
 113 @y
 114    <para os="s1">
 115    テスト実施にあたり、スタックサイズを増やします。
 116    </para>
 117 @z
 118
 119 @x
 120     <para os="m">Test the results, but do not stop at errors:</para>
 121 @y
 122     <para os="m">
 123     ビルド結果をテストします。
 124     エラーが発生しても停止しないようにします。
 125     </para>
 126 @z
 127
 128 @x
 129     <para os="o">The <parameter>-k</parameter> flag is used to make the test suite
 130     run through to completion and not stop at the first failure. The GCC test
 131     suite is very comprehensive and is almost guaranteed to generate a few
 132     failures. To receive a summary of the test suite results, run:</para>
 133 @y
 134     <para os="o">
 135     <parameter>-k</parameter> フラグをつけるのは最後までテストスイートを実行させるためです。
 136     失敗があってもすぐ止まることがないようにします。
 137     GCC のテストスイートは広範囲に行われるもので、たいていは正常実行されますが失敗するものも多少はあります。
 138     テスト結果を確認するために以下を実行します。
 139     </para>
 140 @z
 141
 142 @x
 143     <para os="q">For only the summaries, pipe the output through
 144     <userinput>grep -A7 Summ</userinput>.</para>
 145 @y
 146     <para os="q">
 147     テスト結果の概略のみ確認したい場合は、出力結果をパイプ出力して <userinput>grep -A7 Summ</userinput> を実行してください。
 148     </para>
 149 @z
 150
 151 @x
 152     <para os="r">A few unexpected failures cannot always be avoided. The
 153     GCC developers are usually aware of these issues, but have not
 154     resolved them yet.</para>
 155 @y
 156     <para os="r">
 157     テストに失敗することがありますが、これを回避することはできません。
 158     GCC の開発者はこの問題を認識していますが、まだ解決していない状況です。
 159     </para>
 160 @z
 161
 162 @x
 163     <para os="s">Install the package:</para>
 164 @y
 165     <para os="s">&InstallThePackage;</para>
 166 @z
 167
 168 @x
 169     <para os="w">Create a link to satisfy FHS requirements:</para>
 170 @y
 171     <para os="w">
 172     FHS に準拠するためリンクを作成します。
 173     </para>
 174 @z
 175
 176 @x
 177     <para os="y">Many packages use the name <command>cc</command> to call the C
 178     compiler. To satisfy those packages, create a symlink:</para>
 179 @y
 180     <para os="y">
 181     各種パッケージは C コンパイラーとして <command>cc</command> を呼び出しているものが数多くあります。
 182     これに対応するため、以下のシンボリックリンクを作成します。
 183     </para>
 184 @z
 185
 186 @x
 187     <para os="aa">Finally, move a misplaced file:</para>
 188 @y
 189     <para os="aa">
 190     最後に誤ったディレクトリにあるファイルを移動します。
 191     </para>
 192 @z
 193
 194 @x
 195     <title>Contents of GCC</title>
 196 @y
 197     <title>&ContentsOf1;GCC &ContentsOf2;</title>
 198 @z
 199
 200 @x
 201       <segtitle>Installed programs</segtitle>
 202       <segtitle>Installed libraries</segtitle>
 203       <segtitle>Installed directories</segtitle>
 204 @y
 205       <segtitle>&InstalledProgram;</segtitle>
 206       <segtitle>&InstalledLibrary;</segtitle>
 207       <segtitle>&InstalledDirectory;</segtitle>
 208 @z
 209
 210 @x
 211         <seg>c++, cc (link to gcc), cpp, g++, gcc, gcov, gcov-tool</seg>
 212         <seg>libasan.[a,so], libatomic.[a,so], libcc1.so, libcilkrts.[a,so],
 213         libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a, libgomp.[a,so],
 214         libiberty.a, libitm.[a,so], liblsan.[a,so], liblto_plugin.so,
 215         libquadmath.[a,so], libssp.[a,so], libssp_nonshared.a,
 216         libstdc++.[a,so], libsupc++.a, libtsan.[a,so], libubsan.[a,so],
 217         libvtv.[a,so]</seg>
 218         <seg>/usr/include/[c++,libiberty], /usr/lib/gcc,
 219         /usr/share/gcc-&gcc-version;</seg>
 220 @y
 221         <seg>c++, cc (&LinkTo1;gcc &LinkTo2;), cpp, g++, gcc, gcov, gcov-tool</seg>
 222         <seg>libasan.[a,so], libatomic.[a,so], libcc1.so, libcilkrts.[a,so],
 223         libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a, libgomp.[a,so],
 224         libiberty.a, libitm.[a,so], liblsan.[a,so], liblto_plugin.so,
 225         libquadmath.[a,so], libssp.[a,so], libssp_nonshared.a,
 226         libstdc++.[a,so], libsupc++.a, libtsan.[a,so], libubsan.[a,so],
 227         libvtv.[a,so]</seg>
 228         <seg>/usr/include/[c++,libiberty], /usr/lib/gcc,
 229         /usr/share/gcc-&gcc-version;</seg>
 230 @z
 231
 232 @x
 233       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 234 @y
 235       <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
 236 @z
 237
 238 @x cc
 239           <para>The C compiler</para>
 240 @y
 241           <para>C コンパイラー</para>
 242 @z
 243
 244 @x cpp
 245           <para>The C preprocessor; it is used by the compiler to expand the
 246           #include, #define, and similar statements in the source files</para>
 247 @y
 248           <para>
 249           C プリプロセッサー。
 250           コンパイラーがこれを利用して、ソース内に記述された #include、#define や同じようなステートメントを展開します。
 251           </para>
 252 @z
 253
 254 @x c++
 255           <para>The C++ compiler</para>
 256 @y
 257           <para>C++ コンパイラー</para>
 258 @z
 259
 260 @x g++
 261           <para>The C++ compiler</para>
 262 @y
 263           <para>C++ コンパイラー</para>
 264 @z
 265
 266 @x gcc
 267           <para>The C compiler</para>
 268 @y
 269           <para>C コンパイラー</para>
 270 @z
 271
 272 @x gcov
 273           <para>A coverage testing tool; it is used to analyze programs to
 274           determine where optimizations will have the most effect</para>
 275 @y
 276           <para>
 277           カバレッジテストツール。
 278           プログラムを解析して、最適化が最も効果的となるのはどこかを特定します。
 279           </para>
 280 @z
 281
 282 @x gcov-tool
 283           <para>An offline tool to handle gcda counts</para>
 284 @y
 285           <para>
 286           gcda カウントを取り扱うオフラインツール。
 287           </para>
 288 @z
 289
 290 @x libasan
 291           <para>The Address Sanitizer runtime library</para>
 292 @y
 293           <para>
 294           アドレスサニタイザー (Address Sanitizer) のランタイムライブラリ。
 295           </para>
 296 @z
 297
 298 @x libatomic
 299           <para>A GCC support runtime library for atomic operations not
 300           supported by hardware</para>
 301 @y
 302           <para>
 303           ハードウェアではサポートされないアトミック操作 (atomic operations) のために GCC がサポートするランタイムライブラリ。
 304           </para>
 305 @z
 306
 307 @x libcc1
 308           <para>Translates API into RPC calls</para>
 309 @y
 310           <para>
 311           API を RPC コールに変換します。
 312           </para>
 313 @z
 314
 315 @x libcilkrts
 316           <para>Intel&reg; Cilk&trade; Plus runtime library</para>
 317 @y
 318           <para>
 319           Intel&reg; Cilk&trade; Plus ランタイムライブラリ。
 320           </para>
 321 @z
 322
 323 @x libgcc
 324           <para>Contains run-time support for <command>gcc</command></para>
 325 @y
 326           <para>
 327           <command>gcc</command> のランタイムサポートを提供します。
 328           </para>
 329 @z
 330
 331 @x libgcov
 332           <para>Library that is linked into a program when
 333           <command>gcc</command> is instructed to enable profiling</para>
 334 @y
 335           <para>
 336           <command>gcc</command> のプロファイリングを有効にした場合にこのライブラリがリンクされます。
 337           </para>
 338 @z
 339
 340 @x libgomp
 341           <para>GNU implementation of the OpenMP API for multi-platform
 342           shared-memory parallel programming in C/C++ and Fortran</para>
 343 @y
 344           <para>
 345           C/C++ や Fortran においてマルチプラットフォームでの共有メモリ並行プログラミング
 346           (multi-platform shared-memory parallel programming)
 347           を行うための GNU による OpenMP API インプリメンテーションです。
 348           </para>
 349 @z
 350
 351 @x libiberty
 352           <para>Contains routines used by various GNU programs, including
 353           <command>getopt</command>, <command>obstack</command>,
 354           <command>strerror</command>, <command>strtol</command>, and
 355           <command>strtoul</command></para>
 356 @y
 357           <para>
 358           以下に示すような数多くの GNU プログラムが利用する処理ルーチンを提供します。
 359           <command>getopt</command>、
 360           <command>obstack</command>、
 361           <command>strerror</command>、
 362           <command>strtol</command>、
 363           <command>strtoul</command>
 364           </para>
 365 @z
 366
 367 @x libitm
 368           <para>The GNU Transactional Memory Library, which provides
 369           transaction support for accesses to a process's memory</para>
 370 @y
 371           <para>
 372           GNU トランザクショナルメモリ (GNU Transactional Memory) ライブラリ。
 373           これはプロセスのメモリ上へのトランザクションを考慮したサポートを行います。
 374           </para>
 375 @z
 376
 377 @x liblsan
 378           <para>The Leak Sanitizer runtime library</para>
 379 @y
 380           <para>
 381           Leak Sanitizer ランタイムライブラリ。
 382           </para>
 383 @z
 384
 385 @x liblto_plugin
 386           <para>Runtime library for GCC's link-time optimization plugin</para>
 387 @y
 388           <para>
 389           GCC のリンク時における最適化プラグインのためのランタイムライブラリ。
 390           </para>
 391 @z
 392
 393 @x libquadmath
 394           <para>The GCC Quad-Precision Math Libarary API</para>
 395 @y
 396           <para>
 397           GCC の4倍精度数値演算 (Quad Precision Math) ライブラリ API
 398           </para>
 399 @z
 400
 401 @x libssp
 402           <para>Contains routines supporting GCC's stack-smashing protection
 403           functionality</para>
 404 @y
 405           <para>
 406           GCC のスタック破壊を防止する (stack-smashing protection) 機能をサポートするルーチンを提供します。
 407           </para>
 408 @z
 409
 410 @x libstdc++
 411           <para>The standard C++ library</para>
 412 @y
 413           <para>標準 C++ ライブラリ</para>
 414 @z
 415
 416 @x libsupc++
 417           <para>Provides supporting routines for the C++ programming
 418           language</para>
 419 @y
 420           <para>
 421           C++ プログラミング言語のためのサポートルーチンを提供します。
 422           </para>
 423 @z
 424
 425 @x libtsan
 426           <para>The Thread Sanitizer runtime library</para>
 427 @y
 428           <para>
 429           スレッドサニタイザー (Thread Sanitizer) のランタイムライブラリ。
 430           </para>
 431 @z
 432
 433 @x libubsan
 434           <para>The Undefined Behavior Sanitizer runtime library</para>
 435 @y
 436           <para>
 437           Undefined Behavior Sanitizer ランタイムライブラリ。
 438           </para>
 439 @z
 440
 441 @x libvtv
 442           <para>The Virtual Table Verification runtime library</para>
 443 @y
 444           <para>
 445           Virtual Table Verification ランタイムライブラリ。
 446           </para>
 447 @z