usr.sbin/crunch/crunchide/crunchide.1

   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: src/usr.sbin/crunch/crunchide/crunchide.1,v 1.5.2.5 2003/03/12 22:08:14 trhodes Exp $
  26 .\" $DragonFly: src/usr.sbin/crunch/crunchide/crunchide.1,v 1.2 2003/06/17 04:29:53 dillon Exp $
  27 .\"
  28 .Dd June 14, 1994
  29 .Dt CRUNCHIDE 1
  30 .Os
  31 .Sh NAME
  32 .Nm crunchide
  33 .Nd hides symbol names from ld, for crunching programs together
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl f Ar keep-list-file
  37 .Op Fl k Ar keep-symbol
  38 .Op Ar object-file ...
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 utility hides the global symbols of
  43 .Ar object-file
  44 such that they are ignored by subsequent runs of the linker,
  45 .Xr ld 1 .
  46 Some symbols may be left visible via the
  47 .Fl k Ar keep-symbol
  48 and
  49 .Fl f Ar keep-list-file
  50 options.  The
  51 .Ar keep-list-file
  52 must contain a list of symbols to keep visible, one symbol per line.
  53 The names given by
  54 .Ar keep-symbol
  55 or in
  56 .Ar keep-list-file
  57 should be C names.  For example,
  58 to keep the C function
  59 .Dq foo
  60 visible, the option
  61 .Dq -k foo
  62 should be used.
  63 .Pp
  64 The
  65 .Nm
  66 utility is designed as a companion program for
  67 .Xr crunchgen 1 ,
  68 which automates the process of creating crunched binaries from
  69 multiple component programs.
  70 .Sh SEE ALSO
  71 .Xr crunchgen 1 ,
  72 .Xr ld 1
  73 .Sh AUTHORS
  74 The
  75 .Nm crunch
  76 utility was written by
  77 .An James da Silva Aq jds@cs.umd.edu .
  78 .Pp
  79 Copyright (c) 1994 University of Maryland.  All Rights Reserved.
  80 .Pp
  81 .An Chris Demetriou Aq cgd@netbsd.org
  82 reorganized
  83 .Nm
  84 so that it supported multiple object formats, and added
  85 ELF object support and ECOFF object recognition.
  86 .Pp
  87 Copyright (c) 1997 Christopher G. Demetriou.  All Rights Reserved.