DEBSNAP
Section: DebSnap User Manual (1)
Updated: July 3, 2010
Index
Return to Main Contents
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`
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- CONFIGURATION OPTIONS
-
- EXIT STATUS
-
- EXAMPLES
-
- FILES
-
- SEE ALSO
-
- AUTHORS
-
- COPYRIGHT
-
- BUGS
-
- Reporting bugs
-
This document was created by
man2html,
using the manual pages.
Time: 02:41:05 GMT, April 18, 2024