xref: /freebsd/usr.sbin/crunch/crunchide/crunchide.1 (revision e8d8bef961a50d4dc22501cde4fb9fb0be1b2532)
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.\" $FreeBSD$
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.Op Fl f Ar keep-list-file
36.Op Fl k Ar keep-symbol
37.Op Ar object-file ...
38.Sh DESCRIPTION
39The
40.Nm
41utility hides the global symbols of
42.Ar object-file
43such that they are ignored by subsequent runs of the linker,
44.Xr ld 1 .
45Some symbols may be left visible via the
46.Fl k Ar keep-symbol
47and
48.Fl f Ar keep-list-file
49options.
50The
51.Ar keep-list-file
52must contain a list of symbols to keep visible, one symbol per line.
53The names given by
54.Ar keep-symbol
55or in
56.Ar keep-list-file
57should be C names.
58For example,
59to keep the C function
60.Dq foo
61visible, the option
62.Dq -k foo
63should be used.
64.Pp
65The
66.Nm
67utility is designed as a companion program for
68.Xr crunchgen 1 ,
69which automates the process of creating crunched binaries from
70multiple component programs.
71.Sh SEE ALSO
72.Xr crunchgen 1 ,
73.Xr ld 1
74.Sh AUTHORS
75.An -nosplit
76The
77.Nm crunch
78utility was written by
79.An James da Silva Aq Mt jds@cs.umd.edu .
80.Pp
81Copyright (c) 1994 University of Maryland.
82All Rights Reserved.
83.Pp
84.An Chris Demetriou Aq Mt cgd@netbsd.org
85reorganized
86.Nm
87so that it supported multiple object formats, and added
88ELF object support and ECOFF object recognition.
89.Pp
90Copyright (c) 1997
91.An Christopher G. Demetriou .
92All Rights Reserved.
93