.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DGET 1" .TH DGET 1 "2022-06-21" "Debian Utilities" " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" dget \- Download Debian source and binary packages .SH "SYNOPSIS" .IX Header "SYNOPSIS" .IP "\fBdget\fR [\fIoptions\fR] \fI\s-1URL\s0\fR ..." 4 .IX Item "dget [options] URL ..." .PD 0 .IP "\fBdget\fR [\fIoptions\fR] [\fB\-\-all\fR] \fIpackage\fR[\fB=\fR\fIversion\fR] ..." 4 .IX Item "dget [options] [--all] package[=version] ..." .PD .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBdget\fR downloads Debian packages. In the first form, \fBdget\fR fetches the requested URLs. If this is a .dsc or .changes file, then \fBdget\fR acts as a source-package aware form of \fBwget\fR: it also fetches any files referenced in the .dsc/.changes file. The downloaded source is then checked with \fBdscverify\fR and, if successful, unpacked by \&\fBdpkg-source\fR. .PP In the second form, \fBdget\fR downloads a \fIbinary\fR package (i.e., a \&\fI.deb\fR file) from the Debian mirror configured in /etc/apt/sources.list(.d). Unlike \fBapt-get install \-d\fR, it does not require root privileges, writes to the current directory, and does not download dependencies. If a version number is specified, this version of the package is requested. With \fB\-\-all\fR, the list of all binaries for the source package \fIpackage\fR is extracted from the output of \&\f(CW\*(C`apt\-cache showsrc package\*(C'\fR. .PP In both cases dget is capable of getting several packages and/or URLs at once. .PP (Note that \fI.udeb\fR packages used by debian-installer are located in separate packages files from \fI.deb\fR packages. In order to use \fI.udebs\fR with \fBdget\fR, you will need to have configured \fBapt\fR to use a packages file for \&\fIcomponent\fR/\fIdebian-installer\fR). .PP Before downloading files listed in .dsc and .changes files, and before downloading binary packages, \fBdget\fR checks to see whether any of these files already exist. If they do, then their md5sums are compared to avoid downloading them again unnecessarily. \fBdget\fR also looks for matching files in \fI/var/cache/apt/archives\fR and directories given by the \fB\-\-path\fR option or specified in the configuration files (see below). Finally, if downloading (.orig).tar.gz or .diff.gz files fails, dget consults \fBapt-get source \-\-print\-uris\fR. Download backends used are \fBcurl\fR and \fBwget\fR, looked for in that order. .PP \&\fBdget\fR was written to make it easier to retrieve source packages from the web for sponsor uploads. For checking the package with \&\fBdebdiff\fR, the last binary version is available via \fBdget\fR \&\fIpackage\fR, the last source version via \fBapt-get source\fR \fIpackage\fR. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-a\fR, \fB\-\-all\fR" 4 .IX Item "-a, --all" Interpret \fIpackage\fR as a source package name, and download all binaries as found in the output of "apt-cache showsrc \fIpackage\fR". If \fIpackage\fR is arch-qualified, then only binary packages which are \*(L"Arch: all\*(R", \*(L"Arch: any\*(R", or \*(L"Arch: \f(CW$arch\fR\*(R" will be downloaded. .IP "\fB\-b\fR, \fB\-\-backup\fR" 4 .IX Item "-b, --backup" Move files that would be overwritten to \fI./backup\fR. .IP "\fB\-q\fR, \fB\-\-quiet\fR" 4 .IX Item "-q, --quiet" Suppress \fBwget\fR/\fBcurl\fR non-error output. .IP "\fB\-d\fR, \fB\-\-download\-only\fR" 4 .IX Item "-d, --download-only" Do not run \fBdpkg-source \-x\fR on the downloaded source package. This can only be used with the first method of calling \fBdget\fR. .IP "\fB\-x\fR, \fB\-\-extract\fR" 4 .IX Item "-x, --extract" Run \fBdpkg-source \-x\fR on the downloaded source package to unpack it. This option is the default and can only be used with the first method of calling \fBdget\fR. .IP "\fB\-u\fR, \fB\-\-allow\-unauthenticated\fR" 4 .IX Item "-u, --allow-unauthenticated" Do not attempt to verify the integrity of downloaded source packages using \fBdscverify\fR. .IP "\fB\-\-build\fR" 4 .IX Item "--build" Run \fBdpkg-buildpackage \-b \-uc\fR on the downloaded source package. .IP "\fB\-\-path\fR \fI\s-1DIR\s0\fR[\fB:\fR\fI\s-1DIR\s0\fR ...]" 4 .IX Item "--path DIR[:DIR ...]" In addition to \fI/var/cache/apt/archives\fR, \fBdget\fR uses the colon-separated list given as argument to \fB\-\-path\fR to find files with a matching md5sum. For example: \*(L"\-\-path /srv/pbuilder/result:/home/cb/UploadQueue\*(R". If \s-1DIR\s0 is empty (i.e., \&\*(L"\-\-path ''\*(R" is specified), then any previously listed directories or directories specified in the configuration files will be ignored. This option may be specified multiple times, and all of the directories listed will be searched; hence, the above example could have been written as: \*(L"\-\-path /srv/pbuilder/result \-\-path /home/cb/UploadQueue\*(R". .IP "\fB\-\-insecure\fR" 4 .IX Item "--insecure" Allow \s-1SSL\s0 connections to untrusted hosts. .IP "\fB\-\-no\-cache\fR" 4 .IX Item "--no-cache" Bypass server-side \s-1HTTP\s0 caches by sending a \fBPragma: no-cache\fR header. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Show a help message. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Show version information. .SH "CONFIGURATION VARIABLES" .IX Header "CONFIGURATION VARIABLES" The two configuration files \fI/etc/devscripts.conf\fR and \&\fI~/.devscripts\fR are sourced by a shell in that order to set configuration variables. Command line options can be used to override configuration file settings. Environment variable settings are ignored for this purpose. The currently recognised variable is: .IP "\fB\s-1DGET_PATH\s0\fR" 4 .IX Item "DGET_PATH" This can be set to a colon-separated list of directories in which to search for files in addition to the default \&\fI/var/cache/apt/archives\fR. It has the same effect as the \fB\-\-path\fR command line option. It is not set by default. .IP "\fB\s-1DGET_UNPACK\s0\fR" 4 .IX Item "DGET_UNPACK" Set to 'no' to disable extracting downloaded source packages. Default is 'yes'. .IP "\fB\s-1DGET_VERIFY\s0\fR" 4 .IX Item "DGET_VERIFY" Set to 'no' to disable checking signatures of downloaded source packages. Default is 'yes'. .SH "EXAMPLES" .IX Header "EXAMPLES" Download all \fI.deb\fR files for the previous version of a package and run \fBdebdiff\fR on them: .PP .Vb 2 \& dget \-\-all mypackage=1.2\-1 \& debdiff \-\-from *_1.2\-1_*.deb \-\-to *_1.2\-2_*.deb .Ve .SH "BUGS AND COMPATIBILITY" .IX Header "BUGS AND COMPATIBILITY" \&\fBdget\fR \fIpackage\fR should be implemented in \fBapt-get install \-d\fR. .PP Before devscripts version 2.10.17, the default was not to extract the downloaded source. Set DGET_UNPACK=no to revert to the old behaviour. .SH "AUTHOR" .IX Header "AUTHOR" This program is Copyright (C) 2005\-2013 by Christoph Berg . Modifications are Copyright (C) 2005\-06 by Julian Gilbey . .PP This program is licensed under the terms of the \s-1GPL,\s0 either version 2 of the License, or (at your option) any later version. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBapt-get\fR(1), \fBcurl\fR(1), \fBdebcheckout\fR(1), \fBdebdiff\fR(1), \fBdpkg-source\fR(1), \&\fBwget\fR(1)