xref: /freebsd/usr.sbin/crunch/crunchide/crunchide.1 (revision 0c43d89a0d8e976ca494d4837f4c1f3734d2c300)
1.\"
2.\" Copyright (c) 1994 University of Maryland
3.\" All Rights Reserved.
4.\"
5.\" Permission to use, copy, modify, distribute, and sell this software and its
6.\" documentation for any purpose is hereby granted without fee, provided that
7.\" the above copyright notice appear in all copies and that both that
8.\" copyright notice and this permission notice appear in supporting
9.\" documentation, and that the name of U.M. not be used in advertising or
10.\" publicity pertaining to distribution of the software without specific,
11.\" written prior permission.  U.M. makes no representations about the
12.\" suitability of this software for any purpose.  It is provided "as is"
13.\" without express or implied warranty.
14.\"
15.\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
17.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
18.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
20.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21.\"
22.\" Author: James da Silva, Systems Design and Analysis Group
23.\"			   Computer Science Department
24.\"			   University of Maryland at College Park
25.\"
26.Dd June 14, 1994
27.Dt CRUNCHIDE 1
28.Os BSD 4
29.Sh NAME
30.Nm crunchide
31.Nd hides symbol names from ld, for crunching programs together
32.Sh SYNOPSIS
33.Nm crunchide
34.Op Fl f Ar keep-list-file
35.Op Fl k Ar keep-symbol
36.Op Ar object-file ...
37.Sh DESCRIPTION
38
39.Nm Crunchide
40hides the global symbols of
41.Ar object-file
42such that they are ignored by subsequent runs of the linker,
43.Xr ld 1 .
44Some symbols may be left visible via the
45.Fl k Ar keep-symbol
46and
47.Fl f Ar keep-list-file
48options.  The
49.Ar keep-list-file
50must contain a list of symbols to keep visible, one symbol per line.
51Note that the C compiler prepends an underscore in front of
52symbols, so to keep the C function ``foo'' visible, the option
53\&``-k _foo'' must be used.
54
55.Pp
56.Nm Crunchide
57is designed as a companion program for
58.Xr crunchgen 1 ,
59which automates the process of creating crunched binaries from
60multiple component programs.
61.Sh SEE ALSO
62.Xr crunchgen 1 ,
63.Xr ld 1
64.Sh AUTHOR
65.Nm Crunch
66was written by James da Silva <jds@cs.umd.edu>.
67.sp 0
68Copyright (c) 1994 University of Maryland.  All Rights Reserved.
69