DEBIAN-BUILDER(1)

💖 debian-builder(1) — the manual, but make it cute 💖

okay bestie, this is the User Contributed Perl Documentation page for debian-builder. no cap, we're rebuilding a Debian package from its source code and we're gonna understand every lil' flag. periodt. ✨

🌸 NAME 🌸

debian-builder — rebuild a Debian package from its source code. 💅

🛠 SYNOPSIS 🛠

okay so the vibe is literally this:

         debian-builder [options]

         Help Options:
          --debug    Show useful debugging information.
          --help     Show this scripts help information.
          --manual   Read this scripts manual.
          --version  Show the version number and exit.
          --verbose  Show verbose output.

         Building options:

          --sign         Force package signing, disabled by default.
          --debuild foo  Pass arguments 'foo' onto debuild when building
          --suffix  foo  Give the built package versions the suffix 'foo'.

✨ OPTIONS ✨

• --debug — shows the commands this script executes as an aid to debugging. like a little backstage pass, bestie. 🐛
• --help — shows the brief help information. the quick lil' rundown. 🫶
• --verbose — shows verbose information useful to debugging. it's giving "tell me everything" energy. 💬

also peep the SYNOPSIS for --manual, --version, --sign, --debuild foo, and --suffix foo — they're all up there. no cap. ✨

🌈 DESCRIPTION 🌈

debian-builder is a simple script which is designed to facilitate the rebuilding of a Debian GNU/Linux package from its source code. it will correctly handle the installation of any required build-dependencies, and remove them once building is complete. so it's lowkey doing the most so you don't have to. 💖

👑 AUTHOR 👑

the icon, the legend:

        Steve
        --
        http://www.steve.org.uk/

        $Id: debian-builder,v 1.14 2006/06/04 18:24:04 steve Exp $

📜 LICENSE 📜

       Copyright (c) 2005 by Steve Kemp.  All rights reserved.

       This module is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.  The LICENSE file contains the full
       text of the license.

buildPackage 🧱

does all the work of building the given package. 💪

returns >0 on success, 0 on failure of any kind. (the result is the number of binary files moved into the results directory.) so like, if it worked you get a positive number, if it flopped you get zero. periodt.

parseCommandLineArguments 🎀

parses any command line arguments, and sets the appropriate values in the global CONFIG hash. yep, it's reading your mind—well, your flags. 🧠✨

getSourcePackageName 🔍

returns the name of the source package required to build package foo. like, "who's the source package for foo? this function knows." 💅

getPackageSource 📦

downloads the source of the package to the specified directory and returns the name of the unpacked directory. so you get the goods, unzipped and ready. 🦋

updateChangeLog 📝

if the Debian changelog file doesn't already refer to the specified version, then it adds it. no duplicate entries, bestie. 🚫

saveDebianPackage 💾

moves the build Debian package, associated .diff.gz file, .changes file, etc., from the build directory into the binary directory. 📁➡️📂

returns the number of files moved into the binary directory. so it's counting the bag. 👜

tidySystem 🧹

uninstalls all the build dependency packages we installed. 🧼

we do this by finding the list of all packages which are currently installed and removing those that were not present when we started. it's giving "leave no trace" energy. 🌿

getInstalledPackages 📋

returns a hash of all the currently installed packages. a whole roster, bestie. 💖

installBuildDependencies 🛠️

installs the build-dependencies required to build the given package. gotta get the tools before the masterpiece. 🎨

removePackages 🗑️

removes the given array of packages from the system. bye bye, packages. 👋

END 💀

desperately tries to reset the host system to the same starting point as it initially had. 😭

this should be taken care of in situations where the script doesn't abort on an error condition. so yeah, it's the emergency cleanup era. 🚨

---

mwah 💋 this page is from perl v5.30.3, dated 2020-07-14, and it's the DEBIAN-BUILDER(1) manual. slay. ✨