1DEBSNAP(1) DebSnap User Manual DEBSNAP(1)
2
6 debsnap - retrieve old snapshots of Debian packages
7
10 debsnap [options] package [version]
11 debsnap [-h | --help] [--version]
13
17 debsnap is a tool to help with retrieving snapshots of old packages
18 from a daily archive repository.
19 The only publicly available snapshot archive is currently located at
21 https://snapshot.debian.org
22 By default, debsnap will download all the available versions for pack‐
24 age that are found in the snapshot archive. If a version is specified,
25 only that particular version will be downloaded, if available.
26
30 The following options are available:
31 -d destination, --destdir destination
34 Directory to place retrieved packages.
35 -f, --force
38 Force writing into an existing destination. By default debsnap
39 will insist the destination directory does not exist yet unless
40 it is explicitly specified to be '.' (the current working direc‐
41 tory). This is to avoid files being accidentally overwritten by
42 what is fetched from the archive and to provide a guarantee for
43 other scripts that only the files fetched will be present there
44 upon completion.
45 -v, --verbose
48 Report on the debsnap configuration being used and progress dur‐
49 ing the download operation. Please always use this option when
50 reporting bugs.
51 --list Don't download but just list versions.
54 --binary
57 Download binary packages instead of source packages.
58 -a, --architecture
61 Specify architecture of downloaded binary packages. Implies
62 --binary. This can be given multiple times in order to download
63 binary packages for multiple architectures.
64 --first
67 Specify the minimum version of a package which will be down‐
68 loaded. Any versions which compare larger than this, according
69 to dpkg, will be considered for download. May be used in combi‐
70 nation with --last.
71 --last Specify the maximum version of a package which will be down‐
74 loaded. Any package versions which compare less than this,
75 according to dpkg, will be considered for download. May be used
76 in combination with --first.
77 -h, --help
80 Show a summary of these options.
81 --version
84 Show the version of debsnap.
85
89 debsnap may also be configured through the use of the following options
90 in the devscripts configuration files:
91 DEBSNAP_VERBOSE
94 Same as the command line option --verbose. Set to yes to
95 enable.
96 DEBSNAP_DESTDIR
99 Set a default path for the destination directory. If unset
100 ./source-<package_name> will be used. The command line option
101 --destdir will override this.
102 DEBSNAP_BASE_URL
105 The base url for the snapshots archive.
106 If unset this defaults to https://snapshot.debian.org
108
111 debsnap will return an exit status of 0 if all operations succeeded, 1
112 if a fatal error occurred, and 2 if some packages failed to be down‐
113 loaded but operations otherwise succeeded as expected. In some cases
114 packages may fail to be downloaded because they are no longer available
115 on the snapshot mirror, so any caller should expect this may occur in
116 normal use.
117
120 debsnap -a amd64 xterm 256-1
121 Download the binary package of a specific xterm version for
122 amd64 architecture.
123 debsnap -a armel xterm
125 Download binary packages for all versions of xterm for armel
126 architecture.
127 debsnap --binary xterm 256-1
129 Download binary packages for a specific xterm version but for
130 all architectures.
131 debsnap --binary xterm
133 Download binary packages for all versions of xterm for all
134 architectures.
135 debsnap -v --first 347-1 --last 348-2 xterm
137 Download source packages for local architecture of xterm,
138 between 347-1 and 348-2 revisions, inclusive, showing the
139 progress when doing it.
140 aptitude search '~i' -F '%p %V' | while read pkg ver; do debsnap -a
142 $(dpkg-architecture -qDEB_HOST_ARCH) -a all $pkg $ver; done
143 Download binary packages of all packages that are installed on
144 the system.
145
148 /etc/devscripts.conf
149 Global devscripts configuration options. Will override hard‐
150 coded defaults.
151 ~/.devscripts
153 Per-user configuration options. Will override any global con‐
154 figuration.
155
158 devscripts(1), devscripts.conf(5), git-debimport(1)
159
162 David Paleino <dapal@debian.org>
163
166 Copyright © 2010 David Paleino
167 Permission is granted to copy, distribute and/or modify this document
169 under the terms of the GNU General Public License, Version 3 or (at
170 your option) any later version published by the Free Software Founda‐
171 tion.
172 On Debian systems, the complete text of the GNU General Public License
174 can be found in /usr/share/common-licenses/GPL.
175
178 Reporting bugs
179 The program is part of the devscripts package. Please report bugs
180 using `reportbug devscripts`
181Debian devscripts July 3, 2010 DEBSNAP(1)