summaryrefslogtreecommitdiff
path: root/gzexe.1
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2007-02-05 20:54:25 +0000
committerPaul Eggert <eggert@cs.ucla.edu>2007-02-05 20:54:25 +0000
commite24e0fedb97d741ef5ef34a2c38807ef4dd5bf57 (patch)
tree8d7657394a27b86d1458977ba029e801e60261bb /gzexe.1
parent2d97657ee315734d908e9008cb9843755bfbc88b (diff)
downloadgzip-e24e0fedb97d741ef5ef34a2c38807ef4dd5bf57.tar.gz
* gunzip.in, zcat.in, zcmp.in, zegrep.in, zfgrep.in: New files.
* Makefile.am (EXTRA_DIST): Add them. (bin_SCRIPTS, MOSTLYCLEANFILES): Add gunzip, zcat, zcmp, zdgrep, zfgrep. (.in): Use GZIP_BINDIR as the location of gzip binaries, if it is set. (check-local): Use GZIP_BINDIR. (install-exec-hook, remove-installed-links): Make 'uncompress' an alias for gunzip. * gzexe.1: At least one arg is required. Don't give cat as an example, since gzexe refuses to compress cat due to a bootstrapping issue. List more utilities in this category. * gzexe.in, zdiff.in, zforce.in, zgrep.in, zless.in, zmore.in, znew.in: Report our name in usage. * gzexe.in: Don't compress bash. Don't use rmdir, so it's OK to compress rmdir. * gzip.c: Now requires that you compile with -DGNU_STANDARD=0 to get non GNU-standard behavior. We now build with GNU-standard behavior by default, so that programs do not depend on the names of their executables. * zdiff.in: Don't depend on the name of the executable, as per GNU standard. Instead, rely on an internal --__cmp option. Support ' in options. Check for failures in subsidiary gzip invocations. * zgrep.1: Clarify compression issues. * zgrep.in: Don't assume POSIX-style case syntax. Remove unused var have_optarg. * zless.1: zless sets LESSMETACHARS now.
Diffstat (limited to 'gzexe.1')
-rw-r--r--gzexe.134
1 files changed, 21 insertions, 13 deletions
diff --git a/gzexe.1 b/gzexe.1
index 8b62cd6..01ad9ad 100644
--- a/gzexe.1
+++ b/gzexe.1
@@ -3,22 +3,22 @@
gzexe \- compress executable files in place
.SH SYNOPSIS
.B gzexe
-[ name ... ]
+.I "name .\|.\|."
.SH DESCRIPTION
The
.I gzexe
utility allows you to compress executables in place and have them
automatically uncompress and execute when you run them (at a penalty
-in performance). For example if you execute ``gzexe /bin/cat'' it
+in performance). For example if you execute ``gzexe /usr/bin/gdb'' it
will create the following two files:
.nf
.br
- -r-xr-xr-x 1 root bin 9644 Feb 11 11:16 /bin/cat
- -r-xr-xr-x 1 bin bin 24576 Nov 23 13:21 /bin/cat~
+ -rwxr-xr-x 1 root root 1026675 Jun 7 13:53 /usr/bin/gdb
+ -rwxr-xr-x 1 root root 2304524 May 30 13:02 /usr/bin/gdb~
.fi
-/bin/cat~ is the original file and /bin/cat is the self-uncompressing
-executable file. You can remove /bin/cat~ once you are sure that
-/bin/cat works properly.
+/usr/bin/gdb~ is the original file and /usr/bin/gdb is the self-uncompressing
+executable file. You can remove /usr/bin/gdb~ once you are sure that
+/usr/bin/gdb works properly.
.PP
This utility is most useful on systems with very small disks.
.SH OPTIONS
@@ -28,16 +28,24 @@ Decompress the given executables instead of compressing them.
.SH "SEE ALSO"
gzip(1), znew(1), zmore(1), zcmp(1), zforce(1)
.SH CAVEATS
-The compressed executable is a shell script. This may create some
-security holes. In particular, the compressed executable relies
+The compressed executable is a shell script. This may create some
+security holes. In particular, the compressed executable relies
on the PATH environment variable to find
.I gzip
-and some other utilities
-.I (tail, chmod, ln, sleep).
+and some standard utilities
+.RI ( basename ,
+.IR chmod ,
+.IR ln ,
+.IR mkdir ,
+.IR mktemp ,
+.IR rm ,
+.IR sleep ,
+and
+.IR tail ).
.SH "BUGS"
-.I gzexe
+.I gzexe
attempts to retain the original file attributes on the compressed executable,
but you may have to fix them manually in some cases, using
.I chmod
or
-.I chown.
+.IR chown .