1.\" $NetBSD: crunchide.1,v 1.11 2002/02/08 01:36:22 ross Exp $ 2.\" 3.\" Copyright (c) 1994 University of Maryland 4.\" All Rights Reserved. 5.\" 6.\" Permission to use, copy, modify, distribute, and sell this software and its 7.\" documentation for any purpose is hereby granted without fee, provided that 8.\" the above copyright notice appear in all copies and that both that 9.\" copyright notice and this permission notice appear in supporting 10.\" documentation, and that the name of U.M. not be used in advertising or 11.\" publicity pertaining to distribution of the software without specific, 12.\" written prior permission. U.M. makes no representations about the 13.\" suitability of this software for any purpose. It is provided "as is" 14.\" without express or implied warranty. 15.\" 16.\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL 17.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M. 18.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 19.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 20.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR 21.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 22.\" 23.\" Author: James da Silva, Systems Design and Analysis Group 24.\" Computer Science Department 25.\" University of Maryland at College Park 26.\" 27.Dd June 14, 1994 28.Dt CRUNCHIDE 1 29.Os 30.Sh NAME 31.Nm crunchide 32.Nd hides symbol names from ld, for crunching programs together 33.Sh SYNOPSIS 34.Nm "" 35.Bk -words 36.Op Fl f Ar keep-list-file 37.Ek 38.Bk -words 39.Op Fl k Ar keep-symbol 40.Ek 41.Bk -words 42.Op Ar object-file ... 43.Ek 44.Sh DESCRIPTION 45.Nm 46hides the global symbols of 47.Ar object-file 48such that they are ignored by subsequent runs of the linker, 49.Xr ld 1 . 50Some symbols may be left visible via the 51.Fl k Ar keep-symbol 52and 53.Fl f Ar keep-list-file 54options. The 55.Ar keep-list-file 56must contain a list of symbols to keep visible, one symbol per line. 57The names given by 58.Ar keep-symbol 59or in 60.Ar keep-list-file 61should be C names. For example, 62to keep the C function 63.Dq foo 64visible, the option 65.Dq -k foo 66should be used. 67.Pp 68.Nm 69is designed as a companion program for 70.Xr crunchgen 1 , 71which automates the process of creating crunched binaries from 72multiple component programs. 73.Sh SEE ALSO 74.Xr crunchgen 1 , 75.Xr ld 1 76.Sh AUTHORS 77.Nm 78was written by James da Silva \*[Lt]jds@cs.umd.edu\*[Gt]. 79.sp 0 80Copyright (c) 1994 University of Maryland. All Rights Reserved. 81.Pp 82Chris Demetriou \*[Lt]cgd@netbsd.org\*[Gt] reorganized 83.Nm 84so that it supported multiple object formats, and added 85ELF object support and ECOFF object recognition. 86.sp 0 87Copyright (c) 1997 Christopher G. Demetriou. All Rights Reserved. 88