xref: /freebsd/contrib/elftoolchain/libelftc/elftc.3 (revision 7d8f797b725e3efc0a4256554654780df83c456c)
1.\" Copyright (c) 2012 Joseph Koshy.  All rights reserved.
2.\"
3.\" Redistribution and use in source and binary forms, with or without
4.\" modification, are permitted provided that the following conditions
5.\" are met:
6.\" 1. Redistributions of source code must retain the above copyright
7.\"    notice, this list of conditions and the following disclaimer.
8.\" 2. Redistributions in binary form must reproduce the above copyright
9.\"    notice, this list of conditions and the following disclaimer in the
10.\"    documentation and/or other materials provided with the distribution.
11.\"
12.\" This software is provided by Joseph Koshy ``as is'' and
13.\" any express or implied warranties, including, but not limited to, the
14.\" implied warranties of merchantability and fitness for a particular purpose
15.\" are disclaimed.  in no event shall Joseph Koshy be liable
16.\" for any direct, indirect, incidental, special, exemplary, or consequential
17.\" damages (including, but not limited to, procurement of substitute goods
18.\" or services; loss of use, data, or profits; or business interruption)
19.\" however caused and on any theory of liability, whether in contract, strict
20.\" liability, or tort (including negligence or otherwise) arising in any way
21.\" out of the use of this software, even if advised of the possibility of
22.\" such damage.
23.\"
24.\" $Id: elftc.3 2818 2012-12-24 12:32:48Z jkoshy $
25.\"
26.Dd December 24, 2012
27.Os
28.Dt ELFTC 3
29.Sh NAME
30.Nm elftc
31.Nd support routines used in the Elftoolchain project
32.Sh LIBRARY
33.Lb libelftc
34.Sh SYNOPSIS
35.In libelftc.h
36.Sh DESCRIPTION
37The
38.Lb libelftc
39provides support routines used for developing the utilities in the
40Elftoolchain source tree.
41.Pp
42This manual page serves as an overview of the functionality in this
43library.
44Additional reference information may be found in the individual
45manual pages for the functions listed below.
46.Ss Functional Grouping
47.Bl -tag -width indent
48.It "Binary Object Handling"
49.Bl -tag -compact
50.It Fn elftc_bfd_find_target
51Locate a binary object descriptor.
52.It Fn elftc_bfd_target_class
53Query the ELF class for a binary object descriptor.
54.It Fn elftc_bfd_target_byteorder
55Query the byte order for a binary object descriptor.
56.It Fn elftc_bfd_target_flavor
57Query the object format for a binary object descriptor.
58.It Fn elftc_bfd_target_machine
59Query the target machine for a binary object descriptor.
60.El
61.It "C++ support"
62.Bl -tag -compact
63.It Fn elftc_demangle
64Decodes a symbol name encoded according to the encoding rules for the
65C++ language.
66.El
67.It "Programming conveniences"
68.Bl -tag -compact
69.It Fn elftc_copyfile
70Copies the contents of a file to another.
71.It Fn elftc_set_timestamp
72Portably set the time stamps on a file.
73.El
74.It "Project Configuration"
75.Bl -tag -compact
76.It Fn elftc_version
77Returns a project-wide identifier string that encodes the source
78revision of the source tree.
79.El
80.El
81.Sh SEE ALSO
82.Xr dwarf 3 ,
83.Xr elf 3
84