Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
apt-cache(8)
Edit
PageHistory
Diff
Info
LikePages
APT-CACHE !!!APT-CACHE NAME SYNOPSIS DESCRIPTION OPTIONS FILES SEE ALSO DIAGNOSTICS BUGS AUTHOR ---- !!NAME apt-cache - APT package handling utility -- cache manipulator !!SYNOPSIS __apt-cache__ [[ __-hvs__ ] [[ __-o=__''config string'' ] [[ __-c=__''file'' ] __[[ add__ ''file...'' __] [[ gencaches ] [[ showpkg__ ''pkg...'' __] [[ stats ] [[ dump ] [[ dumpavail ] [[ unmet ] [[ search__ ''regex'' __] [[ show__ ''pkg...'' __] [[ showpkg__ ''pkg...'' __] [[ depends__ ''pkg...'' __] [[ pkgnames__ ''prefix'' __] [[ dotty__ ''pkg...'' __] [[ policy__ ''pkgs...'' __]__ !!DESCRIPTION __apt-cache__ performs a variety of operations on APT's package cache. __apt-cache__ does not manipulate the state of the system but does provide operations to search and generate interesting output from the package metadata. Unless the __-h__, or __--help__ option is given one of the commands below must be present. __add__ add adds the names package index files to the package cache. __gencaches__ gencaches performs the same opration as __apt-get check__. It builds the source and package caches from the sources in ''sources.list''(5) and from ''/var/lib/dpkg/status''. __showpkg__ showpkg displays information about the packages listed on the command line. Remaining arguments are package names. The available versions and reverse dependencies of each package listed are listed, as well as forward dependencies for each version. Forward (normal) dependencies are those packages upon which the package in question depends; reverse dependencies are those packages that depend upon the package in question. Thus, forward dependencies must be satisfied for a package, but reverse dependencies need not be. For instance, __apt-cache showpkg libreadline2__ would produce output similar to the following: Package: libreadline2 Versions: 2.1-12(/var/state/apt/lists/foo_Packages), Reverse Depends: libreadlineg2,libreadline2 libreadline2-altdev,libreadline2 Dependencies: 2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null)) Provides: 2.1-12 - Reverse Provides: Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and ncurses3.0 which must be installed for libreadline2 to work. In turn, libreadlineg2 and libreadline2-altdev depend on libreadline2. If libreadline2 is installed, libc5, ncurses3.0, and ldso must also be installed; libreadlineg2 and libreadline2-altdev do not have to be installed. For the specific meaning of the remainder of the output it is best to consult the apt source code. __stats__ stats displays some statistics about the cache. No further arguments are expected. Statistics reported are: Total package names is the number of package names found in the cache. Normal packages is the number of regular, ordinary package names; these are packages that bear a one-to-one correspondence between their names and the names used by other packages for them in dependencies. The majority of packages fall into this category. Pure virtual packages is the number of packages that exist only as a virtual package name; that is, packages only Single virtual packages is the number of packages with only one package providing a particular virtual package. For example, in the Debian GNU/Linux system, Mixed virtual packages is the number of packages that either provide a particular virtual package or have the virtual package name as the package name. For instance, in the Debian GNU/Linux system, debconf is both an actual package, and provided by the debconf-tiny package. Missing is the number of package names that were referenced in a dependency but were not provided by any package. Missing packages may be in evidence if a full distribution is not accesssed, or if a package (real or virtual) has been dropped from the distribution. Usually they are referenced from Conflicts statements. Total distinct versions is the number of package versions found in the cache; this value is therefore at least equal to the number of total package names. If more than one distribution (both Total dependencies is the number of dependency relationships claimed by all of the packages in the cache. __dump__ dump shows a short listing of every package in the cache. It is primarily for debugging. __dumpavail__ dumpavail prints out an available list to stdout. This is suitable for use with dpkg(8) and is used by the dselect(8) method. __unmet__ unmet displays a summary of all unmet dependencies in the package cache. __show__ show performs a function similar to __dpkg --print-avail__, it displays the package records for the named packages. __search__ search performs a full text search on all available package files for the regex pattern given. It searchs the package names and the descriptions for an occurance of the string and prints out the package name and the short description. If __--full__ is given then output identical to show is produced for each matched package and if __--names-only__ is given then the long description is not searched, only the package name is. Seperate arguments can be used to specified multiple search patterns that are and'd together. __depends__ depends shows a listing of each dependency a package has and all the possible other packages that can fullfill that dependency. __pkgnames__ This command prints the name of each package in the system. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated extremly quickly. This command is best used with the __--generate__ option. __dotty__ dotty takes a list of packages on the command line and gernerates output suitable for use by dotty from the !GraphVis The resulting nodes will have several shapse, normal packages are boxes, pure provides are triangles, mixed provides are diamonds, hexagons are missing packages. Orange boxes mean recursion was stopped [[leaf packages], blue lines are prre-depends, green lines are conflicts. Caution, dotty cannot graph larger sets of packages. __policy__ policy is ment to help debug issues relating to the preferences file. With no arguments it will print out the priorities of each source. Otherwise it prints out detailed information about the priority selection of the named package. !!OPTIONS All command line options may be set using the configuration file, the descriptions indicate the configuration option to set. For boolean options you can override the config file by using something like __-f-__,__--no-f__, __-f=no__ or several other variations. __-p__ __--pkg-cache__ Select the file to store the package cache. The package cache is the primary cache used by all operations. Configuration Item: Dir::Cache::pkgcache. __-s__ __--src-cache__ Select the file to store the source cache. The source is used only by gencaches and it stores a parsed version of the package information from remote sources. When building the package cache the source cache is used to advoid reparsing all of the package files. Configuration Item: Dir::Cache::srcpkgcache. __-q__ __--quiet__ Quiet; produces output suitable for logging, omitting progress indicators. More qs will produce more quite up to a maximum of 2. You can also use __-q=#__ to set the quiet level, overriding the configuration file. Configuration Item: quiet. __-i__ __--important__ Print only important deps; for use with unmet causes only Depends and Pre-Depends relations to be printed. Configuration Item: APT::Cache::Important. __-f__ __--full__ Print full package records when searching. Configuration Item: APT::Cache::!ShowFull. __-a__ __--all-versions__ Print full records for all available versions, this is only applicable to the show command. Configuration Item: APT::Cache::!AllVersions. __-g__ __--generate__ Perform automatic package cache regeneration, rather than use the cache as it is. This is the default, to turn it off use __--no-generate__. Configuration Item: APT::Cache::Generate. __--names-only__ Only search on the package names, not the long description. Configuration Item: APT::Cache::!NamesOnly. __--all-names__ Make pkgnames print all names, including virtual packages and missing dependencies. Configuration Item: APT::Cache::!AllNames. __--recurse__ Make depends recursive so that all packages mentioned are printed once. Configuration Item: APT::Cache::!RecurseDepends. __-h__ __--help__ Show a short usage summary. __-v__ __--version__ Show the program verison. __-c__ __--config-file__ Configuration File; Specify a configuration file to use. The program will read the default configuration file and then this configuration file. See ''apt.conf''(5) for syntax information. __-o__ __--option__ Set a Configuration Option; This will set an arbitary configuration option. The syntax is __-o Foo::Bar=bar__. !!FILES ''/etc/apt/sources.list'' locations to fetch packages from. Configuration Item: Dir::Etc::!SourceList. ''/var/lib/apt/lists/'' storage area for state information for each package resource specified in ''sources.list''(5) Configuration Item: Dir::State::Lists. ''/var/lib/apt/lists/partial/'' storage area for state information in transit. Configuration Item: Dir::State::Lists (implicit partial). !!SEE ALSO ''apt.conf''(5), ''sources.list''(5), apt-get(8) !!DIAGNOSTICS __apt-cache__ returns zero on normal operation, decimal 100 on error. !!BUGS See the APT bug page /usr/share/doc/debian/bug-reporting.txt'' or the bug(1) command. !!AUTHOR APT was written by the APT team ----
6 pages link to
apt-cache(8)
:
sources.list(5)
apt_preferences(5)
Man8a
apt-get(8)
apt(8)
apt.conf(5)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
