Rechercher une page de manuel
debsnap
Langue: en
Version: January 8, 2009 (debian - 07/07/09)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
debsnap - retrieve old snapshots of Debian packagesSYNOPSIS
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.net
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 overwriting 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. Note that this option will remove the destination directory and all of its contents prior to beginning the download.
- -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. This is the root of a directory tree such as pool/<initial>/<package>/ under which a Sources.gz may be found, and the root for the location of the packages specified in the Sources.gz file found there.
If unset this defaults to http://snapshot.debian.net/archive/
- DEBSNAP_CLEAN_REGEX
- A sed regular expression to transform the directory returned by `apt-cache showsrc package | grep ^Directory` to a suitable path to be put between DEBSNAP_BASE_URL and DEBSNAP_SOURCES_GZ_PATH.
If unset it will default to s@\([^/]*\)/[^/]*/\(.*\)@\1/\2@
i.e. it transforms pool/<component>/<initial>/<package> into pool/<initial>/<package> - DEBSNAP_SOURCES_GZ_PATH
- The final path to the Sources.gz file. This is appended after the DEBSNAP_BASE_URL and the path modified by DEBSNAP_CLEAN_REGEX to locate the Sources.gz file for the package to download.
If unset it will default to source/Sources.gz
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 <d.paleino@gmail.com>Ron Lee <ron@debian.org>
COPYRIGHT
Copyright © 2009 David Paleino, Ron LeePermission 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`Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre