1DGET(1)                                                                DGET(1)
2
3
4

NAME

6       dget - Download Debian source and binary packages
7

SYNOPSIS

9       dget [options] URL ...
10       dget [options] [--all] package[=version] ...
11

DESCRIPTION

13       dget downloads Debian packages.  In the first form, dget fetches the
14       requested URLs.  If this is a .dsc or .changes file, then dget acts as
15       a source-package aware form of wget: it also fetches any files
16       referenced in the .dsc/.changes file.  The downloaded source is then
17       checked with dscverify and, if successful, unpacked by dpkg-source.
18
19       In the second form, dget downloads a binary package (i.e., a .deb file)
20       from the Debian mirror configured in /etc/apt/sources.list(.d).  Unlike
21       apt-get install -d, it does not require root privileges, writes to the
22       current directory, and does not download dependencies.  If a version
23       number is specified, this version of the package is requested.  With
24       --all, the list of all binaries for the source package package is
25       extracted from the output of "apt-cache showsrc package".
26
27       In both cases dget is capable of getting several packages and/or URLs
28       at once.
29
30       (Note that .udeb packages used by debian-installer are located in
31       separate packages files from .deb packages. In order to use .udebs with
32       dget, you will need to have configured apt to use a packages file for
33       component/debian-installer).
34
35       Before downloading files listed in .dsc and .changes files, and before
36       downloading binary packages, dget checks to see whether any of these
37       files already exist.  If they do, then their md5sums are compared to
38       avoid downloading them again unnecessarily.  dget also looks for
39       matching files in /var/cache/apt/archives and directories given by the
40       --path option or specified in the configuration files (see below).
41       Finally, if downloading (.orig).tar.gz or .diff.gz files fails, dget
42       consults apt-get source --print-uris.  Download backends used are curl
43       and wget, looked for in that order.
44
45       dget was written to make it easier to retrieve source packages from the
46       web for sponsor uploads.  For checking the package with debdiff, the
47       last binary version is available via dget package, the last source
48       version via apt-get source package.
49

OPTIONS

51       -a, --all
52           Interpret package as a source package name, and download all
53           binaries as found in the output of "apt-cache showsrc package".  If
54           package is arch-qualified, then only binary packages which are
55           "Arch: all", "Arch: any", or "Arch: $arch" will be downloaded.
56
57       -b, --backup
58           Move files that would be overwritten to ./backup.
59
60       -q, --quiet
61           Suppress wget/curl non-error output.
62
63       -d, --download-only
64           Do not run dpkg-source -x on the downloaded source package.  This
65           can only be used with the first method of calling dget.
66
67       -x, --extract
68           Run dpkg-source -x on the downloaded source package to unpack it.
69           This option is the default and can only be used with the first
70           method of calling dget.
71
72       -u, --allow-unauthenticated
73           Do not attempt to verify the integrity of downloaded source
74           packages using dscverify.
75
76       --build
77           Run dpkg-buildpackage -b -uc on the downloaded source package.
78
79       --path DIR[:DIR ...]
80           In addition to /var/cache/apt/archives, dget uses the colon-
81           separated list given as argument to --path to find files with a
82           matching md5sum.  For example: "--path
83           /srv/pbuilder/result:/home/cb/UploadQueue".  If DIR is empty (i.e.,
84           "--path ''" is specified), then any previously listed directories
85           or directories specified in the configuration files will be
86           ignored.  This option may be specified multiple times, and all of
87           the directories listed will be searched; hence, the above example
88           could have been written as: "--path /srv/pbuilder/result --path
89           /home/cb/UploadQueue".
90
91       -k, --insecure
92           Allow SSL connections to untrusted hosts.
93
94       --no-cache
95           Bypass server-side HTTP caches by sending a Pragma: no-cache
96           header.
97
98       -h, --help
99           Show a help message.
100
101       -V, --version
102           Show version information.
103

CONFIGURATION VARIABLES

105       The two configuration files /etc/devscripts.conf and ~/.devscripts are
106       sourced by a shell in that order to set configuration variables.
107       Command line options can be used to override configuration file
108       settings.  Environment variable settings are ignored for this purpose.
109       The currently recognised variable is:
110
111       DGET_PATH
112           This can be set to a colon-separated list of directories in which
113           to search for files in addition to the default
114           /var/cache/apt/archives.  It has the same effect as the --path
115           command line option.  It is not set by default.
116
117       DGET_UNPACK
118           Set to 'no' to disable extracting downloaded source packages.
119           Default is 'yes'.
120
121       DGET_VERIFY
122           Set to 'no' to disable checking signatures of downloaded source
123           packages.  Default is 'yes'.
124

EXAMPLES

126       Download all .deb files for the previous version of a package and run
127       debdiff on them:
128
129         dget --all mypackage=1.2-1
130         debdiff --from *_1.2-1_*.deb --to *_1.2-2_*.deb
131

BUGS AND COMPATIBILITY

133       dget package should be implemented in apt-get install -d.
134
135       Before devscripts version 2.10.17, the default was not to extract the
136       downloaded source. Set DGET_UNPACK=no to revert to the old behaviour.
137

AUTHOR

139       This program is Copyright (C) 2005-2013 by Christoph Berg
140       <myon@debian.org>.  Modifications are Copyright (C) 2005-06 by Julian
141       Gilbey <jdg@debian.org>.
142
143       This program is licensed under the terms of the GPL, either version 2
144       of the License, or (at your option) any later version.
145

SEE ALSO

147       apt-get(1), curl(1), debcheckout(1), debdiff(1), dpkg-source(1),
148       wget(1)
149
150
151
152Debian Utilities                  2023-07-19                           DGET(1)
Impressum