.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" 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 turned on, 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 "CPANDB 1"
.TH CPANDB 1 "2015-07-15" "perl v5.16.3" "User Contributed Perl Documentation"
.\" 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"
cpandb \- interface to "CPAN::SQLite"
.SH "VERSION"
.IX Header "VERSION"
version 0.211
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This script is an interface to the routines of
CPAN::SQLite for setting up, maintaining and
searching a \f(CW\*(C`DBD::SQLite\*(C'\fR database
of \s-1CPAN.\s0 Available options can be grouped into
three categories.
.SS "Common options"
.IX Subsection "Common options"
These are options which are common to both setting up
and maintaining the database or performing queries on it.
These are
.IP "\(bu" 3
\&\f(CW\*(C`\-\-CPAN  \*(Aq/path/to/CPAN\*(Aq\*(C'\fR
.Sp
This specifies the path to where the index files are
to be stored. This could be a local \s-1CPAN\s0 mirror,
defined here by the presence of a \fI\s-1MIRRORED.BY\s0\fR file beneath
this directory, or a local directory in which to store
these files from a remote \s-1CPAN\s0 mirror. In the latter case,
the index files are fetched from a remote \s-1CPAN\s0 mirror,
using the same list that \f(CW\*(C`CPAN.pm\*(C'\fR uses, if this is
configured, and are updated if they are more than one
day old.
.Sp
If the \f(CW\*(C`CPAN\*(C'\fR option is not given, it will default
to \f(CW\*(C`cpan_home\*(C'\fR of \s-1CPAN::\s0, if this is configured,
with the sources being found under \f(CW\*(C`keep_source_where\*(C'\fR.
A fatal error results if such a directory isn't found.
Updates to these index files are assumed here to be
handled by \f(CW\*(C`CPAN.pm\*(C'\fR.
.IP "\(bu" 3
\&\f(CW\*(C`\-\-db_name  \*(Aqcpan\-sqlite\*(Aq\*(C'\fR
.Sp
This is the name of the database that \f(CW\*(C`DBD::SQLite\*(C'\fR
will use. If not given, this defaults to \f(CW\*(C`cpandb\-sqlite\*(C'\fR.
.IP "\(bu" 3
\&\f(CW\*(C`\-\-db_dir  \*(Aq/path/to/db/dir\*(Aq\*(C'\fR
.Sp
This specifies the path to where the database file is
found. If not given, it defaults to the
\&\f(CW\*(C`cpan_home\*(C'\fR directory of \f(CW\*(C`CPAN.pm\*(C'\fR, if present, or to
the directory in which the script was invoked.
.SS "Indexing options"
.IX Subsection "Indexing options"
These are options which are used for setting up and
maintaining the database. These include
.IP "\(bu" 3
\&\f(CW\*(C`\-\-setup\*(C'\fR
.Sp
This specifies that the database is to be created and
populated from the \s-1CPAN\s0 indices; any existing database
will be overwritten.
.IP "\(bu" 3
\&\f(CW\*(C`\-\-update\*(C'\fR
.Sp
This is used to update an existing database,
which must have first been created with the \f(CW\*(C`setup\*(C'\fR
option.
.IP "\(bu" 3
\&\f(CW\*(C`\-\-reindex \*(Aqdist_name\*(Aq\*(C'\fR
.Sp
This specifies that the \s-1CPAN\s0 distribution \f(CW\*(C`dist_name\*(C'\fR
is to be reindexed.
.SS "Querying options"
.IX Subsection "Querying options"
These options are used to query the database. Available
options are
.IP "\(bu" 3
\&\f(CW\*(C`\-\-module Mod::Name\*(C'\fR
.Sp
This provides information on the specified module name.
.IP "\(bu" 3
\&\f(CW\*(C`\-\-dist Dist\-Name\*(C'\fR
.Sp
This provides information on the specified distribution name.
.IP "\(bu" 3
\&\f(CW\*(C`\-\-cpanid CPANID\*(C'\fR
.Sp
This provides information on the specified \s-1CPAN\s0 author id
.PP
All search terms are assumed to be exact matches in a
case-insensitive manner.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
CPAN::SQLite.