Red Hat ENTERPRISE LINUX 4 - USING BINUTILS Manual do Utilizador

Red Hat Enterprise Linux 4Using binutils, the GNU BinaryUtilities

4 Chapter 2. ardDelete modules from the archive. Specify the names of modules to be deleted as member. . . ; thearchive is untouched if you specify no

Chapter 2. ar 5If there is more than one file with the same name (say, fie) in an archive (say b.a), ar t b.afie lists only the first instance; to see t

6 Chapter 2. arThis option will cause gnu ar to match file names using a complete path name, which can beconvenient when extracting a single file from a

Chapter 2. ar 7• comments are allowed; text after either of the characters * or ; is ignored.• Whenever you use a list of names as part of the argumen

8 Chapter 2. arENDExit from ar, with a 0 exit code to indicate successful completion. This command does not savethe output file; if you have changed th

Chapter 3.nmnm [-a|--debug-syms] [-g|--extern-only][-B] [-C|--demangle[=style]] [-D|--dynamic][-S|--print-size] [-s|--print-armap][-A|-o|--print-file-

10 Chapter 3. nmNThe symbol is a debugging symbol.RThe symbol is in a read only data section.SThe symbol is in an uninitialized data section for small

Chapter 3. nm 11-C-demangle[=style]Decode (demangle) low-level symbol names into user-level names. Besides removing any initialunderscore prepended by

12 Chapter 3. nm-s-print-armapWhen listing symbols from archive members, include the index: a mapping (stored in the archiveby ar or ranlib) of which

Chapter 4.objcopyobjcopy [-F bfdname|--target=bfdname][-I bfdname|--input-target=bfdname][-O bfdname|--output-target=bfdname][-B bfdarch|--binary-arch

Red Hat Enterprise Linux 4: Using binutils, the GNU Binary UtilitiesCopyright © 1987, 1989, 1991-2004 Free Software Foundation, Inc.Permission is gran

14 Chapter 4. objcopy[--help] [--info]infile [outfile]The gnu objcopy utility copies the contents of an object file to another. objcopy uses the gnu bf

Chapter 4. objcopy 15_binary_objfile_end and _binary_objfile_size. e.g. you can transform a picture file into anobject file and then access it in your c

16 Chapter 4. objcopythe symbol name. If the first character of the symbol name is the exclamation point (!) then thesense of the switch is reversed fo

Chapter 4. objcopy 17-change-addresses incr-adjust-vma incrChange the VMA and LMA addresses of all sections, as well as the start address, by addingin

18 Chapter 4. objcopy-add-section sectionname=filenameAdd a new section named sectionname while copying the file. The contents of the new sectionare ta

Chapter 4. objcopy 19-keep-symbols=filenameApply -keep-symbol option to each symbol listed in the file filename. filename is simply aflat file, with one

20 Chapter 4. objcopy-add-gnu-debuglink=path-to-fileCreates a .gnu_debuglink section which contains a reference to path-to-file and adds it tothe outp

Chapter 5.objdumpobjdump [-a|--archive-headers][-b bfdname|--target=bfdname][-C|--demangle[=style] ][-d|--disassemble][-D|--disassemble-all][-z|--disa

22 Chapter 5. objdump-adjust-vma=offsetWhen dumping information, first add offset to all the section addresses. This is useful if thesection addresses

Chapter 5. objdump 23-EB-EL-endian={big|little}Specify the endianness of the object files. This only affects disassembly. This can be useful whendisass

Table of Contents1. Introduction...

24 Chapter 5. objdump-M options-disassembler-options=optionsPass target specific information to the disassembler. Only supported on some targets. If it

Chapter 5. objdump 25reg-names=ABIPrint GPR and FPR names as appropriate for the selected ABI.reg-names=ARCHPrint CPU-specific register names (CP0 regi

26 Chapter 5. objdump-start-address=addressStart displaying data at the specified address. This affects the output of the -d, -r and -s options.-stop-a

Chapter 6.ranlibranlib [-vV] archiveranlib generates an index to the contents of an archive and stores it in the archive. The index listseach symbol d

28 Chapter 6. ranlib

Chapter 7.sizesize [-A|-B|--format=compatibility][--help][-d|-o|-x|--radix=number][-t|--totals][--target=bfdname] [-V|--version][objfile...]The gnu si

30 Chapter 7. size-d-o-x-radix=numberUsing one of these options, you can control whether the size of each section is given in dec-imal (-d, or -radix=

Chapter 8.stringsstrings [-afov] [-min-len][-n min-len] [--bytes=min-len][-t radix] [--radix=radix][-e encoding] [--encoding=encoding][-] [--all] [--p

32 Chapter 8. strings-e encoding-encoding=encodingSelect the character encoding of the strings that are to be found. Possible values for encodingare:

Chapter 9.stripstrip [-F bfdname |--target=bfdname][-I bfdname |--input-target=bfdname][-O bfdname |--output-target=bfdname][-s|--strip-all][-S|-g|-d|

34 Chapter 9. strip-s-strip-allRemove all symbols.-g-S-d-strip-debugRemove debugging symbols only.-strip-unneededRemove all symbols that are not neede

Chapter 9. strip 35-only-keep-debugStrip a file, removing any sections that would be stripped by -strip-debug and leaving thedebugging sections.The int

36 Chapter 9. strip

Chapter 10.c++filtc++filt [-_|--strip-underscores][-j|--java][-n|--no-strip-underscores][-p|--no-params][-s format|--format=format][--help] [--version]

38 Chapter 10. c++filt-s format-format=formatc++filt can decode various methods of mangling, used by different compilers. The argumentto this option se

Chapter 10. c++filt 39

40 Chapter 10. c++filt

Chapter 11.addr2lineaddr2line [-b bfdname|--target=bfdname][-C|--demangle[=style]][-e filename|--exe=filename][-f|--functions] [-s|--basename][-H|--he

42 Chapter 11. addr2line-f-functionsDisplay function names as well as file and line number information.-s-basenamesDisplay only the base of each file na

Chapter 12.nlmconvnlmconv converts a relocatable object file into a NetWare Loadable Module.Warning: nlmconv is not always built as part of the binary

gnu Binary Utilities

44 Chapter 12. nlmconv-l linker-linker=linkerUse linker for any linking. linker can be an absolute or a relative pathname.-h-helpPrints a usage summar

Chapter 13.windreswindres may be used to manipulate Windows resources.Warning: windres is not always built as part of the binary utilities, since it i

46 Chapter 13. windres-o filename-output filenameThe name of the output file. If this option is not used, then windres will use the first non-optionargu

Chapter 13. windres 47-l val-language valSpecify the default language to use when reading an rc file. val should be a hexadecimal lan-guage code. The l

48 Chapter 13. windres

Chapter 14.Create files needed to build and use DLLsdlltool may be used to create the files needed to build and use dynamic link libraries (DLLs).Warnin

50 Chapter 14. Create files needed to build and use DLLsThe second file needed for DLL creation is an exports file. This file is linked with the object fil

Chapter 14. Create files needed to build and use DLLs 51-no-export-all-symbolsOnly export symbols explicitly listed in an input .def file or in .drectve

52 Chapter 14. Create files needed to build and use DLLs-k-kill-atSpecifies that when dlltool is creating the exports file it should not append the strin

Chapter 14. Create files needed to build and use DLLs 53-V-versionDisplays dlltool’s version number and then exits.

54 Chapter 14. Create files needed to build and use DLLs

Chapter 15.readelfreadelf [-a|--all][-h|--file-header][-l|--program-headers|--segments][-S|--section-headers|--sections][-e|--headers][-s|--syms|--sym

56 Chapter 15. readelf-S-sections-section-headersDisplays the information contained in the file’s section headers, if it has any.-s-symbols-symsDisplay

Chapter 15. readelf 57-w[liaprmfFso]-debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=macro,=frames,=frames-interp,=str,=loc]Displays the contents of

58 Chapter 15. readelf

Chapter 16.Selecting the Target SystemYou can specify two aspects of the target system to the gnu binary file utilities, each in several ways:• the tar

60 Chapter 16. Selecting the Target System16.1.3. objcopyand stripOutput TargetWays to specify:1. command line options: -O or -output-target, or -F or

Chapter 17.Reporting BugsYour bug reports play an essential role in making the binary utilities reliable.Reporting a bug may help you by bringing a so

62 Chapter 17. Reporting BugsWithout this, we will not know whether there is any point in looking for the bug in the currentversion of the binary util

Chapter 17. Reporting Bugs 63• A patch for the bug.A patch for the bug does help us if it is a good one. But do not omit the necessary information, su

Chapter 1.IntroductionThis brief manual contains documentation for the gnu binary utilities (collectively version2.15.92.0.2):This document is distrib

64 Chapter 17. Reporting Bugs

Appendix A.GNU Free Documentation LicenseVersion 1.1, March 2000Copyright (C) 2000 Free Software Foundation, Inc.59 Temple Place, Suite 330, Boston, M

66 Appendix A. GNU Free Documentation LicenseA "Transparent" copy of the Document means a machine-readable copy, represented in a for-mat wh

Appendix A. GNU Free Documentation License 67version of the Document.5. MODIFICATIONSYou may copy and distribute a Modified Version of the Document und

68 Appendix A. GNU Free Documentation LicenseYou may combine the Document with other documents released under this License, under theterms defined in s

Appendix A. GNU Free Documentation License 69The Free Software Foundation may publish new, revised versions of the GNU Free Documenta-tion License fro

70 Appendix A. GNU Free Documentation License

Index.stab, see Chapter 5 objdumpAaddr2line, see Chapter 11 addr2lineaddress to file name and line number, see Chapter 11addr2lineall header informatio

72 IndexHheader information, all, see Chapter 5 objdumpIinput .def file, see Chapter 14 Create files needed tobuild and use DLLsinput file name, see Chap

Index 73symbol table entries, printing, see Chapter 5 objdumpsymbols, see Chapter 3 nmsymbols, discarding, see Chapter 9 stripUundefined symbols, see C

2 Chapter 1. Introduction

Chapter 2.arar [-]p[mod [relpos] [count]] archive [member...]ar -M [mri-script ]The gnu ar program creates, modifies, and extracts from archives. An ar