18be96e10SRui Paulo.\" 28be96e10SRui Paulo.\" Copyright (c) 2010 The FreeBSD Foundation 38be96e10SRui Paulo.\" All rights reserved. 48be96e10SRui Paulo.\" 58be96e10SRui Paulo.\" This software was developed by Rui Paulo under sponsorship from the 68be96e10SRui Paulo.\" FreeBSD Foundation. 78be96e10SRui Paulo.\" 88be96e10SRui Paulo.\" Redistribution and use in source and binary forms, with or without 98be96e10SRui Paulo.\" modification, are permitted provided that the following conditions 108be96e10SRui Paulo.\" are met: 118be96e10SRui Paulo.\" 1. Redistributions of source code must retain the above copyright 128be96e10SRui Paulo.\" notice, this list of conditions and the following disclaimer. 138be96e10SRui Paulo.\" 2. Redistributions in binary form must reproduce the above copyright 148be96e10SRui Paulo.\" notice, this list of conditions and the following disclaimer in the 158be96e10SRui Paulo.\" documentation and/or other materials provided with the distribution. 168be96e10SRui Paulo.\" 178be96e10SRui Paulo.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 188be96e10SRui Paulo.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 198be96e10SRui Paulo.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 208be96e10SRui Paulo.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 218be96e10SRui Paulo.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 228be96e10SRui Paulo.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 238be96e10SRui Paulo.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 248be96e10SRui Paulo.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 258be96e10SRui Paulo.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 268be96e10SRui Paulo.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 278be96e10SRui Paulo.\" SUCH DAMAGE. 288be96e10SRui Paulo.\" 298be96e10SRui Paulo.\" $FreeBSD$ 308be96e10SRui Paulo.\" 318be96e10SRui Paulo.Dd July 7, 2010 328be96e10SRui Paulo.Dt CTFCONVERT 1 338be96e10SRui Paulo.Os 348be96e10SRui Paulo.Sh NAME 358be96e10SRui Paulo.Nm ctfconvert 368be96e10SRui Paulo.Nd convert debug data to CTF data 378be96e10SRui Paulo.Sh SYNOPSIS 388be96e10SRui Paulo.Nm 398be96e10SRui Paulo.Op Fl gis 408be96e10SRui Paulo.Fl l Ar label 418be96e10SRui Paulo.Fl L Ar labelenv 428be96e10SRui Paulo.Op Fl o Ar outfile 438be96e10SRui Pauloobject_file 448be96e10SRui Paulo.Sh DESCRIPTION 458be96e10SRui PauloThe 468be96e10SRui Paulo.Nm 478be96e10SRui Pauloutility converts debug information from a binary file to CTF data and replaces 488be96e10SRui Paulothe debug section of that file with a CTF section called SUNW_ctf. 498be96e10SRui PauloThis new section is added to the input file, unless the -o 508be96e10SRui Paulooption is present. 518be96e10SRui PauloYou can also opt to keep the original debugging section with the 528be96e10SRui Paulo-g option. 538be96e10SRui Paulo.Pp 548be96e10SRui PauloThe following options are available: 558be96e10SRui Paulo.Bl -tag -width indent 568be96e10SRui Paulo.It Fl l Ar label 578be96e10SRui PauloSets the label as 588be96e10SRui Paulo.Ar label . 598be96e10SRui Paulo.It Fl L Ar labelenv 608be96e10SRui PauloInstructs 618be96e10SRui Paulo.Nm 628be96e10SRui Pauloto read the label from the environment variable 638be96e10SRui Paulo.Ar labelenv . 648be96e10SRui Paulo.It Fl g 658be96e10SRui PauloDon't delete the original debugging section. 668be96e10SRui Paulo.It Fl i 678be96e10SRui PauloIgnore object files built from other languages than C. 688be96e10SRui Paulo.It Fl s 698be96e10SRui PauloUse the .dynsym ELF section instead of the .symtab ELF section. 708be96e10SRui Paulo.It Fl o Ar outfile 718be96e10SRui PauloWrite the output to file in 728be96e10SRui Paulo.Ar outfile . 738be96e10SRui Paulo.El 748be96e10SRui Paulo.Sh EXIT STATUS 758be96e10SRui Paulo.Ex -std 768be96e10SRui Paulo.Sh SEE ALSO 77*4990a1c0SJoel Dahl.Xr ctfdump 1 , 78*4990a1c0SJoel Dahl.Xr ctfmerge 1 798be96e10SRui Paulo.Sh HISTORY 808be96e10SRui PauloThe 818be96e10SRui Paulo.Nm 828be96e10SRui Pauloutility first appeared in 838be96e10SRui Paulo.Fx 7.0 . 848be96e10SRui Paulo.Sh AUTHORS 858be96e10SRui PauloThe CTF utilities came from OpenSolaris. 86