Scroll to navigation

DEBAUX-BUILD(1p) User Contributed Perl Documentation DEBAUX-BUILD(1p)


debaux-build - Debian package building script



debaux-build --cpan Net::Google




debaux-build is a helper script for building Debian packages. Besides options it takes up to three parameters: DEBDIR, BUILDDIR, SOURCEDIR. DEBDIR is a required parameter.

If DEBDIR doesn't exist, debaux-build tries to download the package with apt-get source.

debaux-build applies all patches found in the DEBDIR subdirectory patches.

If no source tarball exist and the DEBDIR subdirectory sources exist, all files in this directory get packed and used as source tarball.


Forces apt-get source mode.
Specifies file name of source archive.
Options passed to "dpkg-buildpackage".
Build package in a chroot environment.
Download Perl module from CPAN and create necessary Debian packaging files. You need to have the dh-make Debian package installed in order to utilize this option.
Empty package (no source code archive). Intended to use for task packages.
Sets environment variable(s) for builds in chroot environments.

Example for using gcc-snapshot in a chroot containing Debian unstable (sid):

"--env='PATH=/usr/lib/gcc-snapshot/bin:$PATH' --env='LD_LIBRARY_PATH=/usr/lib/gcc-snapshot/lib:$LD_LIBRARY_PATH'"

Specifies epoch for CPAN builds.
Specifies a directory below DEBDIR which is copied to the build directory.
"-i, --install, --install=PACKAGE"
Install build package.
"-l, --lintian"
Run lintian on the source file and the generated packages.
Intended to use for native Debian packages. Specify the commands to build the archive here.
The generated packages are targeted for official Debian packages.
"--rpm, --alien"
Convert generated packages into RPM packages by using "alien".
"-s, --sign"
Sign source package and changelog.
Don't apply patches from the patches directory and sources.diff file.
Instructs "debaux-build" to use the specified directory instead of an archive file.
Stop script before calling "dpkg-buildpackage".


"debaux-build" looks for the configuration file ".debauxrc" in the home directory and in the current directory and recognizes the following directives:

"debauxdir" PACKAGE
Used as "DEBDIR" for package if it is an existing directory. Considered before the <debiandir> directive.
If the directory "DEBDIR" on the commandline doesn't exist, "debaux-build" appends "DEBDIR" to the specified directory and tries again.
Directory with the source archives. Can be overridden by the commandline parameter "SOURCEDIR".
"source-tree" PACKAGE
Directory with the source code for PACKAGE.


dpkg(8), dpkg-source(1), apt-get(8)


Stefan Hornburg (Racke) <>.


debaux-build comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute and modify it under the terms of the GNU General Public License.


Copyright 2000,2001,2002,2003,2004,2005,2006,2007,2008,2010 Stefan Hornburg (Racke) <>.

2021-01-05 perl v5.32.0