xref: /freebsd/usr.bin/elfdump/elfdump.1 (revision 538015aa3b16b2819401ed2b6cebdd459affc7d4)
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.\" $FreeBSD$
26.\"
27.Dd January 15, 2003
28.Dt ELFDUMP 1
29.Os
30.Sh NAME
31.Nm elfdump
32.Nd "Displays information about ELF files."
33.Sh SYNOPSIS
34.Nm
35.Op Fl a | cdeiGhnprs
36.Op Fl w Ar argument
37.Ar file
38.Sh DESCRIPTION
39This is an example manual page for the
40.Nm
41command.
42It is intended that this example can be used as a template
43when writing a new manual page.
44.Pp
45The options are as follows:
46.Bl -tag -width ".Fl d Ar argument"
47.It Fl a
48Dump all information.
49.It Fl c
50Dump shared headers.
51.It Fl d
52Dump dynamic symbols.
53.It Fl e
54Dump ELF header.
55.It Fl i
56Dump the dyanmic interupter.
57.It Fl G
58Dump the GOT.
59.It Fl h
60Dump the hash values.
61.It Fl n
62Dump note sections.
63.It Fl p
64Dump the program header.
65.It Fl r
66Dump relocations.
67.It Fl s
68Dump the symbol table.
69.It Fl w
70Write output to
71.Ar argument .
72.It Ar file
73Required argument
74.Ar file .
75.El
76.Sh EXAMPLES
77The following is an example of a typical usage
78of the
79.Nm
80command:
81.Pp
82.Dl "elfdump -a -w output /bin/ls"
83.Sh DIAGNOSTICS
84Exit status is 0 on success, and 1 if the command fails.
85.El
86.Sh COMPATIBILITY
87The
88.Nm
89command has no known compatibility issues.
90.Sh SEE ALSO
91.Xr objdump 1 ,
92.Xr readelf 1
93.Pp
94.Rs
95.%A AT&T Unix Systems Labs
96.%T System V Application Binary Interface
97.%O http://www.sco.com/developers/gabi/
98.Re
99.\".Sh STANDARDS
100.\"If the command conforms to some standard, such as
101.\".St -p1003.2
102.\"or
103.\".St -isoC ,
104.\"it should be noted here.
105.Sh HISTORY
106The
107.Nm
108command first appeared in
109.Fx 5.0 .
110.Sh AUTHORS
111.Nm
112was authored by
113.An Jake Burkholder Aq jake@FreeBSD.org .
114This
115manual page was written by
116.An David O'Brien Aq obrien@FreeBSD.org .
117.Sh BUGS
118Does not fully impliment the ELF gABI.
119