File:  [Local Repository] / gnujdoc / binutils-2.13 / binutils-ja.texi
Revision 1.1: download - view: text, annotated - select for diffs
Sun Aug 25 10:22:31 2002 UTC (18 years, 2 months ago) by futoshi
Branches: MAIN
CVS tags: HEAD
Add binutils-2.13

    1: \input texinfo       @c                    -*- Texinfo -*-
    2: @setfilename binutils-ja.info
    3: @c Copyright 2001, 2002 Free Software Foundation, Inc.
    4: 
    5: @c @documentlanguage ja
    6: 
    7: @include config.texi
    8: 
    9: @ifinfo
   10: @format
   11: START-INFO-DIR-ENTRY
   12: * Binutils(ja): (binutils-ja).         The GNU binary utilities.
   13: * ar(ja): (binutils-ja)ar.               Create, modify, and extract from archives
   14: * nm(ja): (binutils-ja)nm.               List symbols from object files
   15: * objcopy(ja): (binutils-ja)objcopy.     Copy and translate object files
   16: * objdump(ja): (binutils-ja)objdump.     Display information from object files
   17: * ranlib(ja): (binutils-ja)ranlib.       Generate index to archive contents
   18: * readelf(ja): (binutils-ja)readelf.     Display the contents of ELF format files.
   19: * size(ja): (binutils-ja)size.           List section sizes and total size
   20: * strings(ja): (binutils-ja)strings.     List printable strings from files
   21: * strip(ja): (binutils-ja)strip.         Discard symbols
   22: * c++filt(ja): (binutils-ja)c++filt.     Filter to demangle encoded C++ symbols
   23: * cxxfilt(ja): (binutils-ja)c++filt.     MS-DOS name for c++filt
   24: * addr2line(ja): (binutils-ja)addr2line. Convert addresses to file and line
   25: * nlmconv(ja): (binutils-ja)nlmconv.     Converts object code into an NLM
   26: * windres(ja): (binutils-ja)windres.     Manipulate Windows resources
   27: * dlltool(ja): (binutils-ja)dlltool.     Create files needed to build and use DLLs
   28: END-INFO-DIR-ENTRY
   29: @end format
   30: @end ifinfo
   31: 
   32: @ifinfo
   33: @c man begin COPYRIGHT
   34: Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.
   35: 
   36: Permission is granted to copy, distribute and/or modify this document
   37: under the terms of the GNU Free Documentation License, Version 1.1
   38: or any later version published by the Free Software Foundation;
   39: with no Invariant Sections, with no Front-Cover Texts, and with no
   40: Back-Cover Texts.  A copy of the license is included in the
   41: section entitled "GNU Free Documentation License".
   42: 
   43: @c man end
   44: @ignore
   45: Permission is granted to process this file through TeX and print the
   46: results, provided the printed document carries a copying permission
   47: notice identical to this one except for the removal of this paragraph
   48: (this paragraph not being relevant to the printed manual).
   49: 
   50: @end ignore
   51: @end ifinfo
   52: 
   53: @synindex ky cp
   54: @c
   55: @c This file documents the GNU binary utilities "ar", "ld", "objcopy",
   56: @c  "objdump", "nm", "size", "strings", "strip", "readelf" and "ranlib".
   57: @c
   58: @c Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.
   59: @c 
   60: @c This text may be freely distributed under the terms of the GNU
   61: @c Free Documentation License.
   62: @c
   63: 
   64: @setchapternewpage odd
   65: @settitle @sc{gnu} Binary Utilities
   66: @titlepage
   67: @finalout
   68: @title The @sc{gnu} Binary Utilities
   69: @subtitle Version @value{VERSION}
   70: @sp 1
   71: @subtitle May 1993
   72: @author Roland H. Pesch
   73: @author Jeffrey M. Osier
   74: @author Cygnus Support
   75: @c 翻訳:西尾 太
   76: @page
   77: 
   78: @tex
   79: {\parskip=0pt \hfill Cygnus Support\par \hfill
   80: \TeX{}info \texinfoversion\par }
   81: @end tex
   82: 
   83: @vskip 0pt plus 1filll
   84: Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 1998, 2000, 2001, 2002 Free Software Foundation, Inc.
   85: 
   86:       Permission is granted to copy, distribute and/or modify this document
   87:       under the terms of the GNU Free Documentation License, Version 1.1
   88:       or any later version published by the Free Software Foundation;
   89:       with no Invariant Sections, with no Front-Cover Texts, and with no
   90:       Back-Cover Texts.  A copy of the license is included in the
   91:       section entitled "GNU Free Documentation License".
   92: 
   93: @end titlepage
   94: 
   95: @node Top
   96: @top Introduction
   97: 
   98: @cindex version
   99: @c This brief manual contains preliminary documentation for the @sc{gnu} binary
  100: @c utilities (collectively version @value{VERSION}): 
  101: @c 
  102: この短いマニュアルは,@sc{gnu}バイナリユーティリティ(バージョン
  103: @value{VERSION}全体)に対する予備的な文章を含んでいます.
  104: 
  105: @iftex
  106: @table @code
  107: @item ar
  108: @c Create, modify, and extract from archives
  109: @c 
  110: アーカイバの作成,編集,そしてそれからの抽出.
  111: 
  112: @item nm
  113: @c List symbols from object files
  114: @c 
  115: オブジェクトファイルからシンボルをリストアップ.
  116: 
  117: @item objcopy
  118: @c Copy and translate object files
  119: @c 
  120: オブジェクトファイルのコピーと変換.
  121: 
  122: @item objdump
  123: @c Display information from object files
  124: @c 
  125: オブジェクトファイルの情報を表示.
  126: 
  127: @item ranlib
  128: @c Generate index to archive contents
  129: @c 
  130: アーカイブの内容に索引を生成.
  131: 
  132: @item readelf
  133: @c Display the contents of ELF format files.
  134: @c 
  135: ELFフォーマットファイルの内容を表示.
  136: 
  137: @item size
  138: @c List file section sizes and total size
  139: @c 
  140: ファイルのセクションの大きさと全体の大きさをリストアップ.
  141: 
  142: @item strings
  143: @c List printable strings from files
  144: @c 
  145: ファイルから,出力可能な文字列をリストアップ.
  146: 
  147: @item strip
  148: @c Discard symbols
  149: @c 
  150: シンボルの削除.
  151: 
  152: @item c++filt
  153: @c Demangle encoded C++ symbols (on MS-DOS, this program is named
  154: @c @code{cxxfilt})
  155: @c 
  156: 符号化されたC++シンボルをdemangleする(MS-DOSでは,このプログラムは
  157: @code{cxxfilt}と命名されています).
  158: 
  159: @item addr2line
  160: @c Convert addresses into file names and line numbers
  161: @c 
  162: アドレスをファイル名と行番号に変換.
  163: 
  164: @item nlmconv
  165: @c Convert object code into a Netware Loadable Module
  166: @c 
  167: オブジェクトコードをNetware Loadable Moduleに変換.
  168: 
  169: @item windres
  170: @c Manipulate Windows resources
  171: @c 
  172: Windowsリソースの操作.
  173: 
  174: @item dlltool
  175: @c Create the files needed to build and use Dynamic Link Libraries
  176: @c 
  177: ダイナミックリンクライブラリを構築し使用するために必要なファイルを作成.
  178: @end table
  179: @end iftex
  180: 
  181: @c This document is distributed under the terms of the GNU Free
  182: @c Documentation License.  A copy of the license is included in the
  183: @c section entitled "GNU Free Documentation License".
  184: @c 
  185: この文章はGNU Free Documentation Licenseの条件の下で配布されます.ライセ
  186: ンスのコピーは,"GNU Free Documentation License"と名付けられたセクション
  187: に含まれています.
  188: 
  189: @menu
  190: * ar::                          Create, modify, and extract from archives
  191: * nm::                          List symbols from object files
  192: * objcopy::			Copy and translate object files
  193: * objdump::                     Display information from object files
  194: * ranlib::                      Generate index to archive contents
  195: * readelf::			Display the contents of ELF format files.
  196: * size::                        List section sizes and total size
  197: * strings::                     List printable strings from files
  198: * strip::                       Discard symbols
  199: * c++filt::			Filter to demangle encoded C++ symbols
  200: * cxxfilt: c++filt.             MS-DOS name for c++filt
  201: * addr2line::			Convert addresses to file and line
  202: * nlmconv::                     Converts object code into an NLM
  203: * windres::			Manipulate Windows resources
  204: * dlltool::			Create files needed to build and use DLLs
  205: * Selecting The Target System:: How these utilities determine the target.
  206: * Reporting Bugs::              Reporting Bugs
  207: * GNU Free Documentation License::  GNU Free Documentation License
  208: * Index::                       Index
  209: @end menu
  210: 
  211: @node ar
  212: @chapter ar
  213: 
  214: @kindex ar
  215: @cindex archives
  216: @cindex collections of files
  217: 
  218: @c man title ar create, modify, and extract from archives
  219: 
  220: @smallexample
  221: ar [-]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] @var{archive} [@var{member}@dots{}]
  222: ar -M [ <mri-script ]
  223: @end smallexample
  224: 
  225: @c man begin DESCRIPTION ar
  226: 
  227: @c The @sc{gnu} @command{ar} program creates, modifies, and extracts from
  228: @c archives.  An @dfn{archive} is a single file holding a collection of
  229: @c other files in a structure that makes it possible to retrieve
  230: @c the original individual files (called @dfn{members} of the archive).
  231: @c 
  232: @sc{gnu} @command{ar}は,アーカイブの作成,変更,そして,それからの抽出
  233: を行います.@dfn{アーカイブ(archive)}とは,(アーカイブの@dfn{メンバー
  234: (members)}と呼ばれる) 元となる個々のファイルを取り出すことが可能な構造の
  235: ファイル中に,他のファイルの集合を保持している単一のファイルです.
  236: 
  237: @c The original files' contents, mode (permissions), timestamp, owner, and
  238: @c group are preserved in the archive, and can be restored on
  239: @c extraction.  
  240: @c 
  241: 元のファイルの内容,モード(許可),タイムスタンプ,所有者,そしてグループ
  242: は,アーカイブに保存されていて,抽出時に復元可能です.
  243: 
  244: @cindex name length
  245: @c @sc{gnu} @command{ar} can maintain archives whose members have names of any
  246: @c length; however, depending on how @command{ar} is configured on your
  247: @c system, a limit on member-name length may be imposed for compatibility
  248: @c with archive formats maintained with other tools.  If it exists, the
  249: @c limit is often 15 characters (typical of formats related to a.out) or 16
  250: @c characters (typical of formats related to coff).
  251: @c 
  252: @sc{gnu} @command{ar}は,あらゆる長さのメンバー名のアーカイブを管理する
  253: ことが可能です.しかし,@command{ar}がシステムでコンフィグレーションされ
  254: た方法に依存し,他のツールで管理されるアーカイブのフォーマットの互換性の
  255: ため,メンバー名の長さは制限される可能性があります.それが存在する場合,
  256: 制限は15文字(a.out に関連するフォーマットの典型)や16文字(coffに関連する
  257: フォーマットの典型)のことが多いでしょう.
  258: 
  259: @cindex libraries
  260: @c @command{ar} is considered a binary utility because archives of this sort
  261: @c are most often used as @dfn{libraries} holding commonly needed
  262: @c subroutines.
  263: @c 
  264: この種のアーカイブは,一般に必要なサブルーチンを保持する@dfn{ライブラリ
  265: (libraries)} として最もよく使用されるので,@command{ar}は,バイナリユー
  266: ティリティと考えられます.
  267: 
  268: @cindex symbol index
  269: @c @command{ar} creates an index to the symbols defined in relocatable
  270: @c object modules in the archive when you specify the modifier @samp{s}.
  271: @c Once created, this index is updated in the archive whenever @command{ar}
  272: @c makes a change to its contents (save for the @samp{q} update operation).
  273: @c An archive with such an index speeds up linking to the library, and
  274: @c allows routines in the library to call each other without regard to
  275: @c their placement in the archive.
  276: @c 
  277: @command{ar}は,修飾子@samp{s}を指定したとき,アーカイブの再配置可能なオ
  278: ブジェクトモジュールに定義されているシンボルに索引を作成します.一度作成
  279: されると,(@samp{q}更新コマンドに対する保存で)@command{ar}がその内容を変
  280: 更したときはいつも,この索引はアーカイブ内で更新されます.そのような索引
  281: をもつアーカイブは,ライブラリとのリンク速度を上げ,ライブラリのルーチン
  282: がアーカイブ内の位置に関わらず,お互いの呼び出しを可能にします.
  283: 
  284: @c You may use @samp{nm -s} or @samp{nm --print-armap} to list this index
  285: @c table.  If an archive lacks the table, another form of @command{ar} called
  286: @c @command{ranlib} can be used to add just the table.
  287: @c 
  288: この索引テーブルをリストアップするため,@samp{nm -s}や@samp{nm
  289: --print-armap} を使用してもかまいません.アーカイブにテーブルがない場合,
  290: @command{ranlib}と呼ばれる@command{ar}の別の形式を,テーブルを加えるため
  291: に使用することが可能です.
  292: 
  293: @cindex compatibility, @command{ar}
  294: @cindex @command{ar} compatibility
  295: @c @sc{gnu} @command{ar} is designed to be compatible with two different
  296: @c facilities.  You can control its activity using command-line options,
  297: @c like the different varieties of @command{ar} on Unix systems; or, if you
  298: @c specify the single command-line option @option{-M}, you can control it
  299: @c with a script supplied via standard input, like the MRI ``librarian''
  300: @c program.
  301: @c 
  302: @sc{gnu} @command{ar}は,二つの異なる機能と互換性があるように設計されて
  303: います.Unixシステム上の異なる形態の@command{ar}のように,コマンドライン
  304: オプションを使用してその作業を制御することが可能です.また,単一のコマン
  305: ドラインオプション@option{-M}を指定した場合,MRI ``librarian''プログラム
  306: のように,標準入力を通じて供給されるスクリプトを用いて,それを制御するこ
  307: とが可能です.
  308: 
  309: @c man end
  310: 
  311: @menu
  312: * ar cmdline::                  Controlling @command{ar} on the command line
  313: * ar scripts::                  Controlling @command{ar} with a script
  314: @end menu
  315: 
  316: @page
  317: @node ar cmdline
  318: @section コマンドラインでの@command{ar}の制御
  319: 
  320: @smallexample
  321: @c man begin SYNOPSIS ar
  322: ar [@option{-X32_64}] [@option{-}]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] @var{archive} [@var{member}@dots{}]
  323: @c man end
  324: @end smallexample
  325: 
  326: @cindex Unix compatibility, @command{ar}
  327: @c When you use @command{ar} in the Unix style, @command{ar} insists on at least two
  328: @c arguments to execute: one keyletter specifying the @emph{operation}
  329: @c (optionally accompanied by other keyletters specifying
  330: @c @emph{modifiers}), and the archive name to act on.
  331: @c 
  332: Unix形式で@command{ar}を使用するとき,@command{ar}は少なくとも二つの引数
  333: を実行時に要求します.@emph{operation}を指定するキー文字
  334: (@emph{modifiers}を指定するその他のキー文字がオプションで付きます)と,動
  335: 作対象のアーカイブ名です.
  336: 
  337: @c Most operations can also accept further @var{member} arguments,
  338: @c specifying particular files to operate on.
  339: @c 
  340: ほとんどの処理は,それ以外に@var{member}引数を受け入れ,それは処理の対象
  341: となる特定のファイル名を指定します.
  342: 
  343: @c man begin OPTIONS ar
  344: 
  345: @c @sc{gnu} @command{ar} allows you to mix the operation code @var{p} and modifier
  346: @c flags @var{mod} in any order, within the first command-line argument.
  347: @c 
  348: @sc{gnu} @command{ar}では,最初のコマンドライン引数内で,処理コード
  349: @var{p}と修飾フラグ@var{mod}を,あらゆる順序で混合させることが可能です.
  350: 
  351: @c If you wish, you may begin the first command-line argument with a
  352: @c dash.
  353: @c 
  354: 好みにより,最初のコマンドライン引数をダッシュで始めてもかまいません.
  355: 
  356: @cindex operations on archive
  357: @c The @var{p} keyletter specifies what operation to execute; it may be
  358: @c any of the following, but you must specify only one of them:
  359: @c 
  360: @var{p}キー文字は,実行する処理を指定します.それは以下のいずれでもかま
  361: いませんが,その中の一つだけを指定する必要があります.
  362: 
  363: @table @samp
  364: @item d
  365: @cindex deleting from archive
  366: @c @emph{Delete} modules from the archive.  Specify the names of modules to
  367: @c be deleted as @var{member}@dots{}; the archive is untouched if you
  368: @c specify no files to delete.
  369: @c 
  370: アーカイブからモジュールを@emph{削除}します.削除するモジュール名は,
  371: @var{member}@dots{}として指定してください.削除するファイルを指定してい
  372: ない場合,アーカイブはそのままです.
  373: 
  374: @c If you specify the @samp{v} modifier, @command{ar} lists each module
  375: @c as it is deleted.
  376: @c 
  377: @samp{v}修飾子を指定した場合,@command{ar}は削除するそれぞれのモジュール
  378: をリストアップします.
  379: 
  380: @item m
  381: @cindex moving in archive
  382: @c Use this operation to @emph{move} members in an archive.
  383: @c 
  384: アーカイブ内でメンバーを@emph{移動}するためにこの処理を使用してください.
  385: 
  386: @c The ordering of members in an archive can make a difference in how
  387: @c programs are linked using the library, if a symbol is defined in more
  388: @c than one member.  
  389: @c 
  390: シンボルが一つ以上のメンバーで定義されている場合,アーカイブ内のメンバー
  391: の順序で,ライブラリを使用してプログラムがリンクされる方法に差異が発生す
  392: るはずです.
  393: 
  394: @c If no modifiers are used with @code{m}, any members you name in the
  395: @c @var{member} arguments are moved to the @emph{end} of the archive;
  396: @c you can use the @samp{a}, @samp{b}, or @samp{i} modifiers to move them to a
  397: @c specified place instead.
  398: @c 
  399: @code{m}とともに修飾子を使用しない場合,@var{member}引数で指名したすべて
  400: のメンバーは,アーカイブの@emph{終り}に移動されます.そうする代わりに,
  401: 指定した位置にそれらを移動するために,@samp{a},@samp{b},または@samp{i} 
  402: 修飾子が使用可能です.
  403: 
  404: @item p
  405: @cindex printing from archive
  406: @c @emph{Print} the specified members of the archive, to the standard
  407: @c output file.  If the @samp{v} modifier is specified, show the member
  408: @c name before copying its contents to standard output.
  409: @c 
  410: アーカイブの指定されたメンバーを標準出力ファイルに@emph{出力}します.
  411: @samp{v}修飾子が指定されている場合,その内容のコピーの前にメンバー名を標
  412: 準出力に表示します.
  413: 
  414: @c If you specify no @var{member} arguments, all the files in the archive are
  415: @c printed.
  416: @c 
  417: @var{member}引数を指定していない場合,アーカイブのすべてのファイルが出力
  418: されます.
  419: 
  420: @item q
  421: @cindex quick append to archive
  422: @c @emph{Quick append}; Historically, add the files @var{member}@dots{} to the end of
  423: @c @var{archive}, without checking for replacement.
  424: @c 
  425: @emph{すばやく追加}します.歴史的に,ファイル@var{member}@dots{}を
  426: @var{archive}の終りに,置換についての調査をせずに追加します.
  427: 
  428: @c The modifiers @samp{a}, @samp{b}, and @samp{i} do @emph{not} affect this
  429: @c operation; new members are always placed at the end of the archive.
  430: @c 
  431: 修飾子@samp{a},@samp{b},そして@samp{i}は,このオプションに効果は
  432: @emph{ありません}.新しいメンバーは常にアーカイブの終りに配置されます.
  433: 
  434: @c The modifier @samp{v} makes @command{ar} list each file as it is appended.
  435: @c 
  436: 修飾子@samp{v}で,@command{ar}は追加されるそれぞれのファイルをリストアッ
  437: プします.
  438: 
  439: @c Since the point of this operation is speed, the archive's symbol table
  440: @c index is not updated, even if it already existed; you can use @samp{ar s} or
  441: @c @command{ranlib} explicitly to update the symbol table index.
  442: @c 
  443: このオペレーションの要点は速度なので,アーカイブのシンボルテーブルの索引
  444: が存在している場合でも更新されません.シンボルテーブルの索引を更新するた
  445: めに,@samp{ar s}または@command{ranlib}を明示的に使用することが可能です.
  446: 
  447: @c However, too many different systems assume quick append rebuilds the
  448: @c index, so GNU ar implements @code{q} as a synonym for @code{r}.
  449: @c 
  450: しかし,あまりに多くの異なるシステムで,高速追加が索引を再構築することを
  451: 仮定するので,@sc{gnu} @command{ar}は,@code{q}を@code{r}の同義語として
  452: 実装されています.
  453: 
  454: @item r
  455: @cindex replacement in archive
  456: @c Insert the files @var{member}@dots{} into @var{archive} (with
  457: @c @emph{replacement}). This operation differs from @samp{q} in that any
  458: @c previously existing members are deleted if their names match those being
  459: @c added.
  460: @c 
  461: ファイル@var{member}@dots{}を@var{archive}に挿入します(@emph{置換}を用い
  462: ます).この処理は,追加されるものと名前が一致した場合,既存のメンバーが
  463: 削除される点で,@samp{q}とは異なります.
  464: 
  465: @c If one of the files named in @var{member}@dots{} does not exist, @command{ar}
  466: @c displays an error message, and leaves undisturbed any existing members
  467: @c of the archive matching that name.
  468: @c 
  469: @var{member}@dots{}で指名されたファイルが一つでも存在しない場合,
  470: @command{ar}はエラーメッセージを表示し,名前がアーカイブと一致する既存の
  471: メンバーはそのままになります.
  472: 
  473: @c By default, new members are added at the end of the file; but you may
  474: @c use one of the modifiers @samp{a}, @samp{b}, or @samp{i} to request
  475: @c placement relative to some existing member.
  476: @c 
  477: デフォルトで,新しいメンバーはファイルの終りに追加されます.しかし,既存
  478: のメンバーとの相対位置を要求するため,修飾子@samp{a},@samp{b},または
  479: @samp{i}の一つを使用してもかまいません.
  480: 
  481: @c The modifier @samp{v} used with this operation elicits a line of
  482: @c output for each file inserted, along with one of the letters @samp{a} or
  483: @c @samp{r} to indicate whether the file was appended (no old member
  484: @c deleted) or replaced.
  485: @c 
  486: この処理での修飾子@samp{v}の使用は,挿入されたそれぞれのファイルを出力の
  487: 一行に書き出し,ファイルが追加された(古いメンバーが削除されていない)のか,
  488: 置換されたのかを示す文字@samp{a}または@samp{r}のどちらかを追加します.
  489: 
  490: @item t
  491: @cindex contents of archive
  492: @c Display a @emph{table} listing the contents of @var{archive}, or those
  493: @c of the files listed in @var{member}@dots{} that are present in the
  494: @c archive.  Normally only the member name is shown; if you also want to
  495: @c see the modes (permissions), timestamp, owner, group, and size, you can
  496: @c request that by also specifying the @samp{v} modifier.
  497: @c 
  498: @var{archive}の内容をリストアップしている@emph{テーブル},または,アーカ
  499: イブに存在する@var{member}@dots{}にリストアップされているファイルの
  500: @emph{テーブル}を表示します.通常,メンバー名のみ見えます.モード(許可),
  501: タイムスタンプ,所有者,そして大きさも見たい場合,@samp{v}修飾子を指定し
  502: てで要求することも可能です.
  503: 
  504: @c If you do not specify a @var{member}, all files in the archive
  505: @c are listed.
  506: @c 
  507: @var{member}を指定しない場合は,アーカイブ内のすべてのファイルがリストアッ
  508: プされます.
  509: 
  510: @cindex repeated names in archive
  511: @cindex name duplication in archive
  512: @c If there is more than one file with the same name (say, @samp{fie}) in
  513: @c an archive (say @samp{b.a}), @samp{ar t b.a fie} lists only the
  514: @c first instance; to see them all, you must ask for a complete
  515: @c listing---in our example, @samp{ar t b.a}.
  516: @c 
  517: 同じ名前の(@samp{fie}という名の)ファイルが,(@samp{b.a}をいう名の)アーカ
  518: イブに一つ以上ある場合,@samp{ar t b.a fie}は最初のインスタンスのみリス
  519: トアップします.すべてを見るために,完全なリストを請求する必要があります 
  520: --- この例では@samp{ar t b.a}です.
  521: @c WRS only; per Gumby, this is implementation-dependent, and in a more
  522: @c recent case in fact works the other way.
  523: 
  524: @item x
  525: @cindex extract from archive
  526: @c @emph{Extract} members (named @var{member}) from the archive.  You can
  527: @c use the @samp{v} modifier with this operation, to request that
  528: @c @command{ar} list each name as it extracts it.
  529: @c 
  530: (@var{member}という名の)メンバーをアーカイブから@emph{抽出}します.
  531: @command{ar}が抽出しているそれぞれの名前をリストアップするように,この処
  532: 理で@samp{v}修飾子を使用することが可能です.
  533: 
  534: @c If you do not specify a @var{member}, all files in the archive
  535: @c are extracted.
  536: @c 
  537: @var{member}を指定しない場合,アーカイブのすべてのファイルが抽出されます.
  538: 
  539: @end table
  540: 
  541: @c A number of modifiers (@var{mod}) may immediately follow the @var{p}
  542: @c keyletter, to specify variations on an operation's behavior:
  543: @c 
  544: 処理の動作の変更を指定するため,いくつかの修飾子(@var{mod})を@var{p}キー
  545: 文字の直後に続けてもかまいません.
  546: 
  547: @table @samp
  548: @item a
  549: @cindex relative placement in archive
  550: @c Add new files @emph{after} an existing member of the
  551: @c archive.  If you use the modifier @samp{a}, the name of an existing archive
  552: @c member must be present as the @var{relpos} argument, before the
  553: @c @var{archive} specification.
  554: @c 
  555: 新しいファイルを,アーカイブの既存のメンバーの@emph{後}に追加します.修
  556: 飾子@samp{a}を使用した場合,@var{archive}指定の前に,既存のアーカイブメ
  557: ンバー名が@var{relpos}引数にある必要があります.
  558: 
  559: @item b
  560: @c Add new files @emph{before} an existing member of the
  561: @c archive.  If you use the modifier @samp{b}, the name of an existing archive
  562: @c member must be present as the @var{relpos} argument, before the
  563: @c @var{archive} specification.  (same as @samp{i}).
  564: @c 
  565: 新しいファイルをアーカイブの既存のメンバーの@emph{前}に加えます.修飾子
  566: @samp{b}を使用した場合,@var{archive}指定の前に,既存のアーカイブメンバー
  567: 名が@var{relpos}引数にある必要があります.(@samp{i}と同じです).
  568: 
  569: @item c
  570: @cindex creating archives
  571: @c @emph{Create} the archive.  The specified @var{archive} is always
  572: @c created if it did not exist, when you request an update.  But a warning is
  573: @c issued unless you specify in advance that you expect to create it, by
  574: @c using this modifier.
  575: @c 
  576: アーカイブを@emph{作成}します.更新の要求をしたとき,指定された
  577: @var{archive}が存在する場合でも,それは常に作成されます.しかし,この修
  578: 飾子を使用して,作成することを期待するということを前もって指定しない場合,
  579: 警告が生じます.
  580: 
  581: @item f
  582: @c Truncate names in the archive.  @sc{gnu} @command{ar} will normally permit file
  583: @c names of any length.  This will cause it to create archives which are
  584: @c not compatible with the native @command{ar} program on some systems.  If
  585: @c this is a concern, the @samp{f} modifier may be used to truncate file
  586: @c names when putting them in the archive.
  587: @c 
  588: アーカイブで名前を切り詰めます.@sc{gnu} @command{ar}は,通常あらゆる長
  589: さのファイル名を許可します.これは,いくつかのシステムのネイティブ
  590: @command{ar}プログラムと互換性のないアーカイブを作成します.これが懸念さ
  591: れる場合,アーカイブに配置するときファイル名を切り詰めるために,@samp{f}
  592: 修飾子を使用してもかまいません.
  593: 
  594: @item i
  595: @c Insert new files @emph{before} an existing member of the
  596: @c archive.  If you use the modifier @samp{i}, the name of an existing archive
  597: @c member must be present as the @var{relpos} argument, before the
  598: @c @var{archive} specification.  (same as @samp{b}).
  599: @c 
  600: 新しいファイルをアーカイブの既存のメンバーの@emph{前に}挿入します.修飾
  601: 子@samp{i}を使用する場合,@var{archive}指定の前に,既存のアーカイブメン
  602: バー名前が@var{relpos}引数にある必要があります.(@samp{b}と同じです).
  603: 
  604: @item l
  605: @c This modifier is accepted but not used.
  606: @c 
  607: この修飾子は受け入れられますが,使用されません.
  608: @c whaffor ar l modifier??? presumably compat; with
  609: @c what???---doc@@cygnus.com, 25jan91 
  610: 
  611: @item N
  612: @c Uses the @var{count} parameter.  This is used if there are multiple
  613: @c entries in the archive with the same name.  Extract or delete instance
  614: @c @var{count} of the given name from the archive.
  615: @c 
  616: @var{count}パラメータを使用します.これは,同じ名前のアーカイブに,複数
  617: のエントリーがある場合に使用されます.アーカイブから,該当する名前のイン
  618: スタンスを@var{count}個,抽出または削除します.
  619: 
  620: @item o
  621: @cindex dates in archive
  622: @c Preserve the @emph{original} dates of members when extracting them.  If
  623: @c you do not specify this modifier, files extracted from the archive
  624: @c are stamped with the time of extraction.
  625: @c 
  626: メンバーが既存のとき,その@emph{オリジナルの}日付を保持します.この修飾
  627: 子を指定しない場合,アーカイブから抽出されるファイルは,抽出した時間でタ
  628: イムスタンプがつきます.
  629: 
  630: @item P
  631: @c Use the full path name when matching names in the archive.  @sc{gnu}
  632: @c @command{ar} can not create an archive with a full path name (such archives
  633: @c are not POSIX complaint), but other archive creators can.  This option
  634: @c will cause @sc{gnu} @command{ar} to match file names using a complete path
  635: @c name, which can be convenient when extracting a single file from an
  636: @c archive created by another tool.
  637: @c 
  638: アーカイブの名前の一致にフルパス名を使用します.@sc{gnu} @command{ar}は
  639: フルパス名を持つアーカイブ(そのようなアーカイブは,POSIXで問題ない)を作
  640: 成することは不可能ですが,アーカイブを作成するものには,そうすることが可
  641: 能なものもあります.このオプションで,@sc{gnu} @command{ar}はフルパス名
  642: を使用しているファイル名にマッチし,それは,他のツールで作成されたアーカ
  643: イブから単一のファイルを抽出するとき便利でしょう.
  644: 
  645: @item s
  646: @cindex writing archive index
  647: @c Write an object-file index into the archive, or update an existing one,
  648: @c even if no other change is made to the archive.  You may use this modifier
  649: @c flag either with any operation, or alone.  Running @samp{ar s} on an
  650: @c archive is equivalent to running @samp{ranlib} on it.
  651: @c 
  652: オブジェクトファイルの索引をアーカイブに書き出したり,他の変更がアーカイ
  653: ブに対してなされない場合でも,既存のものを更新したりします.この修飾子フ
  654: ラグは,あらゆるオプションとともに,または単独で使用してもかまいません.
  655: アーカイブで@samp{ar s}を実行することは,@samp{ranlib}の実行と等価です.
  656: 
  657: @item S
  658: @cindex not writing archive index
  659: @c Do not generate an archive symbol table.  This can speed up building a
  660: @c large library in several steps.  The resulting archive can not be used
  661: @c with the linker.  In order to build a symbol table, you must omit the
  662: @c @samp{S} modifier on the last execution of @samp{ar}, or you must run
  663: @c @samp{ranlib} on the archive.
  664: @c 
  665: アーカイブシンボルテーブルを生成しません.これで何段階か使用する大きなラ
  666: イブラリの構築を高速にすることが可能です.結果として出力されるアーカイブ
  667: は,リンカで使用することは不可能です.シンボルテーブルを構築するために,
  668: @samp{ar} の最後の実行で@samp{S} 修飾子を省略したり,アーカイブで
  669: @samp{ranlib}を実行する必要があります.
  670: 
  671: @item u
  672: @cindex updating an archive
  673: @c Normally, @samp{ar r}@dots{} inserts all files
  674: @c listed into the archive.  If you would like to insert @emph{only} those
  675: @c of the files you list that are newer than existing members of the same
  676: @c names, use this modifier.  The @samp{u} modifier is allowed only for the
  677: @c operation @samp{r} (replace).  In particular, the combination @samp{qu} is
  678: @c not allowed, since checking the timestamps would lose any speed
  679: @c advantage from the operation @samp{q}.
  680: @c 
  681: 通常,@samp{ar r}@dots{}でリストアップされているすべてのファイルをアーカ
  682: イブに挿入します.リストアップしたもので,同じ名前の既存のメンバーより新
  683: しいファイル@emph{のみ}挿入したい場合,この修飾子を使用してください.
  684: @samp{u}修飾子は,処理@samp{r}(置換)に対してのみ可能です.特に,タイムス
  685: タンプの調査が処理@samp{q}での速度の利点を損なうため,@samp{qu}と組み合
  686: わせることはできません.
  687: 
  688: @item v
  689: @c This modifier requests the @emph{verbose} version of an operation.  Many
  690: @c operations display additional information, such as filenames processed,
  691: @c when the modifier @samp{v} is appended.
  692: @c 
  693: この修飾子は,処理の@emph{冗長}バージョンを要求します.多くのオペレーショ
  694: ンは,修飾子@samp{v}が追加されているとき,処理しているファイル名のような
  695: 追加の情報を表示します.
  696: 
  697: @item V
  698: @c This modifier shows the version number of @command{ar}.
  699: @c 
  700: この修飾子は@command{ar}のバージョンナンバーを表示します.
  701: @end table
  702: 
  703: @c @command{ar} ignores an initial option spelt @samp{-X32_64}, for
  704: @c compatibility with AIX.  The behaviour produced by this option is the
  705: @c default for GNU @command{ar}.  @command{ar} does not support any of the other
  706: @c @samp{-X} options; in particular, it does not support @option{-X32}
  707: @c which is the default for AIX @command{ar}.
  708: @c 
  709: @command{ar}は,AIXに対する互換性のため,@samp{-X32_64}と綴られた最初の
  710: オプションを無視します.このオプションによって引き起こされる動作は,GNU
  711: @command{ar}のデフォルトです.@command{ar}は,その他の@samp{-X}オプショ
  712: ンを全くサポートしません.特に,AIX @command{ar}ではデフォルトとなる
  713: @option{-X32}はサポートしません.
  714: 
  715: @c man end
  716: 
  717: @ignore
  718: @c man begin SEEALSO ar
  719: nm(1), ranlib(1), and the Info entries for @file{binutils}.
  720: @c man end
  721: @end ignore
  722: 
  723: @node ar scripts
  724: @section スクリプトを用いた@command{ar}の制御
  725: 
  726: @smallexample
  727: ar -M [ <@var{script} ]
  728: @end smallexample
  729: 
  730: @cindex MRI compatibility, @command{ar}
  731: @cindex scripts, @command{ar}
  732: @c If you use the single command-line option @samp{-M} with @command{ar}, you
  733: @c can control its operation with a rudimentary command language.  This
  734: @c form of @command{ar} operates interactively if standard input is coming
  735: @c directly from a terminal.  During interactive use, @command{ar} prompts for
  736: @c input (the prompt is @samp{AR >}), and continues executing even after
  737: @c errors.  If you redirect standard input to a script file, no prompts are
  738: @c issued, and @command{ar} abandons execution (with a nonzero exit code)
  739: @c on any error.
  740: @c 
  741: 単一のコマンドラインオプション@option{-M}を@command{ar}で用いた場合,基
  742: 礎的なコマンド言語でその処理を制御することが可能です.@command{ar}のこの
  743: 形式は,標準入力が端末から直接来ている場合,対話的に処理します.対話的に
  744: 使用している間,@command{ar}は入力を促し(プロンプトは@samp{AR >}),エラー
  745: 後も実行を続けます.標準入力をスクリプトファイルにリダイレクトしている場
  746: 合,プロンプトは発行されず,@command{ar}はエラーが発生すると(ゼロでない
  747: 終了コードで)実行を終了します.
  748: 
  749: @c The @command{ar} command language is @emph{not} designed to be equivalent
  750: @c to the command-line options; in fact, it provides somewhat less control
  751: @c over archives.  The only purpose of the command language is to ease the
  752: @c transition to @sc{gnu} @command{ar} for developers who already have scripts
  753: @c written for the MRI ``librarian'' program.
  754: @c 
  755: @command{ar}コマンド言語は,コマンドラインオプションと等価に設計されて
  756: @emph{いません}.実際,それはアーカイブ上の制御が幾分少なくなっています.
  757: コマンド言語の目的は,MRI ``librarian''プログラムに対して書かれたスクリ
  758: プトを既に所有している開発者が,@sc{gnu} @command{ar}への変換をより簡単
  759: にすることです.
  760: 
  761: @c The syntax for the @command{ar} command language is straightforward:
  762: @c 
  763: @command{ar}コマンド言語の構文は簡単です.
  764: @itemize @bullet
  765: @item
  766: @c commands are recognized in upper or lower case; for example, @code{LIST}
  767: @c is the same as @code{list}.  In the following descriptions, commands are
  768: @c shown in upper case for clarity.
  769: @c 
  770: コマンドは大文字も小文字も認識します.例えば,@code{LIST}は@code{list}と
  771: 同じです.以下の記述では,明確さのためにコマンドは大文字で表示されます.
  772: 
  773: @item
  774: @c a single command may appear on each line; it is the first word on the
  775: @c line.
  776: @c 
  777: 単一のコマンドは,個別の行に配置してもかまいません.それは,行の最初の単
  778: 語となります.
  779: 
  780: @item
  781: @c empty lines are allowed, and have no effect.
  782: @c 
  783: 空行が可能で,それは効果がありません.
  784: 
  785: @item
  786: @c comments are allowed; text after either of the characters @samp{*}
  787: @c or @samp{;} is ignored.
  788: @c 
  789: コメントが可能です.文字@samp{*}または@samp{;}以降のテキストは無視されま
  790: す.
  791: 
  792: @item
  793: @c Whenever you use a list of names as part of the argument to an @command{ar}
  794: @c command, you can separate the individual names with either commas or
  795: @c blanks.  Commas are shown in the explanations below, for clarity.
  796: @c 
  797: @command{ar}コマンドの引数の一部として名前のリストを使用するときは,カンマ
  798: または空白で,それぞれの名前を分けることが可能です.明確さのため,以下の
  799: 説明はカンマで表現されます.
  800: 
  801: @item
  802: @c @samp{+} is used as a line continuation character; if @samp{+} appears
  803: @c at the end of a line, the text on the following line is considered part
  804: @c of the current command.
  805: @c 
  806: 行の連結文字として@samp{+}が使用されます.@samp{+}が行末に現れた場合,そ
  807: れに続く行のテキストは,現在のコマンドの一部と考えられます.
  808: @end itemize
  809: 
  810: @c Here are the commands you can use in @command{ar} scripts, or when using
  811: @c @command{ar} interactively.  Three of them have special significance:
  812: @c 
  813: ここに,@command{ar}で使用可能な,または,@command{ar}を対話的に使用して
  814: いるときのコマンドがあります.そのうちの3つは特別な意味を持ちます.
  815: 
  816: @c @code{OPEN} or @code{CREATE} specify a @dfn{current archive}, which is
  817: @c a temporary file required for most of the other commands.
  818: @c 
  819: @code{OPEN}または@code{CREATE}は@dfn{現在のアーカイブ(current archive)}
  820: を指定し,それはそれ以外のほとんどのコマンドが要求する一時ファイルです.
  821: 
  822: @c @code{SAVE} commits the changes so far specified by the script.  Prior
  823: @c to @code{SAVE}, commands affect only the temporary copy of the current
  824: @c archive.
  825: @c 
  826: @code{SAVE}は,スクリプトでこれまでに指定された変更をコミットします.
  827: @code{SAVE}の前のコマンドは,現在のアーカイブの一時的なコピーに対しての
  828: み効果があります.
  829: 
  830: @table @code
  831: @item ADDLIB @var{archive} 
  832: @itemx ADDLIB @var{archive} (@var{module}, @var{module}, @dots{} @var{module})
  833: @c Add all the contents of @var{archive} (or, if specified, each named
  834: @c @var{module} from @var{archive}) to the current archive.
  835: @c 
  836: @var{archive}のすべての内容(または,指定されている場合,アーカイブのそれ
  837: ぞれの指名された@var{module})を,現在のアーカイブに追加します.
  838: 
  839: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  840: @c 
  841: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
  842: 
  843: @item ADDMOD @var{member}, @var{member}, @dots{} @var{member}
  844: @c FIXME! w/Replacement??  If so, like "ar r @var{archive} @var{names}"
  845: @c        else like "ar q..."
  846: @c 
  847: @c Add each named @var{member} as a module in the current archive.
  848: @c 
  849: それぞれの指名された@var{member}を,モジュールとして,現在のアーカイブに
  850: 追加します.
  851: 
  852: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  853: @c 
  854: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
  855: 
  856: @item CLEAR
  857: @c Discard the contents of the current archive, canceling the effect of
  858: @c any operations since the last @code{SAVE}.  May be executed (with no
  859: @c effect) even if  no current archive is specified.
  860: @c 
  861: 現在のアーカイブの内容を削除し,最後に@code{SAVE}されてからのあらゆる処
  862: 理の効果を無効にします.現在のアーカイブが指定されていない場合でも実行可
  863: 能です(効果はありません).
  864: 
  865: @item CREATE @var{archive}
  866: @c Creates an archive, and makes it the current archive (required for many
  867: @c other commands).  The new archive is created with a temporary name; it
  868: @c is not actually saved as @var{archive} until you use @code{SAVE}.
  869: @c You can overwrite existing archives; similarly, the contents of any
  870: @c existing file named @var{archive} will not be destroyed until @code{SAVE}.
  871: @c 
  872: アーカイブを作成し,それを現在のアーカイブにします(その他,多くのコマン
  873: ドに対し必要です).新しいアーカイブは,一時的な名前で作成されます.それ
  874: は,@code{SAVE}を使用するまで,@var{archive}として実際に保存されません.
  875: 既存のアーカイブに優先可能です.同様に,指名されている既存の
  876: @var{archive}ファイルの内容は,@code{SAVE}まで破壊されません.
  877: 
  878: @item DELETE @var{module}, @var{module}, @dots{} @var{module}
  879: @c Delete each listed @var{module} from the current archive; equivalent to
  880: @c @samp{ar -d @var{archive} @var{module} @dots{} @var{module}}.
  881: @c 
  882: リストアップされているそれぞれの@var{module}を,現在のアーカイブから削除
  883: します.@samp{ar -d @var{archive} @var{module} @dots{} @var{module}}と同
  884: じです.
  885: 
  886: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  887: @c 
  888: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
  889: 
  890: @item DIRECTORY @var{archive} (@var{module}, @dots{} @var{module})
  891: @itemx DIRECTORY @var{archive} (@var{module}, @dots{} @var{module}) @var{outputfile}
  892: @c List each named @var{module} present in @var{archive}.  The separate
  893: @c command @code{VERBOSE} specifies the form of the output: when verbose
  894: @c output is off, output is like that of @samp{ar -t @var{archive}
  895: @c @var{module}@dots{}}.  When verbose output is on, the listing is like
  896: @c @samp{ar -tv @var{archive} @var{module}@dots{}}.
  897: @c 
  898: @var{archive}に存在している指名されたそれぞれ@var{module}をリストアップ
  899: します.別のコマンド@code{VERBOSE}で,出力形式を指定します.冗長出力がオ
  900: フのとき,出力は@samp{ar -t @var{archive} @var{module}@dots{}}のようにな
  901: ります.冗長出力がオンのとき,リストは@samp{ar -tv @var{archive}
  902: @var{module}@dots{}}のようになります.
  903: 
  904: @c Output normally goes to the standard output stream; however, if you
  905: @c specify @var{outputfile} as a final argument, @command{ar} directs the
  906: @c output to that file.
  907: @c 
  908: 出力は通常,標準出力に流れていきます.しかし,@var{outputfile}を最後の引
  909: 数として指定した場合,@command{ar}はそのファイルに出力を変更します.
  910: 
  911: @item END
  912: @c Exit from @command{ar}, with a @code{0} exit code to indicate successful
  913: @c completion.  This command does not save the output file; if you have
  914: @c changed the current archive since the last @code{SAVE} command, those
  915: @c changes are lost.
  916: @c 
  917: @command{ar}を,正しく完了したことを示す終了コード@code{0}で終了します.
  918: このコマンドは出力ファイルを保存しません.最後の@code{SAVE}コマンド以降
  919: に現在のアーカイブを変更した場合.これらの変更は失われます.
  920: 
  921: @item EXTRACT @var{module}, @var{module}, @dots{} @var{module}
  922: @c Extract each named @var{module} from the current archive, writing them
  923: @c into the current directory as separate files.  Equivalent to @samp{ar -x
  924: @c @var{archive} @var{module}@dots{}}.
  925: @c 
  926: 指名されたそれぞれの@var{module}を現在のアーカイブから抽出し,それらを現
  927: 在のディレクトリに個別のファイルとして書き出します.@samp{ar -x
  928: @var{archive} @var{module}@dots{}}と同じです.
  929: 
  930: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  931: @c 
  932: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
  933: 
  934: @ignore
  935: @c FIXME Tokens but no commands???
  936: @item FULLDIR
  937: 
  938: @item HELP
  939: @end ignore
  940: 
  941: @item LIST
  942: @c Display full contents of the current archive, in ``verbose'' style
  943: @c regardless of the state of @code{VERBOSE}.  The effect is like @samp{ar
  944: @c tv @var{archive}}.  (This single command is a @sc{gnu} @command{ar}
  945: @c enhancement, rather than present for MRI compatibility.)
  946: @c 
  947: 現在のアーカイブのすべての内容を,@code{VERBOSE}の状態に関わらず,
  948: ``verbose''形式で表示します.効果は@samp{ar tv @var{archive}}に似ていま
  949: す.(この単独コマンドは@sc{gnu} @command{ar}拡張で,MRI互換に提供されて
  950: いるものではありません).
  951: 
  952: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  953: @c 
  954: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
  955: 
  956: @item OPEN @var{archive}
  957: @c Opens an existing archive for use as the current archive (required for
  958: @c many other commands).  Any changes as the result of subsequent commands
  959: @c will not actually affect @var{archive} until you next use @code{SAVE}.
  960: @c 
  961: 現在のアーカイブとして使用するために,既存のアーカイブを開きます(他の多
  962: くのコマンドに対し必要です).それに続くコマンドの結果からのあらゆる変更
  963: は,次に@code{SAVE}が使用されるまで,@var{archive}に対し実際に効果はあり
  964: ません.
  965: 
  966: @item REPLACE @var{module}, @var{module}, @dots{} @var{module}
  967: @c In the current archive, replace each existing @var{module} (named in
  968: @c the @code{REPLACE} arguments) from files in the current working directory.
  969: @c To execute this command without errors, both the file, and the module in
  970: @c the current archive, must exist. 
  971: @c 
  972: 現在のアーカイブで,それぞれの(@code{REPLACE}の引数で指名された)既存の
  973: @var{module}を,現在のワーキングディレクトリのファイルで置換します.エラー
  974: 無くこのコマンドを実行するために,ファイルと現在のアーカイブのモジュール
  975: の両方が存在する必要があります.
  976: 
  977: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  978: @c 
  979: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
  980: 
  981: @item VERBOSE
  982: @c Toggle an internal flag governing the output from @code{DIRECTORY}.
  983: @c When the flag is on, @code{DIRECTORY} output matches output from
  984: @c @samp{ar -tv }@dots{}.
  985: @c 
  986: @code{DIRECTORY}からの出力を管理している内部フラグを切り替えます.フラグ
  987: がオンのとき,@code{DIRECTORY}出力は,@samp{ar -tv }@dots{}からの出力に
  988: 一致します.
  989: 
  990: @item SAVE
  991: @c Commit your changes to the current archive, and actually save it as a
  992: @c file with the name specified in the last @code{CREATE} or @code{OPEN}
  993: @c command. 
  994: @c 
  995: 現在のアーカイブへの変更をコミットし,それを,最後の@code{CREATE}や
  996: @code{OPEN}コマンドで指定された名前のファイルに,実際に保存します.
  997: 
  998: @c Requires prior use of @code{OPEN} or @code{CREATE}.
  999: @c 
 1000: @code{OPEN}や@code{CREATE}を前もって使用することが要求されます.
 1001: 
 1002: @end table
 1003: 
 1004: @iftex
 1005: @node ld
 1006: @chapter ld
 1007: @cindex linker
 1008: @kindex ld
 1009: @c The @sc{gnu} linker @command{ld} is now described in a separate manual.
 1010: @c @xref{Top,, Overview,, Using LD: the @sc{gnu} linker}.
 1011: @c 
 1012: @sc{gnu}リンカ@command{ld}は,現在,別のマニュアルで記述されています.
 1013: @xref{Top,, Overview,, Using LD: the @sc{gnu} linker}.
 1014: @end iftex
 1015: 
 1016: @node nm
 1017: @chapter nm
 1018: @cindex symbols
 1019: @kindex nm
 1020: 
 1021: @c man title nm list symbols from object files
 1022: 
 1023: @smallexample
 1024: @c man begin SYNOPSIS nm
 1025: nm [@option{-a}|@option{--debug-syms}] [@option{-g}|@option{--extern-only}]
 1026:    [@option{-B}] [@option{-C}|@option{--demangle}[=@var{style}]] [@option{-D}|@option{--dynamic}]
 1027:    [@option{-S}|@option{--print-size}] [@option{-s}|@option{--print-armap}]
 1028:    [@option{-A}|@option{-o}|@option{--print-file-name}]
 1029:    [@option{-n}|@option{-v}|@option{--numeric-sort}] [@option{-p}|@option{--no-sort}]
 1030:    [@option{-r}|@option{--reverse-sort}] [@option{--size-sort}] [@option{-u}|@option{--undefined-only}]
 1031:    [@option{-t} @var{radix}|@option{--radix=}@var{radix}] [@option{-P}|@option{--portability}]
 1032:    [@option{--target=}@var{bfdname}] [@option{-f}@var{format}|@option{--format=}@var{format}]
 1033:    [@option{--defined-only}] [@option{-l}|@option{--line-numbers}] [@option{--no-demangle}]
 1034:    [@option{-V}|@option{--version}] [@option{-X 32_64}] [@option{--help}]  [@var{objfile}@dots{}]
 1035: @c man end
 1036: @end smallexample
 1037: 
 1038: @c man begin DESCRIPTION nm
 1039: @c @sc{gnu} @command{nm} lists the symbols from object files @var{objfile}@dots{}.
 1040: @c If no object files are listed as arguments, @command{nm} assumes the file
 1041: @c @file{a.out}.
 1042: @c 
 1043: @sc{gnu} @command{nm}は,オブジェクトファイル@var{objfile}@dots{}のシン
 1044: ボルをリストアップします.オブジェクトファイルが引数として与えられていな
 1045: い場合,@command{nm}はファイルを@code{a.out}と仮定します.
 1046: 
 1047: @c For each symbol, @command{nm} shows:
 1048: @c 
 1049: それぞれのシンボルに対し,@command{nm}は以下を表示します.
 1050: 
 1051: @itemize @bullet
 1052: @item
 1053: @c The symbol value, in the radix selected by options (see below), or
 1054: @c hexadecimal by default.
 1055: @c 
 1056: シンボル値で,オプションで指定されている基数(以下を参照),または,デフォ
 1057: ルトの16進数になります.
 1058: 
 1059: @item
 1060: @c The symbol type.  At least the following types are used; others are, as
 1061: @c well, depending on the object file format.  If lowercase, the symbol is
 1062: @c local; if uppercase, the symbol is global (external).
 1063: @c 
 1064: シンボル形式です.少なくとも以下の形式が使用されます.それ以外は,同様に
 1065: オブジェクトファイルのフォーマットに依存します.小文字の場合,シンボルは
 1066: ローカルです.大文字の場合,シンボルはグローバル(外部参照可能)です.
 1067: 
 1068: @c Some more detail on exactly what these symbol types are used for
 1069: @c would be nice.
 1070: @table @code
 1071: @item A
 1072: @c The symbol's value is absolute, and will not be changed by further
 1073: @c linking.
 1074: @c 
 1075: シンボルの値は絶対値で,更なるリンクで変更されません.
 1076: 
 1077: @item B
 1078: @c The symbol is in the uninitialized data section (known as BSS).
 1079: @c 
 1080: シンボルは初期化されていないデータセクションにあります(BSSとして知られて
 1081: います).
 1082: 
 1083: @item C
 1084: @c The symbol is common.  Common symbols are uninitialized data.  When
 1085: @c linking, multiple common symbols may appear with the same name.  If the
 1086: @c symbol is defined anywhere, the common symbols are treated as undefined
 1087: @c references.
 1088: @c 
 1089: シンボルは共通です.共通シンボルは初期化されていないデータです.リンク時,
 1090: 複数の共通シンボルは,同じ名前のものが存在してもかまいません.シンボルが
 1091: どこかで定義されている場合,共通のシンボルは未定義の参照として扱われます.
 1092: @ifclear man
 1093: @c For more details on common symbols, see the discussion of
 1094: @c --warn-common in @ref{Options,,Linker options,ld.info,The GNU linker}.
 1095: @c 
 1096: 共通シンボルの詳細は,@ref{Options,,Linker options,ld.info,The GNU
 1097: linker}の@option{--warn-common}の記述を参照してください.
 1098: @end ifclear
 1099: 
 1100: @item D
 1101: @c The symbol is in the initialized data section.
 1102: @c 
 1103: シンボルは,初期化されているデータセクションにあります.
 1104: 
 1105: @item G
 1106: @c The symbol is in an initialized data section for small objects.  Some
 1107: @c object file formats permit more efficient access to small data objects,
 1108: @c such as a global int variable as opposed to a large global array.
 1109: @c 
 1110: シンボルは,小さいオブジェクトに対して初期化されているデータセクションに
 1111: あります.いくつかのオブジェクトファイルのフォーマットは,グローバルな配
 1112: 列に対するグローバルな整数型変数のような,小さなデータオブジェクトに対す
 1113: るより効果的なアクセスを可能とします.
 1114: 
 1115: @item I
 1116: @c The symbol is an indirect reference to another symbol.  This is a GNU
 1117: @c extension to the a.out object file format which is rarely used.
 1118: @c 
 1119: シンボルは他のシンボルへの間接参照です.これは,滅多に使用されない
 1120: @file{a.out}オブジェクトファイル形式に対するGNU拡張です.
 1121: 
 1122: @item N
 1123: @c The symbol is a debugging symbol.
 1124: @c 
 1125: シンボルはデバッグシンボルです.
 1126: 
 1127: @item R
 1128: @c The symbol is in a read only data section.
 1129: @c 
 1130: シンボルは読み込み専用データセクションにあります.
 1131: 
 1132: @item S
 1133: @c The symbol is in an uninitialized data section for small objects.
 1134: @c 
 1135: シンボルは小さなオブジェクトに対する初期化されていないデータセクションに
 1136: あります.
 1137: 
 1138: @item T
 1139: @c The symbol is in the text (code) section.
 1140: @c 
 1141: シンボルはテキスト(code)セクションにあります.
 1142: 
 1143: @item U
 1144: @c The symbol is undefined.
 1145: @c 
 1146: シンボルは定義されていません.
 1147: 
 1148: @item V
 1149: @c The symbol is a weak object.  When a weak defined symbol is linked with
 1150: @c a normal defined symbol, the normal defined symbol is used with no error.
 1151: @c When a weak undefined symbol is linked and the symbol is not defined,
 1152: @c the value of the weak symbol becomes zero with no error.
 1153: @c 
 1154: シンボルはweakオブジェクトです.定義されているweakシンボルが,通常通りに
 1155: 定義されているシンボルとリンクされるとき,通常通りに定義されているシンボ
 1156: ルがエラー無く使用されます.weakな未定義のシンボルがリンクされ,シンボル
 1157: が定義されていないとき,weakシンボルの値はエラー無くゼロになります.
 1158: 
 1159: @item W
 1160: @c The symbol is a weak symbol that has not been specifically tagged as a
 1161: @c weak object symbol.  When a weak defined symbol is linked with a normal
 1162: @c defined symbol, the normal defined symbol is used with no error.
 1163: @c When a weak undefined symbol is linked and the symbol is not defined,
 1164: @c the value of the weak symbol becomes zero with no error.
 1165: @c 
 1166: シンボルは,weakオブジェクトシンボルとして特殊なタグを持たないweakシンボ
 1167: ルです.定義されているweakシンボルが,通常通りに定義されているシンボルと
 1168: リンクされるとき,通常通りに定義されているシンボルがエラー無く使用されま
 1169: す.weakな未定義のシンボルがリンクされ,シンボルが定義されていないとき,
 1170: weakシンボルの値はエラー無くゼロになります.
 1171: 
 1172: @item -
 1173: @c The symbol is a stabs symbol in an a.out object file.  In this case, the
 1174: @c next values printed are the stabs other field, the stabs desc field, and
 1175: @c the stab type.  Stabs symbols are used to hold debugging information.
 1176: @c 
 1177: シンボルは,@code{a.out}オブジェクトファイルのスタブシンボルです.この場
 1178: 合,次に出力される値は,スタブのその他のフィールド,スタブのdescフィール
 1179: ド,そして,スタブの形式になります.スタブシンボルは,デバッグ情報を保つ
 1180: ために使用されます.
 1181: @ifclear man
 1182: @c For more information, see @ref{Top,Stabs,Stabs Overview,stabs.info, The
 1183: @c ``stabs'' debug format}.
 1184: @c 
 1185: 詳細は,@ref{Top,Stabs,Stabs Overview,stabs.info, The ``stabs'' debug
 1186: format}を参照してください.
 1187: @end ifclear
 1188: 
 1189: @item ?
 1190: @c The symbol type is unknown, or object file format specific.
 1191: @c 
 1192: シンボル形式が分からない,または独特のフォーマットのオブジェクトファイル
 1193: です.
 1194: @end table
 1195: 
 1196: @item
 1197: @c The symbol name.
 1198: @c 
 1199: シンボル名です.
 1200: @end itemize
 1201: 
 1202: @c man end
 1203: 
 1204: @c man begin OPTIONS nm
 1205: @c The long and short forms of options, shown here as alternatives, are
 1206: @c equivalent.
 1207: @c 
 1208: 以下で交互に表示している,オプションの長い形式と短い形式は等価です.
 1209: 
 1210: @table @env
 1211: @item -A
 1212: @itemx -o
 1213: @itemx --print-file-name 
 1214: @cindex input file name
 1215: @cindex file name
 1216: @cindex source file name
 1217: @c Precede each symbol by the name of the input file (or archive member)
 1218: @c in which it was found, rather than identifying the input file once only,
 1219: @c before all of its symbols.
 1220: @c 
 1221: 入力ファイルの識別をそのすべてのシンボルの前に一度だけ前置するのではなく,
 1222: シンボルが見つかった入力ファイル(またはアーカイブメンバー)の名前をそれぞ
 1223: れのシンボルに前置します.
 1224: 
 1225: @item -a
 1226: @itemx --debug-syms 
 1227: @cindex debugging symbols
 1228: @c Display all symbols, even debugger-only symbols; normally these are not
 1229: @c listed.
 1230: @c 
 1231: すべてのシンボルを表示し,デバッグ専用のシンボルさえも表示します.通常は
 1232: リストアップされません.
 1233: 
 1234: @item -B
 1235: @cindex @command{nm} format
 1236: @cindex @command{nm} compatibility
 1237: @c The same as @option{--format=bsd} (for compatibility with the MIPS @command{nm}).
 1238: @c 
 1239: (MIPS @command{nm}との互換性のための)@option{--format=bsd}と同じです.
 1240: 
 1241: @item -C
 1242: @itemx --demangle[=@var{style}]
 1243: @cindex demangling in nm
 1244: @c Decode (@dfn{demangle}) low-level symbol names into user-level names.
 1245: @c Besides removing any initial underscore prepended by the system, this
 1246: @c makes C++ function names readable. Different compilers have different
 1247: @c mangling styles. The optional demangling style argument can be used to 
 1248: @c choose an appropriate demangling style for your compiler. @xref{c++filt}, 
 1249: @c for more information on demangling.
 1250: @c 
 1251: 低レベルのシンボル名をユーザレベルの名前に復号(@dfn{demangle})します.シ
 1252: ステムが前置する,最初のあらゆるアンダースコアを削除するだけでなく,これ
 1253: でC++関数名が読みやすくなります.異なるコンパイラでは,mangle形式が異な
 1254: ります.追加のdemangle形式の引数は,コンパイラに対する適切なdemangle形式
 1255: を選択するために使用可能です.demangleの情報は,@xref{c++filt}.
 1256: 
 1257: @item --no-demangle
 1258: @c Do not demangle low-level symbol names.  This is the default.
 1259: @c 
 1260: 低レベルのシンボル名をdemangleしません.これはデフォルトです.
 1261: 
 1262: @item -D
 1263: @itemx --dynamic
 1264: @cindex dynamic symbols
 1265: @c Display the dynamic symbols rather than the normal symbols.  This is
 1266: @c only meaningful for dynamic objects, such as certain types of shared
 1267: @c libraries.
 1268: @c 
 1269: 通常のシンボルではなく,動的シンボルを表示します.これは,共有ライブラリ
 1270: の特定の形式のような,動的オブジェクトに対してのみ意味があります.
 1271: 
 1272: @item -f @var{format}
 1273: @itemx --format=@var{format}
 1274: @cindex @command{nm} format
 1275: @cindex @command{nm} compatibility
 1276: @c Use the output format @var{format}, which can be @code{bsd},
 1277: @c @code{sysv}, or @code{posix}.  The default is @code{bsd}.
 1278: @c Only the first character of @var{format} is significant; it can be
 1279: @c either upper or lower case.
 1280: @c 
 1281: 出力書式@var{format}を使用し,書式は@code{bsd},@code{sysv},または
 1282: @code{posix}が可能です.デフォルトは@code{bsd}です.@var{format}の最初の
 1283: 文字のみ識別されます.それは大文字または小文字が可能です.
 1284: 
 1285: @item -g
 1286: @itemx --extern-only 
 1287: @cindex external symbols
 1288: @c Display only external symbols.
 1289: @c 
 1290: 外部シンボルのみ表示します.
 1291: 
 1292: @item -l
 1293: @itemx --line-numbers
 1294: @cindex symbol line numbers
 1295: @c For each symbol, use debugging information to try to find a filename and
 1296: @c line number.  For a defined symbol, look for the line number of the
 1297: @c address of the symbol.  For an undefined symbol, look for the line
 1298: @c number of a relocation entry which refers to the symbol.  If line number
 1299: @c information can be found, print it after the other symbol information.
 1300: @c 
 1301: それぞれのシンボルに対し,ファイル名と行番号を見つけることを試みるため,
 1302: デバッグ情報を使用します.定義済シンボルに対し,シンボルのアドレスの行番
 1303: 号を探します.未定義のシンボルに対し,シンボルを参照する再配置エントリー
 1304: の行番号を探します.行番号の情報が見つかる場合,それを他のシンボル情報の
 1305: 後に出力します.
 1306: 
 1307: @item -n
 1308: @itemx -v
 1309: @itemx --numeric-sort 
 1310: @c Sort symbols numerically by their addresses, rather than alphabetically
 1311: @c by their names. 
 1312: @c 
 1313: シンボルを,名前のアルファベット順ではなく,そのアドレスで数値的に並べ替
 1314: えます.
 1315: 
 1316: @item -p
 1317: @itemx --no-sort 
 1318: @cindex sorting symbols
 1319: @c Do not bother to sort the symbols in any order; print them in the order
 1320: @c encountered.
 1321: @c 
 1322: シンボルの並べ替えを全く行いません.それらを見つかった順番で出力します.
 1323: 
 1324: @item -P
 1325: @itemx --portability
 1326: @c Use the POSIX.2 standard output format instead of the default format.
 1327: @c Equivalent to @samp{-f posix}.
 1328: @c 
 1329: デフォルトの書式の代わりに,POSIX.2標準出力形式を使用します.@option{-f
 1330: posix}と同じです.
 1331: 
 1332: @item -S
 1333: @itemx --print-size
 1334: @c Print size of defined symbols for the @code{bsd} output format.
 1335: @c 
 1336: @code{bsd}出力書式に対し,定義されているシンボルのサイズを出力します.
 1337: 
 1338: @item -s
 1339: @itemx --print-armap
 1340: @cindex symbol index, listing
 1341: @c When listing symbols from archive members, include the index: a mapping
 1342: @c (stored in the archive by @command{ar} or @command{ranlib}) of which modules
 1343: @c contain definitions for which names.
 1344: @c 
 1345: アーカイブメンバーからシンボルをリストアップするとき,索引を含めます.名
 1346: 前に対する定義を含むモジュールの(@command{ar}や@command{ranlib}でアーカ
 1347: イブに保存されている)マップです.
 1348: 
 1349: @item -r
 1350: @itemx --reverse-sort 
 1351: @c Reverse the order of the sort (whether numeric or alphabetic); let the
 1352: @c last come first.
 1353: @c 
 1354: 並べ替えの順序を(数値的またはアルファベット順によらず)逆にします.最後の
 1355: ものを最初にします.
 1356: 
 1357: @item --size-sort
 1358: @c Sort symbols by size.  The size is computed as the difference between
 1359: @c the value of the symbol and the value of the symbol with the next higher
 1360: @c value.  The size of the symbol is printed, rather than the value.
 1361: @c 
 1362: シンボルを大きさで並べ替えます.大きさは,そのシンボル値と,次に現れるよ
 1363: り大きい値を持つシンボル値の差として計算されます.シンボル値ではなく,そ
 1364: の大きさが出力されます.
 1365: 
 1366: @item -t @var{radix}
 1367: @itemx --radix=@var{radix}
 1368: @c Use @var{radix} as the radix for printing the symbol values.  It must be
 1369: @c @samp{d} for decimal, @samp{o} for octal, or @samp{x} for hexadecimal.
 1370: @c 
 1371: @var{radix}をシンボル値を出力する基数として使用します.それは,10進数の
 1372: @samp{d},8進数の@samp{o},または16進数の@samp{x}にする必要があります.
 1373: 
 1374: @item --target=@var{bfdname}
 1375: @cindex object code format
 1376: @c Specify an object code format other than your system's default format.
 1377: @c @xref{Target Selection}, for more information.
 1378: @c 
 1379: システムのデフォルトフォーマット以外のオブジェクトコードを指定します.詳
 1380: 細は,@xref{Target Selection}.
 1381: 
 1382: @item -u
 1383: @itemx --undefined-only 
 1384: @cindex external symbols
 1385: @cindex undefined symbols
 1386: @c Display only undefined symbols (those external to each object file).
 1387: @c 
 1388: 未定義のシンボルのみ表示します(それらはそれぞれのオブジェクトファイルの
 1389: 外部にあります).
 1390: 
 1391: @item --defined-only
 1392: @cindex external symbols
 1393: @cindex undefined symbols
 1394: @c Display only defined symbols for each object file.
 1395: @c 
 1396: それぞれのオブジェクトファイルの定義済シンボルのみ表示します.
 1397: 
 1398: @item -V
 1399: @itemx --version
 1400: @c Show the version number of @command{nm} and exit.
 1401: @c 
 1402: @command{nm}のバージョンナンバーを表示し終了します.
 1403: 
 1404: @item -X
 1405: @c This option is ignored for compatibility with the AIX version of
 1406: @c @command{nm}.  It takes one parameter which must be the string
 1407: @c @option{32_64}.  The default mode of AIX @command{nm} corresponds
 1408: @c to @option{-X 32}, which is not supported by @sc{gnu} @command{nm}.
 1409: @c 
 1410: このオプションは,AIXバージョンの@command{nm}への互換性のため無視されま
 1411: す.それは,@option{32_64}とする必要がある,一つのパラメータを持ちます.
 1412: AIX @command{nm}のデフォルトモードは@option{-X 32}に対応し,それは
 1413: @sc{gnu} @command{nm}ではサポートされていません.
 1414: 
 1415: @item --help
 1416: @c Show a summary of the options to @command{nm} and exit.
 1417: @c 
 1418: @command{nm}のオプションの概要を表示し終了します.
 1419: @end table
 1420: 
 1421: @c man end
 1422: 
 1423: @ignore
 1424: @c man begin SEEALSO nm
 1425: ar(1), objdump(1), ranlib(1), and the Info entries for @file{binutils}.
 1426: @c man end
 1427: @end ignore
 1428: 
 1429: @node objcopy
 1430: @chapter objcopy
 1431: 
 1432: @c man title objcopy copy and translate object files
 1433: 
 1434: @smallexample
 1435: @c man begin SYNOPSIS objcopy
 1436: objcopy [@option{-F} @var{bfdname}|@option{--target=}@var{bfdname}]
 1437:         [@option{-I} @var{bfdname}|@option{--input-target=}@var{bfdname}]
 1438:         [@option{-O} @var{bfdname}|@option{--output-target=}@var{bfdname}]
 1439:         [@option{-B} @var{bfdarch}|@option{--binary-architecture=}@var{bfdarch}]
 1440:         [@option{-S}|@option{--strip-all}] [@option{-g}|@option{--strip-debug}]
 1441:         [@option{-K} @var{symbolname}|@option{--keep-symbol=}@var{symbolname}]
 1442:         [@option{-N} @var{symbolname}|@option{--strip-symbol=}@var{symbolname}]
 1443:         [@option{-G} @var{symbolname}|@option{--keep-global-symbol=}@var{symbolname}]
 1444:         [@option{-L} @var{symbolname}|@option{--localize-symbol=}@var{symbolname}]
 1445:         [@option{-W} @var{symbolname}|@option{--weaken-symbol=}@var{symbolname}]
 1446:         [@option{-x}|@option{--discard-all}] [@option{-X}|@option{--discard-locals}]
 1447:         [@option{-b} @var{byte}|@option{--byte=}@var{byte}]
 1448:         [@option{-i} @var{interleave}|@option{--interleave=}@var{interleave}]
 1449:         [@option{-j} @var{sectionname}|@option{--only-section=}@var{sectionname}]
 1450:         [@option{-R} @var{sectionname}|@option{--remove-section=}@var{sectionname}]
 1451:         [@option{-p}|@option{--preserve-dates}]
 1452:         [@option{--debugging}]
 1453:         [@option{--gap-fill=}@var{val}] [@option{--pad-to=}@var{address}]
 1454:         [@option{--set-start=}@var{val}] [@option{--adjust-start=}@var{incr}]
 1455:         [@option{--change-addresses=}@var{incr}]
 1456:         [@option{--change-section-address} @var{section}@{=,+,-@}@var{val}]
 1457:         [@option{--change-section-lma} @var{section}@{=,+,-@}@var{val}]
 1458:         [@option{--change-section-vma} @var{section}@{=,+,-@}@var{val}]
 1459:         [@option{--change-warnings}] [@option{--no-change-warnings}]
 1460:         [@option{--set-section-flags} @var{section}=@var{flags}]
 1461:         [@option{--add-section} @var{sectionname}=@var{filename}]
 1462:         [@option{--rename-section} @var{oldname}=@var{newname}[,@var{flags}]]
 1463:         [@option{--change-leading-char} ] [@option{--remove-leading-char}]
 1464:         [@option{--srec-len=}@var{ival} ] [@option{--srec-forceS3}]
 1465:         [@option{--redefine-sym} @var{old}=@var{new} ]
 1466:         [@option{--weaken}]
 1467:         [@option{--keep-symbols=}@var{filename}]
 1468:         [@option{--strip-symbols=}@var{filename}]
 1469:         [@option{--keep-global-symbols=}@var{filename}]
 1470:         [@option{--localize-symbols=}@var{filename}]
 1471:         [@option{--weaken-symbols=}@var{filename}]
 1472:         [@option{--alt-machine-code=@var{index}}]
 1473:         [@option{-v}|@option{--verbose}]
 1474:         [@option{-V}|@option{--version}]  
 1475:         [@option{--help}]
 1476:         @var{infile} [@var{outfile}]
 1477: @c man end
 1478: @end smallexample
 1479: 
 1480: @c man begin DESCRIPTION objcopy
 1481: @c The @sc{gnu} @command{objcopy} utility copies the contents of an object
 1482: @c file to another.  @command{objcopy} uses the @sc{gnu} @sc{bfd} Library to
 1483: @c read and write the object files.  It can write the destination object
 1484: @c file in a format different from that of the source object file.  The
 1485: @c exact behavior of @command{objcopy} is controlled by command-line options.
 1486: @c Note that @command{objcopy} should be able to copy a fully linked file
 1487: @c between any two formats. However, copying a relocatable object file
 1488: @c between any two formats may not work as expected.
 1489: @c 
 1490: @sc{gnu} @command{objcopy}ユーティリティは,オブジェクトファイルの内容を
 1491: 別のファイルにコピーします.@command{objcopy}はオブジェクトファイルの読
 1492: み書きに@sc{gnu} @sc{bfd}を使用します.コピー先のオブジェクトファイルに,
 1493: コピー元のオブジェクトファイルとは異なるフォーマットで書き出すことが可能
 1494: です.@command{objcopy}の正確な動作は,コマンドラインオプションで制御さ
 1495: れます.@command{objcopy}は,完全にリンクされているファイルを,二つの書
 1496: 式間でコピー可能であるべきだということに注意してください.しかし,再配置
 1497: 可能なオブジェクトファイルを二つのフォーマットの間でコピーすることは,期
 1498: 待したようには動作しません.
 1499: 
 1500: @c @command{objcopy} creates temporary files to do its translations and
 1501: @c deletes them afterward.  @command{objcopy} uses @sc{bfd} to do all its
 1502: @c translation work; it has access to all the formats described in @sc{bfd}
 1503: @c and thus is able to recognize most formats without being told
 1504: @c explicitly.  @xref{BFD,,BFD,ld.info,Using LD}.
 1505: @c 
 1506: @command{objcopy}は,その変換を行うために一時ファイルを作成し,その後で
 1507: それを削除します.@command{objcopy}は,そのすべての変換作業で@sc{bfd}を
 1508: 使用します.それは,@sc{bfd}で記述されているすべてのフォーマットにアクセ
 1509: スするので,明示的に伝えること無く,ほとんどのフォーマットを認識すること
 1510: が可能です.@xref{BFD,,BFD,ld.info,Using LD}.
 1511: 
 1512: @c @command{objcopy} can be used to generate S-records by using an output
 1513: @c target of @samp{srec} (e.g., use @samp{-O srec}).
 1514: @c 
 1515: @command{objcopy}は,@samp{srec}出力ターゲットを使用することで,S-record
 1516: を生成するために使用可能です(例えば,@option{-O srec}を使用してください).
 1517: 
 1518: @c @command{objcopy} can be used to generate a raw binary file by using an
 1519: @c output target of @samp{binary} (e.g., use @option{-O binary}).  When
 1520: @c @command{objcopy} generates a raw binary file, it will essentially produce
 1521: @c a memory dump of the contents of the input object file.  All symbols and
 1522: @c relocation information will be discarded.  The memory dump will start at
 1523: @c the load address of the lowest section copied into the output file.
 1524: @c 
 1525: @command{objcopy}は,@samp{binary}の出力ターゲットを使用することで,生の
 1526: バイナリファイルを生成するために使用可能です(例えば,@option{-O binary} 
 1527: を使用してください).@command{objcopy}が生のバイナリファイルを生成すると
 1528: き,それは本質的に,入力オブジェクトファイルの内容のメモリダンプを生成し
 1529: ます.すべてのシンボルと再配置の情報は削除されます.メモリダンプは,出力
 1530: ファイルにコピーされる最抵位のセクションのロードアドレスから開始します.
 1531: 
 1532: @c When generating an S-record or a raw binary file, it may be helpful to
 1533: @c use @option{-S} to remove sections containing debugging information.  In
 1534: @c some cases @option{-R} will be useful to remove sections which contain
 1535: @c information that is not needed by the binary file.
 1536: @c 
 1537: S-recordや生のバイナリファイルを生成するとき,デバッグ情報を含むセクショ
 1538: ンを削除するため,@option{-S}を使用すると便利かもしれません.場合によっ
 1539: ては,バイナリファイルに必要のない情報を含むセクションを削除するため,
 1540: @option{-R}が役に立つでしょう.
 1541: 
 1542: @c Note - @command{objcopy} is not able to change the endianness of its input
 1543: @c files.  If the input format has an endianness, (some formats do not),
 1544: @c @command{objcopy} can only copy the inputs into file formats that have the
 1545: @c same endianness or which have no endianness (eg @samp{srec}).
 1546: @c 
 1547: 注意 - @command{objcopy}は,入力ファイルのエンディアンを変更することがで
 1548: きません.入力フォーマットにエンディアンがある場合,(持たないフォーマッ
 1549: トもあります),@command{objcopy}は,入力ファイルを同じエンディアンを持つ,
 1550: またはエンディアンを持たないフォーマットのファイル(例えば@samp{srec})に
 1551: のみコピー可能です.
 1552: 
 1553: @c man end
 1554: 
 1555: @c man begin OPTIONS objcopy
 1556: 
 1557: @table @env
 1558: @item @var{infile}
 1559: @itemx @var{outfile}
 1560: @c The input and output files, respectively.
 1561: @c If you do not specify @var{outfile}, @command{objcopy} creates a
 1562: @c temporary file and destructively renames the result with
 1563: @c the name of @var{infile}.
 1564: @c 
 1565: それぞれ入力と出力のファイルです.@var{outfile}を指定しない場合,
 1566: @command{objcopy}は結果的に破壊される一時ファイルを作成し,@var{infile}
 1567: に名前を変更します.
 1568: 
 1569: @item -I @var{bfdname}
 1570: @itemx --input-target=@var{bfdname}
 1571: @c Consider the source file's object format to be @var{bfdname}, rather than
 1572: @c attempting to deduce it.  @xref{Target Selection}, for more information.
 1573: @c 
 1574: ソースファイルのオブジェクトのフォーマットを,それを導き出すのではなく,
 1575: @var{bfdname}と考えます.詳細は,@xref{Target Selection}.
 1576: 
 1577: @item -O @var{bfdname}
 1578: @itemx --output-target=@var{bfdname}
 1579: @c Write the output file using the object format @var{bfdname}.
 1580: @c @xref{Target Selection}, for more information.
 1581: @c 
 1582: 出力ファイルを,オブジェクトファイルのフォーマット@var{bfdname}を用いて
 1583: 書き出します.詳細は,@xref{Target Selection}.
 1584: 
 1585: @item -F @var{bfdname}
 1586: @itemx --target=@var{bfdname}
 1587: @c Use @var{bfdname} as the object format for both the input and the output
 1588: @c file; i.e., simply transfer data from source to destination with no
 1589: @c translation.  @xref{Target Selection}, for more information.
 1590: @c 
 1591: 入出力両方のファイルに対し,オブジェクトのフォーマットとして
 1592: @var{bfdname}を使用します.すなわち,単純に元ファイルから目的ファイルに,
 1593: 変換せずにデータを転送します.詳細は,@xref{Target Selection}.
 1594: 
 1595: @item -B @var{bfdarch}
 1596: @itemx --binary-architecture=@var{bfdarch}
 1597: @c Useful when transforming a raw binary input file into an object file.
 1598: @c In this case the output architecture can be set to @var{bfdarch}. This
 1599: @c option will be ignored if the input file has a known @var{bfdarch}. You
 1600: @c can access this binary data inside a program by referencing the special
 1601: @c symbols that are created by the conversion process.  These symbols are
 1602: @c called _binary_@var{objfile}_start, _binary_@var{objfile}_end and
 1603: @c _binary_@var{objfile}_size.  e.g. you can transform a picture file into
 1604: @c an object file and then access it in your code using these symbols. 
 1605: @c 
 1606: 生の入力ファイルをオブジェクトファイルに変換するとき役に立ちます.この状
 1607: 況では,出力先のアーキテクチャは@var{bfdarch}に設定されるはずです.入力
 1608: ファイルに既知の@var{bfdarch}がある場合,このオプションは無視されます.
 1609: 変換処理で作成される特殊なシンボルで参照することで,このバイナリデータを
 1610: プログラム内部でアクセスすることが可能です.これらのシンボルは,
 1611: @samp{_binary_@var{objfile}_start},@samp{_binary_@var{objfile}_end},そ
 1612: して@samp{_binary_@var{objfile}_size}という名前です.例えば,画像ファイ
 1613: ルをオブジェクトファイルに変換した後,これらのシンボルを使用してコード内
 1614: でアクセスすることが可能です.
 1615: 
 1616: @item -j @var{sectionname}
 1617: @itemx --only-section=@var{sectionname}
 1618: @c Copy only the named section from the input file to the output file.
 1619: @c This option may be given more than once.  Note that using this option
 1620: @c inappropriately may make the output file unusable.
 1621: @c 
 1622: 指名されたセクションのみ,入力ファイルから出力ファイルへコピーします.こ
 1623: のオプションは,一回以上与えてもかまいません.このオプションを不適切に使
 1624: 用すると,出力ファイルが使用不可能になることに注意してください.
 1625: 
 1626: @item -R @var{sectionname}
 1627: @itemx --remove-section=@var{sectionname}
 1628: @c Remove any section named @var{sectionname} from the output file.  This
 1629: @c option may be given more than once.  Note that using this option
 1630: @c inappropriately may make the output file unusable.
 1631: @c 
 1632: 指名されている,あらゆる@var{sectionname}セクションを出力ファイルから削
 1633: 除します.このオプションは,一回以上与えてもかまいません.このオプション
 1634: を不適切に使用すると,出力ファイルが使用不可能になることに注意してくださ
 1635: い.
 1636: 
 1637: @item -S
 1638: @itemx --strip-all
 1639: @c Do not copy relocation and symbol information from the source file.
 1640: @c 
 1641: 再配置の情報ととシンボルの情報を,ソースファイルからコピーしません.
 1642: 
 1643: @item -g
 1644: @itemx --strip-debug
 1645: @c Do not copy debugging symbols from the source file.
 1646: @c 
 1647: デバッグシンボルをソースファイルからコピーしません.
 1648: 
 1649: @item --strip-unneeded
 1650: @c Strip all symbols that are not needed for relocation processing.
 1651: @c 
 1652: 再配置の処理に不要な,すべてのシンボルを削除します.
 1653: 
 1654: @item -K @var{symbolname}
 1655: @itemx --keep-symbol=@var{symbolname}
 1656: @c Copy only symbol @var{symbolname} from the source file.  This option may
 1657: @c be given more than once.
 1658: @c 
 1659: ソースファイルからシンボル@var{symbolname}のみコピーします.このオプショ
 1660: ンは,一回以上与えてもかまいません.
 1661: 
 1662: @item -N @var{symbolname}
 1663: @itemx --strip-symbol=@var{symbolname}
 1664: @c Do not copy symbol @var{symbolname} from the source file.  This option
 1665: @c may be given more than once.
 1666: @c 
 1667: ソースファイルからシンボル@var{symbolname}をコピーしません.このオプショ
 1668: ンは,一回以上与えてもかまいません.
 1669: 
 1670: @item -G @var{symbolname}
 1671: @itemx --keep-global-symbol=@var{symbolname}
 1672: @c Keep only symbol @var{symbolname} global.  Make all other symbols local
 1673: @c to the file, so that they are not visible externally.  This option may
 1674: @c be given more than once.
 1675: @c 
 1676: グローバルな@var{symbolname}シンボルのみ保ちます.すべての他のシンボルを
 1677: それらが外部から見えないようにファイルローカルにします.このオプションは
 1678: 一回以上与えてもかまいません.
 1679: 
 1680: @item -L @var{symbolname}
 1681: @itemx --localize-symbol=@var{symbolname}
 1682: @c Make symbol @var{symbolname} local to the file, so that it is not
 1683: @c visible externally.  This option may be given more than once.
 1684: @c 
 1685: 外部から見えないようにするため,シンボル@var{symbolname}をファイルでロー
 1686: カルにします.このオプションは,一回以上与えてもかまいません.
 1687: 
 1688: @item -W @var{symbolname}
 1689: @itemx --weaken-symbol=@var{symbolname}
 1690: @c Make symbol @var{symbolname} weak. This option may be given more than once.
 1691: @c 
 1692: シンボル@var{symbolname}をweakにします.このオプションは,一回以上与えて
 1693: もかまいません.
 1694: 
 1695: @item -x
 1696: @itemx --discard-all
 1697: @c Do not copy non-global symbols from the source file.
 1698: @c 
 1699: ソースファイルからグローバルでないシンボルをコピーしません.
 1700: @c FIXME any reason to prefer "non-global" to "local" here?
 1701: 
 1702: @item -X
 1703: @itemx --discard-locals
 1704: @c Do not copy compiler-generated local symbols.
 1705: @c (These usually start with @samp{L} or @samp{.}.)
 1706: @c 
 1707: コンパイラが生成したローカルなシンボルをコピーしません.(これらは通常,
 1708: @samp{L}または@samp{.}ではじまります.)
 1709: 
 1710: @item -b @var{byte}
 1711: @itemx --byte=@var{byte}
 1712: @c Keep only every @var{byte}th byte of the input file (header data is not
 1713: @c affected).  @var{byte} can be in the range from 0 to @var{interleave}-1,
 1714: @c where @var{interleave} is given by the @option{-i} or @option{--interleave}
 1715: @c option, or the default of 4.  This option is useful for creating files
 1716: @c to program @sc{rom}.  It is typically used with an @code{srec} output
 1717: @c target.
 1718: @c 
 1719: 入力ファイルの@var{byte}バイト毎のバイトのみ保持します(ヘッダデータは影
 1720: 響されません).@var{byte}は,0から@var{interleave}-1までの範囲が可能で,
 1721: @var{interleave}は,@option{-i}や@option{--interleave}オプションで与えら
 1722: れる,またはデフォルトの4になります.このオプションは,プログラマブル
 1723: @sc{rom}にファイルを作成するとき便利です.それは特に,@code{srec}出力ター
 1724: ゲットとともに使用されます.
 1725: 
 1726: @item -i @var{interleave}
 1727: @itemx --interleave=@var{interleave}
 1728: @c Only copy one out of every @var{interleave} bytes.  Select which byte to
 1729: @c copy with the @option{-b} or @option{--byte} option.  The default is 4.
 1730: @c @command{objcopy} ignores this option if you do not specify either @option{-b} or
 1731: @c @option{--byte}.
 1732: @c 
 1733: @var{interleave}バイト毎に一つのみコピーします.@option{-b}や
 1734: @option{--byte}オプションを用いてそのバイトを選択してください.デフォル
 1735: トは4です.@command{objcopy}は,@option{-b}や@option{--byte}を指定してい
 1736: ない場合,このオプションを無視します.
 1737: 
 1738: @item -p
 1739: @itemx --preserve-dates
 1740: @c Set the access and modification dates of the output file to be the same
 1741: @c as those of the input file.
 1742: @c 
 1743: 出力ファイルのアクセスと編集の日付を入力ファイルと同じに設定します.
 1744: 
 1745: @item --debugging
 1746: @c Convert debugging information, if possible.  This is not the default
 1747: @c because only certain debugging formats are supported, and the
 1748: @c conversion process can be time consuming.
 1749: @c 
 1750: 可能な場合,デバッグ情報を変換します.特定のデバッグフォーマットのみサポー
 1751: トされていて,そして,変換処理は時間がかかるため,これはデフォルトではあ
 1752: りません.
 1753: 
 1754: @item --gap-fill @var{val}
 1755: @c Fill gaps between sections with @var{val}.  This operation applies to
 1756: @c the @emph{load address} (LMA) of the sections.  It is done by increasing
 1757: @c the size of the section with the lower address, and filling in the extra
 1758: @c space created with @var{val}.
 1759: @c 
 1760: @var{val}を用いてセクション間のギャップを補充します.このオプションはセ
 1761: クションの@emph{load address} (LMA)に適用されます.それは,低いアドレス
 1762: @footnote{訳注:原文は lower address.}でセクションの大きさを増加し,そ
 1763: して,@var{val}を用いて作成される余分な空間で補充することで動作します.
 1764: 
 1765: @item --pad-to @var{address}
 1766: @c Pad the output file up to the load address @var{address}.  This is
 1767: @c done by increasing the size of the last section.  The extra space is
 1768: @c filled in with the value specified by @option{--gap-fill} (default zero).
 1769: @c 
 1770: 出力ファイルをload address @var{address}までパディングします.これは,最
 1771: 後のセクションの大きさを増加することで動作します.余分な空間は,
 1772: @option{--gap-fill}で指定された値(デフォルトはゼロ)で補充されます.
 1773: 
 1774: @item --set-start @var{val}
 1775: @c Set the start address of the new file to @var{val}.  Not all object file
 1776: @c formats support setting the start address.
 1777: @c 
 1778: 新しいファイルの開始アドレスを@var{val}に設定します.すべてのオブジェク
 1779: トファイルのフォーマットが,開始アドレスの設定をサポートするわけではあり
 1780: ません.
 1781: 
 1782: @item --change-start @var{incr}
 1783: @itemx --adjust-start @var{incr}
 1784: @cindex changing start address
 1785: @c Change the start address by adding @var{incr}.  Not all object file
 1786: @c formats support setting the start address.
 1787: @c 
 1788: 開始アドレスを@var{incr}を加えることで変更します.すべてのオブジェクトファ
 1789: イルのフォーマットが,開始アドレスの設定をサポートするわけではありません.
 1790: 
 1791: @item --change-addresses @var{incr}
 1792: @itemx --adjust-vma @var{incr}
 1793: @cindex changing object addresses
 1794: @c Change the VMA and LMA addresses of all sections, as well as the start
 1795: @c address, by adding @var{incr}.  Some object file formats do not permit
 1796: @c section addresses to be changed arbitrarily.  Note that this does not
 1797: @c relocate the sections; if the program expects sections to be loaded at a
 1798: @c certain address, and this option is used to change the sections such
 1799: @c that they are loaded at a different address, the program may fail. 
 1800: @c 
 1801: 開始アドレスのように,@var{incr}を加えることで,VMAとLMAアドレスを変更し
 1802: ます.オブジェクトファイルのフォーマットによっては,セクションアドレスを
 1803: 任意に変更できないものもあります.これはセクションを再配置しないことに注
 1804: 意してください.セクションが特定のアドレスにロードされていることをプログ
 1805: ラムが期待し,セクションが異なるアドレスにロードされるように変更するため
 1806: に,このオプションが使用された場合,プログラムは失敗するかもしれません.
 1807: 
 1808: @item --change-section-address @var{section}@{=,+,-@}@var{val}
 1809: @itemx --adjust-section-vma @var{section}@{=,+,-@}@var{val}
 1810: @cindex changing section address
 1811: @c Set or change both the VMA address and the LMA address of the named
 1812: @c @var{section}.  If @samp{=} is used, the section address is set to
 1813: @c @var{val}.  Otherwise, @var{val} is added to or subtracted from the
 1814: @c section address.  See the comments under @option{--change-addresses},
 1815: @c above. If @var{section} does not exist in the input file, a warning will
 1816: @c be issued, unless @option{--no-change-warnings} is used.
 1817: @c 
 1818: @var{section}で指名されたVMAアドレスとLMAアドレスの両方を設定または変更
 1819: します.@samp{=}が使用された場合,セクションのアドレスは,@var{val}に設
 1820: 定されます.それ以外の場合,@var{val}は,セクションアドレスに加えられる,
 1821: またはそれから引かれます.上記の@option{--change-addresses}以下のコメン
 1822: トを参照してください.入力ファイルに@var{section}が存在しない場合,
 1823: @option{--no-change-warnings}が使用されていない限り,警告が発せられます.
 1824: 
 1825: @item --change-section-lma @var{section}@{=,+,-@}@var{val}
 1826: @cindex changing section LMA
 1827: @c Set or change the LMA address of the named @var{section}.  The LMA
 1828: @c address is the address where the section will be loaded into memory at
 1829: @c program load time.  Normally this is the same as the VMA address, which
 1830: @c is the address of the section at program run time, but on some systems,
 1831: @c especially those where a program is held in ROM, the two can be
 1832: @c different.  If @samp{=} is used, the section address is set to
 1833: @c @var{val}.  Otherwise, @var{val} is added to or subtracted from the
 1834: @c section address.  See the comments under @option{--change-addresses},
 1835: @c above.  If @var{section} does not exist in the input file, a warning
 1836: @c will be issued, unless @option{--no-change-warnings} is used.  
 1837: @c 
 1838: 指名された@var{section}のLMAアドレスを設定または変更します.LMAアドレス
 1839: は,プログラムロード時にセクションがメモリにロードされるアドレスです.通
 1840: 常これはVMAと同じで,それは,プログラムの実行時のセクションのアドレスで
 1841: すが,システムによっては,特にプログラムがROMに保存されるものでは,二つ
 1842: が異なる可能性があります.@samp{=}が使用されている場合,セクションのアド
 1843: レスは,@var{val}に設定されます.それ以外の場合,@var{val}はセクションア
 1844: ドレスに加えられる,またはそれから引かれます.上記の
 1845: @option{--change-addresses}以下のコメントを参照してください.
 1846: @var{section} が入力ファイルに存在しない場合,
 1847: @option{--no-change-warnings}が使用されていない限り,警告が発せられます.
 1848: 
 1849: @item --change-section-vma @var{section}@{=,+,-@}@var{val}
 1850: @cindex changing section VMA
 1851: @c Set or change the VMA address of the named @var{section}.  The VMA
 1852: @c address is the address where the section will be located once the
 1853: @c program has started executing.  Normally this is the same as the LMA
 1854: @c address, which is the address where the section will be loaded into
 1855: @c memory, but on some systems, especially those where a program is held in
 1856: @c ROM, the two can be different.  If @samp{=} is used, the section address
 1857: @c is set to @var{val}.  Otherwise, @var{val} is added to or subtracted
 1858: @c from the section address.  See the comments under
 1859: @c @option{--change-addresses}, above.  If @var{section} does not exist in
 1860: @c the input file, a warning will be issued, unless
 1861: @c @option{--no-change-warnings} is used.   
 1862: @c 
 1863: 指名された@var{section}のVMAアドレスを設定または変更します.VMAアドレス
 1864: は,プログラムの実行を開始したときにセクションが位置するアドレスです.通
 1865: 常これはLMAと同じで,それは,セクションがメモリにロードされるアドレスで
 1866: すが,システムによっては,特にプログラムがROMに保存されるものでは,二つ
 1867: のアドレスが異なる可能性があります.@samp{=}が使用されている場合,セクショ
 1868: ンのアドレスは,@var{val}に設定されます.それ以外の場合,@var{val}はセク
 1869: ションアドレスに加えられる,またはそれから引かれます.上記の
 1870: @option{--change-addresses}以下のコメントを参照してください.
 1871: @var{section}が入力ファイルに存在しない場合,
 1872: @option{--no-change-warnings}が使用されていない限り,警告が発せられます.
 1873: 
 1874: @item --change-warnings
 1875: @itemx --adjust-warnings
 1876: @c If @option{--change-section-address} or @option{--change-section-lma} or
 1877: @c @option{--change-section-vma} is used, and the named section does not
 1878: @c exist, issue a warning.  This is the default. 
 1879: @c 
 1880: @option{--change-section-address}や@option{--change-section-lma}や
 1881: @option{--change-section-vma}が使用されていて,指名されたセクションが存
 1882: 在しない場合,警告を発します.これはデフォルトです.
 1883: 
 1884: @item --no-change-warnings
 1885: @itemx --no-adjust-warnings
 1886: @c Do not issue a warning if @option{--change-section-address} or
 1887: @c @option{--adjust-section-lma} or @option{--adjust-section-vma} is used, even
 1888: @c if the named section does not exist. 
 1889: @c 
 1890: @option{--change-section-address}や@option{--change-section-lma}や
 1891: @option{--change-section-vma}が使用されていて,指名されたセクションが存
 1892: 在しない場合でも警告を発しません.
 1893: 
 1894: @item --set-section-flags @var{section}=@var{flags}
 1895: @c Set the flags for the named section.  The @var{flags} argument is a
 1896: @c comma separated string of flag names.  The recognized names are
 1897: @c @samp{alloc}, @samp{contents}, @samp{load}, @samp{noload},
 1898: @c @samp{readonly}, @samp{code}, @samp{data}, @samp{rom}, @samp{share}, and
 1899: @c @samp{debug}.  You can set the @samp{contents} flag for a section which
 1900: @c does not have contents, but it is not meaningful to clear the
 1901: @c @samp{contents} flag of a section which does have contents--just remove
 1902: @c the section instead.  Not all flags are meaningful for all object file
 1903: @c formats.
 1904: @c 
 1905: 指名したセクションのフラグを設定します.@var{flags}引数は,カンマで分け
 1906: られたフラグ名の文字列です.認識される名前は,@samp{alloc},
 1907: @samp{contents},@samp{load},@samp{noload},@samp{readonly},
 1908: @samp{code},@samp{data},@samp{rom},@samp{share},そして@samp{debug}で
 1909: す.@samp{contents}フラグを内容のないセクションに対し設定可能ですが,内
 1910: 容のあるセクションの@samp{contents}フラグとしての意味がありません --- そ
 1911: の代わりにセクションを削除します.すべてのフラグがすべてのオブジェクトファ
 1912: イルのフォーマットに意味があるわけではありません.
 1913: 
 1914: @item --add-section @var{sectionname}=@var{filename}
 1915: @c Add a new section named @var{sectionname} while copying the file.  The
 1916: @c contents of the new section are taken from the file @var{filename}.  The
 1917: @c size of the section will be the size of the file.  This option only
 1918: @c works on file formats which can support sections with arbitrary names.
 1919: @c 
 1920: ファイルをコピーしている間に,指名された@var{sectionname}の新しいセクショ
 1921: ンを追加します.新しいセクションの内容はファイル@var{filename}からもたら
 1922: されます.セクションの大きさは,ファイルのサイズになります.このオプショ
 1923: ンは,任意の名前を持つセクションをサポート可能なファイルのフォーマットで
 1924: のみ動作します.
 1925: 
 1926: @item --rename-section @var{oldname}=@var{newname}[,@var{flags}]
 1927: @c Rename a section from @var{oldname} to @var{newname}, optionally
 1928: @c changing the section's flags to @var{flags} in the process.  This has
 1929: @c the advantage over usng a linker script to perform the rename in that
 1930: @c the output stays as an object file and does not become a linked
 1931: @c executable.
 1932: @c 
 1933: セクションの名前を@var{oldname}から@var{newname}に変更し,オプションでセ
 1934: クションのフラグを@var{flags}に,処理中に変更します.名前の変更を実行す
 1935: るためにリンカスクリプトを使用すると,オブジェクトファイルとして出力が抑
 1936: 制されリンクされた実行形式にはならないので,これには利点があります.
 1937: 
 1938: @c This option is particularly helpful when the input format is binary,
 1939: @c since this will always create a section called .data.  If for example,
 1940: @c you wanted instead to create a section called .rodata containing binary
 1941: @c data you could use the following command line to achieve it:
 1942: @c 
 1943: このオプションは,@samp{.data}いう名前のセクションを常に作成するので,入
 1944: 力フォーマットがバイナリのとき,特に役に立ちます.例えば,バイナリデータ
 1945: を含んでいる@samp{.rodata}いう名前のセクションを作成したい場合,それを達
 1946: 成するために以下のコマンドラインを使用することが可能でしょう.
 1947: 
 1948: @smallexample
 1949:   objcopy -I binary -O <output_format> -B <architecture> \
 1950:    --rename-section .data=.rodata,alloc,load,readonly,data,contents \
 1951:    <input_binary_file> <output_object_file>
 1952: @end smallexample
 1953: 
 1954: @item --change-leading-char
 1955: @c Some object file formats use special characters at the start of
 1956: @c symbols.  The most common such character is underscore, which compilers
 1957: @c often add before every symbol.  This option tells @command{objcopy} to
 1958: @c change the leading character of every symbol when it converts between
 1959: @c object file formats.  If the object file formats use the same leading
 1960: @c character, this option has no effect.  Otherwise, it will add a
 1961: @c character, or remove a character, or change a character, as
 1962: @c appropriate.
 1963: @c 
 1964: オブジェクトファイルのフォーマットには,シンボルの開始時に特別な文字を使
 1965: 用するものもあります.そのような文字で最もよくあるのはアンダースコアで,
 1966: それはコンパイラがすべてのシンボルの前によく追加するものです.このオプショ
 1967: ンは,@command{objcopy}に,オブジェクトファイルのフォーマットを変換して
 1968: いる間にすべてのシンボルに前置される文字を変更するよう伝えます.オブジェ
 1969: クトファイルのフォーマットが同じ前置文字を使用している場合,このオプショ
 1970: ンは効果がありません.それ以外の場合,それは適切に,文字を加えたり,文字
 1971: を削除したり,文字を変更したりします.
 1972: 
 1973: @item --remove-leading-char
 1974: @c If the first character of a global symbol is a special symbol leading
 1975: @c character used by the object file format, remove the character.  The
 1976: @c most common symbol leading character is underscore.  This option will
 1977: @c remove a leading underscore from all global symbols.  This can be useful
 1978: @c if you want to link together objects of different file formats with
 1979: @c different conventions for symbol names.  This is different from
 1980: @c @option{--change-leading-char} because it always changes the symbol name
 1981: @c when appropriate, regardless of the object file format of the output
 1982: @c file.
 1983: @c 
 1984: グローバルシンボルの最初の文字が,オブジェクトファイルのフォーマットで使
 1985: 用されているシンボルに前置される特殊な文字の場合,その文字を削除します.
 1986: そのような文字で最もよくあるのはアンダースコアです.このオプションは,す
 1987: べてのグローバルシンボルから前置されるアンダースコアを削除します.シンボ
 1988: ル名に対して異なる規則を持つ,異なるファイルフォーマットのオブジェクト同
 1989: 士をリンクしたい場合,これは役に立つはずです.これは
 1990: @option{--change-leading-char}とは異なり,出力ファイルのオブジェクトファ
 1991: イルのフォーマットに依存せず,それは適切なときは常にシンボル名を変更しま
 1992: す.
 1993: 
 1994: @item --srec-len=@var{ival}
 1995: @c Meaningful only for srec output.  Set the maximum length of the Srecords
 1996: @c being produced to @var{ival}.  This length covers both address, data and
 1997: @c crc fields.
 1998: @c 
 1999: srec出力でのみ意味があります.生成されているSrecordの最大長を@var{ival} 
 2000: に設定します.この長さは,両方のアドレス,データ,そしてcrcフィールドを
 2001: カバーします.
 2002: 
 2003: @item --srec-forceS3
 2004: @c Meaningful only for srec output.  Avoid generation of S1/S2 records, 
 2005: @c creating S3-only record format.
 2006: @c 
 2007: srec出力でのみ意味があります.S1/S2レコードの生成を避け,S3のみのレコー
 2008: ドのフォーマットを作成します.
 2009: 
 2010: @item --redefine-sym @var{old}=@var{new}
 2011: @c Change the name of a symbol @var{old}, to @var{new}.  This can be useful
 2012: @c when one is trying link two things together for which you have no
 2013: @c source, and there are name collisions.
 2014: @c 
 2015: シンボル名を@var{old}から@var{new}に変更します.ソースを持っていない二つ
 2016: のものを一緒にリンクしようとし,名前の衝突があるとき便利です.
 2017: 
 2018: @item --weaken
 2019: @c Change all global symbols in the file to be weak.  This can be useful
 2020: @c when building an object which will be linked against other objects using
 2021: @c the @option{-R} option to the linker.  This option is only effective when
 2022: @c using an object file format which supports weak symbols.
 2023: @c 
 2024: ファイルのすべてのグローバルシンボルをweakにします.リンカに対し
 2025: @option{-R}オプションを使用している他のオブジェクトに対してリンクするオ
 2026: ブジェクトを構築するとき,これは便利です.このオプションは,weakなシンボ
 2027: ルをサポートしているオブジェクトファイルを使用しているときだけ効果があり
 2028: ます.
 2029: 
 2030: @item --keep-symbols=@var{filename}
 2031: @c Apply @option{--keep-symbol} option to each symbol listed in the file
 2032: @c @var{filename}.  @var{filename} is simply a flat file, with one symbol
 2033: @c name per line.  Line comments may be introduced by the hash character.
 2034: @c This option may be given more than once.
 2035: @c 
 2036: @option{--keep-symbol}オプションを,ファイル@var{filename}にリストアップ
 2037: されているそれぞれのシンボルに適用します.@var{filename}は単なるフラット
 2038: なファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ文
 2039: 字で導入されます.このオプションは一回以上与えるてもかまいません.
 2040: 
 2041: @item --strip-symbols=@var{filename}
 2042: @c Apply @option{--strip-symbol} option to each symbol listed in the file
 2043: @c @var{filename}.  @var{filename} is simply a flat file, with one symbol
 2044: @c name per line.  Line comments may be introduced by the hash character.
 2045: @c This option may be given more than once.
 2046: @c 
 2047: @option{--strip-symbol}オプションを,ファイル@var{filename}にリストアッ
 2048: プされているそれぞれのシンボルに適用します.@var{filename}は単なるフラッ
 2049: トなファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ
 2050: 文字で導入されます.このオプションは一回以上与えてもかまいません.
 2051: 
 2052: @item --keep-global-symbols=@var{filename}
 2053: @c Apply @option{--keep-global-symbol} option to each symbol listed in the
 2054: @c file @var{filename}.  @var{filename} is simply a flat file, with one
 2055: @c symbol name per line.  Line comments may be introduced by the hash
 2056: @c character.  This option may be given more than once.
 2057: @c 
 2058: @option{--keep-global-symbol}オプションを,ファイル@var{filename}にリス
 2059: トアップされているそれぞれのシンボルに適用します.@var{filename}は単なる
 2060: フラットなファイルで,一行に一つのシンボル名があります.行のコメントはハッ
 2061: シュ文字で導入されます.このオプションは一回以上与えてもかまいません.
 2062: 
 2063: @item --localize-symbols=@var{filename}
 2064: @c Apply @option{--localize-symbol} option to each symbol listed in the file
 2065: @c @var{filename}.  @var{filename} is simply a flat file, with one symbol
 2066: @c name per line.  Line comments may be introduced by the hash character.
 2067: @c This option may be given more than once.
 2068: @c 
 2069: @option{--localize-symbol}オプションを,ファイル@var{filename}にリストアッ
 2070: プされているそれぞれのシンボルに適用します.@var{filename}は単なるフラッ
 2071: トなファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ
 2072: 文字で導入されます.このオプションは一回以上与えてもかまいません.
 2073: 
 2074: @item --weaken-symbols=@var{filename}
 2075: @c Apply @option{--weaken-symbol} option to each symbol listed in the file
 2076: @c @var{filename}.  @var{filename} is simply a flat file, with one symbol
 2077: @c name per line.  Line comments may be introduced by the hash character.
 2078: @c This option may be given more than once.
 2079: @c 
 2080: @option{--weaken-symbol}オプションを,ファイル@var{filename}にリストアッ
 2081: プされているそれぞれのシンボルに適用します.@var{filename}は単なるフラッ
 2082: トなファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ
 2083: 文字で導入されます.このオプションは一回以上与えてもかまいません.
 2084: 
 2085: @item --alt-machine-code=@var{index}
 2086: @c If the output architecture has alternate machine codes, use the
 2087: @c @var{index}th code instead of the default one.  This is useful in case
 2088: @c a machine is assigned an official code and the tool-chain adopts the 
 2089: @c new code, but other applications still depend on the original code
 2090: @c being used.
 2091: @c 
 2092: 出力アーキテクチャに代替のマシンコードがある場合,デフォルトのものの代わ
 2093: りに@var{index}番目のコードを使用します.マシンに公式のコードが割り当て
 2094: られていて,ツールチェーンが新しいコードに適用するのですが,他のアプリケー
 2095: ションはまだ使用されているオリジナルのコードに依存している状況では,これ
 2096: は役に立ちます.
 2097: 
 2098: @item -V
 2099: @itemx --version
 2100: @c Show the version number of @command{objcopy}.
 2101: @c 
 2102: @command{objcopy}のバージョンナンバーを表示します.
 2103: 
 2104: @item -v
 2105: @itemx --verbose
 2106: @c Verbose output: list all object files modified.  In the case of
 2107: @c archives, @samp{objcopy -V} lists all members of the archive.
 2108: @c 
 2109: 冗長な出力です.修正されたすべてのオブジェクトファイルをリストアップしま
 2110: す.アーカイブの場合,@samp{objcopy -v}は,アーカイブのすべてのメンバー
 2111: をリストアップします.
 2112: 
 2113: @item --help
 2114: @c Show a summary of the options to @command{objcopy}.
 2115: @c 
 2116: @command{objcopy}へのオプションの概要を表示します.
 2117: @end table
 2118: 
 2119: @c man end
 2120: 
 2121: @ignore
 2122: @c man begin SEEALSO objcopy
 2123: ld(1), objdump(1), and the Info entries for @file{binutils}.
 2124: @c man end
 2125: @end ignore
 2126: 
 2127: @node objdump
 2128: @chapter objdump
 2129: 
 2130: @cindex object file information
 2131: @kindex objdump
 2132: 
 2133: @c man title objdump display information from object files.
 2134: 
 2135: @smallexample
 2136: @c man begin SYNOPSIS objdump
 2137: objdump [@option{-a}|@option{--archive-headers}]
 2138:         [@option{-b} @var{bfdname}|@option{--target=@var{bfdname}}]
 2139:         [@option{-C}|@option{--demangle}[=@var{style}] ]
 2140:         [@option{-d}|@option{--disassemble}]
 2141:         [@option{-D}|@option{--disassemble-all}]
 2142:         [@option{-z}|@option{--disassemble-zeroes}]
 2143:         [@option{-EB}|@option{-EL}|@option{--endian=}@{big | little @}]
 2144:         [@option{-f}|@option{--file-headers}]
 2145:         [@option{--file-start-context}]
 2146:         [@option{-g}|@option{--debugging}]
 2147:         [@option{-h}|@option{--section-headers}|@option{--headers}]
 2148:         [@option{-i}|@option{--info}]
 2149:         [@option{-j} @var{section}|@option{--section=}@var{section}]
 2150:         [@option{-l}|@option{--line-numbers}]
 2151:         [@option{-S}|@option{--source}]
 2152:         [@option{-m} @var{machine}|@option{--architecture=}@var{machine}]
 2153:         [@option{-M} @var{options}|@option{--disassembler-options=}@var{options}]
 2154:         [@option{-p}|@option{--private-headers}]
 2155:         [@option{-r}|@option{--reloc}]
 2156:         [@option{-R}|@option{--dynamic-reloc}]
 2157:         [@option{-s}|@option{--full-contents}]
 2158:         [@option{-G}|@option{--stabs}]
 2159:         [@option{-t}|@option{--syms}]
 2160:         [@option{-T}|@option{--dynamic-syms}]
 2161:         [@option{-x}|@option{--all-headers}]
 2162:         [@option{-w}|@option{--wide}]
 2163:         [@option{--start-address=}@var{address}]
 2164:         [@option{--stop-address=}@var{address}]
 2165:         [@option{--prefix-addresses}]
 2166:         [@option{--[no-]show-raw-insn}]
 2167:         [@option{--adjust-vma=}@var{offset}]
 2168:         [@option{-V}|@option{--version}]
 2169:         [@option{-H}|@option{--help}]
 2170:         @var{objfile}@dots{}
 2171: @c man end
 2172: @end smallexample
 2173: 
 2174: @c man begin DESCRIPTION objdump
 2175: 
 2176: @c @command{objdump} displays information about one or more object files.
 2177: @c The options control what particular information to display.  This
 2178: @c information is mostly useful to programmers who are working on the
 2179: @c compilation tools, as opposed to programmers who just want their
 2180: @c program to compile and work.
 2181: @c 
 2182: @command{objdump}は,一つ以上のオブジェクトファイルに関する情報を表示し
 2183: ます.オプションで,表示する情報を制御します.この情報は,プログラムをコ
 2184: ンパイルして動作させたいだけのプログラマより,コンパイルツールに関する作
 2185: 業をしているプログラマに対し最も役に立ちます.
 2186: 
 2187: @c @var{objfile}@dots{} are the object files to be examined.  When you
 2188: @c specify archives, @command{objdump} shows information on each of the member
 2189: @c object files.
 2190: @c 
 2191: @var{objfile}@dots{}は,調査されるオブジェクトファイルです.アーカイブを
 2192: 指定したとき,@command{objdump}は,それぞれのメンバーオブジェクトファイ
 2193: ルの情報を表示します.
 2194: 
 2195: @c man end
 2196: 
 2197: @c man begin OPTIONS objdump
 2198: 
 2199: @c The long and short forms of options, shown here as alternatives, are
 2200: @c equivalent.  At least one option from the list
 2201: @c @option{-a,-d,-D,-f,-g,-G,-h,-H,-p,-r,-R,-S,-t,-T,-V,-x} must be given. 
 2202: @c 
 2203: ここに交互に表示しているオプションの長い形式と短い形式は等価です.リスト
 2204: の@option{-a,-d,-D,-f,-g,-G,-h,-H,-p,-r,-R,-S,-t,-T,-V,-x}から少なくとも
 2205: 一つのオプションを与える必要があります.
 2206: 
 2207: @table @env
 2208: @item -a
 2209: @itemx --archive-header
 2210: @cindex archive headers
 2211: @c If any of the @var{objfile} files are archives, display the archive
 2212: @c header information (in a format similar to @samp{ls -l}).  Besides the
 2213: @c information you could list with @samp{ar tv}, @samp{objdump -a} shows
 2214: @c the object file format of each archive member.
 2215: @c 
 2216: @var{objfile}ファイルがすべてアーカイブの場合,アーカイブヘッダ情報を表
 2217: 示します(書式は@samp{ls -l}に似ています).@samp{ar tv}を用いてリストアッ
 2218: プ可能な情報に加え,@samp{objdump -a}は,それぞれのアーカイブのメンバー
 2219: のオブジェクトファイルのフォーマットを表示します.
 2220: 
 2221: @item --adjust-vma=@var{offset}
 2222: @cindex section addresses in objdump
 2223: @cindex VMA in objdump
 2224: @c When dumping information, first add @var{offset} to all the section
 2225: @c addresses.  This is useful if the section addresses do not correspond to
 2226: @c the symbol table, which can happen when putting sections at particular
 2227: @c addresses when using a format which can not represent section addresses,
 2228: @c such as a.out.
 2229: @c 
 2230: 情報をダンプしているとき,最初に,すべてのセクションアドレスに
 2231: @var{offset}を加えます.これは,セクションアドレスがシンボルテーブルに対
 2232: 応していない場合便利で,それは,@code{a.out}のようなセクションアドレスが
 2233: 存在しないフォーマットを使用しているとき,セクションを特定のアドレスに配
 2234: 置するとき発生します.
 2235: 
 2236: @item -b @var{bfdname}
 2237: @itemx --target=@var{bfdname}
 2238: @cindex object code format
 2239: @c Specify that the object-code format for the object files is
 2240: @c @var{bfdname}.  This option may not be necessary; @var{objdump} can
 2241: @c automatically recognize many formats.
 2242: @c 
 2243: オブジェクトファイルに対するオブジェクトコードのフォーマットを
 2244: @var{bfdname}に指定します.このオプションは不要かもしれません.
 2245: @var{objdump}は,自動的に多くのフォーマットを認識することが可能です.
 2246: 
 2247: @c For example,
 2248: @c 
 2249: 例えば,以下のようにします.
 2250: @example
 2251: objdump -b oasys -m vax -h fu.o
 2252: @end example
 2253: @noindent
 2254: @c displays summary information from the section headers (@option{-h}) of
 2255: @c @file{fu.o}, which is explicitly identified (@option{-m}) as a VAX object
 2256: @c file in the format produced by Oasys compilers.  You can list the
 2257: @c formats available with the @option{-i} option.
 2258: @c @xref{Target Selection}, for more information.
 2259: @c 
 2260: それは,@file{fu.o}のセクションヘッダ(@option{-h})からの情報の概要を表示
 2261: し,それは特に,Oasysコンパイラで生成されるフォーマットのVAXオブジェクト
 2262: ファイルとして認識(@option{-m})されます.@option{-i}オプションを用いて利
 2263: 用可能なフォーマットをリストアップすることが可能です.詳細は,
 2264: @xref{Target Selection}.
 2265: 
 2266: @item -C
 2267: @itemx --demangle[=@var{style}]
 2268: @cindex demangling in objdump
 2269: @c Decode (@dfn{demangle}) low-level symbol names into user-level names.
 2270: @c Besides removing any initial underscore prepended by the system, this
 2271: @c makes C++ function names readable.  Different compilers have different
 2272: @c mangling styles. The optional demangling style argument can be used to 
 2273: @c choose an appropriate demangling style for your compiler. @xref{c++filt}, 
 2274: @c for more information on demangling.
 2275: @c 
 2276: 低レベルのシンボル名をユーザレベルの名前に復号(@dfn{demangle})します.シ
 2277: ステムによって前置される,最初のすべてのアンダースコアを削除するだけでな
 2278: く.これはC++関数名を可読にします.異なるコンパイラでは,mangle形式が異
 2279: なります.追加のdemangle形式の引数は,コンパイラに対する適切なdemangle形
 2280: 式を選択するために使用可能です.demangleの情報は,@xref{c++filt}.
 2281: 
 2282: @item -G
 2283: @item --debugging
 2284: @c Display debugging information.  This attempts to parse debugging
 2285: @c information stored in the file and print it out using a C like syntax.
 2286: @c Only certain types of debugging information have been implemented.
 2287: @c 
 2288: デバッグ情報を表示します.これは,ファイルに保存されているデバッグ情報の
 2289: 解析を試み,Cのような構文を使用してそれを出力します.デバッグ情報の特定
 2290: の形式のみ実装されています.
 2291: 
 2292: @item -d
 2293: @itemx --disassemble
 2294: @cindex disassembling object code
 2295: @cindex machine instructions
 2296: @c Display the assembler mnemonics for the machine instructions from
 2297: @c @var{objfile}.  This option only disassembles those sections which are
 2298: @c expected to contain instructions.
 2299: @c 
 2300: @var{objfile}から,機械語命令に対するアセンブラニーモニックを表示します.
 2301: このオプションは,命令を含むことを期待されるそれらのセクションを,逆アセ
 2302: ンブルするだけです.
 2303: 
 2304: @item -D
 2305: @itemx --disassemble-all
 2306: @c Like @option{-d}, but disassemble the contents of all sections, not just
 2307: @c those expected to contain instructions.
 2308: @c 
 2309: @option{-d}に似ていますが,命令を含むことを期待されるものだけでなく,す
 2310: べてのセクションの内容を逆アセンブルします.
 2311: 
 2312: @item --prefix-addresses
 2313: @c When disassembling, print the complete address on each line.  This is
 2314: @c the older disassembly format.
 2315: @c 
 2316: 逆アセンブルしているとき,それぞれの行に絶対アドレスを出力します.これは
 2317: より古い逆アセンブルの書式です.
 2318: 
 2319: @item --disassemble-zeroes
 2320: @c Normally the disassembly output will skip blocks of zeroes.  This
 2321: @c option directs the disassembler to disassemble those blocks, just like
 2322: @c any other data.
 2323: @c 
 2324: 通常逆アセンブルの出力はゼロブロックをスキップします.このオプションは,
 2325: それらのブロックを他のデータと同じように逆アセンブルする,直接的な逆アセ
 2326: ンブラです.
 2327: 
 2328: @item -EB
 2329: @itemx -EL
 2330: @itemx --endian=@{big|little@}
 2331: @cindex endianness
 2332: @cindex disassembly endianness
 2333: @c Specify the endianness of the object files.  This only affects
 2334: @c disassembly.  This can be useful when disassembling a file format which
 2335: @c does not describe endianness information, such as S-records.
 2336: @c 
 2337: オブジェクトファイルのエンディアンを指定します.これは逆アセンブラにのみ
 2338: 効果があります.これは,S-recordのような,エンディアン情報を記述していな
 2339: いファイルフォーマットを逆アセンブルしているとき役に立つはずです.
 2340: 
 2341: @item -f
 2342: @itemx --file-header
 2343: @cindex object file header
 2344: @c Display summary information from the overall header of
 2345: @c each of the @var{objfile} files.
 2346: @c 
 2347: それぞれの@var{objfile}ファイルのヘッダ全体からの情報の概要を表示します.
 2348: 
 2349: @item --file-start-context
 2350: @cindex source code context
 2351: @c Specify that when displaying interlisted source code/disassembly
 2352: @c (assumes @option{-S}) from a file that has not yet been displayed, extend the
 2353: @c context to the start of the file.
 2354: @c 
 2355: まだ表示されていない,内部にリストアップされているソースコード/ファイル
 2356: から逆アセンブルされたもの(おそらく@option{-S})を表示しているとき,コン
 2357: テクストをファイルの先頭まで拡張することを指定します.
 2358: 
 2359: @item -h
 2360: @itemx --section-header
 2361: @itemx --header
 2362: @cindex section headers
 2363: @c Display summary information from the section headers of the
 2364: @c object file.
 2365: @c 
 2366: オブジェクトファイルのセクションヘッダの情報の概要を表示します.
 2367: 
 2368: @c File segments may be relocated to nonstandard addresses, for example by
 2369: @c using the @option{-Ttext}, @option{-Tdata}, or @option{-Tbss} options to
 2370: @c @command{ld}.  However, some object file formats, such as a.out, do not
 2371: @c store the starting address of the file segments.  In those situations,
 2372: @c although @command{ld} relocates the sections correctly, using @samp{objdump
 2373: @c -h} to list the file section headers cannot show the correct addresses.
 2374: @c Instead, it shows the usual addresses, which are implicit for the
 2375: @c target.
 2376: @c 
 2377: ファイルのセグメントは,非標準のアドレスに再配置され,例えば,
 2378: @option{-Ttext},@option{-Tdata},または@option{-Tbss}オプションが
 2379: @command{ld}で使用されています.しかし,@code{a.out}のようなオブジェクト
 2380: ファイルのフォーマットによっては,ファイルセグメントの開始アドレスを保存
 2381: しないものもあります.そのような状況では,@command{ld}がセクションを正し
 2382: く再配置しますが,ファイルのセクションのヘッダのリストに@samp{objdump
 2383: -h}を使用しても,正しいアドレスを表示することは不可能です.その代わりに,
 2384: それは通常のアドレスを表示し,それらはターゲットに対して暗黙のうちに行わ
 2385: れます.
 2386: 
 2387: @item --help
 2388: @c Print a summary of the options to @command{objdump} and exit.
 2389: @c 
 2390: @command{objdump}に対するオプションの概要を出力し,終了します.
 2391: 
 2392: @item -i
 2393: @itemx --info
 2394: @cindex architectures available
 2395: @cindex object formats available
 2396: @c Display a list showing all architectures and object formats available
 2397: @c for specification with @option{-b} or @option{-m}.
 2398: @c 
 2399: @option{-b}や@option{-m}を用いて指定可能な,すべてのアーキテクチャとオブ
 2400: ジェクトのフォーマットを示すリストを表示します.
 2401: 
 2402: @item -j @var{name}
 2403: @itemx --section=@var{name}
 2404: @cindex section information
 2405: @c Display information only for section @var{name}.
 2406: @c 
 2407: セクション@var{name}に対する情報のみ表示します.
 2408: 
 2409: @item -l
 2410: @itemx --line-numbers
 2411: @cindex source filenames for object files
 2412: @c Label the display (using debugging information) with the filename and
 2413: @c source line numbers corresponding to the object code or relocs shown.
 2414: @c Only useful with @option{-d}, @option{-D}, or @option{-r}.
 2415: @c 
 2416: (デバッグ情報を使用した)表示に,表示されているオブジェクトコードや再配置
 2417: に一致しているファイル名とソースの行番号を用いてラベル付けします.
 2418: @option{-d},@option{-D},または@option{-r}を用いた場合のみ有益です.
 2419: 
 2420: @item -m @var{machine}
 2421: @itemx --architecture=@var{machine}
 2422: @cindex architecture
 2423: @cindex disassembly architecture
 2424: @c Specify the architecture to use when disassembling object files.  This
 2425: @c can be useful when disassembling object files which do not describe
 2426: @c architecture information, such as S-records.  You can list the available
 2427: @c architectures with the @option{-i} option.
 2428: @c 
 2429: オブジェクトファイルの逆アセンブル時に,使用するアーキテクチャを指定しま
 2430: す.これは,S-recordのような,アーキテクチャ情報が記述されていないオブジェ
 2431: クトファイルを逆アセンブルするとき役に立ちます.@option{-i}オプションを
 2432: 用いて,利用可能なアーキテクチャをリストアップすることが可能です.
 2433: 
 2434: @item -M @var{options}
 2435: @itemx --disassembler-options=@var{options}
 2436: @c Pass target specific information to the disassembler.  Only supported on
 2437: @c some targets.
 2438: @c 
 2439: ターゲット指定の情報を逆アセンブラに渡します.いくつかのターゲットだけを
 2440: サポートします.
 2441: 
 2442: @c If the target is an ARM architecture then this switch can be used to
 2443: @c select which register name set is used during disassembler.  Specifying
 2444: @c @option{-M reg-name-std} (the default) will select the register names as
 2445: @c used in ARM's instruction set documentation, but with register 13 called
 2446: @c 'sp', register 14 called 'lr' and register 15 called 'pc'.  Specifying
 2447: @c @option{-M reg-names-apcs} will select the name set used by the ARM
 2448: @c Procedure Call Standard, whilst specifying @option{-M reg-names-raw} will
 2449: @c just use @samp{r} followed by the register number.
 2450: @c 
 2451: ターゲットがARMアーキテクチャの場合,逆アセンブラが使用されている間に使
 2452: 用するレジスタ名のセットを選択するために,このスイッチを使用することが可
 2453: 能です.@option{-M reg-name-std} (デフォルト)を指定すると,ARMの命令セッ
 2454: トのドキュメントで使用しているレジスタ名を選択しますが,'sp'と呼ばれるレ
 2455: ジスタ13,'lr'と呼ばれるレジスタ14,そして'pc'と呼ばれるレジスタ15 レジ
 2456: スタは除きます.@option{-M reg-names-apcs}を指定すると,ARM Procedure
 2457: Call Standardで使用されている名前のセットを選択するのに対し,@option{-M
 2458: reg-names-raw}を指定すると,@samp{r}にレジスタ番号が続いたものを使用しま
 2459: す.
 2460: 
 2461: @c There are also two variants on the APCS register naming scheme enabled
 2462: @c by @option{-M reg-names-atpcs} and @option{-M reg-names-special-atpcs} which
 2463: @c use the ARM/Thumb Procedure Call Standard naming conventions.  (Either
 2464: @c with the normal register name or the special register names).
 2465: @c 
 2466: APCSレジスタ命名規則には二つの変形があり,@option{-M reg-names-atpcs}と
 2467: @option{-M reg-names-special-atpcs}により利用可能で,それはARM/Thumb
 2468: Procedure Call Standard命名規約を使用します.(通常のレジスタ名,または,
 2469: 特殊なレジスタ名のどちらかを使用します.)
 2470: 
 2471: @c This option can also be used for ARM architectures to force the
 2472: @c disassembler to interpret all instructions as Thumb instructions by
 2473: @c using the switch @option{--disassembler-options=force-thumb}.  This can be
 2474: @c useful when attempting to disassemble thumb code produced by other
 2475: @c compilers.
 2476: @c 
 2477: このオプションは,ARMアーキテクチャに対し,スイッチ
 2478: @option{--disassembler-options=force-thumb}を使用して,すべての命令を
 2479: Thumb命令として解釈するように逆アセンブラに強制するためにも使用可能です.
 2480: 他のコンパイラで生成される thumb コードの逆アセンブラを試みるとき,これ
 2481: は役に立つはずです.
 2482: 
 2483: @c For the x86, some of the options duplicate functions of the @option{-m}
 2484: @c switch, but allow finer grained control.  Multiple selections from the
 2485: @c following may be specified as a comma separated string.
 2486: @c @option{x86-64}, @option{i386} and @option{i8086} select disassembly for
 2487: @c the given architecture.  @option{intel} and @option{att} select between
 2488: @c intel syntax mode and AT&T syntax mode.  @option{addr32},
 2489: @c @option{addr16}, @option{data32} and @option{data16} specify the default
 2490: @c address size and operand size.  These four options will be overridden if
 2491: @c @option{x86-64}, @option{i386} or @option{i8086} appear later in the
 2492: @c option string.  Lastly, @option{suffix}, when in AT&T mode,
 2493: @c instructs the dissassembler to print a mnemonic suffix even when the
 2494: @c suffix could be inferred by the operands.
 2495: @c 
 2496: x86に対して,オプションによっては@option{-m}のスイッチの機能を複製します
 2497: が,よりきめ細かい制御が可能になります.以下の複数のセクションをカンマで
 2498: 分けられた文字列として指定してもかまいません.@option{x86-64},
 2499: @option{i386},そして@option{i8086}は該当するアーキテクチャに対する逆ア
 2500: センブルを選択します.@option{intel}と@option{att}は,インテルの構文のモー
 2501: ドとAT&Tの構文のモードを選択します.@option{addr32},@option{addr16},
 2502: @option{data32},そして@option{data16}は,デフォルトのアドレスサイズとオ
 2503: ペランドサイズを指定します.これらの四つのオプションは,それ以降のオプショ
 2504: ン文字列に@option{x86-64},@option{i386},または@option{i8086}が現れる場
 2505: 合は,そちらが優先されます.最後は@option{suffix}で,これはAT&Tモードの
 2506: とき,サフィックスがオペランドで推測可能なときでさえ,ニーモニックサフィッ
 2507: クスを逆アセンブラは出力します.
 2508: 
 2509: @c For PPC, @option{booke}, @option{booke32} and @option{booke64} select
 2510: @c disassembly of BookE instructions.  @option{32} and @option{64} select
 2511: @c PowerPC and PowerPC64 disassembly, respectively.
 2512: @c 
 2513: PPCに対し,@option{booke},@option{booke32},そして@option{booke64}は
 2514: BookE命令の逆アセンブラを選択します.@option{32}と@option{64}は,それぞ
 2515: れPowerPCとPowerPC64の逆アセンブラを選択します.
 2516: 
 2517: @item -p
 2518: @itemx --private-headers
 2519: @c Print information that is specific to the object file format.  The exact
 2520: @c information printed depends upon the object file format.  For some
 2521: @c object file formats, no additional information is printed.
 2522: @c 
 2523: オブジェクトファイルのフォーマット特有の情報を出力します.出力される厳密
 2524: な情報はオブジェクトファイルのフォーマットに依存します.オブジェクトファ
 2525: イルのフォーマットによっては,追加情報は出力されません.
 2526: 
 2527: @item -r
 2528: @itemx --reloc
 2529: @cindex relocation entries, in object file
 2530: @c Print the relocation entries of the file.  If used with @option{-d} or
 2531: @c @option{-D}, the relocations are printed interspersed with the
 2532: @c disassembly.
 2533: @c 
 2534: ファイルの再配置エントリを出力します.@option{-d}や@option{-D}とともに使
 2535: 用される場合,再配置は逆アセンブルの中にバラバラに出力されます.
 2536: 
 2537: @item -R
 2538: @itemx --dynamic-reloc
 2539: @cindex dynamic relocation entries, in object file
 2540: @c Print the dynamic relocation entries of the file.  This is only
 2541: @c meaningful for dynamic objects, such as certain types of shared
 2542: @c libraries.
 2543: @c 
 2544: ファイルの動的な再配置エントリを出力します.これは,ある形式の共有ライブ
 2545: ラリのような,動的オブジェクトのみで意味があります.
 2546: 
 2547: @item -s
 2548: @itemx --full-contents
 2549: @cindex sections, full contents
 2550: @cindex object file sections
 2551: @c Display the full contents of any sections requested.
 2552: @c 
 2553: 要求されたあらゆるセクションの,すべての内容を表示します.
 2554: 
 2555: @item -S
 2556: @itemx --source
 2557: @cindex source disassembly
 2558: @cindex disassembly, with source
 2559: @c Display source code intermixed with disassembly, if possible.  Implies
 2560: @c @option{-d}.
 2561: @c 
 2562: 可能な場合,逆アセンブラの中にソースコードを混ぜて表示します.@option{-d}
 2563: が暗黙のうちに指定されます.
 2564: 
 2565: @item --show-raw-insn
 2566: @c When disassembling instructions, print the instruction in hex as well as
 2567: @c in symbolic form.  This is the default except when
 2568: @c @option{--prefix-addresses} is used.
 2569: @c 
 2570: 命令を逆アセンブルするとき,命令をシンボリック形式と同様に16進で出力しま
 2571: す.@option{--prefix-addresses}が使用されているとき以外,これはデフォル
 2572: トです.
 2573: 
 2574: @item --no-show-raw-insn
 2575: @c When disassembling instructions, do not print the instruction bytes.
 2576: @c This is the default when @option{--prefix-addresses} is used.
 2577: @c 
 2578: 命令を逆アセンブルするとき,命令バイトを出力しません.これは
 2579: @option{--prefix-addresses}が使用されているときデフォルトです.
 2580: 
 2581: @item -G
 2582: @item --stabs
 2583: @cindex stab
 2584: @cindex .stab
 2585: @cindex debug symbols
 2586: @cindex ELF object file format
 2587: @c Display the full contents of any sections requested.  Display the
 2588: @c contents of the .stab and .stab.index and .stab.excl sections from an
 2589: @c ELF file.  This is only useful on systems (such as Solaris 2.0) in which
 2590: @c @code{.stab} debugging symbol-table entries are carried in an ELF
 2591: @c section.  In most other file formats, debugging symbol-table entries are
 2592: @c interleaved with linkage symbols, and are visible in the @option{--syms}
 2593: @c output.
 2594: @c 
 2595: 要求されるすべてのセクションの内容を全部表示します.ELFファイルの .stab 
 2596: と .stab.indexと .stab.exclセクションの内容を表示します.これは,
 2597: @code{.stab}デバッグシンボルテーブルのエントリーがELFのセクションに運び
 2598: 込まれる(Solaris 2.0のような)システムでのみ役に立ちます.そのほかのほと
 2599: んどのフォーマットでは,デバッグシンボルテーブルのエントリーは,リンクシ
 2600: ンボルとともにバラバラに配置され,@option{--syms}の出力で見ることが可能
 2601: となります.
 2602: @ifclear man
 2603: @c For more information on stabs symbols, see @ref{Top,Stabs,Stabs
 2604: @c Overview,stabs.info, The ``stabs'' debug format}.
 2605: @c 
 2606: スタブシンボルの詳細は,@ref{Top,Stabs,Stabs Overview,stabs.info, The
 2607: ``stabs'' debug format}を参照してください.
 2608: @end ifclear
 2609: 
 2610: @item --start-address=@var{address}
 2611: @cindex start-address
 2612: @c Start displaying data at the specified address.  This affects the output
 2613: @c of the @option{-d}, @option{-r} and @option{-s} options.
 2614: @c 
 2615: データの表示を,指定したアドレスで開始します.これは@option{-d},
 2616: @option{-r},そして@option{-s}オプションの出力に効果があります.
 2617: 
 2618: @item --stop-address=@var{address}
 2619: @cindex stop-address
 2620: @c Stop displaying data at the specified address.  This affects the output
 2621: @c of the @option{-d}, @option{-r} and @option{-s} options.
 2622: @c 
 2623: データの表示を,指定したアドレスで停止します.これは@option{-d},
 2624: @option{-r},そして@option{-s}オプションの出力に効果があります.
 2625: 
 2626: @item -t
 2627: @itemx --syms
 2628: @cindex symbol table entries, printing
 2629: @c Print the symbol table entries of the file.
 2630: @c This is similar to the information provided by the @samp{nm} program.
 2631: @c 
 2632: ファイルのシンボルテーブルのエントリーを出力します.これは,@samp{nm}プ
 2633: ログラムで提供される情報に似ています.
 2634: 
 2635: @item -T
 2636: @itemx --dynamic-syms
 2637: @cindex dynamic symbol table entries, printing
 2638: @c Print the dynamic symbol table entries of the file.  This is only
 2639: @c meaningful for dynamic objects, such as certain types of shared
 2640: @c libraries.  This is similar to the information provided by the @samp{nm}
 2641: @c program when given the @option{-D} (@option{--dynamic}) option.
 2642: @c 
 2643: ファイルの動的シンボルテーブルのエントリーを表示します.これは,特定の形
 2644: 式の共有ライブラリのような,動的オブジェクトに対してのみ意味があります.
 2645: これは,@option{-D} (@option{--dynamic})オプションが与えられている
 2646: @samp{nm}プログラムで提供される情報に似ています.
 2647: 
 2648: @item --version
 2649: @c Print the version number of @command{objdump} and exit.
 2650: @c 
 2651: @command{objdump}のバージョンナンバーを出力し終了します.
 2652: 
 2653: @item -x
 2654: @itemx --all-header
 2655: @cindex all header information, object file
 2656: @cindex header information, all
 2657: @c Display all available header information, including the symbol table and
 2658: @c relocation entries.  Using @option{-x} is equivalent to specifying all of
 2659: @c @option{-a -f -h -r -t}.
 2660: @c 
 2661: 利用可能なヘッダ情報をすべて表示し,それはシンボルテーブルと,再配置エン
 2662: トリを含みます.@option{-x}を用いると,@option{-a -f -h -r -t}をすべて指
 2663: 定したものと等価になります.
 2664: 
 2665: @item -w
 2666: @itemx --wide
 2667: @cindex wide output, printing
 2668: @c Format some lines for output devices that have more than 80 columns.
 2669: @c Also do not truncate symbol names when they are displayed.
 2670: @c 
 2671: 80列以上の出力デバイスに対し,数行で書式化します.また,表示するときにシ
 2672: ンボル名を切り詰めません.
 2673: @end table
 2674: 
 2675: @c man end
 2676: 
 2677: @ignore
 2678: @c man begin SEEALSO objdump
 2679: nm(1), readelf(1), and the Info entries for @file{binutils}.
 2680: @c man end
 2681: @end ignore
 2682: 
 2683: @node ranlib
 2684: @chapter ranlib
 2685: 
 2686: @kindex ranlib
 2687: @cindex archive contents
 2688: @cindex symbol index
 2689: 
 2690: @c man title ranlib generate index to archive.
 2691: 
 2692: @smallexample
 2693: @c man begin SYNOPSIS ranlib
 2694: ranlib [@option{-vV}] @var{archive}
 2695: @c man end
 2696: @end smallexample
 2697: 
 2698: @c man begin DESCRIPTION ranlib
 2699: 
 2700: @c @command{ranlib} generates an index to the contents of an archive and
 2701: @c stores it in the archive.  The index lists each symbol defined by a
 2702: @c member of an archive that is a relocatable object file.  
 2703: @c 
 2704: @command{ranlib}は,アーカイブの内容の索引を生成し,それをアーカイブに保
 2705: 存します.索引は,再配置可能なオブジェクトファイルであるアーカイブのメン
 2706: バーによって定義される,それぞれのシンボルをリストアップします.
 2707: 
 2708: @c You may use @samp{nm -s} or @samp{nm --print-armap} to list this index.
 2709: @c 
 2710: この索引をリストアップするために,@samp{nm -s}や@samp{nm --print-armap} 
 2711: を使用してもかまいません.
 2712: 
 2713: @c An archive with such an index speeds up linking to the library and
 2714: @c allows routines in the library to call each other without regard to
 2715: @c their placement in the archive.
 2716: @c 
 2717: そのような索引を持ったアーカイブは,ライブラリとのリンクで高速になり,アー
 2718: カイブ内での位置によらず,ライブラリ内でのお互いの呼び出し動作を可能にし
 2719: ます.
 2720: 
 2721: @c The @sc{gnu} @command{ranlib} program is another form of @sc{gnu} @command{ar}; running
 2722: @c @command{ranlib} is completely equivalent to executing @samp{ar -s}.
 2723: @c @xref{ar}.
 2724: @c 
 2725: @sc{gnu} @command{ranlib}プログラムは,@sc{gnu} @command{ar}のもう一つの
 2726: 形式です.@command{ranlib}を実行することは,@samp{ar -s}を実行することと
 2727: 完全に等価です.@xref{ar}.
 2728: 
 2729: @c man end
 2730: 
 2731: @c man begin OPTIONS ranlib
 2732: 
 2733: @table @env
 2734: @item -v
 2735: @itemx -V
 2736: @itemx --version
 2737: @c Show the version number of @command{ranlib}.
 2738: @c 
 2739: @command{ranlib}のバージョンナンバーを表示します.
 2740: @end table
 2741: 
 2742: @c man end
 2743: 
 2744: @ignore
 2745: @c man begin SEEALSO ranlib
 2746: ar(1), nm(1), and the Info entries for @file{binutils}.
 2747: @c man end
 2748: @end ignore
 2749: 
 2750: @node size
 2751: @chapter size
 2752: 
 2753: @kindex size
 2754: @cindex section sizes
 2755: 
 2756: @c man title size list section sizes and total size.
 2757: 
 2758: @smallexample
 2759: @c man begin SYNOPSIS size
 2760: size [@option{-A}|@option{-B}|@option{--format=}@var{compatibility}]
 2761:      [@option{--help}]
 2762:      [@option{-d}|@option{-o}|@option{-x}|@option{--radix=}@var{number}]
 2763:      [@option{-t}|@option{--totals}]
 2764:      [@option{--target=}@var{bfdname}] [@option{-V}|@option{--version}]  
 2765:      [@var{objfile}@dots{}]
 2766: @c man end
 2767: @end smallexample
 2768: 
 2769: @c man begin DESCRIPTION size
 2770: 
 2771: @c The @sc{gnu} @command{size} utility lists the section sizes---and the total
 2772: @c size---for each of the object or archive files @var{objfile} in its
 2773: @c argument list.  By default, one line of output is generated for each
 2774: @c object file or each module in an archive.
 2775: @c 
 2776: @sc{gnu} @command{size}ユーティリティは,その引数リスト内の,それぞれの
 2777: オブジェクトやアーカイブファイル@var{objfile}に対し,セクションのサイズ 
 2778: --- と全体のサイズ --- をリストアップします.デフォルトで,それぞれのオ
 2779: ブジェクトファイルやそれぞれのアーカイブのモジュールに対し,一行の出力が
 2780: 生成されます.
 2781: 
 2782: @c @var{objfile}@dots{} are the object files to be examined.
 2783: @c If none are specified, the file @code{a.out} will be used.
 2784: @c 
 2785: @var{objfile}@dots{} は,調査するオブジェクトファイルです.何も指定され
 2786: ない場合,ファイル@code{a.out}が使用されます.
 2787: 
 2788: @c man end
 2789: 
 2790: @c man begin OPTIONS size
 2791: 
 2792: @c The command line options have the following meanings:
 2793: @c 
 2794: コマンドラインオプションには,以下の意味があります.
 2795: 
 2796: @table @env
 2797: @item -A
 2798: @itemx -B
 2799: @itemx --format=@var{compatibility}
 2800: @cindex @command{size} display format
 2801: @c Using one of these options, you can choose whether the output from @sc{gnu}
 2802: @c @command{size} resembles output from System V @command{size} (using @option{-A},
 2803: @c or @option{--format=sysv}), or Berkeley @command{size} (using @option{-B}, or
 2804: @c @option{--format=berkeley}).  The default is the one-line format similar to
 2805: @c Berkeley's.  
 2806: @c 
 2807: これらのオプションの一つを使用した場合,System V @command{size}
 2808: (@option{-A},または@option{--format=sysv}の使用)の出力に似ている
 2809: @sc{gnu} @command{size}の出力,または,Berkeley @command{size}
 2810: (@option{-B},または@option{--format=berkeley}の使用)のいずれかを選択す
 2811: ることが可能です.デフォルトは,Berkeleyのものに似ている一行の書式です.
 2812: @c Bonus for doc-source readers: you can also say --format=strange (or
 2813: @c anything else that starts with 's') for sysv, and --format=boring (or
 2814: @c anything else that starts with 'b') for Berkeley.
 2815: 
 2816: @c Here is an example of the Berkeley (default) format of output from
 2817: @c @command{size}: 
 2818: @c 
 2819: 以下は,Berkeley(デフォルト)書式の@command{size}の出力例です.
 2820: @smallexample
 2821: $ size --format=Berkeley ranlib size
 2822: text    data    bss     dec     hex     filename
 2823: 294880  81920   11592   388392  5ed28   ranlib
 2824: 294880  81920   11888   388688  5ee50   size
 2825: @end smallexample
 2826: 
 2827: @noindent
 2828: @c This is the same data, but displayed closer to System V conventions:
 2829: @c 
 2830: これは同じデータですが,System Vの記法を選択して表示されています.
 2831: 
 2832: @smallexample
 2833: $ size --format=SysV ranlib size
 2834: ranlib  :
 2835: section         size         addr
 2836: .text         294880         8192       
 2837: .data          81920       303104       
 2838: .bss           11592       385024       
 2839: Total         388392    
 2840: 
 2841: 
 2842: size  :
 2843: section         size         addr
 2844: .text         294880         8192       
 2845: .data          81920       303104       
 2846: .bss           11888       385024       
 2847: Total         388688    
 2848: @end smallexample
 2849: 
 2850: @item --help
 2851: @c Show a summary of acceptable arguments and options.
 2852: @c 
 2853: 受け入れ可能な引数とオプションの概要を表示します.
 2854: 
 2855: @item -d
 2856: @itemx -o
 2857: @itemx -x
 2858: @itemx --radix=@var{number}
 2859: @cindex @command{size} number format
 2860: @cindex radix for section sizes
 2861: @c Using one of these options, you can control whether the size of each
 2862: @c section is given in decimal (@option{-d}, or @option{--radix=10}); octal
 2863: @c (@option{-o}, or @option{--radix=8}); or hexadecimal (@option{-x}, or
 2864: @c @option{--radix=16}).  In @option{--radix=@var{number}}, only the three
 2865: @c values (8, 10, 16) are supported.  The total size is always given in two
 2866: @c radices; decimal and hexadecimal for @option{-d} or @option{-x} output, or
 2867: @c octal and hexadecimal if you're using @option{-o}.
 2868: @c 
 2869: これらのオプションの一つを使用した場合,それぞれのセクションのサイズを,
 2870: 10進数(@option{-d}または@option{--radix=10}),8進数(@option{-o}または
 2871: @option{--radix=8}),または16進数(@option{-x}または@option{--radix=16}) 
 2872: で与えられるもののいづれかに制御可能です.@option{--radix=@var{number}} 
 2873: では,三つの値(8, 10, 16)のみサポートされます.全体のサイズは常に二つの
 2874: 基数で与えられます.それは,@option{-d}や@option{-x}に対する,10進数と16
 2875: 進数,または@option{-o}を使用した場合,8進数と16進数になります.
 2876: 
 2877: @item -t
 2878: @itemx --totals
 2879: @c Show totals of all objects listed (Berkeley format listing mode only).
 2880: @c 
 2881: リストアップされたすべてのオブジェクトの総数を表示します(Berkeleyの書式
 2882: でのリストアップモードのみです).
 2883: 
 2884: @item --target=@var{bfdname}
 2885: @cindex object code format
 2886: @c Specify that the object-code format for @var{objfile} is
 2887: @c @var{bfdname}.  This option may not be necessary; @command{size} can
 2888: @c automatically recognize many formats.
 2889: @c @xref{Target Selection}, for more information.
 2890: @c 
 2891: @var{objfile}に対するオブジェクトコードのフォーマットを@var{bfdname}とし
 2892: て指定します.このオプションは不要かもしれません.@command{size}は自動的
 2893: に多くのフォーマットを認識することが可能です.詳細は,@xref{Target
 2894: Selection}.
 2895: 
 2896: @item -V
 2897: @itemx --version
 2898: @c Display the version number of @command{size}.
 2899: @c 
 2900: @command{size}のバージョンナンバーを表示します.
 2901: @end table
 2902: 
 2903: @c man end
 2904: 
 2905: @ignore
 2906: @c man begin SEEALSO size
 2907: ar(1), objdump(1), readelf(1), and the Info entries for @file{binutils}.
 2908: @c man end
 2909: @end ignore
 2910: 
 2911: @node strings
 2912: @chapter strings
 2913: @kindex strings
 2914: @cindex listings strings
 2915: @cindex printing strings
 2916: @cindex strings, printing
 2917: 
 2918: @c man title strings print the strings of printable characters in files.
 2919: 
 2920: @smallexample
 2921: @c man begin SYNOPSIS strings
 2922: strings [@option{-afov}] [@option{-}@var{min-len}]
 2923:         [@option{-n} @var{min-len}] [@option{--bytes=}@var{min-len}]
 2924:         [@option{-t} @var{radix}] [@option{--radix=}@var{radix}]
 2925:         [@option{-e} @var{encoding}] [@option{--encoding=}@var{encoding}]
 2926:         [@option{-}] [@option{--all}] [@option{--print-file-name}]
 2927:         [@option{--target=}@var{bfdname}]
 2928:         [@option{--help}] [@option{--version}] @var{file}@dots{}
 2929: @c man end
 2930: @end smallexample
 2931: 
 2932: @c man begin DESCRIPTION strings
 2933: 
 2934: @c For each @var{file} given, @sc{gnu} @command{strings} prints the printable
 2935: @c character sequences that are at least 4 characters long (or the number
 2936: @c given with the options below) and are followed by an unprintable
 2937: @c character.  By default, it only prints the strings from the initialized
 2938: @c and loaded sections of object files; for other types of files, it prints
 2939: @c the strings from the whole file.
 2940: @c 
 2941: それぞれの与えられた@var{file}に対し,@sc{gnu} @command{strings}は,出力
 2942: 可能な文字が最低四文字(または以下のオプションで与えられた数)並んでいて,
 2943: それに出力不可能な文字が続くものの,出力可能な文字を出力します.デフォル
 2944: トで,オブジェクトファイルの,初期化されロードされるセクションから,文字
 2945: 列のみ出力します.それ以外のファイルの形式では,ファイル全体から文字列を
 2946: 出力します.
 2947: 
 2948: @c @command{strings} is mainly useful for determining the contents of non-text
 2949: @c files.
 2950: @c 
 2951: @command{strings}は,テキストではないファイルの内容を判断することに,主
 2952: に役立ちます.
 2953: 
 2954: @c man end
 2955: 
 2956: @c man begin OPTIONS strings
 2957: 
 2958: @table @env
 2959: @item -a
 2960: @itemx --all
 2961: @itemx -
 2962: @c Do not scan only the initialized and loaded sections of object files;
 2963: @c scan the whole files.
 2964: @c 
 2965: オブジェクトファイルの初期化されロードされるセクションのみをスキャンする
 2966: のではありません.ファイル全体をスキャンします.
 2967: 
 2968: @item -f
 2969: @itemx --print-file-name
 2970: @c Print the name of the file before each string.
 2971: @c 
 2972: それぞれの文字列の前にファイル名を出力します.
 2973: 
 2974: @item --help
 2975: @c Print a summary of the program usage on the standard output and exit.
 2976: @c 
 2977: プログラムの使用方法の概要を標準出力に出力し終了します.
 2978: 
 2979: @item -@var{min-len}
 2980: @itemx -n @var{min-len}
 2981: @itemx --bytes=@var{min-len}
 2982: @c Print sequences of characters that are at least @var{min-len} characters
 2983: @c long, instead of the default 4.
 2984: @c 
 2985: デフォルトの4文字ではなく,少なくとも@var{min-len}文字の長さの文字の列
 2986: を出力します.
 2987: 
 2988: @item -o
 2989: @c Like @samp{-t o}.  Some other versions of @command{strings} have @option{-o}
 2990: @c act like @samp{-t d} instead.  Since we can not be compatible with both
 2991: @c ways, we simply chose one.
 2992: @c 
 2993: @option{-t o}に似ています.@command{strings}の他のバージョンには,代わり
 2994: に@option{-t d}のように@option{-o}を動作させるものもあります.我々は,両
 2995: 方の互換性を提供することができないので,単純にこちらを選択しただけです.
 2996: 
 2997: @item -t @var{radix}
 2998: @itemx --radix=@var{radix}
 2999: @c Print the offset within the file before each string.  The single
 3000: @c character argument specifies the radix of the offset---@samp{o} for
 3001: @c octal, @samp{x} for hexadecimal, or @samp{d} for decimal.
 3002: @c 
 3003: それぞれの文字列の前に,ファイル内部でのオフセットを出力します.単一文字
 3004: の引数を指定した場合,オフセットの基数を指定します --- 8進数に対する
 3005: @samp{o},16進数に対する@samp{x},または10進数に対する@samp{d}になります.
 3006: 
 3007: @item -e @var{encoding}
 3008: @itemx --encoding=@var{encoding}
 3009: @c Select the character encoding of the strings that are to be found.
 3010: @c Possible values for @var{encoding} are: @samp{s} = single-byte
 3011: @c characters (ASCII, ISO 8859, etc., default), @samp{b} = 16-bit
 3012: @c Bigendian, @samp{l} = 16-bit Littleendian, @samp{B} = 32-bit Bigendian,
 3013: @c @samp{L} = 32-bit Littleendian. Useful for finding wide character
 3014: @c strings.
 3015: @c 
 3016: 見つかった文字列の文字のエンコードを選択します.@var{encoding}に対して利
 3017: 用可能な値は以下のとおりです.@samp{s} = シングルバイト文字(ASCII,ISO
 3018: 8859等,デフォルトです),@samp{b} = 16ビットビッグエンディアン,@samp{l}
 3019: = 16ビットリトルエンディアン,@samp{B} = 32ビットビッグエンディアン,
 3020: @samp{L} = 32ビットリトルエンディアン.ワイド文字の文字列を見つけるとき
 3021: 役に立ちます.
 3022: 
 3023: @item --target=@var{bfdname}
 3024: @cindex object code format
 3025: @c Specify an object code format other than your system's default format.
 3026: @c @xref{Target Selection}, for more information.
 3027: @c 
 3028: システムのデフォルトのフォーマット以外のオブジェクトコードのフォーマット
 3029: を指定します.詳細は,@xref{Target Selection}.
 3030: 
 3031: @item -v
 3032: @itemx --version
 3033: @c Print the program version number on the standard output and exit.
 3034: @c 
 3035: プログラムのバージョンナンバーを標準出力に出力し終了します.
 3036: @end table
 3037: 
 3038: @c man end
 3039: 
 3040: @ignore
 3041: @c man begin SEEALSO strings
 3042: ar(1), nm(1), objdump(1), ranlib(1), readelf(1)
 3043: and the Info entries for @file{binutils}.
 3044: @c man end
 3045: @end ignore
 3046: 
 3047: @node strip
 3048: @chapter strip
 3049: 
 3050: @kindex strip
 3051: @cindex removing symbols
 3052: @cindex discarding symbols
 3053: @cindex symbols, discarding
 3054: 
 3055: @c man title strip Discard symbols from object files.
 3056: 
 3057: @smallexample
 3058: @c man begin SYNOPSIS strip
 3059: strip [@option{-F} @var{bfdname} |@option{--target=}@var{bfdname} ]
 3060:       [@option{-I} @var{bfdname} |@option{--input-target=}@var{bfdname} ]
 3061:       [@option{-O} @var{bfdname} |@option{--output-target=}@var{bfdname} ]
 3062:       [@option{-s}|@option{--strip-all}] [@option{-S}|@option{-g}|@option{-d}|@option{--strip-debug}]
 3063:       [@option{-K} @var{symbolname} |@option{--keep-symbol=}@var{symbolname} ]
 3064:       [@option{-N} @var{symbolname} |@option{--strip-symbol=}@var{symbolname} ]
 3065:       [@option{-x}|@option{--discard-all} ] [@option{-X} |@option{--discard-locals}]
 3066:       [@option{-R} @var{sectionname} |@option{--remove-section=}@var{sectionname} ]
 3067:       [@option{-o} @var{file} ] [@option{-p}|@option{--preserve-dates}]
 3068:       [@option{-v} |@option{--verbose}]  [@option{-V}|@option{--version}] [@option{--help}]
 3069:       @var{objfile}@dots{}
 3070: @c man end
 3071: @end smallexample
 3072: 
 3073: @c man begin DESCRIPTION strip
 3074: 
 3075: @c @sc{gnu} @command{strip} discards all symbols from object files
 3076: @c @var{objfile}.  The list of object files may include archives.
 3077: @c At least one object file must be given.
 3078: @c 
 3079: @sc{gnu} @command{strip}は,オブジェクトファイル@var{objfile}からシンボ
 3080: ルをすべて廃棄します.オブジェクトファイルのリストには,アーカイブを含め
 3081: てもかまいません.少なくとも一つのオブジェクトファイルを与える必要があり
 3082: ます.
 3083: 
 3084: @c @command{strip} modifies the files named in its argument,
 3085: @c rather than writing modified copies under different names.
 3086: @c 
 3087: @command{strip}は,異なる名前に編集されたものを書き出すのではなく,その
 3088: 引数で指名されたファイルを変更します.
 3089: 
 3090: @c man end
 3091: 
 3092: @c man begin OPTIONS strip
 3093: 
 3094: @table @env
 3095: @item -F @var{bfdname}
 3096: @itemx --target=@var{bfdname}
 3097: @c Treat the original @var{objfile} as a file with the object
 3098: @c code format @var{bfdname}, and rewrite it in the same format.
 3099: @c @xref{Target Selection}, for more information.
 3100: @c 
 3101: オリジナルの@var{objfile}を,オブジェクトコードのフォーマット
 3102: @var{bfdname}を用いたファイルとして扱い,同じフォーマットで再書き込みし
 3103: ます.詳細は,@xref{Target Selection}.
 3104: 
 3105: @item --help
 3106: @c Show a summary of the options to @command{strip} and exit.
 3107: @c 
 3108: @command{strip}へのオプションの概要を表示し終了します.
 3109: 
 3110: @item -I @var{bfdname}	
 3111: @itemx --input-target=@var{bfdname}
 3112: @c Treat the original @var{objfile} as a file with the object
 3113: @c code format @var{bfdname}.
 3114: @c @xref{Target Selection}, for more information.
 3115: @c 
 3116: オリジナルの@var{objfile}を,オブジェクトコードのフォーマット
 3117: @var{bfdname}を用いたファイルとして扱います.詳細は,@xref{Target
 3118: Selection}.
 3119: 
 3120: @item -O @var{bfdname}
 3121: @itemx --output-target=@var{bfdname}
 3122: @c Replace @var{objfile} with a file in the output format @var{bfdname}.
 3123: @c @xref{Target Selection}, for more information.
 3124: @c 
 3125: @var{objfile}を,出力フォーマット@var{bfdname}のファイルで置換します.詳
 3126: 細は,@xref{Target Selection}.
 3127: 
 3128: @item -R @var{sectionname}
 3129: @itemx --remove-section=@var{sectionname}
 3130: @c Remove any section named @var{sectionname} from the output file.  This
 3131: @c option may be given more than once.  Note that using this option
 3132: @c inappropriately may make the output file unusable.
 3133: @c 
 3134: @var{sectionname}で指名されたすべてのセクションを,出力ファイルから削除
 3135: します.このオプションは一回以上与えてもかまいません.このオプションを使
 3136: 用すると,不適切にも出力ファイルを利用不可能にする可能性があることに注意
 3137: してください.
 3138: 
 3139: @item -s
 3140: @itemx --strip-all
 3141: @c Remove all symbols.
 3142: @c 
 3143: すべてのシンボルを削除します.
 3144: 
 3145: @item -g
 3146: @itemx -S
 3147: @itemx -d
 3148: @itemx --strip-debug
 3149: @c Remove debugging symbols only.
 3150: @c 
 3151: デバッグシンボルのみ削除します.
 3152: 
 3153: @item --strip-unneeded
 3154: @c Remove all symbols that are not needed for relocation processing.
 3155: @c 
 3156: 再配置の処理に不要なすべてのシンボルを削除します.
 3157: 
 3158: @item -K @var{symbolname}
 3159: @itemx --keep-symbol=@var{symbolname}
 3160: @c Keep only symbol @var{symbolname} from the source file.  This option may
 3161: @c be given more than once.
 3162: @c 
 3163: シンボル@var{symbolname}のみ,ソースファイルに保存します.このオプション
 3164: は一回以上与えてもかまいません.
 3165: 
 3166: @item -N @var{symbolname}
 3167: @itemx --strip-symbol=@var{symbolname}
 3168: @c Remove symbol @var{symbolname} from the source file. This option may be
 3169: @c given more than once, and may be combined with strip options other than
 3170: @c @option{-K}.
 3171: @c 
 3172: シンボル@var{symbolname}をソースファイルから削除します.このオプションは
 3173: 一回以上与えたり,@option{-K}以外の@command{strip}オプションと組み合わせ
 3174: たりしてもかまいません.
 3175: 
 3176: @item -o @var{file}
 3177: @c Put the stripped output in @var{file}, rather than replacing the
 3178: @c existing file.  When this argument is used, only one @var{objfile}
 3179: @c argument may be specified.
 3180: @c 
 3181: 既存のファイルを置換するのではなく,@command{strip}された出力を
 3182: @var{file}に書き込みます.この引数が使用されたとき,一つの@var{objfile}
 3183: 引数のみ指定可能です.
 3184: 
 3185: @item -p
 3186: @itemx --preserve-dates
 3187: @c Preserve the access and modification dates of the file.
 3188: @c 
 3189: ファイルのアクセスと編集の日付を保持します.
 3190: 
 3191: @item -x
 3192: @itemx --discard-all
 3193: @c Remove non-global symbols.
 3194: @c 
 3195: グローバルでないシンボルを削除します.
 3196: 
 3197: @item -X
 3198: @itemx --discard-locals
 3199: @c Remove compiler-generated local symbols.
 3200: @c (These usually start with @samp{L} or @samp{.}.)
 3201: @c 
 3202: コンパイラが生成したローカルシンボルを削除します.(これらは通常,
 3203: @samp{L}または@samp{.}で始まります.)
 3204: 
 3205: @item -V
 3206: @itemx --version
 3207: @c Show the version number for @command{strip}.
 3208: @c 
 3209: @command{strip}のバージョンナンバーを表示します.
 3210: 
 3211: @item -v
 3212: @itemx --verbose
 3213: @c Verbose output: list all object files modified.  In the case of
 3214: @c archives, @samp{strip -v} lists all members of the archive.
 3215: @c 
 3216: 冗長な出力です.編集されたすべてのオブジェクトファイルをリストアップしま
 3217: す.アーカイブの場合,@samp{strip -v}はアーカイブのすべてのメンバーをリ
 3218: ストアップします.
 3219: @end table
 3220: 
 3221: @c man end
 3222: 
 3223: @ignore
 3224: @c man begin SEEALSO strip
 3225: the Info entries for @file{binutils}.
 3226: @c man end
 3227: @end ignore
 3228: 
 3229: @node c++filt, addr2line, strip, Top
 3230: @chapter c++filt
 3231: 
 3232: @kindex c++filt
 3233: @cindex demangling C++ symbols
 3234: 
 3235: @c man title cxxfilt Demangle C++ and Java symbols.
 3236: 
 3237: @smallexample
 3238: @c man begin SYNOPSIS cxxfilt
 3239: c++filt [@option{-_}|@option{--strip-underscores}]
 3240:         [@option{-j}|@option{--java}]
 3241:         [@option{-n}|@option{--no-strip-underscores}]
 3242:         [@option{-s} @var{format}|@option{--format=}@var{format}]
 3243:         [@option{--help}]  [@option{--version}]  [@var{symbol}@dots{}]
 3244: @c man end
 3245: @end smallexample
 3246: 
 3247: @c man begin DESCRIPTION cxxfilt
 3248: 
 3249: @kindex cxxfilt
 3250: @c The C++ and Java languages provides function overloading, which means
 3251: @c that you can write many functions with the same name (providing each
 3252: @c takes parameters of different types).  All C++ and Java function names
 3253: @c are encoded into a low-level assembly label (this process is known as
 3254: @c @dfn{mangling}). The @command{c++filt}
 3255: @c @footnote{MS-DOS does not allow @kbd{+} characters in file names, so on
 3256: @c MS-DOS this program is named @command{cxxfilt}.}
 3257: @c program does the inverse mapping: it decodes (@dfn{demangles}) low-level
 3258: @c names into user-level names so that the linker can keep these overloaded
 3259: @c functions from clashing.
 3260: @c 
 3261: C++とJava言語は,関数のオーバーロードを提供し,それは(それぞれ異なる型の
 3262: パラメータの受け入れを提供する)同じ名前で複数の関数を書くことが可能だと
 3263: いうことを意味します.すべてのC++とJavaの関数名は,低レベルのアセンブリ
 3264: ラベルに符号化されます(この処理は@dfn{mangling}として知られています.)
 3265: @command{c++filt}@footnote{MS-DOSは,ファイル名に@kbd{+}文字が使用できな
 3266: いので,MS-DOS上でのこのプログラムは@code{cxxfilt}と命名されます.}プロ
 3267: グラムは,マッピングを反転します.それは,これらのオーバーロードされた関
 3268: 数を破壊することから,リンカが守ることができるように,低レベルの名前をユー
 3269: ザレベルの名前に復号(@dfn{demangles})します.
 3270: 
 3271: @c Every alphanumeric word (consisting of letters, digits, underscores,
 3272: @c dollars, or periods) seen in the input is a potential label.  If the
 3273: @c label decodes into a C++ name, the C++ name replaces the low-level
 3274: @c name in the output.
 3275: @c 
 3276: 入力にあるすべての英数単語(文字,数字,アンダースコア,ドル記号,または
 3277: ピリオド)は,ポテンシャルラベルと考えられます.ラベルをC++の名前に復号す
 3278: る場合,C++の名前は出力で低レベルの名前に置換されます.
 3279: 
 3280: @c You can use @command{c++filt} to decipher individual symbols:
 3281: @c 
 3282: 個別のシンボルを解読するために@command{c++filt}を使用することが可能です.
 3283: 
 3284: @example
 3285: c++filt @var{symbol}
 3286: @end example
 3287: 
 3288: @c If no @var{symbol} arguments are given, @command{c++filt} reads symbol
 3289: @c names from the standard input and writes the demangled names to the
 3290: @c standard output.  All results are printed on the standard output.
 3291: @c 
 3292: @var{symbol}引数が与えられた場合,@command{c++filt}は,シンボル名を標準
 3293: 入力から読み込み,demangleされた名前を標準出力に書き出します.すべての結
 3294: 果は,標準出力に出力されます.
 3295: 
 3296: @c man end
 3297: 
 3298: @c man begin OPTIONS cxxfilt
 3299: 
 3300: @table @env
 3301: @item -_
 3302: @itemx --strip-underscores
 3303: @c On some systems, both the C and C++ compilers put an underscore in front
 3304: @c of every name.  For example, the C name @code{foo} gets the low-level
 3305: @c name @code{_foo}.  This option removes the initial underscore.  Whether
 3306: @c @command{c++filt} removes the underscore by default is target dependent.
 3307: @c 
 3308: システムによっては,CとC++のコンパイラが,すべての名前の前にアンダースコ
 3309: アを書き込むものもあります.例えば,Cでの名前@code{foo}が,低レベルでは
 3310: 名前@code{_foo}になります.このオプションは,最初のアンダースコアを削除
 3311: します.@command{c++filt}がデフォルトでアンダースコアを削除するかどうか
 3312: はターゲットに依存します.
 3313: 
 3314: @item -j
 3315: @itemx --java
 3316: @c Prints demangled names using Java syntax.  The default is to use C++
 3317: @c syntax.
 3318: @c 
 3319: demangleされた名前を,Javaの構文を用いて出力します.デフォルトは,C++の
 3320: 構文の使用です.
 3321: 
 3322: @item -n
 3323: @itemx --no-strip-underscores
 3324: @c Do not remove the initial underscore.
 3325: @c 
 3326: 最初のアンダースコアを削除しません.
 3327: 
 3328: @item -s @var{format}
 3329: @itemx --format=@var{format}
 3330: @c @sc{gnu} @command{nm} can decode three different methods of mangling, used by
 3331: @c different C++ compilers.  The argument to this option selects which
 3332: @c method it uses:
 3333: @c 
 3334: @sc{gnu} @command{nm}は,異なるC++コンパイラが使用されてmangleしている,
 3335: 三つの異なるメソッドを復号することが可能です.このオプションの引数は,使
 3336: 用されているメソッドを選択します.
 3337: 
 3338: @table @code
 3339: @item gnu
 3340: @c the one used by the @sc{gnu} compiler (the default method)
 3341: @c 
 3342: @sc{gnu}コンパイラで使用されるもの(デフォルトメソッド).
 3343: @item lucid
 3344: @c the one used by the Lucid compiler
 3345: @c 
 3346: Lucidコンパイラで使用されるもの.
 3347: @item arm
 3348: @c the one specified by the C++ Annotated Reference Manual
 3349: @c 
 3350: C++ Annotated Reference Manualで指定されるもの.
 3351: @item hp
 3352: @c the one used by the HP compiler
 3353: @c 
 3354: HPコンパイラで使用されるもの.
 3355: @item edg
 3356: @c the one used by the EDG compiler
 3357: @c 
 3358: EDGコンパイラで使用されるもの.
 3359: @item gnu-new-abi
 3360: @c the one used by the @sc{gnu} compiler with the new ABI.
 3361: @c 
 3362: 新しいABIを用いた@sc{gnu}コンパイラで使用されるもの.
 3363: @end table
 3364: 
 3365: @item --help
 3366: @c Print a summary of the options to @command{c++filt} and exit.
 3367: @c 
 3368: @command{c++filt}のオプションの概要を出力し終了します.
 3369: 
 3370: @item --version
 3371: @c Print the version number of @command{c++filt} and exit.
 3372: @c 
 3373: @command{c++filt}のバージョンナンバーを出力し終了します.
 3374: @end table
 3375: 
 3376: @c man end
 3377: 
 3378: @ignore
 3379: @c man begin SEEALSO cxxfilt
 3380: the Info entries for @file{binutils}.
 3381: @c man end
 3382: @end ignore
 3383: 
 3384: @quotation
 3385: @c @emph{Warning:} @command{c++filt} is a new utility, and the details of its
 3386: @c user interface are subject to change in future releases.  In particular,
 3387: @c a command-line option may be required in the the future to decode a name
 3388: @c passed as an argument on the command line; in other words, 
 3389: @c 
 3390: @emph{警告:} @command{c++filt}は,新しいユーティリティで,そのユーザイン
 3391: ターフェースの詳細は将来のリリースで変更を受けやすくなっています.特に,
 3392: コマンドラインの引数として渡される名前を復号するために,コマンドラインオ
 3393: プションが,将来要求されるかもしれません.言い換えると以下のようになると
 3394: いうことです.
 3395: 
 3396: @example
 3397: c++filt @var{symbol}
 3398: @end example
 3399: 
 3400: @noindent
 3401: @c may in a future release become
 3402: @c 
 3403: これが,将来のリリースでは,以下のようになるかもしれません.
 3404: 
 3405: @example
 3406: c++filt @var{option} @var{symbol}
 3407: @end example
 3408: @end quotation
 3409: 
 3410: @node addr2line
 3411: @chapter addr2line
 3412: 
 3413: @kindex addr2line
 3414: @cindex address to file name and line number
 3415: 
 3416: @c man title addr2line convert addresses into file names and line numbers.
 3417: 
 3418: @smallexample
 3419: @c man begin SYNOPSIS addr2line
 3420: addr2line [@option{-b} @var{bfdname}|@option{--target=}@var{bfdname}]
 3421:           [@option{-C}|@option{--demangle}[=@var{style}]]
 3422:           [@option{-e} @var{filename}|@option{--exe=}@var{filename}]
 3423:           [@option{-f}|@option{--functions}] [@option{-s}|@option{--basename}]
 3424:           [@option{-H}|@option{--help}] [@option{-V}|@option{--version}]
 3425:           [addr addr @dots{}]
 3426: @c man end
 3427: @end smallexample
 3428: 
 3429: @c man begin DESCRIPTION addr2line
 3430: 
 3431: @c @command{addr2line} translates program addresses into file names and line
 3432: @c numbers.  Given an address and an executable, it uses the debugging
 3433: @c information in the executable to figure out which file name and line
 3434: @c number are associated with a given address.
 3435: @c 
 3436: @command{addr2line}は,プログラムアドレスをファイル名と行番号に変換しま
 3437: す.アドレスと実行形式が与えられた場合,ファイル名と行番号が与えられたア
 3438: ドレスに関連していることを判別するため,それは実行形式内のデバッグ情報を
 3439: 使用します.
 3440: 
 3441: @c The executable to use is specified with the @option{-e} option.  The
 3442: @c default is the file @file{a.out}.
 3443: @c 
 3444: 使用する実行形式は,@option{-e}オプションで指定されます.デフォルトは,
 3445: ファイル@file{a.out}です.
 3446: 
 3447: @c @command{addr2line} has two modes of operation.
 3448: @c 
 3449: @command{addr2line}には,二つの処理モードがあります.
 3450: 
 3451: @c In the first, hexadecimal addresses are specified on the command line,
 3452: @c and @command{addr2line} displays the file name and line number for each
 3453: @c address.
 3454: @c 
 3455: 最初のものは,16進のアドレスがコマンドラインで指定され,
 3456: @command{addr2line}は,それぞれのアドレスに対しファイル名と行番号を表示
 3457: します.
 3458: 
 3459: @c In the second, @command{addr2line} reads hexadecimal addresses from
 3460: @c standard input, and prints the file name and line number for each
 3461: @c address on standard output.  In this mode, @command{addr2line} may be used
 3462: @c in a pipe to convert dynamically chosen addresses.
 3463: @c 
 3464: 二番目のものは,@command{addr2line}が16進のアドレスと標準入力から読み込
 3465: み,それぞれのアドレスに対し,ファイル名と行番号を標準出力に出力します.
 3466: このモードでは,@command{addr2line}は,動的に選択されたアドレスを変換す
 3467: るパイプとして使用可能です.
 3468: 
 3469: @c The format of the output is @samp{FILENAME:LINENO}.  The file name and
 3470: @c line number for each address is printed on a separate line.  If the
 3471: @c @command{-f} option is used, then each @samp{FILENAME:LINENO} line is
 3472: @c preceded by a @samp{FUNCTIONNAME} line which is the name of the function
 3473: @c containing the address.
 3474: @c 
 3475: 出力の書式は,@samp{FILENAME:LINENO}です.それぞれのアドレスに対するファ
 3476: イル名と行番号は,個別の行に出力されます.@option{-f}オプションが使用さ
 3477: れた場合,それぞれの@samp{FILENAME:LINENO}行に,アドレスに含まれる関数名
 3478: @samp{FUNCTIONNAME}が前置されます.
 3479: 
 3480: @c If the file name or function name can not be determined,
 3481: @c @command{addr2line} will print two question marks in their place.  If the
 3482: @c line number can not be determined, @command{addr2line} will print 0.
 3483: @c 
 3484: ファイル名と関数名を決定することが不可能な場合,@command{addr2line}は二
 3485: つの疑問符をその場所に出力します.行番号を決定することが不可能な場合,
 3486: @command{addr2line}は,0を出力します.
 3487: 
 3488: @c man end
 3489: 
 3490: @c man begin OPTIONS addr2line
 3491: 
 3492: @c The long and short forms of options, shown here as alternatives, are
 3493: @c equivalent.
 3494: @c 
 3495: 以下で交互に表示している,オプションの長い形式と短い形式は等価です.
 3496: 
 3497: @table @env
 3498: @item -b @var{bfdname}
 3499: @itemx --target=@var{bfdname}
 3500: @cindex object code format
 3501: @c Specify that the object-code format for the object files is
 3502: @c @var{bfdname}.
 3503: @c 
 3504: オブジェクトファイルに対するオブジェクトコードを@var{bfdname}として指定
 3505: します.
 3506: 
 3507: @item -C
 3508: @itemx --demangle[=@var{style}]
 3509: @cindex demangling in objdump
 3510: @c Decode (@dfn{demangle}) low-level symbol names into user-level names.
 3511: @c Besides removing any initial underscore prepended by the system, this
 3512: @c makes C++ function names readable.  Different compilers have different
 3513: @c mangling styles. The optional demangling style argument can be used to 
 3514: @c choose an appropriate demangling style for your compiler. @xref{c++filt}, 
 3515: @c for more information on demangling.
 3516: @c 
 3517: 低レベルのシンボル名をユーザレベル名に復号(@dfn{demangle})します.システ
 3518: ムによって前置される,すべての最初のアンダースコアを削除する他に,これは
 3519: C++関数名を可読にします.異なるコンパイラでは,mangle形式が異なります.
 3520: 追加のdemangle形式の引数は,コンパイラに対する適切なdemangle形式を選択す
 3521: るために使用可能です.demangleの情報は,@xref{c++filt}.
 3522: 
 3523: @item -e @var{filename}
 3524: @itemx --exe=@var{filename}
 3525: @c Specify the name of the executable for which addresses should be
 3526: @c translated.  The default file is @file{a.out}.
 3527: @c 
 3528: 変換したいアドレスに対する実行形式の名前を指定します.デフォルトファイル
 3529: は@code{a.out}です.
 3530: 
 3531: @item -f
 3532: @itemx --functions
 3533: @c Display function names as well as file and line number information.
 3534: @c 
 3535: ファイルと行番号の情報と同様に,関数名も表示します.
 3536: 
 3537: @item -s
 3538: @itemx --basenames
 3539: @c Display only the base of each file name.
 3540: @c 
 3541: それぞれのファイル名のベースのみ表示します.
 3542: @end table
 3543: 
 3544: @c man end
 3545: 
 3546: @ignore
 3547: @c man begin SEEALSO addr2line
 3548: Info entries for @file{binutils}.
 3549: @c man end
 3550: @end ignore
 3551: 
 3552: @node nlmconv
 3553: @chapter nlmconv
 3554: 
 3555: @c @command{nlmconv} converts a relocatable object file into a NetWare
 3556: @c Loadable Module.
 3557: @c 
 3558: @command{nlmconv}は,再配置可能なオブジェクトファイルをNetWare Loadable
 3559: Moduleに変換します.
 3560: 
 3561: @ignore
 3562: @command{nlmconv} currently works with @samp{i386} object
 3563: files in @code{coff}, @sc{elf}, or @code{a.out} format, and @sc{SPARC}
 3564: object files in @sc{elf}, or @code{a.out} format@footnote{
 3565: @command{nlmconv} should work with any @samp{i386} or @sc{sparc} object
 3566: format in the Binary File Descriptor library.  It has only been tested
 3567: with the above formats.}.
 3568: @end ignore
 3569: 
 3570: @quotation
 3571: @c @emph{Warning:} @command{nlmconv} is not always built as part of the binary
 3572: @c utilities, since it is only useful for NLM targets.
 3573: @c 
 3574: @emph{警告:} @command{nlmconv}は,NLMターゲットに対してのみ役に立つので,
 3575: 常にバイナリユーティリティの一部として構築されるわけではありません.
 3576: @end quotation
 3577: 
 3578: @c man title nlmconv converts object code into an NLM.
 3579: 
 3580: @smallexample
 3581: @c man begin SYNOPSIS nlmconv
 3582: nlmconv [@option{-I} @var{bfdname}|@option{--input-target=}@var{bfdname}]
 3583:         [@option{-O} @var{bfdname}|@option{--output-target=}@var{bfdname}]
 3584:         [@option{-T} @var{headerfile}|@option{--header-file=}@var{headerfile}]
 3585:         [@option{-d}|@option{--debug}] [@option{-l} @var{linker}|@option{--linker=}@var{linker}]
 3586:         [@option{-h}|@option{--help}] [@option{-V}|@option{--version}]
 3587:         @var{infile} @var{outfile}
 3588: @c man end
 3589: @end smallexample
 3590: 
 3591: @c man begin DESCRIPTION nlmconv
 3592: 
 3593: @c @command{nlmconv} converts the relocatable @samp{i386} object file
 3594: @c @var{infile} into the NetWare Loadable Module @var{outfile}, optionally
 3595: @c reading @var{headerfile} for NLM header information.  For instructions
 3596: @c on writing the NLM command file language used in header files, see the
 3597: @c @samp{linkers} section, @samp{NLMLINK} in particular, of the @cite{NLM
 3598: @c Development and Tools Overview}, which is part of the NLM Software
 3599: @c Developer's Kit (``NLM SDK''), available from Novell, Inc.
 3600: @c @command{nlmconv} uses the @sc{gnu} Binary File Descriptor library to read
 3601: @c @var{infile};
 3602: @c 
 3603: @command{nlmconv}は,再配置可能な@samp{i386}オブジェクトファイル
 3604: @var{infile}をNetWare Loadable Module @var{outfile}に変換し,さらに,NLM 
 3605: ヘッダ情報に対する@var{headerfile}を読み込みます.ヘッダで使用されている
 3606: NLMコマンドファイル言語を書くことに関する説明は, Novell, Inc.で利用可能
 3607: な,NLM Software Developer's Kit (``NLM SDK'')の一部である,@cite{NLM
 3608: Development and Tools Overview}の,@samp{linkers}セクションの特定の
 3609: @samp{NLMLINK}を参照してください.@command{nlmconv}は,@var{infile}を読
 3610: み込むために,@sc{gnu} Binary File Descriptorライブラリを使用します.
 3611: @ifclear man
 3612: @c see @ref{BFD,,BFD,ld.info,Using LD}, for more information.
 3613: @c 
 3614: 詳細は,@ref{BFD,,BFD,ld.info,Using LD},を参照してください.
 3615: @end ifclear
 3616: 
 3617: @c @command{nlmconv} can perform a link step.  In other words, you can list
 3618: @c more than one object file for input if you list them in the definitions
 3619: @c file (rather than simply specifying one input file on the command line).
 3620: @c In this case, @command{nlmconv} calls the linker for you.
 3621: @c 
 3622: @command{nlmconv}はリンクステップを実行することが可能です.言い換えると,
 3623: (コマンドラインで一つの入力ファイルを単に指定するのではなく)定義ファイル
 3624: でリストアップした場合,入力に対して一つ以上のオブジェクトファイルをリス
 3625: トアップすることが可能です.この場合,@command{nlmconv}はリンカを呼び出
 3626: します.
 3627: 
 3628: @c man end
 3629: 
 3630: @c man begin OPTIONS nlmconv
 3631: 
 3632: @table @env
 3633: @item -I @var{bfdname}
 3634: @itemx --input-target=@var{bfdname}
 3635: @c Object format of the input file.  @command{nlmconv} can usually determine
 3636: @c the format of a given file (so no default is necessary).
 3637: @c @xref{Target Selection}, for more information.
 3638: @c 
 3639: 入力ファイルのオブジェクトフォーマットです.@command{nlmconv}は,通常与
 3640: えられたファイルのフォーマットを決定することが可能です(そのためデフォル
 3641: トは不要です).詳細は,@xref{Target Selection}.
 3642: 
 3643: @item -O @var{bfdname}
 3644: @itemx --output-target=@var{bfdname}
 3645: @c Object format of the output file.  @command{nlmconv} infers the output
 3646: @c format based on the input format, e.g. for a @samp{i386} input file the
 3647: @c output format is @samp{nlm32-i386}.
 3648: @c @xref{Target Selection}, for more information.
 3649: @c 
 3650: 出力ファイルのオブジェクトのフォーマットです.@command{nlmconv}は,出力
 3651: のフォーマットを入力のフォーマットを元に推測し,例えば,@samp{i386}入力
 3652: ファイルに対する出力のフォーマットは,@samp{nlm32-i386}になります.詳細
 3653: は,@xref{Target Selection}.
 3654: 
 3655: @item -T @var{headerfile}
 3656: @itemx --header-file=@var{headerfile}
 3657: @c Reads @var{headerfile} for NLM header information.  For instructions on
 3658: @c writing the NLM command file language used in header files, see@ see the
 3659: @c @samp{linkers} section, of the @cite{NLM Development and Tools
 3660: @c Overview}, which is part of the NLM Software Developer's Kit, available
 3661: @c from Novell, Inc.
 3662: @c 
 3663: NLMヘッダ情報のために@var{headerfile}を読み込みます.ヘッダファイルで使
 3664: 用されているNLMコマンドファイルの言語を書くときの命令については,Novell,
 3665: Inc. で利用可能なNLM Software Developer's Kitの一部となっている,
 3666: @cite{NLM Development and Tools Overview}の@samp{linkers}セクションを参
 3667: 照してください.
 3668: 
 3669: @item -d
 3670: @itemx --debug
 3671: @c Displays (on standard error) the linker command line used by @command{nlmconv}.
 3672: @c 
 3673: @command{nlmconv}が使用しているリンカコマンドラインを(標準エラー出力に)
 3674: 表示します.
 3675: 
 3676: @item -l @var{linker}
 3677: @itemx --linker=@var{linker}
 3678: @c Use @var{linker} for any linking.  @var{linker} can be an absolute or a
 3679: @c relative pathname.
 3680: @c 
 3681: すべてのリンクで@var{linker}を使用します.@var{linker}は,絶対パス名また
 3682: は相対パス名が可能です.
 3683: 
 3684: @item -h
 3685: @itemx --help
 3686: @c Prints a usage summary.
 3687: @c 
 3688: 使用方法の概要を出力します.
 3689: 
 3690: @item -V
 3691: @itemx --version
 3692: @c Prints the version number for @command{nlmconv}.
 3693: @c 
 3694: @command{nlmconv}のバージョンナンバーを出力します.
 3695: @end table
 3696: 
 3697: @c man end
 3698: 
 3699: @ignore
 3700: @c man begin SEEALSO nlmconv
 3701: the Info entries for @file{binutils}.
 3702: @c man end
 3703: @end ignore
 3704: 
 3705: @node windres
 3706: @chapter windres
 3707: 
 3708: @c @command{windres} may be used to manipulate Windows resources.
 3709: @c 
 3710: @command{windres}は,Windowsのリソースを操作することに使用可能です.
 3711: 
 3712: @quotation
 3713: @c @emph{Warning:} @command{windres} is not always built as part of the binary
 3714: @c utilities, since it is only useful for Windows targets.
 3715: @c 
 3716: @emph{警告:} @command{windres}は,Windowsターゲットに対してのみ役に立つ
 3717: ので,常にバイナリユーティリティの一部として構築されるわけではありません.
 3718: @end quotation
 3719: 
 3720: @c man title windres manipulate Windows resources.
 3721: 
 3722: @smallexample
 3723: @c man begin SYNOPSIS windres
 3724: windres [options] [input-file] [output-file]
 3725: @c man end
 3726: @end smallexample
 3727: 
 3728: @c man begin DESCRIPTION windres
 3729: 
 3730: @c @command{windres} reads resources from an input file and copies them into
 3731: @c an output file.  Either file may be in one of three formats:
 3732: @c 
 3733: @command{windres}はリソースを入力ファイルから読み込み,それを出力ファイ
 3734: ルにコピーします.ファイルは以下の三つの形式のいずれか一つが可能です.
 3735: 
 3736: @table @code
 3737: @item rc
 3738: @c A text format read by the Resource Compiler.
 3739: @c 
 3740: リソースコンパイラで読み込むテキスト形式.
 3741: 
 3742: @item res
 3743: @c A binary format generated by the Resource Compiler.
 3744: @c 
 3745: リソースコンパイラが生成したバイナリ形式.
 3746: 
 3747: @item coff
 3748: @c A COFF object or executable.
 3749: @c 
 3750: COFFオブジェクト,または,実行形式.
 3751: @end table
 3752: 
 3753: @c The exact description of these different formats is available in
 3754: @c documentation from Microsoft.
 3755: @c 
 3756: これらの形式の差異の正確な記述は,Microsoftのドキュメントで利用可能です.
 3757: 
 3758: @c When @command{windres} converts from the @code{rc} format to the @code{res}
 3759: @c format, it is acting like the Windows Resource Compiler.  When
 3760: @c @command{windres} converts from the @code{res} format to the @code{coff}
 3761: @c format, it is acting like the Windows @code{CVTRES} program.
 3762: @c 
 3763: @command{windres}が@code{rc}形式から@code{res}形式に変換するとき,それは
 3764: Windows Resource Compilerのように動作します.@command{windres}が
 3765: @code{res}形式から@code{coff}形式に変換するとき,それはWindows
 3766: @code{CVTRES}プログラムのように動作します.
 3767: 
 3768: @c When @command{windres} generates an @code{rc} file, the output is similar
 3769: @c but not identical to the format expected for the input.  When an input
 3770: @c @code{rc} file refers to an external filename, an output @code{rc} file
 3771: @c will instead include the file contents.
 3772: @c 
 3773: @command{windres}が@code{rc}ファイルを生成するとき,出力は似ていますが,
 3774: 入力で期待される形式と同一ではありません.入力@code{rc}ファイルが外部の
 3775: ファイル名を参照するとき,出力@code{rc}ファイルは,その代わりにファイル
 3776: の内容を含めます.
 3777: 
 3778: @c If the input or output format is not specified, @command{windres} will
 3779: @c guess based on the file name, or, for the input file, the file contents.
 3780: @c A file with an extension of @file{.rc} will be treated as an @code{rc}
 3781: @c file, a file with an extension of @file{.res} will be treated as a
 3782: @c @code{res} file, and a file with an extension of @file{.o} or
 3783: @c @file{.exe} will be treated as a @code{coff} file.
 3784: @c 
 3785: 入力や出力の形式が指定されていない場合,@command{windres}はファイル名,
 3786: または,入力ファイルのファイルの内容を基に推測します.@file{.rc}の拡張子
 3787: を持つファイルは,@code{rc}ファイルとして扱われ,@file{.res}の拡張子を持
 3788: つファイルは,@code{res}ファイルとして扱われ,そして,@file{.o}や
 3789: @file{.exe}の拡張子を持つファイルは,@code{coff}ファイルとして扱われます.
 3790: 
 3791: @c If no output file is specified, @command{windres} will print the resources
 3792: @c in @code{rc} format to standard output.
 3793: @c 
 3794: 出力ファイルが指定されない場合,@command{windres}は,@code{rc}形式内のリ
 3795: ソースを標準出力に出力します.
 3796: 
 3797: @c The normal use is for you to write an @code{rc} file, use @command{windres}
 3798: @c to convert it to a COFF object file, and then link the COFF file into
 3799: @c your application.  This will make the resources described in the
 3800: @c @code{rc} file available to Windows.
 3801: @c 
 3802: @code{rc}を書き,COFFオブジェクトファイルに変換するために
 3803: @command{windres}を使用し,COFFファイルをアプリケーションにリンクするの
 3804: が通常の使用方法です.これは,@code{rc}ファイルのリソースの記述を,
 3805: Windowsで利用可能にします.
 3806: 
 3807: @c man end
 3808: 
 3809: @c man begin OPTIONS windres
 3810: 
 3811: @table @env
 3812: @item -i @var{filename}
 3813: @itemx --input @var{filename}
 3814: @c The name of the input file.  If this option is not used, then
 3815: @c @command{windres} will use the first non-option argument as the input file
 3816: @c name.  If there are no non-option arguments, then @command{windres} will
 3817: @c read from standard input.  @command{windres} can not read a COFF file from
 3818: @c standard input.
 3819: @c 
 3820: 入力ファイル名です.このオプションが使用されていない場合,
 3821: @command{windres}は,最初の非オプションの引数を入力ファイル名として使用
 3822: します.非オプションの引数がない場合,@command{windres}は,標準入力から
 3823: 読み込みます.@command{windres}は,COFFファイルを標準入力から読み込むこ
 3824: とは不可能です.
 3825: 
 3826: @item -o @var{filename}
 3827: @itemx --output @var{filename}
 3828: @c The name of the output file.  If this option is not used, then
 3829: @c @command{windres} will use the first non-option argument, after any used
 3830: @c for the input file name, as the output file name.  If there is no
 3831: @c non-option argument, then @command{windres} will write to standard output.
 3832: @c @command{windres} can not write a COFF file to standard output.
 3833: @c 
 3834: 出力ファイル名です.このオプションが使用されない場合,@command{windres} 
 3835: は,入力ファイル名として使用した後の,最初の非オプションの引数を出力ファ
 3836: イル名として使用します.非オプションの引数がない場合,@command{windres} 
 3837: は,標準出力に書き出します.@command{windres}は,COFFファイルを標準出力
 3838: に書き出すことは不可能です.
 3839: 
 3840: @item -I @var{format}
 3841: @itemx --input-format @var{format}
 3842: @c The input format to read.  @var{format} may be @samp{res}, @samp{rc}, or
 3843: @c @samp{coff}.  If no input format is specified, @command{windres} will
 3844: @c guess, as described above.
 3845: @c 
 3846: 読み込む入力の形式です.@var{format}は,@samp{res},@samp{rc},または
 3847: @samp{coff}が可能です.入力形式が指定されない場合,@command{windres}は,
 3848: 上記のように推測します.
 3849: 
 3850: @item -O @var{format}
 3851: @itemx --output-format @var{format}
 3852: @c The output format to generate.  @var{format} may be @samp{res},
 3853: @c @samp{rc}, or @samp{coff}.  If no output format is specified,
 3854: @c @command{windres} will guess, as described above.
 3855: @c 
 3856: 生成する出力の形式です.@var{format}は,@samp{res},@samp{rc},または
 3857: @samp{coff}が可能です.出力形式が指定されない場合,@command{windres}は,
 3858: 上記のように推測します.
 3859: 
 3860: @item -F @var{target}
 3861: @itemx --target @var{target}
 3862: @c Specify the BFD format to use for a COFF file as input or output.  This
 3863: @c is a BFD target name; you can use the @option{--help} option to see a list
 3864: @c of supported targets.  Normally @command{windres} will use the default
 3865: @c format, which is the first one listed by the @option{--help} option.
 3866: @c 
 3867: 入出力としてのCOFFに対して使用するBFDフォーマットを指定します.これは,
 3868: BFDターゲット名です.サポートされているターゲットのリストを見るために,
 3869: @option{--help}オプションが使用可能です.通常,@command{windres}はデフォ
 3870: ルトのフォーマットを使用し,それは@option{--help}オプションでリストアッ
 3871: プされる最初のものです.
 3872: @ifclear man
 3873: @ref{Target Selection}.
 3874: @end ifclear
 3875: 
 3876: @item --preprocessor @var{program}
 3877: @c When @command{windres} reads an @code{rc} file, it runs it through the C
 3878: @c preprocessor first.  This option may be used to specify the preprocessor
 3879: @c to use, including any leading arguments.  The default preprocessor
 3880: @c argument is @code{gcc -E -xc-header -DRC_INVOKED}.
 3881: @c 
 3882: @command{windres}が@code{rc}ファイルを読み込むとき,それは最初にCプリプ
 3883: ロセッサを通じて実行されます.このオプションは,使用するプリプロセッサを
 3884: 指定するために利用してもかまわず,それには引数を前置するものを含みます.
 3885: デフォルトのプリプロセッサ引数は,@code{gcc -E -xc-header -DRC_INVOKED} 
 3886: です.
 3887: 
 3888: @item --include-dir @var{directory}
 3889: @c Specify an include directory to use when reading an @code{rc} file.
 3890: @c @command{windres} will pass this to the preprocessor as an @option{-I}
 3891: @c option.  @command{windres} will also search this directory when looking for
 3892: @c files named in the @code{rc} file.
 3893: @c 
 3894: @code{rc}ファイルを読み込むとき使用する,インクルードディレクトリを指定
 3895: します.@command{windres}は,これを@option{-I}オプションとしてプリプロセッ
 3896: サに渡します.@command{windres}は,@code{rc}ファイルで指名されているファ
 3897: イルを探すとき,このディレクトリの検索も行います.
 3898: 
 3899: @item -D @var{target}
 3900: @itemx --define @var{sym}[=@var{val}]
 3901: @c Specify a @option{-D} option to pass to the preprocessor when reading an
 3902: @c @code{rc} file.
 3903: @c 
 3904: @code{rc}ファイルを読み込むとき,プリプロセッサに渡す@option{-D}オプショ
 3905: ンを指定します.
 3906: 
 3907: @item -v
 3908: @c Enable verbose mode.  This tells you what the preprocessor is if you
 3909: @c didn't specify one.
 3910: @c 
 3911: 冗長モードを可能にします.これは,プリプロセッサが指定されていない場合,
 3912: そのプリプロセッサを報告します.
 3913: 
 3914: @item --language @var{val}
 3915: @c Specify the default language to use when reading an @code{rc} file.
 3916: @c @var{val} should be a hexadecimal language code.  The low eight bits are
 3917: @c the language, and the high eight bits are the sublanguage.
 3918: @c 
 3919: @code{rc}ファイルを読み込むとき使用する,デフォルトの言語を指定します.
 3920: @var{val}は16進数の言語コードにする必要があります.下位8ビットは言語で,
 3921: 上位8ビットはサブ言語です.
 3922: 
 3923: @item --use-temp-file
 3924: @c Use a temporary file to instead of using popen to read the output of
 3925: @c the preprocessor. Use this option if the popen implementation is buggy 
 3926: @c on the host (eg., certain non-English language versions of Windows 95 and 
 3927: @c Windows 98 are known to have buggy popen where the output will instead
 3928: @c go the console).
 3929: @c 
 3930: プリプロセッサの出力を読み込むためpopenを使用する代わりに,一時ファイル
 3931: を使用します.popenの実装にバグの多いホストの場合,このオプションを使用
 3932: してください(例えば,ある非英語バージョンのWindows95とWindows98は,出力
 3933: がコンソールでないところでは,バグの多いpopenとなっていることが知られて
 3934: います).
 3935: 
 3936: @item --no-use-temp-file
 3937: @c Use popen, not a temporary file, to read the output of the preprocessor.
 3938: @c This is the default behaviour.
 3939: @c 
 3940: プリプロセッサの出力を読み込むため,一時ファイルではなくpopenを使用しま
 3941: す.これはデフォルトの動作です.
 3942: 
 3943: @item --help
 3944: @c Prints a usage summary.
 3945: @c 
 3946: 使用方法の概要を出力します.
 3947: 
 3948: @item --version
 3949: @c Prints the version number for @command{windres}.
 3950: @c 
 3951: @command{windres}のバージョンナンバーを出力します.
 3952: 
 3953: @item --yydebug
 3954: @c If @command{windres} is compiled with @code{YYDEBUG} defined as @code{1},
 3955: @c this will turn on parser debugging.
 3956: @c 
 3957: @command{windres}が@code{YYDEBUG}を@code{1}と定義してコンパイルされる場
 3958: 合,パーサデバッグを開始します.
 3959: @end table
 3960: 
 3961: @c man end
 3962: 
 3963: @ignore
 3964: @c man begin SEEALSO windres
 3965: the Info entries for @file{binutils}.
 3966: @c man end
 3967: @end ignore
 3968: 
 3969: @node dlltool
 3970: @chapter DLLを構築し使用するのに必要なファイルの作成
 3971: @cindex DLL
 3972: @kindex dlltool
 3973: 
 3974: @c @command{dlltool} may be used to create the files needed to build and use
 3975: @c dynamic link libraries (DLLs).
 3976: @c 
 3977: ダイナミックリンクライブラリ(DLL)を構築し使用するのに必要なファイルを作
 3978: 成するために,@command{dlltool}は使用されます.
 3979: 
 3980: @quotation
 3981: @c @emph{Warning:} @command{dlltool} is not always built as part of the binary
 3982: @c utilities, since it is only useful for those targets which support DLLs.
 3983: @c 
 3984: に立つので,常にバイナリユーティリティの一部として構築されるわけではあり
 3985: ません.
 3986: @end quotation
 3987: 
 3988: @c man title dlltool Create files needed to build and use DLLs.
 3989: 
 3990: @smallexample
 3991: @c man begin SYNOPSIS dlltool
 3992: dlltool [@option{-d}|@option{--input-def} @var{def-file-name}]
 3993:         [@option{-b}|@option{--base-file} @var{base-file-name}]
 3994:         [@option{-e}|@option{--output-exp} @var{exports-file-name}]
 3995:         [@option{-z}|@option{--output-def} @var{def-file-name}]
 3996:         [@option{-l}|@option{--output-lib} @var{library-file-name}]        
 3997:         [@option{--export-all-symbols}] [@option{--no-export-all-symbols}]
 3998:         [@option{--exclude-symbols} @var{list}]
 3999:         [@option{--no-default-excludes}]
 4000:         [@option{-S}|@option{--as} @var{path-to-assembler}] [@option{-f}|@option{--as-flags} @var{options}]
 4001:         [@option{-D}|@option{--dllname} @var{name}] [@option{-m}|@option{--machine} @var{machine}]
 4002:         [@option{-a}|@option{--add-indirect}] [@option{-U}|@option{--add-underscore}] [@option{-k}|@option{--kill-at}]
 4003:         [@option{-A}|@option{--add-stdcall-alias}]
 4004:         [@option{-x}|@option{--no-idata4}] [@option{-c}|@option{--no-idata5}] [@option{-i}|@option{--interwork}]
 4005:         [@option{-n}|@option{--nodelete}] [@option{-v}|@option{--verbose}] 
 4006:         [@option{-h}|@option{--help}] [@option{-V}|@option{--version}]
 4007:         [object-file @dots{}]
 4008: @c man end
 4009: @end smallexample
 4010: 
 4011: @c man begin DESCRIPTION dlltool
 4012: 
 4013: @c @command{dlltool} reads its inputs, which can come from the @option{-d} and
 4014: @c @option{-b} options as well as object files specified on the command
 4015: @c line.  It then processes these inputs and if the @option{-e} option has
 4016: @c been specified it creates a exports file.  If the @option{-l} option
 4017: @c has been specified it creates a library file and if the @option{-z} option
 4018: @c has been specified it creates a def file.  Any or all of the @option{-e}, 
 4019: @c @option{-l} and @option{-z} options can be present in one invocation of 
 4020: @c dlltool.
 4021: @c 
 4022: @command{dlltool}は,その入力を読み込み,それは,コマンドラインで指定さ
 4023: れたオブジェクトファイルと,@option{-d}と@option{-b}オプションから成り立
 4024: ちます.そして,これらの入力を処理し,@option{-e}オプションが指定されて
 4025: いる場合は,エクスポートファイルを作成します.@option{-l}オプションが指
 4026: 定されている場合は,ライブラリファイルを作成し,@option{-z}オプションが
 4027: 指定されている場合は,defファイルを作成します.@option{-e},@option{-l},
 4028: そして@option{-z}オプションのいずれか,またはすべてを,@command{dlltool} 
 4029: の呼び出しに配置することが可能です.
 4030: 
 4031: @c When creating a DLL, along with the source for the DLL, it is necessary
 4032: @c to have three other files.  @command{dlltool} can help with the creation of
 4033: @c these files.
 4034: @c 
 4035: DLLを作成しているとき,DLLのソースファイルとともに,それは三つの他のファ
 4036: イルが必要です.@command{dlltool}は,これらのファイルの作成を手助けする
 4037: ことが可能です.
 4038: 
 4039: @c The first file is a @samp{.def} file which specifies which functions are
 4040: @c exported from the DLL, which functions the DLL imports, and so on.  This
 4041: @c is a text file and can be created by hand, or @command{dlltool} can be used
 4042: @c to create it using the @option{-z} option.  In this case @command{dlltool}
 4043: @c will scan the object files specified on its command line looking for
 4044: @c those functions which have been specially marked as being exported and
 4045: @c put entries for them in the .def file it creates.
 4046: @c 
 4047: 最初のファイルは,DLLからエクスポートされる関数や,DLLがインポートする関
 4048: 数等を指定する,@file{.def}ファイルです.これはテキストファイルで,手動
 4049: で作成したり,作成するために@command{dlltool}を@option{-z}オプションを用
 4050: いて使用したりすることが可能です.この場合,@command{dlltool}は,エクス
 4051: ポートされるように特別に印の付けられたこれらの関数を探しながら,コマンド
 4052: ラインで指定されたオブジェクトファイルを走査し,作成する@file{.def}ファ
 4053: イルにそれらのエントリーを書き出します.
 4054: 
 4055: @c In order to mark a function as being exported from a DLL, it needs to
 4056: @c have an @option{-export:<name_of_function>} entry in the @samp{.drectve}
 4057: @c section of the object file.  This can be done in C by using the
 4058: @c asm() operator:
 4059: @c 
 4060: DLLからエクスポートされるように関数に印を付けるため,オブジェクトファイ
 4061: ルの@samp{.drectve}セクションに,@option{-export:<name_of_function>}エン
 4062: トリーが必要です.これは,Cでasm()演算子を使用することで可能となります.
 4063: 
 4064: @smallexample
 4065:   asm (".section .drectve");  
 4066:   asm (".ascii \"-export:my_func\"");
 4067: 
 4068:   int my_func (void) @{ @dots{} @}
 4069: @end smallexample
 4070: 
 4071: @c The second file needed for DLL creation is an exports file.  This file
 4072: @c is linked with the object files that make up the body of the DLL and it
 4073: @c handles the interface between the DLL and the outside world.  This is a
 4074: @c binary file and it can be created by giving the @option{-e} option to
 4075: @c @command{dlltool} when it is creating or reading in a .def file. 
 4076: @c 
 4077: DLLの作成に必要とされる2番目のファイルは,エクスポートファイルです.この
 4078: ファイルは,DLL本体を作成し,DLLと外部世界の間のインターフェースを取り扱
 4079: うオブジェクトファイルとリンクされます.これはバイナリファイルで,
 4080: @command{dlltool}が@file{.def}ファイルの作成または読み込みをしているとき
 4081: に,それに@option{-e}オプションを与えると作成されます.
 4082: 
 4083: @c The third file needed for DLL creation is the library file that programs
 4084: @c will link with in order to access the functions in the DLL.  This file
 4085: @c can be created by giving the @option{-l} option to dlltool when it
 4086: @c is creating or reading in a .def file.
 4087: @c 
 4088: DLLの作成に必要とされる三番目のファイルは,DLL内の関数にアクセスするため
 4089: にプログラムとリンクするライブラリファイルです.このファイルは,
 4090: @command{dlltool}が@file{.def}ファイルの作成または読み込みをしている時に,
 4091: それに@option{-l}オプションを与えると作成されます.
 4092: 
 4093: @c @command{dlltool} builds the library file by hand, but it builds the
 4094: @c exports file by creating temporary files containing assembler statements
 4095: @c and then assembling these.  The @option{-S} command line option can be
 4096: @c used to specify the path to the assembler that dlltool will use,
 4097: @c and the @option{-f} option can be used to pass specific flags to that
 4098: @c assembler.  The @option{-n} can be used to prevent dlltool from deleting
 4099: @c these temporary assembler files when it is done, and if @option{-n} is
 4100: @c specified twice then this will prevent dlltool from deleting the
 4101: @c temporary object files it used to build the library.
 4102: @c 
 4103: @command{dlltool}は,手動でライブラリファイルを構築しますが,それは,ア
 4104: センブラ宣言を含む一時ファイルを作成し,それをアセンブルすることで,エク
 4105: スポートファイルを構築します.@option{-S}コマンドラインオプションは,
 4106: @command{dlltool}が使用するアセンブラへのパスを指定するため使用可能で,
 4107: @option{-f}オプションは,そのアセンブラに特別なフラグを渡すために使用可
 4108: 能です.@option{-n}は,@command{dlltool}がこれらの一時的なアセンブラファ
 4109: イルを終了後に削除することを防ぐために使用可能で,@option{-n}が二回指定
 4110: されている場合は,@command{dlltool}がライブラリを構築するために使用した,
 4111: 一時的なオブジェクトファイルが削除されることを防ぎます.
 4112: 
 4113: @c Here is an example of creating a DLL from a source file @samp{dll.c} and
 4114: @c also creating a program (from an object file called @samp{program.o})
 4115: @c that uses that DLL:
 4116: @c 
 4117: ソースファイル@samp{dll.c}からDLLを作成し,そのDLLを使用しているプログラ
 4118: ムも(@samp{program.o}という名前のオブジェクトファイルから)作成している例
 4119: は以下のようになります.
 4120: 
 4121: @smallexample
 4122:   gcc -c dll.c
 4123:   dlltool -e exports.o -l dll.lib dll.o
 4124:   gcc dll.o exports.o -o dll.dll
 4125:   gcc program.o dll.lib -o program
 4126: @end smallexample
 4127: 
 4128: @c man end
 4129: 
 4130: @c man begin OPTIONS dlltool
 4131: 
 4132: @c The command line options have the following meanings:
 4133: @c 
 4134: コマンドラインオプションには以下の意味があります.
 4135: 
 4136: @table @env
 4137: 
 4138: @item -d @var{filename}
 4139: @itemx --input-def @var{filename}
 4140: @cindex input .def file
 4141: @c Specifies the name of a .def file to be read in and processed.
 4142: @c 
 4143: 読み込み,処理する@file{.def}ファイルの名前を指定します.
 4144: 
 4145: @item -b @var{filename}
 4146: @itemx --base-file @var{filename}
 4147: @cindex base files
 4148: @c Specifies the name of a base file to be read in and processed.  The
 4149: @c contents of this file will be added to the relocation section in the
 4150: @c exports file generated by dlltool.
 4151: @c 
 4152: 読み込み,処理するベースファイルの名前を指定します.このファイルの内容に,
 4153: @command{dlltool}で生成されるエクスポートファイルの,再配置のセクション
 4154: が追加されます.
 4155: 
 4156: @item -e @var{filename}
 4157: @itemx --output-exp @var{filename}
 4158: @c Specifies the name of the export file to be created by dlltool.
 4159: @c 
 4160: @command{dlltool}で作成される,@file{.def}ファイルの名前を指定します.
 4161: 
 4162: @item -z @var{filename}
 4163: @itemx --output-def @var{filename}
 4164: @c Specifies the name of the .def file to be created by dlltool.
 4165: @c 
 4166: @command{dlltool}で作成される,@file{.def}ファイルの名前を指定します.
 4167: 
 4168: @item -l @var{filename}
 4169: @itemx --output-lib @var{filename}
 4170: @c Specifies the name of the library file to be created by dlltool.
 4171: @c 
 4172: @command{dlltool}で作成される,ライブラリファイルの名前を指定します.
 4173: 
 4174: @item --export-all-symbols
 4175: @c Treat all global and weak defined symbols found in the input object
 4176: @c files as symbols to be exported.  There is a small list of symbols which
 4177: @c are not exported by default; see the @option{--no-default-excludes}
 4178: @c option.  You may add to the list of symbols to not export by using the
 4179: @c @option{--exclude-symbols} option.
 4180: @c 
 4181: 入力ファイル内のエクスポートされるシンボルとして見つかったものは,すべて
 4182: 大域的にweakとして定義されているシンボルとして扱います.これらは,デフォ
 4183: ルトでエクスポートされないシンボルの小さなリストです.
 4184: @option{--no-default-excludes}オプションを参照してください.
 4185: @option{--exclude-symbols}オプションを使用して,エクスポートされないシン
 4186: ボルのリストを追加してもかまいません.
 4187: 
 4188: @item --no-export-all-symbols
 4189: @c Only export symbols explicitly listed in an input .def file or in
 4190: @c @samp{.drectve} sections in the input object files.  This is the default
 4191: @c behaviour.  The @samp{.drectve} sections are created by @samp{dllexport}
 4192: @c attributes in the source code.
 4193: @c 
 4194: 入力の@file{.def}ファイルや入力オブジェクトファイルの@samp{.drectve}セク
 4195: ションで,明示的にリストアップされているシンボルのみエクスポートします.
 4196: @samp{.drectve}は,ソースコード内の@samp{dllexport}属性で作成されます.
 4197: 
 4198: @item --exclude-symbols @var{list}
 4199: @c Do not export the symbols in @var{list}.  This is a list of symbol names
 4200: @c separated by comma or colon characters.  The symbol names should not
 4201: @c contain a leading underscore.  This is only meaningful when
 4202: @c @option{--export-all-symbols} is used.
 4203: @c 
 4204: @var{list}内のシンボルをエクスポートしません.これは,カンマまたはコロン
 4205: 文字で分けられた,シンボル名のリストです.シンボル名に,アンダースコアの
 4206: 前置を含めることはできません.これは,@option{--export-all-symbols}が使
 4207: 用されているときのみ意味があります.
 4208: 
 4209: @item --no-default-excludes
 4210: @c When @option{--export-all-symbols} is used, it will by default avoid
 4211: @c exporting certain special symbols.  The current list of symbols to avoid
 4212: @c exporting is @samp{DllMain@@12}, @samp{DllEntryPoint@@0},
 4213: @c @samp{impure_ptr}.  You may use the @option{--no-default-excludes} option
 4214: @c to go ahead and export these special symbols.  This is only meaningful
 4215: @c when @option{--export-all-symbols} is used.
 4216: @c 
 4217: @option{--export-all-symbols}が使用されているとき,それはデフォルトで,
 4218: ある特別なシンボルをエクスポートすることを避けます.現在のエクスポートを
 4219: 避けるリストは,@samp{DllMain@@12}, @samp{DllEntryPoint@@0},
 4220: @samp{impure_ptr}です.これらの特別なシンボルを進んでエクスポートするた
 4221: めに,@option{--no-default-excludes}オプションを使用してもかまいません.
 4222: これは,@option{--export-all-symbols}が使用されているときのみ意味があり
 4223: ます.
 4224: 
 4225: @item -S @var{path}
 4226: @itemx --as @var{path}
 4227: @c Specifies the path, including the filename, of the assembler to be used
 4228: @c to create the exports file.
 4229: @c 
 4230: エクスポートファイルを作成するために使用するアセンブラの,ファイル名を含
 4231: む,パスを指定します.
 4232: 
 4233: @item -f @var{options}
 4234: @itemx --as-flags @var{options}
 4235: @c Specifies any specific command line options to be passed to the
 4236: @c assembler when building the exports file.  This option will work even if
 4237: @c the @option{-S} option is not used.  This option only takes one argument,
 4238: @c and if it occurs more than once on the command line, then later
 4239: @c occurrences will override earlier occurrences.  So if it is necessary to
 4240: @c pass multiple options to the assembler they should be enclosed in
 4241: @c double quotes.
 4242: @c 
 4243: エクスポートファイルを構築しているときアセンブラに渡す,あらゆる特別なコ
 4244: マンドラインオプションを指定します.このオプションは,@option{-S}が指定
 4245: されていないかのように動作します.このオプションは一つの引数のみ渡し,コ
 4246: マンドラインに一回以上出現する場合,最後に出現したものを,前に出現したも
 4247: のに優先させます.そのため,複数のオプションをアセンブラに渡す必要がある
 4248: 場合は,二重引用符で囲む必要があります.
 4249: 
 4250: @item -D @var{name}
 4251: @itemx --dll-name @var{name}
 4252: @c Specifies the name to be stored in the .def file as the name of the DLL
 4253: @c when the @option{-e} option is used.  If this option is not present, then
 4254: @c the filename given to the @option{-e} option will be used as the name of
 4255: @c the DLL.
 4256: @c 
 4257: @option{-e}オプションが使用されてるとき,DLLの名前として@file{.def}ファ
 4258: イルに保存する名前を指定します.このオプションがない場合,@option{-e}オ
 4259: プションで与えられるファイル名は,DLLの名前として使用されます.
 4260: 
 4261: @item -m @var{machine}
 4262: @itemx -machine @var{machine}
 4263: @c Specifies the type of machine for which the library file should be
 4264: @c built.  @command{dlltool} has a built in default type, depending upon how
 4265: @c it was created, but this option can be used to override that.  This is
 4266: @c normally only useful when creating DLLs for an ARM processor, when the
 4267: @c contents of the DLL are actually encode using Thumb instructions.
 4268: @c 
 4269: ライブラリファイルが構築されるマシンの形式を指定します.
 4270: @command{dlltool}には,構築のされ方に依存するデフォルト形式がありますが,
 4271: このオプションで,それに優先させることが可能です.これは通常,ARMプロセッ
 4272: サに対するDLLを作成するときのみ役に立ち,DLLの内容は,実際にThumb命令を
 4273: 使用して符号化されます.
 4274: 
 4275: @item -a
 4276: @itemx --add-indirect
 4277: @c Specifies that when @command{dlltool} is creating the exports file it
 4278: @c should add a section which allows the exported functions to be
 4279: @c referenced without using the import library.  Whatever the hell that
 4280: @c means! 
 4281: @c 
 4282: @command{dlltool}がエクスポートファイルを作成しているとき,エクスポート
 4283: 関数がインポートライブラリを使用しないで参照できるように,セクションを加
 4284: えることを指定します.たとえ,それが地獄を意味しようとも!
 4285: 
 4286: @item -U
 4287: @itemx --add-underscore
 4288: @c Specifies that when @command{dlltool} is creating the exports file it
 4289: @c should prepend an underscore to the names of the exported functions. 
 4290: @c 
 4291: @command{dlltool}エクスポートファイルを作成しているとき,エクスポート関
 4292: 数の名前にアンダースコアを前置することを指定します.
 4293: 
 4294: @item -k
 4295: @itemx --kill-at
 4296: @c Specifies that when @command{dlltool} is creating the exports file it
 4297: @c should not append the string @samp{@@ <number>}.  These numbers are
 4298: @c called ordinal numbers and they represent another way of accessing the
 4299: @c function in a DLL, other than by name.
 4300: @c 
 4301: @command{dlltool}エクスポートファイルを作成しているとき,文字列@samp{@@
 4302: <number>}を追加しないことを指定します.これらの数字は,序数と呼ばれ,DLL 
 4303: では関数にアクセスする一つの方法を表示し,それ以外では名前で表示します.
 4304: 
 4305: @item -A
 4306: @itemx --add-stdcall-alias
 4307: @c Specifies that when @command{dlltool} is creating the exports file it
 4308: @c should add aliases for stdcall symbols without @samp{@@ <number>}
 4309: @c in addition to the symbols with @samp{@@ <number>}.
 4310: @c 
 4311: @command{dlltool}がエクスポートファイルを作成しているとき,シンボルに
 4312: @samp{@@ <number>}を追加したものを,@samp{@@ <number>}なしでstdcallシン
 4313: ボルの別名を加えることを指定します.
 4314: 
 4315: @item -x
 4316: @itemx --no-idata4
 4317: @c Specifies that when @command{dlltool} is creating the exports and library
 4318: @c files it should omit the @code{.idata4} section.  This is for compatibility
 4319: @c with certain operating systems.
 4320: @c 
 4321: @command{dlltool}エクスポートファイルとライブラリファイルを作成している
 4322: とき,@code{.idata4}セクションを削除することを指定します.これは,あるオ
 4323: ペレーティングシステムとの互換性のためです.
 4324: 
 4325: @item -c
 4326: @itemx --no-idata5
 4327: @c Specifies that when @command{dlltool} is creating the exports and library
 4328: @c files it should omit the @code{.idata5} section.  This is for compatibility
 4329: @c with certain operating systems.
 4330: @c 
 4331: @command{dlltool}エクスポートファイルとライブラリファイルを作成している
 4332: とき,@code{.idata5}セクションを削除することを指定します.これは,あるオ
 4333: ペレーティングシステムとの互換性のためです.
 4334: 
 4335: @item -i
 4336: @itemx --interwork
 4337: @c Specifies that @command{dlltool} should mark the objects in the library
 4338: @c file and exports file that it produces as supporting interworking
 4339: @c between ARM and Thumb code.
 4340: @c 
 4341: @command{dlltool}が,生成しているライブラリファイルとエクスポートファイ
 4342: ル内のオブジェクトに,ARMとThumb間での相互動作をサポートするように印を付
 4343: けることを指定します.
 4344: 
 4345: @item -n
 4346: @itemx --nodelete
 4347: @c Makes @command{dlltool} preserve the temporary assembler files it used to
 4348: @c create the exports file.  If this option is repeated then dlltool will
 4349: @c also preserve the temporary object files it uses to create the library
 4350: @c file. 
 4351: @c 
 4352: @command{dlltool}は,エクスポートファイルを作成するために使用した一時的
 4353: なアセンブラファイルを保存します.このオプションが繰り返される場合,
 4354: @command{dlltool}は,ライブラリを作成するために使用する一時的なオブジェ
 4355: クトファイルも保存します.
 4356: 
 4357: @item -v
 4358: @itemx --verbose
 4359: @c Make dlltool describe what it is doing.
 4360: @c 
 4361: @command{dlltool}は,行っていることを記述します.
 4362: 
 4363: @item -h
 4364: @itemx --help
 4365: @c Displays a list of command line options and then exits.
 4366: @c 
 4367: コマンドラインオプションのリストを表示し終了します.
 4368: 
 4369: @item -V
 4370: @itemx --version
 4371: @c Displays dlltool's version number and then exits.
 4372: @c 
 4373: @command{dlltool}のバージョンナンバーを表示し終了します.
 4374: 
 4375: @end table
 4376: 
 4377: @c man end
 4378: 
 4379: @ignore
 4380: @c man begin SEEALSO dlltool
 4381: the Info entries for @file{binutils}.
 4382: @c man end
 4383: @end ignore
 4384: 
 4385: @node readelf
 4386: @chapter readelf
 4387: 
 4388: @cindex ELF file information
 4389: @kindex readelf
 4390: 
 4391: @c man title readelf Displays information about ELF files.
 4392: 
 4393: @smallexample
 4394: @c man begin SYNOPSIS readelf
 4395: readelf [@option{-a}|@option{--all}] 
 4396:         [@option{-h}|@option{--file-header}]
 4397:         [@option{-l}|@option{--program-headers}|@option{--segments}]
 4398:         [@option{-S}|@option{--section-headers}|@option{--sections}]
 4399:         [@option{-e}|@option{--headers}]
 4400:         [@option{-s}|@option{--syms}|@option{--symbols}]
 4401:         [@option{-n}|@option{--notes}]
 4402:         [@option{-r}|@option{--relocs}]
 4403:         [@option{-u}|@option{--unwind}]
 4404:         [@option{-d}|@option{--dynamic}]
 4405:         [@option{-V}|@option{--version-info}]
 4406:         [@option{-D}|@option{--use-dynamic}]
 4407:         [@option{-x} <number>|@option{--hex-dump=}<number>]
 4408:         [@option{-w[liaprmfFso]}|@option{--debug-dump}[=line,=info,=abbrev,=pubnames,=ranges,=macro,=frames,=str,=loc]]
 4409:         [@option{-histogram}]
 4410:         [@option{-v}|@option{--version}]
 4411:         [@option{-W}|@option{--wide}]
 4412:         [@option{-H}|@option{--help}]
 4413:         @var{elffile}@dots{}
 4414: @c man end
 4415: @end smallexample
 4416: 
 4417: @c man begin DESCRIPTION readelf
 4418: 
 4419: @c @command{readelf} displays information about one or more ELF format object
 4420: @c files.  The options control what particular information to display.
 4421: @c 
 4422: @command{readelf}は,一つ以上のELFフォーマットのオブジェクトファイルの情
 4423: 報を表示します.オプションで表示する特定の情報を制御します.
 4424: 
 4425: @c @var{elffile}@dots{} are the object files to be examined.  At the
 4426: @c moment, @command{readelf} does not support examining archives, nor does it
 4427: @c support examing 64 bit ELF files.
 4428: @c 
 4429: @var{elffile}@dots{} は調査するオブジェクトファイルです.現在は,
 4430: @command{readelf}は,アーカイブの調査のサポートも,64ビットELFファイルの
 4431: サポートもありません.
 4432: 
 4433: @c man end
 4434: 
 4435: @c man begin OPTIONS readelf
 4436: 
 4437: @c The long and short forms of options, shown here as alternatives, are
 4438: @c equivalent.  At least one option besides @samp{-v} or @samp{-H} must be
 4439: @c given. 
 4440: @c 
 4441: ここで交互に表示されている,オプションの長い形式と短い形式は等価です.
 4442: @option{-v}または@option{-H}の他に,少なくとも一つのオプションを与える必
 4443: 要があります.
 4444: 
 4445: @table @env
 4446: @item -a
 4447: @itemx --all
 4448: @c Equivalent to specifiying @option{--file-header},
 4449: @c @option{--program-headers}, @option{--sections}, @option{--symbols},
 4450: @c @option{--relocs}, @option{--dynamic}, @option{--notes} and
 4451: @c @option{--version-info}. 
 4452: @c 
 4453: @option{--file-header},@option{--program-headers},@option{--sections},
 4454: @option{--symbols},@option{--relocs},@option{--dynamic},
 4455: @option{--notes},そして@option{--version-info}を指定することと等価です.
 4456: 
 4457: @item -h
 4458: @itemx --file-header
 4459: @cindex ELF file header information
 4460: @c Displays the information contained in the ELF header at the start of the
 4461: @c file.
 4462: @c 
 4463: ファイルの最初のELFヘッダ内に含まれる情報を表示します.
 4464: 
 4465: @item -l
 4466: @itemx --program-headers
 4467: @itemx --segments
 4468: @cindex ELF program header information
 4469: @cindex ELF segment information
 4470: @c Displays the information contained in the file's segment headers, if it
 4471: @c has any.
 4472: @c 
 4473: ファイルのセグメントヘッダ内に含まれる情報を,存在する場合は表示します.
 4474: 
 4475: @item -S
 4476: @itemx --sections
 4477: @itemx --section-headers
 4478: @cindex ELF section information
 4479: @c Displays the information contained in the file's section headers, if it
 4480: @c has any.
 4481: @c 
 4482: ファイルのセクションヘッダ内に含まれる情報を,存在する場合は表示します.
 4483: 
 4484: @item -s
 4485: @itemx --symbols
 4486: @itemx --syms
 4487: @cindex ELF symbol table information
 4488: @c Displays the entries in symbol table section of the file, if it has one.
 4489: @c 
 4490: ファイルのシンボルテーブルセクション内のエントリーを,存在する場合は表示
 4491: します.
 4492: 
 4493: @item -e
 4494: @itemx --headers
 4495: @c Display all the headers in the file.  Equivalent to @option{-h -l -S}.
 4496: @c 
 4497: ファイルのすべてのヘッダを表示します.@option{-h -l -S}と等価です.
 4498: 
 4499: @item -n
 4500: @itemx --notes
 4501: @cindex ELF core notes
 4502: @c Displays the contents of the NOTE segment, if it exists.
 4503: @c 
 4504: NOTEセグメントの内容を,存在する場合は表示します.
 4505: 
 4506: @item -r
 4507: @itemx --relocs
 4508: @cindex ELF reloc information
 4509: @c Displays the contents of the file's relocation section, if it has one.
 4510: @c 
 4511: ファイルの再配置のセクションの内容を,存在する場合は表示します.
 4512: 
 4513: @item -u
 4514: @itemx --unwind
 4515: @cindex unwind information
 4516: @c Displays the contents of the file's unwind section, if it has one.  Only
 4517: @c the unwind sections for IA64 ELF files are currently supported.
 4518: @c 
 4519: ファイルのunwindセクションの内容が存在する場合は表示します.IA64 ELF ファ
 4520: イルのunwindセクションのみ,現在はサポートされています.
 4521: 
 4522: @item -d
 4523: @itemx --dynamic
 4524: @cindex ELF dynamic section information
 4525: @c Displays the contents of the file's dynamic section, if it has one.
 4526: @c 
 4527: ファイルの動的セクションの内容を,存在する場合は表示します.
 4528: 
 4529: @item -V
 4530: @itemx --version-info
 4531: @cindex ELF version sections informations
 4532: @c Displays the contents of the version sections in the file, it they
 4533: @c exist.
 4534: @c 
 4535: ファイルのバージョンセクションの内容を,存在する場合は表示します.
 4536: 
 4537: @item -D
 4538: @itemx --use-dynamic
 4539: @c When displaying symbols, this option makes @command{readelf} use the
 4540: @c symbol table in the file's dynamic section, rather than the one in the
 4541: @c symbols section.
 4542: @c 
 4543: シンボルを表示しているとき,@command{readelf}はこのオプションで,ファイ
 4544: ルのシンボルセクションではなく,動的セクションのシンボルテーブルを使用し
 4545: ます.
 4546: 
 4547: @item -x <number>
 4548: @itemx --hex-dump=<number>
 4549: @c Displays the contents of the indicated section as a hexadecimal dump.
 4550: @c 
 4551: 16進のダンプとして示されているセクションの内容を表示します.
 4552: 
 4553: @item -w[liaprmfFso]
 4554: @itemx --debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=macro,=frames,=str,=loc]
 4555: @c Displays the contents of the debug sections in the file, if any are
 4556: @c present.  If one of the optional letters or words follows the switch
 4557: @c then only data found in those specific sections will be dumped.
 4558: @c 
 4559: ファイルのデバッグセクションの内容を,存在する場合は表示します.オプショ
 4560: ン文字や単語の一つがスイッチに続く場合,これらで指定されたセクションで見
 4561: つかるデータのみダンプされます.
 4562: 
 4563: @item --histogram
 4564: @c Display a histogram of bucket list lengths when displaying the contents
 4565: @c of the symbol tables.
 4566: @c 
 4567: シンボルテーブルの内容を表示するとき,バケットリスト長のヒストグラムを表
 4568: 示します.
 4569: 
 4570: @item -v
 4571: @itemx --version
 4572: @c Display the version number of readelf.
 4573: @c 
 4574: @command{readelf}のバージョンナンバーを表示します.
 4575: 
 4576: @item -W
 4577: @itemx --wide
 4578: @c Don't break output lines to fit into 80 columns. By default
 4579: @c @command{readelf} breaks section header and segment listing lines for
 4580: @c 64-bit ELF files, so that they fit into 80 columns. This option causes
 4581: @c @command{readelf} to print each section header resp. each segment one a
 4582: @c single line, which is far more readable on terminals wider than 80 columns.
 4583: @c 
 4584: 出力行を80列に揃えて改行しません.@command{readelf}はデフォルトで,64ビッ
 4585: トのELFファイルに対し,セクションヘッダとセグメントを80列に揃うように改
 4586: 行します.このオプションで,@command{readelf}はそれぞれのセクションヘッ
 4587: ダを各々のセグメントを単一の行出力し,80列以上の幅の端末でより読み易くな
 4588: ります.
 4589: 
 4590: @item -H
 4591: @itemx --help
 4592: @c Display the command line options understood by @command{readelf}.
 4593: @c 
 4594: @command{readelf}が理解するコマンドラインオプションを表示します.
 4595: 
 4596: @end table
 4597: 
 4598: @c man end
 4599: 
 4600: @ignore
 4601: @c man begin SEEALSO readelf
 4602: objdump(1), and the Info entries for @file{binutils}.
 4603: @c man end
 4604: @end ignore
 4605: 
 4606: @node Selecting The Target System
 4607: @chapter ターゲットシステムの選択
 4608: 
 4609: @c You can specify three aspects of the target system to the @sc{gnu}
 4610: @c binary file utilities, each in several ways:
 4611: @c 
 4612: ターゲットシステムの三つの側面を,@sc{gnu}バイナリファイルユーティリティ
 4613: に,それぞれ異なる方法で指定することが可能です.
 4614: 
 4615: @itemize @bullet
 4616: @item
 4617: @c the target
 4618: @c 
 4619: ターゲット
 4620: 
 4621: @item
 4622: @c the architecture
 4623: @c 
 4624: アーキテクチャ
 4625: 
 4626: @item
 4627: @c the linker emulation (which applies to the linker only)
 4628: @c 
 4629: リンカエミュレーション(リンカのみ適用されます)
 4630: @end itemize
 4631: 
 4632: @c In the following summaries, the lists of ways to specify values are in
 4633: @c order of decreasing precedence.  The ways listed first override those
 4634: @c listed later.
 4635: @c 
 4636: 以下の概要では,変数を指定する方法のリストは,優先順位が下がる順序となっ
 4637: ています.方法は,最初のものがそれ以降のものに優先するようにリストアップ
 4638: されています.
 4639: 
 4640: @c The commands to list valid values only list the values for which the
 4641: @c programs you are running were configured.  If they were configured with
 4642: @c @option{--enable-targets=all}, the commands list most of the available
 4643: @c values, but a few are left out; not all targets can be configured in at
 4644: @c once because some of them can only be configured @dfn{native} (on hosts
 4645: @c with the same type as the target system).
 4646: @c 
 4647: 有効な値をリストアップするコマンドは,実行しているプログラムに設定されて
 4648: いる値のみリストアップします.それらが@option{--enable-targets=all}で設
 4649: 定されている場合,ほとんどの利用可能なコマンドはリストアップされますが,
 4650: いくつかはそうなりません.ターゲットには@dfn{native}(ターゲットシステム
 4651: と同じ形式のホスト)に設定することしかできないものもあるので,すべてのも
 4652: のが一度に設定可能なわけではありません.
 4653: 
 4654: @menu
 4655: * Target Selection::            
 4656: * Architecture Selection::      
 4657: * Linker Emulation Selection::  
 4658: @end menu
 4659: 
 4660: @node Target Selection
 4661: @section ターゲットの選択
 4662: 
 4663: @c A @dfn{target} is an object file format.  A given target may be
 4664: @c supported for multiple architectures (@pxref{Architecture Selection}).
 4665: @c A target selection may also have variations for different operating
 4666: @c systems or architectures.
 4667: @c 
 4668: @dfn{ターゲット(target)}とはオブジェクトファイルのフォーマットです.与え
 4669: られたターゲットは,複数のアーキテクチャでサポートされるかもしれません
 4670: (@pxref{Architecture Selection}).ターゲットの選択は,オペレーティングシ
 4671: ステムやアーキテクチャによっても,変化があるかもしれません.
 4672: 
 4673: @c The command to list valid target values is @samp{objdump -i}
 4674: @c (the first column of output contains the relevant information).
 4675: @c 
 4676: 有効なターゲットの値をリストアップするコマンドは,@samp{objdump -i}です
 4677: (出力の最初の列は,関連した情報を含みます).
 4678: 
 4679: @c Some sample values are: @samp{a.out-hp300bsd}, @samp{ecoff-littlemips},
 4680: @c @samp{a.out-sunos-big}.
 4681: @c 
 4682: サンプルの値は以下のとおりです.@samp{a.out-hp300bsd},
 4683: @samp{ecoff-littlemips},@samp{a.out-sunos-big}.
 4684: 
 4685: @c You can also specify a target using a configuration triplet.  This is
 4686: @c the same sort of name that is passed to @file{configure} to specify a
 4687: @c target.  When you use a configuration triplet as an argument, it must be
 4688: @c fully canonicalized.  You can see the canonical version of a triplet by
 4689: @c running the shell script @file{config.sub} which is included with the
 4690: @c sources.
 4691: @c 
 4692: 三項目の設定を使用してターゲットを指定することも可能です.これは,ターゲッ
 4693: トを指定するために@file{configure}に渡す名前と同種です.三項目の設定を引
 4694: 数として使用するとき,それを完全に標準のものにする必要があります.ソース
 4695: に含まれるシェルスクリプト@file{config.sub}を実行することで,三項目の標
 4696: 準的なバージョンを知ることが可能です.
 4697: 
 4698: @c Some sample configuration triplets are: @samp{m68k-hp-bsd},
 4699: @c @samp{mips-dec-ultrix}, @samp{sparc-sun-sunos}.
 4700: @c 
 4701: サンプルの値は以下のとおりです.@samp{m68k-hp-bsd},
 4702: @samp{mips-dec-ultrix},@samp{sparc-sun-sunos}.
 4703: 
 4704: @subheading @command{objdump}のターゲット
 4705: 
 4706: @c Ways to specify:
 4707: @c 
 4708: 指定方法:
 4709: 
 4710: @enumerate
 4711: @item
 4712: @c command line option: @option{-b} or @option{--target}
 4713: @c 
 4714: コマンドラインオプション:@option{-b}または@option{--target}
 4715: 
 4716: @item
 4717: @c environment variable @code{GNUTARGET}
 4718: @c 
 4719: 環境変数@code{GNUTARGET}
 4720: 
 4721: @item
 4722: @c deduced from the input file
 4723: @c 
 4724: 入力ファイルから推測
 4725: @end enumerate
 4726: 
 4727: @subheading @command{objcopy}と@command{strip}の入力ターゲット
 4728: 
 4729: @c Ways to specify:
 4730: @c 
 4731: 指定方法:
 4732: 
 4733: @enumerate
 4734: @item
 4735: @c command line options: @option{-I} or @option{--input-target}, or @option{-F} or @option{--target}
 4736: @c 
 4737: コマンドラインオプション:@option{-I}または@option{--input-target},もし
 4738: くは,@option{-F}または@option{--target}
 4739: 
 4740: @item
 4741: @c environment variable @code{GNUTARGET}
 4742: @c 
 4743: 環境変数@code{GNUTARGET}
 4744: 
 4745: @item
 4746: @c deduced from the input file
 4747: @c 
 4748: 入力ファイルから推測
 4749: @end enumerate
 4750: 
 4751: @subheading @command{objcopy}と@command{strip}の出力ターゲット
 4752: 
 4753: @c Ways to specify:
 4754: @c 
 4755: 指定方法:
 4756: 
 4757: @enumerate
 4758: @item
 4759: @c command line options: @option{-O} or @option{--output-target}, or @option{-F} or @option{--target}
 4760: @c 
 4761: コマンドラインオプション:@option{-O}または@option{--output-target},も
 4762: しくは,@option{-F}または@option{--target}
 4763: 
 4764: @item
 4765: @c the input target (see ``@command{objcopy} and @command{strip} Input Target'' above)
 4766: @c 
 4767: 入力ターゲット(上記の``@command{objcopy}と@command{strip}の入力ターゲッ
 4768: ト''を参照してください)
 4769: 
 4770: @item
 4771: @c environment variable @code{GNUTARGET}
 4772: @c 
 4773: 環境変数@code{GNUTARGET}
 4774: 
 4775: @item
 4776: @c deduced from the input file
 4777: @c 
 4778: 入力ファイルから推測
 4779: @end enumerate
 4780: 
 4781: @subheading @command{nm},@command{size},そして@command{strings}のターゲット
 4782: 
 4783: @c Ways to specify:
 4784: @c 
 4785: 指定方法:
 4786: 
 4787: @enumerate
 4788: @item
 4789: @c command line option: @option{--target}
 4790: @c 
 4791: コマンドラインオプション:@option{--target}
 4792: 
 4793: @item
 4794: @c environment variable @code{GNUTARGET}
 4795: @c 
 4796: 環境変数@code{GNUTARGET}
 4797: 
 4798: @item
 4799: @c deduced from the input file
 4800: @c 
 4801: 入力ファイルから推測
 4802: @end enumerate
 4803: 
 4804: @subheading リンカ入力ターゲット
 4805: 
 4806: @c Ways to specify:
 4807: @c 
 4808: 指定方法:
 4809: 
 4810: @enumerate
 4811: @item
 4812: @c command line option: @option{-b} or @option{--format}
 4813: @c (@pxref{Options,,Options,ld.info,Using LD})
 4814: @c 
 4815: コマンドラインオプション:@option{-b}または@option{--format}
 4816: (@pxref{Options,,Options,ld.info,Using LD})
 4817: 
 4818: @item
 4819: @c script command @code{TARGET}
 4820: @c (@pxref{Format Commands,,Format Commands,ld.info,Using LD})
 4821: @c 
 4822: スクリプトコマンド@code{TARGET} (@pxref{Format Commands,,Format
 4823: Commands,ld.info,Using LD})
 4824: 
 4825: @item
 4826: @c environment variable @code{GNUTARGET}
 4827: @c (@pxref{Environment,,Environment,ld.info,Using LD})
 4828: @c 
 4829: 環境変数@code{GNUTARGET} (@pxref{Environment,,Environment,ld.info,Using
 4830: LD})
 4831: 
 4832: @item
 4833: @c the default target of the selected linker emulation
 4834: @c (@pxref{Linker Emulation Selection})
 4835: @c 
 4836: リンカエミュレーションで選択されたデフォルトターゲット (@pxref{Linker
 4837: Emulation Selection})
 4838: @end enumerate
 4839: 
 4840: @subheading リンカ出力ターゲット
 4841: 
 4842: @c Ways to specify:
 4843: @c 
 4844: 指定方法:
 4845: 
 4846: @enumerate
 4847: @item
 4848: @c command line option: @option{-oformat}
 4849: @c (@pxref{Options,,Options,ld.info,Using LD})
 4850: @c 
 4851: コマンドラインオプション:@option{-oformat}
 4852: (@pxref{Options,,Options,ld.info,Using LD})
 4853: 
 4854: @item
 4855: @c script command @code{OUTPUT_FORMAT}
 4856: @c (@pxref{Format Commands,,Format Commands,ld.info,Using LD})
 4857: @c 
 4858: スクリプトコマンド@code{OUTPUT_FORMAT} (@pxref{Format Commands,,Format
 4859: Commands,ld.info,Using LD})
 4860: 
 4861: @item
 4862: @c the linker input target (see ``Linker Input Target'' above)
 4863: @c 
 4864: リンカ入力ターゲット(上記の``リンカ入力ターゲット''を参照してください)
 4865: @end enumerate
 4866: 
 4867: @node Architecture Selection
 4868: @section アーキテクチャの選択
 4869: 
 4870: @c An @dfn{architecture} is a type of @sc{cpu} on which an object file is
 4871: @c to run.  Its name may contain a colon, separating the name of the
 4872: @c processor family from the name of the particular @sc{cpu}.
 4873: @c 
 4874: @dfn{アーキテクチャ(architecture)}は,オブジェクトファイルを実行する
 4875: @sc{cpu}の型式です.その名前にはコロンを含めてもかまわず,それは特定の
 4876: @sc{cpu}とプロセッサファミリーの名前を分けます.
 4877: 
 4878: @c The command to list valid architecture values is @samp{objdump -i} (the
 4879: @c second column contains the relevant information).
 4880: @c 
 4881: 有効なアーキテクチャの値をリストアップするコマンドは,@samp{objdump -i} 
 4882: です(二番目のコロンは,関連する情報を含みます).
 4883: 
 4884: @c Sample values: @samp{m68k:68020}, @samp{mips:3000}, @samp{sparc}.
 4885: @c 
 4886: サンプルの値です.@samp{m68k:68020},@samp{mips:3000},@samp{sparc}.
 4887: 
 4888: @subheading @command{objdump}のアーキテクチャ
 4889: 
 4890: @c Ways to specify:
 4891: @c 
 4892: 指定方法:
 4893: 
 4894: @enumerate
 4895: @item
 4896: @c command line option: @option{-m} or @option{--architecture}
 4897: @c 
 4898: コマンドラインオプション:@option{-m}または@option{--architecture}
 4899: 
 4900: @item
 4901: @c deduced from the input file
 4902: @c 
 4903: 入力ファイルから推測
 4904: @end enumerate
 4905: 
 4906: @subheading @command{objcopy},@command{nm},@command{size},@command{strings}のアーキテクチャ
 4907: 
 4908: @c Ways to specify:
 4909: @c 
 4910: 指定方法:
 4911: 
 4912: @enumerate
 4913: @item
 4914: @c deduced from the input file
 4915: @c 
 4916: 入力ファイルから推測
 4917: @end enumerate
 4918: 
 4919: @subheading リンカの入力のアーキテクチャ
 4920: 
 4921: @c Ways to specify:
 4922: @c 
 4923: 指定方法:
 4924: 
 4925: @enumerate
 4926: @item
 4927: @c deduced from the input file
 4928: @c 
 4929: 入力ファイルから推測
 4930: @end enumerate
 4931: 
 4932: @subheading リンカの出力のアーキテクチャ
 4933: 
 4934: @c Ways to specify:
 4935: @c 
 4936: 指定方法:
 4937: 
 4938: @enumerate
 4939: @item
 4940: @c script command @code{OUTPUT_ARCH}
 4941: @c (@pxref{Miscellaneous Commands,,Miscellaneous Commands,ld.info,Using LD})
 4942: @c 
 4943: スクリプトコマンド@code{OUTPUT_ARCH} (@pxref{Miscellaneous
 4944: Commands,,Miscellaneous Commands,ld.info,Using LD})
 4945: 
 4946: @item
 4947: @c the default architecture from the linker output target
 4948: @c (@pxref{Target Selection})
 4949: @c 
 4950: リンカの出力ターゲットのデフォルトアーキテクチャ(@pxref{Target
 4951: Selection})
 4952: @end enumerate
 4953: 
 4954: @node Linker Emulation Selection
 4955: @section リンカエミュレーションの選択
 4956: 
 4957: @c A linker @dfn{emulation} is a ``personality'' of the linker, which gives
 4958: @c the linker default values for the other aspects of the target system.
 4959: @c In particular, it consists of
 4960: @c 
 4961: リンカ@dfn{エミュレーション(emulation)}は,リンカの``個性''で,それはター
 4962: ゲットシステムのそれ以外の側面に対するリンカのデフォルト値を与えます.特
 4963: に以下から成り立ちます.
 4964: 
 4965: @itemize @bullet
 4966: @item
 4967: @c the linker script
 4968: @c 
 4969: リンカスクリプト
 4970: 
 4971: @item
 4972: @c the target
 4973: @c 
 4974: ターゲット
 4975: 
 4976: @item
 4977: @c several ``hook'' functions that are run at certain stages of the linking
 4978: @c process to do special things that some targets require
 4979: @c 
 4980: いくつかのターゲットが要求する特別なことを行うために,リンクプロセスの特
 4981: 定のステージで実行されるいくつかの``フック''関数.
 4982: @end itemize
 4983: 
 4984: @c The command to list valid linker emulation values is @samp{ld -V}.
 4985: @c 
 4986: 有効なリンカエミュレーションの値をリストアップするコマンドは,@samp{ld
 4987: -V}です.
 4988: 
 4989: @c Sample values: @samp{hp300bsd}, @samp{mipslit}, @samp{sun4}.
 4990: @c 
 4991: サンプルの値は以下のとおりです.@samp{hp300bsd},@samp{mipslit},
 4992: @samp{sun4}.
 4993: 
 4994: @c Ways to specify:
 4995: @c 
 4996: 指定方法:
 4997: 
 4998: @enumerate
 4999: @item
 5000: @c command line option: @option{-m}
 5001: @c (@pxref{Options,,Options,ld.info,Using LD})
 5002: @c 
 5003: コマンドラインオプション:@option{-m}
 5004: (@pxref{Options,,Options,ld.info,Using LD})
 5005: 
 5006: @item
 5007: @c environment variable @code{LDEMULATION}
 5008: @c 
 5009: 環境変数@code{LDEMULATION}
 5010: 
 5011: @item
 5012: @c compiled-in @code{DEFAULT_EMULATION} from @file{Makefile},
 5013: @c which comes from @code{EMUL} in @file{config/@var{target}.mt}
 5014: @c 
 5015: @file{Makefile}でコンパイル時に組み込まれた@code{DEFAULT_EMULATION}で,
 5016: それは@file{config/@var{target}.mt}の@code{EMUL}に由来する.
 5017: @end enumerate
 5018: 
 5019: @node Reporting Bugs
 5020: @chapter バグの報告
 5021: @cindex bugs
 5022: @cindex reporting bugs
 5023: 
 5024: @c Your bug reports play an essential role in making the binary utilities
 5025: @c reliable.
 5026: @c 
 5027: バグの報告は,バイナリユーティリティを確実にする上で重要な役割を果たしま
 5028: す.
 5029: 
 5030: @c Reporting a bug may help you by bringing a solution to your problem, or
 5031: @c it may not.  But in any case the principal function of a bug report is
 5032: @c to help the entire community by making the next version of the binary
 5033: @c utilities work better.  Bug reports are your contribution to their
 5034: @c maintenance.
 5035: @c 
 5036: バグを報告することで,問題の解決をもたらすかもしれませんが,そうでないか
 5037: もしれません.しかし,いずれにせよ,バグの報告の主な機能は,バイナリユー
 5038: ティリティの次のバージョンの仕事をより良くすることで,全てのコミュニティ
 5039: に役立つことです.バグの報告は,管理者に対する貢献になります.
 5040: 
 5041: @c In order for a bug report to serve its purpose, you must include the
 5042: @c information that enables us to fix the bug.
 5043: @c 
 5044: バグの報告を目的に役立つようにするため,バグの修正が可能となるような情報
 5045: を含める必要があります.
 5046: 
 5047: @menu
 5048: * Bug Criteria::                Have you found a bug?
 5049: * Bug Reporting::               How to report bugs
 5050: @end menu
 5051: 
 5052: @node Bug Criteria
 5053: @section バグを見つけましたか?
 5054: @cindex bug criteria
 5055: 
 5056: @c If you are not sure whether you have found a bug, here are some guidelines:
 5057: @c 
 5058: バグを見つけたかどうか確実でない場合,ここに指針がいくつかあります.
 5059: 
 5060: @itemize @bullet
 5061: @cindex fatal signal
 5062: @cindex crash
 5063: @item
 5064: @c If a binary utility gets a fatal signal, for any input whatever, that is
 5065: @c a bug.  Reliable utilities never crash.
 5066: @c 
 5067: バイナリユーティリティが,入力によらず,致命的なシグナルを得た場合,それ
 5068: はバグです.信頼できるユーティリティは決して壊れません.
 5069: 
 5070: @cindex error on valid input
 5071: @item
 5072: @c If a binary utility produces an error message for valid input, that is a
 5073: @c bug.
 5074: @c 
 5075: バイナリユーティリティが有効な入力に対しエラーメッセージを生成した場合,
 5076: それはバグです.
 5077: 
 5078: @item
 5079: @c If you are an experienced user of binary utilities, your suggestions for
 5080: @c improvement are welcome in any case.
 5081: @c 
 5082: バイナリユーティリティの経験豊かなユーザの場合,改良のための提案はいつで
 5083: も歓迎します.
 5084: @end itemize
 5085: 
 5086: @node Bug Reporting
 5087: @section バグの報告の方法
 5088: @cindex bug reports
 5089: @cindex bugs, reporting
 5090: 
 5091: @c A number of companies and individuals offer support for @sc{gnu}
 5092: @c products.  If you obtained the binary utilities from a support
 5093: @c organization, we recommend you contact that organization first.
 5094: @c 
 5095: 多くの企業と個人が,@sc{gnu}製品に対してサポートを提供しています.サポー
 5096: ト組織からバイナリユーティリティを得ている場合,われわれは,その組織に最
 5097: 初に連絡するように勧めます.
 5098: 
 5099: @c You can find contact information for many support companies and
 5100: @c individuals in the file @file{etc/SERVICE} in the @sc{gnu} Emacs
 5101: @c distribution.
 5102: @c 
 5103: @sc{gnu} Emacs配布物のファイル@file{etc/SERVICE}で,サポートしている多く
 5104: の会社と個人へ連絡する情報を見つけることが可能です.
 5105: 
 5106: @c In any event, we also recommend that you send bug reports for the binary
 5107: @c utilities to @samp{bug-binutils@@gnu.org}.
 5108: @c 
 5109: いずれにせよ,我々は,バイナリユーティリティに対するバグの報告を
 5110: @samp{bug-binutils@@gnu.org}にも送ることを勧めます.
 5111: 
 5112: @c The fundamental principle of reporting bugs usefully is this:
 5113: @c @strong{report all the facts}.  If you are not sure whether to state a
 5114: @c fact or leave it out, state it!
 5115: @c 
 5116: バグの報告の有効な基本原理は以下のとおりです.@strong{すべての事実を報告
 5117: する}.事実を述べるべきか削除すべきかよく分からない場合,それを述べてく
 5118: ださい!
 5119: 
 5120: @c Often people omit facts because they think they know what causes the
 5121: @c problem and assume that some details do not matter.  Thus, you might
 5122: @c assume that the name of a file you use in an example does not matter.
 5123: @c Well, probably it does not, but one cannot be sure.  Perhaps the bug is
 5124: @c a stray memory reference which happens to fetch from the location where
 5125: @c that pathname is stored in memory; perhaps, if the pathname were
 5126: @c different, the contents of that location would fool the utility into
 5127: @c doing the right thing despite the bug.  Play it safe and give a
 5128: @c specific, complete example.  That is the easiest thing for you to do,
 5129: @c and the most helpful.
 5130: @c 
 5131: 人々はよく,問題を発生させるものを知っていて,重要でない詳細もあると思う
 5132: ため,事実を省略します.このため,使用したファイル名は重要でないと考えた
 5133: とします.さて,おそらくそうでしょうが,確実ではありません.おそらくバグ
 5134: は,パス名がメモリに保存されている場所から取り出すために生じる,偶然のメ
 5135: モリ参照です.おそらく,パス名が異なっている場合,その場所の内容は,バグ
 5136: にもかかわらず正しいことを行うユーティリティを馬鹿にするでしょう.安全に
 5137: 動作するようにし,特定の完全な例を与えてください.それは,最も簡単に行う
 5138: ことができ,最も役に立ちます.
 5139: 
 5140: @c Keep in mind that the purpose of a bug report is to enable us to fix the bug if
 5141: @c it is new to us.  Therefore, always write your bug reports on the assumption
 5142: @c that the bug has not been reported previously.
 5143: @c 
 5144: バグの報告の目的が,新しいものの場合は,バグの修正を可能にすることだとい
 5145: うことを覚えておいてください.そのため,以前にバグが報告されていないこと
 5146: を常に前提にして,バグの報告を書いてください.
 5147: 
 5148: @c Sometimes people give a few sketchy facts and ask, ``Does this ring a
 5149: @c bell?''  Those bug reports are useless, and we urge everyone to
 5150: @c @emph{refuse to respond to them} except to chide the sender to report
 5151: @c bugs properly.
 5152: @c 
 5153: ときどき,概略だけのわずかな事実を与え,``これは報告すべきですか? (Does
 5154: this ring a bell?)と尋ねる人がいます.これらのバグの報告は役に立たず,正
 5155: しくバグの報告をするよう送付者に小言を言うために,@emph{それに対する返答
 5156: を廃棄するように}ということを,我々は全員に勧めます.
 5157: 
 5158: @c To enable us to fix the bug, you should include all these things:
 5159: @c 
 5160: バグの修正を可能とするため,これらすべてのものを含めるべきです.
 5161: 
 5162: @itemize @bullet
 5163: @item
 5164: @c The version of the utility.  Each utility announces it if you start it
 5165: @c with the @option{--version} argument.
 5166: @c 
 5167: ユーティリティのバージョン.それぞれのバージョンは,@option{--version}引
 5168: 数を用いて開始した場合,それを報告します.
 5169: 
 5170: @c Without this, we will not know whether there is any point in looking for
 5171: @c the bug in the current version of the binary utilities.
 5172: @c 
 5173: これがなければ,我々はバイナリユーティリティの現在のバージョンにバグを探
 5174: す場所があるかどうか分かりません.
 5175: 
 5176: @item
 5177: @c Any patches you may have applied to the source, including any patches
 5178: @c made to the @code{BFD} library.
 5179: @c 
 5180: @code{BFD}ライブラリを作るために与えたパッチを含む,ソースに適用したあら
 5181: ゆるパッチ.
 5182: 
 5183: @item
 5184: @c The type of machine you are using, and the operating system name and
 5185: @c version number.
 5186: @c 
 5187: 使用しているマシンの形式と,オペレーティングシステム名とバージョンナン
 5188: バー.
 5189: 
 5190: @item
 5191: @c What compiler (and its version) was used to compile the utilities---e.g.
 5192: @c ``@code{gcc-2.7}''.
 5193: @c 
 5194: ユーティリティをコンパイルするとき使用したコンパイラ(とバージョン) --- 
 5195: 例えば,``@code{gcc-2.7}''.
 5196: 
 5197: @item
 5198: @c The command arguments you gave the utility to observe the bug.  To
 5199: @c guarantee you will not omit something important, list them all.  A copy
 5200: @c of the Makefile (or the output from make) is sufficient.
 5201: @c 
 5202: バグを観測するためにユーティリティに与えたコマンド引数.重要なものを省略
 5203: しないことを保証するため,すべてをリストアップしてください.Makefile(ま
 5204: たはmakeの出力)のコピーで十分です.
 5205: 
 5206: @c If we were to try to guess the arguments, we would probably guess wrong
 5207: @c and then we might not encounter the bug.
 5208: @c 
 5209: 我々が引数を推測しようとした場合,おそらく間違ったものを推測し,バグに遭
 5210: 遇しない可能性があります.
 5211: 
 5212: @item
 5213: @c A complete input file, or set of input files, that will reproduce the
 5214: @c bug.  If the utility is reading an object file or files, then it is
 5215: @c generally most helpful to send the actual object files, uuencoded if
 5216: @c necessary to get them through the mail system.  Note that
 5217: @c @samp{bug-binutils@@gnu.org} is a mailing list, so you should avoid
 5218: @c sending very large files to it.  Making the files available for
 5219: @c anonymous FTP is OK.
 5220: @c 
 5221: 完全な入力ファイルまたは入力ファイルの組で,実際のオブジェクトファイルを
 5222: 送ることは,最も役に立ち,バグがあればuuencodeしてください.ユーティリティ
 5223: がオブジェクトファイルやファイルを読み込んでいる場合,それをメールシステ
 5224: ムに通過させる場合必要です.@samp{bug-binutils@@gnu.org}はメーリングリス
 5225: トなので,非常に大きなファイルをそこに送ることは避けるよう注意してくださ
 5226: い.ファイルをanonymous FTPで利用可能にするとOKです.
 5227: 
 5228: @c If the source files were produced exclusively using @sc{gnu} programs
 5229: @c (e.g., @command{gcc}, @command{gas}, and/or the @sc{gnu} @command{ld}), then it
 5230: @c may be OK to send the source files rather than the object files.  In
 5231: @c this case, be sure to say exactly what version of @command{gcc}, or
 5232: @c whatever, was used to produce the object files.  Also say how
 5233: @c @command{gcc}, or whatever, was configured.
 5234: @c 
 5235: ソースファイルが@sc{gnu}プログラム(例えば,@command{gcc},@command{gas},
 5236: そして/または,@sc{gnu} @command{ld})を使用して生成されたことが明らかな
 5237: 場合,オブジェクトファイルよりソースファイルを送ることでOKです.この場合,
 5238: @command{gcc}や,それらオブジェクトファイルを生成するために使用したあら
 5239: ゆるもののバージョンを正確に確実に伝えてください.@command{gcc}や,それ
 5240: らあらゆるもののコンフィグレーションの方法も伝えてください.
 5241: 
 5242: @item
 5243: @c A description of what behavior you observe that you believe is
 5244: @c incorrect.  For example, ``It gets a fatal signal.''
 5245: @c 
 5246: 適当でないと確信することになった動作の記述.例えば,``致命的なシグナルを
 5247: 得た''.
 5248: 
 5249: @c Of course, if the bug is that the utility gets a fatal signal, then we
 5250: @c will certainly notice it.  But if the bug is incorrect output, we might
 5251: @c not notice unless it is glaringly wrong.  You might as well not give us
 5252: @c a chance to make a mistake.
 5253: @c 
 5254: もちろん,バグはユーティリティが致命的なシグナルを得た場合,我々はきっと
 5255: そこに注目します.しかし,バグが不適切な出力の場合,我々は,明らかに間違っ
 5256: ていない限り注目しないかもしれません.我々が間違う機会を与えない方がよい
 5257: でしょう.
 5258: 
 5259: @c Even if the problem you experience is a fatal signal, you should still
 5260: @c say so explicitly.  Suppose something strange is going on, such as your
 5261: @c copy of the utility is out of synch, or you have encountered a bug in
 5262: @c the C library on your system.  (This has happened!)  Your copy might
 5263: @c crash and ours would not.  If you told us to expect a crash, then when
 5264: @c ours fails to crash, we would know that the bug was not happening for
 5265: @c us.  If you had not told us to expect a crash, then we would not be able
 5266: @c to draw any conclusion from our observations.
 5267: @c 
 5268: 遭遇した問題が致命的なシグナルの場合でさえ,それを明確に伝えるべきです.
 5269: ユーティリティのコピーが同期化されていない,または,システムのCライブラ
 5270: リのバグに遭遇したといった,おそらく何か変なことが生じています.(それは
 5271: 発生したのです!) コピーは壊れていて,我々のはそうでないかもしれません.
 5272: 壊れることを期待していると我々に告げ,我々が壊すことに失敗した場合,我々
 5273: にバグは発生しないことを知るでしょう.壊れることを期待していると我々に告
 5274: げない場合,我々は自分達の観測から全く結論が得られないでしょう.
 5275: 
 5276: @item
 5277: @c If you wish to suggest changes to the source, send us context diffs, as
 5278: @c generated by @command{diff} with the @option{-u}, @option{-c}, or @option{-p}
 5279: @c option.  Always send diffs from the old file to the new file.  If you
 5280: @c wish to discuss something in the @command{ld} source, refer to it by
 5281: @c context, not by line number.
 5282: @c 
 5283: ソースの変更を提案したい場合,@option{-u},@option{-c},または
 5284: @option{-p}オプションを用いた@command{diff}で生成したような,コンテクス
 5285: トのdiffを我々に送ってください.古いファイルから新しいファイルへのdiffを,
 5286: 常に送ってください.@command{ld}のソースについて何か議論したい場合,行番
 5287: 号ではなくコンテクストで参照してください.
 5288: 
 5289: @c The line numbers in our development sources will not match those in your
 5290: @c sources.  Your line numbers would convey no useful information to us.
 5291: @c 
 5292: 我々の開発ソース内の行番号は,あなた方のソースと一致しないでしょう.行番
 5293: 号は我々に全く情報をもたらしません.
 5294: @end itemize
 5295: 
 5296: @c Here are some things that are not necessary:
 5297: @c 
 5298: 不要なものは以下のものです.
 5299: 
 5300: @itemize @bullet
 5301: @item
 5302: @c A description of the envelope of the bug.
 5303: @c 
 5304: バグの回りの説明.
 5305: 
 5306: @c Often people who encounter a bug spend a lot of time investigating
 5307: @c which changes to the input file will make the bug go away and which
 5308: @c changes will not affect it.
 5309: @c 
 5310: バグに遭遇した人は,バグを無くす入力ファイルへの変更と,効果がない変更を
 5311: 調査するのに多くの時間を費やすことが多いです.
 5312: 
 5313: @c This is often time consuming and not very useful, because the way we
 5314: @c will find the bug is by running a single example under the debugger
 5315: @c with breakpoints, not by pure deduction from a series of examples.
 5316: @c We recommend that you save your time for something else.
 5317: @c 
 5318: 我々がバグを見つける方法は,単純な例をブレークポイントを用いたデバッガで
 5319: 実行することで,それは一連の例から推測することではないので,これは役に立
 5320: たないことが多いです.我々は,他のことをすることを勧めます.
 5321: 
 5322: @c Of course, if you can find a simpler example to report @emph{instead}
 5323: @c of the original one, that is a convenience for us.  Errors in the
 5324: @c output will be easier to spot, running under the debugger will take
 5325: @c less time, and so on.
 5326: @c 
 5327: もちろん,報告するためのオリジナルの例@emph{ではなく},それより簡単な例
 5328: が見つかった場合,それはとても役立ちます.出力ファイルのエラーは,見つけ
 5329: るのがより簡単,デバッガの実行に余り時間がかからない,等々です.
 5330: 
 5331: @c However, simplification is not vital; if you do not want to do this,
 5332: @c report the bug anyway and send us the entire test case you used.
 5333: @c 
 5334: しかし,簡略化は重要ではありません.こうしたくない場合,いい加減にバグを
 5335: 報告し,使用したテストケースを全て我々に送ってください.
 5336: 
 5337: @item
 5338: @c A patch for the bug.
 5339: @c 
 5340: バグに対するパッチ.
 5341: 
 5342: @c A patch for the bug does help us if it is a good one.  But do not omit
 5343: @c the necessary information, such as the test case, on the assumption that
 5344: @c a patch is all we need.  We might see problems with your patch and decide
 5345: @c to fix the problem another way, or we might not understand it at all.
 5346: @c 
 5347: バグに対するパッチは,それが良いものであれば我々は助かります.しかし,テ
 5348: ストケースのような,我々全員がパッチを必要だと推測するのに必要な情報を省
 5349: 略しないでください.我々は,パッチに関する問題が分かり,別の方法で問題を
 5350: 修正することに決めるかもしれませんし,全く理解できないかもしれません.
 5351: 
 5352: @c Sometimes with programs as complicated as the binary utilities it is
 5353: @c very hard to construct an example that will make the program follow a
 5354: @c certain path through the code.  If you do not send us the example, we
 5355: @c will not be able to construct one, so we will not be able to verify that
 5356: @c the bug is fixed.
 5357: @c 
 5358: バイナリユーティリティと同じくらい複雑なプログラムを用いた場合,コードを
 5359: 通じて,プログラムに特定の手順をたどらせる例を構成することは,とても難し
 5360: いことです.例を我々に送らない場合,我々はそれを構成することができないの
 5361: で,我々はバグが修正されたかどうか検証することができません.
 5362: 
 5363: @c And if we cannot understand what bug you are trying to fix, or why your
 5364: @c patch should be an improvement, we will not install it.  A test case will
 5365: @c help us to understand.
 5366: @c 
 5367: そして,あなたが修正しようとしたバグや,パッチの改良点を我々が理解できな
 5368: い場合や,我々はそれをインストールしないでしょう.テストケースは我々の理
 5369: 解を助けます.
 5370: 
 5371: @item
 5372: @c A guess about what the bug is or what it depends on.
 5373: @c 
 5374: バグやそれが依存するものに関する推測.
 5375: 
 5376: @c Such guesses are usually wrong.  Even we cannot guess right about such
 5377: @c things without first using the debugger to find the facts.
 5378: @c 
 5379: そのような推測は,通常正しくありません.事実を見つけるために最初にデバッ
 5380: ガを使用しなければ,我々でも正しく推測できません.
 5381: @end itemize
 5382: 
 5383: @node GNU Free Documentation License
 5384: @chapter GNU Free Documentation License
 5385: @cindex GNU Free Documentation License
 5386: 
 5387:                 GNU Free Documentation License
 5388:                 
 5389:                    Version 1.1, March 2000
 5390: 
 5391:  Copyright (C) 2000  Free Software Foundation, Inc.
 5392:   59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 5393:      
 5394:  Everyone is permitted to copy and distribute verbatim copies
 5395:  of this license document, but changing it is not allowed.
 5396: 
 5397: 
 5398: 0. PREAMBLE
 5399: 
 5400: The purpose of this License is to make a manual, textbook, or other
 5401: written document "free" in the sense of freedom: to assure everyone
 5402: the effective freedom to copy and redistribute it, with or without
 5403: modifying it, either commercially or noncommercially.  Secondarily,
 5404: this License preserves for the author and publisher a way to get
 5405: credit for their work, while not being considered responsible for
 5406: modifications made by others.
 5407: 
 5408: This License is a kind of "copyleft", which means that derivative
 5409: works of the document must themselves be free in the same sense.  It
 5410: complements the GNU General Public License, which is a copyleft
 5411: license designed for free software.
 5412: 
 5413: We have designed this License in order to use it for manuals for free
 5414: software, because free software needs free documentation: a free
 5415: program should come with manuals providing the same freedoms that the
 5416: software does.  But this License is not limited to software manuals;
 5417: it can be used for any textual work, regardless of subject matter or
 5418: whether it is published as a printed book.  We recommend this License
 5419: principally for works whose purpose is instruction or reference.
 5420: 
 5421: 
 5422: 1. APPLICABILITY AND DEFINITIONS
 5423: 
 5424: This License applies to any manual or other work that contains a
 5425: notice placed by the copyright holder saying it can be distributed
 5426: under the terms of this License.  The "Document", below, refers to any
 5427: such manual or work.  Any member of the public is a licensee, and is
 5428: addressed as "you".
 5429: 
 5430: A "Modified Version" of the Document means any work containing the
 5431: Document or a portion of it, either copied verbatim, or with
 5432: modifications and/or translated into another language.
 5433: 
 5434: A "Secondary Section" is a named appendix or a front-matter section of
 5435: the Document that deals exclusively with the relationship of the
 5436: publishers or authors of the Document to the Document's overall subject
 5437: (or to related matters) and contains nothing that could fall directly
 5438: within that overall subject.  (For example, if the Document is in part a
 5439: textbook of mathematics, a Secondary Section may not explain any
 5440: mathematics.)  The relationship could be a matter of historical
 5441: connection with the subject or with related matters, or of legal,
 5442: commercial, philosophical, ethical or political position regarding
 5443: them.
 5444: 
 5445: The "Invariant Sections" are certain Secondary Sections whose titles
 5446: are designated, as being those of Invariant Sections, in the notice
 5447: that says that the Document is released under this License.
 5448: 
 5449: The "Cover Texts" are certain short passages of text that are listed,
 5450: as Front-Cover Texts or Back-Cover Texts, in the notice that says that
 5451: the Document is released under this License.
 5452: 
 5453: A "Transparent" copy of the Document means a machine-readable copy,
 5454: represented in a format whose specification is available to the
 5455: general public, whose contents can be viewed and edited directly and
 5456: straightforwardly with generic text editors or (for images composed of
 5457: pixels) generic paint programs or (for drawings) some widely available
 5458: drawing editor, and that is suitable for input to text formatters or
 5459: for automatic translation to a variety of formats suitable for input
 5460: to text formatters.  A copy made in an otherwise Transparent file
 5461: format whose markup has been designed to thwart or discourage
 5462: subsequent modification by readers is not Transparent.  A copy that is
 5463: not "Transparent" is called "Opaque".
 5464: 
 5465: Examples of suitable formats for Transparent copies include plain
 5466: ASCII without markup, Texinfo input format, LaTeX input format, SGML
 5467: or XML using a publicly available DTD, and standard-conforming simple
 5468: HTML designed for human modification.  Opaque formats include
 5469: PostScript, PDF, proprietary formats that can be read and edited only
 5470: by proprietary word processors, SGML or XML for which the DTD and/or
 5471: processing tools are not generally available, and the
 5472: machine-generated HTML produced by some word processors for output
 5473: purposes only.
 5474: 
 5475: The "Title Page" means, for a printed book, the title page itself,
 5476: plus such following pages as are needed to hold, legibly, the material
 5477: this License requires to appear in the title page.  For works in
 5478: formats which do not have any title page as such, "Title Page" means
 5479: the text near the most prominent appearance of the work's title,
 5480: preceding the beginning of the body of the text.
 5481: 
 5482: 
 5483: 2. VERBATIM COPYING
 5484: 
 5485: You may copy and distribute the Document in any medium, either
 5486: commercially or noncommercially, provided that this License, the
 5487: copyright notices, and the license notice saying this License applies
 5488: to the Document are reproduced in all copies, and that you add no other
 5489: conditions whatsoever to those of this License.  You may not use
 5490: technical measures to obstruct or control the reading or further
 5491: copying of the copies you make or distribute.  However, you may accept
 5492: compensation in exchange for copies.  If you distribute a large enough
 5493: number of copies you must also follow the conditions in section 3.
 5494: 
 5495: You may also lend copies, under the same conditions stated above, and
 5496: you may publicly display copies.
 5497: 
 5498: 
 5499: 3. COPYING IN QUANTITY
 5500: 
 5501: If you publish printed copies of the Document numbering more than 100,
 5502: and the Document's license notice requires Cover Texts, you must enclose
 5503: the copies in covers that carry, clearly and legibly, all these Cover
 5504: Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
 5505: the back cover.  Both covers must also clearly and legibly identify
 5506: you as the publisher of these copies.  The front cover must present
 5507: the full title with all words of the title equally prominent and
 5508: visible.  You may add other material on the covers in addition.
 5509: Copying with changes limited to the covers, as long as they preserve
 5510: the title of the Document and satisfy these conditions, can be treated
 5511: as verbatim copying in other respects.
 5512: 
 5513: If the required texts for either cover are too voluminous to fit
 5514: legibly, you should put the first ones listed (as many as fit
 5515: reasonably) on the actual cover, and continue the rest onto adjacent
 5516: pages.
 5517: 
 5518: If you publish or distribute Opaque copies of the Document numbering
 5519: more than 100, you must either include a machine-readable Transparent
 5520: copy along with each Opaque copy, or state in or with each Opaque copy
 5521: a publicly-accessible computer-network location containing a complete
 5522: Transparent copy of the Document, free of added material, which the
 5523: general network-using public has access to download anonymously at no
 5524: charge using public-standard network protocols.  If you use the latter
 5525: option, you must take reasonably prudent steps, when you begin
 5526: distribution of Opaque copies in quantity, to ensure that this
 5527: Transparent copy will remain thus accessible at the stated location
 5528: until at least one year after the last time you distribute an Opaque
 5529: copy (directly or through your agents or retailers) of that edition to
 5530: the public.
 5531: 
 5532: It is requested, but not required, that you contact the authors of the
 5533: Document well before redistributing any large number of copies, to give
 5534: them a chance to provide you with an updated version of the Document.
 5535: 
 5536: 
 5537: 4. MODIFICATIONS
 5538: 
 5539: You may copy and distribute a Modified Version of the Document under
 5540: the conditions of sections 2 and 3 above, provided that you release
 5541: the Modified Version under precisely this License, with the Modified
 5542: Version filling the role of the Document, thus licensing distribution
 5543: and modification of the Modified Version to whoever possesses a copy
 5544: of it.  In addition, you must do these things in the Modified Version:
 5545: 
 5546: A. Use in the Title Page (and on the covers, if any) a title distinct
 5547:    from that of the Document, and from those of previous versions
 5548:    (which should, if there were any, be listed in the History section
 5549:    of the Document).  You may use the same title as a previous version
 5550:    if the original publisher of that version gives permission.
 5551: B. List on the Title Page, as authors, one or more persons or entities
 5552:    responsible for authorship of the modifications in the Modified
 5553:    Version, together with at least five of the principal authors of the
 5554:    Document (all of its principal authors, if it has less than five).
 5555: C. State on the Title page the name of the publisher of the
 5556:    Modified Version, as the publisher.
 5557: D. Preserve all the copyright notices of the Document.
 5558: E. Add an appropriate copyright notice for your modifications
 5559:    adjacent to the other copyright notices.
 5560: F. Include, immediately after the copyright notices, a license notice
 5561:    giving the public permission to use the Modified Version under the
 5562:    terms of this License, in the form shown in the Addendum below.
 5563: G. Preserve in that license notice the full lists of Invariant Sections
 5564:    and required Cover Texts given in the Document's license notice.
 5565: H. Include an unaltered copy of this License.
 5566: I. Preserve the section entitled "History", and its title, and add to
 5567:    it an item stating at least the title, year, new authors, and
 5568:    publisher of the Modified Version as given on the Title Page.  If
 5569:    there is no section entitled "History" in the Document, create one
 5570:    stating the title, year, authors, and publisher of the Document as
 5571:    given on its Title Page, then add an item describing the Modified
 5572:    Version as stated in the previous sentence.
 5573: J. Preserve the network location, if any, given in the Document for
 5574:    public access to a Transparent copy of the Document, and likewise
 5575:    the network locations given in the Document for previous versions
 5576:    it was based on.  These may be placed in the "History" section.
 5577:    You may omit a network location for a work that was published at
 5578:    least four years before the Document itself, or if the original
 5579:    publisher of the version it refers to gives permission.
 5580: K. In any section entitled "Acknowledgements" or "Dedications",
 5581:    preserve the section's title, and preserve in the section all the
 5582:    substance and tone of each of the contributor acknowledgements
 5583:    and/or dedications given therein.
 5584: L. Preserve all the Invariant Sections of the Document,
 5585:    unaltered in their text and in their titles.  Section numbers
 5586:    or the equivalent are not considered part of the section titles.
 5587: M. Delete any section entitled "Endorsements".  Such a section
 5588:    may not be included in the Modified Version.
 5589: N. Do not retitle any existing section as "Endorsements"
 5590:    or to conflict in title with any Invariant Section.
 5591: 
 5592: If the Modified Version includes new front-matter sections or
 5593: appendices that qualify as Secondary Sections and contain no material
 5594: copied from the Document, you may at your option designate some or all
 5595: of these sections as invariant.  To do this, add their titles to the
 5596: list of Invariant Sections in the Modified Version's license notice.
 5597: These titles must be distinct from any other section titles.
 5598: 
 5599: You may add a section entitled "Endorsements", provided it contains
 5600: nothing but endorsements of your Modified Version by various
 5601: parties--for example, statements of peer review or that the text has
 5602: been approved by an organization as the authoritative definition of a
 5603: standard.
 5604: 
 5605: You may add a passage of up to five words as a Front-Cover Text, and a
 5606: passage of up to 25 words as a Back-Cover Text, to the end of the list
 5607: of Cover Texts in the Modified Version.  Only one passage of
 5608: Front-Cover Text and one of Back-Cover Text may be added by (or
 5609: through arrangements made by) any one entity.  If the Document already
 5610: includes a cover text for the same cover, previously added by you or
 5611: by arrangement made by the same entity you are acting on behalf of,
 5612: you may not add another; but you may replace the old one, on explicit
 5613: permission from the previous publisher that added the old one.
 5614: 
 5615: The author(s) and publisher(s) of the Document do not by this License
 5616: give permission to use their names for publicity for or to assert or
 5617: imply endorsement of any Modified Version.
 5618: 
 5619: 
 5620: 5. COMBINING DOCUMENTS
 5621: 
 5622: You may combine the Document with other documents released under this
 5623: License, under the terms defined in section 4 above for modified
 5624: versions, provided that you include in the combination all of the
 5625: Invariant Sections of all of the original documents, unmodified, and
 5626: list them all as Invariant Sections of your combined work in its
 5627: license notice.
 5628: 
 5629: The combined work need only contain one copy of this License, and
 5630: multiple identical Invariant Sections may be replaced with a single
 5631: copy.  If there are multiple Invariant Sections with the same name but
 5632: different contents, make the title of each such section unique by
 5633: adding at the end of it, in parentheses, the name of the original
 5634: author or publisher of that section if known, or else a unique number.
 5635: Make the same adjustment to the section titles in the list of
 5636: Invariant Sections in the license notice of the combined work.
 5637: 
 5638: In the combination, you must combine any sections entitled "History"
 5639: in the various original documents, forming one section entitled
 5640: "History"; likewise combine any sections entitled "Acknowledgements",
 5641: and any sections entitled "Dedications".  You must delete all sections
 5642: entitled "Endorsements."
 5643: 
 5644: 
 5645: 6. COLLECTIONS OF DOCUMENTS
 5646: 
 5647: You may make a collection consisting of the Document and other documents
 5648: released under this License, and replace the individual copies of this
 5649: License in the various documents with a single copy that is included in
 5650: the collection, provided that you follow the rules of this License for
 5651: verbatim copying of each of the documents in all other respects.
 5652: 
 5653: You may extract a single document from such a collection, and distribute
 5654: it individually under this License, provided you insert a copy of this
 5655: License into the extracted document, and follow this License in all
 5656: other respects regarding verbatim copying of that document.
 5657: 
 5658: 
 5659: 7. AGGREGATION WITH INDEPENDENT WORKS
 5660: 
 5661: A compilation of the Document or its derivatives with other separate
 5662: and independent documents or works, in or on a volume of a storage or
 5663: distribution medium, does not as a whole count as a Modified Version
 5664: of the Document, provided no compilation copyright is claimed for the
 5665: compilation.  Such a compilation is called an "aggregate", and this
 5666: License does not apply to the other self-contained works thus compiled
 5667: with the Document, on account of their being thus compiled, if they
 5668: are not themselves derivative works of the Document.
 5669: 
 5670: If the Cover Text requirement of section 3 is applicable to these
 5671: copies of the Document, then if the Document is less than one quarter
 5672: of the entire aggregate, the Document's Cover Texts may be placed on
 5673: covers that surround only the Document within the aggregate.
 5674: Otherwise they must appear on covers around the whole aggregate.
 5675: 
 5676: 
 5677: 8. TRANSLATION
 5678: 
 5679: Translation is considered a kind of modification, so you may
 5680: distribute translations of the Document under the terms of section 4.
 5681: Replacing Invariant Sections with translations requires special
 5682: permission from their copyright holders, but you may include
 5683: translations of some or all Invariant Sections in addition to the
 5684: original versions of these Invariant Sections.  You may include a
 5685: translation of this License provided that you also include the
 5686: original English version of this License.  In case of a disagreement
 5687: between the translation and the original English version of this
 5688: License, the original English version will prevail.
 5689: 
 5690: 
 5691: 9. TERMINATION
 5692: 
 5693: You may not copy, modify, sublicense, or distribute the Document except
 5694: as expressly provided for under this License.  Any other attempt to
 5695: copy, modify, sublicense or distribute the Document is void, and will
 5696: automatically terminate your rights under this License.  However,
 5697: parties who have received copies, or rights, from you under this
 5698: License will not have their licenses terminated so long as such
 5699: parties remain in full compliance.
 5700: 
 5701: 
 5702: 10. FUTURE REVISIONS OF THIS LICENSE
 5703: 
 5704: The Free Software Foundation may publish new, revised versions
 5705: of the GNU Free Documentation License from time to time.  Such new
 5706: versions will be similar in spirit to the present version, but may
 5707: differ in detail to address new problems or concerns.  See
 5708: http://www.gnu.org/copyleft/.
 5709: 
 5710: Each version of the License is given a distinguishing version number.
 5711: If the Document specifies that a particular numbered version of this
 5712: License "or any later version" applies to it, you have the option of
 5713: following the terms and conditions either of that specified version or
 5714: of any later version that has been published (not as a draft) by the
 5715: Free Software Foundation.  If the Document does not specify a version
 5716: number of this License, you may choose any version ever published (not
 5717: as a draft) by the Free Software Foundation.
 5718: 
 5719: 
 5720: ADDENDUM: How to use this License for your documents
 5721: 
 5722: To use this License in a document you have written, include a copy of
 5723: the License in the document and put the following copyright and
 5724: license notices just after the title page:
 5725: 
 5726: @smallexample
 5727:     Copyright (c)  YEAR  YOUR NAME.
 5728:     Permission is granted to copy, distribute and/or modify this document
 5729:     under the terms of the GNU Free Documentation License, Version 1.1
 5730:     or any later version published by the Free Software Foundation;
 5731:     with the Invariant Sections being LIST THEIR TITLES, with the
 5732:     Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
 5733:     A copy of the license is included in the section entitled "GNU
 5734:     Free Documentation License".
 5735: @end smallexample
 5736: 
 5737: If you have no Invariant Sections, write "with no Invariant Sections"
 5738: instead of saying which ones are invariant.  If you have no
 5739: Front-Cover Texts, write "no Front-Cover Texts" instead of
 5740: "Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
 5741: 
 5742: If your document contains nontrivial examples of program code, we
 5743: recommend releasing these examples in parallel under your choice of
 5744: free software license, such as the GNU General Public License,
 5745: to permit their use in free software.
 5746: 
 5747: @node Index
 5748: @unnumbered 索引
 5749: 
 5750: @printindex cp
 5751: 
 5752: @contents
 5753: @bye

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>