diff options
Diffstat (limited to 'share/info/binutils.info')
-rw-r--r-- | share/info/binutils.info | 270 |
1 files changed, 142 insertions, 128 deletions
diff --git a/share/info/binutils.info b/share/info/binutils.info index 7bba45b..f7d0976 100644 --- a/share/info/binutils.info +++ b/share/info/binutils.info @@ -1,7 +1,7 @@ -This is binutils.info, produced by makeinfo version 4.13 from -/mnt/jenkins/workspace/linaro-android_toolchain64-4.9-2014.09/build/objdir/../build/../binutils/binutils-current/binutils/doc/binutils.texi. +This is binutils.info, produced by makeinfo version 4.8 from +binutils.texi. -Copyright (C) 1991-2013 Free Software Foundation, Inc. + Copyright (C) 1991-2013 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -43,7 +43,7 @@ Introduction ************ This brief manual contains documentation for the GNU binary utilities -(Linux/GNU Binutils) version 2.23.52.0.2: +(GNU Binutils) version 2.23.91: This document is distributed under the terms of the GNU Free Documentation License version 1.3. A copy of the license is included @@ -207,12 +207,15 @@ of the following, but you must specify only one of them: The modifier `v' makes `ar' list each file as it is appended. - Since the point of this operation is speed, the archive's symbol - table index is not updated, even if it already existed; you can - use `ar s' or `ranlib' explicitly to update the symbol table index. + Since the point of this operation is speed, implementations of + `ar' have the option of not updating the archive's symbol table if + one exists. Too many different systems however assume that symbol + tables are always up-to-date, so GNU `ar' will rebuild the table + even with a quick append. - However, too many different systems assume quick append rebuilds - the index, so GNU `ar' implements `q' as a synonym for `r'. + Note - GNU `ar' treats the command `qs' as a synonym for `r' - + replacing already existing files in the archive and appending new + ones at the end. `r' Insert the files MEMBER... into ARCHIVE (with _replacement_). This @@ -589,7 +592,7 @@ object files are listed as arguments, `nm' assumes the file `a.out'. same name. If the symbol is defined anywhere, the common symbols are treated as undefined references. For more details on common symbols, see the discussion of -warn-common - in *note Linker options: (ld.info)Options. + in *Note Linker options: (ld.info)Options. `D' `d' @@ -612,6 +615,9 @@ object files are listed as arguments, `nm' assumes the file `a.out'. be invoked at runtime. The runtime execution will then return the value to be used in the relocation. + `I' + The symbol is an indirect reference to another symbol. + `N' The symbol is a debugging symbol. @@ -665,8 +671,7 @@ object files are listed as arguments, `nm' assumes the file `a.out'. The symbol is a stabs symbol in an a.out object file. In this case, the next values printed are the stabs other field, the stabs desc field, and the stab type. Stabs symbols are - used to hold debugging information. For more information, - see *note Stabs: (stabs.info)Top. + used to hold debugging information. `?' The symbol type is unknown, or object file format specific. @@ -791,8 +796,8 @@ equivalent. `--plugin NAME' Load the plugin called NAME to add support for extra target types. - This option is only available if the toolchain has been built with - plugin support enabled. + This option is only available if the toolchain has been built + with plugin support enabled. `--size-sort' Sort symbols by size. The size is computed as the difference @@ -804,8 +809,8 @@ equivalent. `--special-syms' Display symbols which have a target-specific special meaning. These symbols are usually used by the target for some special - processing and are not normally helpful when included included in - the normal symbol lists. For example for ARM targets this option + processing and are not normally helpful when included in the + normal symbol lists. For example for ARM targets this option would skip the mapping symbols used to mark transitions between ARM code, THUMB code and data. @@ -1827,6 +1832,9 @@ given. instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move', 'sll' instead of 'nop', etc. + `virt' + Disassemble the virtualization ASE instructions. + `gpr-names=ABI' Print GPR (general-purpose register) names as appropriate for the specified ABI. By default, GPR names are selected @@ -1884,7 +1892,7 @@ given. For XCOFF, the available options are: `header', `aout', `sections', `syms', `relocs', `lineno', `loader', `except', - `typchk', `traceback' and `toc'. + `typchk', `traceback', `toc' and `ldinfo'. `-r' `--reloc' @@ -1973,8 +1981,7 @@ given. in which `.stab' debugging symbol-table entries are carried in an ELF section. In most other file formats, debugging symbol-table entries are interleaved with linkage symbols, and are visible in - the `--syms' output. For more information on stabs symbols, see - *note Stabs: (stabs.info)Top. + the `--syms' output. `--start-address=ADDRESS' Start displaying data at the specified address. This affects the @@ -2138,8 +2145,9 @@ their placement in the archive. header will show zero for the UID, GID, and timestamp. When this option is used, multiple runs will produce identical output files. - This is the default unless `binutils' was configured with - `--enable-deterministic-archives'. + If `binutils' was configured with + `--enable-deterministic-archives', then this mode is on by + default. It can be disabled with the `-U' option, described below. `-t' Update the timestamp of the symbol map of an archive. @@ -2149,8 +2157,9 @@ their placement in the archive. the `-D' option, above: the archive index will get actual UID, GID, timestamp, and file mode values. - This is the default unless `binutils' was configured with - `--enable-deterministic-archives'. + If `binutils' was configured _without_ + `--enable-deterministic-archives', then this mode is on by default. + File: binutils.info, Node: size, Next: strings, Prev: ranlib, Up: Top @@ -2818,7 +2827,7 @@ file language used in header files, see the `linkers' section, `NLMLINK' in particular, of the `NLM Development and Tools Overview', which is part of the NLM Software Developer's Kit ("NLM SDK"), available from Novell, Inc. `nlmconv' uses the GNU Binary File -Descriptor library to read INFILE; see *note BFD: (ld.info)BFD, for +Descriptor library to read INFILE; see *Note BFD: (ld.info)BFD, for more information. `nlmconv' can perform a link step. In other words, you can list @@ -2940,7 +2949,7 @@ Compiler. Specify the BFD format to use for a bin file as output. This is a BFD target name; you can use the `--help' option to see a list of supported targets. Normally `windmc' will use the default format, - which is the first one listed by the `--help' option. *note + which is the first one listed by the `--help' option. *Note Target Selection::. `-h PATH' @@ -3092,7 +3101,7 @@ available to Windows. This is a BFD target name; you can use the `--help' option to see a list of supported targets. Normally `windres' will use the default format, which is the first one listed by the `--help' - option. *note Target Selection::. + option. *Note Target Selection::. `--preprocessor PROGRAM' When `windres' reads an `rc' file, it runs it through the C @@ -3657,8 +3666,9 @@ equivalent. At least one option besides `-v' or `-H' must be given. `-u' `--unwind' Displays the contents of the file's unwind section, if it has one. - Only the unwind sections for IA64 ELF files, as well as ARM unwind - tables (`.ARM.exidx' / `.ARM.extab') are currently supported. + Only the unwind sections for IA64 ELF files, as well as ARM + unwind tables (`.ARM.exidx' / `.ARM.extab') are currently + supported. `-d' `--dynamic' @@ -4059,8 +4069,7 @@ recommend you contact that organization first. individuals in the file `etc/SERVICE' in the GNU Emacs distribution. In any event, we also recommend that you send bug reports for the -binary utilities to `http://www.sourceware.org/bugzilla/ and -mailto:hjl.tools@gmail.com'. +binary utilities to `http://www.sourceware.org/bugzilla/'. The fundamental principle of reporting bugs usefully is this: *report all the facts*. If you are not sure whether to state a fact or @@ -4689,21 +4698,23 @@ Binutils Index * Menu: -* --enable-deterministic-archives <1>: strip. (line 105) -* --enable-deterministic-archives <2>: ranlib. (line 32) -* --enable-deterministic-archives <3>: objcopy. (line 292) -* --enable-deterministic-archives: ar cmdline. (line 148) -* .stab: objdump. (line 410) -* Add prefix to absolute paths: objdump. (line 353) +* --enable-deterministic-archives <1>: objcopy. (line 302) +* --enable-deterministic-archives <2>: ranlib. (line 44) +* --enable-deterministic-archives <3>: ar cmdline. (line 151) +* --enable-deterministic-archives <4>: strip. (line 115) +* --enable-deterministic-archives <5>: ar cmdline. (line 224) +* --enable-deterministic-archives: objcopy. (line 292) +* .stab: objdump. (line 413) +* Add prefix to absolute paths: objdump. (line 356) * addr2line: addr2line. (line 6) * address to file name and line number: addr2line. (line 6) -* all header information, object file: objdump. (line 529) +* all header information, object file: objdump. (line 531) * ar: ar. (line 6) * ar compatibility: ar. (line 60) * architecture: objdump. (line 197) * architectures available: objdump. (line 182) * archive contents: ranlib. (line 6) -* Archive file symbol index information: readelf. (line 154) +* Archive file symbol index information: readelf. (line 155) * archive headers: objdump. (line 67) * archives: ar. (line 6) * base files: dlltool. (line 124) @@ -4719,80 +4730,83 @@ Binutils Index * changing start address: objcopy. (line 332) * collections of files: ar. (line 6) * compatibility, ar: ar. (line 60) -* contents of archive: ar cmdline. (line 94) +* contents of archive: ar cmdline. (line 97) * crash: Bug Criteria. (line 9) -* creating archives: ar cmdline. (line 142) -* creating thin archive: ar cmdline. (line 207) +* creating archives: ar cmdline. (line 145) +* creating thin archive: ar cmdline. (line 210) * cxxfilt: c++filt. (line 14) -* dates in archive: ar cmdline. (line 181) -* debug symbols: objdump. (line 375) -* debugging symbols: nm. (line 145) +* dates in archive: ar cmdline. (line 184) +* debug symbols: objdump. (line 413) +* debugging symbols: nm. (line 147) * deleting from archive: ar cmdline. (line 26) * demangling C++ symbols: c++filt. (line 6) -* demangling in nm: nm. (line 153) -* demangling in objdump <1>: addr2line. (line 78) -* demangling in objdump: objdump. (line 95) -* deterministic archives <1>: strip. (line 105) -* deterministic archives <2>: ranlib. (line 32) -* deterministic archives <3>: objcopy. (line 292) -* deterministic archives: ar cmdline. (line 148) +* demangling in nm: nm. (line 155) +* demangling in objdump <1>: objdump. (line 95) +* demangling in objdump: addr2line. (line 78) +* deterministic archives <1>: ranlib. (line 32) +* deterministic archives <2>: objcopy. (line 292) +* deterministic archives <3>: ar cmdline. (line 224) +* deterministic archives <4>: strip. (line 105) +* deterministic archives <5>: ar cmdline. (line 151) +* deterministic archives <6>: ranlib. (line 44) +* deterministic archives: objcopy. (line 302) * disassembling object code: objdump. (line 117) * disassembly architecture: objdump. (line 197) * disassembly endianness: objdump. (line 137) -* disassembly, with source: objdump. (line 349) +* disassembly, with source: objdump. (line 352) * discarding symbols: strip. (line 6) * DLL: dlltool. (line 6) * dlltool: dlltool. (line 6) -* DWARF: objdump. (line 375) -* dynamic relocation entries, in object file: objdump. (line 337) -* dynamic symbol table entries, printing: objdump. (line 513) -* dynamic symbols: nm. (line 165) -* ELF dynamic section information: readelf. (line 112) +* DWARF: objdump. (line 378) +* dynamic relocation entries, in object file: objdump. (line 340) +* dynamic symbol table entries, printing: objdump. (line 515) +* dynamic symbols: nm. (line 167) +* ELF dynamic section information: readelf. (line 113) * ELF dynamic symbol table information: readelf. (line 88) * ELF file header information: readelf. (line 57) * ELF file information: readelf. (line 6) * ELF notes: readelf. (line 97) -* ELF object file format: objdump. (line 410) +* ELF object file format: objdump. (line 413) * ELF program header information: readelf. (line 63) * ELF reloc information: readelf. (line 101) * ELF section group information: readelf. (line 74) -* ELF section information: readelf. (line 69) +* ELF section information: readelf. (line 79) * ELF segment information: readelf. (line 63) * ELF symbol table information: readelf. (line 84) -* ELF version sections information: readelf. (line 116) +* ELF version sections information: readelf. (line 117) * elfedit: elfedit. (line 6) * endianness: objdump. (line 137) * error on valid input: Bug Criteria. (line 12) -* external symbols: nm. (line 177) -* extract from archive: ar cmdline. (line 109) +* external symbols: nm. (line 179) +* extract from archive: ar cmdline. (line 112) * fatal signal: Bug Criteria. (line 9) -* file name: nm. (line 139) -* header information, all: objdump. (line 529) +* file name: nm. (line 141) +* header information, all: objdump. (line 531) * input .def file: dlltool. (line 120) -* input file name: nm. (line 139) -* Instruction width: objdump. (line 370) +* input file name: nm. (line 141) +* Instruction width: objdump. (line 373) * libraries: ar. (line 25) * listings strings: strings. (line 6) -* load plugin: nm. (line 250) +* load plugin: nm. (line 252) * machine instructions: objdump. (line 117) * moving in archive: ar cmdline. (line 34) * MRI compatibility, ar: ar scripts. (line 8) -* name duplication in archive: ar cmdline. (line 103) +* name duplication in archive: ar cmdline. (line 106) * name length: ar. (line 18) * nm: nm. (line 6) -* nm compatibility: nm. (line 149) -* nm format: nm. (line 149) -* not writing archive index: ar cmdline. (line 200) +* nm compatibility: nm. (line 173) +* nm format: nm. (line 173) +* not writing archive index: ar cmdline. (line 203) * objdump: objdump. (line 6) -* object code format <1>: addr2line. (line 73) -* object code format <2>: strings. (line 67) -* object code format <3>: size. (line 84) +* object code format <1>: strings. (line 67) +* object code format <2>: nm. (line 278) +* object code format <3>: addr2line. (line 73) * object code format <4>: objdump. (line 81) -* object code format: nm. (line 276) +* object code format: size. (line 84) * object file header: objdump. (line 143) * object file information: objdump. (line 6) * object file offsets: objdump. (line 148) -* object file sections: objdump. (line 344) +* object file sections: objdump. (line 347) * object formats available: objdump. (line 182) * operations on archive: ar cmdline. (line 22) * printing from archive: ar cmdline. (line 46) @@ -4800,85 +4814,85 @@ Binutils Index * quick append to archive: ar cmdline. (line 54) * radix for section sizes: size. (line 66) * ranlib <1>: ranlib. (line 6) -* ranlib: ar cmdline. (line 88) +* ranlib: ar cmdline. (line 91) * readelf: readelf. (line 6) -* relative placement in archive: ar cmdline. (line 130) -* relocation entries, in object file: objdump. (line 331) +* relative placement in archive: ar cmdline. (line 133) +* relocation entries, in object file: objdump. (line 334) * removing symbols: strip. (line 6) -* repeated names in archive: ar cmdline. (line 103) -* replacement in archive: ar cmdline. (line 70) +* repeated names in archive: ar cmdline. (line 106) +* replacement in archive: ar cmdline. (line 73) * reporting bugs: Reporting Bugs. (line 6) * scripts, ar: ar scripts. (line 8) * section addresses in objdump: objdump. (line 73) * section headers: objdump. (line 164) * section information: objdump. (line 187) * section sizes: size. (line 6) -* sections, full contents: objdump. (line 344) +* sections, full contents: objdump. (line 347) * size: size. (line 6) * size display format: size. (line 27) * size number format: size. (line 66) -* sorting symbols: nm. (line 200) +* sorting symbols: nm. (line 202) * source code context: objdump. (line 157) -* source disassembly: objdump. (line 349) -* source file name: nm. (line 139) +* source disassembly: objdump. (line 352) +* source file name: nm. (line 141) * source filenames for object files: objdump. (line 191) -* stab: objdump. (line 410) -* start-address: objdump. (line 420) -* stop-address: objdump. (line 424) +* stab: objdump. (line 413) +* start-address: objdump. (line 422) +* stop-address: objdump. (line 426) * strings: strings. (line 6) * strings, printing: strings. (line 6) * strip: strip. (line 6) -* Strip absolute paths: objdump. (line 356) -* symbol index <1>: ranlib. (line 6) -* symbol index: ar. (line 28) -* symbol index, listing: nm. (line 222) -* symbol line numbers: nm. (line 185) -* symbol table entries, printing: objdump. (line 429) +* Strip absolute paths: objdump. (line 359) +* symbol index <1>: ar. (line 28) +* symbol index: ranlib. (line 6) +* symbol index, listing: nm. (line 224) +* symbol line numbers: nm. (line 187) +* symbol table entries, printing: objdump. (line 431) * symbols: nm. (line 6) * symbols, discarding: strip. (line 6) * thin archives: ar. (line 40) -* undefined symbols: nm. (line 233) +* undefined symbols: nm. (line 235) * Unix compatibility, ar: ar cmdline. (line 8) * unwind information: readelf. (line 106) * Update ELF header: elfedit. (line 6) -* updating an archive: ar cmdline. (line 212) +* updating an archive: ar cmdline. (line 215) * version: Top. (line 6) * VMA in objdump: objdump. (line 73) -* wide output, printing: objdump. (line 535) -* writing archive index: ar cmdline. (line 194) +* wide output, printing: objdump. (line 537) +* writing archive index: ar cmdline. (line 197) Tag Table: -Node: Top2020 -Node: ar3743 -Node: ar cmdline6881 -Node: ar scripts17096 -Node: nm22784 -Node: objcopy32680 -Node: objdump64449 -Node: ranlib86578 -Node: size88095 -Node: strings91099 -Node: strip93557 -Node: c++filt100789 -Ref: c++filt-Footnote-1105630 -Node: addr2line105736 -Node: nlmconv110073 -Node: windmc112678 -Node: windres116327 -Node: dlltool122688 -Node: def file format135568 -Node: readelf138107 -Node: elfedit145657 -Node: Common Options147911 -Node: Selecting the Target System148951 -Node: Target Selection149883 -Node: Architecture Selection151865 -Node: Reporting Bugs152693 -Node: Bug Criteria153472 -Node: Bug Reporting154025 -Node: GNU Free Documentation License160926 -Node: Binutils Index186105 +Node: Top1896 +Node: ar3609 +Node: ar cmdline6747 +Node: ar scripts17089 +Node: nm22777 +Node: objcopy32671 +Node: objdump64440 +Node: ranlib86571 +Node: size88176 +Node: strings91180 +Node: strip93638 +Node: c++filt100870 +Ref: c++filt-Footnote-1105711 +Node: addr2line105817 +Node: nlmconv110154 +Node: windmc112759 +Node: windres116408 +Node: dlltool122769 +Node: def file format135649 +Node: readelf138188 +Node: elfedit145743 +Node: Common Options147997 +Node: Selecting the Target System149037 +Node: Target Selection149969 +Node: Architecture Selection151951 +Node: Reporting Bugs152779 +Node: Bug Criteria153558 +Node: Bug Reporting154111 +Node: GNU Free Documentation License160981 +Node: Binutils Index186160 End Tag Table |