man dh_upx (Commandes) - applies UPX compression on executables

NAME

dh_upx - 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

SEE ALSO

debhelper(1), upx(1)

This program is an extension to debhelper.

AUTHOR

Eduard Bloch <blade@debian.org>.