.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.1.
.TH DEBOOTSNAP "1" "June 2022" "debootsnap 2.22.2~bpo11+1" "User Commands"
.SH NAME
debootsnap \- create debian chroot using snapshot.debian.org
.SH DESCRIPTION
usage: debootsnap [\-h] [\-\-architecture ARCHITECTURE] [\-\-ignore\-notfound]
.IP
(\fB\-\-buildinfo\fR BUILDINFO | \fB\-\-packages\fR PACKAGES)
[\-\-sources\-list\-only]
[output]
.PP
Combines debootstrap and snapshot.debian.org to create a chroot with exact
package versions from the past either to reproduce bugs or to test source
package reproducibility.
.PP
To obtain a list of packages run the following command on one machine:
.IP
\f(CW$ dpkg-query --showformat '${binary:Package}=${Version}\en' --show\fR
.PP
And pass the output to debootsnap with the \fB\-\-packages\fR argument. The result
will be a chroot tarball with precisely the package versions as they were
found on the system that ran dpkg\-query.
.SS "positional arguments:"
.TP
output
path to output chroot tarball
.SS "optional arguments:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-architecture\fR ARCHITECTURE, \fB\-\-nativearch\fR ARCHITECTURE
native architecture of the chroot. Ignored if
\fB\-\-buildinfo\fR is used. Foreign architectures are
inferred from the package list. Not required if
packages are architecture qualified.
.TP
\fB\-\-ignore\-notfound\fR
only warn about packages that cannot be found on
snapshot.debian.org instead of exiting
.TP
\fB\-\-buildinfo\fR BUILDINFO
use packages from a buildinfo file. Read buildinfo
file from standard input if value is "\-".
.TP
\fB\-\-packages\fR PACKAGES, \fB\-\-pkgs\fR PACKAGES
list of packages, optional architecture and version,
separated by comma or linebreak. Read list from
standard input if value is "\-". The option can be
specified multiple times. Package name, version and
architecture are separated by one or more characters
that are not legal in the respective adjacent field.
Leading and trailing illegal characters are allowed.
Example: pkg1:arch=ver1,pkg2:arch=ver2
.TP
\fB\-\-sources\-list\-only\fR
only query metasnap.debian.net and print the
sources.list needed to create chroot and exit
.SH EXAMPLES
On one system run:
.IP
\f(CW$ dpkg-query --showformat '${binary:Package}=${Version}\en' --show > pkglist\fR
.PP
Then copy over "pkglist" and on another system run:
.IP
\f(CW$ debootsnap --pkgs=./pkglist chroot.tar\fR
.PP
Or use a buildinfo file as input:
.IP
\f(CW$ debootsnap --buildinfo=./package.buildinfo chroot.tar\fR