File:  [Local Repository] / gnujdoc / binutils-2.14 / binutils-ja.texi
Revision 1.1: download - view: text, annotated - select for diffs
Thu Feb 26 12:47:08 2004 UTC (16 years, 8 months ago) by futoshi
Branches: MAIN
CVS tags: HEAD
Add binutils-2.14.

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

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