1*8be96e10SRui Paulo.\" 2*8be96e10SRui Paulo.\" Copyright (c) 2010 The FreeBSD Foundation 3*8be96e10SRui Paulo.\" All rights reserved. 4*8be96e10SRui Paulo.\" 5*8be96e10SRui Paulo.\" This software was developed by Rui Paulo under sponsorship from the 6*8be96e10SRui Paulo.\" FreeBSD Foundation. 7*8be96e10SRui Paulo.\" 8*8be96e10SRui Paulo.\" Redistribution and use in source and binary forms, with or without 9*8be96e10SRui Paulo.\" modification, are permitted provided that the following conditions 10*8be96e10SRui Paulo.\" are met: 11*8be96e10SRui Paulo.\" 1. Redistributions of source code must retain the above copyright 12*8be96e10SRui Paulo.\" notice, this list of conditions and the following disclaimer. 13*8be96e10SRui Paulo.\" 2. Redistributions in binary form must reproduce the above copyright 14*8be96e10SRui Paulo.\" notice, this list of conditions and the following disclaimer in the 15*8be96e10SRui Paulo.\" documentation and/or other materials provided with the distribution. 16*8be96e10SRui Paulo.\" 17*8be96e10SRui Paulo.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18*8be96e10SRui Paulo.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19*8be96e10SRui Paulo.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20*8be96e10SRui Paulo.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21*8be96e10SRui Paulo.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22*8be96e10SRui Paulo.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23*8be96e10SRui Paulo.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24*8be96e10SRui Paulo.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25*8be96e10SRui Paulo.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26*8be96e10SRui Paulo.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27*8be96e10SRui Paulo.\" SUCH DAMAGE. 28*8be96e10SRui Paulo.\" 29*8be96e10SRui Paulo.\" $FreeBSD$ 30*8be96e10SRui Paulo.\" 31*8be96e10SRui Paulo.Dd July 7, 2010 32*8be96e10SRui Paulo.Dt CTFMERGE 1 33*8be96e10SRui Paulo.Os 34*8be96e10SRui Paulo.Sh NAME 35*8be96e10SRui Paulo.Nm ctfmerge 36*8be96e10SRui Paulo.Nd merge several CTF data sections into one 37*8be96e10SRui Paulo.Sh SYNOPSIS 38*8be96e10SRui Paulo.Nm 39*8be96e10SRui Paulo.Op Fl fgstv 40*8be96e10SRui Paulo.Fl l Ar label 41*8be96e10SRui Paulo.Fl L Ar labelenv 42*8be96e10SRui Paulo.Fl o Ar outfile 43*8be96e10SRui Paulofile ... 44*8be96e10SRui Paulo.Nm 45*8be96e10SRui Paulo.Op Fl fgstv 46*8be96e10SRui Paulo.Fl l Ar label 47*8be96e10SRui Paulo.Fl L Ar labelenv 48*8be96e10SRui Paulo.Fl o Ar outfile 49*8be96e10SRui Paulo.Fl d Ar uniqfile 50*8be96e10SRui Paulo.Op Fl g 51*8be96e10SRui Paulo.Op Fl D Ar uniqlabel 52*8be96e10SRui Paulofile ... 53*8be96e10SRui Paulo.Nm 54*8be96e10SRui Paulo.Op Fl fgstv 55*8be96e10SRui Paulo.Fl l Ar label 56*8be96e10SRui Paulo.Fl L Ar labelenv 57*8be96e10SRui Paulo.Fl o Ar outfile 58*8be96e10SRui Paulo.Fl w Ar withfile 59*8be96e10SRui Paulofile ... 60*8be96e10SRui Paulo.Nm 61*8be96e10SRui Paulo.Op Fl g 62*8be96e10SRui Paulo.Fl c Ar srcfile 63*8be96e10SRui Paulo.Ar destfile 64*8be96e10SRui Paulo.Sh DESCRIPTION 65*8be96e10SRui PauloThe 66*8be96e10SRui Paulo.Nm 67*8be96e10SRui Pauloutility merges several CTF data sections from several files into one 68*8be96e10SRui Paulooutput file, unifying common data. 69*8be96e10SRui Paulo.Pp 70*8be96e10SRui PauloThe following options are available: 71*8be96e10SRui Paulo.Bl -tag -width indent 72*8be96e10SRui Paulo.It Fl f 73*8be96e10SRui PauloMatch global symbols to global CTF data. 74*8be96e10SRui Paulo.It Fl g 75*8be96e10SRui PauloDon't delete the original debugging sections. 76*8be96e10SRui Paulo.It Fl s 77*8be96e10SRui PauloUse the .dynsym ELF section instead of the .symtab ELF section. 78*8be96e10SRui Paulo.It Fl t 79*8be96e10SRui PauloMake sure that all object files have a CTF section. 80*8be96e10SRui Paulo.It Fl v 81*8be96e10SRui PauloEnable verbose mode. 82*8be96e10SRui Paulo.It Fl l Ar label 83*8be96e10SRui PauloSets the label as 84*8be96e10SRui Paulo.Ar label . 85*8be96e10SRui Paulo.It Fl L Ar labelenv 86*8be96e10SRui PauloInstructs 87*8be96e10SRui Paulo.Nm 88*8be96e10SRui Pauloto read the label from the environment variable 89*8be96e10SRui Paulo.Ar labelenv . 90*8be96e10SRui Paulo.It Fl o Ar outfile 91*8be96e10SRui PauloUse 92*8be96e10SRui Paulo.Ar outfile 93*8be96e10SRui Pauloto store the merged CTF data. 94*8be96e10SRui Paulo.It Fl d Ar uniqfile 95*8be96e10SRui PauloUniquify against 96*8be96e10SRui Paulo.Ar uniqfile . 97*8be96e10SRui Paulo.It Fl d Ar uniqlabel 98*8be96e10SRui PauloUniquify against label 99*8be96e10SRui Paulo.Ar uniqlabel 100*8be96e10SRui Paulo.It Fl w Ar withfile 101*8be96e10SRui PauloAdditive merge with 102*8be96e10SRui Paulo.Ar withfile . 103*8be96e10SRui Paulo.It Fl c Ar srcfile Ar destfile 104*8be96e10SRui PauloCopy CTF data from 105*8be96e10SRui Paulo.Ar srcfile 106*8be96e10SRui Paulointo 107*8be96e10SRui Paulo.Ar destfile . 108*8be96e10SRui Paulo.El 109*8be96e10SRui Paulo.Sh EXIT STATUS 110*8be96e10SRui Paulo.Ex -std 111*8be96e10SRui Paulo.Sh SEE ALSO 112*8be96e10SRui Paulo.Xr ctfconvert 1 , 113*8be96e10SRui Paulo.Xr ctfdump 1 114*8be96e10SRui Paulo.Sh HISTORY 115*8be96e10SRui PauloThe 116*8be96e10SRui Paulo.Nm 117*8be96e10SRui Pauloutility first appeared in 118*8be96e10SRui Paulo.Fx 7.0 . 119*8be96e10SRui Paulo.Sh AUTHORS 120*8be96e10SRui PauloThe CTF utilities came from OpenSolaris. 121