src/external/gpl3/binutils.old/dist/binutils/doc/binutils.texi - diff

Return to binutils.texi CVS log

Up to [cvs.NetBSD.org] / src / external / gpl3 / binutils.old / dist / binutils / doc

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/external/gpl3/binutils.old/dist/binutils/doc/binutils.texi between version 1.5 and 1.6

version 1.5, 2018/04/14 17:52:51

version 1.6, 2020/04/03 17:51:06

Line 10

@copying

@c man begin COPYRIGHT

Permission is granted to copy, distribute and/or modify this document

under the terms of the GNU Free Documentation License, Version 1.3

Line 34 section entitled ``GNU Free Documentatio

* c++filt: (binutils)c++filt. Filter to demangle encoded C++ symbols.

* cxxfilt: (binutils)c++filt. MS-DOS name for c++filt.

* dlltool: (binutils)dlltool. Create files needed to build and use DLLs.

* nlmconv: (binutils)nlmconv. Converts object code into an NLM.

* nm: (binutils)nm. List symbols from object files.

* objcopy: (binutils)objcopy. Copy and translate object files.

* objdump: (binutils)objdump. Display information from object files.

Line 121 Demangle encoded C++ symbols (on MS-DOS,

Line 120 Demangle encoded C++ symbols (on MS-DOS,

@item addr2line

Convert addresses into file names and line numbers

@item nlmconv

Convert object code into a Netware Loadable Module

@item windres

Manipulate Windows resources

Line 151 in the section entitled ``GNU Free Docum

Line 147 in the section entitled ``GNU Free Docum

* c++filt:: Filter to demangle encoded C++ symbols

* cxxfilt: c++filt. MS-DOS name for c++filt

* addr2line:: Convert addresses to file and line

* nlmconv:: Converts object code into an NLM

* windmc:: Generator for Windows message resources

* windres:: Manipulate Windows resources

* dlltool:: Create files needed to build and use DLLs

Line 366 modifier. In either case it does the sa

Line 361 modifier. In either case it does the sa

@cindex contents of archive

Display a @emph{table} listing the contents of @var{archive}, or those

of the files listed in @var{member}@dots{} that are present in the

archive. Normally only the member name is shown; if you also want to

archive. Normally only the member name is shown, but if the modifier

see the modes (permissions), timestamp, owner, group, and size, you can

@samp{O} is specified, then the corresponding offset of the member is also

request that by also specifying the @samp{v} modifier.

displayed. Finally, in order to see the modes (permissions), timestamp,

owner, group, and size the @samp{v} modifier should be included.

If you do not specify a @var{member}, all files in the archive

are listed.

Line 392 If you do not specify a @var{member}, al

Line 388 If you do not specify a @var{member}, al

are extracted.

Files cannot be extracted from a thin archive.

@item --help

Displays the list of command line options supported by @command{ar}

and then exits.

@item --version

Displays the version information of @command{ar} and then exits.

@end table

A number of modifiers (@var{mod}) may immediately follow the @var{p}

Line 469 Preserve the @emph{original} dates of me

Line 457 Preserve the @emph{original} dates of me

you do not specify this modifier, files extracted from the archive

are stamped with the time of extraction.

@item O

@cindex offsets of files

Display member offsets inside the archive. Use together with the @samp{t}

option.

@item P

Use the full path name when matching names in the archive. @sc{gnu}

@command{ar} can not create an archive with a full path name (such archives

Line 527 when the modifier @samp{v} is appended.

Line 520 when the modifier @samp{v} is appended.

This modifier shows the version number of @command{ar}.

@end table

The @command{ar} program also supports some command line options which

are neither modifiers nor actions, but which do change its behaviour

in specific ways:

@table @samp

@item --help

Displays the list of command line options supported by @command{ar}

and then exits.

@item --version

Displays the version information of @command{ar} and then exits.

@item -X32_64

@command{ar} ignores an initial option spelt @samp{-X32_64}, for

compatibility with AIX. The behaviour produced by this option is the

default for @sc{gnu} @command{ar}. @command{ar} does not support any of the other

default for @sc{gnu} @command{ar}. @command{ar} does not support any

@samp{-X} options; in particular, it does not support @option{-X32}

of the other @samp{-X} options; in particular, it does not support

which is the default for AIX @command{ar}.

@option{-X32} which is the default for AIX @command{ar}.

The optional command line switch @option{--plugin} @var{name} causes

@item --plugin @var{name}

@cindex plugins

The optional command line switch @option{--plugin @var{name}} causes

@command{ar} to load the plugin called @var{name} which adds support

for more file formats. This option is only available if the toolchain

for more file formats, including object files with link-time

has been built with plugin support enabled.

optimization information.

The optional command line switch @option{--target} @var{bfdname}

This option is only available if the toolchain has been built with

plugin support enabled.

If @option{--plugin} is not provided, but plugin support has been

enabled then @command{ar} iterates over the files in

@file{$@{libdir@}/bfd-plugins} in alphabetic order and the first

plugin that claims the object in question is used.

Please note that this plugin search directory is @emph{not} the one

used by @command{ld}'s @option{-plugin} option. In order to make

@command{ar} use the linker plugin it must be copied into the

@file{$@{libdir@}/bfd-plugins} directory. For GCC based compilations

the linker plugin is called @file{liblto_plugin.so.0.0.0}. For Clang

based compilations it is called @file{LLVMgold.so}. The GCC plugin

is always backwards compatible with earlier versions, so it is

sufficient to just copy the newest one.

@item --target @var{target}

The optional command line switch @option{--target @var{bfdname}}

specifies that the archive members are in an object code format

different from your system's default format. See

@xref{Target Selection}, for more information.

@end table

@c man end

@ignore

Line 736 nm [@option{-A}|@option{-o}|@option{--pr

Line 762 nm [@option{-A}|@option{-o}|@option{--pr

[@option{-B}|@option{--format=bsd}] [@option{-C}|@option{--demangle}[=@var{style}]]

[@option{-D}|@option{--dynamic}] [@option{-f}@var{format}|@option{--format=}@var{format}]

[@option{-g}|@option{--extern-only}] [@option{-h}|@option{--help}]

[@option{-l}|@option{--line-numbers}] [@option{-n}|@option{-v}|@option{--numeric-sort}]

[@option{-l}|@option{--line-numbers}] [@option{--inlines}]

[@option{-n}|@option{-v}|@option{--numeric-sort}]

[@option{-P}|@option{--portability}] [@option{-p}|@option{--no-sort}]

[@option{-r}|@option{--reverse-sort}] [@option{-S}|@option{--print-size}]

[@option{-s}|@option{--print-armap}] [@option{-t} @var{radix}|@option{--radix=}@var{radix}]

[@option{-u}|@option{--undefined-only}] [@option{-V}|@option{--version}]

[@option{-X 32_64}] [@option{--defined-only}] [@option{--no-demangle}]

[@option{--plugin} @var{name}] [@option{--size-sort}] [@option{--special-syms}]

[@option{--synthetic}] [@option{--target=}@var{bfdname}]

[@option{--synthetic}] [@option{--with-symbol-versions}] [@option{--target=}@var{bfdname}]

[@var{objfile}@dots{}]

@c man end

@end smallexample

Line 776 linking.

Line 803 linking.

@item B

@itemx b

The symbol is in the uninitialized data section (known as BSS).

The symbol is in the BSS data section. This section typically

contains zero-initialized or uninitialized data, although the exact

behavior is system dependent.

@item C

The symbol is common. Common symbols are uninitialized data. When

Line 822 The symbol is in a read only data sectio

Line 851 The symbol is in a read only data sectio

@item S

@itemx s

The symbol is in an uninitialized data section for small objects.

The symbol is in an uninitialized or zero-initialized data section

for small objects.

@item T

@itemx t

Line 943 address of the symbol. For an undefined

Line 973 address of the symbol. For an undefined

number of a relocation entry which refers to the symbol. If line number

information can be found, print it after the other symbol information.

@item --inlines

@cindex objdump inlines

When option @option{-l} is active, if the address belongs to a

function that was inlined, then this option causes the source

information for all enclosing scopes back to the first non-inlined

function to be printed as well. For example, if @code{main} inlines

@code{callee1} which inlines @code{callee2}, and address is from

@code{callee2}, the source information for @code{callee1} and @code{main}

will also be printed.

@item -n

@itemx -v

@itemx --numeric-sort

Line 1006 to @option{-X 32}, which is not supporte

Line 1046 to @option{-X 32}, which is not supporte

Display only defined symbols for each object file.

@item --plugin @var{name}

@cindex load plugin

@cindex plugins

Load the plugin called @var{name} to add support for extra target

types. This option is only available if the toolchain has been built

with plugin support enabled.

If @option{--plugin} is not provided, but plugin support has been

enabled then @command{nm} iterates over the files in

@file{$@{libdir@}/bfd-plugins} in alphabetic order and the first

plugin that claims the object in question is used.

Please note that this plugin search directory is @emph{not} the one

used by @command{ld}'s @option{-plugin} option. In order to make

@command{nm} use the linker plugin it must be copied into the

@file{$@{libdir@}/bfd-plugins} directory. For GCC based compilations

the linker plugin is called @file{liblto_plugin.so.0.0.0}. For Clang

based compilations it is called @file{LLVMgold.so}. The GCC plugin

is always backwards compatible with earlier versions, so it is

sufficient to just copy the newest one.

@item --size-sort

Sort symbols by size. For ELF objects symbol sizes are read from the

ELF, for other object types the symbol sizes are computed as the

Line 1031 Include synthetic symbols in the output.

Line 1085 Include synthetic symbols in the output.

created by the linker for various purposes. They are not shown by

default since they are not part of the binary's original source code.

@item --with-symbol-versions

Enables the display of symbol version information if any exists. The

version string is displayed as a suffix to the symbol name, preceeded by

an @@ character. For example @samp{foo@@VER_1}. If the version is

the default version to be used when resolving unversioned references

to the symbol then it is displayed as a suffix preceeded by two @@

characters. For example @samp{foo@@@@VER_2}.

@item --target=@var{bfdname}

@cindex object code format

Specify an object code format other than your system's default format.

Line 1059 objcopy [@option{-F} @var{bfdname}|@opti

Line 1121 objcopy [@option{-F} @var{bfdname}|@opti

[@option{-B} @var{bfdarch}|@option{--binary-architecture=}@var{bfdarch}]

[@option{-S}|@option{--strip-all}]

[@option{-g}|@option{--strip-debug}]

[@option{--strip-unneeded}]

[@option{-K} @var{symbolname}|@option{--keep-symbol=}@var{symbolname}]

[@option{-N} @var{symbolname}|@option{--strip-symbol=}@var{symbolname}]

[@option{--strip-unneeded-symbol=}@var{symbolname}]

Line 1075 objcopy [@option{-F} @var{bfdname}|@opti

Line 1138 objcopy [@option{-F} @var{bfdname}|@opti

[@option{--interleave-width=}@var{width}]

[@option{-j} @var{sectionpattern}|@option{--only-section=}@var{sectionpattern}]

[@option{-R} @var{sectionpattern}|@option{--remove-section=}@var{sectionpattern}]

[@option{--remove-relocations=}@var{sectionpattern}]

[@option{-p}|@option{--preserve-dates}]

[@option{-D}|@option{--enable-deterministic-archives}]

[@option{-U}|@option{--disable-deterministic-archives}]

Line 1107 objcopy [@option{-F} @var{bfdname}|@opti

Line 1171 objcopy [@option{-F} @var{bfdname}|@opti

[@option{--localize-symbols=}@var{filename}]

[@option{--globalize-symbols=}@var{filename}]

[@option{--weaken-symbols=}@var{filename}]

[@option{--add-symbol} @var{name}=[@var{section}:]@var{value}[,@var{flags}]

[@option{--add-symbol} @var{name}=[@var{section}:]@var{value}[,@var{flags}]]

[@option{--alt-machine-code=}@var{index}]

[@option{--prefix-symbols=}@var{string}]

[@option{--prefix-sections=}@var{string}]

Line 1131 objcopy [@option{-F} @var{bfdname}|@opti

Line 1195 objcopy [@option{-F} @var{bfdname}|@opti

[@option{--compress-debug-sections}]

[@option{--decompress-debug-sections}]

[@option{--elf-stt-common=@var{val}}]

[@option{--merge-notes}]

[@option{--no-merge-notes}]

[@option{-v}|@option{--verbose}]

[@option{-V}|@option{--version}]

[@option{--help}] [@option{--info}]

Line 1221 This option may be given more than once.

Line 1287 This option may be given more than once.

inappropriately may make the output file unusable. Wildcard

characters are accepted in @var{sectionpattern}.

If the first character of @var{sectionpattern} is the exclamation

point (!) then matching sections will not be copied, even if earlier

use of @option{--only-section} on the same command line would

otherwise copy it. For example:

@smallexample

--only-section=.text.* --only-section=!.text.foo

@end smallexample

will copy all sectinos maching '.text.*' but not the section

'.text.foo'.

@item -R @var{sectionpattern}

@itemx --remove-section=@var{sectionpattern}

Remove any section matching @var{sectionpattern} from the output file.

Line 1230 characters are accepted in @var{sectionp

Line 1308 characters are accepted in @var{sectionp

@option{-j} and @option{-R} options together results in undefined

behaviour.

If the first character of @var{sectionpattern} is the exclamation

point (!) then matching sections will not be removed even if an

earlier use of @option{--remove-section} on the same command line

would otherwise remove it. For example:

@smallexample

--remove-section=.text.* --remove-section=!.text.foo

@end smallexample

will remove all sections matching the pattern '.text.*', but will not

remove the section '.text.foo'.

@item --remove-relocations=@var{sectionpattern}

Remove relocations from the output file for any section matching

@var{sectionpattern}. This option may be given more than once. Note

that using this option inappropriately may make the output file

unusable. Wildcard characters are accepted in @var{sectionpattern}.

For example:

@smallexample

--remove-relocations=.text.*

@end smallexample

will remove the relocations for all sections matching the patter

'.text.*'.

If the first character of @var{sectionpattern} is the exclamation

point (!) then matching sections will not have their relocation

removed even if an earlier use of @option{--remove-relocations} on the

same command line would otherwise cause the relocations to be removed.

For example:

@smallexample

--remove-relocations=.text.* --remove-relocations=!.text.foo

@end smallexample

will remove all relocations for sections matching the pattern

'.text.*', but will not remove relocations for the section

'.text.foo'.

@item -S

@itemx --strip-all

Do not copy relocation and symbol information from the source file.

Line 1268 such as @option{-L}.

Line 1386 such as @option{-L}.

@item -L @var{symbolname}

@itemx --localize-symbol=@var{symbolname}

Make symbol @var{symbolname} local to the file, so that it is not

Convert a global or weak symbol called @var{symbolname} into a local

visible externally. This option may be given more than once.

symbol, so that it is not visible externally. This option may be

given more than once. Note - unique symbols are not converted.

@item -W @var{symbolname}

@itemx --weaken-symbol=@var{symbolname}

Line 1520 symbol table in the order they appear.

Line 1639 symbol table in the order they appear.

@item --rename-section @var{oldname}=@var{newname}[,@var{flags}]

Rename a section from @var{oldname} to @var{newname}, optionally

changing the section's flags to @var{flags} in the process. This has

the advantage over usng a linker script to perform the rename in that

the advantage over using a linker script to perform the rename in that

the output stays as an object file and does not become a linked

executable.

Line 1757 needed if debugging abilities are requir

Line 1876 needed if debugging abilities are requir

to create these files is as follows:

@enumerate

@item Link the executable as normal. Assuming that is is called

@item Link the executable as normal. Assuming that it is called

@code{foo} then...

@item Run @code{objcopy --only-keep-debug foo foo.dbg} to

create a file containing the debugging info.

Line 1894 converted to the @code{STT_COMMON} or @c

Line 2013 converted to the @code{STT_COMMON} or @c

@code{STT_COMMON}. @option{--elf-stt-common=no} converts common symbol

type to @code{STT_OBJECT}.

@item --merge-notes

@itemx --no-merge-notes

For ELF files, attempt (or do not attempt) to reduce the size of any

SHT_NOTE type sections by removing duplicate notes.

@item -V

@itemx --version

Show the version number of @command{objcopy}.

Line 1952 objdump [@option{-a}|@option{--archive-h

Line 2076 objdump [@option{-a}|@option{--archive-h

[@option{-r}|@option{--reloc}]

[@option{-R}|@option{--dynamic-reloc}]

[@option{-s}|@option{--full-contents}]

[@option{-W[lLiaprmfFsoRt]}|

[@option{-W[lLiaprmfFsoRtUuTgAckK]}|

@option{--dwarf}[=rawline,=decodedline,=info,=abbrev,=pubnames]

@option{--dwarf}[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]]

[=aranges,=macro,=frames,=frames-interp,=str,=loc]

[=Ranges,=pubtypes,=trace_info,=trace_abbrev]

[=trace_aranges,=gdb_index]

[@option{-G}|@option{--stabs}]

[@option{-t}|@option{--syms}]

[@option{-T}|@option{--dynamic-syms}]

Line 2047 for more information on demangling.

Line 2168 for more information on demangling.

@item -g

@itemx --debugging

Display debugging information. This attempts to parse STABS and IEEE

Display debugging information. This attempts to parse STABS

debugging format information stored in the file and print it out using

a C like syntax. If neither of these formats are found this option

a C like syntax. If no STABS debuging was found this option

falls back on the @option{-W} option to print any DWARF information in

the file.

Line 2186 some targets. If it is necessary to spe

Line 2307 some targets. If it is necessary to spe

disassembler option then multiple @option{-M} options can be used or

can be placed together into a comma separated list.

For ARC, @option{dsp} controls the printing of DSP instructions,

@option{spfp} selects the printing of FPX single precision FP

instructions, @option{dpfp} selects the printing of FPX double

precision FP instructions, @option{quarkse_em} selects the printing of

special QuarkSE-EM instructions, @option{fpuda} selects the printing

of double precision assist instructions, @option{fpus} selects the

printing of FPU single precision FP instructions, while @option{fpud}

selects the printing of FPU double precision FP instructions.

Additionally, one can choose to have all the immediates printed in

hexadecimal using @option{hex}. By default, the short immediates are

printed using the decimal representation, while the long immediate

values are printed as hexadecimal.

@option{cpu=...} allows to enforce a particular ISA when disassembling

instructions, overriding the @option{-m} value or whatever is in the ELF file.

This might be useful to select ARC EM or HS ISA, because architecture is same

for those and disassembler relies on private ELF header data to decide if code

is for EM or HS. This option might be specified multiple times - only the

latest value will be used. Valid values are same as for the assembler

@option{-mcpu=...} option.

If the target is an ARM architecture then this switch can be used to

select which register name set is used during disassembler. Specifying

@option{-M reg-names-std} (the default) will select the register names as

Line 2206 using the switch @option{--disassembler-

Line 2348 using the switch @option{--disassembler-

useful when attempting to disassemble thumb code produced by other

compilers.

For AArch64 targets this switch can be used to set whether instructions are

disassembled as the most general instruction using the @option{-M no-aliases}

option or whether instruction notes should be generated as comments in the

disasssembly using @option{-M notes}.

For the x86, some of the options duplicate functions of the @option{-m}

switch, but allow finer grained control. Multiple selections from the

following may be specified as a comma separated string.

Line 2243 When in AT&T mode, instructs the disasse

Line 2390 When in AT&T mode, instructs the disasse

suffix even when the suffix could be inferred by the operands.

@end table

For PowerPC, @option{booke} controls the disassembly of BookE

For PowerPC, the @option{-M} argument @option{raw} selects

instructions. @option{32} and @option{64} select PowerPC and

disasssembly of hardware insns rather than aliases. For example, you

PowerPC64 disassembly, respectively. @option{e300} selects

will see @code{rlwinm} rather than @code{clrlwi}, and @code{addi}

disassembly for the e300 family. @option{440} selects disassembly for

rather than @code{li}. All of the @option{-m} arguments for

the PowerPC 440. @option{ppcps} selects disassembly for the paired

@command{gas} that select a CPU are supported. These are:

single instructions of the PPC750CL.

@option{403}, @option{405}, @option{440}, @option{464}, @option{476},

@option{601}, @option{603}, @option{604}, @option{620}, @option{7400},

@option{7410}, @option{7450}, @option{7455}, @option{750cl},

@option{821}, @option{850}, @option{860}, @option{a2}, @option{booke},

@option{booke32}, @option{cell}, @option{com}, @option{e200z4},

@option{e300}, @option{e500}, @option{e500mc}, @option{e500mc64},

@option{e500x2}, @option{e5500}, @option{e6500}, @option{efs},

@option{power4}, @option{power5}, @option{power6}, @option{power7},

@option{power8}, @option{power9}, @option{ppc}, @option{ppc32},

@option{ppc64}, @option{ppc64bridge}, @option{ppcps}, @option{pwr},

@option{pwr2}, @option{pwr4}, @option{pwr5}, @option{pwr5x},

@option{pwr6}, @option{pwr7}, @option{pwr8}, @option{pwr9},

@option{pwrx}, @option{titan}, and @option{vle}.

@option{32} and @option{64} modify the default or a prior CPU

selection, disabling and enabling 64-bit insns respectively. In

addition, @option{altivec}, @option{any}, @option{htm}, @option{vsx},

and @option{spe} add capabilities to a previous @emph{or later} CPU

selection. @option{any} will disassemble any opcode known to

binutils, but in cases where an opcode has two different meanings or

different arguments, you may not see the disassembly you expect.

If you disassemble without giving a CPU selection, a default will be

chosen from information gleaned by BFD from the object files headers,

but the result again may not be as you expect.

For MIPS, this option controls the printing of instruction mnemonic

names and register names in disassembled instructions. Multiple

Line 2398 This is the default when @option{--prefi

Line 2567 This is the default when @option{--prefi

Display @var{width} bytes on a single line when disassembling

instructions.

@item -W[lLiaprmfFsoRt]

@item -W[lLiaprmfFsoRtUuTgAckK]

@itemx --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames]

@itemx --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]

@itemx --dwarf[=aranges,=macro,=frames,=frames-interp,=str,=loc]

@include debug.options.texi

@itemx --dwarf[=Ranges,=pubtypes,=trace_info,=trace_abbrev]

@itemx --dwarf[=trace_aranges,=gdb_index]

@cindex DWARF

@cindex debug symbols

Displays the contents of the debug sections in the file, if any are

present. If one of the optional letters or words follows the switch

then only data found in those specific sections will be dumped.

Note that there is no single letter option to display the content of

trace sections or .gdb_index.

Note: the output from the @option{=info} option can also be affected

by the options @option{--dwarf-depth}, the @option{--dwarf-start} and

the @option{--dwarf-check}.

@item --dwarf-depth=@var{n}

Limit the dump of the @code{.debug_info} section to @var{n} children.

This is only useful with @option{--dwarf=info}. The default is

to print all DIEs; the special value 0 for @var{n} will also have this

effect.

With a non-zero value for @var{n}, DIEs at or deeper than @var{n}

levels will not be printed. The range for @var{n} is zero-based.

@item --dwarf-start=@var{n}

Print only DIEs beginning with the DIE numbered @var{n}. This is only

useful with @option{--dwarf=info}.

If specified, this option will suppress printing of any header

information and all DIEs before the DIE numbered @var{n}. Only

siblings and children of the specified DIE will be printed.

This can be used in conjunction with @option{--dwarf-depth}.

@item --dwarf-check

Enable additional checks for consistency of Dwarf information.

Line 2555 meaningful for dynamic objects, such as

Line 2691 meaningful for dynamic objects, such as

libraries. This is similar to the information provided by the @samp{nm}

program when given the @option{-D} (@option{--dynamic}) option.

The output format is similar to that produced by the @option{--syms}

option, except that an extra field is inserted before the symbol's

name, giving the version information associated with the symbol.

If the version is the default version to be used when resolving

unversioned references to the symbol then it's displayed as is,

otherwise it's put into parentheses.

@item --special-syms

When displaying symbols include those which the target considers to be

special in some way and which would not normally be of interest to the

Line 2959 strip [@option{-F} @var{bfdname} |@optio

Line 3102 strip [@option{-F} @var{bfdname} |@optio

[@option{-s}|@option{--strip-all}]

[@option{-S}|@option{-g}|@option{-d}|@option{--strip-debug}]

[@option{--strip-dwo}]

[@option{-K} @var{symbolname} |@option{--keep-symbol=}@var{symbolname}]

[@option{-K} @var{symbolname}|@option{--keep-symbol=}@var{symbolname}]

[@option{-M}|@option{--merge-notes}][@option{--no-merge-notes}]

[@option{-N} @var{symbolname} |@option{--strip-symbol=}@var{symbolname}]

[@option{-w}|@option{--wildcard}]

[@option{-x}|@option{--discard-all}] [@option{-X} |@option{--discard-locals}]

[@option{-R} @var{sectionname} |@option{--remove-section=}@var{sectionname}]

[@option{--remove-relocations=}@var{sectionpattern}]

[@option{-o} @var{file}] [@option{-p}|@option{--preserve-dates}]

[@option{-D}|@option{--enable-deterministic-archives}]

[@option{-U}|@option{--disable-deterministic-archives}]

Line 3021 inappropriately may make the output file

Line 3166 inappropriately may make the output file

character @samp{*} may be given at the end of @var{sectionname}. If

so, then any section starting with @var{sectionname} will be removed.

If the first character of @var{sectionpattern} is the exclamation

point (!) then matching sections will not be removed even if an

earlier use of @option{--remove-section} on the same command line

would otherwise remove it. For example:

@smallexample

--remove-section=.text.* --remove-section=!.text.foo

@end smallexample

will remove all sections matching the pattern '.text.*', but will not

remove the section '.text.foo'.

@item --remove-relocations=@var{sectionpattern}

Remove relocations from the output file for any section matching

@var{sectionpattern}. This option may be given more than once. Note

that using this option inappropriately may make the output file

unusable. Wildcard characters are accepted in @var{sectionpattern}.

For example:

@smallexample

--remove-relocations=.text.*

@end smallexample

will remove the relocations for all sections matching the patter

'.text.*'.

If the first character of @var{sectionpattern} is the exclamation

point (!) then matching sections will not have their relocation

removed even if an earlier use of @option{--remove-relocations} on the

same command line would otherwise cause the relocations to be removed.

For example:

@smallexample

--remove-relocations=.text.* --remove-relocations=!.text.foo

@end smallexample

will remove all relocations for sections matching the pattern

'.text.*', but will not remove relocations for the section

'.text.foo'.

@item -s

@itemx --strip-all

Remove all symbols.

Line 3045 Remove all symbols that are not needed f

Line 3230 Remove all symbols that are not needed f

When stripping symbols, keep symbol @var{symbolname} even if it would

normally be stripped. This option may be given more than once.

@item -M

@itemx --merge-notes

@itemx --no-merge-notes

For ELF files, attempt (or do not attempt) to reduce the size of any

SHT_NOTE type sections by removing duplicate notes. The default is to

attempt this reduction.

@item -N @var{symbolname}

@itemx --strip-symbol=@var{symbolname}

Remove symbol @var{symbolname} from the source file. This option may be

Line 3134 needed if debugging abilities are requir

Line 3326 needed if debugging abilities are requir

to create these files is as follows:

@enumerate

@item Link the executable as normal. Assuming that is is called

@item Link the executable as normal. Assuming that it is called

@code{foo} then...

@item Run @code{objcopy --only-keep-debug foo foo.dbg} to

create a file containing the debugging info.

Line 3511 Info entries for @file{binutils}.

Line 3703 Info entries for @file{binutils}.

@c man end

@end ignore

@node nlmconv

@chapter nlmconv

@command{nlmconv} converts a relocatable object file into a NetWare

Loadable Module.

@ignore

@command{nlmconv} currently works with @samp{i386} object

files in @code{coff}, @sc{elf}, or @code{a.out} format, and @sc{SPARC}

object files in @sc{elf}, or @code{a.out} format@footnote{

@command{nlmconv} should work with any @samp{i386} or @sc{sparc} object

format in the Binary File Descriptor library. It has only been tested

with the above formats.}.

@end ignore

@quotation

@emph{Warning:} @command{nlmconv} is not always built as part of the binary

utilities, since it is only useful for NLM targets.

@end quotation

@c man title nlmconv converts object code into an NLM.

@smallexample

@c man begin SYNOPSIS nlmconv

nlmconv [@option{-I} @var{bfdname}|@option{--input-target=}@var{bfdname}]

[@option{-O} @var{bfdname}|@option{--output-target=}@var{bfdname}]

[@option{-T} @var{headerfile}|@option{--header-file=}@var{headerfile}]

[@option{-d}|@option{--debug}] [@option{-l} @var{linker}|@option{--linker=}@var{linker}]

[@option{-h}|@option{--help}] [@option{-V}|@option{--version}]

@var{infile} @var{outfile}

@c man end

@end smallexample

@c man begin DESCRIPTION nlmconv

@command{nlmconv} converts the relocatable @samp{i386} object file

@var{infile} into the NetWare Loadable Module @var{outfile}, optionally

reading @var{headerfile} for NLM header information. For instructions

on writing the NLM command file language used in header files, see the

@samp{linkers} section, @samp{NLMLINK} in particular, of the @cite{NLM

Development and Tools Overview}, which is part of the NLM Software

Developer's Kit (``NLM SDK''), available from Novell, Inc.

@command{nlmconv} uses the @sc{gnu} Binary File Descriptor library to read

@var{infile};

@ifclear man

see @ref{BFD,,BFD,ld.info,Using LD}, for more information.

@end ifclear

@command{nlmconv} can perform a link step. In other words, you can list

more than one object file for input if you list them in the definitions

file (rather than simply specifying one input file on the command line).

In this case, @command{nlmconv} calls the linker for you.

@c man end

@c man begin OPTIONS nlmconv

@table @env

@item -I @var{bfdname}

@itemx --input-target=@var{bfdname}

Object format of the input file. @command{nlmconv} can usually determine

the format of a given file (so no default is necessary).

@xref{Target Selection}, for more information.

@item -O @var{bfdname}

@itemx --output-target=@var{bfdname}

Object format of the output file. @command{nlmconv} infers the output

format based on the input format, e.g. for a @samp{i386} input file the

output format is @samp{nlm32-i386}.

@xref{Target Selection}, for more information.

@item -T @var{headerfile}

@itemx --header-file=@var{headerfile}

Reads @var{headerfile} for NLM header information. For instructions on

writing the NLM command file language used in header files, see@ see the

@samp{linkers} section, of the @cite{NLM Development and Tools

Overview}, which is part of the NLM Software Developer's Kit, available

from Novell, Inc.

@item -d

@itemx --debug

Displays (on standard error) the linker command line used by @command{nlmconv}.

@item -l @var{linker}

@itemx --linker=@var{linker}

Use @var{linker} for any linking. @var{linker} can be an absolute or a

relative pathname.

@item -h

@itemx --help

Prints a usage summary.

@item -V

@itemx --version

Prints the version number for @command{nlmconv}.

@end table

@c man end

@ignore

@c man begin SEEALSO nlmconv

the Info entries for @file{binutils}.

@c man end

@end ignore

@node windmc

@chapter windmc

Line 4409 readelf [@option{-a}|@option{--all}]

Line 4496 readelf [@option{-a}|@option{--all}]

[@option{-R} <number or name>|@option{--relocated-dump=}<number or name>]

[@option{-z}|@option{--decompress}]

[@option{-c}|@option{--archive-index}]

[@option{-w[lLiaprmfFsoRt]}|

[@option{-w[lLiaprmfFsoRtUuTgAckK]}|

@option{--debug-dump}[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]]

@option{--debug-dump}[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]]

[@option{--dwarf-depth=@var{n}}]

[@option{--dwarf-start=@var{n}}]

[@option{-I}|@option{--histogram}]

Line 4447 given.

Line 4534 given.

@itemx --all

Equivalent to specifying @option{--file-header},

@option{--program-headers}, @option{--sections}, @option{--symbols},

@option{--relocs}, @option{--dynamic}, @option{--notes} and

@option{--relocs}, @option{--dynamic}, @option{--notes},

@option{--version-info}.

@option{--version-info}, @option{--arch-specific}, @option{--unwind},

@option{--section-groups} and @option{--histogram}.

Note - this option does not enable @option{--use-dynamic} itself, so

if that option is not present on the command line then dynamic symbols

and dynamic relocs will not be displayed.

@item -h

@itemx --file-header

Line 4487 Displays the detailed section informatio

Line 4579 Displays the detailed section informatio

@itemx --syms

@cindex ELF symbol table information

Displays the entries in symbol table section of the file, if it has one.

If a symbol has version information associated with it then this is

displayed as well. The version string is displayed as a suffix to the

symbol name, preceeded by an @@ character. For example

@samp{foo@@VER_1}. If the version is the default version to be used

when resolving unversioned references to the symbol then it is

displayed as a suffix preceeded by two @@ characters. For example

@samp{foo@@@@VER_2}.

@item --dyn-syms

@cindex ELF dynamic symbol table information

Displays the entries in dynamic symbol table section of the file, if it

has one.

has one. The output format is the same as the format used by the

@option{--syms} option.

@item -e

@itemx --headers

Line 4536 When displaying symbols, this option mak

Line 4636 When displaying symbols, this option mak

symbol hash tables in the file's dynamic section, rather than the

symbol table sections.

When displaying relocations, this option makes @command{readelf}

display the dynamic relocations rather than the static relocations.

@item -x <number or name>

@itemx --hex-dump=<number or name>

Displays the contents of the indicated section as a hexadecimal bytes.

Line 4569 Displays the file symbol index informati

Line 4672 Displays the file symbol index informati

of binary archives. Performs the same function as the @option{t}

command to @command{ar}, but without using the BFD library. @xref{ar}.

@item -w[lLiaprmfFsoRt]

@item -w[lLiaprmfFsoRtUuTgAckK]

@itemx --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]

@itemx --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]

Displays the contents of the debug sections in the file, if any are

@include debug.options.texi

present. If one of the optional letters or words follows the switch

then only data found in those specific sections will be dumped.

Note that there is no single letter option to display the content of

trace sections or .gdb_index.

Note: the @option{=decodedline} option will display the interpreted

contents of a .debug_line section whereas the @option{=rawline} option

dumps the contents in a raw format.

Note: the @option{=frames-interp} option will display the interpreted

contents of a .debug_frame section whereas the @option{=frames} option

dumps the contents in a raw format.

Note: the output from the @option{=info} option can also be affected

by the options @option{--dwarf-depth} and @option{--dwarf-start}.

@item --dwarf-depth=@var{n}

Limit the dump of the @code{.debug_info} section to @var{n} children.

This is only useful with @option{--debug-dump=info}. The default is

to print all DIEs; the special value 0 for @var{n} will also have this

effect.

With a non-zero value for @var{n}, DIEs at or deeper than @var{n}

levels will not be printed. The range for @var{n} is zero-based.

@item --dwarf-start=@var{n}

Print only DIEs beginning with the DIE numbered @var{n}. This is only

useful with @option{--debug-dump=info}.

If specified, this option will suppress printing of any header

information and all DIEs before the DIE numbered @var{n}. Only

siblings and children of the specified DIE will be printed.

This can be used in conjunction with @option{--dwarf-depth}.

@item -I

@itemx --histogram

CVSweb <webmaster@jp.NetBSD.org>