gzexe.1

   1 .TH GZEXE 1
   2 .SH NAME
   3 gzexe \- compress executable files in place
   4 .SH SYNOPSIS
   5 .B gzexe
   6 .I "name .\|.\|."
   7 .SH DESCRIPTION
   8 The
   9 .B gzexe
  10 utility allows you to compress executables in place and have them
  11 automatically uncompress and execute when you run them (at a penalty
  12 in performance).  For example if you execute ``gzexe /usr/bin/gdb'' it
  13 will create the following two files:
  14 .nf
  15 .br
  16     -rwxr-xr-x  1 root root 1026675 Jun  7 13:53 /usr/bin/gdb
  17     -rwxr-xr-x  1 root root 2304524 May 30 13:02 /usr/bin/gdb~
  18 .fi
  19 /usr/bin/gdb~ is the original file and /usr/bin/gdb is the self-uncompressing
  20 executable file.  You can remove /usr/bin/gdb~ once you are sure that
  21 /usr/bin/gdb works properly.
  22 .PP
  23 This utility is most useful on systems with very small disks.
  24 .SH OPTIONS
  25 .TP
  26 .B \-d
  27 Decompress the given executables instead of compressing them.
  28 .SH "SEE ALSO"
  29 .BR gzip (1),
  30 .BR znew (1),
  31 .BR zmore (1),
  32 .BR zcmp (1),
  33 .BR zforce (1)
  34 .SH CAVEATS
  35 The compressed executable is a shell script.  This may create some
  36 security holes.  In particular, the compressed executable relies
  37 on the PATH environment variable to find
  38 .B gzip
  39 and some standard utilities
  40 .RB ( basename ,
  41 .BR chmod ,
  42 .BR ln ,
  43 .BR mkdir ,
  44 .BR mktemp ,
  45 .BR rm ,
  46 .BR sleep ,
  47 and
  48 .BR tail ).
  49 .SH "BUGS"
  50 The
  51 .B gzexe
  52 command
  53 attempts to retain the original file attributes on the compressed executable,
  54 but you may have to fix them manually in some cases, using
  55 .B chmod
  56 or
  57 .BR chown .