.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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 "DCONTROL 1"
.TH DCONTROL 1 "2019-07-20" "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"
dcontrol \-\- Query package and source control files for all Debian distributions
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\fBdcontrol\fR [\fIoptions\fR] \fIpackage\fR[\fImodifiers\fR] ..." 4
.IX Item "dcontrol [options] package[modifiers] ..."
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdcontrol\fR queries a remote database of Debian binary and source package
control files. It can be thought of as an \fBapt-cache\fR webservice that also
operates for distributions and architectures different from the local machine.
.SH "MODIFIERS"
.IX Header "MODIFIERS"
Like \fBapt-cache\fR, packages can be suffixed by modifiers:
.IP "\fB=\fR\fIversion\fR" 4
.IX Item "=version"
Exact version match
.IP "\fB@\fR\fIarchitecture\fR" 4
.IX Item "@architecture"
Query this only architecture. Use \fB\f(CB@source\fB\fR for source packages,
\&\fB\f(CB@binary\fB\fR excludes source packages.
.IP "\fB/\fR[\fIarchive\fR\fB:\fR][\fIsuite\fR][\fB/\fR\fIcomponent\fR]" 4
.IX Item "/[archive:][suite][/component]"
Restrict to \fIarchive\fR (debian, debian-backports, debian-security,
debian-volatile), \fIsuite\fR (always codenames, with the exception of
experimental), and/or \fIcomponent\fR (main, updates/main, ...). Use two slashes
(\fB//\fR) to separate suite and component if the suite name contains slashes.
(Component can be left empty.)
.PP
By default, all versions, suites, and architectures are queried. Refer to
\&\fBhttps://qa.debian.org/cgi\-bin/dcontrol\fR for currently supported values.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-s\fR, \fB\-\-show\-suites\fR" 4
.IX Item "-s, --show-suites"
Add headers showing which distribution the control file is from.
.IP "\fB\-d\fR, \fB\-\-debug\fR" 4
.IX Item "-d, --debug"
Print \s-1URL\s0 queried.
.IP "\fB\-\-noconf\fR, \fB\-\-no\-conf\fR" 4
.IX Item "--noconf, --no-conf"
Ignore all configuration files (must be the first option).
.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 "\s-1DCONTROL_URL\s0" 4
.IX Item "DCONTROL_URL"
\&\s-1URL\s0 to query. Default is \fBhttps://qa.debian.org/cgi\-bin/dcontrol\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
This program is Copyright (C) 2009 by Christoph Berg <myon@debian.org>.
.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-cache\fR(1)