1DEBSNAP(1) DebSnap User Manual DEBSNAP(1)
2
3
4
6 debsnap - retrieve old snapshots of Debian packages
7
8
10 debsnap [options] package [version]
11
12 debsnap [-h | --help] [--version]
13
14
15
17 debsnap is a tool to help with retrieving snapshots of old packages
18 from a daily archive repository.
19
20 The only publicly available snapshot archive is currently located at
21 https://snapshot.debian.org
22
23 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
27
28
30 The following options are available:
31
32
33 -d destination, --destdir destination
34 Directory to place retrieved packages.
35
36
37 -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
46
47 -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
52
53 -l, --list
54 Don't download but just list versions.
55
56
57 --binary
58 Download binary packages instead of source packages.
59
60
61 -a, --architecture
62 Specify architecture of downloaded binary packages. Implies
63 --binary. This can be given multiple times in order to download
64 binary packages for multiple architectures.
65
66
67 --first
68 Specify the minimum version of a package which will be down‐
69 loaded. Any versions which compare larger than this, according
70 to dpkg, will be considered for download. May be used in combi‐
71 nation with --last.
72
73
74 --last Specify the maximum version of a package which will be down‐
75 loaded. Any package versions which compare less than this, ac‐
76 cording to dpkg, will be considered for download. May be used
77 in combination with --first.
78
79
80 -h, --help
81 Show a summary of these options.
82
83
84 --version
85 Show the version of debsnap.
86
87
88
90 debsnap may also be configured through the use of the following options
91 in the devscripts configuration files:
92
93
94 DEBSNAP_VERBOSE
95 Same as the command line option --verbose. Set to yes to en‐
96 able.
97
98
99 DEBSNAP_DESTDIR
100 Set a default path for the destination directory. If unset
101 ./source-<package_name> will be used. The command line option
102 --destdir will override this.
103
104
105 DEBSNAP_BASE_URL
106 The base url for the snapshots archive.
107
108 If unset this defaults to https://snapshot.debian.org
109
110
112 debsnap will return an exit status of 0 if all operations succeeded, 1
113 if a fatal error occurred, and 2 if some packages failed to be down‐
114 loaded but operations otherwise succeeded as expected. In some cases
115 packages may fail to be downloaded because they are no longer available
116 on the snapshot mirror, so any caller should expect this may occur in
117 normal use.
118
119
121 debsnap -a amd64 xterm 256-1
122 Download the binary package of a specific xterm version for
123 amd64 architecture.
124
125 debsnap -a armel xterm
126 Download binary packages for all versions of xterm for armel ar‐
127 chitecture.
128
129 debsnap --binary xterm 256-1
130 Download binary packages for a specific xterm version but for
131 all architectures.
132
133 debsnap --binary xterm
134 Download binary packages for all versions of xterm for all ar‐
135 chitectures.
136
137 debsnap -v --first 347-1 --last 348-2 xterm
138 Download source packages for local architecture of xterm, be‐
139 tween 347-1 and 348-2 revisions, inclusive, showing the progress
140 when doing it.
141
142 aptitude search '~i' -F '%p %V' | while read pkg ver; do debsnap -a
143 $(dpkg-architecture -qDEB_HOST_ARCH) -a all $pkg $ver; done
144 Download binary packages of all packages that are installed on
145 the system.
146
147
149 /etc/devscripts.conf
150 Global devscripts configuration options. Will override hard‐
151 coded defaults.
152
153 ~/.devscripts
154 Per-user configuration options. Will override any global con‐
155 figuration.
156
157
159 devscripts(1), devscripts.conf(5), git-debimport(1)
160
161
163 David Paleino <dapal@debian.org>
164
165
167 Copyright © 2010 David Paleino
168
169 Permission is granted to copy, distribute and/or modify this document
170 under the terms of the GNU General Public License, Version 3 or (at
171 your option) any later version published by the Free Software Founda‐
172 tion.
173
174 On Debian systems, the complete text of the GNU General Public License
175 can be found in /usr/share/common-licenses/GPL.
176
177
179 Reporting bugs
180 The program is part of the devscripts package. Please report bugs us‐
181 ing `reportbug devscripts`
182
183
184
185
186Debian devscripts July 3, 2010 DEBSNAP(1)