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
http://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.
-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 http://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.
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 (C) 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`