1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
.\" for manpage-specific macros, see man(7)
.TH DEBSNAP 1 "July 3, 2010" "Debian devscripts" "DebSnap User Manual"
.SH NAME
debsnap \- retrieve old snapshots of Debian packages
.SH SYNOPSIS
.B debsnap
.RI [ options ] " package " [ version ]
.B debsnap
.RB [ -h " | " \-\-help ] " " [ \-\-version ]
.SH DESCRIPTION
\fBdebsnap\fP 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
\fIhttp://snapshot.debian.org\fP
By default, debsnap will download all the available versions for \fIpackage\fP
that are found in the snapshot archive. If a \fIversion\fP is specified, only
that particular version will be downloaded, if available.
.SH OPTIONS
The following options are available:
.TP
.BI -d " destination\fR,\fP " \-\-destdir " destination"
Directory to place retrieved packages.
.TP
.BR \-f ", " \-\-force
Force writing into an existing \fIdestination\fP. By default \fBdebsnap\fP 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.
.TP
.BR \-v ", " \-\-verbose
Report on the \fBdebsnap\fP configuration being used and progress during the
download operation. Please always use this option when reporting bugs.
.TP
.BR \-h ", " \-\-help
Show a summary of these options.
.TP
.B \-\-version
Show the version of \fBdebsnap\fP.
.SH CONFIGURATION OPTIONS
\fBdebsnap\fP may also be configured through the use of the following options
in the devscripts configuration files:
.TP
.B DEBSNAP_VERBOSE
Same as the command line option \fB\-\-verbose\fP. Set to "yes" to enable.
.TP
.B DEBSNAP_DESTDIR
Set a default path for the destination directory. If unset
\fI./source\-<package_name>\fP will be used. The command line option
\fB\-\-destdir\fP will override this.
.TP
.B DEBSNAP_BASE_URL
The base url for the snapshots archive.
If unset this defaults to \fIhttp://snapshot.debian.org\fP
.SH EXIT STATUS
\fBdebsnap\fP 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.
.SH FILES
.TP
.I /etc/devscripts.conf
Global devscripts configuration options. Will override hardcoded defaults.
.TP
.I ~/.devscripts
Per\-user configuration options. Will override any global configuration.
.SH SEE ALSO
.BR devscripts (1),
.BR devscripts.conf (5),
.BR git-debimport (1)
.SH AUTHORS
David Paleino <dapal@debian.org>
.SH COPYRIGHT
Copyright \(co 2010 David Paleino
Permission 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 \fI/usr/share/common\-licenses/GPL\fP.
.SH BUGS
.SS Reporting bugs
The program is part of the devscripts package. Please report bugs using
`\fBreportbug devscripts\fP`
|
