NAME

       debsnap - retrieve old snapshots of Debian packages

SYNOPSIS

       debsnap [options] package [version]

       debsnap [-h | --help] [--version]

DESCRIPTION

       debsnap is a tool to help with retrieving snapshots of old packages from a daily archive repository.

       The only publicly available snapshot archive is currently located at https://snapshot.debian.org

       By  default,  debsnap will download all the available versions for package that are found in the snapshot
       archive.  If a version is specified, only that particular version will be downloaded, if available.

OPTIONS

       The following options are available:

       -d destination, --destdir destination
              Directory to place retrieved packages.

       -f, --force
              Force writing into an existing destination.   By  default  debsnap  will  insist  the  destination
              directory  does  not  exist  yet  unless it is explicitly specified to be '.' (the current working
              directory).  This is to avoid files being accidentally overwritten by what  is  fetched  from  the
              archive  and  to provide a guarantee for other scripts that only the files fetched will be present
              there upon completion.

       -v, --verbose
              Report on the debsnap configuration being used and progress during the download operation.  Please
              always use this option when reporting bugs.

       -l, --list
              Don't download but just list versions.

       --binary
              Download binary packages instead of source packages.

       -a, --architecture
              Specify architecture of downloaded binary packages. Implies --binary.  This can be given  multiple
              times in order to download binary packages for multiple architectures.

       --first
              Specify  the  minimum  version  of a package which will be downloaded.  Any versions which compare
              larger than this, according to dpkg, will be considered for download.  May be used in  combination
              with --last.

       --last Specify  the  maximum  version  of a package which will be downloaded.  Any package versions which
              compare less than this, according to dpkg, will be  considered  for  download.   May  be  used  in
              combination with --first.

       -h, --help
              Show a summary of these options.

       --version
              Show the version of debsnap.

CONFIGURATION OPTIONS

       debsnap  may  also be configured through the use of the following options in the devscripts configuration
       files:

       DEBSNAP_VERBOSE
              Same as the command line option --verbose.  Set to yes to enable.

       DEBSNAP_DESTDIR
              Set a default path for the destination directory.  If unset ./source-<package_name> will be  used.
              The command line option --destdir will override this.

       DEBSNAP_BASE_URL
              The base url for the snapshots archive.

              If unset this defaults to https://snapshot.debian.org

EXIT STATUS

       debsnap  will  return an exit status of 0 if all operations succeeded, 1 if a fatal error occurred, and 2
       if some packages failed to be downloaded but operations otherwise succeeded as expected.  In  some  cases
       packages  may  fail  to be downloaded because they are no longer available on the snapshot mirror, so any
       caller should expect this may occur in normal use.

EXAMPLES

       debsnap -a amd64 xterm 256-1
              Download the binary package of a specific xterm version for amd64 architecture.

       debsnap -a armel xterm
              Download binary packages for all versions of xterm for armel architecture.

       debsnap --binary xterm 256-1
              Download binary packages for a specific xterm version but for all architectures.

       debsnap --binary xterm
              Download binary packages for all versions of xterm for all architectures.

       debsnap -v --first 347-1 --last 348-2 xterm
              Download source packages for local architecture of  xterm,  between  347-1  and  348-2  revisions,
              inclusive, showing the progress when doing it.

       aptitude search '~i' -F '%p %V' | while read pkg ver; do debsnap -a $(dpkg-architecture -qDEB_HOST_ARCH)
       -a all $pkg $ver; done
              Download binary packages of all packages that are installed on the system.

FILES

       /etc/devscripts.conf
              Global devscripts configuration options.  Will override hardcoded defaults.

       ~/.devscripts
              Per-user configuration options.  Will override any global configuration.

SEE ALSO

       devscripts(1), devscripts.conf(5), git-debimport(1)

AUTHORS

       David Paleino <dapal@debian.org>

COPYRIGHT

       Copyright © 2010 David Paleino

       Permission  is granted to copy, distribute and/or modify this document under the terms of the GNU General
       Public License, Version 3 or  (at  your  option)  any  later  version  published  by  the  Free  Software
       Foundation.

       On   Debian   systems,   the   complete  text  of  the  GNU  General  Public  License  can  be  found  in
       /usr/share/common-licenses/GPL.

BUGS

   Reporting bugs
       The program is part of the devscripts package.  Please report bugs using `reportbug devscripts`

Debian devscripts                                 July 3, 2010                                        DEBSNAP(1)