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.\" 29*5727eceaSMark Johnston.Dd April 21, 2022 308be96e10SRui Paulo.Dt CTFMERGE 1 318be96e10SRui Paulo.Os 328be96e10SRui Paulo.Sh NAME 338be96e10SRui Paulo.Nm ctfmerge 348be96e10SRui Paulo.Nd merge several CTF data sections into one 358be96e10SRui Paulo.Sh SYNOPSIS 368be96e10SRui Paulo.Nm 378be96e10SRui Paulo.Op Fl fgstv 388be96e10SRui Paulo.Fl l Ar label 398be96e10SRui Paulo.Fl L Ar labelenv 408be96e10SRui Paulo.Fl o Ar outfile 418be96e10SRui Paulofile ... 428be96e10SRui Paulo.Nm 438be96e10SRui Paulo.Op Fl fgstv 448be96e10SRui Paulo.Fl l Ar label 458be96e10SRui Paulo.Fl L Ar labelenv 468be96e10SRui Paulo.Fl o Ar outfile 478be96e10SRui Paulo.Fl d Ar uniqfile 488be96e10SRui Paulo.Op Fl g 498be96e10SRui Paulo.Op Fl D Ar uniqlabel 508be96e10SRui Paulofile ... 518be96e10SRui Paulo.Nm 528be96e10SRui Paulo.Op Fl fgstv 538be96e10SRui Paulo.Fl l Ar label 548be96e10SRui Paulo.Fl L Ar labelenv 558be96e10SRui Paulo.Fl o Ar outfile 568be96e10SRui Paulo.Fl w Ar withfile 578be96e10SRui Paulofile ... 588be96e10SRui Paulo.Nm 598be96e10SRui Paulo.Op Fl g 608be96e10SRui Paulo.Fl c Ar srcfile 618be96e10SRui Paulo.Ar destfile 628be96e10SRui Paulo.Sh DESCRIPTION 638be96e10SRui PauloThe 648be96e10SRui Paulo.Nm 65*5727eceaSMark Johnstonutility merges several CTF (Compact C Type Format) data sections from several 66*5727eceaSMark Johnstonfiles into one output file, unifying common data. 678be96e10SRui Paulo.Pp 688be96e10SRui PauloThe following options are available: 698be96e10SRui Paulo.Bl -tag -width indent 708be96e10SRui Paulo.It Fl f 718be96e10SRui PauloMatch global symbols to global CTF data. 728be96e10SRui Paulo.It Fl g 738be96e10SRui PauloDon't delete the original debugging sections. 748be96e10SRui Paulo.It Fl s 758be96e10SRui PauloUse the .dynsym ELF section instead of the .symtab ELF section. 768be96e10SRui Paulo.It Fl t 778be96e10SRui PauloMake sure that all object files have a CTF section. 788be96e10SRui Paulo.It Fl v 798be96e10SRui PauloEnable verbose mode. 808be96e10SRui Paulo.It Fl l Ar label 818be96e10SRui PauloSets the label as 828be96e10SRui Paulo.Ar label . 838be96e10SRui Paulo.It Fl L Ar labelenv 848be96e10SRui PauloInstructs 858be96e10SRui Paulo.Nm 868be96e10SRui Pauloto read the label from the environment variable 878be96e10SRui Paulo.Ar labelenv . 888be96e10SRui Paulo.It Fl o Ar outfile 898be96e10SRui PauloUse 908be96e10SRui Paulo.Ar outfile 918be96e10SRui Pauloto store the merged CTF data. 928be96e10SRui Paulo.It Fl d Ar uniqfile 938be96e10SRui PauloUniquify against 948be96e10SRui Paulo.Ar uniqfile . 958be96e10SRui Paulo.It Fl d Ar uniqlabel 968be96e10SRui PauloUniquify against label 978be96e10SRui Paulo.Ar uniqlabel 988be96e10SRui Paulo.It Fl w Ar withfile 998be96e10SRui PauloAdditive merge with 1008be96e10SRui Paulo.Ar withfile . 1018be96e10SRui Paulo.It Fl c Ar srcfile Ar destfile 1028be96e10SRui PauloCopy CTF data from 1038be96e10SRui Paulo.Ar srcfile 1048be96e10SRui Paulointo 1058be96e10SRui Paulo.Ar destfile . 1068be96e10SRui Paulo.El 1078be96e10SRui Paulo.Sh EXIT STATUS 1088be96e10SRui Paulo.Ex -std 1098be96e10SRui Paulo.Sh SEE ALSO 1108be96e10SRui Paulo.Xr ctfconvert 1 , 111*5727eceaSMark Johnston.Xr ctfdump 1 , 112*5727eceaSMark Johnston.Xr ctf 5 1138be96e10SRui Paulo.Sh HISTORY 1148be96e10SRui PauloThe 1158be96e10SRui Paulo.Nm 1168be96e10SRui Pauloutility first appeared in 1178be96e10SRui Paulo.Fx 7.0 . 1188be96e10SRui Paulo.Sh AUTHORS 1198be96e10SRui PauloThe CTF utilities came from OpenSolaris. 120