1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
.TH apt-file 1 "January 2002" "Version 0.2.3"
.UC 1
.SH "NAME"
apt-file \- APT package searching utility -- command-line interface
.SH SYNOPSIS
.sp
\fBapt-file\fR [\fIoptions\fR] \fIaction\fR \fIpattern\fR
.SH "DESCRIPTION"
.PP
\fBapt-file\fR is a command line tool for searching packages for the
APT packaging system.
.PP
Some actions are required to run the search.
.TP
\fBupdate\fR
\fIupdate\fR is used to resynchronize the package contents from their
sources. The contents packages are fetched from the location(s)
specified in \fI/etc/apt/sources.list\fR. This command attempt to
fetch the \fIContents-<ARCH>.gz\fR file from remote source.
.TP
\fBsearch\fR
\fBsearch\fR is used to search in which package file is included. A
list of all package containing the \fIpattern\fR pattern is returned.
.TP
\fBlist\fR
\fBlist\fR is used to list the contents of a package matching the
\fIpattern\fR pattern. This action is very close to the \fBdpkg -S\fR
command except the package does not need to be installed or fetched.
.SH "OPTIONS"
.PP
Many options can be overridden via the command-line or set in the
configuration file (\fI/etc/apt/apt-file.conf\fR). For boolean options
you can prefix them with \fBno\fR to inhibit this option.
.TP
\fB--cache | -c \fIcache-directory\fB\fR
Sets the cache directory to \fIcache-directory\fR instead of its
default value (\fI/var/cache/apt\fR) thus you can use \fBapt-file\fR
even if you do not have administrator privileges.
.TP
\fB--(no)auto-apt | -(no)afR
Use \fBauto-apt\fR(1) cache files (located in
\fI/var/cache/auto-apt\fR) instead of \fBapt-file\fR's one. See
\fBauto-apt\fR(1) for more details.
.TP
\fB--(no)verbose | -(no)v\fR
Run \fBapt-file\fR in verbose mode.
.TP
\fB--version\fR
Show version number.
.TP
\fB--arch | -a \fIarchitecture\fR
Sets architecture to \fIarchitecture\fR. This option is useful if you
search a package for a different architecture the one installed on
your system.
.TP
\fB--source-list | -s \fIsources.list\fR
Sets the \fIsources.list\fR file to a different value its default
\fI/etc/apt/sources.list\fR.
.TP
\fB--(no)ftp-passive | -(no)p\fR
Use passive mode fot FTP connections. This option should be used is
you are behind a firewall or a gateway (see \fBftp\fR (1) man page for
more details).
.TP
\fB--(no)recursive | -(no)r\fR
Search recursivelly file name in the contents list. Note: this option
is currently disabled.
.TP
\fB--(no)case-sensitive | -(no)i\fR
Runs \fBapt-file\fR in case-sensitive mode.
.PP
.SH "FILES"
.TP
\fB\fI/etc/apt/sources.list\fB\fR
Locations to fetch packages contents from.
.TP
\fB\fI/etc/apt/apt-file.conf\fB\fR
Configuration file for \fBapt-file\fR
.SH "SEE ALSO"
.PP
\fBauto-apt\fR(1), \fBapt-cache\fR(8), \fBapt-cdrom\fR(8),
\fBdpkg\fR(8), \fBdselect\fR(8), \fB\fIsources.list\fB\fR(5),
\fB\fIapt.conf\fB\fR(5), \fBapt_preferences\fR(5).
.PP
The APT users guide in \fI/usr/share/doc/apt/\fR
.SH "BUGS"
Actually no bugs are reported.
.SH "AUTHOR"
.PP
\fBapt-file\fR was written by Sebastien J. Gross <seb@sjgross.org>
|
