Debian Codegraph @

upstream/mageia-cauldron/man1/nm.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "NM 1"
61 .TH NM 1 2025-12-22 binutils-2.45.1 "GNU Development Tools"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 nm \- list symbols from object files
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 nm [\fB\-A\fR|\fB\-o\fR|\fB\-\-print\-file\-name\fR]
71 [\fB\-a\fR|\fB\-\-debug\-syms\fR]
72 [\fB\-B\fR|\fB\-\-format=bsd\fR]
73 [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR]]
74 [\fB\-D\fR|\fB\-\-dynamic\fR]
75 [\fB\-f\fR\fIformat\fR|\fB\-\-format=\fR\fIformat\fR]
76 [\fB\-g\fR|\fB\-\-extern\-only\fR]
77 [\fB\-h\fR|\fB\-\-help\fR]
78 [\fB\-\-ifunc\-chars=\fR\fICHARS\fR]
79 [\fB\-j\fR|\fB\-\-format=just\-symbols\fR]
80 [\fB\-l\fR|\fB\-\-line\-numbers\fR] [\fB\-\-inlines\fR]
81 [\fB\-n\fR|\fB\-v\fR|\fB\-\-numeric\-sort\fR]
82 [\fB\-P\fR|\fB\-\-portability\fR]
83 [\fB\-p\fR|\fB\-\-no\-sort\fR]
84 [\fB\-r\fR|\fB\-\-reverse\-sort\fR]
85 [\fB\-S\fR|\fB\-\-print\-size\fR]
86 [\fB\-s\fR|\fB\-\-print\-armap\fR]
87 [\fB\-t\fR \fIradix\fR|\fB\-\-radix=\fR\fIradix\fR]
88 [\fB\-u\fR|\fB\-\-undefined\-only\fR]
89 [\fB\-U\fR|\fB\-\-defined\-only\fR]
90 [\fB\-V\fR|\fB\-\-version\fR]
91 [\fB\-W\fR|\fB\-\-no\-weak\fR]
92 [\fB\-X 32_64\fR]
93 [\fB\-\-no\-demangle\fR]
94 [\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]]
95 [\fB\-\-plugin\fR \fIname\fR]
96 [\fB\-\-size\-sort\fR]
97 [\fB\-\-special\-syms\fR]
98 [\fB\-\-synthetic\fR]
99 [\fB\-\-target=\fR\fIbfdname\fR]
100 [\fB\-\-unicode=\fR\fImethod\fR]
101 [\fB\-\-with\-symbol\-versions\fR]
102 [\fB\-\-without\-symbol\-versions\fR]
103 [\fIobjfile\fR...]
104 .SH DESCRIPTION
105 .IX Header "DESCRIPTION"
106 GNU \fBnm\fR lists the symbols from object files \fIobjfile\fR....
107 If no object files are listed as arguments, \fBnm\fR assumes the file
108 \&\fIa.out\fR.
109 .PP
110 For each symbol, \fBnm\fR shows:
111 .IP \(bu 4
112 The symbol value, in the radix selected by options (see below), or
113 hexadecimal by default.
114 .IP \(bu 4
115 The symbol type. At least the following types are used; others are, as
116 well, depending on the object file format. If lowercase, the symbol is
117 usually local; if uppercase, the symbol is global (external). There
118 are however a few lowercase symbols that are shown for special global
119 symbols (\f(CW\*(C`u\*(C'\fR, \f(CW\*(C`v\*(C'\fR and \f(CW\*(C`w\*(C'\fR).
120 .RS 4
121 .ie n .IP """A""" 4
122 .el .IP \f(CWA\fR 4
123 .IX Item "A"
124 The symbol\*(Aqs value is absolute, and will not be changed by further
125 linking.
126 .ie n .IP """B""" 4
127 .el .IP \f(CWB\fR 4
128 .IX Item "B"
129 .PD 0
130 .ie n .IP """b""" 4
131 .el .IP \f(CWb\fR 4
132 .IX Item "b"
133 .PD
134 The symbol is in the BSS data section. This section typically
135 contains zero\-initialized or uninitialized data, although the exact
136 behavior is system dependent.
137 .ie n .IP """C""" 4
138 .el .IP \f(CWC\fR 4
139 .IX Item "C"
140 .PD 0
141 .ie n .IP """c""" 4
142 .el .IP \f(CWc\fR 4
143 .IX Item "c"
144 .PD
145 The symbol is common. Common symbols are uninitialized data. When
146 linking, multiple common symbols may appear with the same name. If the
147 symbol is defined anywhere, the common symbols are treated as undefined
148 references.
149 The lower case \fIc\fR character is used when the symbol is in a
150 special section for small commons.
151 .ie n .IP """D""" 4
152 .el .IP \f(CWD\fR 4
153 .IX Item "D"
154 .PD 0
155 .ie n .IP """d""" 4
156 .el .IP \f(CWd\fR 4
157 .IX Item "d"
158 .PD
159 The symbol is in the initialized data section.
160 .ie n .IP """G""" 4
161 .el .IP \f(CWG\fR 4
162 .IX Item "G"
163 .PD 0
164 .ie n .IP """g""" 4
165 .el .IP \f(CWg\fR 4
166 .IX Item "g"
167 .PD
168 The symbol is in an initialized data section for small objects. Some
169 object file formats permit more efficient access to small data objects,
170 such as a global int variable as opposed to a large global array.
171 .ie n .IP """i""" 4
172 .el .IP \f(CWi\fR 4
173 .IX Item "i"
174 For PE format files this indicates that the symbol is in a section
175 specific to the implementation of DLLs.
176 .Sp
177 For ELF format files this indicates that the symbol is an indirect
178 function. This is a GNU extension to the standard set of ELF symbol
179 types. It indicates a symbol which if referenced by a relocation does
180 not evaluate to its address, but instead must be invoked at runtime.
181 The runtime execution will then return the value to be used in the
182 relocation.
183 .Sp
184 Note \- the actual symbols display for GNU indirect symbols is
185 controlled by the \fB\-\-ifunc\-chars\fR command line option. If this
186 option has been provided then the first character in the string will
187 be used for global indirect function symbols. If the string contains
188 a second character then that will be used for local indirect function
189 symbols.
190 .ie n .IP """I""" 4
191 .el .IP \f(CWI\fR 4
192 .IX Item "I"
193 The symbol is an indirect reference to another symbol.
194 .ie n .IP """N""" 4
195 .el .IP \f(CWN\fR 4
196 .IX Item "N"
197 The symbol is a debugging symbol.
198 .ie n .IP """n""" 4
199 .el .IP \f(CWn\fR 4
200 .IX Item "n"
201 The symbol is in a non\-data, non\-code, non\-debug read\-only section.
202 .ie n .IP """p""" 4
203 .el .IP \f(CWp\fR 4
204 .IX Item "p"
205 The symbol is in a stack unwind section.
206 .ie n .IP """R""" 4
207 .el .IP \f(CWR\fR 4
208 .IX Item "R"
209 .PD 0
210 .ie n .IP """r""" 4
211 .el .IP \f(CWr\fR 4
212 .IX Item "r"
213 .PD
214 The symbol is in a read only data section.
215 .ie n .IP """S""" 4
216 .el .IP \f(CWS\fR 4
217 .IX Item "S"
218 .PD 0
219 .ie n .IP """s""" 4
220 .el .IP \f(CWs\fR 4
221 .IX Item "s"
222 .PD
223 The symbol is in an uninitialized or zero\-initialized data section
224 for small objects.
225 .ie n .IP """T""" 4
226 .el .IP \f(CWT\fR 4
227 .IX Item "T"
228 .PD 0
229 .ie n .IP """t""" 4
230 .el .IP \f(CWt\fR 4
231 .IX Item "t"
232 .PD
233 The symbol is in the text (code) section.
234 .ie n .IP """U""" 4
235 .el .IP \f(CWU\fR 4
236 .IX Item "U"
237 The symbol is undefined.
238 .ie n .IP """u""" 4
239 .el .IP \f(CWu\fR 4
240 .IX Item "u"
241 The symbol is a unique global symbol. This is a GNU extension to the
242 standard set of ELF symbol bindings. For such a symbol the dynamic linker
243 will make sure that in the entire process there is just one symbol with
244 this name and type in use.
245 .ie n .IP """V""" 4
246 .el .IP \f(CWV\fR 4
247 .IX Item "V"
248 .PD 0
249 .ie n .IP """v""" 4
250 .el .IP \f(CWv\fR 4
251 .IX Item "v"
252 .PD
253 The symbol is a weak object. When a weak defined symbol is linked with
254 a normal defined symbol, the normal defined symbol is used with no error.
255 When a weak undefined symbol is linked and the symbol is not defined,
256 the value of the weak symbol becomes zero with no error. On some
257 systems, uppercase indicates that a default value has been specified.
258 .ie n .IP """W""" 4
259 .el .IP \f(CWW\fR 4
260 .IX Item "W"
261 .PD 0
262 .ie n .IP """w""" 4
263 .el .IP \f(CWw\fR 4
264 .IX Item "w"
265 .PD
266 The symbol is a weak symbol that has not been specifically tagged as a
267 weak object symbol. When a weak defined symbol is linked with a normal
268 defined symbol, the normal defined symbol is used with no error.
269 When a weak undefined symbol is linked and the symbol is not defined,
270 the value of the symbol is determined in a system\-specific manner without
271 error. On some systems, uppercase indicates that a default value has been
272 specified.
273 .ie n .IP """\-""" 4
274 .el .IP \f(CW\-\fR 4
275 .IX Item "-"
276 The symbol is a stabs symbol in an a.out object file. In this case, the
277 next values printed are the stabs other field, the stabs desc field, and
278 the stab type. Stabs symbols are used to hold debugging information.
279 .ie n .IP """?""" 4
280 .el .IP \f(CW?\fR 4
281 .IX Item "?"
282 The symbol type is unknown, or object file format specific.
283 .RE
284 .RS 4
285 .RE
286 .IP \(bu 4
287 The symbol name. If a symbol has version information associated with it,
288 then the version information is displayed as well. If the versioned
289 symbol is undefined or hidden from linker, the version string is displayed
290 as a suffix to the symbol name, preceded by an @ character. For example
291 \&\fBfoo@VER_1\fR. If the version is the default version to be used when
292 resolving unversioned references to the symbol, then it is displayed as a
293 suffix preceded by two @ characters. For example \fBfoo@@VER_2\fR.
294 .SH OPTIONS
295 .IX Header "OPTIONS"
296 The long and short forms of options, shown here as alternatives, are
297 equivalent.
298 .IP \fB\-A\fR 4
299 .IX Item "-A"
300 .PD 0
301 .IP \fB\-o\fR 4
302 .IX Item "-o"
303 .IP \fB\-\-print\-file\-name\fR 4
304 .IX Item "--print-file-name"
305 .PD
306 Precede each symbol by the name of the input file (or archive member)
307 in which it was found, rather than identifying the input file once only,
308 before all of its symbols.
309 .IP \fB\-a\fR 4
310 .IX Item "-a"
311 .PD 0
312 .IP \fB\-\-debug\-syms\fR 4
313 .IX Item "--debug-syms"
314 .PD
315 Display all symbols, even debugger\-only symbols; normally these are not
316 listed.
317 .IP \fB\-B\fR 4
318 .IX Item "-B"
319 The same as \fB\-\-format=bsd\fR (for compatibility with the MIPS \fBnm\fR).
320 .IP \fB\-C\fR 4
321 .IX Item "-C"
322 .PD 0
323 .IP \fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR 4
324 .IX Item "--demangle[=style]"
325 .PD
326 Decode (\fIdemangle\fR) low\-level symbol names into user\-level names.
327 Besides removing any initial underscore prepended by the system, this
328 makes C++ function names readable. Different compilers have different
329 mangling styles. The optional demangling style argument can be used to
330 choose an appropriate demangling style for your compiler.
331 .IP \fB\-\-no\-demangle\fR 4
332 .IX Item "--no-demangle"
333 Do not demangle low\-level symbol names. This is the default.
334 .IP \fB\-\-recurse\-limit\fR 4
335 .IX Item "--recurse-limit"
336 .PD 0
337 .IP \fB\-\-no\-recurse\-limit\fR 4
338 .IX Item "--no-recurse-limit"
339 .IP \fB\-\-recursion\-limit\fR 4
340 .IX Item "--recursion-limit"
341 .IP \fB\-\-no\-recursion\-limit\fR 4
342 .IX Item "--no-recursion-limit"
343 .PD
344 Enables or disables a limit on the amount of recursion performed
345 whilst demangling strings. Since the name mangling formats allow for
346 an infinite level of recursion it is possible to create strings whose
347 decoding will exhaust the amount of stack space available on the host
348 machine, triggering a memory fault. The limit tries to prevent this
349 from happening by restricting recursion to 2048 levels of nesting.
350 .Sp
351 The default is for this limit to be enabled, but disabling it may be
352 necessary in order to demangle truly complicated names. Note however
353 that if the recursion limit is disabled then stack exhaustion is
354 possible and any bug reports about such an event will be rejected.
355 .IP \fB\-D\fR 4
356 .IX Item "-D"
357 .PD 0
358 .IP \fB\-\-dynamic\fR 4
359 .IX Item "--dynamic"
360 .PD
361 Display the dynamic symbols rather than the normal symbols. This is
362 only meaningful for dynamic objects, such as certain types of shared
363 libraries.
364 .IP "\fB\-f\fR \fIformat\fR" 4
365 .IX Item "-f format"
366 .PD 0
367 .IP \fB\-\-format=\fR\fIformat\fR 4
368 .IX Item "--format=format"
369 .PD
370 Use the output format \fIformat\fR, which can be \f(CW\*(C`bsd\*(C'\fR,
371 \&\f(CW\*(C`sysv\*(C'\fR, \f(CW\*(C`posix\*(C'\fR or \f(CW\*(C`just\-symbols\*(C'\fR. The default is \f(CW\*(C`bsd\*(C'\fR.
372 Only the first character of \fIformat\fR is significant; it can be
373 either upper or lower case.
374 .IP \fB\-g\fR 4
375 .IX Item "-g"
376 .PD 0
377 .IP \fB\-\-extern\-only\fR 4
378 .IX Item "--extern-only"
379 .PD
380 Display only external symbols.
381 .IP \fB\-h\fR 4
382 .IX Item "-h"
383 .PD 0
384 .IP \fB\-\-help\fR 4
385 .IX Item "--help"
386 .PD
387 Show a summary of the options to \fBnm\fR and exit.
388 .IP \fB\-\-ifunc\-chars=\fR\fICHARS\fR 4
389 .IX Item "--ifunc-chars=CHARS"
390 When display GNU indirect function symbols \fBnm\fR will default
391 to using the \f(CW\*(C`i\*(C'\fR character for both local indirect functions and
392 global indirect functions. The \fB\-\-ifunc\-chars\fR option allows
393 the user to specify a string containing one or two characters. The
394 first character will be used for global indirect function symbols and
395 the second character, if present, will be used for local indirect
396 function symbols.
397 .IP \fBj\fR 4
398 .IX Item "j"
399 The same as \fB\-\-format=just\-symbols\fR.
400 .IP \fB\-l\fR 4
401 .IX Item "-l"
402 .PD 0
403 .IP \fB\-\-line\-numbers\fR 4
404 .IX Item "--line-numbers"
405 .PD
406 For each symbol, use debugging information to try to find a filename and
407 line number. For a defined symbol, look for the line number of the
408 address of the symbol. For an undefined symbol, look for the line
409 number of a relocation entry which refers to the symbol. If line number
410 information can be found, print it after the other symbol information.
411 .IP \fB\-\-inlines\fR 4
412 .IX Item "--inlines"
413 When option \fB\-l\fR is active, if the address belongs to a
414 function that was inlined, then this option causes the source
415 information for all enclosing scopes back to the first non\-inlined
416 function to be printed as well. For example, if \f(CW\*(C`main\*(C'\fR inlines
417 \&\f(CW\*(C`callee1\*(C'\fR which inlines \f(CW\*(C`callee2\*(C'\fR, and address is from
418 \&\f(CW\*(C`callee2\*(C'\fR, the source information for \f(CW\*(C`callee1\*(C'\fR and \f(CW\*(C`main\*(C'\fR
419 will also be printed.
420 .IP \fB\-n\fR 4
421 .IX Item "-n"
422 .PD 0
423 .IP \fB\-v\fR 4
424 .IX Item "-v"
425 .IP \fB\-\-numeric\-sort\fR 4
426 .IX Item "--numeric-sort"
427 .PD
428 Sort symbols numerically by their addresses, rather than alphabetically
429 by their names.
430 .IP \fB\-p\fR 4
431 .IX Item "-p"
432 .PD 0
433 .IP \fB\-\-no\-sort\fR 4
434 .IX Item "--no-sort"
435 .PD
436 Do not bother to sort the symbols in any order; print them in the order
437 encountered.
438 .IP \fB\-P\fR 4
439 .IX Item "-P"
440 .PD 0
441 .IP \fB\-\-portability\fR 4
442 .IX Item "--portability"
443 .PD
444 Use the POSIX.2 standard output format instead of the default format.
445 Equivalent to \fB\-f posix\fR.
446 .IP \fB\-r\fR 4
447 .IX Item "-r"
448 .PD 0
449 .IP \fB\-\-reverse\-sort\fR 4
450 .IX Item "--reverse-sort"
451 .PD
452 Reverse the order of the sort (whether numeric or alphabetic); let the
453 last come first.
454 .IP \fB\-S\fR 4
455 .IX Item "-S"
456 .PD 0
457 .IP \fB\-\-print\-size\fR 4
458 .IX Item "--print-size"
459 .PD
460 Print both value and size of defined symbols for the \f(CW\*(C`bsd\*(C'\fR output style.
461 This option has no effect for object formats that do not record symbol
462 sizes, unless \fB\-\-size\-sort\fR is also used in which case a
463 calculated size is displayed.
464 .IP \fB\-s\fR 4
465 .IX Item "-s"
466 .PD 0
467 .IP \fB\-\-print\-armap\fR 4
468 .IX Item "--print-armap"
469 .PD
470 When listing symbols from archive members, include the index: a mapping
471 (stored in the archive by \fBar\fR or \fBranlib\fR) of which modules
472 contain definitions for which names.
473 .IP "\fB\-t\fR \fIradix\fR" 4
474 .IX Item "-t radix"
475 .PD 0
476 .IP \fB\-\-radix=\fR\fIradix\fR 4
477 .IX Item "--radix=radix"
478 .PD
479 Use \fIradix\fR as the radix for printing the symbol values. It must be
480 \&\fBd\fR for decimal, \fBo\fR for octal, or \fBx\fR for hexadecimal.
481 .IP \fB\-u\fR 4
482 .IX Item "-u"
483 .PD 0
484 .IP \fB\-\-undefined\-only\fR 4
485 .IX Item "--undefined-only"
486 .PD
487 Display only undefined symbols (those external to each object file).
488 By default both defined and undefined symbols are displayed.
489 .IP \fB\-U\fR 4
490 .IX Item "-U"
491 .PD 0
492 .IP \fB\-\-defined\-only\fR 4
493 .IX Item "--defined-only"
494 .PD
495 Display only defined symbols for each object file.
496 By default both defined and undefined symbols are displayed.
497 .IP \fB\-V\fR 4
498 .IX Item "-V"
499 .PD 0
500 .IP \fB\-\-version\fR 4
501 .IX Item "--version"
502 .PD
503 Show the version number of \fBnm\fR and exit.
504 .IP \fB\-X\fR 4
505 .IX Item "-X"
506 This option is ignored for compatibility with the AIX version of
507 \&\fBnm\fR. It takes one parameter which must be the string
508 \&\fB32_64\fR. The default mode of AIX \fBnm\fR corresponds
509 to \fB\-X 32\fR, which is not supported by GNU \fBnm\fR.
510 .IP "\fB\-\-plugin\fR \fIname\fR" 4
511 .IX Item "--plugin name"
512 Load the plugin called \fIname\fR to add support for extra target
513 types. This option is only available if the toolchain has been built
514 with plugin support enabled.
515 .Sp
516 If \fB\-\-plugin\fR is not provided, but plugin support has been
517 enabled then \fBnm\fR iterates over the files in
518 \&\fI${libdir}/bfd\-plugins\fR in alphabetic order and the first
519 plugin that claims the object in question is used.
520 .Sp
521 Please note that this plugin search directory is \fInot\fR the one
522 used by \fBld\fR\*(Aqs \fB\-plugin\fR option. In order to make
523 \&\fBnm\fR use the linker plugin it must be copied into the
524 \&\fI${libdir}/bfd\-plugins\fR directory. For GCC based compilations
525 the linker plugin is called \fIliblto_plugin.so.0.0.0\fR. For Clang
526 based compilations it is called \fILLVMgold.so\fR. The GCC plugin
527 is always backwards compatible with earlier versions, so it is
528 sufficient to just copy the newest one.
529 .IP \fB\-\-size\-sort\fR 4
530 .IX Item "--size-sort"
531 Sort symbols by size. For ELF objects symbol sizes are read from the
532 ELF, for other object types the symbol sizes are computed as the
533 difference between the value of the symbol and the value of the symbol
534 with the next higher value. If the \f(CW\*(C`bsd\*(C'\fR output format is used
535 the size of the symbol is printed, rather than the value, and
536 \&\fB\-S\fR must be used in order both size and value to be printed.
537 .Sp
538 Note \- this option does not work if \fB\-\-undefined\-only\fR has been
539 enabled as undefined symbols have no size.
540 .IP \fB\-\-special\-syms\fR 4
541 .IX Item "--special-syms"
542 Display symbols which have a target\-specific special meaning. These
543 symbols are usually used by the target for some special processing and
544 are not normally helpful when included in the normal symbol lists.
545 For example for ARM targets this option would skip the mapping symbols
546 used to mark transitions between ARM code, THUMB code and data.
547 .IP \fB\-\-synthetic\fR 4
548 .IX Item "--synthetic"
549 Include synthetic symbols in the output. These are special symbols
550 created by the linker for various purposes. They are not shown by
551 default since they are not part of the binary\*(Aqs original source code.
552 .IP \fB\-\-unicode=\fR\fI[default|invalid|locale|escape|hex|highlight]\fR 4
553 .IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
554 Controls the display of UTF\-8 encoded multibyte characters in strings.
555 The default (\fB\-\-unicode=default\fR) is to give them no special
556 treatment. The \fB\-\-unicode=locale\fR option displays the sequence
557 in the current locale, which may or may not support them. The options
558 \&\fB\-\-unicode=hex\fR and \fB\-\-unicode=invalid\fR display them as
559 hex byte sequences enclosed by either angle brackets or curly braces.
560 .Sp
561 The \fB\-\-unicode=escape\fR option displays them as escape sequences
562 (\fI\euxxxx\fR) and the \fB\-\-unicode=highlight\fR option displays
563 them as escape sequences highlighted in red (if supported by the
564 output device). The colouring is intended to draw attention to the
565 presence of unicode sequences where they might not be expected.
566 .IP \fB\-W\fR 4
567 .IX Item "-W"
568 .PD 0
569 .IP \fB\-\-no\-weak\fR 4
570 .IX Item "--no-weak"
571 .PD
572 Do not display weak symbols.
573 .IP \fB\-\-with\-symbol\-versions\fR 4
574 .IX Item "--with-symbol-versions"
575 .PD 0
576 .IP \fB\-\-without\-symbol\-versions\fR 4
577 .IX Item "--without-symbol-versions"
578 .PD
579 Enables or disables the display of symbol version information. The
580 version string is displayed as a suffix to the symbol name, preceded
581 by an @ character. For example \fBfoo@VER_1\fR. If the version is
582 the default version to be used when resolving unversioned references
583 to the symbol then it is displayed as a suffix preceded by two @
584 characters. For example \fBfoo@@VER_2\fR. By default, symbol
585 version information is displayed.
586 .IP \fB\-\-target=\fR\fIbfdname\fR 4
587 .IX Item "--target=bfdname"
588 Specify an object code format other than your system\*(Aqs default format.
589 .IP \fB@\fR\fIfile\fR 4
590 .IX Item "@file"
591 Read command\-line options from \fIfile\fR. The options read are
592 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
593 does not exist, or cannot be read, then the option will be treated
594 literally, and not removed.
595 .Sp
596 Options in \fIfile\fR are separated by whitespace. A whitespace
597 character may be included in an option by surrounding the entire
598 option in either single or double quotes. Any character (including a
599 backslash) may be included by prefixing the character to be included
600 with a backslash. The \fIfile\fR may itself contain additional
601 @\fIfile\fR options; any such options will be processed recursively.
602 .SH "SEE ALSO"
603 .IX Header "SEE ALSO"
604 \&\fBar\fR\|(1), \fBobjdump\fR\|(1), \fBranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
605 .SH COPYRIGHT
606 .IX Header "COPYRIGHT"
607 Copyright (c) 1991\-2025 Free Software Foundation, Inc.
608 .PP
609 Permission is granted to copy, distribute and/or modify this document
610 under the terms of the GNU Free Documentation License, Version 1.3
611 or any later version published by the Free Software Foundation;
612 with no Invariant Sections, with no Front\-Cover Texts, and with no
613 Back\-Cover Texts. A copy of the license is included in the
614 section entitled "GNU Free Documentation License".