xref: /netbsd-src/usr.bin/gzip/gzexe.1 (revision 98018344b79a0df5a851cddd135940ce0848b1dc)
1*98018344Swiz.\"	$NetBSD: gzexe.1,v 1.3 2003/12/28 12:49:41 wiz Exp $
25ddb4360Smrg.\"	$OpenBSD: gzexe.1,v 1.1 2003/07/31 07:32:47 otto Exp $
35ddb4360Smrg.\"
45ddb4360Smrg.\" Copyright (c) 2003 Otto Moerbeek <otto@drijf.net>
55ddb4360Smrg.\"
65ddb4360Smrg.\" Permission to use, copy, modify, and distribute this software for any
75ddb4360Smrg.\" purpose with or without fee is hereby granted, provided that the above
85ddb4360Smrg.\" copyright notice and this permission notice appear in all copies.
95ddb4360Smrg.\"
105ddb4360Smrg.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
115ddb4360Smrg.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
125ddb4360Smrg.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
135ddb4360Smrg.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
145ddb4360Smrg.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
155ddb4360Smrg.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
165ddb4360Smrg.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
175ddb4360Smrg.\"
185ddb4360Smrg.Dd July 30, 2003
195ddb4360Smrg.Dt GZEXE 1
205ddb4360Smrg.Os
215ddb4360Smrg.Sh NAME
225ddb4360Smrg.Nm gzexe
235ddb4360Smrg.Nd create auto-decompressing executables
245ddb4360Smrg.Sh SYNOPSIS
255ddb4360Smrg.Nm gzexe
265ddb4360Smrg.Op Fl d
275ddb4360Smrg.Ar
285ddb4360Smrg.Sh DESCRIPTION
295ddb4360SmrgThe
305ddb4360Smrg.Nm
315ddb4360Smrgutility uses
325ddb4360Smrg.Xr gzip 1
335ddb4360Smrgto compress executables, producing executables that decompress on-the-fly
345ddb4360Smrgwhen executed.
355ddb4360SmrgThis saves disk space, at the cost of slower execution times.
365ddb4360SmrgThe original executables are saved by copying each of them to a file with
375ddb4360Smrgthe same name with a
385ddb4360Smrg.Sq ~
395ddb4360Smrgsuffix appended.
405ddb4360SmrgAfter verifying that the compressed executables work as expected, the backup
415ddb4360Smrgfiles can be removed.
425ddb4360Smrg.Pp
435ddb4360SmrgThe options are as follows:
445ddb4360Smrg.Bl -tag -width Ds
455ddb4360Smrg.It Fl d
465ddb4360SmrgDecompress executables previously compressed by
47*98018344Swiz.Nm .
485ddb4360Smrg.El
495ddb4360Smrg.Pp
505ddb4360SmrgThe
515ddb4360Smrg.Nm
525ddb4360Smrgprogram refuses to compress non-regular or non-executable files,
535ddb4360Smrgfiles with a setuid or setgid bit set, files that are already
545ddb4360Smrgcompressed using
555ddb4360Smrg.Nm
565ddb4360Smrgor programs it needs to perform on-the-fly decompression:
575ddb4360Smrg.Xr sh 1 ,
585ddb4360Smrg.Xr mktemp 1 ,
595ddb4360Smrg.Xr rm 1 ,
605ddb4360Smrg.Xr echo 1 ,
615ddb4360Smrg.Xr tail 1 ,
62*98018344Swiz.Xr gzip 1 ,
635ddb4360Smrgand
645ddb4360Smrg.Xr chmod 1 .
655ddb4360Smrg.Sh SEE ALSO
665ddb4360Smrg.Xr gzip 1
675ddb4360Smrg.Sh CAVEATS
685ddb4360SmrgThe
695ddb4360Smrg.Nm
705ddb4360Smrgutility replaces files by overwriting them with the generated
715ddb4360Smrgcompressed executable.
725ddb4360SmrgTo be able to do this, it is required that the original files are writable.
73