xref: /dflybsd-src/usr.bin/crunch/crunchide/crunchide.1 (revision 93b7dd6d088c37d3efa48fa7ace035768a033ca9)
1fc7e83faSFrançois Tigeot.\"
2fc7e83faSFrançois Tigeot.\" Copyright (c) 1994 University of Maryland
3fc7e83faSFrançois Tigeot.\" All Rights Reserved.
4fc7e83faSFrançois Tigeot.\"
5fc7e83faSFrançois Tigeot.\" Permission to use, copy, modify, distribute, and sell this software and its
6fc7e83faSFrançois Tigeot.\" documentation for any purpose is hereby granted without fee, provided that
7fc7e83faSFrançois Tigeot.\" the above copyright notice appear in all copies and that both that
8fc7e83faSFrançois Tigeot.\" copyright notice and this permission notice appear in supporting
9fc7e83faSFrançois Tigeot.\" documentation, and that the name of U.M. not be used in advertising or
10fc7e83faSFrançois Tigeot.\" publicity pertaining to distribution of the software without specific,
11fc7e83faSFrançois Tigeot.\" written prior permission.  U.M. makes no representations about the
12fc7e83faSFrançois Tigeot.\" suitability of this software for any purpose.  It is provided "as is"
13fc7e83faSFrançois Tigeot.\" without express or implied warranty.
14fc7e83faSFrançois Tigeot.\"
15fc7e83faSFrançois Tigeot.\" U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
16fc7e83faSFrançois Tigeot.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
17fc7e83faSFrançois Tigeot.\" BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
18fc7e83faSFrançois Tigeot.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19fc7e83faSFrançois Tigeot.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
20fc7e83faSFrançois Tigeot.\" IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21fc7e83faSFrançois Tigeot.\"
22fc7e83faSFrançois Tigeot.\" Author: James da Silva, Systems Design and Analysis Group
23fc7e83faSFrançois Tigeot.\"			   Computer Science Department
24fc7e83faSFrançois Tigeot.\"			   University of Maryland at College Park
256fc6ffe8SFrançois Tigeot.\" $FreeBSD: head/usr.sbin/crunch/crunchide/crunchide.1 131500 2004-07-02 23:13:00Z ru $
26fc7e83faSFrançois Tigeot.\"
27fc7e83faSFrançois Tigeot.Dd June 14, 1994
28fc7e83faSFrançois Tigeot.Dt CRUNCHIDE 1
29fc7e83faSFrançois Tigeot.Os
30fc7e83faSFrançois Tigeot.Sh NAME
31fc7e83faSFrançois Tigeot.Nm crunchide
32fc7e83faSFrançois Tigeot.Nd hides symbol names from ld, for crunching programs together
33fc7e83faSFrançois Tigeot.Sh SYNOPSIS
34fc7e83faSFrançois Tigeot.Nm
35fc7e83faSFrançois Tigeot.Op Fl f Ar keep-list-file
36fc7e83faSFrançois Tigeot.Op Fl k Ar keep-symbol
37fc7e83faSFrançois Tigeot.Op Ar object-file ...
38fc7e83faSFrançois Tigeot.Sh DESCRIPTION
39fc7e83faSFrançois TigeotThe
40fc7e83faSFrançois Tigeot.Nm
41fc7e83faSFrançois Tigeotutility hides the global symbols of
42fc7e83faSFrançois Tigeot.Ar object-file
43fc7e83faSFrançois Tigeotsuch that they are ignored by subsequent runs of the linker,
44fc7e83faSFrançois Tigeot.Xr ld 1 .
45fc7e83faSFrançois TigeotSome symbols may be left visible via the
46fc7e83faSFrançois Tigeot.Fl k Ar keep-symbol
47fc7e83faSFrançois Tigeotand
48fc7e83faSFrançois Tigeot.Fl f Ar keep-list-file
496fc6ffe8SFrançois Tigeotoptions.
506fc6ffe8SFrançois TigeotThe
51fc7e83faSFrançois Tigeot.Ar keep-list-file
52fc7e83faSFrançois Tigeotmust contain a list of symbols to keep visible, one symbol per line.
53fc7e83faSFrançois TigeotThe names given by
54fc7e83faSFrançois Tigeot.Ar keep-symbol
55fc7e83faSFrançois Tigeotor in
56fc7e83faSFrançois Tigeot.Ar keep-list-file
576fc6ffe8SFrançois Tigeotshould be C names.
586fc6ffe8SFrançois TigeotFor example,
59fc7e83faSFrançois Tigeotto keep the C function
60fc7e83faSFrançois Tigeot.Dq foo
61fc7e83faSFrançois Tigeotvisible, the option
62fc7e83faSFrançois Tigeot.Dq -k foo
63fc7e83faSFrançois Tigeotshould be used.
64fc7e83faSFrançois Tigeot.Pp
65fc7e83faSFrançois TigeotThe
66fc7e83faSFrançois Tigeot.Nm
67fc7e83faSFrançois Tigeotutility is designed as a companion program for
68fc7e83faSFrançois Tigeot.Xr crunchgen 1 ,
69fc7e83faSFrançois Tigeotwhich automates the process of creating crunched binaries from
70fc7e83faSFrançois Tigeotmultiple component programs.
71fc7e83faSFrançois Tigeot.Sh SEE ALSO
72fc7e83faSFrançois Tigeot.Xr crunchgen 1 ,
73fc7e83faSFrançois Tigeot.Xr ld 1
74fc7e83faSFrançois Tigeot.Sh AUTHORS
756fc6ffe8SFrançois Tigeot.An -nosplit
76fc7e83faSFrançois TigeotThe
77fc7e83faSFrançois Tigeot.Nm crunch
78fc7e83faSFrançois Tigeotutility was written by
79*93b7dd6dSSascha Wildner.An James da Silva Aq Mt jds@cs.umd.edu .
80fc7e83faSFrançois Tigeot.Pp
816fc6ffe8SFrançois TigeotCopyright (c) 1994 University of Maryland.
826fc6ffe8SFrançois TigeotAll Rights Reserved.
83fc7e83faSFrançois Tigeot.Pp
84*93b7dd6dSSascha Wildner.An Chris Demetriou Aq Mt cgd@netbsd.org
85fc7e83faSFrançois Tigeotreorganized
86fc7e83faSFrançois Tigeot.Nm
87fc7e83faSFrançois Tigeotso that it supported multiple object formats, and added
88fc7e83faSFrançois TigeotELF object support and ECOFF object recognition.
89fc7e83faSFrançois Tigeot.Pp
906fc6ffe8SFrançois TigeotCopyright (c) 1997
916fc6ffe8SFrançois Tigeot.An Christopher G. Demetriou .
926fc6ffe8SFrançois TigeotAll Rights Reserved.
93