DEBAUX-BUILD(1p)

📦
version 0.1.12 · 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

💖 DEBAUX-BUILD(1p) — Debian package building script 💖

okay bestie, listen up — this is debaux-build, and she lives in the User Contributed Perl Documentation section of your friendly neighbourhood manual pages. She's a lil helper script whose whole personality is building Debian packages, and honestly? She eats. ✨

📜 SYNOPSIS

debaux-build [OPTIONS] DEBDIR [BUILDDIR SOURCEDIR]

debaux-build --cpan Net::Google

Like, that's the whole vibe. 🫶

🌸 VERSION

0.1.11 — that's the version, babes. Not a drill.

✨ DESCRIPTION

debaux-build is your helper script for building Debian packages, and she is so good at it. Besides the options, she takes up to three parameters: DEBDIR, BUILDDIR, and SOURCEDIR. And the important part — the mandatory part — DEBDIR is a required parameter. You cannot skip her. She is the main character. 👑

If DEBDIR doesn't exist? No stress, she just tries to download the package with apt-get source. Resourceful queen. 💅

Then she applies all the patches she finds hanging out in the DEBDIR subdirectory called patches. Every single one.

And if there's no source tarball but the DEBDIR subdirectory sources does exist, all the files in that directory get packed up and used as the source tarball. Recycle, repurpose, slay. 🦋

🎀 OPTIONS

  • --apt — forces apt-get source mode. No takebacks.
  • --archive — specifies the file name of the source archive.
  • --build-options — options that get passed to dpkg-buildpackage.
  • --chroot=DIRECTORY — builds the package inside a chroot environment.
  • --cpan — downloads a Perl module from CPAN and creates the necessary Debian packaging files. Heads up bestie: you need to have the dh-make Debian package installed to use this one. No dh-make, no party. 😭
  • --empty — empty package (no source code archive at all). It's intended to be used for task packages. It's giving minimalism. 🌈
  • --env=NAME=VALUE — sets environment variable(s) for builds in chroot environments.

Here's the example for using gcc-snapshot in a chroot that contains Debian unstable (sid):

--env='PATH=/usr/lib/gcc-snapshot/bin:$PATH'
--env='LD_LIBRARY_PATH=/usr/lib/gcc-snapshot/lib:$LD_LIBRARY_PATH'
  • --epoch — specifies the epoch for CPAN builds.
  • --extra-sources — specifies a directory below DEBDIR which gets copied to the build directory.
  • -i, --install, --install=PACKAGE — installs the build package.
  • -l, --lintian — runs lintian on the source file and the generated packages. Quality check era. 🔍
  • --make-archive — intended to be used for native Debian packages. You specify the commands to build the archive right here.
  • --release — the generated packages are targeted for official Debian packages.
  • --rpm, --alien — converts the generated packages into RPM packages by using alien. Cross-distro crossover episode. 👽
  • -s, --sign — signs the source package and the changelog.
  • --skip-patches — don't apply patches from the patches directory or the sources.diff file.
  • --source-tree — instructs debaux-build to use the specified directory instead of an archive file.
  • --stop-before-build — stops the script before calling dpkg-buildpackage. (Sometimes you gotta pause before the big moment. 🙈)

🧚 CONFIGURATION FILE

debaux-build goes looking for a configuration file called .debauxrc — in the home directory and in the current directory — and she recognises these directives:

⭐ debauxdir PACKAGE

Used as DEBDIR for the package if it's an existing directory. This one is considered before the <debiandir> directive. Priorities, bestie.

⭐ debiandir

If the directory DEBDIR on the commandline doesn't exist, debaux-build appends DEBDIR to the specified directory and tries again. Second chances are cute. 💖

⭐ sourcedir

The directory with the source archives. Can be overridden by the commandline parameter SOURCEDIR.

⭐ source-tree PACKAGE

The directory with the source code for PACKAGE.

🔥 SEE ALSO

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

Go read those too, iykyk. 📚

👑 AUTHOR

Stefan Hornburg (Racke) <racke@linuxia.de>.

📝 LICENSE

debaux-build comes with ABSOLUTELY NO WARRANTY. It's free software, and you are welcome to redistribute and modify it under the terms of the GNU General Public License. FOSS royalty behaviour. 💜

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

and that's the whole page, babe — this documentation ships with perl v5.32.0 and it was dated 2021-01-05. Periodt. 💅✨

📦 where this page comes from