.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" 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 "RMADISON 1"
.TH RMADISON 1 "2023-12-12" "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"
rmadison \-\- Remotely query the Debian archive database about packages
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\fBrmadison\fR [\fI\s-1OPTIONS\s0\fR] \fI\s-1PACKAGE\s0\fR ..." 4
.IX Item "rmadison [OPTIONS] PACKAGE ..."
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdak ls\fR queries the Debian archive database (\*(L"projectb\*(R") and
displays which package version is registered per architecture/component/suite.
The \s-1CGI\s0 at \fBhttps://qa.debian.org/madison.php\fR provides that service without
requiring \s-1SSH\s0 access to ftp\-master.debian.org or the mirror on
mirror.ftp\-master.debian.org. This script, \fBrmadison\fR, is a command line
frontend to this \s-1CGI.\s0
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-a\fR, \fB\-\-architecture=\fR\fI\s-1ARCH\s0\fR" 4
.IX Item "-a, --architecture=ARCH"
only show info for \s-1ARCH\s0(s)
.IP "\fB\-b\fR, \fB\-\-binary\-type=\fR\fI\s-1TYPE\s0\fR" 4
.IX Item "-b, --binary-type=TYPE"
only show info for binary \s-1TYPE\s0
.IP "\fB\-c\fR, \fB\-\-component=\fR\fI\s-1COMPONENT\s0\fR" 4
.IX Item "-c, --component=COMPONENT"
only show info for \s-1COMPONENT\s0(s)
.IP "\fB\-g\fR, \fB\-\-greaterorequal\fR" 4
.IX Item "-g, --greaterorequal"
show buildd 'dep\-wait pkg >= {highest version}' info
.IP "\fB\-G\fR, \fB\-\-greaterthan\fR" 4
.IX Item "-G, --greaterthan"
show buildd 'dep\-wait pkg >> {highest version}' info
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
show this help and exit
.IP "\fB\-s\fR, \fB\-\-suite=\fR\fI\s-1SUITE\s0\fR" 4
.IX Item "-s, --suite=SUITE"
only show info for this suite
.IP "\fB\-r\fR, \fB\-\-regex\fR" 4
.IX Item "-r, --regex"
treat \s-1PACKAGE\s0 as a regex
.Sp
\&\fBNote:\fR Since \fB\-r\fR can easily DoS the database (\*(L"\-r .\*(R"), this option is not
supported by the \s-1CGI\s0 on qa.debian.org and most other installations.
.IP "\fB\-S\fR, \fB\-\-source\-and\-binary\fR" 4
.IX Item "-S, --source-and-binary"
show info for the binary children of source pkgs
.IP "\fB\-t\fR, \fB\-\-time\fR" 4
.IX Item "-t, --time"
show projectb snapshot and reload time (not supported by all archives)
.IP "\fB\-u\fR, \fB\-\-url=\fR\fI\s-1URL\s0\fR[\fB,\fR\fI\s-1URL\s0\fR ...]" 4
.IX Item "-u, --url=URL[,URL ...]"
use \fI\s-1URL\s0\fR for the query. Supported shorthands are
 \fBdebian\fR https://api.ftp\-master.debian.org/madison
 \fBnew\fR https://api.ftp\-master.debian.org/madison?s=new
 \fBqa\fR https://qa.debian.org/madison.php
 \fBubuntu\fR https://people.canonical.com/~ubuntu\-archive/madison.cgi
 \fBudd\fR https://qa.debian.org/cgi\-bin/madison.cgi
 \fBarchive\fR https://qa.debian.org/cgi\-bin/madison.cgi?table=archived
 \fBports\fR https://qa.debian.org/cgi\-bin/madison.cgi?table=ports
.Sp
See the \fB\s-1RMADISON_URL_MAP_\s0\fR variable below for a method to add
new shorthands.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
show version and exit
.IP "\fB\-\-no\-conf\fR, \fB\-\-noconf\fR" 4
.IX Item "--no-conf, --noconf"
don't read the devscripts configuration files
.PP
\&\s-1ARCH, COMPONENT\s0 and \s-1SUITE\s0 can be comma (or space) separated lists, e.g.
\&\-\-architecture=amd64,i386
.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 variables are:
.IP "\fB\s-1RMADISON_URL_MAP_\s0\fR\fI\s-1SHORTHAND\s0\fR=\fI\s-1URL\s0\fR" 4
.IX Item "RMADISON_URL_MAP_SHORTHAND=URL"
Add an entry to the set of shorthand URLs listed above. \fI\s-1SHORTHAND\s0\fR should
be replaced with the shorthand form to be used to refer to \fI\s-1URL\s0\fR.
.Sp
Multiple shorthand entries may be specified by using multiple
\&\fBRMADISON_URL_MAP_*\fR variables.
.IP "\fB\s-1RMADISON_DEFAULT_URL\s0\fR=\fI\s-1URL\s0\fR" 4
.IX Item "RMADISON_DEFAULT_URL=URL"
Set the default \s-1URL\s0 to use unless overridden by a command line option.
For Debian this defaults to debian. For Ubuntu this defaults to ubuntu.
.IP "\fB\s-1RMADISON_ARCHITECTURE\s0\fR=\fI\s-1ARCH\s0\fR" 4
.IX Item "RMADISON_ARCHITECTURE=ARCH"
Set the default architecture to use unless overridden by a command line option.
To run an unrestricted query when \fB\s-1RMADISON_ARCHITECTURE\s0\fR is set, use
\&\fB\-\-architecture='*'\fR.
.IP "\fB\s-1RMADISON_SSL_CA_FILE\s0\fR=\fI\s-1FILE\s0\fR" 4
.IX Item "RMADISON_SSL_CA_FILE=FILE"
Use the specified \s-1CA\s0 file instead of the default \s-1CA\s0 bundle for curl/wget,
passed as \-\-cacert to curl, and as \-\-ca\-certificate to wget.
.IP "\fB\s-1RMADISON_SSL_CA_PATH\s0\fR=\fI\s-1PATH\s0\fR" 4
.IX Item "RMADISON_SSL_CA_PATH=PATH"
Use the specified \s-1CA\s0 directory instead of the default \s-1CA\s0 bundle for curl/wget,
passed as \-\-capath to curl, and as \-\-ca\-directory to wget.
.SH "NOTES"
.IX Header "NOTES"
\&\fBdak ls\fR was formerly called \fBmadison\fR.
.PP
The protocol used by rmadison is fairly simple, the \s-1CGI\s0 accepts query the
parameters a, b, c, g, G, r, s, S, t, and package. The parameter text is passed to
enable plain-text output.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdak\fR(1), \fBmadison-lite\fR(1)
.SH "AUTHOR"
.IX Header "AUTHOR"
rmadison and https://qa.debian.org/madison.php were written by Christoph Berg
<myon@debian.org>. dak was written by
James Troup <james@nocrew.org>, Anthony Towns <ajt@debian.org>, and others.