src/final-system/common/binutils.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 Binutils package contains a linker, an assembler, and other
  14     tools for handling object files.</para>
  15 @y
  16     <para>
  17     Binutils パッケージは、リンカーやアセンブラーなどのようにオブジェクトファイルを取り扱うツール類を提供します。
  18     </para>
  19 @z
  20
  21 @x
  22     <title>Installation of Binutils</title>
  23 @y
  24     <title>&InstallationOf1;Binutils &InstallationOf2;</title>
  25 @z
  26
  27 @x
  28     <para os="b">Verify that the PTYs are working properly inside the build
  29     environment. Check that everything is set up correctly by performing a
  30     simple test:</para>
  31 @y
  32     <para os="b">
  33     PTY がビルド環境内にて正しく作動しているかどうかを確認します。
  34     すべてが適正であるかどうかを、以下の簡単なテストの実行によりチェックします。
  35     </para>
  36 @z
  37
  38 @x
  39     <para os="d">This command should give the following output:</para>
  40 @y
  41     <para os="d">
  42     上のコマンドは以下を出力するはずです。
  43     </para>
  44 @z
  45
  46 @x
  47     <para os="f">If, instead, it gives a message saying to create more ptys,
  48     then the environment is not set up for proper PTY operation. This issue
  49     needs to be resolved before running the test suites for Binutils and GCC.</para>
  50 @y
  51     <para os="f">
  52     上のような出力ではなく、PTY の生成が必要であるとするメッセージが出力されたら、PTY の動作が適切に構築できていないことを示しています。
  53     Binutils や GCC のテストスイートを実行する前に、この症状は解消しておく必要があります。
  54     </para>
  55 @z
  56
  57 @x
  58     <para os="g">The Binutils documentation recommends building Binutils outside of the
  59     source directory in a dedicated build directory:</para>
  60 @y
  61     <para os="g">
  62     Binutils のドキュメントによると Binutils のビルドにあたっては、ソースディレクトリ以外の専用のビルドディレクトリを作成してビルドすることが推奨されています。
  63     </para>
  64 @z
  65
  66 @x
  67     <para os="i">Prepare Binutils for compilation:</para>
  68 @y
  69     <para os="i">&PreparePackage1;Binutils &PreparePackage2;</para>
  70 @z
  71
  72 @x
  73     <para os="j">Compile the package:</para>
  74 @y
  75     <para os="j">&CompileThePackage;</para>
  76 @z
  77
  78 @x
  79       <para>During <command>make tooldir=/usr</command> you may receive the
  80       following error message. It is safe to ignore.</para>
  81 @y
  82       <para>
  83       <command>make tooldir=/usr</command> を実行した際には、以下のようなエラーメッセージが出力されます。
  84       これは安全なものであり無視して構いません。
  85       </para>
  86 @z
  87
  88 @x
  89       <title>The meaning of the make parameter:</title>
  90 @y
  91       <title>&MeaningOfParameter1;make &MeaningOfParameter2;</title>
  92 @z
  93
  94 @x tooldir=/usr
  95           <para>Normally, the tooldir (the directory where the executables
  96           will ultimately be located) is set to <filename
  97           class="directory">$(exec_prefix)/$(target_alias)</filename>. Because this
  98           is a custom system, this target-specific directory in <filename
  99           class="directory">/usr</filename> is not required.</para>
 100 @y
 101           <para>
 102           tooldir は実行モジュール類が最終的にインストールされるディレクトリを表わすものであり、通常は <filename
 103           class="directory">$(exec_prefix)/$(target_alias)</filename> に設定されています。
 104           ここで行っているのはカスタムシステム作りであるわけですから <filename
 105           class="directory">/usr</filename> の下にターゲット指定のディレクトリを生成する必要はありません。
 106           </para>
 107 @z
 108
 109 @x
 110       <para>Due to Binutils' critical role in a properly functioning system,
 111       the CLFS developers strongly recommend running the testsuite.</para>
 112 @y
 113       <para>
 114       Binutils にはシステムを適切に動作させるための重要な役割があります。
 115       CLFS 開発者はテストスイートを実行することを強く勧めます。
 116       </para>
 117 @z
 118
 119 @x
 120     <para os="p">Test the results:</para>
 121 @y
 122     <para os="p">
 123     ビルド結果をテストします。
 124     </para>
 125 @z
 126
 127 @x
 128     <para os="r">Install the package:</para>
 129 @y
 130     <para os="r">&InstallThePackage;</para>
 131 @z
 132
 133 @x
 134     <title>Contents of Binutils</title>
 135 @y
 136     <title>&ContentsOf1;Binutils &ContentsOf2;</title>
 137 @z
 138
 139 @x
 140       <segtitle>Installed programs</segtitle>
 141       <segtitle>Installed libraries</segtitle>
 142       <segtitle>Installed directory</segtitle>
 143 @y
 144       <segtitle>&InstalledProgram;</segtitle>
 145       <segtitle>&InstalledLibrary;</segtitle>
 146       <segtitle>&InstalledDirectory;</segtitle>
 147 @z
 148
 149 @x
 150         <seg>addr2line, ar, as, c++filt, elfedit, gprof, ld, ld.bfd, ld.gold,
 151         nm, objcopy, objdump, ranlib, readelf, size, strings, strip</seg>
 152         <seg>libbfd.[a,so], libopcodes.[a,so]</seg>
 153         <seg>/usr/lib/ldscripts</seg>
 154 @y
 155         <seg>addr2line, ar, as, c++filt, elfedit, gprof, ld, ld.bfd, ld.gold,
 156         nm, objcopy, objdump, ranlib, readelf, size, strings, strip</seg>
 157         <seg>libbfd.[a,so], libopcodes.[a,so]</seg>
 158         <seg>/usr/lib/ldscripts</seg>
 159 @z
 160
 161 @x
 162       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 163 @y
 164       <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
 165 @z
 166
 167 @x addr2line
 168           <para>Translates program addresses to file names and line numbers;
 169           given an address and the name of an executable, it uses the debugging
 170           information in the executable to determine which source file and line
 171           number are associated with the address</para>
 172 @y
 173           <para>
 174           指定された実行モジュール名とアドレスに基づいて、プログラム内のアドレスをファイル名と行番号に変換します。
 175           これは実行モジュール内のデバッグ情報を利用します。
 176           特定のアドレスがどのソースファイルと行番号に該当するかを確認するものです。
 177           </para>
 178 @z
 179
 180 @x ar
 181           <para>Creates, modifies, and extracts from archives</para>
 182 @y
 183           <para>
 184           アーカイブの生成、修正、抽出を行います。
 185           </para>
 186 @z
 187
 188 @x as
 189           <para>An assembler that assembles the output of <command>gcc</command>
 190           into object files</para>
 191 @y
 192           <para>
 193           <command>gcc</command> の出力結果をアセンブルして、オブジェクトファイルとして生成するアセンブラー。
 194           </para>
 195 @z
 196
 197 @x c++filt
 198           <para>Used by the linker to de-mangle C++ and Java symbols and to keep
 199           overloaded functions from clashing</para>
 200 @y
 201           <para>
 202           リンカーから呼び出されるもので C++ と Java のシンボルを複合 (demangle) し、オーバーロード関数が破壊されることを回避します。
 203           </para>
 204 @z
 205
 206 @x elfedit
 207           <para>Updates the ELF header of ELF files</para>
 208 @y
 209           <para>
 210           ELF ファイルの ELF ヘッダーを更新します。
 211           </para>
 212 @z
 213
 214 @x gprof
 215           <para>Displays call graph profile data</para>
 216 @y
 217           <para>
 218           コールグラフ (call graph) のプロファイルデータを表示します。
 219           </para>
 220 @z
 221
 222 @x ld
 223           <para>A linker that combines a number of object and archive files
 224           into a single file, relocating their data and tying up symbol
 225           references</para>
 226 @y
 227           <para>
 228           複数のオブジェクトファイルやアーカイブファイルから、一つのファイルを生成するリンカー。
 229           データの再配置やシンボル参照情報の結合を行います。
 230           </para>
 231 @z
 232
 233 @x ld.bfd
 234           <para>Hard link to <command>ld</command></para>
 235 @y
 236           <para>
 237           <command>ld</command> へのハードリンク。
 238           </para>
 239 @z
 240
 241 @x ld.gold
 242           <para>A linker designed to be faster than <command>ld</command>,
 243           especially for large C++ applications.</para>
 244 @y
 245           <para>
 246           <command>ld</command> よりも高速に処理できるリンカー。
 247           特に大規模な C++ アプリケーションに有用です。
 248           </para>
 249 @z
 250
 251 @x nm
 252           <para>Lists the symbols occurring in a given object file</para>
 253 @y
 254           <para>
 255           指定されたオブジェクトファイル内のシンボル情報を一覧表示します。
 256           </para>
 257 @z
 258
 259 @x objcopy
 260           <para>Translates one type of object file into another</para>
 261 @y
 262           <para>
 263           オブジェクトファイルの変換を行います。
 264           </para>
 265 @z
 266
 267 @x objdump
 268           <para>Displays information about the given object file, with options
 269           controlling the particular information to display; the information
 270           shown is useful to programmers who are working on the compilation
 271           tools</para>
 272 @y
 273           <para>
 274           指定されたオブジェクトファイルの各種情報を表示します。
 275           さまざまなオプションを用いることで特定の情報表示が可能です。
 276           表示される情報は、コンパイル関連ツールを開発する際に有用なものです。
 277           </para>
 278 @z
 279
 280 @x ranlib
 281           <para>Generates an index of the contents of an archive and stores it
 282           in the archive; the index lists all of the symbols defined by archive
 283           members that are relocatable object files</para>
 284 @y
 285           <para>
 286           アーカイブの内容を索引として生成し、それをアーカイブに保存します。
 287           索引は、アーカイブのメンバーによって定義されるすべてのシンボルの一覧により構成されます。
 288           アーカイブのメンバーとは再配置可能なオブジェクトファイルのことです。
 289           </para>
 290 @z
 291
 292 @x readelf
 293           <para>Displays information about ELF type binaries</para>
 294 @y
 295           <para>
 296           ELF フォーマットのバイナリファイルの情報を表示します。
 297           </para>
 298 @z
 299
 300 @x size
 301           <para>Lists the section sizes and the total size for the given
 302           object files</para>
 303 @y
 304           <para>
 305           指定されたオブジェクトファイルのセクションサイズと合計サイズを一覧表示します。
 306           </para>
 307 @z
 308
 309 @x strings
 310           <para>Outputs, for each given file, the sequences of printable
 311           characters that are of at least the specified length (defaulting to
 312           four); for object files, it prints, by default, only the strings from
 313           the initializing and loading sections while for other types of files,
 314           it scans the entire file</para>
 315 @y
 316           <para>
 317           指定されたファイルに対して、印字可能な文字の並びを出力します。
 318           文字は所定の長さ (デフォルトでは 4文字) 以上のものが対象となります。
 319           オブジェクトファイルの場合デフォルトでは、初期化セクションとロードされるセクションからのみ文字列を抽出し出力します。
 320           これ以外の種類のファイルの場合は、ファイル全体が走査されます。
 321           </para>
 322 @z
 323
 324 @x strip
 325           <para>Discards symbols from object files</para>
 326 @y
 327           <para>
 328           オブジェクトファイルからデバッグシンボルを取り除きます。
 329           </para>
 330 @z
 331
 332 @x libbfd
 333           <para>The Binary File Descriptor library</para>
 334 @y
 335           <para>
 336           バイナリファイルディスクリプター (Binary File Descriptor) ライブラリ。
 337           </para>
 338 @z
 339
 340 @x libopcodes
 341           <para>A library for dealing with opcodes&mdash;the <quote>readable
 342           text</quote> versions of instructions for the processor;
 343           it is used for building utilities like
 344           <command>objdump</command>.</para>
 345 @y
 346           <para>
 347           opcodes (オペレーションコード; プロセッサー命令を<quote>認識可能なテキスト</quote>として表現したもの) を取り扱うライブラリ。
 348           このライブラリは <command>objdump</command> のような、ビルド作業に用いるユーティリティプログラムが利用しています。
 349           </para>
 350 @z