1DEBSNAP(1)                    DebSnap User Manual                   DEBSNAP(1)
2
3
4

NAME

6       debsnap - retrieve old snapshots of Debian packages
7
8

SYNOPSIS

10       debsnap [options] package [version]
11
12       debsnap [-h | --help] [--version]
13
14
15

DESCRIPTION

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

OPTIONS

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

CONFIGURATION OPTIONS

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

EXIT STATUS

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

EXAMPLES

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

FILES

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

SEE ALSO

159       devscripts(1), devscripts.conf(5), git-debimport(1)
160
161

AUTHORS

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

BUGS

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)
Impressum