DLOCATE(1) dlocate DLOCATE(1)
NAME
dlocate - program to view debian package information
SYNOPSIS
dlocate [OPTIONS] [command] [ package... | PATTERN...]
DESCRIPTION
dlocate is a fast alternative to dpkg for queries like `dpkg -L' and
`dpkg -S'
COMMANDS
(none) List all records where either the package name or the filename
matches 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: dlocate
'/usr/bin/\[' or dlocate -F '/usr/bin/['
-S List all records where only the filename matches PATTERN.
Note that dlocate uses GNU grep, so normal regexp metacharacters
need to be taken into account. Fixed String searches are incom-
patible with -S.
For example, to search for `/usr/bin/[', you need to type:
dlocate '/usr/bin/\['
-l Regexp-enhanced emulation of `dpkg -l'. Shows all packages
which match 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 exam-
ple, Extended Regexp:
dlocate -l '^..[[:space:]]libc6'
or Perl Regexp:
dlocate -P -l '^..\slibc6'
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 dlocate
-l is occasionally different to the output from dpkg -l.
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.
-k List package names of installed kernels and all related packages
-K Detailed list of installed kernels and all related packages
-L List all files in package.
-s Print status of package.
--ls `ls -ldF' of all files in package.
--lsconf
`ls -ldF' of conffiles in package.
--conf List conffiles in package.
--du `du -sck' of all files in package.
--md5sum
List md5sums (if any) of package.
--md5check
Check md5sums (if any) of package.
--man List man pages (if any) in package.
--lsman
List full path/filenames of man pages (if any) in package.
--lsbin
List full path/filenames of executable files (if any) in pack-
age.
--lsdir
List only the directories in package.
OPTIONS
--filename-only
Only output file names when searching for files
--package-only
Only output package names when searching for files
-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 con-
stituent 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.
-i, --ignore-case
Ignore case distinctions in the PATTERN
-E, --extended-regexp
Interpret PATTERN as an extended regular expression. This is
the default.
-F, --fixed-strings
Interpret PATTERN as a list of fixed strings, separated by new-
lines, any of which is to be matched.
-G, --basic-regexp
Interpret PATTERN as a basic regular expression.
-P, --perl-regexp
Interpret PATTERN as a Perl regular expression. This is consid-
ered to be highly experimental within GNU grep and may warn of
unimplemented features.
-h, --help
Display help message and exit.
-V, --version
Display dlocate's version number and exit.
-v, --verbose, --debug
Produce verbose debugging output
-c, --columns[=columns]
Set COLUMN width to override the dlocate default of using the
entire terminal line width. Any value for columns less than 80
will be increaed to 80.
-C, --colour, --color
Colourise -l or -s output (requires supercat to be installed)
FILES
/etc/default/dlocate
Configuration file with default options. Currently the only op-
tion is to enable/disable gzip compression of /var/lib/dlo-
cate/dlocatedb.
/var/lib/dlocate/dlocatedb
Plain text listing of all files belonging to all packages (op-
tionally compressed)
/var/lib/dlocate/dpkg-list
Listing of all packages known to dpkg.
See update-dlocatedb(8) for details.
EXAMPLES
To find which package `/usr/bin/[' belongs to:
dlocate '/usr/bin/\['
To view all man pages contained within the dpkg package:
man $(dlocate -man dpkg)
To purge kernel version 2.6.28.7 and all related module packages:
dlocate -k | grep -- -2.6.28.7 | xargs apt-get purge
To check the md5sums of the dlocate package:
dlocate --md5check dlocate
To use dpkg-repack to make a backup copy of all installed mythtv pack-
ages just before upgrading them:
dlocate -l mythtv | awk '/^.i/ {print $2}' | xargs dpkg-repack
# dlocate -l mythtv | awk '/^.i/ {print $2}' | xargs dpkg-repack
dpkg-deb: building package `libmythtv-perl' in `./libmythtv-perl_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv' in `./mythtv_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-backend' in `./mythtv-backend_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-common' in `./mythtv-common_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-database' in `./mythtv-database_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-doc' in `./mythtv-doc_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-frontend' in `./mythtv-frontend_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-perl' in `./mythtv-perl_0.21.svn20090414-0.0_amd64.deb'.
dpkg-deb: building package `mythtv-status' in `./mythtv-status_0.9.0-5_amd64.deb'.
dpkg-deb: building package `mythtv-themes' in `./mythtv-themes_0.21-0.0_amd64.deb'.
dpkg-deb: building package `mythtvfs' in `./mythtvfs_0.5.2-2_amd64.deb'.
dpkg-deb: building package `python-mythtv' in `./python-mythtv_0.21.svn20090414-0.0_amd64.deb'.
NOTES
dlocate does not update its databases (see FILES section) automatically
after new or upgraded packages have been installed with dpkg or apt-get
etc.
A daily cron job is run to perform the update. Or the root user can
run update-dlocatedb at any time to force an update.
ENVIRONMENT VARIABLES
COLUMNS
Sets the number of columns dlocate should use when displaying
formatted text. Currently only used by -l. Values lower than 80
are increased to 80.
SEE ALSO
dpkg(1), update-dlocatedb(8), grep(1) and grep-dctrl(1).
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 Gen-
eral Public License.
Debian Project 2016-06-20 DLOCATE(1)
Generated by dwww version 1.15 on Fri Jun 28 21:23:38 CEST 2024.