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 incompat-
	      ible 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 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:

	      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 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 constituent character.  Similarly, it must be either at the end of the line or fol-
	      lowed 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 newlines, 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 considered to be highly experimental within GNU grep and may warn of  unim-
	      plemented features.

       -h, -H, --help
	      Produces a short help message and exits.

       -V, --version
	      Display dlocate's version number and exit.

       -v, --verbose, --debug
	      Produce verbose debugging output

FILES

       /etc/default/dlocate
	      Configuration  file  with default options.  Currently the only option is to enable/disable gzip compression of /var/lib/dlocate/dlo-
	      catedb.

       /var/lib/dlocate/dlocatedb
	      plain text listing of all files belonging to all packages (optionally compressed)

       /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

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 packages just before upgrading them:
	    dlocate -l mythtv | grep '^.i' | awk '{print $2}' | xargs dpkg-repack

       # dlocate -l mythtv | grep '^.i' | awk '{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'.

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
	      ignored.

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 General
       Public License.

Debian Project							    2009-06-03								DLOCATE(1)