X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/aec2216091b3d70b3baa5a5b8c87ce208e35c19c..5832913a49d4f7c75527264a935cc0ce00627f1d:/doc/apt-cache.8.xml diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 1429af185..b8e515362 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -1,13 +1,9 @@ - -%aptent; - - -%aptverbatiment; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -18,7 +14,7 @@ &apt-email; &apt-product; - 2012-05-21T00:00:00Z + 2016-09-20T00:00:00Z @@ -36,10 +32,16 @@ &synopsis-command-apt-cache; 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. + + 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. The metadata is acquired + and updated via the 'update' command of e.g. apt-get, + so that it can be outdated if the last update is too long ago, but in + exchange apt-cache works independently of the + availability of the configured sources (e.g. offline). + Unless the , or option is given, one of the commands below must be present. @@ -100,20 +102,20 @@ Reverse Provides: Pure virtual packages is the number of packages that exist only as a virtual package name; that is, packages only "provide" the virtual package name, and no package actually uses the name. For - instance, "mail-transport-agent" in the Debian GNU/Linux system is a + instance, "mail-transport-agent" in the Debian system is a pure virtual package; several packages provide "mail-transport-agent", but there is no package named "mail-transport-agent". 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, "X11-text-viewer" is a virtual package, but + Debian system, "X11-text-viewer" is a virtual package, but only one package, xless, provides "X11-text-viewer". 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, + as the package name. For instance, in the Debian system, "debconf" is both an actual package, and provided by the debconf-tiny package. @@ -126,9 +128,8 @@ Reverse Provides: 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 - "stable" and "unstable", for instance), is being accessed, this value + found in the cache. If more than one distribution is being accessed + (for instance, "stable" and "unstable"), this value can be considerably larger than the number of total package names. @@ -140,9 +141,12 @@ Reverse Provides: - showsrc displays all the source package records that match - the given package names. All versions are shown, as well as all - records that declare the name to be a Binary. + showsrc displays all the + source package records that match the given package names. All + versions are shown, as well as all records that declare the name + to be a binary package. Use to + display only source package names. + @@ -176,7 +180,7 @@ Reverse Provides: If is given then output identical to show is produced for each matched package, and if is given then the long description - is not searched, only the package name is. + is not searched, only the package name and provided packages are. Separate arguments can be used to specify multiple search patterns that are and'ed together. @@ -214,9 +218,9 @@ Reverse Provides: set the APT::Cache::GivenOnly option. The resulting nodes will have several shapes; normal packages are boxes, - pure provides are triangles, mixed provides are diamonds, + pure virtual packages are triangles, mixed virtual packages are diamonds, missing packages are hexagons. Orange boxes mean recursion was stopped - [leaf packages], blue lines are pre-depends, green lines are conflicts. + (leaf packages), blue lines are pre-depends, green lines are conflicts. Caution, dotty cannot graph larger sets of packages. @@ -271,7 +275,8 @@ Reverse Provides: - Print only important dependencies; for use with unmet and depends. Causes only Depends and + Print only important dependencies; for use with unmet + and depends. Causes only Depends and Pre-Depends relations to be printed. Configuration Item: APT::Cache::Important. @@ -284,12 +289,23 @@ Reverse Provides: - Per default the depends and - rdepends print all dependencies. This can be tweaked with + Per default the depends and + rdepends print all dependencies. This can be tweaked with these flags which will omit the specified dependency type. Configuration Item: APT::Cache::ShowDependencyType e.g. APT::Cache::ShowRecommends. + + + Per default depends and rdepends + print only dependencies explicitly expressed in the metadata. With this flag + it will also show dependencies implicitly added based on the encountered data. + A Conflicts: foo e.g. expresses implicitly that this package + also conflicts with the package foo from any other architecture. + Configuration Item: APT::Cache::ShowImplicit. + + + Print full package records when searching. Configuration Item: APT::Cache::ShowFull. @@ -299,7 +315,7 @@ Reverse Provides: Print full records for all available versions. This is the default; to turn it off, use . If is specified, only the candidate version - will displayed (the one which would be selected for installation). + will be displayed (the one which would be selected for installation). This option is only applicable to the show command. Configuration Item: APT::Cache::AllVersions. @@ -311,7 +327,7 @@ Reverse Provides: - Only search on the package names, not the long descriptions. + Only search on the package and provided package names, not the long descriptions. Configuration Item: APT::Cache::NamesOnly. @@ -334,6 +350,21 @@ Reverse Provides: Configuration Item: APT::Cache::Installed. + + + Adds the given file as a source for metadata. Can be repeated to add multiple files. + Supported are currently *.deb, *.dsc, + *.changes, Sources and + Packages files as well as source package directories. + Files are matched based on their name only, not their content! + Sources and Packages can be compressed in any + format apt supports as long as they have the correct extension. If you need to store + multiple of these files in one directory you can prefix a name of your choice with the + last character being an underscore ("_"). Example: my.example_Packages.xz + Note that these sources are treated as trusted (see &apt-secure;). + Configuration Item: APT::Sources::With. + + &apt-commonoptions;