.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.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
\&.