DH_UPX(1)

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(7), upx-ucl(1)

This program is an extension to debhelper.

AUTHOR

Eduard Bloch <blade@debian.org>.
Copyright © 2010-2025 Platon Technologies, s.r.o.           Home | Man pages | tLDP | Documents | Utilities | About
Design by styleshout