NAME

debrebuild - use a buildinfo file and snapshot.d.o to recreate binary packages

SYNOPSIS

debrebuild [options] <buildinfo>

DESCRIPTION

debrebuild <--help|-h>

Given a buildinfo file, builds the referenced source package in an environment documented in the provided buildinfo file. The build can be performed by sbuild or other builders in a chroot environment created by debootsnap. The generated artifacts will be verified against the hashes from the buildinfo file.

OPTIONS

--help, -h

Show this help and exit

--[no-]use-tor-proxy

Whether to fetch resources via tor (socks://127.0.0.1:9050) Assumes "apt-transport-tor" is installed both in host + chroot

--[no-]respect-build-path

Whether to setup the build to use the Build-Path from the provided .buildinfo file.

--buildresult

Directory for the build artifacts (default: ./)

--builder=BUILDER

Which building software should be used. Possible values are none, sbuild, mmdebstrap, dpkg and sbuild+unshare. The default is none. See section BUILDER for details.

Note: debrebuild can parse buildinfo files with and without a GPG signature. However, the signature (if present) is discarded as debrebuild does not support verifying it. If the authenticity or integrity of the buildinfo files are important to you, checking these need to be done before invoking debrebuild, for example by using dscverify.

EXAMPLES

$ debrebuild --buildresult=./artifacts --builder=mmdebstrap hello_2.10-2_amd64.buildinfo

BUILDERS

debrebuild can use different backends to perform the actual package rebuild. The desired backend is chosen using the --builder option. The default is "none".

none

Dry-run mode. No build is performed.

sbuild

Use sbuild to build the package. This requires sbuild to be setup with schroot chroots of Debian stable distributions.

mmdebstrap

Use mmdebstrap to build the package. This requires no setup and no superuser privileges.

dpkg

Directly run apt-get and dpkg-buildpackage on the current system without chroot. This requires root privileges.

sbuild+unshare

Use sbuild with the unshare backend. This will create the chroot and perform the build without superuser privileges and without any setup.

UNSHARE

Before kernel 5.10.1 or before Debian 11 (Bullseye), unprivileged user namespaces were disabled in Debian for security reasons. Refer to Debian bug #898446 for details. To enable user namespaces, run:

$ sudo sysctl -w kernel.unprivileged_userns_clone=1

The sbuild+unshare builder requires and the mmdebstrap builder benefits from having unprivileged user namespaces activated. On Ubuntu they are enabled by default.

LIMITATIONS

Currently, the code assumes that all packages were at some point part of Debian unstable main. This fails for packages from Debian ports, packages from experimental as well as for locally built packages or packages from third party repositories. Enabling support for Debian ports and experimental is conceptually possible and only needs somebody implementing it.