1*6cb10275Sriastradh.\" $NetBSD: crunchide.1,v 1.17 2014/03/18 18:20:44 riastradh Exp $ 2ee36043fScgd.\" 3ee36043fScgd.\" Copyright (c) 1994 University of Maryland 4ee36043fScgd.\" All Rights Reserved. 5ee36043fScgd.\" 6ee36043fScgd.\" Permission to use, copy, modify, distribute, and sell this software and its 7ee36043fScgd.\" documentation for any purpose is hereby granted without fee, provided that 8ee36043fScgd.\" the above copyright notice appear in all copies and that both that 9ee36043fScgd.\" copyright notice and this permission notice appear in supporting 10ee36043fScgd.\" documentation, and that the name of U.M. not be used in advertising or 11ee36043fScgd.\" publicity pertaining to distribution of the software without specific, 12ee36043fScgd.\" written prior permission. U.M. makes no representations about the 13ee36043fScgd.\" suitability of this software for any purpose. It is provided "as is" 14ee36043fScgd.\" without express or implied warranty. 15ee36043fScgd.\" 16ee36043fScgd.\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL 17ee36043fScgd.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M. 18ee36043fScgd.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 19ee36043fScgd.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 20ee36043fScgd.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR 21ee36043fScgd.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 22ee36043fScgd.\" 23ee36043fScgd.\" Author: James da Silva, Systems Design and Analysis Group 24ee36043fScgd.\" Computer Science Department 25ee36043fScgd.\" University of Maryland at College Park 26ee36043fScgd.\" 27ee36043fScgd.Dd June 14, 1994 28ee36043fScgd.Dt CRUNCHIDE 1 299e44e9b5Sgarbled.Os 30ee36043fScgd.Sh NAME 31ee36043fScgd.Nm crunchide 32ee36043fScgd.Nd hides symbol names from ld, for crunching programs together 33ee36043fScgd.Sh SYNOPSIS 34990562bfSwiz.Nm 35ee36043fScgd.Op Fl f Ar keep-list-file 36ee36043fScgd.Op Fl k Ar keep-symbol 3771ad289aSwiz.Ar object-file 38ee36043fScgd.Op Ar object-file ... 39ee36043fScgd.Sh DESCRIPTION 40279552d3Slukem.Nm 41ee36043fScgdhides the global symbols of 42ee36043fScgd.Ar object-file 43ee36043fScgdsuch that they are ignored by subsequent runs of the linker, 44ee36043fScgd.Xr ld 1 . 45ee36043fScgdSome symbols may be left visible via the 46ee36043fScgd.Fl k Ar keep-symbol 47ee36043fScgdand 48ee36043fScgd.Fl f Ar keep-list-file 4971ad289aSwizoptions. 5071ad289aSwizThe 51ee36043fScgd.Ar keep-list-file 52ee36043fScgdmust contain a list of symbols to keep visible, one symbol per line. 534790c9bcScgdThe names given by 544790c9bcScgd.Ar keep-symbol 554790c9bcScgdor in 564790c9bcScgd.Ar keep-list-file 5771ad289aSwizshould be C names. 5871ad289aSwizFor example, to keep the C function 594790c9bcScgd.Dq foo 604790c9bcScgdvisible, the option 614790c9bcScgd.Dq -k foo 624790c9bcScgdshould be used. 63ee36043fScgd.Pp 64279552d3Slukem.Nm 65ee36043fScgdis designed as a companion program for 66ee36043fScgd.Xr crunchgen 1 , 67ee36043fScgdwhich automates the process of creating crunched binaries from 68ee36043fScgdmultiple component programs. 69ee36043fScgd.Sh SEE ALSO 70ee36043fScgd.Xr crunchgen 1 , 71ee36043fScgd.Xr ld 1 724790c9bcScgd.Sh AUTHORS 73279552d3Slukem.Nm 7471ad289aSwizwas written by 75a5684d07Swiz.An James da Silva Aq Mt jds@cs.umd.edu . 764790c9bcScgd.Pp 7771ad289aSwizCopyright (c) 1994 University of Maryland. 7871ad289aSwizAll Rights Reserved. 7971ad289aSwiz.Pp 8071ad289aSwizChris Demetriou 8171ad289aSwiz.Aq cgd@NetBSD.org 8271ad289aSwizreorganized 834790c9bcScgd.Nm 844790c9bcScgdso that it supported multiple object formats, and added 854790c9bcScgdELF object support and ECOFF object recognition. 8671ad289aSwiz.Pp 8771ad289aSwizCopyright (c) 1997 Christopher G. Demetriou. 8871ad289aSwizAll Rights Reserved. 89