dpkg-query

NAME

dpkg-query - a tool to query the dpkg database .

SYNOPSIS

dpkg-query [option...] command .

DESCRIPTION

dpkg-query is a tool to show information about packages listed in the dpkg database. .

COMMANDS

R -l , --list package-name-pattern ...
List packages matching given pattern. If no package-name-pattern is given, list all packages in /var/lib/dpkg/status, excluding the ones marked with state purge. Normal shell wildchars are allowed in package-name-pattern. Please note you will probably have to quote package-name-pattern to prevent the shell from performing filename expansion. For example this will list all package names starting with libc6:
  dpkg-query -l libc6*
The output format of this option is not configurable, but varies automatically to fit the terminal width. It is intended for human readers, and is not easily machine-readable. See -W (--show) and --showformat for a way to configure the output format.
R -W , --show package-name-pattern ...
Just like the --list option this will list all packages matching the given pattern. However the output can be customized using the --showformat option. The default output format gives one line per matching package, each line having the name and installed version of the package, separated by a tab.
R -s , --status package-name ...
Report status of specified package. This just displays the entry in the installed package status database.
R -L , --listfiles package-name ...
List files installed to your system from package-name. However, note that files created by package-specific installation-scripts are not listed.
R -S , --search filename-search-pattern ...
Search for a filename from installed packages. All standard shell wildchars can be used in the pattern. This command will not list extra files created by maintainer scripts, nor will it list alternatives.
R -p , --print-avail package-name
Display details about package-name, as found in /var/lib/dpkg/available.
R -h , --help
Show the usage message and exit.
--version
Show the version and exit.
R --license , --licence
Show the copyright licensing terms and exit. .

OPTIONS

I --admindir= dir
Change the location of the dpkg database. The default location is /var/lib/dpkg.
R -f , --showformat=format
This option is used to specify the format of the output --show will produce. The format is a string that will be output for each package listed. In the format string, \ introduces escapes:
    \n  newline
    \r  carriage return
    \t  tab
\ before any other character suppresses any special meaning of the following character, which is useful for \ and $. Package information can be included by inserting variable references to package fields using the syntax ${field[;width]}. Fields are printed right-aligned unless the width is negative in which case left alignment will be used. The following fields are recognised:
    Architecture
    Bugs
    Conffiles
    Config-Version
    Conflicts
    Breaks
    Depends
    Description
    Enhances
    Essential
    Filename
    Installed-Size
    MD5sum
    MSDOS-Filename
    Maintainer
    Origin
    Package
    Pre-Depends
    Priority
    Provides
    Recommends
    Replaces
    Revision
    Section
    Size
    Source
    Status
    Suggests
    Version
The default format string is ${Package}\t${Version}\n. Actually, all other fields found in the status file (i.e. user defined fields) can be requested, too. They will be printed as-is, though, no conversion nor error checking is done on them. To get the name of the dpkg maintainer and the installed version, you could run:
  dpkg-query -W -f='${Package} ${Version}\t${Maintainer}\n' dpkg
.

ENVIRONMENT

COLUMNS
This setting influences the output of the --list option by changing the width of its output. .

AUTHOR

Copyright 2001 Wichert Akkerman <wakkerma@debian.org> This is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is NO warranty. .

SEE ALSO

dpkg(1).