xref: /freebsd/usr.sbin/crunch/crunchide/crunchide.1 (revision 9fe6a96a879d0d65acf48cd812734f781036edef)
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
28de566360SJordan K. Hubbard.Os BSD 4
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
33de566360SJordan K. Hubbard.Nm crunchide
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
38de566360SJordan K. Hubbard
39de566360SJordan K. Hubbard.Nm Crunchide
40de566360SJordan K. Hubbardhides 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
48de566360SJordan K. Hubbardoptions.  The
49de566360SJordan K. Hubbard.Ar keep-list-file
50de566360SJordan K. Hubbardmust contain a list of symbols to keep visible, one symbol per line.
519fe6a96aSJohn HayThe names given by
529fe6a96aSJohn Hay.Ar keep-symbol
539fe6a96aSJohn Hayor in
549fe6a96aSJohn Hay.Ar keep-list-file
559fe6a96aSJohn Hayshould be C names.  For example,
569fe6a96aSJohn Hayto keep the C function
579fe6a96aSJohn Hay.Dq foo
589fe6a96aSJohn Hayvisible, the option
599fe6a96aSJohn Hay.Dq -k foo
609fe6a96aSJohn Hayshould be used.
61de566360SJordan K. Hubbard.Pp
62de566360SJordan K. Hubbard.Nm Crunchide
63de566360SJordan K. Hubbardis designed as a companion program for
64de566360SJordan K. Hubbard.Xr crunchgen 1 ,
65de566360SJordan K. Hubbardwhich automates the process of creating crunched binaries from
66de566360SJordan K. Hubbardmultiple component programs.
67de566360SJordan K. Hubbard.Sh SEE ALSO
68de566360SJordan K. Hubbard.Xr crunchgen 1 ,
69de566360SJordan K. Hubbard.Xr ld 1
70f12a1471SPhilippe Charnier.Sh AUTHORS
71de566360SJordan K. Hubbard.Nm Crunch
72f12a1471SPhilippe Charnierwas written by
73f12a1471SPhilippe Charnier.An James da Silva Aq jds@cs.umd.edu .
749fe6a96aSJohn Hay.sp 0
75de566360SJordan K. HubbardCopyright (c) 1994 University of Maryland.  All Rights Reserved.
769fe6a96aSJohn Hay.Pp
779fe6a96aSJohn HayChris Demetriou <cgd@netbsd.org> reorganized
789fe6a96aSJohn Hay.Nm
799fe6a96aSJohn Hayso that it supported multiple object formats, and added
809fe6a96aSJohn HayELF object support and ECOFF object recognition.
819fe6a96aSJohn Hay.sp 0
829fe6a96aSJohn HayCopyright (c) 1997 Christopher G. Demetriou.  All Rights Reserved.
83