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.

debrebuild 2.25.15                                  June 2025                                      DEBREBUILD(1)