summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/gzexe.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/mageia-cauldron/man1/gzexe.1')
-rw-r--r--upstream/mageia-cauldron/man1/gzexe.157
1 files changed, 57 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/gzexe.1 b/upstream/mageia-cauldron/man1/gzexe.1
new file mode 100644
index 00000000..04e3a732
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/gzexe.1
@@ -0,0 +1,57 @@
+.TH GZEXE 1
+.SH NAME
+gzexe \- compress executable files in place
+.SH SYNOPSIS
+.B gzexe
+.I "name .\|.\|."
+.SH DESCRIPTION
+The
+.B 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 /usr/bin/gdb'' it
+will create the following two files:
+.nf
+.br
+ -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
+/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
+.TP
+.B \-d
+Decompress the given executables instead of compressing them.
+.SH "SEE ALSO"
+.BR gzip (1),
+.BR znew (1),
+.BR zmore (1),
+.BR zcmp (1),
+.BR zforce (1)
+.SH CAVEATS
+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
+.B gzip
+and some standard utilities
+.RB ( basename ,
+.BR chmod ,
+.BR ln ,
+.BR mkdir ,
+.BR mktemp ,
+.BR rm ,
+.BR sleep ,
+and
+.BR tail ).
+.SH "BUGS"
+The
+.B gzexe
+command
+attempts to retain the original file attributes on the compressed executable,
+but you may have to fix them manually in some cases, using
+.B chmod
+or
+.BR chown .