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 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291
|
.TH DLOCATE 1 "2009-06-03" "Debian Project" "dlocate"
.\" Please adjust this date whenever revising the manpage.
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
dlocate - program to view debian package information
.SH SYNOPSIS
.B dlocate
.RI [ OPTIONS ]
.RI [ command ]
.RB [
.IR package .\|.\|.
|
.IR PATTERN .\|.\|.]
.
.SH "DESCRIPTION"
.PP
.B dlocate
is a fast alternative to dpkg for queries like `dpkg \-L' and `dpkg \-S'
.SH COMMANDS
.TP
.BR (none)
List all records where either the package name or the filename matches
.IR PATTERN .
Note that dlocate uses GNU grep, so normal regexp metacharacters need to be taken into account or avoided
by using the '\-F' (Fixed String) grep option.
For example, to search for `/usr/bin/[', you might try:
\fBdlocate '/usr/bin/\\['\fP
or
\fBdlocate \-F '/usr/bin/['\fP
.TP
.BR \-S
List all records where only the filename matches
.IR PATTERN .
Note that dlocate uses GNU grep, so normal regexp metacharacters need to be taken into account.
Fixed String searches are incompatible with \-S.
For example, to search for `/usr/bin/[', you need to type:
\fBdlocate '/usr/bin/\\['\fP
.TP
.BR \-l
Regexp-enhanced emulation of `dpkg \-l'. Shows all packages which match
.IR package .
Internally this uses grep on a file containing the reformatted
output of 'dpkg \-l' (four fields separated by tabs; status,
package-name, installed version, short description) so it will return
packages whose version or short description matches, too.
Various flavours of regular expression are supported. For example, Extended Regexp:
\fBdlocate \-l '^..[[:space:]]libc6'\fP
or Perl Regexp:
\fBdlocate \-P \-l '^..\\slibc6'\fP
Both of these will list all the packages whose names start with `libc6'.
Note that because of the difference between regular expressions and
dpkg's shell\-style pattern matching, the output from \fBdlocate \-l\fP
is occasionally different to the output from \fBdpkg \-l\fP.
This is not a bug, regular expressions are far more flexible than shell
pattern matching. This is the way dlocate is supposed to run, but it
may require some knowledge of regular expressions to get the output you
want.
.TP
.BR \-k
List package names of installed kernels and all related packages
.TP
.BR \-K
Detailed list of installed kernels and all related packages
.TP
.BR \-L
List all files in
.IR package .
.TP
.BR \-s
Print status of
.IR package .
.TP
.BR \-ls
`ls \-ldF' of all files in
.IR package .
.TP
.BR \-lsconf
`ls \-ldF' of conffiles in
.IR package .
.TP
.BR \-conf
List conffiles in
.IR package .
.TP
.BR \-du
`du \-sck' of all files in
.IR package .
.TP
.BR \-md5sum
List md5sums (if any) of
.IR package .
.TP
.BR \-md5check
Check md5sums (if any) of
.IR package .
.TP
.BR \-man
List man pages (if any) in
.IR package .
.TP
.BR \-lsman
List full path/filenames of man pages (if any) in
.IR package .
.TP
.BR \-lsbin
List full path/filenames of executable files (if any) in
.IR package .
.SH OPTIONS
.TP
.BR \-\^\-filename\-only
Only output file names when searching for files
.TP
.BR \-\^\-package\-only
Only output package names when searching for files
.TP
.BR \-w ", " \-\^\-word\-regexp
Select only those lines containing matches that form whole words.
The test is that the matching substring must either be at the
beginning of the line, or preceded by a non-word constituent
character. Similarly, it must be either at the end of the line
or followed by a non-word constituent character. Word-constituent
characters are letters, digits, and the underscore.
.TP
.BR \-i ", " --ignore-case
Ignore case distinctions in the PATTERN
.TP
.BR \-E ", " \-\^\-extended\-regexp
Interpret
.I PATTERN
as an extended regular expression.
This is the default.
.TP
.BR \-F ", " \-\^\-fixed\-strings
Interpret
.I PATTERN
as a list of fixed strings, separated by newlines,
any of which is to be matched.
.TP
.BR \-G ", " \-\^\-basic\-regexp
Interpret
.I PATTERN
as a basic regular expression.
.TP
.BR \-P ", " \-\^\-perl\-regexp
Interpret
.I PATTERN
as a Perl regular expression.
This is considered to be highly experimental within GNU grep and may warn of unimplemented features.
.TP
.BR \-h ", " \-H ", " \-\-help
Produces a short help message and exits.
.TP
.BR \-V ", " \-\-version
Display dlocate's version number and exit.
.TP
.BR \-v ", " \-\-verbose ", " \-\-debug
Produce verbose debugging output
.PP
.SH FILES
.TP
.I /etc/default/dlocate
Configuration file with default options. Currently the only option is
to enable/disable gzip compression of /var/lib/dlocate/dlocatedb.
.TP
.I /var/lib/dlocate/dlocatedb
Plain text listing of all files belonging to all packages (optionally compressed)
.TP
.I /var/lib/dlocate/dpkg-list
Listing of all packages known to dpkg.
This contains the reformatted output output of 'dpkg \-l'. The file format is four fields separated by tabs:
status [TAB] package-name [TAB] installed version [TAB] short description
.SH EXAMPLES
To find which package `/usr/bin/[' belongs to:
.br
\fB dlocate '/usr/bin/\\['\fP
.br
To view all man pages contained within the dpkg package:
.br
\fB man $(dlocate \-man dpkg)\fP
.br
To purge kernel version 2.6.28.7 and all related module packages:
.br
\fB dlocate \-k | grep \-\- \-2.6.28.7 | xargs apt\-get purge\fP
.br
To check the md5sums of the dlocate package:
.br
\fB dlocate \-md5check dlocate\fP
.br
To use dpkg-repack to make a backup copy of all installed mythtv packages just before
upgrading them:
.br
\fB dlocate \-l mythtv | grep '^.i' | awk '{print $2}' | xargs dpkg\-repack\fP
.br
.br
# dlocate \-l mythtv | grep '^.i' | awk '{print $2}' | xargs dpkg\-repack
.br
dpkg-deb: building package `libmythtv-perl' in `./libmythtv-perl_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv' in `./mythtv_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-backend' in `./mythtv-backend_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-common' in `./mythtv-common_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-database' in `./mythtv-database_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-doc' in `./mythtv-doc_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-frontend' in `./mythtv-frontend_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-perl' in `./mythtv-perl_0.21.svn20090414-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtv-status' in `./mythtv-status_0.9.0-5_amd64.deb'.
.br
dpkg-deb: building package `mythtv-themes' in `./mythtv-themes_0.21-0.0_amd64.deb'.
.br
dpkg-deb: building package `mythtvfs' in `./mythtvfs_0.5.2-2_amd64.deb'.
.br
dpkg-deb: building package `python-mythtv' in `./python-mythtv_0.21.svn20090414-0.0_amd64.deb'.
.br
.SH ENVIRONMENT VARIABLES
.TP
.BR COLUMNS
Sets the number of columns \fBdlocate\fP should use when displaying formatted
text. Currently only used by \-l. Values lower than 80 are ignored.
.SH "SEE ALSO"
\fBdpkg\fP(1),
\fBupdate\-dlocatedb\fP(8),
\fBgrep\fP(1)
and
\fBgrep\-dctrl\fP(1).
.SH AUTHOR
dlocate was written by Jim Pick <jim@pick.com> and Craig Sanders
<cas@taz.net.au>. dlocate is Free Software licensed under the GNU
General Public License.
|