contrib/binutils-2.25/binutils/doc/nm.1

   1 .\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sp \" Vertical space (when we can't use .PP)
   6 .if t .sp .5v
   7 .if n .sp
   8 ..
   9 .de Vb \" Begin verbatim text
  10 .ft CW
  11 .nf
  12 .ne \\$1
  13 ..
  14 .de Ve \" End verbatim text
  15 .ft R
  16 .fi
  17 ..
  18 .\" Set up some character translations and predefined strings.  \*(-- will
  19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  23 .\" nothing in troff, for use with C<>.
  24 .tr \(*W-
  25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26 .ie n \{\
  27 .    ds -- \(*W-
  28 .    ds PI pi
  29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  31 .    ds L" ""
  32 .    ds R" ""
  33 .    ds C` ""
  34 .    ds C' ""
  35 'br\}
  36 .el\{\
  37 .    ds -- \|\(em\|
  38 .    ds PI \(*p
  39 .    ds L" ``
  40 .    ds R" ''
  41 .    ds C`
  42 .    ds C'
  43 'br\}
  44 .\"
  45 .\" Escape single quotes in literal strings from groff's Unicode transform.
  46 .ie \n(.g .ds Aq \(aq
  47 .el       .ds Aq '
  48 .\"
  49 .\" If the F register is turned on, we'll generate index entries on stderr for
  50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  52 .\" output yourself in some meaningful fashion.
  53 .\"
  54 .\" Avoid warning from groff about undefined register 'F'.
  55 .de IX
  56 ..
  57 .nr rF 0
  58 .if \n(.g .if rF .nr rF 1
  59 .if (\n(rF:(\n(.g==0)) \{
  60 .    if \nF \{
  61 .        de IX
  62 .        tm Index:\\$1\t\\n%\t"\\$2"
  63 ..
  64 .        if !\nF==2 \{
  65 .            nr % 0
  66 .            nr F 2
  67 .        \}
  68 .    \}
  69 .\}
  70 .rr rF
  71 .\"
  72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  73 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  74 .    \" fudge factors for nroff and troff
  75 .if n \{\
  76 .    ds #H 0
  77 .    ds #V .8m
  78 .    ds #F .3m
  79 .    ds #[ \f1
  80 .    ds #] \fP
  81 .\}
  82 .if t \{\
  83 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  84 .    ds #V .6m
  85 .    ds #F 0
  86 .    ds #[ \&
  87 .    ds #] \&
  88 .\}
  89 .    \" simple accents for nroff and troff
  90 .if n \{\
  91 .    ds ' \&
  92 .    ds ` \&
  93 .    ds ^ \&
  94 .    ds , \&
  95 .    ds ~ ~
  96 .    ds /
  97 .\}
  98 .if t \{\
  99 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 100 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 101 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 102 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 103 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 104 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 105 .\}
 106 .    \" troff and (daisy-wheel) nroff accents
 107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 114 .ds ae a\h'-(\w'a'u*4/10)'e
 115 .ds Ae A\h'-(\w'A'u*4/10)'E
 116 .    \" corrections for vroff
 117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 119 .    \" for low resolution devices (crt and lpr)
 120 .if \n(.H>23 .if \n(.V>19 \
 121 \{\
 122 .    ds : e
 123 .    ds 8 ss
 124 .    ds o a
 125 .    ds d- d\h'-1'\(ga
 126 .    ds D- D\h'-1'\(hy
 127 .    ds th \o'bp'
 128 .    ds Th \o'LP'
 129 .    ds ae ae
 130 .    ds Ae AE
 131 .\}
 132 .rm #[ #] #H #V #F C
 133 .\" ========================================================================
 134 .\"
 135 .IX Title "NM 1"
 136 .TH NM 1 "2014-12-23" "binutils-2.25" "GNU Development Tools"
 137 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 138 .\" way too many mistakes in technical documents.
 139 .if n .ad l
 140 .nh
 141 .SH "NAME"
 142 nm \- list symbols from object files
 143 .SH "SYNOPSIS"
 144 .IX Header "SYNOPSIS"
 145 nm [\fB\-A\fR|\fB\-o\fR|\fB\-\-print\-file\-name\fR] [\fB\-a\fR|\fB\-\-debug\-syms\fR]
 146    [\fB\-B\fR|\fB\-\-format=bsd\fR] [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR]]
 147    [\fB\-D\fR|\fB\-\-dynamic\fR] [\fB\-f\fR\fIformat\fR|\fB\-\-format=\fR\fIformat\fR]
 148    [\fB\-g\fR|\fB\-\-extern\-only\fR] [\fB\-h\fR|\fB\-\-help\fR]
 149    [\fB\-l\fR|\fB\-\-line\-numbers\fR] [\fB\-n\fR|\fB\-v\fR|\fB\-\-numeric\-sort\fR]
 150    [\fB\-P\fR|\fB\-\-portability\fR] [\fB\-p\fR|\fB\-\-no\-sort\fR]
 151    [\fB\-r\fR|\fB\-\-reverse\-sort\fR] [\fB\-S\fR|\fB\-\-print\-size\fR]
 152    [\fB\-s\fR|\fB\-\-print\-armap\fR] [\fB\-t\fR \fIradix\fR|\fB\-\-radix=\fR\fIradix\fR]
 153    [\fB\-u\fR|\fB\-\-undefined\-only\fR] [\fB\-V\fR|\fB\-\-version\fR]
 154    [\fB\-X 32_64\fR] [\fB\-\-defined\-only\fR] [\fB\-\-no\-demangle\fR]
 155    [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-size\-sort\fR] [\fB\-\-special\-syms\fR]
 156    [\fB\-\-synthetic\fR] [\fB\-\-target=\fR\fIbfdname\fR]
 157    [\fIobjfile\fR...]
 158 .SH "DESCRIPTION"
 159 .IX Header "DESCRIPTION"
 160 \&\s-1GNU \s0\fBnm\fR lists the symbols from object files \fIobjfile\fR....
 161 If no object files are listed as arguments, \fBnm\fR assumes the file
 162 \&\fIa.out\fR.
 163 .PP
 164 For each symbol, \fBnm\fR shows:
 165 .IP "\(bu" 4
 166 The symbol value, in the radix selected by options (see below), or
 167 hexadecimal by default.
 168 .IP "\(bu" 4
 169 The symbol type.  At least the following types are used; others are, as
 170 well, depending on the object file format.  If lowercase, the symbol is
 171 usually local; if uppercase, the symbol is global (external).  There
 172 are however a few lowercase symbols that are shown for special global
 173 symbols (\f(CW\*(C`u\*(C'\fR, \f(CW\*(C`v\*(C'\fR and \f(CW\*(C`w\*(C'\fR).
 174 .RS 4
 175 .ie n .IP """A""" 4
 176 .el .IP "\f(CWA\fR" 4
 177 .IX Item "A"
 178 The symbol's value is absolute, and will not be changed by further
 179 linking.
 180 .ie n .IP """B""" 4
 181 .el .IP "\f(CWB\fR" 4
 182 .IX Item "B"
 183 .PD 0
 184 .ie n .IP """b""" 4
 185 .el .IP "\f(CWb\fR" 4
 186 .IX Item "b"
 187 .PD
 188 The symbol is in the uninitialized data section (known as \s-1BSS\s0).
 189 .ie n .IP """C""" 4
 190 .el .IP "\f(CWC\fR" 4
 191 .IX Item "C"
 192 The symbol is common.  Common symbols are uninitialized data.  When
 193 linking, multiple common symbols may appear with the same name.  If the
 194 symbol is defined anywhere, the common symbols are treated as undefined
 195 references.
 196 .ie n .IP """D""" 4
 197 .el .IP "\f(CWD\fR" 4
 198 .IX Item "D"
 199 .PD 0
 200 .ie n .IP """d""" 4
 201 .el .IP "\f(CWd\fR" 4
 202 .IX Item "d"
 203 .PD
 204 The symbol is in the initialized data section.
 205 .ie n .IP """G""" 4
 206 .el .IP "\f(CWG\fR" 4
 207 .IX Item "G"
 208 .PD 0
 209 .ie n .IP """g""" 4
 210 .el .IP "\f(CWg\fR" 4
 211 .IX Item "g"
 212 .PD
 213 The symbol is in an initialized data section for small objects.  Some
 214 object file formats permit more efficient access to small data objects,
 215 such as a global int variable as opposed to a large global array.
 216 .ie n .IP """i""" 4
 217 .el .IP "\f(CWi\fR" 4
 218 .IX Item "i"
 219 For \s-1PE\s0 format files this indicates that the symbol is in a section
 220 specific to the implementation of DLLs.  For \s-1ELF\s0 format files this
 221 indicates that the symbol is an indirect function.  This is a \s-1GNU\s0
 222 extension to the standard set of \s-1ELF\s0 symbol types.  It indicates a
 223 symbol which if referenced by a relocation does not evaluate to its
 224 address, but instead must be invoked at runtime.  The runtime
 225 execution will then return the value to be used in the relocation.
 226 .ie n .IP """I""" 4
 227 .el .IP "\f(CWI\fR" 4
 228 .IX Item "I"
 229 The symbol is an indirect reference to another symbol.
 230 .ie n .IP """N""" 4
 231 .el .IP "\f(CWN\fR" 4
 232 .IX Item "N"
 233 The symbol is a debugging symbol.
 234 .ie n .IP """p""" 4
 235 .el .IP "\f(CWp\fR" 4
 236 .IX Item "p"
 237 The symbols is in a stack unwind section.
 238 .ie n .IP """R""" 4
 239 .el .IP "\f(CWR\fR" 4
 240 .IX Item "R"
 241 .PD 0
 242 .ie n .IP """r""" 4
 243 .el .IP "\f(CWr\fR" 4
 244 .IX Item "r"
 245 .PD
 246 The symbol is in a read only data section.
 247 .ie n .IP """S""" 4
 248 .el .IP "\f(CWS\fR" 4
 249 .IX Item "S"
 250 .PD 0
 251 .ie n .IP """s""" 4
 252 .el .IP "\f(CWs\fR" 4
 253 .IX Item "s"
 254 .PD
 255 The symbol is in an uninitialized data section for small objects.
 256 .ie n .IP """T""" 4
 257 .el .IP "\f(CWT\fR" 4
 258 .IX Item "T"
 259 .PD 0
 260 .ie n .IP """t""" 4
 261 .el .IP "\f(CWt\fR" 4
 262 .IX Item "t"
 263 .PD
 264 The symbol is in the text (code) section.
 265 .ie n .IP """U""" 4
 266 .el .IP "\f(CWU\fR" 4
 267 .IX Item "U"
 268 The symbol is undefined.
 269 .ie n .IP """u""" 4
 270 .el .IP "\f(CWu\fR" 4
 271 .IX Item "u"
 272 The symbol is a unique global symbol.  This is a \s-1GNU\s0 extension to the
 273 standard set of \s-1ELF\s0 symbol bindings.  For such a symbol the dynamic linker
 274 will make sure that in the entire process there is just one symbol with
 275 this name and type in use.
 276 .ie n .IP """V""" 4
 277 .el .IP "\f(CWV\fR" 4
 278 .IX Item "V"
 279 .PD 0
 280 .ie n .IP """v""" 4
 281 .el .IP "\f(CWv\fR" 4
 282 .IX Item "v"
 283 .PD
 284 The symbol is a weak object.  When a weak defined symbol is linked with
 285 a normal defined symbol, the normal defined symbol is used with no error.
 286 When a weak undefined symbol is linked and the symbol is not defined,
 287 the value of the weak symbol becomes zero with no error.  On some
 288 systems, uppercase indicates that a default value has been specified.
 289 .ie n .IP """W""" 4
 290 .el .IP "\f(CWW\fR" 4
 291 .IX Item "W"
 292 .PD 0
 293 .ie n .IP """w""" 4
 294 .el .IP "\f(CWw\fR" 4
 295 .IX Item "w"
 296 .PD
 297 The symbol is a weak symbol that has not been specifically tagged as a
 298 weak object symbol.  When a weak defined symbol is linked with a normal
 299 defined symbol, the normal defined symbol is used with no error.
 300 When a weak undefined symbol is linked and the symbol is not defined,
 301 the value of the symbol is determined in a system-specific manner without
 302 error.  On some systems, uppercase indicates that a default value has been
 303 specified.
 304 .ie n .IP """\-""" 4
 305 .el .IP "\f(CW\-\fR" 4
 306 .IX Item "-"
 307 The symbol is a stabs symbol in an a.out object file.  In this case, the
 308 next values printed are the stabs other field, the stabs desc field, and
 309 the stab type.  Stabs symbols are used to hold debugging information.
 310 .ie n .IP """?""" 4
 311 .el .IP "\f(CW?\fR" 4
 312 .IX Item "?"
 313 The symbol type is unknown, or object file format specific.
 314 .RE
 315 .RS 4
 316 .RE
 317 .IP "\(bu" 4
 318 The symbol name.
 319 .SH "OPTIONS"
 320 .IX Header "OPTIONS"
 321 The long and short forms of options, shown here as alternatives, are
 322 equivalent.
 323 .IP "\fB\-A\fR" 4
 324 .IX Item "-A"
 325 .PD 0
 326 .IP "\fB\-o\fR" 4
 327 .IX Item "-o"
 328 .IP "\fB\-\-print\-file\-name\fR" 4
 329 .IX Item "--print-file-name"
 330 .PD
 331 Precede each symbol by the name of the input file (or archive member)
 332 in which it was found, rather than identifying the input file once only,
 333 before all of its symbols.
 334 .IP "\fB\-a\fR" 4
 335 .IX Item "-a"
 336 .PD 0
 337 .IP "\fB\-\-debug\-syms\fR" 4
 338 .IX Item "--debug-syms"
 339 .PD
 340 Display all symbols, even debugger-only symbols; normally these are not
 341 listed.
 342 .IP "\fB\-B\fR" 4
 343 .IX Item "-B"
 344 The same as \fB\-\-format=bsd\fR (for compatibility with the \s-1MIPS \s0\fBnm\fR).
 345 .IP "\fB\-C\fR" 4
 346 .IX Item "-C"
 347 .PD 0
 348 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
 349 .IX Item "--demangle[=style]"
 350 .PD
 351 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
 352 Besides removing any initial underscore prepended by the system, this
 353 makes \*(C+ function names readable. Different compilers have different
 354 mangling styles. The optional demangling style argument can be used to
 355 choose an appropriate demangling style for your compiler.
 356 .IP "\fB\-\-no\-demangle\fR" 4
 357 .IX Item "--no-demangle"
 358 Do not demangle low-level symbol names.  This is the default.
 359 .IP "\fB\-D\fR" 4
 360 .IX Item "-D"
 361 .PD 0
 362 .IP "\fB\-\-dynamic\fR" 4
 363 .IX Item "--dynamic"
 364 .PD
 365 Display the dynamic symbols rather than the normal symbols.  This is
 366 only meaningful for dynamic objects, such as certain types of shared
 367 libraries.
 368 .IP "\fB\-f\fR \fIformat\fR" 4
 369 .IX Item "-f format"
 370 .PD 0
 371 .IP "\fB\-\-format=\fR\fIformat\fR" 4
 372 .IX Item "--format=format"
 373 .PD
 374 Use the output format \fIformat\fR, which can be \f(CW\*(C`bsd\*(C'\fR,
 375 \&\f(CW\*(C`sysv\*(C'\fR, or \f(CW\*(C`posix\*(C'\fR.  The default is \f(CW\*(C`bsd\*(C'\fR.
 376 Only the first character of \fIformat\fR is significant; it can be
 377 either upper or lower case.
 378 .IP "\fB\-g\fR" 4
 379 .IX Item "-g"
 380 .PD 0
 381 .IP "\fB\-\-extern\-only\fR" 4
 382 .IX Item "--extern-only"
 383 .PD
 384 Display only external symbols.
 385 .IP "\fB\-h\fR" 4
 386 .IX Item "-h"
 387 .PD 0
 388 .IP "\fB\-\-help\fR" 4
 389 .IX Item "--help"
 390 .PD
 391 Show a summary of the options to \fBnm\fR and exit.
 392 .IP "\fB\-l\fR" 4
 393 .IX Item "-l"
 394 .PD 0
 395 .IP "\fB\-\-line\-numbers\fR" 4
 396 .IX Item "--line-numbers"
 397 .PD
 398 For each symbol, use debugging information to try to find a filename and
 399 line number.  For a defined symbol, look for the line number of the
 400 address of the symbol.  For an undefined symbol, look for the line
 401 number of a relocation entry which refers to the symbol.  If line number
 402 information can be found, print it after the other symbol information.
 403 .IP "\fB\-n\fR" 4
 404 .IX Item "-n"
 405 .PD 0
 406 .IP "\fB\-v\fR" 4
 407 .IX Item "-v"
 408 .IP "\fB\-\-numeric\-sort\fR" 4
 409 .IX Item "--numeric-sort"
 410 .PD
 411 Sort symbols numerically by their addresses, rather than alphabetically
 412 by their names.
 413 .IP "\fB\-p\fR" 4
 414 .IX Item "-p"
 415 .PD 0
 416 .IP "\fB\-\-no\-sort\fR" 4
 417 .IX Item "--no-sort"
 418 .PD
 419 Do not bother to sort the symbols in any order; print them in the order
 420 encountered.
 421 .IP "\fB\-P\fR" 4
 422 .IX Item "-P"
 423 .PD 0
 424 .IP "\fB\-\-portability\fR" 4
 425 .IX Item "--portability"
 426 .PD
 427 Use the \s-1POSIX.2\s0 standard output format instead of the default format.
 428 Equivalent to \fB\-f posix\fR.
 429 .IP "\fB\-r\fR" 4
 430 .IX Item "-r"
 431 .PD 0
 432 .IP "\fB\-\-reverse\-sort\fR" 4
 433 .IX Item "--reverse-sort"
 434 .PD
 435 Reverse the order of the sort (whether numeric or alphabetic); let the
 436 last come first.
 437 .IP "\fB\-S\fR" 4
 438 .IX Item "-S"
 439 .PD 0
 440 .IP "\fB\-\-print\-size\fR" 4
 441 .IX Item "--print-size"
 442 .PD
 443 Print both value and size of defined symbols for the \f(CW\*(C`bsd\*(C'\fR output style.
 444 This option has no effect for object formats that do not record symbol
 445 sizes, unless \fB\-\-size\-sort\fR is also used in which case a
 446 calculated size is displayed.
 447 .IP "\fB\-s\fR" 4
 448 .IX Item "-s"
 449 .PD 0
 450 .IP "\fB\-\-print\-armap\fR" 4
 451 .IX Item "--print-armap"
 452 .PD
 453 When listing symbols from archive members, include the index: a mapping
 454 (stored in the archive by \fBar\fR or \fBranlib\fR) of which modules
 455 contain definitions for which names.
 456 .IP "\fB\-t\fR \fIradix\fR" 4
 457 .IX Item "-t radix"
 458 .PD 0
 459 .IP "\fB\-\-radix=\fR\fIradix\fR" 4
 460 .IX Item "--radix=radix"
 461 .PD
 462 Use \fIradix\fR as the radix for printing the symbol values.  It must be
 463 \&\fBd\fR for decimal, \fBo\fR for octal, or \fBx\fR for hexadecimal.
 464 .IP "\fB\-u\fR" 4
 465 .IX Item "-u"
 466 .PD 0
 467 .IP "\fB\-\-undefined\-only\fR" 4
 468 .IX Item "--undefined-only"
 469 .PD
 470 Display only undefined symbols (those external to each object file).
 471 .IP "\fB\-V\fR" 4
 472 .IX Item "-V"
 473 .PD 0
 474 .IP "\fB\-\-version\fR" 4
 475 .IX Item "--version"
 476 .PD
 477 Show the version number of \fBnm\fR and exit.
 478 .IP "\fB\-X\fR" 4
 479 .IX Item "-X"
 480 This option is ignored for compatibility with the \s-1AIX\s0 version of
 481 \&\fBnm\fR.  It takes one parameter which must be the string
 482 \&\fB32_64\fR.  The default mode of \s-1AIX \s0\fBnm\fR corresponds
 483 to \fB\-X 32\fR, which is not supported by \s-1GNU \s0\fBnm\fR.
 484 .IP "\fB\-\-defined\-only\fR" 4
 485 .IX Item "--defined-only"
 486 Display only defined symbols for each object file.
 487 .IP "\fB\-\-plugin\fR \fIname\fR" 4
 488 .IX Item "--plugin name"
 489 Load the plugin called \fIname\fR to add support for extra target
 490 types.  This option is only available if the toolchain has been built
 491 with plugin support enabled.
 492 .IP "\fB\-\-size\-sort\fR" 4
 493 .IX Item "--size-sort"
 494 Sort symbols by size.  The size is computed as the difference between
 495 the value of the symbol and the value of the symbol with the next higher
 496 value.  If the \f(CW\*(C`bsd\*(C'\fR output format is used the size of the symbol
 497 is printed, rather than the value, and \fB\-S\fR must be used in order
 498 both size and value to be printed.
 499 .IP "\fB\-\-special\-syms\fR" 4
 500 .IX Item "--special-syms"
 501 Display symbols which have a target-specific special meaning.  These
 502 symbols are usually used by the target for some special processing and
 503 are not normally helpful when included in the normal symbol lists.
 504 For example for \s-1ARM\s0 targets this option would skip the mapping symbols
 505 used to mark transitions between \s-1ARM\s0 code, \s-1THUMB\s0 code and data.
 506 .IP "\fB\-\-synthetic\fR" 4
 507 .IX Item "--synthetic"
 508 Include synthetic symbols in the output.  These are special symbols
 509 created by the linker for various purposes.  They are not shown by
 510 default since they are not part of the binary's original source code.
 511 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
 512 .IX Item "--target=bfdname"
 513 Specify an object code format other than your system's default format.
 514 .IP "\fB@\fR\fIfile\fR" 4
 515 .IX Item "@file"
 516 Read command-line options from \fIfile\fR.  The options read are
 517 inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
 518 does not exist, or cannot be read, then the option will be treated
 519 literally, and not removed.
 520 .Sp
 521 Options in \fIfile\fR are separated by whitespace.  A whitespace
 522 character may be included in an option by surrounding the entire
 523 option in either single or double quotes.  Any character (including a
 524 backslash) may be included by prefixing the character to be included
 525 with a backslash.  The \fIfile\fR may itself contain additional
 526 @\fIfile\fR options; any such options will be processed recursively.
 527 .SH "SEE ALSO"
 528 .IX Header "SEE ALSO"
 529 \&\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
 530 .SH "COPYRIGHT"
 531 .IX Header "COPYRIGHT"
 532 Copyright (c) 1991\-2014 Free Software Foundation, Inc.
 533 .PP
 534 Permission is granted to copy, distribute and/or modify this document
 535 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
 536 or any later version published by the Free Software Foundation;
 537 with no Invariant Sections, with no Front-Cover Texts, and with no
 538 Back-Cover Texts.  A copy of the license is included in the
 539 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".