.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "RAPT-FILE" "1" "May 2012" "" ""

.SH NAME
rapt-file \- APT package searching utility -- search remotely
.SH SYNOPSIS

\fBrapt-file\fR [ \fBoptions\fR ] [ \fBaction\fR ] [ \fBpattern\fR ]

.SH "DESCRIPTION"
.PP
\fBrapt-file\fR is a command line tool for
searching files in packages for the APT package management system.
It differs from apt-file in that it works with remote package
indices, so it doesn't need to download full Contents files.
.TP
\fBfind\fR
Alias for \fBsearch\fR\&.
.TP
\fBlist\fR
List the contents of a package matching the
\fBpattern\fR pattern. This action is very
close to the \fBdpkg -L\fR command except the
package does not need to be installed or fetched.
.TP
\fBsearch\fR
Search in which package a file is included. A list of all
packages containing the \fBpattern\fR pattern
is returned.

rapt-file will only search for filenames, not directory names.
This is due to the format of the Contents files it searches.
.TP
\fBshow\fR
Alias for \fBlist\fR\&.
.SH "OPTIONS"
.TP
\fB   -a, --architecture architecture \fR
Sets architecture to architecture\&. This
option is useful if you search a package for a different
architecture from the one installed on your system.
It determines how the $ARCH variable
in sources.list is expanded (but it does not influence
the search in any other way).
.TP
\fB   -l, --package-only \fR
Only display package name; do not display file names.
.TP
\fB   -v, --verbose \fR
Run \fBrapt-file\fR in verbose mode.
.TP
\fB   -h, --help \fR
Display a short help screen.
.SH "FILES"
.TP
\fB\fI/etc/apt/sources.list\fB\fR
Locations to fetch package contents from.
.TP
\fB\fI/etc/apt/sources.list.d/\fB\fR
Directory with additional sources.list snippets
.SH "AUTHOR"
.PP
\fBrapt-file\fR was written by Enrico Zini
<enrico@debian.org>\&.