[6370fa6] | 1 | <sect2>
|
---|
| 2 | <title>Description</title>
|
---|
| 3 |
|
---|
| 4 | <para>
|
---|
| 5 | The Binutils package contains the ld, as, ar, nm, objcopy, objdump,
|
---|
| 6 | ranlib, size, strings, strip, c++filt, addr2line and nlmconv programs
|
---|
| 7 | </para>
|
---|
| 8 |
|
---|
| 9 | </sect2>
|
---|
| 10 |
|
---|
| 11 | <sect2><title>Description</title>
|
---|
| 12 |
|
---|
| 13 | <sect3><title>ld</title>
|
---|
| 14 |
|
---|
| 15 | <para>
|
---|
| 16 | ld combines a number of object and archive files, relocates their data
|
---|
| 17 | and ties up symbol references. Often the last step in building a new compiled
|
---|
| 18 | program to run is a call to ld.
|
---|
| 19 | </para>
|
---|
| 20 |
|
---|
| 21 | </sect3>
|
---|
| 22 |
|
---|
| 23 | <sect3><title>as</title>
|
---|
| 24 |
|
---|
| 25 | <para>
|
---|
| 26 | as is primarily intended to assemble the output of the GNU C compiler gcc
|
---|
| 27 | for use by the linker ld.
|
---|
| 28 | </para>
|
---|
| 29 |
|
---|
| 30 | </sect3>
|
---|
| 31 |
|
---|
| 32 | <sect3><title>ar</title>
|
---|
| 33 |
|
---|
| 34 | <para>
|
---|
| 35 | The ar program creates, modifies, and extracts from archives. An archive is
|
---|
| 36 | a single file holding a collection of other files in a structure that makes
|
---|
| 37 | it possible to retrieve the original individual files (called members of
|
---|
| 38 | the archive).
|
---|
| 39 | </para>
|
---|
| 40 |
|
---|
| 41 | </sect3>
|
---|
| 42 |
|
---|
| 43 | <sect3><title>nm</title>
|
---|
| 44 |
|
---|
| 45 | <para>
|
---|
| 46 | nm lists the symbols from object files.
|
---|
| 47 | </para>
|
---|
| 48 |
|
---|
| 49 | </sect3>
|
---|
| 50 |
|
---|
| 51 | <sect3><title>objcopy</title>
|
---|
| 52 |
|
---|
| 53 | <para>
|
---|
| 54 | objcopy utility copies the contents of an object file to another. objcopy
|
---|
| 55 | uses the GNU BFD Library to read and write the object files. It can write
|
---|
| 56 | the destination object file in a format different from that of the source
|
---|
| 57 | object file.
|
---|
| 58 | </para>
|
---|
| 59 |
|
---|
| 60 | </sect3>
|
---|
| 61 |
|
---|
| 62 | <sect3><title>objdump</title>
|
---|
| 63 |
|
---|
| 64 | <para>
|
---|
| 65 | objdump displays information about one or more object files. The options
|
---|
| 66 | control what particular information to display. This information is mostly
|
---|
| 67 | useful to programmers who are working on the compilation tools, as opposed to
|
---|
| 68 | programmers who just want their program to compile and work.
|
---|
| 69 | </para>
|
---|
| 70 |
|
---|
| 71 | </sect3>
|
---|
| 72 |
|
---|
| 73 | <sect3><title>ranlib</title>
|
---|
| 74 |
|
---|
| 75 | <para>
|
---|
| 76 | ranlib generates an index to the contents of an archive, and stores it in
|
---|
| 77 | the archive. The index lists each symbol defined by a member of an archive
|
---|
| 78 | that is a relocatable object file.
|
---|
| 79 | </para>
|
---|
| 80 |
|
---|
| 81 | </sect3>
|
---|
| 82 |
|
---|
| 83 | <sect3><title>size</title>
|
---|
| 84 |
|
---|
| 85 | <para>
|
---|
| 86 | size lists the section sizes --and the total size-- for each of the object
|
---|
| 87 | files objfile in its argument list. By default, one line of output is
|
---|
| 88 | generated for each object file or each module in an archive.
|
---|
| 89 | </para>
|
---|
| 90 |
|
---|
| 91 | </sect3>
|
---|
| 92 |
|
---|
| 93 | <sect3><title>strings</title>
|
---|
| 94 |
|
---|
| 95 | <para>
|
---|
| 96 | For each file given, strings prints the printable character sequences
|
---|
| 97 | that are at least 4 characters long (or the number specified with an
|
---|
| 98 | option to the program) and are followed by an unprintable character. By
|
---|
| 99 | default, it only prints the strings from the initialized and loaded
|
---|
| 100 | sections of object files; for other types of files, it prints the strings
|
---|
| 101 | from the whole file.
|
---|
| 102 | </para>
|
---|
| 103 |
|
---|
| 104 | <para>
|
---|
| 105 | strings is mainly useful for determining the contents of non-text files.
|
---|
| 106 | </para>
|
---|
| 107 |
|
---|
| 108 | </sect3>
|
---|
| 109 |
|
---|
| 110 | <sect3><title>strip</title>
|
---|
| 111 |
|
---|
| 112 | <para>
|
---|
| 113 | strip discards all or specific symbols from object files. The list of
|
---|
| 114 | object files may include archives. At least one object file must be
|
---|
| 115 | given. strip modifies the files named in its argument, rather than writing
|
---|
| 116 | modified copies under different names.
|
---|
| 117 | </para>
|
---|
| 118 |
|
---|
| 119 | </sect3>
|
---|
| 120 |
|
---|
| 121 | <sect3><title>c++filt</title>
|
---|
| 122 |
|
---|
| 123 | <para>
|
---|
| 124 | The C++ language provides function overloading, which means that you can
|
---|
| 125 | write many functions with the same name (providing each takes parameters
|
---|
| 126 | of different types). All C++ function names are encoded into a low-level
|
---|
| 127 | assembly label (this process is known as mangling). The c++filt program
|
---|
| 128 | does the inverse mapping: it decodes (demangles) low-level names into
|
---|
| 129 | user-level names so that the linker can keep these overloaded functions
|
---|
| 130 | from clashing.
|
---|
| 131 | </para>
|
---|
| 132 |
|
---|
| 133 | </sect3>
|
---|
| 134 |
|
---|
| 135 | <sect3><title>addr2line</title>
|
---|
| 136 |
|
---|
| 137 | <para>
|
---|
| 138 | addr2line translates program addresses into file names and line numbers.
|
---|
| 139 | Given an address and an executable, it uses the debugging information in
|
---|
| 140 | the executable to figure out which file name and line number are associated
|
---|
| 141 | with a given address.
|
---|
| 142 | </para>
|
---|
| 143 |
|
---|
| 144 | </sect3>
|
---|
| 145 |
|
---|
| 146 | <sect3><title>nlmconv</title>
|
---|
| 147 |
|
---|
| 148 | <para>
|
---|
| 149 | nlmconv converts relocatable object files into the NetWare Loadable Module
|
---|
| 150 | files, optionally reading header files for NLM header information.
|
---|
| 151 | </para>
|
---|
| 152 |
|
---|
| 153 | </sect3>
|
---|
| 154 |
|
---|
| 155 | </sect2>
|
---|
| 156 |
|
---|