diff --git a/gnu/usr.bin/binutils/addr2line/addr2line.1 b/gnu/usr.bin/binutils/addr2line/addr2line.1 index 4f76544fa352..7912ac06c0d4 100644 --- a/gnu/usr.bin/binutils/addr2line/addr2line.1 +++ b/gnu/usr.bin/binutils/addr2line/addr2line.1 @@ -1,266 +1,265 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ADDR2LINE 1" .TH ADDR2LINE 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" addr2line \- convert addresses into file names and line numbers .SH "SYNOPSIS" .IX Header "SYNOPSIS" addr2line [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR] [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR]] [\fB\-e\fR \fIfilename\fR|\fB\-\-exe=\fR\fIfilename\fR] [\fB\-f\fR|\fB\-\-functions\fR] [\fB\-s\fR|\fB\-\-basename\fR] [\fB\-i\fR|\fB\-\-inlines\fR] [\fB\-j\fR|\fB\-\-section=\fR\fIname\fR] [\fB\-H\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [addr addr ...] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBaddr2line\fR translates addresses into file names and line numbers. Given an address in an executable or an offset in a section of a relocatable object, it uses the debugging information to figure out which file name and line number are associated with it. .PP The executable or relocatable object to use is specified with the \fB\-e\fR option. The default is the file \fIa.out\fR. The section in the relocatable object to use is specified with the \fB\-j\fR option. .PP \&\fBaddr2line\fR has two modes of operation. .PP In the first, hexadecimal addresses are specified on the command line, and \fBaddr2line\fR displays the file name and line number for each address. .PP In the second, \fBaddr2line\fR reads hexadecimal addresses from standard input, and prints the file name and line number for each address on standard output. In this mode, \fBaddr2line\fR may be used in a pipe to convert dynamically chosen addresses. .PP The format of the output is \fB\s-1FILENAME:LINENO\s0\fR. The file name and line number for each address is printed on a separate line. If the \&\fB\-f\fR option is used, then each \fB\s-1FILENAME:LINENO\s0\fR line is preceded by a \fB\s-1FUNCTIONNAME\s0\fR line which is the name of the function containing the address. .PP If the file name or function name can not be determined, \&\fBaddr2line\fR will print two question marks in their place. If the line number can not be determined, \fBaddr2line\fR will print 0. .SH "OPTIONS" .IX Header "OPTIONS" The long and short forms of options, shown here as alternatives, are equivalent. .IP "\fB\-b\fR \fIbfdname\fR" 4 .IX Item "-b bfdname" .PD 0 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" .PD Specify that the object-code format for the object files is \&\fIbfdname\fR. .IP "\fB\-C\fR" 4 .IX Item "-C" .PD 0 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4 .IX Item "--demangle[=style]" .PD Decode (\fIdemangle\fR) low-level symbol names into user-level names. Besides removing any initial underscore prepended by the system, this makes \*(C+ function names readable. Different compilers have different mangling styles. The optional demangling style argument can be used to choose an appropriate demangling style for your compiler. .IP "\fB\-e\fR \fIfilename\fR" 4 .IX Item "-e filename" .PD 0 .IP "\fB\-\-exe=\fR\fIfilename\fR" 4 .IX Item "--exe=filename" .PD Specify the name of the executable for which addresses should be translated. The default file is \fIa.out\fR. .IP "\fB\-f\fR" 4 .IX Item "-f" .PD 0 .IP "\fB\-\-functions\fR" 4 .IX Item "--functions" .PD Display function names as well as file and line number information. .IP "\fB\-s\fR" 4 .IX Item "-s" .PD 0 .IP "\fB\-\-basenames\fR" 4 .IX Item "--basenames" .PD Display only the base of each file name. .IP "\fB\-i\fR" 4 .IX Item "-i" .PD 0 .IP "\fB\-\-inlines\fR" 4 .IX Item "--inlines" .PD If the address belongs to a function that was inlined, the source information for all enclosing scopes back to the first non-inlined function will also be printed. For example, if \f(CW\*(C`main\*(C'\fR inlines \&\f(CW\*(C`callee1\*(C'\fR which inlines \f(CW\*(C`callee2\*(C'\fR, and address is from \&\f(CW\*(C`callee2\*(C'\fR, the source information for \f(CW\*(C`callee1\*(C'\fR and \f(CW\*(C`main\*(C'\fR will also be printed. .IP "\fB\-j\fR" 4 .IX Item "-j" .PD 0 .IP "\fB\-\-section\fR" 4 .IX Item "--section" .PD Read offsets relative to the specified section instead of absolute addresses. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". diff --git a/gnu/usr.bin/binutils/nm/nm.1 b/gnu/usr.bin/binutils/nm/nm.1 index e94e472f21aa..68b5098902f9 100644 --- a/gnu/usr.bin/binutils/nm/nm.1 +++ b/gnu/usr.bin/binutils/nm/nm.1 @@ -1,450 +1,449 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "NM 1" .TH NM 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" nm \- list symbols from object files .SH "SYNOPSIS" .IX Header "SYNOPSIS" nm [\fB\-a\fR|\fB\-\-debug\-syms\fR] [\fB\-g\fR|\fB\-\-extern\-only\fR] [\fB\-B\fR] [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR]] [\fB\-D\fR|\fB\-\-dynamic\fR] [\fB\-S\fR|\fB\-\-print\-size\fR] [\fB\-s\fR|\fB\-\-print\-armap\fR] [\fB\-A\fR|\fB\-o\fR|\fB\-\-print\-file\-name\fR][\fB\-\-special\-syms\fR] [\fB\-n\fR|\fB\-v\fR|\fB\-\-numeric\-sort\fR] [\fB\-p\fR|\fB\-\-no\-sort\fR] [\fB\-r\fR|\fB\-\-reverse\-sort\fR] [\fB\-\-size\-sort\fR] [\fB\-u\fR|\fB\-\-undefined\-only\fR] [\fB\-t\fR \fIradix\fR|\fB\-\-radix=\fR\fIradix\fR] [\fB\-P\fR|\fB\-\-portability\fR] [\fB\-\-target=\fR\fIbfdname\fR] [\fB\-f\fR\fIformat\fR|\fB\-\-format=\fR\fIformat\fR] [\fB\-\-defined\-only\fR] [\fB\-l\fR|\fB\-\-line\-numbers\fR] [\fB\-\-no\-demangle\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fB\-X 32_64\fR] [\fB\-\-help\fR] [\fIobjfile\fR...] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\s-1GNU\s0 \fBnm\fR lists the symbols from object files \fIobjfile\fR.... If no object files are listed as arguments, \fBnm\fR assumes the file \&\fIa.out\fR. .PP For each symbol, \fBnm\fR shows: .IP "\(bu" 4 The symbol value, in the radix selected by options (see below), or hexadecimal by default. .IP "\(bu" 4 The symbol type. At least the following types are used; others are, as well, depending on the object file format. If lowercase, the symbol is local; if uppercase, the symbol is global (external). .RS 4 .ie n .IP """A""" 4 .el .IP "\f(CWA\fR" 4 .IX Item "A" The symbol's value is absolute, and will not be changed by further linking. .ie n .IP """B""" 4 .el .IP "\f(CWB\fR" 4 .IX Item "B" The symbol is in the uninitialized data section (known as \s-1BSS\s0). .ie n .IP """C""" 4 .el .IP "\f(CWC\fR" 4 .IX Item "C" The symbol is common. Common symbols are uninitialized data. When linking, multiple common symbols may appear with the same name. If the symbol is defined anywhere, the common symbols are treated as undefined references. .ie n .IP """D""" 4 .el .IP "\f(CWD\fR" 4 .IX Item "D" The symbol is in the initialized data section. .ie n .IP """G""" 4 .el .IP "\f(CWG\fR" 4 .IX Item "G" The symbol is in an initialized data section for small objects. Some object file formats permit more efficient access to small data objects, such as a global int variable as opposed to a large global array. .ie n .IP """I""" 4 .el .IP "\f(CWI\fR" 4 .IX Item "I" The symbol is an indirect reference to another symbol. This is a \s-1GNU\s0 extension to the a.out object file format which is rarely used. .ie n .IP """N""" 4 .el .IP "\f(CWN\fR" 4 .IX Item "N" The symbol is a debugging symbol. .ie n .IP """R""" 4 .el .IP "\f(CWR\fR" 4 .IX Item "R" The symbol is in a read only data section. .ie n .IP """S""" 4 .el .IP "\f(CWS\fR" 4 .IX Item "S" The symbol is in an uninitialized data section for small objects. .ie n .IP """T""" 4 .el .IP "\f(CWT\fR" 4 .IX Item "T" The symbol is in the text (code) section. .ie n .IP """U""" 4 .el .IP "\f(CWU\fR" 4 .IX Item "U" The symbol is undefined. .ie n .IP """V""" 4 .el .IP "\f(CWV\fR" 4 .IX Item "V" The symbol is a weak object. When a weak defined symbol is linked with a normal defined symbol, the normal defined symbol is used with no error. When a weak undefined symbol is linked and the symbol is not defined, the value of the weak symbol becomes zero with no error. .ie n .IP """W""" 4 .el .IP "\f(CWW\fR" 4 .IX Item "W" The symbol is a weak symbol that has not been specifically tagged as a weak object symbol. When a weak defined symbol is linked with a normal defined symbol, the normal defined symbol is used with no error. When a weak undefined symbol is linked and the symbol is not defined, the value of the symbol is determined in a system-specific manner without error. On some systems, uppercase indicates that a default value has been specified. .ie n .IP """\-""" 4 .el .IP "\f(CW\-\fR" 4 .IX Item "-" 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. .ie n .IP """?""" 4 .el .IP "\f(CW?\fR" 4 .IX Item "?" The symbol type is unknown, or object file format specific. .RE .RS 4 .RE .IP "\(bu" 4 The symbol name. .SH "OPTIONS" .IX Header "OPTIONS" The long and short forms of options, shown here as alternatives, are equivalent. .IP "\fB\-A\fR" 4 .IX Item "-A" .PD 0 .IP "\fB\-o\fR" 4 .IX Item "-o" .IP "\fB\-\-print\-file\-name\fR" 4 .IX Item "--print-file-name" .PD Precede each symbol by the name of the input file (or archive member) in which it was found, rather than identifying the input file once only, before all of its symbols. .IP "\fB\-a\fR" 4 .IX Item "-a" .PD 0 .IP "\fB\-\-debug\-syms\fR" 4 .IX Item "--debug-syms" .PD Display all symbols, even debugger-only symbols; normally these are not listed. .IP "\fB\-B\fR" 4 .IX Item "-B" The same as \fB\-\-format=bsd\fR (for compatibility with the \s-1MIPS\s0 \fBnm\fR). .IP "\fB\-C\fR" 4 .IX Item "-C" .PD 0 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4 .IX Item "--demangle[=style]" .PD Decode (\fIdemangle\fR) low-level symbol names into user-level names. Besides removing any initial underscore prepended by the system, this makes \*(C+ function names readable. Different compilers have different mangling styles. The optional demangling style argument can be used to choose an appropriate demangling style for your compiler. .IP "\fB\-\-no\-demangle\fR" 4 .IX Item "--no-demangle" Do not demangle low-level symbol names. This is the default. .IP "\fB\-D\fR" 4 .IX Item "-D" .PD 0 .IP "\fB\-\-dynamic\fR" 4 .IX Item "--dynamic" .PD Display the dynamic symbols rather than the normal symbols. This is only meaningful for dynamic objects, such as certain types of shared libraries. .IP "\fB\-f\fR \fIformat\fR" 4 .IX Item "-f format" .PD 0 .IP "\fB\-\-format=\fR\fIformat\fR" 4 .IX Item "--format=format" .PD Use the output format \fIformat\fR, which can be \f(CW\*(C`bsd\*(C'\fR, \&\f(CW\*(C`sysv\*(C'\fR, or \f(CW\*(C`posix\*(C'\fR. The default is \f(CW\*(C`bsd\*(C'\fR. Only the first character of \fIformat\fR is significant; it can be either upper or lower case. .IP "\fB\-g\fR" 4 .IX Item "-g" .PD 0 .IP "\fB\-\-extern\-only\fR" 4 .IX Item "--extern-only" .PD Display only external symbols. .IP "\fB\-l\fR" 4 .IX Item "-l" .PD 0 .IP "\fB\-\-line\-numbers\fR" 4 .IX Item "--line-numbers" .PD For each symbol, use debugging information to try to find a filename and line number. For a defined symbol, look for the line number of the address of the symbol. For an undefined symbol, look for the line number of a relocation entry which refers to the symbol. If line number information can be found, print it after the other symbol information. .IP "\fB\-n\fR" 4 .IX Item "-n" .PD 0 .IP "\fB\-v\fR" 4 .IX Item "-v" .IP "\fB\-\-numeric\-sort\fR" 4 .IX Item "--numeric-sort" .PD Sort symbols numerically by their addresses, rather than alphabetically by their names. .IP "\fB\-p\fR" 4 .IX Item "-p" .PD 0 .IP "\fB\-\-no\-sort\fR" 4 .IX Item "--no-sort" .PD Do not bother to sort the symbols in any order; print them in the order encountered. .IP "\fB\-P\fR" 4 .IX Item "-P" .PD 0 .IP "\fB\-\-portability\fR" 4 .IX Item "--portability" .PD Use the \s-1POSIX\s0.2 standard output format instead of the default format. Equivalent to \fB\-f posix\fR. .IP "\fB\-S\fR" 4 .IX Item "-S" .PD 0 .IP "\fB\-\-print\-size\fR" 4 .IX Item "--print-size" .PD Print size, not the value, of defined symbols for the \f(CW\*(C`bsd\*(C'\fR output format. .IP "\fB\-s\fR" 4 .IX Item "-s" .PD 0 .IP "\fB\-\-print\-armap\fR" 4 .IX Item "--print-armap" .PD When listing symbols from archive members, include the index: a mapping (stored in the archive by \fBar\fR or \fBranlib\fR) of which modules contain definitions for which names. .IP "\fB\-r\fR" 4 .IX Item "-r" .PD 0 .IP "\fB\-\-reverse\-sort\fR" 4 .IX Item "--reverse-sort" .PD Reverse the order of the sort (whether numeric or alphabetic); let the last come first. .IP "\fB\-\-size\-sort\fR" 4 .IX Item "--size-sort" Sort symbols by size. The size is computed as the difference between the value of the symbol and the value of the symbol with the next higher value. If the \f(CW\*(C`bsd\*(C'\fR output format is used the size of the symbol is printed, rather than the value, and \fB\-S\fR must be used in order both size and value to be printed. .IP "\fB\-\-special\-syms\fR" 4 .IX Item "--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 \s-1ARM\s0 targets this option would skip the mapping symbols used to mark transitions between \s-1ARM\s0 code, \s-1THUMB\s0 code and data. .IP "\fB\-t\fR \fIradix\fR" 4 .IX Item "-t radix" .PD 0 .IP "\fB\-\-radix=\fR\fIradix\fR" 4 .IX Item "--radix=radix" .PD Use \fIradix\fR as the radix for printing the symbol values. It must be \&\fBd\fR for decimal, \fBo\fR for octal, or \fBx\fR for hexadecimal. .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" Specify an object code format other than your system's default format. .IP "\fB\-u\fR" 4 .IX Item "-u" .PD 0 .IP "\fB\-\-undefined\-only\fR" 4 .IX Item "--undefined-only" .PD Display only undefined symbols (those external to each object file). .IP "\fB\-\-defined\-only\fR" 4 .IX Item "--defined-only" Display only defined symbols for each object file. .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Show the version number of \fBnm\fR and exit. .IP "\fB\-X\fR" 4 .IX Item "-X" This option is ignored for compatibility with the \s-1AIX\s0 version of \&\fBnm\fR. It takes one parameter which must be the string \&\fB32_64\fR. The default mode of \s-1AIX\s0 \fBnm\fR corresponds to \fB\-X 32\fR, which is not supported by \s-1GNU\s0 \fBnm\fR. .IP "\fB\-\-help\fR" 4 .IX Item "--help" Show a summary of the options to \fBnm\fR and exit. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". diff --git a/gnu/usr.bin/binutils/objcopy/objcopy.1 b/gnu/usr.bin/binutils/objcopy/objcopy.1 index 66f051d3b86f..11baf43d8e3a 100644 --- a/gnu/usr.bin/binutils/objcopy/objcopy.1 +++ b/gnu/usr.bin/binutils/objcopy/objcopy.1 @@ -1,858 +1,857 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "OBJCOPY 1" .TH OBJCOPY 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" objcopy \- copy and translate object files .SH "SYNOPSIS" .IX Header "SYNOPSIS" objcopy [\fB\-F\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR] [\fB\-I\fR \fIbfdname\fR|\fB\-\-input\-target=\fR\fIbfdname\fR] [\fB\-O\fR \fIbfdname\fR|\fB\-\-output\-target=\fR\fIbfdname\fR] [\fB\-B\fR \fIbfdarch\fR|\fB\-\-binary\-architecture=\fR\fIbfdarch\fR] [\fB\-S\fR|\fB\-\-strip\-all\fR] [\fB\-g\fR|\fB\-\-strip\-debug\fR] [\fB\-K\fR \fIsymbolname\fR|\fB\-\-keep\-symbol=\fR\fIsymbolname\fR] [\fB\-N\fR \fIsymbolname\fR|\fB\-\-strip\-symbol=\fR\fIsymbolname\fR] [\fB\-\-strip\-unneeded\-symbol=\fR\fIsymbolname\fR] [\fB\-G\fR \fIsymbolname\fR|\fB\-\-keep\-global\-symbol=\fR\fIsymbolname\fR] [\fB\-\-localize\-hidden\fR] [\fB\-L\fR \fIsymbolname\fR|\fB\-\-localize\-symbol=\fR\fIsymbolname\fR] [\fB\-\-globalize\-symbol=\fR\fIsymbolname\fR] [\fB\-W\fR \fIsymbolname\fR|\fB\-\-weaken\-symbol=\fR\fIsymbolname\fR] [\fB\-w\fR|\fB\-\-wildcard\fR] [\fB\-x\fR|\fB\-\-discard\-all\fR] [\fB\-X\fR|\fB\-\-discard\-locals\fR] [\fB\-b\fR \fIbyte\fR|\fB\-\-byte=\fR\fIbyte\fR] [\fB\-i\fR \fIinterleave\fR|\fB\-\-interleave=\fR\fIinterleave\fR] [\fB\-j\fR \fIsectionname\fR|\fB\-\-only\-section=\fR\fIsectionname\fR] [\fB\-R\fR \fIsectionname\fR|\fB\-\-remove\-section=\fR\fIsectionname\fR] [\fB\-p\fR|\fB\-\-preserve\-dates\fR] [\fB\-\-debugging\fR] [\fB\-\-gap\-fill=\fR\fIval\fR] [\fB\-\-pad\-to=\fR\fIaddress\fR] [\fB\-\-set\-start=\fR\fIval\fR] [\fB\-\-adjust\-start=\fR\fIincr\fR] [\fB\-\-change\-addresses=\fR\fIincr\fR] [\fB\-\-change\-section\-address\fR \fIsection\fR{=,+,\-}\fIval\fR] [\fB\-\-change\-section\-lma\fR \fIsection\fR{=,+,\-}\fIval\fR] [\fB\-\-change\-section\-vma\fR \fIsection\fR{=,+,\-}\fIval\fR] [\fB\-\-change\-warnings\fR] [\fB\-\-no\-change\-warnings\fR] [\fB\-\-set\-section\-flags\fR \fIsection\fR=\fIflags\fR] [\fB\-\-add\-section\fR \fIsectionname\fR=\fIfilename\fR] [\fB\-\-rename\-section\fR \fIoldname\fR=\fInewname\fR[,\fIflags\fR]] [\fB\-\-change\-leading\-char\fR] [\fB\-\-remove\-leading\-char\fR] [\fB\-\-reverse\-bytes=\fR\fInum\fR] [\fB\-\-srec\-len=\fR\fIival\fR] [\fB\-\-srec\-forceS3\fR] [\fB\-\-redefine\-sym\fR \fIold\fR=\fInew\fR] [\fB\-\-redefine\-syms=\fR\fIfilename\fR] [\fB\-\-weaken\fR] [\fB\-\-keep\-symbols=\fR\fIfilename\fR] [\fB\-\-strip\-symbols=\fR\fIfilename\fR] [\fB\-\-strip\-unneeded\-symbols=\fR\fIfilename\fR] [\fB\-\-keep\-global\-symbols=\fR\fIfilename\fR] [\fB\-\-localize\-symbols=\fR\fIfilename\fR] [\fB\-\-globalize\-symbols=\fR\fIfilename\fR] [\fB\-\-weaken\-symbols=\fR\fIfilename\fR] [\fB\-\-alt\-machine\-code=\fR\fIindex\fR] [\fB\-\-prefix\-symbols=\fR\fIstring\fR] [\fB\-\-prefix\-sections=\fR\fIstring\fR] [\fB\-\-prefix\-alloc\-sections=\fR\fIstring\fR] [\fB\-\-add\-gnu\-debuglink=\fR\fIpath-to-file\fR] [\fB\-\-keep\-file\-symbols\fR] [\fB\-\-only\-keep\-debug\fR] [\fB\-\-extract\-symbol\fR] [\fB\-\-writable\-text\fR] [\fB\-\-readonly\-text\fR] [\fB\-\-pure\fR] [\fB\-\-impure\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fB\-\-help\fR] [\fB\-\-info\fR] \fIinfile\fR [\fIoutfile\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \s-1GNU\s0 \fBobjcopy\fR utility copies the contents of an object file to another. \fBobjcopy\fR uses the \s-1GNU\s0 \s-1BFD\s0 Library to read and write the object files. It can write the destination object file in a format different from that of the source object file. The exact behavior of \fBobjcopy\fR is controlled by command-line options. Note that \fBobjcopy\fR should be able to copy a fully linked file between any two formats. However, copying a relocatable object file between any two formats may not work as expected. .PP \&\fBobjcopy\fR creates temporary files to do its translations and deletes them afterward. \fBobjcopy\fR uses \s-1BFD\s0 to do all its translation work; it has access to all the formats described in \s-1BFD\s0 and thus is able to recognize most formats without being told explicitly. .PP \&\fBobjcopy\fR can be used to generate S\-records by using an output target of \fBsrec\fR (e.g., use \fB\-O srec\fR). .PP \&\fBobjcopy\fR can be used to generate a raw binary file by using an output target of \fBbinary\fR (e.g., use \fB\-O binary\fR). When \&\fBobjcopy\fR generates a raw binary file, it will essentially produce a memory dump of the contents of the input object file. All symbols and relocation information will be discarded. The memory dump will start at the load address of the lowest section copied into the output file. .PP When generating an S\-record or a raw binary file, it may be helpful to use \fB\-S\fR to remove sections containing debugging information. In some cases \fB\-R\fR will be useful to remove sections which contain information that is not needed by the binary file. .PP Note\-\-\-\fBobjcopy\fR is not able to change the endianness of its input files. If the input format has an endianness (some formats do not), \&\fBobjcopy\fR can only copy the inputs into file formats that have the same endianness or which have no endianness (e.g., \fBsrec\fR). (However, see the \fB\-\-reverse\-bytes\fR option.) .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fIinfile\fR" 4 .IX Item "infile" .PD 0 .IP "\fIoutfile\fR" 4 .IX Item "outfile" .PD The input and output files, respectively. If you do not specify \fIoutfile\fR, \fBobjcopy\fR creates a temporary file and destructively renames the result with the name of \fIinfile\fR. .IP "\fB\-I\fR \fIbfdname\fR" 4 .IX Item "-I bfdname" .PD 0 .IP "\fB\-\-input\-target=\fR\fIbfdname\fR" 4 .IX Item "--input-target=bfdname" .PD Consider the source file's object format to be \fIbfdname\fR, rather than attempting to deduce it. .IP "\fB\-O\fR \fIbfdname\fR" 4 .IX Item "-O bfdname" .PD 0 .IP "\fB\-\-output\-target=\fR\fIbfdname\fR" 4 .IX Item "--output-target=bfdname" .PD Write the output file using the object format \fIbfdname\fR. .IP "\fB\-F\fR \fIbfdname\fR" 4 .IX Item "-F bfdname" .PD 0 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" .PD Use \fIbfdname\fR as the object format for both the input and the output file; i.e., simply transfer data from source to destination with no translation. .IP "\fB\-B\fR \fIbfdarch\fR" 4 .IX Item "-B bfdarch" .PD 0 .IP "\fB\-\-binary\-architecture=\fR\fIbfdarch\fR" 4 .IX Item "--binary-architecture=bfdarch" .PD Useful when transforming a raw binary input file into an object file. In this case the output architecture can be set to \fIbfdarch\fR. This option will be ignored if the input file has a known \fIbfdarch\fR. You can access this binary data inside a program by referencing the special symbols that are created by the conversion process. These symbols are called _binary_\fIobjfile\fR_start, _binary_\fIobjfile\fR_end and _binary_\fIobjfile\fR_size. e.g. you can transform a picture file into an object file and then access it in your code using these symbols. .IP "\fB\-j\fR \fIsectionname\fR" 4 .IX Item "-j sectionname" .PD 0 .IP "\fB\-\-only\-section=\fR\fIsectionname\fR" 4 .IX Item "--only-section=sectionname" .PD Copy only the named section from the input file to the output file. This option may be given more than once. Note that using this option inappropriately may make the output file unusable. .IP "\fB\-R\fR \fIsectionname\fR" 4 .IX Item "-R sectionname" .PD 0 .IP "\fB\-\-remove\-section=\fR\fIsectionname\fR" 4 .IX Item "--remove-section=sectionname" .PD Remove any section named \fIsectionname\fR from the output file. This option may be given more than once. Note that using this option inappropriately may make the output file unusable. .IP "\fB\-S\fR" 4 .IX Item "-S" .PD 0 .IP "\fB\-\-strip\-all\fR" 4 .IX Item "--strip-all" .PD Do not copy relocation and symbol information from the source file. .IP "\fB\-g\fR" 4 .IX Item "-g" .PD 0 .IP "\fB\-\-strip\-debug\fR" 4 .IX Item "--strip-debug" .PD Do not copy debugging symbols or sections from the source file. .IP "\fB\-\-strip\-unneeded\fR" 4 .IX Item "--strip-unneeded" Strip all symbols that are not needed for relocation processing. .IP "\fB\-K\fR \fIsymbolname\fR" 4 .IX Item "-K symbolname" .PD 0 .IP "\fB\-\-keep\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--keep-symbol=symbolname" .PD When stripping symbols, keep symbol \fIsymbolname\fR even if it would normally be stripped. This option may be given more than once. .IP "\fB\-N\fR \fIsymbolname\fR" 4 .IX Item "-N symbolname" .PD 0 .IP "\fB\-\-strip\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--strip-symbol=symbolname" .PD Do not copy symbol \fIsymbolname\fR from the source file. This option may be given more than once. .IP "\fB\-\-strip\-unneeded\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--strip-unneeded-symbol=symbolname" Do not copy symbol \fIsymbolname\fR from the source file unless it is needed by a relocation. This option may be given more than once. .IP "\fB\-G\fR \fIsymbolname\fR" 4 .IX Item "-G symbolname" .PD 0 .IP "\fB\-\-keep\-global\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--keep-global-symbol=symbolname" .PD Keep only symbol \fIsymbolname\fR global. Make all other symbols local to the file, so that they are not visible externally. This option may be given more than once. .IP "\fB\-\-localize\-hidden\fR" 4 .IX Item "--localize-hidden" In an \s-1ELF\s0 object, mark all symbols that have hidden or internal visibility as local. This option applies on top of symbol-specific localization options such as \fB\-L\fR. .IP "\fB\-L\fR \fIsymbolname\fR" 4 .IX Item "-L symbolname" .PD 0 .IP "\fB\-\-localize\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--localize-symbol=symbolname" .PD Make symbol \fIsymbolname\fR local to the file, so that it is not visible externally. This option may be given more than once. .IP "\fB\-W\fR \fIsymbolname\fR" 4 .IX Item "-W symbolname" .PD 0 .IP "\fB\-\-weaken\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--weaken-symbol=symbolname" .PD Make symbol \fIsymbolname\fR weak. This option may be given more than once. .IP "\fB\-\-globalize\-symbol=\fR\fIsymbolname\fR" 4 .IX Item "--globalize-symbol=symbolname" Give symbol \fIsymbolname\fR global scoping so that it is visible outside of the file in which it is defined. This option may be given more than once. .IP "\fB\-w\fR" 4 .IX Item "-w" .PD 0 .IP "\fB\-\-wildcard\fR" 4 .IX Item "--wildcard" .PD Permit regular expressions in \fIsymbolname\fRs used in other command line options. The question mark (?), asterisk (*), backslash (\e) and square brackets ([]) operators can be used anywhere in the symbol name. If the first character of the symbol name is the exclamation point (!) then the sense of the switch is reversed for that symbol. For example: .Sp .Vb 1 \& \-w \-W !foo \-W fo* .Ve .Sp would cause objcopy to weaken all symbols that start with \*(L"fo\*(R" except for the symbol \*(L"foo\*(R". .IP "\fB\-x\fR" 4 .IX Item "-x" .PD 0 .IP "\fB\-\-discard\-all\fR" 4 .IX Item "--discard-all" .PD Do not copy non-global symbols from the source file. .IP "\fB\-X\fR" 4 .IX Item "-X" .PD 0 .IP "\fB\-\-discard\-locals\fR" 4 .IX Item "--discard-locals" .PD Do not copy compiler-generated local symbols. (These usually start with \fBL\fR or \fB.\fR.) .IP "\fB\-b\fR \fIbyte\fR" 4 .IX Item "-b byte" .PD 0 .IP "\fB\-\-byte=\fR\fIbyte\fR" 4 .IX Item "--byte=byte" .PD Keep only every \fIbyte\fRth byte of the input file (header data is not affected). \fIbyte\fR can be in the range from 0 to \fIinterleave\fR\-1, where \fIinterleave\fR is given by the \fB\-i\fR or \fB\-\-interleave\fR option, or the default of 4. This option is useful for creating files to program \s-1ROM\s0. It is typically used with an \f(CW\*(C`srec\*(C'\fR output target. .IP "\fB\-i\fR \fIinterleave\fR" 4 .IX Item "-i interleave" .PD 0 .IP "\fB\-\-interleave=\fR\fIinterleave\fR" 4 .IX Item "--interleave=interleave" .PD Only copy one out of every \fIinterleave\fR bytes. Select which byte to copy with the \fB\-b\fR or \fB\-\-byte\fR option. The default is 4. \&\fBobjcopy\fR ignores this option if you do not specify either \fB\-b\fR or \&\fB\-\-byte\fR. .IP "\fB\-p\fR" 4 .IX Item "-p" .PD 0 .IP "\fB\-\-preserve\-dates\fR" 4 .IX Item "--preserve-dates" .PD Set the access and modification dates of the output file to be the same as those of the input file. .IP "\fB\-\-debugging\fR" 4 .IX Item "--debugging" Convert debugging information, if possible. This is not the default because only certain debugging formats are supported, and the conversion process can be time consuming. .IP "\fB\-\-gap\-fill\fR \fIval\fR" 4 .IX Item "--gap-fill val" Fill gaps between sections with \fIval\fR. This operation applies to the \fIload address\fR (\s-1LMA\s0) of the sections. It is done by increasing the size of the section with the lower address, and filling in the extra space created with \fIval\fR. .IP "\fB\-\-pad\-to\fR \fIaddress\fR" 4 .IX Item "--pad-to address" Pad the output file up to the load address \fIaddress\fR. This is done by increasing the size of the last section. The extra space is filled in with the value specified by \fB\-\-gap\-fill\fR (default zero). .IP "\fB\-\-set\-start\fR \fIval\fR" 4 .IX Item "--set-start val" Set the start address of the new file to \fIval\fR. Not all object file formats support setting the start address. .IP "\fB\-\-change\-start\fR \fIincr\fR" 4 .IX Item "--change-start incr" .PD 0 .IP "\fB\-\-adjust\-start\fR \fIincr\fR" 4 .IX Item "--adjust-start incr" .PD Change the start address by adding \fIincr\fR. Not all object file formats support setting the start address. .IP "\fB\-\-change\-addresses\fR \fIincr\fR" 4 .IX Item "--change-addresses incr" .PD 0 .IP "\fB\-\-adjust\-vma\fR \fIincr\fR" 4 .IX Item "--adjust-vma incr" .PD Change the \s-1VMA\s0 and \s-1LMA\s0 addresses of all sections, as well as the start address, by adding \fIincr\fR. Some object file formats do not permit section addresses to be changed arbitrarily. Note that this does not relocate the sections; if the program expects sections to be loaded at a certain address, and this option is used to change the sections such that they are loaded at a different address, the program may fail. .IP "\fB\-\-change\-section\-address\fR \fIsection\fR\fB{=,+,\-}\fR\fIval\fR" 4 .IX Item "--change-section-address section{=,+,-}val" .PD 0 .IP "\fB\-\-adjust\-section\-vma\fR \fIsection\fR\fB{=,+,\-}\fR\fIval\fR" 4 .IX Item "--adjust-section-vma section{=,+,-}val" .PD Set or change both the \s-1VMA\s0 address and the \s-1LMA\s0 address of the named \&\fIsection\fR. If \fB=\fR is used, the section address is set to \&\fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the section address. See the comments under \fB\-\-change\-addresses\fR, above. If \fIsection\fR does not exist in the input file, a warning will be issued, unless \fB\-\-no\-change\-warnings\fR is used. .IP "\fB\-\-change\-section\-lma\fR \fIsection\fR\fB{=,+,\-}\fR\fIval\fR" 4 .IX Item "--change-section-lma section{=,+,-}val" Set or change the \s-1LMA\s0 address of the named \fIsection\fR. The \s-1LMA\s0 address is the address where the section will be loaded into memory at program load time. Normally this is the same as the \s-1VMA\s0 address, which is the address of the section at program run time, but on some systems, especially those where a program is held in \s-1ROM\s0, the two can be different. If \fB=\fR is used, the section address is set to \&\fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the section address. See the comments under \fB\-\-change\-addresses\fR, above. If \fIsection\fR does not exist in the input file, a warning will be issued, unless \fB\-\-no\-change\-warnings\fR is used. .IP "\fB\-\-change\-section\-vma\fR \fIsection\fR\fB{=,+,\-}\fR\fIval\fR" 4 .IX Item "--change-section-vma section{=,+,-}val" Set or change the \s-1VMA\s0 address of the named \fIsection\fR. The \s-1VMA\s0 address is the address where the section will be located once the program has started executing. Normally this is the same as the \s-1LMA\s0 address, which is the address where the section will be loaded into memory, but on some systems, especially those where a program is held in \&\s-1ROM\s0, the two can be different. If \fB=\fR is used, the section address is set to \fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the section address. See the comments under \&\fB\-\-change\-addresses\fR, above. If \fIsection\fR does not exist in the input file, a warning will be issued, unless \&\fB\-\-no\-change\-warnings\fR is used. .IP "\fB\-\-change\-warnings\fR" 4 .IX Item "--change-warnings" .PD 0 .IP "\fB\-\-adjust\-warnings\fR" 4 .IX Item "--adjust-warnings" .PD If \fB\-\-change\-section\-address\fR or \fB\-\-change\-section\-lma\fR or \&\fB\-\-change\-section\-vma\fR is used, and the named section does not exist, issue a warning. This is the default. .IP "\fB\-\-no\-change\-warnings\fR" 4 .IX Item "--no-change-warnings" .PD 0 .IP "\fB\-\-no\-adjust\-warnings\fR" 4 .IX Item "--no-adjust-warnings" .PD Do not issue a warning if \fB\-\-change\-section\-address\fR or \&\fB\-\-adjust\-section\-lma\fR or \fB\-\-adjust\-section\-vma\fR is used, even if the named section does not exist. .IP "\fB\-\-set\-section\-flags\fR \fIsection\fR\fB=\fR\fIflags\fR" 4 .IX Item "--set-section-flags section=flags" Set the flags for the named section. The \fIflags\fR argument is a comma separated string of flag names. The recognized names are \&\fBalloc\fR, \fBcontents\fR, \fBload\fR, \fBnoload\fR, \&\fBreadonly\fR, \fBcode\fR, \fBdata\fR, \fBrom\fR, \fBshare\fR, and \&\fBdebug\fR. You can set the \fBcontents\fR flag for a section which does not have contents, but it is not meaningful to clear the \&\fBcontents\fR flag of a section which does have contents\*(--just remove the section instead. Not all flags are meaningful for all object file formats. .IP "\fB\-\-add\-section\fR \fIsectionname\fR\fB=\fR\fIfilename\fR" 4 .IX Item "--add-section sectionname=filename" Add a new section named \fIsectionname\fR while copying the file. The contents of the new section are taken from the file \fIfilename\fR. The size of the section will be the size of the file. This option only works on file formats which can support sections with arbitrary names. .IP "\fB\-\-rename\-section\fR \fIoldname\fR\fB=\fR\fInewname\fR\fB[,\fR\fIflags\fR\fB]\fR" 4 .IX Item "--rename-section oldname=newname[,flags]" Rename a section from \fIoldname\fR to \fInewname\fR, optionally changing the section's flags to \fIflags\fR in the process. This has the advantage over usng a linker script to perform the rename in that the output stays as an object file and does not become a linked executable. .Sp This option is particularly helpful when the input format is binary, since this will always create a section called .data. If for example, you wanted instead to create a section called .rodata containing binary data you could use the following command line to achieve it: .Sp .Vb 3 \& objcopy \-I binary \-O \-B \e \& \-\-rename\-section .data=.rodata,alloc,load,readonly,data,contents \e \& .Ve .IP "\fB\-\-change\-leading\-char\fR" 4 .IX Item "--change-leading-char" Some object file formats use special characters at the start of symbols. The most common such character is underscore, which compilers often add before every symbol. This option tells \fBobjcopy\fR to change the leading character of every symbol when it converts between object file formats. If the object file formats use the same leading character, this option has no effect. Otherwise, it will add a character, or remove a character, or change a character, as appropriate. .IP "\fB\-\-remove\-leading\-char\fR" 4 .IX Item "--remove-leading-char" If the first character of a global symbol is a special symbol leading character used by the object file format, remove the character. The most common symbol leading character is underscore. This option will remove a leading underscore from all global symbols. This can be useful if you want to link together objects of different file formats with different conventions for symbol names. This is different from \&\fB\-\-change\-leading\-char\fR because it always changes the symbol name when appropriate, regardless of the object file format of the output file. .IP "\fB\-\-reverse\-bytes=\fR\fInum\fR" 4 .IX Item "--reverse-bytes=num" Reverse the bytes in a section with output contents. A section length must be evenly divisible by the value given in order for the swap to be able to take place. Reversing takes place before the interleaving is performed. .Sp This option is used typically in generating \s-1ROM\s0 images for problematic target systems. For example, on some target boards, the 32\-bit words fetched from 8\-bit ROMs are re-assembled in little-endian byte order regardless of the \s-1CPU\s0 byte order. Depending on the programming model, the endianness of the \s-1ROM\s0 may need to be modified. .Sp Consider a simple file with a section containing the following eight bytes: \f(CW12345678\fR. .Sp Using \fB\-\-reverse\-bytes=2\fR for the above example, the bytes in the output file would be ordered \f(CW21436587\fR. .Sp Using \fB\-\-reverse\-bytes=4\fR for the above example, the bytes in the output file would be ordered \f(CW43218765\fR. .Sp By using \fB\-\-reverse\-bytes=2\fR for the above example, followed by \&\fB\-\-reverse\-bytes=4\fR on the output file, the bytes in the second output file would be ordered \f(CW34127856\fR. .IP "\fB\-\-srec\-len=\fR\fIival\fR" 4 .IX Item "--srec-len=ival" Meaningful only for srec output. Set the maximum length of the Srecords being produced to \fIival\fR. This length covers both address, data and crc fields. .IP "\fB\-\-srec\-forceS3\fR" 4 .IX Item "--srec-forceS3" Meaningful only for srec output. Avoid generation of S1/S2 records, creating S3\-only record format. .IP "\fB\-\-redefine\-sym\fR \fIold\fR\fB=\fR\fInew\fR" 4 .IX Item "--redefine-sym old=new" Change the name of a symbol \fIold\fR, to \fInew\fR. This can be useful when one is trying link two things together for which you have no source, and there are name collisions. .IP "\fB\-\-redefine\-syms=\fR\fIfilename\fR" 4 .IX Item "--redefine-syms=filename" Apply \fB\-\-redefine\-sym\fR to each symbol pair "\fIold\fR \fInew\fR" listed in the file \fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol pair per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-weaken\fR" 4 .IX Item "--weaken" Change all global symbols in the file to be weak. This can be useful when building an object which will be linked against other objects using the \fB\-R\fR option to the linker. This option is only effective when using an object file format which supports weak symbols. .IP "\fB\-\-keep\-symbols=\fR\fIfilename\fR" 4 .IX Item "--keep-symbols=filename" Apply \fB\-\-keep\-symbol\fR option to each symbol listed in the file \&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-strip\-symbols=\fR\fIfilename\fR" 4 .IX Item "--strip-symbols=filename" Apply \fB\-\-strip\-symbol\fR option to each symbol listed in the file \&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-strip\-unneeded\-symbols=\fR\fIfilename\fR" 4 .IX Item "--strip-unneeded-symbols=filename" Apply \fB\-\-strip\-unneeded\-symbol\fR option to each symbol listed in the file \fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-keep\-global\-symbols=\fR\fIfilename\fR" 4 .IX Item "--keep-global-symbols=filename" Apply \fB\-\-keep\-global\-symbol\fR option to each symbol listed in the file \fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-localize\-symbols=\fR\fIfilename\fR" 4 .IX Item "--localize-symbols=filename" Apply \fB\-\-localize\-symbol\fR option to each symbol listed in the file \&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-globalize\-symbols=\fR\fIfilename\fR" 4 .IX Item "--globalize-symbols=filename" Apply \fB\-\-globalize\-symbol\fR option to each symbol listed in the file \&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-weaken\-symbols=\fR\fIfilename\fR" 4 .IX Item "--weaken-symbols=filename" Apply \fB\-\-weaken\-symbol\fR option to each symbol listed in the file \&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol name per line. Line comments may be introduced by the hash character. This option may be given more than once. .IP "\fB\-\-alt\-machine\-code=\fR\fIindex\fR" 4 .IX Item "--alt-machine-code=index" If the output architecture has alternate machine codes, use the \&\fIindex\fRth code instead of the default one. This is useful in case a machine is assigned an official code and the tool-chain adopts the new code, but other applications still depend on the original code being used. For \s-1ELF\s0 based architectures if the \fIindex\fR alternative does not exist then the value is treated as an absolute number to be stored in the e_machine field of the \s-1ELF\s0 header. .IP "\fB\-\-writable\-text\fR" 4 .IX Item "--writable-text" Mark the output text as writable. This option isn't meaningful for all object file formats. .IP "\fB\-\-readonly\-text\fR" 4 .IX Item "--readonly-text" Make the output text write protected. This option isn't meaningful for all object file formats. .IP "\fB\-\-pure\fR" 4 .IX Item "--pure" Mark the output file as demand paged. This option isn't meaningful for all object file formats. .IP "\fB\-\-impure\fR" 4 .IX Item "--impure" Mark the output file as impure. This option isn't meaningful for all object file formats. .IP "\fB\-\-prefix\-symbols=\fR\fIstring\fR" 4 .IX Item "--prefix-symbols=string" Prefix all symbols in the output file with \fIstring\fR. .IP "\fB\-\-prefix\-sections=\fR\fIstring\fR" 4 .IX Item "--prefix-sections=string" Prefix all section names in the output file with \fIstring\fR. .IP "\fB\-\-prefix\-alloc\-sections=\fR\fIstring\fR" 4 .IX Item "--prefix-alloc-sections=string" Prefix all the names of all allocated sections in the output file with \&\fIstring\fR. .IP "\fB\-\-add\-gnu\-debuglink=\fR\fIpath-to-file\fR" 4 .IX Item "--add-gnu-debuglink=path-to-file" Creates a .gnu_debuglink section which contains a reference to \fIpath-to-file\fR and adds it to the output file. .IP "\fB\-\-keep\-file\-symbols\fR" 4 .IX Item "--keep-file-symbols" When stripping a file, perhaps with \fB\-\-strip\-debug\fR or \&\fB\-\-strip\-unneeded\fR, retain any symbols specifying source file names, which would otherwise get stripped. .IP "\fB\-\-only\-keep\-debug\fR" 4 .IX Item "--only-keep-debug" Strip a file, removing contents of any sections that would not be stripped by \fB\-\-strip\-debug\fR and leaving the debugging sections intact. In \s-1ELF\s0 files, this preserves all note sections in the output. .Sp The intention is that this option will be used in conjunction with \&\fB\-\-add\-gnu\-debuglink\fR to create a two part executable. One a stripped binary which will occupy less space in \s-1RAM\s0 and in a distribution and the second a debugging information file which is only needed if debugging abilities are required. The suggested procedure to create these files is as follows: .RS 4 .IP "1." 4 .IX Item "1." \&\f(CW\*(C`foo\*(C'\fR then... .ie n .IP "1." 4 .el .IP "1." 4 .IX Item "1." create a file containing the debugging info. .ie n .IP "1." 4 .el .IP "1." 4 .IX Item "1." stripped executable. .ie n .IP "1." 4 .el .IP "1." 4 .IX Item "1." to add a link to the debugging info into the stripped executable. .RE .RS 4 .Sp Note \- the choice of \f(CW\*(C`.dbg\*(C'\fR as an extension for the debug info file is arbitrary. Also the \f(CW\*(C`\-\-only\-keep\-debug\*(C'\fR step is optional. You could instead do this: .IP "1." 4 .IX Item "1." .PD 0 .ie n .IP "1." 4 .el .IP "1." 4 .IX Item "1." .ie n .IP "1." 4 .el .IP "1." 4 .IX Item "1." .ie n .IP "1." 4 .el .IP "1." 4 .IX Item "1." .RE .RS 4 .PD .Sp i.e., the file pointed to by the \fB\-\-add\-gnu\-debuglink\fR can be the full executable. It does not have to be a file created by the \&\fB\-\-only\-keep\-debug\fR switch. .Sp Note \- this switch is only intended for use on fully linked files. It does not make sense to use it on object files where the debugging information may be incomplete. Besides the gnu_debuglink feature currently only supports the presence of one filename containing debugging information, not multiple filenames on a one-per-object-file basis. .RE .IP "\fB\-\-extract\-symbol\fR" 4 .IX Item "--extract-symbol" Keep the file's section flags and symbols but remove all section data. Specifically, the option: .RS 4 .IP "*" 4 .IX Item "*" .PD 0 .IP "*" 4 .IX Item "*" .IP "*" 4 .IX Item "*" .IP "*" 4 .IX Item "*" .RE .RS 4 .PD .Sp This option is used to build a \fI.sym\fR file for a VxWorks kernel. It can also be a useful way of reducing the size of a \fB\-\-just\-symbols\fR linker input file. .RE .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Show the version number of \fBobjcopy\fR. .IP "\fB\-v\fR" 4 .IX Item "-v" .PD 0 .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" .PD Verbose output: list all object files modified. In the case of archives, \fBobjcopy \-V\fR lists all members of the archive. .IP "\fB\-\-help\fR" 4 .IX Item "--help" Show a summary of the options to \fBobjcopy\fR. .IP "\fB\-\-info\fR" 4 .IX Item "--info" Display a list showing all architectures and object formats available. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIld\fR\|(1), \fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". diff --git a/gnu/usr.bin/binutils/objdump/objdump.1 b/gnu/usr.bin/binutils/objdump/objdump.1 index 3e339806d0f2..ab054e304761 100644 --- a/gnu/usr.bin/binutils/objdump/objdump.1 +++ b/gnu/usr.bin/binutils/objdump/objdump.1 @@ -1,636 +1,635 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "OBJDUMP 1" .TH OBJDUMP 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" objdump \- display information from object files. .SH "SYNOPSIS" .IX Header "SYNOPSIS" objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR] [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR] [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR] ] [\fB\-d\fR|\fB\-\-disassemble\fR] [\fB\-D\fR|\fB\-\-disassemble\-all\fR] [\fB\-z\fR|\fB\-\-disassemble\-zeroes\fR] [\fB\-EB\fR|\fB\-EL\fR|\fB\-\-endian=\fR{big | little }] [\fB\-f\fR|\fB\-\-file\-headers\fR] [\fB\-\-file\-start\-context\fR] [\fB\-g\fR|\fB\-\-debugging\fR] [\fB\-e\fR|\fB\-\-debugging\-tags\fR] [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR] [\fB\-i\fR|\fB\-\-info\fR] [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR] [\fB\-l\fR|\fB\-\-line\-numbers\fR] [\fB\-S\fR|\fB\-\-source\fR] [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR] [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR] [\fB\-p\fR|\fB\-\-private\-headers\fR] [\fB\-r\fR|\fB\-\-reloc\fR] [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR] [\fB\-s\fR|\fB\-\-full\-contents\fR] [\fB\-W\fR|\fB\-\-dwarf\fR] [\fB\-G\fR|\fB\-\-stabs\fR] [\fB\-t\fR|\fB\-\-syms\fR] [\fB\-T\fR|\fB\-\-dynamic\-syms\fR] [\fB\-x\fR|\fB\-\-all\-headers\fR] [\fB\-w\fR|\fB\-\-wide\fR] [\fB\-\-start\-address=\fR\fIaddress\fR] [\fB\-\-stop\-address=\fR\fIaddress\fR] [\fB\-\-prefix\-addresses\fR] [\fB\-\-[no\-]show\-raw\-insn\fR] [\fB\-\-adjust\-vma=\fR\fIoffset\fR] [\fB\-\-special\-syms\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fB\-H\fR|\fB\-\-help\fR] \fIobjfile\fR... .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBobjdump\fR displays information about one or more object files. The options control what particular information to display. This information is mostly useful to programmers who are working on the compilation tools, as opposed to programmers who just want their program to compile and work. .PP \&\fIobjfile\fR... are the object files to be examined. When you specify archives, \fBobjdump\fR shows information on each of the member object files. .SH "OPTIONS" .IX Header "OPTIONS" The long and short forms of options, shown here as alternatives, are equivalent. At least one option from the list \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given. .IP "\fB\-a\fR" 4 .IX Item "-a" .PD 0 .IP "\fB\-\-archive\-header\fR" 4 .IX Item "--archive-header" .PD If any of the \fIobjfile\fR files are archives, display the archive header information (in a format similar to \fBls \-l\fR). Besides the information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows the object file format of each archive member. .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4 .IX Item "--adjust-vma=offset" When dumping information, first add \fIoffset\fR to all the section addresses. This is useful if the section addresses do not correspond to the symbol table, which can happen when putting sections at particular addresses when using a format which can not represent section addresses, such as a.out. .IP "\fB\-b\fR \fIbfdname\fR" 4 .IX Item "-b bfdname" .PD 0 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" .PD Specify that the object-code format for the object files is \&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can automatically recognize many formats. .Sp For example, .Sp .Vb 1 \& objdump \-b oasys \-m vax \-h fu.o .Ve .Sp displays summary information from the section headers (\fB\-h\fR) of \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object file in the format produced by Oasys compilers. You can list the formats available with the \fB\-i\fR option. .IP "\fB\-C\fR" 4 .IX Item "-C" .PD 0 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4 .IX Item "--demangle[=style]" .PD Decode (\fIdemangle\fR) low-level symbol names into user-level names. Besides removing any initial underscore prepended by the system, this makes \*(C+ function names readable. Different compilers have different mangling styles. The optional demangling style argument can be used to choose an appropriate demangling style for your compiler. .IP "\fB\-g\fR" 4 .IX Item "-g" .PD 0 .IP "\fB\-\-debugging\fR" 4 .IX Item "--debugging" .PD Display debugging information. This attempts to parse debugging information stored in the file and print it out using a C like syntax. Only certain types of debugging information have been implemented. Some other types are supported by \fBreadelf \-w\fR. .IP "\fB\-e\fR" 4 .IX Item "-e" .PD 0 .IP "\fB\-\-debugging\-tags\fR" 4 .IX Item "--debugging-tags" .PD Like \fB\-g\fR, but the information is generated in a format compatible with ctags tool. .IP "\fB\-d\fR" 4 .IX Item "-d" .PD 0 .IP "\fB\-\-disassemble\fR" 4 .IX Item "--disassemble" .PD Display the assembler mnemonics for the machine instructions from \&\fIobjfile\fR. This option only disassembles those sections which are expected to contain instructions. .IP "\fB\-D\fR" 4 .IX Item "-D" .PD 0 .IP "\fB\-\-disassemble\-all\fR" 4 .IX Item "--disassemble-all" .PD Like \fB\-d\fR, but disassemble the contents of all sections, not just those expected to contain instructions. .IP "\fB\-\-prefix\-addresses\fR" 4 .IX Item "--prefix-addresses" When disassembling, print the complete address on each line. This is the older disassembly format. .IP "\fB\-EB\fR" 4 .IX Item "-EB" .PD 0 .IP "\fB\-EL\fR" 4 .IX Item "-EL" .IP "\fB\-\-endian={big|little}\fR" 4 .IX Item "--endian={big|little}" .PD Specify the endianness of the object files. This only affects disassembly. This can be useful when disassembling a file format which does not describe endianness information, such as S\-records. .IP "\fB\-f\fR" 4 .IX Item "-f" .PD 0 .IP "\fB\-\-file\-headers\fR" 4 .IX Item "--file-headers" .PD Display summary information from the overall header of each of the \fIobjfile\fR files. .IP "\fB\-\-file\-start\-context\fR" 4 .IX Item "--file-start-context" Specify that when displaying interlisted source code/disassembly (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the context to the start of the file. .IP "\fB\-h\fR" 4 .IX Item "-h" .PD 0 .IP "\fB\-\-section\-headers\fR" 4 .IX Item "--section-headers" .IP "\fB\-\-headers\fR" 4 .IX Item "--headers" .PD Display summary information from the section headers of the object file. .Sp File segments may be relocated to nonstandard addresses, for example by using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to \&\fBld\fR. However, some object file formats, such as a.out, do not store the starting address of the file segments. In those situations, although \fBld\fR relocates the sections correctly, using \fBobjdump \&\-h\fR to list the file section headers cannot show the correct addresses. Instead, it shows the usual addresses, which are implicit for the target. .IP "\fB\-H\fR" 4 .IX Item "-H" .PD 0 .IP "\fB\-\-help\fR" 4 .IX Item "--help" .PD Print a summary of the options to \fBobjdump\fR and exit. .IP "\fB\-i\fR" 4 .IX Item "-i" .PD 0 .IP "\fB\-\-info\fR" 4 .IX Item "--info" .PD Display a list showing all architectures and object formats available for specification with \fB\-b\fR or \fB\-m\fR. .IP "\fB\-j\fR \fIname\fR" 4 .IX Item "-j name" .PD 0 .IP "\fB\-\-section=\fR\fIname\fR" 4 .IX Item "--section=name" .PD Display information only for section \fIname\fR. .IP "\fB\-l\fR" 4 .IX Item "-l" .PD 0 .IP "\fB\-\-line\-numbers\fR" 4 .IX Item "--line-numbers" .PD Label the display (using debugging information) with the filename and source line numbers corresponding to the object code or relocs shown. Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR. .IP "\fB\-m\fR \fImachine\fR" 4 .IX Item "-m machine" .PD 0 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4 .IX Item "--architecture=machine" .PD Specify the architecture to use when disassembling object files. This can be useful when disassembling object files which do not describe architecture information, such as S\-records. You can list the available architectures with the \fB\-i\fR option. .IP "\fB\-M\fR \fIoptions\fR" 4 .IX Item "-M options" .PD 0 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4 .IX Item "--disassembler-options=options" .PD Pass target specific information to the disassembler. Only supported on some targets. If it is necessary to specify more than one disassembler option then multiple \fB\-M\fR options can be used or can be placed together into a comma separated list. .Sp If the target is an \s-1ARM\s0 architecture then this switch can be used to select which register name set is used during disassembler. Specifying \&\fB\-M reg-names-std\fR (the default) will select the register names as used in \s-1ARM\s0's instruction set documentation, but with register 13 called \&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will just use \fBr\fR followed by the register number. .Sp There are also two variants on the \s-1APCS\s0 register naming scheme enabled by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which use the ARM/Thumb Procedure Call Standard naming conventions. (Either with the normal register names or the special register names). .Sp This option can also be used for \s-1ARM\s0 architectures to force the disassembler to interpret all instructions as Thumb instructions by using the switch \fB\-\-disassembler\-options=force\-thumb\fR. This can be useful when attempting to disassemble thumb code produced by other compilers. .Sp For the x86, some of the options duplicate functions of the \fB\-m\fR switch, but allow finer grained control. Multiple selections from the following may be specified as a comma separated string. \&\fBx86\-64\fR, \fBi386\fR and \fBi8086\fR select disassembly for the given architecture. \fBintel\fR and \fBatt\fR select between intel syntax mode and \s-1AT&T\s0 syntax mode. \fBaddr64\fR, \fBaddr32\fR, \&\fBaddr16\fR, \fBdata32\fR and \fBdata16\fR specify the default address size and operand size. These four options will be overridden if \&\fBx86\-64\fR, \fBi386\fR or \fBi8086\fR appear later in the option string. Lastly, \fBsuffix\fR, when in \s-1AT&T\s0 mode, instructs the disassembler to print a mnemonic suffix even when the suffix could be inferred by the operands. .Sp For \s-1PPC\s0, \fBbooke\fR, \fBbooke32\fR and \fBbooke64\fR select disassembly of BookE instructions. \fB32\fR and \fB64\fR select PowerPC and PowerPC64 disassembly, respectively. \fBe300\fR selects disassembly for the e300 family. \fB440\fR selects disassembly for the PowerPC 440. .Sp For \s-1MIPS\s0, this option controls the printing of instruction mnemonic names and register names in disassembled instructions. Multiple selections from the following may be specified as a comma separated string, and invalid options are ignored: .RS 4 .ie n .IP """no\-aliases""" 4 .el .IP "\f(CWno\-aliases\fR" 4 .IX Item "no-aliases" Print the 'raw' instruction mnemonic instead of some pseudo instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move', \&'sll' instead of 'nop', etc. .ie n .IP """gpr\-names=\f(CIABI\f(CW""" 4 .el .IP "\f(CWgpr\-names=\f(CIABI\f(CW\fR" 4 .IX Item "gpr-names=ABI" Print \s-1GPR\s0 (general-purpose register) names as appropriate for the specified \s-1ABI\s0. By default, \s-1GPR\s0 names are selected according to the \s-1ABI\s0 of the binary being disassembled. .ie n .IP """fpr\-names=\f(CIABI\f(CW""" 4 .el .IP "\f(CWfpr\-names=\f(CIABI\f(CW\fR" 4 .IX Item "fpr-names=ABI" Print \s-1FPR\s0 (floating-point register) names as appropriate for the specified \s-1ABI\s0. By default, \s-1FPR\s0 numbers are printed rather than names. .ie n .IP """cp0\-names=\f(CIARCH\f(CW""" 4 .el .IP "\f(CWcp0\-names=\f(CIARCH\f(CW\fR" 4 .IX Item "cp0-names=ARCH" Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names as appropriate for the \s-1CPU\s0 or architecture specified by \&\fI\s-1ARCH\s0\fR. By default, \s-1CP0\s0 register names are selected according to the architecture and \s-1CPU\s0 of the binary being disassembled. .ie n .IP """hwr\-names=\f(CIARCH\f(CW""" 4 .el .IP "\f(CWhwr\-names=\f(CIARCH\f(CW\fR" 4 .IX Item "hwr-names=ARCH" Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names as appropriate for the \s-1CPU\s0 or architecture specified by \&\fI\s-1ARCH\s0\fR. By default, \s-1HWR\s0 names are selected according to the architecture and \s-1CPU\s0 of the binary being disassembled. .ie n .IP """reg\-names=\f(CIABI\f(CW""" 4 .el .IP "\f(CWreg\-names=\f(CIABI\f(CW\fR" 4 .IX Item "reg-names=ABI" Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI\s0. .ie n .IP """reg\-names=\f(CIARCH\f(CW""" 4 .el .IP "\f(CWreg\-names=\f(CIARCH\f(CW\fR" 4 .IX Item "reg-names=ARCH" Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names) as appropriate for the selected \s-1CPU\s0 or architecture. .RE .RS 4 .Sp For any of the options listed above, \fI\s-1ABI\s0\fR or \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed rather than names, for the selected types of registers. You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using the \fB\-\-help\fR option. .Sp For \s-1VAX\s0, you can specify function entry addresses with \fB\-M entry:0xf00ba\fR. You can use this multiple times to properly disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like \&\s-1ROM\s0 dumps). In these cases, the function entry mask would otherwise be decoded as \s-1VAX\s0 instructions, which would probably lead the rest of the function being wrongly disassembled. .RE .IP "\fB\-p\fR" 4 .IX Item "-p" .PD 0 .IP "\fB\-\-private\-headers\fR" 4 .IX Item "--private-headers" .PD Print information that is specific to the object file format. The exact information printed depends upon the object file format. For some object file formats, no additional information is printed. .IP "\fB\-r\fR" 4 .IX Item "-r" .PD 0 .IP "\fB\-\-reloc\fR" 4 .IX Item "--reloc" .PD Print the relocation entries of the file. If used with \fB\-d\fR or \&\fB\-D\fR, the relocations are printed interspersed with the disassembly. .IP "\fB\-R\fR" 4 .IX Item "-R" .PD 0 .IP "\fB\-\-dynamic\-reloc\fR" 4 .IX Item "--dynamic-reloc" .PD Print the dynamic relocation entries of the file. This is only meaningful for dynamic objects, such as certain types of shared libraries. .IP "\fB\-s\fR" 4 .IX Item "-s" .PD 0 .IP "\fB\-\-full\-contents\fR" 4 .IX Item "--full-contents" .PD Display the full contents of any sections requested. By default all non-empty sections are displayed. .IP "\fB\-S\fR" 4 .IX Item "-S" .PD 0 .IP "\fB\-\-source\fR" 4 .IX Item "--source" .PD Display source code intermixed with disassembly, if possible. Implies \&\fB\-d\fR. .IP "\fB\-\-show\-raw\-insn\fR" 4 .IX Item "--show-raw-insn" When disassembling instructions, print the instruction in hex as well as in symbolic form. This is the default except when \&\fB\-\-prefix\-addresses\fR is used. .IP "\fB\-\-no\-show\-raw\-insn\fR" 4 .IX Item "--no-show-raw-insn" When disassembling instructions, do not print the instruction bytes. This is the default when \fB\-\-prefix\-addresses\fR is used. .IP "\fB\-W\fR" 4 .IX Item "-W" .PD 0 .IP "\fB\-\-dwarf\fR" 4 .IX Item "--dwarf" .PD Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any are present. .IP "\fB\-G\fR" 4 .IX Item "-G" .PD 0 .IP "\fB\-\-stabs\fR" 4 .IX Item "--stabs" .PD Display the full contents of any sections requested. Display the contents of the .stab and .stab.index and .stab.excl sections from an \&\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0 section. In most other file formats, debugging symbol-table entries are interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR output. .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4 .IX Item "--start-address=address" Start displaying data at the specified address. This affects the output of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options. .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4 .IX Item "--stop-address=address" Stop displaying data at the specified address. This affects the output of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options. .IP "\fB\-t\fR" 4 .IX Item "-t" .PD 0 .IP "\fB\-\-syms\fR" 4 .IX Item "--syms" .PD Print the symbol table entries of the file. This is similar to the information provided by the \fBnm\fR program. .IP "\fB\-T\fR" 4 .IX Item "-T" .PD 0 .IP "\fB\-\-dynamic\-syms\fR" 4 .IX Item "--dynamic-syms" .PD Print the dynamic symbol table entries of the file. This is only meaningful for dynamic objects, such as certain types of shared libraries. This is similar to the information provided by the \fBnm\fR program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option. .IP "\fB\-\-special\-syms\fR" 4 .IX 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 user. .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Print the version number of \fBobjdump\fR and exit. .IP "\fB\-x\fR" 4 .IX Item "-x" .PD 0 .IP "\fB\-\-all\-headers\fR" 4 .IX Item "--all-headers" .PD Display all available header information, including the symbol table and relocation entries. Using \fB\-x\fR is equivalent to specifying all of \&\fB\-a \-f \-h \-p \-r \-t\fR. .IP "\fB\-w\fR" 4 .IX Item "-w" .PD 0 .IP "\fB\-\-wide\fR" 4 .IX Item "--wide" .PD Format some lines for output devices that have more than 80 columns. Also do not truncate symbol names when they are displayed. .IP "\fB\-z\fR" 4 .IX Item "-z" .PD 0 .IP "\fB\-\-disassemble\-zeroes\fR" 4 .IX Item "--disassemble-zeroes" .PD Normally the disassembly output will skip blocks of zeroes. This option directs the disassembler to disassemble those blocks, just like any other data. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". diff --git a/gnu/usr.bin/binutils/readelf/readelf.1 b/gnu/usr.bin/binutils/readelf/readelf.1 index e246d2ce2884..df4b2ef03dfb 100644 --- a/gnu/usr.bin/binutils/readelf/readelf.1 +++ b/gnu/usr.bin/binutils/readelf/readelf.1 @@ -1,377 +1,376 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "READELF 1" .TH READELF 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" readelf \- Displays information about ELF files. .SH "SYNOPSIS" .IX Header "SYNOPSIS" readelf [\fB\-a\fR|\fB\-\-all\fR] [\fB\-h\fR|\fB\-\-file\-header\fR] [\fB\-l\fR|\fB\-\-program\-headers\fR|\fB\-\-segments\fR] [\fB\-S\fR|\fB\-\-section\-headers\fR|\fB\-\-sections\fR] [\fB\-g\fR|\fB\-\-section\-groups\fR] [\fB\-t\fR|\fB\-\-section\-details\fR] [\fB\-e\fR|\fB\-\-headers\fR] [\fB\-s\fR|\fB\-\-syms\fR|\fB\-\-symbols\fR] [\fB\-n\fR|\fB\-\-notes\fR] [\fB\-r\fR|\fB\-\-relocs\fR] [\fB\-u\fR|\fB\-\-unwind\fR] [\fB\-d\fR|\fB\-\-dynamic\fR] [\fB\-V\fR|\fB\-\-version\-info\fR] [\fB\-A\fR|\fB\-\-arch\-specific\fR] [\fB\-D\fR|\fB\-\-use\-dynamic\fR] [\fB\-x\fR |\fB\-\-hex\-dump=\fR] [\fB\-w[liaprmfFsoR]\fR| \fB\-\-debug\-dump\fR[=line,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges]] [\fB\-I\fR|\fB\-histogram\fR] [\fB\-v\fR|\fB\-\-version\fR] [\fB\-W\fR|\fB\-\-wide\fR] [\fB\-H\fR|\fB\-\-help\fR] \fIelffile\fR... .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBreadelf\fR displays information about one or more \s-1ELF\s0 format object files. The options control what particular information to display. .PP \&\fIelffile\fR... are the object files to be examined. 32\-bit and 64\-bit \s-1ELF\s0 files are supported, as are archives containing \s-1ELF\s0 files. .PP This program performs a similar function to \fBobjdump\fR but it goes into more detail and it exists independently of the \s-1BFD\s0 library, so if there is a bug in \s-1BFD\s0 then readelf will not be affected. .SH "OPTIONS" .IX Header "OPTIONS" The long and short forms of options, shown here as alternatives, are equivalent. At least one option besides \fB\-v\fR or \fB\-H\fR must be given. .IP "\fB\-a\fR" 4 .IX Item "-a" .PD 0 .IP "\fB\-\-all\fR" 4 .IX Item "--all" .PD Equivalent to specifying \fB\-\-file\-header\fR, \&\fB\-\-program\-headers\fR, \fB\-\-sections\fR, \fB\-\-symbols\fR, \&\fB\-\-relocs\fR, \fB\-\-dynamic\fR, \fB\-\-notes\fR and \&\fB\-\-version\-info\fR. .IP "\fB\-h\fR" 4 .IX Item "-h" .PD 0 .IP "\fB\-\-file\-header\fR" 4 .IX Item "--file-header" .PD Displays the information contained in the \s-1ELF\s0 header at the start of the file. .IP "\fB\-l\fR" 4 .IX Item "-l" .PD 0 .IP "\fB\-\-program\-headers\fR" 4 .IX Item "--program-headers" .IP "\fB\-\-segments\fR" 4 .IX Item "--segments" .PD Displays the information contained in the file's segment headers, if it has any. .IP "\fB\-S\fR" 4 .IX Item "-S" .PD 0 .IP "\fB\-\-sections\fR" 4 .IX Item "--sections" .IP "\fB\-\-section\-headers\fR" 4 .IX Item "--section-headers" .PD Displays the information contained in the file's section headers, if it has any. .IP "\fB\-g\fR" 4 .IX Item "-g" .PD 0 .IP "\fB\-\-section\-groups\fR" 4 .IX Item "--section-groups" .PD Displays the information contained in the file's section groups, if it has any. .IP "\fB\-t\fR" 4 .IX Item "-t" .PD 0 .IP "\fB\-\-section\-details\fR" 4 .IX Item "--section-details" .PD Displays the detailed section information. Implies \fB\-S\fR. .IP "\fB\-s\fR" 4 .IX Item "-s" .PD 0 .IP "\fB\-\-symbols\fR" 4 .IX Item "--symbols" .IP "\fB\-\-syms\fR" 4 .IX Item "--syms" .PD Displays the entries in symbol table section of the file, if it has one. .IP "\fB\-e\fR" 4 .IX Item "-e" .PD 0 .IP "\fB\-\-headers\fR" 4 .IX Item "--headers" .PD Display all the headers in the file. Equivalent to \fB\-h \-l \-S\fR. .IP "\fB\-n\fR" 4 .IX Item "-n" .PD 0 .IP "\fB\-\-notes\fR" 4 .IX Item "--notes" .PD Displays the contents of the \s-1NOTE\s0 segments and/or sections, if any. .IP "\fB\-r\fR" 4 .IX Item "-r" .PD 0 .IP "\fB\-\-relocs\fR" 4 .IX Item "--relocs" .PD Displays the contents of the file's relocation section, if it has one. .IP "\fB\-u\fR" 4 .IX Item "-u" .PD 0 .IP "\fB\-\-unwind\fR" 4 .IX Item "--unwind" .PD Displays the contents of the file's unwind section, if it has one. Only the unwind sections for \s-1IA64\s0 \s-1ELF\s0 files are currently supported. .IP "\fB\-d\fR" 4 .IX Item "-d" .PD 0 .IP "\fB\-\-dynamic\fR" 4 .IX Item "--dynamic" .PD Displays the contents of the file's dynamic section, if it has one. .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\-info\fR" 4 .IX Item "--version-info" .PD Displays the contents of the version sections in the file, it they exist. .IP "\fB\-A\fR" 4 .IX Item "-A" .PD 0 .IP "\fB\-\-arch\-specific\fR" 4 .IX Item "--arch-specific" .PD Displays architecture-specific information in the file, if there is any. .IP "\fB\-D\fR" 4 .IX Item "-D" .PD 0 .IP "\fB\-\-use\-dynamic\fR" 4 .IX Item "--use-dynamic" .PD When displaying symbols, this option makes \fBreadelf\fR use the symbol table in the file's dynamic section, rather than the one in the symbols section. .IP "\fB\-x \fR" 4 .IX Item "-x " .PD 0 .IP "\fB\-\-hex\-dump=\fR" 4 .IX Item "--hex-dump=" .PD Displays the contents of the indicated section as a hexadecimal dump. A number identifies a particular section by index in the section table; any other string identifies all sections with that name in the object file. .IP "\fB\-w[liaprmfFsoR]\fR" 4 .IX Item "-w[liaprmfFsoR]" .PD 0 .IP "\fB\-\-debug\-dump[=line,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges]\fR" 4 .IX Item "--debug-dump[=line,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges]" .PD 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. .IP "\fB\-I\fR" 4 .IX Item "-I" .PD 0 .IP "\fB\-\-histogram\fR" 4 .IX Item "--histogram" .PD Display a histogram of bucket list lengths when displaying the contents of the symbol tables. .IP "\fB\-v\fR" 4 .IX Item "-v" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Display the version number of readelf. .IP "\fB\-W\fR" 4 .IX Item "-W" .PD 0 .IP "\fB\-\-wide\fR" 4 .IX Item "--wide" .PD Don't break output lines to fit into 80 columns. By default \&\fBreadelf\fR breaks section header and segment listing lines for 64\-bit \s-1ELF\s0 files, so that they fit into 80 columns. This option causes \&\fBreadelf\fR to print each section header resp. each segment one a single line, which is far more readable on terminals wider than 80 columns. .IP "\fB\-H\fR" 4 .IX Item "-H" .PD 0 .IP "\fB\-\-help\fR" 4 .IX Item "--help" .PD Display the command line options understood by \fBreadelf\fR. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". diff --git a/gnu/usr.bin/binutils/size/size.1 b/gnu/usr.bin/binutils/size/size.1 index 7064762186ff..6346ff214595 100644 --- a/gnu/usr.bin/binutils/size/size.1 +++ b/gnu/usr.bin/binutils/size/size.1 @@ -1,263 +1,262 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "SIZE 1" .TH SIZE 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" size \- list section sizes and total size .SH "SYNOPSIS" .IX Header "SYNOPSIS" size [\fB\-A\fR|\fB\-B\fR|\fB\-\-format=\fR\fIcompatibility\fR] [\fB\-\-help\fR] [\fB\-d\fR|\fB\-o\fR|\fB\-x\fR|\fB\-\-radix=\fR\fInumber\fR] [\fB\-t\fR|\fB\-\-totals\fR] [\fB\-\-target=\fR\fIbfdname\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIobjfile\fR...] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \s-1GNU\s0 \fBsize\fR utility lists the section sizes\-\-\-and the total size\-\-\-for each of the object or archive files \fIobjfile\fR in its argument list. By default, one line of output is generated for each object file or each module in an archive. .PP \&\fIobjfile\fR... are the object files to be examined. If none are specified, the file \f(CW\*(C`a.out\*(C'\fR will be used. .SH "OPTIONS" .IX Header "OPTIONS" The command line options have the following meanings: .IP "\fB\-A\fR" 4 .IX Item "-A" .PD 0 .IP "\fB\-B\fR" 4 .IX Item "-B" .IP "\fB\-\-format=\fR\fIcompatibility\fR" 4 .IX Item "--format=compatibility" .PD Using one of these options, you can choose whether the output from \s-1GNU\s0 \&\fBsize\fR resembles output from System V \fBsize\fR (using \fB\-A\fR, or \fB\-\-format=sysv\fR), or Berkeley \fBsize\fR (using \fB\-B\fR, or \&\fB\-\-format=berkeley\fR). The default is the one-line format similar to Berkeley's. .Sp Here is an example of the Berkeley (default) format of output from \&\fBsize\fR: .Sp .Vb 4 \& $ size \-\-format=Berkeley ranlib size \& text data bss dec hex filename \& 294880 81920 11592 388392 5ed28 ranlib \& 294880 81920 11888 388688 5ee50 size .Ve .Sp This is the same data, but displayed closer to System V conventions: .Sp .Vb 7 \& $ size \-\-format=SysV ranlib size \& ranlib : \& section size addr \& .text 294880 8192 \& .data 81920 303104 \& .bss 11592 385024 \& Total 388392 \& \& \& size : \& section size addr \& .text 294880 8192 \& .data 81920 303104 \& .bss 11888 385024 \& Total 388688 .Ve .IP "\fB\-\-help\fR" 4 .IX Item "--help" Show a summary of acceptable arguments and options. .IP "\fB\-d\fR" 4 .IX Item "-d" .PD 0 .IP "\fB\-o\fR" 4 .IX Item "-o" .IP "\fB\-x\fR" 4 .IX Item "-x" .IP "\fB\-\-radix=\fR\fInumber\fR" 4 .IX Item "--radix=number" .PD Using one of these options, you can control whether the size of each section is given in decimal (\fB\-d\fR, or \fB\-\-radix=10\fR); octal (\fB\-o\fR, or \fB\-\-radix=8\fR); or hexadecimal (\fB\-x\fR, or \&\fB\-\-radix=16\fR). In \fB\-\-radix=\fR\fInumber\fR, only the three values (8, 10, 16) are supported. The total size is always given in two radices; decimal and hexadecimal for \fB\-d\fR or \fB\-x\fR output, or octal and hexadecimal if you're using \fB\-o\fR. .IP "\fB\-t\fR" 4 .IX Item "-t" .PD 0 .IP "\fB\-\-totals\fR" 4 .IX Item "--totals" .PD Show totals of all objects listed (Berkeley format listing mode only). .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" Specify that the object-code format for \fIobjfile\fR is \&\fIbfdname\fR. This option may not be necessary; \fBsize\fR can automatically recognize many formats. .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Display the version number of \fBsize\fR. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". diff --git a/gnu/usr.bin/binutils/strings/strings.1 b/gnu/usr.bin/binutils/strings/strings.1 index 075e3a5d8a58..15e2b549aa9c 100644 --- a/gnu/usr.bin/binutils/strings/strings.1 +++ b/gnu/usr.bin/binutils/strings/strings.1 @@ -1,254 +1,253 @@ .\" $FreeBSD$ .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" -'br\} +\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "STRINGS 1" .TH STRINGS 1 "2010-10-30" "binutils-2.17.50" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" strings \- print the strings of printable characters in files. .SH "SYNOPSIS" .IX Header "SYNOPSIS" strings [\fB\-afov\fR] [\fB\-\fR\fImin-len\fR] [\fB\-n\fR \fImin-len\fR] [\fB\-\-bytes=\fR\fImin-len\fR] [\fB\-t\fR \fIradix\fR] [\fB\-\-radix=\fR\fIradix\fR] [\fB\-e\fR \fIencoding\fR] [\fB\-\-encoding=\fR\fIencoding\fR] [\fB\-\fR] [\fB\-\-all\fR] [\fB\-\-print\-file\-name\fR] [\fB\-T\fR \fIbfdname\fR] [\fB\-\-target=\fR\fIbfdname\fR] [\fB\-\-help\fR] [\fB\-\-version\fR] \fIfile\fR... .SH "DESCRIPTION" .IX Header "DESCRIPTION" For each \fIfile\fR given, \s-1GNU\s0 \fBstrings\fR prints the printable character sequences that are at least 4 characters long (or the number given with the options below) and are followed by an unprintable character. By default, it only prints the strings from the initialized and loaded sections of object files; for other types of files, it prints the strings from the whole file. .PP \&\fBstrings\fR is mainly useful for determining the contents of non-text files. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-a\fR" 4 .IX Item "-a" .PD 0 .IP "\fB\-\-all\fR" 4 .IX Item "--all" .IP "\fB\-\fR" 4 .IX Item "-" .PD Do not scan only the initialized and loaded sections of object files; scan the whole files. .IP "\fB\-f\fR" 4 .IX Item "-f" .PD 0 .IP "\fB\-\-print\-file\-name\fR" 4 .IX Item "--print-file-name" .PD Print the name of the file before each string. .IP "\fB\-\-help\fR" 4 .IX Item "--help" Print a summary of the program usage on the standard output and exit. .IP "\fB\-\fR\fImin-len\fR" 4 .IX Item "-min-len" .PD 0 .IP "\fB\-n\fR \fImin-len\fR" 4 .IX Item "-n min-len" .IP "\fB\-\-bytes=\fR\fImin-len\fR" 4 .IX Item "--bytes=min-len" .PD Print sequences of characters that are at least \fImin-len\fR characters long, instead of the default 4. .IP "\fB\-o\fR" 4 .IX Item "-o" Like \fB\-t o\fR. Some other versions of \fBstrings\fR have \fB\-o\fR act like \fB\-t d\fR instead. Since we can not be compatible with both ways, we simply chose one. .IP "\fB\-t\fR \fIradix\fR" 4 .IX Item "-t radix" .PD 0 .IP "\fB\-\-radix=\fR\fIradix\fR" 4 .IX Item "--radix=radix" .PD Print the offset within the file before each string. The single character argument specifies the radix of the offset\-\-\-\fBo\fR for octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal. .IP "\fB\-e\fR \fIencoding\fR" 4 .IX Item "-e encoding" .PD 0 .IP "\fB\-\-encoding=\fR\fIencoding\fR" 4 .IX Item "--encoding=encoding" .PD Select the character encoding of the strings that are to be found. Possible values for \fIencoding\fR are: \fBs\fR = single\-7\-bit\-byte characters (\s-1ASCII\s0, \s-1ISO\s0 8859, etc., default), \fBS\fR = single\-8\-bit\-byte characters, \fBb\fR = 16\-bit bigendian, \fBl\fR = 16\-bit littleendian, \fBB\fR = 32\-bit bigendian, \fBL\fR = 32\-bit littleendian. Useful for finding wide character strings. .IP "\fB\-T\fR \fIbfdname\fR" 4 .IX Item "-T bfdname" .PD 0 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" .PD Specify an object code format other than your system's default format. .IP "\fB\-v\fR" 4 .IX Item "-v" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Print the program version number on the standard output and exit. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR does not exist, or cannot be read, then the option will be treated literally, and not removed. .Sp Options in \fIfile\fR are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The \fIfile\fR may itself contain additional @\fIfile\fR options; any such options will be processed recursively. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1) and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".