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