1994-06-15 10:33:49 +00:00
|
|
|
.\"
|
|
|
|
|
.\" Copyright (c) 1994 University of Maryland
|
|
|
|
|
.\" All Rights Reserved.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Permission to use, copy, modify, distribute, and sell this software and its
|
|
|
|
|
.\" documentation for any purpose is hereby granted without fee, provided that
|
|
|
|
|
.\" the above copyright notice appear in all copies and that both that
|
|
|
|
|
.\" copyright notice and this permission notice appear in supporting
|
|
|
|
|
.\" documentation, and that the name of U.M. not be used in advertising or
|
|
|
|
|
.\" publicity pertaining to distribution of the software without specific,
|
|
|
|
|
.\" written prior permission. U.M. makes no representations about the
|
|
|
|
|
.\" suitability of this software for any purpose. It is provided "as is"
|
|
|
|
|
.\" without express or implied warranty.
|
|
|
|
|
.\"
|
|
|
|
|
.\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
|
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
|
|
|
|
|
.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
|
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
|
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
|
|
|
|
.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Author: James da Silva, Systems Design and Analysis Group
|
|
|
|
|
.\" Computer Science Department
|
|
|
|
|
.\" University of Maryland at College Park
|
1999-08-28 01:35:59 +00:00
|
|
|
.\" $FreeBSD$
|
1994-06-15 10:33:49 +00:00
|
|
|
.\"
|
|
|
|
|
.Dd June 14, 1994
|
|
|
|
|
.Dt CRUNCHIDE 1
|
2001-07-10 15:12:08 +00:00
|
|
|
.Os
|
1994-06-15 10:33:49 +00:00
|
|
|
.Sh NAME
|
|
|
|
|
.Nm crunchide
|
|
|
|
|
.Nd hides symbol names from ld, for crunching programs together
|
|
|
|
|
.Sh SYNOPSIS
|
2000-11-20 20:10:44 +00:00
|
|
|
.Nm
|
1994-06-15 10:33:49 +00:00
|
|
|
.Op Fl f Ar keep-list-file
|
|
|
|
|
.Op Fl k Ar keep-symbol
|
|
|
|
|
.Op Ar object-file ...
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm Crunchide
|
|
|
|
|
hides the global symbols of
|
|
|
|
|
.Ar object-file
|
2001-07-15 08:06:20 +00:00
|
|
|
such that they are ignored by subsequent runs of the linker,
|
1994-06-15 10:33:49 +00:00
|
|
|
.Xr ld 1 .
|
|
|
|
|
Some symbols may be left visible via the
|
|
|
|
|
.Fl k Ar keep-symbol
|
2001-07-15 08:06:20 +00:00
|
|
|
and
|
1994-06-15 10:33:49 +00:00
|
|
|
.Fl f Ar keep-list-file
|
|
|
|
|
options. The
|
|
|
|
|
.Ar keep-list-file
|
|
|
|
|
must contain a list of symbols to keep visible, one symbol per line.
|
1998-09-16 09:26:14 +00:00
|
|
|
The names given by
|
|
|
|
|
.Ar keep-symbol
|
|
|
|
|
or in
|
|
|
|
|
.Ar keep-list-file
|
|
|
|
|
should be C names. For example,
|
2001-07-15 08:06:20 +00:00
|
|
|
to keep the C function
|
1998-09-16 09:26:14 +00:00
|
|
|
.Dq foo
|
2001-07-15 08:06:20 +00:00
|
|
|
visible, the option
|
|
|
|
|
.Dq -k foo
|
1998-09-16 09:26:14 +00:00
|
|
|
should be used.
|
1994-06-15 10:33:49 +00:00
|
|
|
.Pp
|
|
|
|
|
.Nm Crunchide
|
2001-07-15 08:06:20 +00:00
|
|
|
is designed as a companion program for
|
1994-06-15 10:33:49 +00:00
|
|
|
.Xr crunchgen 1 ,
|
|
|
|
|
which automates the process of creating crunched binaries from
|
|
|
|
|
multiple component programs.
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr crunchgen 1 ,
|
|
|
|
|
.Xr ld 1
|
1998-03-23 08:31:20 +00:00
|
|
|
.Sh AUTHORS
|
1994-06-15 10:33:49 +00:00
|
|
|
.Nm Crunch
|
1998-03-23 08:31:20 +00:00
|
|
|
was written by
|
|
|
|
|
.An James da Silva Aq jds@cs.umd.edu .
|
2000-11-10 17:46:15 +00:00
|
|
|
.Pp
|
1994-06-15 10:33:49 +00:00
|
|
|
Copyright (c) 1994 University of Maryland. All Rights Reserved.
|
1998-09-16 09:26:14 +00:00
|
|
|
.Pp
|
|
|
|
|
Chris Demetriou <cgd@netbsd.org> reorganized
|
|
|
|
|
.Nm
|
|
|
|
|
so that it supported multiple object formats, and added
|
|
|
|
|
ELF object support and ECOFF object recognition.
|
2000-11-10 17:46:15 +00:00
|
|
|
.Pp
|
1998-09-16 09:26:14 +00:00
|
|
|
Copyright (c) 1997 Christopher G. Demetriou. All Rights Reserved.
|
