xref: /freebsd/usr.bin/elfdump/elfdump.1 (revision 734e82fe33aa764367791a7d603b383996c6b40b)
1.\" Copyright (c) 2003 David O'Brien
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.Dd November 5, 2018
26.Dt ELFDUMP 1
27.Os
28.Sh NAME
29.Nm elfdump
30.Nd "display information about"
31.Tn ELF
32files
33.Sh SYNOPSIS
34.Nm
35.Fl a | E | cdeGhinprs
36.Op Fl w Ar file
37.Ar file
38.Sh DESCRIPTION
39The
40.Nm
41utility
42dumps various information about the specified
43.Tn ELF
44.Ar file .
45.Pp
46The options are as follows:
47.Bl -tag -width ".Fl w Ar file"
48.It Fl a
49Dump all information.
50.It Fl c
51Dump section headers.
52.It Fl d
53Dump dynamic symbols.
54.It Fl e
55Dump ELF header.
56.It Fl E
57Return success if
58.Ar file
59is an ELF file and failure if it is not.
60This option is exclusive with other options.
61.It Fl G
62Dump the GOT.
63.It Fl h
64Dump the hash values.
65.It Fl i
66Dump the dynamic interpreter.
67.It Fl n
68Dump note sections.
69.It Fl p
70Dump the program header.
71.It Fl r
72Dump relocations.
73.It Fl s
74Dump the symbol table.
75.It Fl w Ar file
76Write output to a
77.Ar file
78instead of the standard output.
79.El
80.Sh EXIT STATUS
81.Ex -std
82.Sh EXAMPLES
83The following is an example of a typical usage
84of the
85.Nm
86command:
87.Pp
88.Dl "elfdump -a -w output /bin/ls"
89.Sh SEE ALSO
90.Xr objdump 1 ,
91.Xr readelf 1
92.Rs
93.%A "AT&T Unix Systems Labs"
94.%T "System V Application Binary Interface"
95.%U http://www.sco.com/developers/gabi/
96.Re
97.Sh HISTORY
98The
99.Nm
100utility first appeared in
101.Fx 5.0 .
102.Sh AUTHORS
103.An -nosplit
104The
105.Nm
106utility
107was written by
108.An Jake Burkholder Aq Mt jake@FreeBSD.org .
109This
110manual page was written by
111.An David O'Brien Aq Mt obrien@FreeBSD.org .
112.Sh BUGS
113Does not fully implement the
114.Tn ELF
115gABI.
116