1dump(1)                          User Commands                         dump(1)
2
3
4

NAME

6       dump - dump selected parts of an object file
7

SYNOPSIS

9       dump [-aCcfghLorstV [-p]] [-T index [, indexn]] filename...
10
11
12       dump [-afhorstL [-p] [v]] filename...
13
14
15       dump [-hsr [-p] [-d number [, numbern]]] filename...
16
17
18       dump [-hsrt [-p] [-n name]] filename...
19
20

DESCRIPTION

22       The  dump utility dumps selected parts of each of its object file argu‐
23       ments.
24
25
26       The dump utility is best suited for use in shell scripts,  whereas  the
27       elfdump(1) command is recommended for more human-readable output.
28

OPTIONS

30       This  utility  will  accept  both  object  files and archives of object
31       files. It processes each file argument according to one or more of  the
32       following options:
33
34       -a                  Dumps  the  archive header of each member of an ar‐
35                           chive.
36
37
38       -c                  Dumps the string table(s).
39
40
41       -C                  Dumps decoded C++ symbol table names.
42
43
44       -f                  Dumps each file header.
45
46
47       -g                  Dumps the global symbols in the symbol table of  an
48                           archive.
49
50
51       -h                  Dumps the section headers.
52
53
54       -L                  Dumps dynamic linking information and static shared
55                           library information, if available.
56
57
58       -o                  Dumps each program execution header.
59
60
61       -r                  Dumps relocation information.
62
63
64       -s                  Dumps section contents in hexadecimal.
65
66
67       -t                  Dumps symbol table entries.
68
69
70       -T index            Dumps only the indexed symbol table  entry  defined
71       -T index1,index2    by   index   or  a  range  of  entries  defined  by
72                           index1,index2.
73
74
75       -V                  Prints version information.
76
77
78
79       The following modifiers are used in conjunction with the options listed
80       above to modify their capabilities.
81
82       -d number             Dumps  the  section number indicated by number or
83       -d number1,number2    the range of sections  starting  at  number1  and
84                             ending at number2. This modifier can be used with
85                             -h, -s, and -r. When -d is used with  -h  or  -s,
86                             the  argument  is treated as the number of a sec‐
87                             tion or range of sections. When -d is  used  with
88                             -r,  the argument is treated as the number of the
89                             section or range of sections to which the reloca‐
90                             tion applies. For example, to print out all relo‐
91                             cation entries associated with the .text section,
92                             specify the number of the section as the argument
93                             to -d. If .text is section number 2 in the  file,
94                             dump  -r  -d 2 will print all associated entries.
95                             To print out a specific relocation  section,  use
96                             dump  -s -n name for raw data output, or dump -sv
97                             -n name for interpreted output.
98
99
100       -n name               Dumps information pertaining only  to  the  named
101                             entity.  This  modifier  can be used with -h, -s,
102                             -r, and  -t. When -n is used with -h or  -s,  the
103                             argument  will  be  treated as the name of a sec‐
104                             tion. When -n is used with -t or -r, the argument
105                             will  be  treated  as  the  name of a symbol. For
106                             example, dump -t -n .text will  dump  the  symbol
107                             table entry associated with the symbol whose name
108                             is .text, where dump -h -n  .text will  dump  the
109                             section header information for the .text section.
110
111
112       -p                    Suppresses printing of the headings.
113
114
115       -v                    Dumps   information  in  symbolic  representation
116                             rather than numeric. This modifier  can  be  used
117                             with
118
119                             -a    (date, user id, group id)
120
121
122                             -f    (class,   data,   type,  machine,  version,
123                                   flags)
124
125
126                             -h    (type, flags)
127
128
129                             -L    (value)
130
131
132                             -o    (type, flags)
133
134
135                             -r    (name, type)
136
137
138                             -s    (interpret section contents wherever possi‐
139                                   ble)
140
141
142                             -t    (type, bind)
143
144                             When -v is used with -s, all sections that can be
145                             interpreted, such as the string table  or  symbol
146                             table, will be interpreted. For example, dump -sv
147                             -n .symtab filename... will produce the same for‐
148                             matted  output  as dump -tv filename..., but dump
149                             -s -n .symtab filename... will print raw data  in
150                             hexadecimal.  Without  additional modifiers, dump
151                             -sv filename... will dump  all  sections  in  the
152                             files,  interpreting  all  those  that it can and
153                             dumping the rest (such as .text or .data) as  raw
154                             data.
155
156
157
158       The dump utility attempts to format the information it dumps in a mean‐
159       ingful way, printing certain  information  in  character,  hexadecimal,
160       octal, or decimal representation as appropriate.
161

ATTRIBUTES

163       See attributes(5) for descriptions of the following attributes:
164
165
166
167
168       ┌─────────────────────────────┬─────────────────────────────┐
169       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
170       ├─────────────────────────────┼─────────────────────────────┤
171       │Availability                 │SUNWbtool                    │
172       └─────────────────────────────┴─────────────────────────────┘
173

SEE ALSO

175       elfdump(1), nm(1), ar.h(3HEAD), a.out(4), attributes(5)
176
177
178
179SunOS 5.11                        6 Sep 2002                           dump(1)