manual/GNU_binutils/draft/man1/nm.1

   1 .\" Copyright (c) 1991 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .\"
   4 .\" Japanese Version Copyright (c) 1997 NAKANO Takeo all rights reserved.
   5 .\" Translated Wed Dec 17 1997 by NAKANO Takeo <nakano@@apm.seikei.ac.jp>
   6 .\"
   7 .TH nm 1 "5 November 1991" "cygnus support" "GNU Development Tools"
   8 .de BP
   9 .sp
  10 .ti \-.2i
  11 \(**
  12 ..
  13
  14 .\"O .SH NAME
  15 .\"O nm \- list symbols from object files.
  16 .SH 名前
  17 nm \- オブジェクトファイルのシンボルをリストする
  18
  19 .\"O .SH SYNOPSIS
  20 .SH 書式
  21 .hy 0
  22 .na
  23 .TP
  24 .B nm
  25 .RB "[\|" \-a | \-\-debug\-syms "\|]"
  26 .RB "[\|" \-g | \-\-extern\-only "\|]"
  27 .RB "[\|" \-B "\|]"
  28 .RB "[\|" \-C | \-\-demangle "\|]"
  29 .RB "[\|" \-D | \-\-dynamic "\|]"
  30 .RB "[\|" \-s | \-\-print\-armap "\|]"
  31 .RB "[\|" \-o | \-\-print\-file\-name "\|]"
  32 .RB "[\|" \-n | \-\-numeric\-sort "\|]"
  33 .RB "[\|" \-p | \-\-no\-sort "\|]"
  34 .RB "[\|" \-r | \-\-reverse\-sort "\|]"
  35 .RB "[\|" \-\-size\-sort "\|]"
  36 .RB "[\|" \-u | \-\-undefined\-only "\|]"
  37 .RB "[\|" \-l | \-\-line\-numbers "\|]"
  38 .RB "[\|" \-\-help "\|]"
  39 .RB "[\|" \-\-version "\|]"
  40 .RB "[\|" "\-t \fIradix" | \-\-radix=\fIradix "\|]"
  41 .RB "[\|" \-P | --portability "\|]"
  42 .RB "[\|" "\-f \fIformat" | \-\-format=\fIformat "\|]"
  43 .RB "[\|" "\-\-target=\fIbfdname" "\|]"
  44 .RB "[\|" \c
  45 .I objfile\c
  46 \&.\|.\|.\|]
  47 .ad b
  48 .hy 1
  49 .\"O .SH DESCRIPTION
  50 .SH 説明
  51 .\"O GNU \c
  52 .\"O .B nm\c
  53 .\"O \& lists the symbols from object files \c
  54 .\"O .I objfile\c
  55 .\"O \&.  If no object files are given as arguments, \c
  56 .\"O .B nm\c
  57 .\"O \& assumes `\|\c
  58 .\"O .B a.out\c
  59 .\"O \|'.
  60 GNU
  61 .B nm
  62 はオブジェクトファイル
  63 .I objfile
  64 からシンボルを抽出して表示する。 引数にオブジェクトファイルが与えられ
  65 なかった場合は、
  66 .B a.out
  67 ファイルに対して動作する。
  68
  69 .\"O .SH OPTIONS
  70 .SH オプション
  71 .\"O The long and short forms of options, shown here as alternatives, are
  72 .\"O equivalent.
  73 オプションには長い形式と短い形式がある。並べて書いてある場合は、それら
  74 が等価なオプションであることを意味する。
  75
  76 .TP
  77 .B \-A
  78 .TP
  79 .B \-o
  80 .TP
  81 .B \-\-print\-file\-name
  82 .\"O Precede each symbol by the name of the input file where it was found,
  83 .\"O rather than identifying the input file once only before all of its
  84 .\"O symbols.
  85 それぞれのシンボルの前に、そのシンボルが含まれていた入力ファイルの名前
  86 を配置する。通常は入力ファイルは一度だけ表示し、その後にそのファイルに
  87 含まれているシンボルの一覧が続く。
  88
  89 .TP
  90 .B \-a
  91 .TP
  92 .B \-\-debug\-syms
  93 .\"O Display debugger-only symbols; normally these are not listed.
  94 デバッガ専用のシンボルも表示する。これらは通常はリストされない。
  95
  96 .TP
  97 .B \-B
  98 .\"O The same as
  99 .\"O .B \-\-format=bsd
 100 .\"O (for compatibility with the MIPS \fBnm\fP).
 101 .B \-\-format=bsd
 102 と同じ (MIPS の \fBnm\fP との互換性のために用意された)。
 103
 104 .TP
 105 .B \-C
 106 .TP
 107 .B \-\-demangle
 108 .\"O Decode (\fIdemangle\fP) low-level symbol names into user-level names.
 109 .\"O Besides removing any initial underscore prepended by the system, this
 110 .\"O makes C++ function names readable.
 111 低位レベルのシンボル名をユーザーレベルの名前にデコード
 112 (\fIdemangle\fP) する。システムによって追加された、先頭部のアンダース
 113 コアを全て削除するほか、 C++ の関数名を可読にする。
 114
 115 .TP
 116 .B \-D
 117 .TP
 118 .B \-\-dynamic
 119 .\"O Display the dynamic symbols rather than the normal symbols.  This is
 120 .\"O only meaningful for dynamic objects, such as certain types of shared
 121 .\"O libraries.
 122 通常のシンボルではなく動的 (dynamic) なシンボルを表示する。これはある
 123 種の共有ライブラリなど、動的なオブジェクトに対してのみ意味を持つ。
 124
 125 .TP
 126 .B "\-f \fIformat"
 127 .\"O Use the output format \fIformat\fP, which can be ``bsd'',
 128 .\"O ``sysv'', or ``posix''.  The default is ``bsd''.
 129 .\"O Only the first character of \fIformat\fP is significant; it can be
 130 .\"O either upper or lower case.
 131 出力フォーマットに \fIformat\fP を用いる。 \fIformat\fP には ``bsd''、
 132 ``sysv''、 ``posix'' のいずれかを指定する。デフォルトは ``bsd'' である。
 133 \fIformat\fP で認識されるのは最初の一文字だけである。大文字小文字は関
 134 係ない。
 135
 136 .TP
 137 .B \-g
 138 .TP
 139 .B \-\-extern\-only
 140 .\"O Display only external symbols.
 141 外部シンボル (external symbol) のみを表示する。
 142
 143 .TP
 144 .B \-n
 145 .TP
 146 .B \-v
 147 .TP
 148 .B \-\-numeric\-sort
 149 .\"O Sort symbols numerically by their addresses, not alphabetically by their
 150 .\"O names.
 151 シンボルをアドレスの数値によってソートする。通常は名前のアルファベット
 152 順にソートされる。
 153
 154 .TP
 155 .B \-p
 156 .TP
 157 .B \-\-no\-sort
 158 .\"O Don't bother to sort the symbols in any order; just print them in the
 159 .\"O order encountered.
 160 シンボルをまったくソートしない。単純に現われた順に表示する。
 161
 162 .TP
 163 .B \-P
 164 .TP
 165 .B \-\-portability
 166 .\"O Use the POSIX.2 standard output format instead of the default format.
 167 .\"O Equivalent to ``\-f posix''.
 168 出力フォーマットに、デフォルトのものではなく POSIX.2 標準のものを用い
 169 る。 ``-f posix'' と等価。
 170
 171 .TP
 172 .B \-s
 173 .TP
 174 .B \-\-print\-armap
 175 .\"O When listing symbols from archive members, include the index: a mapping
 176 .\"O (stored in the archive by \c
 177 .\"O .B ar\c
 178 .\"O \& or \c
 179 .\"O .B ranlib\c
 180 .\"O \&) of what modules
 181 .\"O contain definitions for what names.
 182 書庫のメンバーからシンボルをリストするとき、インデックスをインクルード
 183 する。インデックスとは
 184 .B ar
 185 または
 186 .B ranlib
 187 によって書庫に追加されるもので、その書庫にあるどのファイルにどんな名前
 188 定義が含まれているかをマップする。
 189
 190 .TP
 191 .B \-r
 192 .TP
 193 .B \-\-reverse\-sort
 194 .\"O Reverse the sense of the sort (whether numeric or alphabetic); let the
 195 .\"O last come first.
 196 ソート順を逆にする (数値の場合でもアルファベット順の場合でも)。最後の
 197 ものが最初に来ることになる。
 198
 199 .TP
 200 .B \-\-size\-sort
 201 .\"O Sort symbols by size.  The size is computed as the difference between
 202 .\"O the value of the symbol and the value of the symbol with the next higher
 203 .\"O value.  The size of the symbol is printed, rather than the value.
 204 シンボルをサイズの順にソートする。サイズはシンボルの値を、次に現われる
 205 シンボルの値から引いた物である。シンボルの値ではなく、サイズが表示される。
 206
 207 .TP
 208 .B "\-t \fIradix"
 209 .TP
 210 .B "\-\-radix=\fIradix"
 211 .\"O Use \fIradix\fP as the radix for printing the symbol values.  It must be
 212 .\"O ``d'' for decimal, ``o'' for octal, or ``x'' for hexadecimal.
 213 \fIradix\fP をシンボルの値を表示するときの基数にする。 10 進数の場合は
 214 ``d''、 8 進数には ``o''、 16 進数には ``x'' を指定する。
 215
 216 .TP
 217 .BI "\-\-target=" "bfdname"
 218 .\"O Specify an object code format other than your system's default format.
 219 .\"O See
 220 .\"O .BR objdump ( 1 ),
 221 .\"O for information on listing available formats.
 222 オブジェクトコードのフォーマットを指定する。通常はシステムのデフォルト
 223 であるフォーマットが用いられる。指定できるフォーマットに関する情報を得
 224 るための手法については
 225 .BR objdump ( 1 )
 226 を見よ。
 227
 228 .TP
 229 .B \-u
 230 .TP
 231 .B \-\-undefined\-only
 232 .\"O Display only undefined symbols (those external to each object file).
 233 未定義なシンボル (それぞれのオブジェクトファイルの外部にあるもの) のみ
 234 を表示する。
 235
 236 .TP
 237 .B \-l
 238 .TP
 239 .B \-\-line\-numbers
 240 .\"O For each symbol, use debugging information to try to find a filename and
 241 .\"O line number.  For a defined symbol, look for the line number of the
 242 .\"O address of the symbol.  For an undefined symbol, look for the line
 243 .\"O number of a relocation entry which refers to the symbol.  If line number
 244 .\"O information can be found, print it after the other symbol information.
 245 それぞれのシンボルに対して、デバッグ情報を用いてファイル名と行番号を見
 246 つけようとする。定義されているシンボルに対しては、シンボルのアドレスの
 247 行番号を探す。未定義なシンボルに対しては、シンボルを参照しているリロケー
 248 ションエントリの行番号を探す。行番号の情報を見つけることができたら、他
 249 のシンボルの情報に続いてそれを表示する。
 250
 251 .TP
 252 .B \-V
 253 .TP
 254 .B \-\-version
 255 .\"O Show the version number of
 256 .\"O .B nm
 257 .\"O and exit.
 258 .B nm
 259 のバージョン番号を表示して終了する。
 260
 261 .TP
 262 .B \-\-help
 263 .\"O Show a summary of the options to
 264 .\"O .B nm
 265 .\"O and exit.
 266 .B nm
 267 のオプション一覧を表示して終了する。
 268
 269 .\"O .SH "SEE ALSO"
 270 .SH 関連項目
 271 .\"O .RB "`\|" binutils "\|'"
 272 .\"O entry in
 273 .\"O .B
 274 .\"O info\c
 275 .\"O \&;
 276 .\"O .I
 277 .\"O The GNU Binary Utilities\c
 278 .\"O \&, Roland H. Pesch (October 1991);
 279 .\"O .BR ar "(" 1 "),"
 280 .\"O .BR objdump ( 1 ),
 281 .\"O .BR ranlib "(" 1 ")."
 282 .B info
 283 の `\fB binutils \fP' エントリ、
 284 .IR "The GNU Binary Utilities" ,
 285 Roland H. Pesch (October 1991)、
 286 .BR ar "(" 1 ")、"
 287 .BR objdump "(" 1 ")"
 288 .BR ranlib "(" 1 ")"
 289
 290 .\"O COPYING
 291 .SH 著作権
 292 .PP
 293 Permission is granted to make and distribute verbatim copies of
 294 this manual provided the copyright notice and this permission notice
 295 are preserved on all copies.
 296 .PP
 297 Permission is granted to copy and distribute modified versions of this
 298 manual under the conditions for verbatim copying, provided that the
 299 entire resulting derived work is distributed under the terms of a
 300 permission notice identical to this one.
 301 .PP
 302 Permission is granted to copy and distribute translations of this
 303 manual into another language, under the above conditions for modified
 304 versions, except that this permission notice may be included in
 305 translations approved by the Free Software Foundation instead of in
 306 the original English.