xref: /openbsd-src/usr.bin/ctfconv/ctfconv.1 (revision f273b081c91dc2a2c134252b43a1b2c9bf96c926)
1.\"	$OpenBSD: ctfconv.1,v 1.8 2017/10/17 22:47:58 schwarze Exp $
2.\"
3.\" Copyright (c) 2016 Martin Pieuchot <mpi@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: October 17 2017 $
18.Dt CTFCONV 1
19.Os
20.Sh NAME
21.Nm ctfconv
22.Nd generates a raw CTF section from debug data
23.Sh SYNOPSIS
24.Nm ctfconv
25.Op Fl d
26.Fl l Ar label
27.Fl o Ar outfile
28.Ar file
29.Sh DESCRIPTION
30The
31.Nm
32utility parses DWARF debug sections of
33.Ar file
34to generate
35.Dv CTF
36data.
37.Pp
38The options are as follows:
39.Bl -tag -width Ds
40.It Fl d
41Display types as if they would be dumped from a
42.Dv .SUNW_ctf
43section by
44.Xr ctfdump 1
45and exit.
46This option cannot be used in conjunction with other modes of operation.
47.It Fl l Ar label
48Set the
49.Dv CTF
50label to
51.Ar label .
52.It Fl o Ar outfile
53Write the raw section in
54.Ar outfile .
55.El
56.Sh EXIT STATUS
57.Ex -std ctfconv
58.Sh SEE ALSO
59.Xr ctfdump 1 ,
60.Xr ctfstrip 1
61.Sh HISTORY
62The
63.Nm
64utility first appeared in
65.Ox 6.2 .
66.Sh AUTHORS
67.An Martin Pieuchot Aq Mt mpi@openbsd.org
68