dh_upx(1) applies UPX compression on executables

SYNOPSIS

dh_upx [debhelperĀ options] [-Xitem]

DESCRIPTION

dh_upx is a debhelper program that is responsible for compressing executables using the UPX program.

UPX can be applied on any kinds of i386-compatible executable files. Really small files won't be compressed since the compressed version would become bigger then original file.

IMPORTANT NOTE

dh_upx must not be executed before dh_strip and dh_shlibdeps have done their work.

HINTS

You should never forget that the compression costs load time. Better don't compress applications that are used frequently.

You should not use UPX on files with special permissions (SUID, SGID). This will fail.

OPTIONS

-Xitem, --exclude=item
Exclude files that contain ``item'' anywhere in their filename from being compressed. You may use this option multiple times to build up a list of things to exclude.

NOTES

UPX will only work on Linux executables for i386. dh_upx does nothing if the Build-Target is not ``i386-linux''.

If the DEB_BUILD_OPTIONS environment variable contains ``nostrip'', nothing will be compressed, in accordance with Debian policy.

CONFORMS TO

Debian policy, version 3.0.1

AUTHOR

Eduard Bloch <[email protected]>.