xref: /freebsd/usr.sbin/crunch/crunchide/crunchide.1 (revision b2c76c41be32f904179efed29c0ca04d53f3996c)
1de566360SJordan K. Hubbard.\"
2de566360SJordan K. Hubbard.\" Copyright (c) 1994 University of Maryland
3de566360SJordan K. Hubbard.\" All Rights Reserved.
4de566360SJordan K. Hubbard.\"
5de566360SJordan K. Hubbard.\" Permission to use, copy, modify, distribute, and sell this software and its
6de566360SJordan K. Hubbard.\" documentation for any purpose is hereby granted without fee, provided that
7de566360SJordan K. Hubbard.\" the above copyright notice appear in all copies and that both that
8de566360SJordan K. Hubbard.\" copyright notice and this permission notice appear in supporting
9de566360SJordan K. Hubbard.\" documentation, and that the name of U.M. not be used in advertising or
10de566360SJordan K. Hubbard.\" publicity pertaining to distribution of the software without specific,
11de566360SJordan K. Hubbard.\" written prior permission.  U.M. makes no representations about the
12de566360SJordan K. Hubbard.\" suitability of this software for any purpose.  It is provided "as is"
13de566360SJordan K. Hubbard.\" without express or implied warranty.
14de566360SJordan K. Hubbard.\"
15de566360SJordan K. Hubbard.\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
16de566360SJordan K. Hubbard.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
17de566360SJordan K. Hubbard.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
18de566360SJordan K. Hubbard.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19de566360SJordan K. Hubbard.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
20de566360SJordan K. Hubbard.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21de566360SJordan K. Hubbard.\"
22de566360SJordan K. Hubbard.\" Author: James da Silva, Systems Design and Analysis Group
23de566360SJordan K. Hubbard.\"			   Computer Science Department
24de566360SJordan K. Hubbard.\"			   University of Maryland at College Park
25de566360SJordan K. Hubbard.\"
26de566360SJordan K. Hubbard.Dd June 14, 1994
27de566360SJordan K. Hubbard.Dt CRUNCHIDE 1
28a4c37c81SRuslan Ermilov.Os
29de566360SJordan K. Hubbard.Sh NAME
30de566360SJordan K. Hubbard.Nm crunchide
31de566360SJordan K. Hubbard.Nd hides symbol names from ld, for crunching programs together
32de566360SJordan K. Hubbard.Sh SYNOPSIS
33e97407b4SRuslan Ermilov.Nm
34de566360SJordan K. Hubbard.Op Fl f Ar keep-list-file
35de566360SJordan K. Hubbard.Op Fl k Ar keep-symbol
36de566360SJordan K. Hubbard.Op Ar object-file ...
37de566360SJordan K. Hubbard.Sh DESCRIPTION
387f94b8deSPhilippe CharnierThe
397f94b8deSPhilippe Charnier.Nm
407f94b8deSPhilippe Charnierutility hides the global symbols of
41de566360SJordan K. Hubbard.Ar object-file
42de566360SJordan K. Hubbardsuch that they are ignored by subsequent runs of the linker,
43de566360SJordan K. Hubbard.Xr ld 1 .
44de566360SJordan K. HubbardSome symbols may be left visible via the
45de566360SJordan K. Hubbard.Fl k Ar keep-symbol
46de566360SJordan K. Hubbardand
47de566360SJordan K. Hubbard.Fl f Ar keep-list-file
4807bfccd7SRuslan Ermilovoptions.
4907bfccd7SRuslan ErmilovThe
50de566360SJordan K. Hubbard.Ar keep-list-file
51de566360SJordan K. Hubbardmust contain a list of symbols to keep visible, one symbol per line.
529fe6a96aSJohn HayThe names given by
539fe6a96aSJohn Hay.Ar keep-symbol
549fe6a96aSJohn Hayor in
559fe6a96aSJohn Hay.Ar keep-list-file
5607bfccd7SRuslan Ermilovshould be C names.
5707bfccd7SRuslan ErmilovFor example,
589fe6a96aSJohn Hayto keep the C function
599fe6a96aSJohn Hay.Dq foo
609fe6a96aSJohn Hayvisible, the option
619fe6a96aSJohn Hay.Dq -k foo
629fe6a96aSJohn Hayshould be used.
63de566360SJordan K. Hubbard.Pp
647f94b8deSPhilippe CharnierThe
657f94b8deSPhilippe Charnier.Nm
667f94b8deSPhilippe Charnierutility is designed as a companion program for
67de566360SJordan K. Hubbard.Xr crunchgen 1 ,
68de566360SJordan K. Hubbardwhich automates the process of creating crunched binaries from
69de566360SJordan K. Hubbardmultiple component programs.
70de566360SJordan K. Hubbard.Sh SEE ALSO
71de566360SJordan K. Hubbard.Xr crunchgen 1 ,
72de566360SJordan K. Hubbard.Xr ld 1
73f12a1471SPhilippe Charnier.Sh AUTHORS
7407bfccd7SRuslan Ermilov.An -nosplit
757f94b8deSPhilippe CharnierThe
767f94b8deSPhilippe Charnier.Nm crunch
777f94b8deSPhilippe Charnierutility was written by
78*01c2b8acSBaptiste Daroussin.An James da Silva Aq Mt jds@cs.umd.edu .
79726b61abSRuslan Ermilov.Pp
8007bfccd7SRuslan ErmilovCopyright (c) 1994 University of Maryland.
8107bfccd7SRuslan ErmilovAll Rights Reserved.
829fe6a96aSJohn Hay.Pp
83*01c2b8acSBaptiste Daroussin.An Chris Demetriou Aq Mt cgd@netbsd.org
84557f7e71SPhilippe Charnierreorganized
859fe6a96aSJohn Hay.Nm
869fe6a96aSJohn Hayso that it supported multiple object formats, and added
879fe6a96aSJohn HayELF object support and ECOFF object recognition.
88726b61abSRuslan Ermilov.Pp
8907bfccd7SRuslan ErmilovCopyright (c) 1997
9007bfccd7SRuslan Ermilov.An Christopher G. Demetriou .
9107bfccd7SRuslan ErmilovAll Rights Reserved.
92