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       --list Don't download but just list versions.
54
55
56       --binary
57              Download binary packages instead of source packages.
58
59
60       -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
65
66       --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
72
73       --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
78
79       -h, --help
80              Show a summary of these options.
81
82
83       --version
84              Show the version of debsnap.
85
86
87

CONFIGURATION OPTIONS

89       debsnap may also be configured through the use of the following options
90       in the devscripts configuration files:
91
92
93       DEBSNAP_VERBOSE
94              Same as the command  line  option  --verbose.   Set  to  yes  to
95              enable.
96
97
98       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
103
104       DEBSNAP_BASE_URL
105              The base url for the snapshots archive.
106
107              If unset this defaults to https://snapshot.debian.org
108
109

EXIT STATUS

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
118

EXAMPLES

120       debsnap -a amd64 xterm 256-1
121              Download the binary package of  a  specific  xterm  version  for
122              amd64 architecture.
123
124       debsnap -a armel xterm
125              Download  binary  packages  for  all versions of xterm for armel
126              architecture.
127
128       debsnap --binary xterm 256-1
129              Download binary packages for a specific xterm  version  but  for
130              all architectures.
131
132       debsnap --binary xterm
133              Download  binary  packages  for  all  versions  of xterm for all
134              architectures.
135
136       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
141       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
146

FILES

148       /etc/devscripts.conf
149              Global devscripts configuration options.   Will  override  hard‐
150              coded defaults.
151
152       ~/.devscripts
153              Per-user  configuration  options.  Will override any global con‐
154              figuration.
155
156

SEE ALSO

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

AUTHORS

162       David Paleino <dapal@debian.org>
163
164
166       Copyright © 2010 David Paleino
167
168       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
173       On  Debian systems, the complete text of the GNU General Public License
174       can be found in /usr/share/common-licenses/GPL.
175
176

BUGS

178   Reporting bugs
179       The program is part of the  devscripts  package.   Please  report  bugs
180       using `reportbug devscripts`
181
182
183
184
185Debian devscripts                July 3, 2010                       DEBSNAP(1)
Impressum