File Manager

Editing File: /usr/share/doc/aptitude/html/en/ch02s04s05.html

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Search term reference</title><link rel="stylesheet" type="text/css" href="aptitude.css" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="home" href="index.html" title="aptitude user's manual" /><link rel="up" href="ch02s04.html" title="Search patterns" /><link rel="prev" href="ch02s04s04.html" title="Explicit search targets" /><link rel="next" href="ch02s05.html" title="Customizing aptitude" /><link rel="preface" href="pr01.html" title="Introduction" /><link rel="chapter" href="ch01.html" title="Chapter 1. Getting started" /><link rel="chapter" href="ch02.html" title="Chapter 2. aptitude reference guide" /><link rel="chapter" href="ch03.html" title="Chapter 3. aptitude frequently asked questions" /><link rel="chapter" href="ch04.html" title="Chapter 4. Credits" /><link rel="reference" href="rn01.html" title="Command-line reference" /><link rel="refentry" href="rn01re01.html" title="aptitude" /><link rel="refentry" href="rn01re02.html" title="aptitude-create-state-bundle" /><link rel="refentry" href="rn01re03.html" title="aptitude-run-state-bundle" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Search term reference</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s04s04.html"><img src="images/prev.gif" alt="Prev" /></a> </td><th width="60%" align="center">Search patterns</th><td width="20%" align="right"> <a accesskey="n" href="ch02s05.html"><img src="images/next.gif" alt="Next" /></a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="secSearchTermReference"></a>Search term reference</h3></div></div></div>
	 <a class="xref" href="ch02s04s05.html#tableSearchTermQuickGuide" title="Table 2.3. Quick guide to search terms">Table 2.3, “Quick guide to search terms”</a> provides a brief
	 summary of all the search terms provided by aptitude. A
	 full description of each term can be found <a class="link" href="ch02s04s05.html#searchTermReferenceList">below</a>.
	<div class="table"><a id="tableSearchTermQuickGuide"></a>Table 2.3. Quick guide to search terms<div class="table-contents"><table class="table" summary="Quick guide to search terms" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Long form</th><th>Short form</th><th>Description</th></tr></thead><tbody><tr><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchEqual">?=</a></code><code>variable</code></code>
		</td><td> </td><td>
		 Select the package bound to
		 <code>variable</code>; see <a class="xref" href="ch02s04s04.html" title="Explicit search targets">the section called “Explicit search targets”</a>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchNot">?not</a></code>(<code>pattern</code>)</code></td><td><code class="literal">!<code>pattern</code></code></td><td>
		 Select any package that does not match
		 <code>pattern</code>.
		</td></tr><tr><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchAction">?action</a></code>(<code>action</code>)</code>
		</td><td>~a<code>action</code></td><td>
		 Select packages that have been marked for the given
		 <code>action</code> (e.g.,
		 “<code class="literal">install</code>” or
		 “<code class="literal">upgrade</code>”).
		</td></tr><tr class="oddrow"><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchAllVersions">?all-versions</a></code>(<code>pattern</code>)</code>
		</td><td> </td><td>
		 Select packages whose versions all match
		 <code>pattern</code>.
		</td></tr><tr><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchAnd">?and</a></code>(<code>pattern1</code>, <code>pattern2</code>)</code>
		</td><td><code>pattern1</code> <code>pattern2</code></td><td>
		 Select any package that matches both
		 <code>pattern1</code> and
		 <code>pattern2</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchAnyVersion">?any-version</a></code>(<code>pattern</code>)</code></td><td> </td><td>
		 Select packages for which at least one version
		 matches <code>pattern</code>.
		</td></tr><tr><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchArchitecture">?architecture</a></code>(<code>architecture</code>)</code>
		</td><td>~r<code>architecture</code></td><td>
		 Select packages for the given architecture (such as
		 “<code class="literal">amd64</code>”, or
		 “<code class="literal">all</code>”). Special values:
		 <code class="literal">native</code> and <code class="literal">foreign</code>.
		</td></tr><tr class="oddrow"><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchArchive">?archive</a></code>(<code>archive</code>)</code>
		</td><td>
		 <code class="literal">~A<code>archive</code></code>
		</td><td>
		 Select packages from the given archive (such as
		 “<code class="literal">unstable</code>”).
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchAutomatic">?automatic</a></code></code></td><td><code class="literal">~M</code></td><td>
		 Select packages that were automatically installed.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchBind">?bind</a></code>(<code>variable</code>, <code>pattern</code>)</code></td><td>
		 <code class="literal">?<code>variable</code>:<code>term-name</code>[(<code>args</code>)]</code>
		</td><td>
		 Selects anything if
		 <code>variable</code> matches
		 <code>pattern</code>; see <a class="xref" href="ch02s04s04.html" title="Explicit search targets">the section called “Explicit search targets”</a>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchBroken">?broken</a></code></code></td><td><code class="literal">~b</code></td><td>
		 Select packages that have a broken dependency.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchBrokenType">?broken-<code>depType</code></a></code></code></td><td><code class="literal">~B<code>depType</code></code></td><td>
		 Select package that have a broken dependency of the
		 given <code>depType</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchBrokenTypeTerm">?broken-<code>depType</code></a></code>(<code>pattern</code>)</code></td><td><code class="literal">~DB[<code>depType</code>:]<code>pattern</code></code></td><td>
		 Select packages that have a broken dependency of the
		 given <code>depType</code> matching
		 <code>pattern</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchReverseBrokenDep">?broken-reverse-<code>depType</code></a></code>(<code>pattern</code>)</code></td><td><code class="literal">~RB<code class="option"><code>depType</code>:</code><code>pattern</code></code></td><td>
		 Select packages that a package matching
		 <code>pattern</code> declares a broken
		 dependency of type <code>depType</code>.
		</td></tr><tr><td>
		 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchConflicts">?conflicts</a></code>(<code>pattern</code>)</code>
		</td><td><code class="literal">~C<code>pattern</code></code></td><td>
		 Select packages that conflict with a package
		 matching <code>pattern</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchConfigFiles">?config-files</a></code></code></td><td><code class="literal">~c</code></td><td>
		 Select packages that were removed but not purged.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?<code>depType</code></a></code>(<code>pattern</code>)</code></td><td><code class="literal">~D[<code>depType</code>:]<code>pattern</code></code></td><td>
		 Match packages that declare a dependency of type
		 <code>depType</code> on a package
		 matching <code>pattern</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchDescription">?description</a></code>(<code>description</code>)</code></td><td><code class="literal">~d<code>description</code></code></td><td>
		 Select packages whose description matches
		 <code>description</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchEssential">?essential</a></code></code></td><td><code class="literal">~E</code></td><td>
		 Select essential packages, those with
		 <code class="literal">Essential: yes</code> in their control
		 files.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchExactName">?exact-name</a></code>(<code>name</code>)</code></td><td> </td><td>
		 Select packages named
		 <code>name</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchFalse">?false</a></code></code></td><td><code class="literal">~F</code></td><td>
		 Select no packages.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> <code>variable</code>: <code>pattern</code></code></td><td> </td><td>
		 Select packages that match
		 <code>pattern</code> with
		 <code>variable</code> bound to the
		 package being matched; see <a class="xref" href="ch02s04s04.html" title="Explicit search targets">the section called “Explicit search targets”</a>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchGarbage">?garbage</a></code></code></td><td><code class="literal">~g</code></td><td>
		 Select packages that are not required by any manually
		 installed package.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchInstalled">?installed</a></code></code></td><td><code class="literal">~i</code></td><td>Select installed packages.</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchMaintainer">?maintainer</a></code>(<code>maintainer</code>)</code></td><td><code class="literal">~m<code>maintainer</code></code></td><td>
		 Select packages maintained by
		 <code>maintainer</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchMultiArch">?multiarch</a></code>(<code>multiarch</code>)</code></td><td> </td><td>
		 Select packages with a multi-arch capability of
		 <code>multiarch</code> (that is, either
		 “<code class="literal">foreign</code>”,
		 “<code class="literal">same</code>”,
		 “<code class="literal">allowed</code>”, or
		 “<code class="literal">none</code>”).
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchNarrow">?narrow</a></code>(<code>filter</code>, <code>pattern</code>)</code></td><td><code class="literal">~S <code>filter</code> <code>pattern</code></code></td><td>
		 Select packages for which a single version matches
		 both <code>filter</code> and
		 <code>pattern</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code>(<code>name</code>)</code></td><td><code class="literal">~n<code>name</code></code>, <code class="literal"><code>name</code></code></td><td>
		 Select packages with the given <code>name</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchNew">?new</a></code></code></td><td><code class="literal">~N</code></td><td>
		 Select new packages.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchObsolete">?obsolete</a></code></code></td><td><code class="literal">~o</code></td><td>
		 Match installed packages that cannot be downloaded.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchOr">?or</a></code>(<code>pattern1</code>, <code>pattern2</code>)</code></td><td><code class="literal"><code>pattern1</code> | <code>pattern2</code></code></td><td>
		 Select packages that match
		 <code>pattern1</code>,
		 <code>pattern2</code>, or both.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchOrigin">?origin</a></code>(<code>origin</code>)</code></td><td><code class="literal">~O<code>origin</code></code></td><td>
		 Select packages with the given
		 <code>origin</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchProvides">?provides</a></code>(<code>pattern</code>)</code></td><td><code class="literal">~P<code>pattern</code></code></td><td>
		 Select packages that provide a package matching
		 <code>pattern</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchPriority">?priority</a></code>(<code>priority</code>)</code></td><td><code class="literal">~p<code>priority</code></code></td><td>
		 Select packages with the given <code>priority</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchReverseDep">?reverse-<code>depType</code></a></code>(<code>pattern</code>)</code></td><td><code class="literal">~R[<code>depType</code>:]<code>pattern</code></code></td><td>
		 Select packages that are the targets of a dependency
		 of type <code>depType</code> declared
		 by a package matching
		 <code>pattern</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchReverseBrokenDep">?reverse-broken-<code>depType</code></a></code>(<code>pattern</code>)</code></td><td><code class="literal">~RB<code class="option"><code>depType</code>:</code><code>pattern</code></code></td><td>
		 Select packages that are the targets of a broken
		 dependency of type
		 <code>depType</code> declared by a
		 package matching <code>pattern</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchSection">?section</a></code>(<code>section</code>)</code></td><td><code class="literal">~s<code>section</code></code></td><td>
		 Select packages in the given <code>section</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchSourcePackage">?source-package</a></code>(<code>name</code>)</code></td><td><code class="literal">~e<code>name</code></code></td><td>
		 Select packages whose source package name matches
		 the regular expression
		 <code>name</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchSourceVersion">?source-version</a></code>(<code>version</code>)</code></td><td> </td><td>
		 Select packages whose source version matches the
		 regular expression <code>version</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTag">?tag</a></code>(<code>tag</code>)</code></td><td><code class="literal">~G<code>tag</code></code></td><td>
		 Select packages that have the given debtags
		 <code>tag</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTerm">?term</a></code>(<code>keyword</code>)</code></td><td> </td><td>
		 Full-text search for packages that contain the given
		 <code>keyword</code>.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTermPrefix">?term-prefix</a></code>(<code>keyword</code>)</code></td><td> </td><td>
		 Full-text search for packages that contain a keyword
		 that begins with the given
		 <code>keyword</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTrue">?true</a></code></code></td><td><code class="literal">~T</code></td><td>
		 Select all packages.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTask">?task</a></code>(<code>task</code>)</code></td><td><code class="literal">~t<code>task</code></code></td><td>
		 Select packages that are in the given
		 <code>task</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchUpgradable">?upgradable</a></code></code></td><td><code class="literal">~U</code></td><td>
		 Select packages that are installed and can be
		 upgraded.
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchUserTag">?user-tag</a></code></code></td><td> </td><td>
		 Select packages that are marked with a user-tag
		 matching the regular expression
		 <code>user-tag</code>.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTermVersion">?version</a></code>(<code>version</code>)</code></td><td><code class="literal">~V<code>version</code></code></td><td>
		 Select packages whose version matches
		 <code>version</code> (special values:
		 <code class="literal">CURRENT</code>,
		 <code class="literal">CANDIDATE</code>, and
		 <code class="literal">TARGET</code>).
		</td></tr><tr class="oddrow"><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchVirtual">?virtual</a></code></code></td><td><code class="literal">~v</code></td><td>
		 Select virtual packages.
		</td></tr><tr><td><code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchWiden">?widen</a></code>(<code>pattern</code>)</code></td><td><code class="literal">~W<code>pattern</code></code></td><td>
		 Select versions for which
		 <code>pattern</code> matches any version
		 of the corresponding package, discarding local
		 version restrictions.
		</td></tr></tbody></table></div></div> <div class="variablelist"><a id="searchTermReferenceList"></a><dl class="variablelist"><dt><code>name</code></dt><dd>
	 Matches packages whose names match the regular
	 expression <code>name</code>. This is the
	 “default” search mode and is used for patterns that
	 don't start with <code class="literal">~</code>.
	 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		To match packages whose names contain several
		different substrings, use the <code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code> term (described
		below); for instance,
		“<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code>(apti)<code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code>(tude)</code>”
		will match any package whose name contains
		both
		“<code class="literal">apti</code>” and
		“<code class="literal">tude</code>”.
	 </td></tr></table></div></dd><dt><a id="searchEqual"></a><code class="literal">?=<code>variable</code></code></dt><dd>
	 Matches packages that correspond to the value of
	 <code>variable</code>, which must be bound
	 by an enclosing <code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code>. For instance, <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> x:
	 <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>( <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?recommends</a></code>( ?=x ) )</code> will match any
	 package <code>x</code> that depends on a
	 package which recommends <code>x</code>.
	 
	 For instance, the following search expression matches
	 packages that conflict with themselves:
	 <div class="example"><a id="exampleSearchEqual"></a>Example 2.2. 
		Use of the <code class="literal">?=</code> term.
	 <div class="example-contents">
		<code class="literal">
		 <code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> x: <code class="literal"><a class="link" href="ch02s04s05.html#searchConflicts">?conflicts</a></code>(?=x)
		</code>
	 </div></div> 
	 See <a class="xref" href="ch02s04s04.html" title="Explicit search targets">the section called “Explicit search targets”</a> for more
	 information.
	 </dd><dt><a id="searchNot"></a><code class="literal">?not(<code>pattern</code>)</code>, <code class="literal">!<code>pattern</code></code></dt><dd>
	 Matches packages which do not match
	 the pattern <code>pattern</code>. For
	 instance,
	 “<code class="literal">?not(<code class="literal"><a class="link" href="ch02s04s05.html#searchBroken">?broken</a></code>)</code>”
	 selects packages that are not “broken”.
	 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		To include a “!” in a search string, it
		must be “escaped” by placing a tilde
		(“<code class="literal">~</code>”) in front of it;
		otherwise, aptitude will consider it to be part of a
		<code class="literal">?not</code> term. For instance, to select
		packages whose description contains
		“<code class="literal">extra!</code>”, use
		“<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchDescription">?description</a></code>(extra~!)</code>”.
	 </td></tr></table></div></dd><dt><a id="searchAnd"></a><code class="literal">?and(<code>pattern1</code>, <code>pattern2</code>)</code>, <code>pattern1</code> <code>pattern2</code></dt><dd>
	 Matches packages that match both
	 <code>pattern1</code> and
	 <code>pattern2</code>.
	 </dd><dt><a id="searchOr"></a><code class="literal">?or(<code>pattern1</code>, <code>pattern2</code>)</code>, <code class="literal"><code>pattern1</code> | <code>pattern2</code></code></dt><dd>
	 Matches packages that match either
	 <code>pattern1</code> or
	 <code>pattern2</code>.
	 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		To use the character “|” in a regular expression, it
		must be “escaped” to prevent aptitude from creating
		an OR term from it: “<code class="literal">~|</code>”.
	 </td></tr></table></div></dd><dt><code class="literal">(<code>pattern</code>)</code></dt><dd>
	 Matches <code>pattern</code>. For instance,
	 “<code class="literal">opengl (perl|python)</code>”
	 matches any package whose name contains
	 <code class="literal">opengl</code>, and also contains either
	 <code class="literal">perl</code> or <code class="literal">python</code>.
	 </dd><dt><a id="searchAction"></a><code class="literal">?action(<code>action</code>)</code>, <code class="literal">~a<code>action</code></code></dt><dd>
	 Matches packages upon which the given
	 <code>action</code> is going to be
	 performed. <code>action</code> can be
	 “<code class="literal">install</code>”,
	 “<code class="literal">upgrade</code>”,
	 “<code class="literal">downgrade</code>”,
	 “<code class="literal">remove</code>”,
	 “<code class="literal">purge</code>”,
	 “<code class="literal">hold</code>” (tests whether a
	 package has been placed on hold), or
	 “<code class="literal">keep</code>” (tests whether a
	 package will be unchanged).
	 
	 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		Note that this only tests whether an action is actually
		queued up to be performed on a package, not whether it
		could be performed. Thus, for
		instance, <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchAction">?action</a></code>(upgrade)</code> matches
		exactly those packages that you have already decided to
		upgrade, not packages which could
		be upgraded in the future (for that, use
		<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchUpgradable">?upgradable</a></code></code>).
	 </td></tr></table></div></dd><dt><a id="searchAllVersions"></a><code class="literal">?all-versions(<code>pattern</code>)</code></dt><dd>
	 Matches any package whose versions all match the given
	 expression. Each version of a package will be
	 separately tested against
	 <code>pattern</code>, and the package will
	 match if all of its versions match. Packages without
	 versions, such as virtual packages, will always be
	 matched by this search term.
	 
	 This term may not be used in a context in which the
	 versions to match against have already been narrowed,
	 such as within <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code> or <code class="literal"><a class="link" href="ch02s04s05.html#searchNarrow">?narrow</a></code>. However, it may
	 always be used within <code class="literal"><a class="link" href="ch02s04s05.html#searchWiden">?widen</a></code>.
	 </dd><dt><a id="searchAnyVersion"></a><code class="literal">?any-version(<code>pattern</code>)</code></dt><dd>
	 Matches a package if any one of its versions matches the
	 enclosed pattern. This is the dual to <code class="literal"><a class="link" href="ch02s04s05.html#searchAllVersions">?all-versions</a></code>.
	 
	 This term may not be used in a context in which the
	 versions to match against have already been narrowed,
	 such as within <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code> or <code class="literal"><a class="link" href="ch02s04s05.html#searchNarrow">?narrow</a></code>. However, it may
	 always be used within <code class="literal"><a class="link" href="ch02s04s05.html#searchWiden">?widen</a></code>.
	 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		This term is closely related to <code class="literal"><a class="link" href="ch02s04s05.html#searchNarrow">?narrow</a></code>.
		In fact,
		<code class="literal">?any-version(<code>pattern1</code>
		<code>pattern2</code>)</code> is exactly
		the same as
		<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchNarrow">?narrow</a></code>(<code>pattern1</code>,
		<code>pattern2</code>)</code>.
	 </td></tr></table></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		To be precise, as with any other pattern, it is not packages but
		versions of the packages which are matched. For
		“<code class="literal">aptitude search</code>” and other uses
		it does not make much difference, but “<code class="literal">aptitude
		versions</code>” will only show the versions that
		match, not all versions of the package for which any version
		matches. For that, use an enclosing <code class="literal"><a class="link" href="ch02s04s05.html#searchWiden">?widen</a></code>.
	 </td></tr></table></div></dd><dt><a id="searchArchitecture"></a><code class="literal">?architecture(<code>architecture-spec</code>)</code>, <code class="literal">~r<code>architecture-spec</code></code></dt><dd>
	 Matches package versions for the given
	 <code>architecture-spec</code>. For instance,
	 “<code class="literal">?architecture(amd64)</code>” matches
	 <code class="literal">amd64</code> packages, while
	 “<code class="literal">?architecture(all)</code>” matches
	 arch-independent packages.
	 
	 It also accepts the special values <code class="literal">native</code> and
	 <code class="literal">foreign</code>, and architecture wildcards
	 (e.g. <code class="literal">linux-any</code> or
	 <code class="literal">any-amd64</code>), as specified in Policy (“11.1
	 Architecture specification strings”).
	 </dd><dt><a id="searchArchive"></a><code class="literal">?archive(<code>archive</code>)</code>, <code class="literal">~A<code>archive</code></code></dt><dd>
	 Matches package versions which are available from an
	 archive that matches the regular expression
	 <code>archive</code>. For instance,
	 “<code class="literal">?archive(testing)</code>”
	 matches any package available from the
	 <code class="literal">testing</code> archive.
	 </dd><dt><a id="searchAutomatic"></a><code class="literal">?automatic</code>, <code class="literal">~M</code></dt><dd>
	 Matches packages which were automatically installed.
	 </dd><dt><a id="searchBind"></a>
	 <code class="literal">?bind(<code>variable</code>,
	 <code>pattern</code>)</code>,
	 <code class="literal">?<code>variable</code>:<code>term-name</code>[(<code>args</code>)]</code>
	 </dt><dd>
	 Matches any package or version if the given
	 <code>pattern</code> matches the package or
	 version bound to <code>variable</code>,
	 which must be defined in an enclosing <code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code>.
	 <div class="example"><a id="exampleSearchBind"></a>Example 2.3. Use of the <code class="literal">?bind</code> term<div class="example-contents">
		<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> x: <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> z: ?bind(x, <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchEqual">?=</a></code>z))))</code>
	 
		<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> x: <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchFor">?for</a></code> z: ?x:<a class="link" href="ch02s04s05.html#searchDep">depends</a>(<code class="literal"><a class="link" href="ch02s04s05.html#searchEqual">?=</a></code>z)))</code>
	 </div></div> 
	 The two search patterns in the above example both match
	 any package <code class="literal">x</code> such that
	 <code class="literal">x</code> depends on a package
	 <code class="literal">y</code> which in turn depends on a package
	 <code class="literal">z</code> such that <code class="literal">x</code> also
	 depends directly on <code class="literal">z</code>. The first
	 pattern uses <code class="literal">?bind</code> directly, while
	 the second one uses an equivalent shorthand syntax.
	 
	 See <a class="xref" href="ch02s04s04.html" title="Explicit search targets">the section called “Explicit search targets”</a> for more
	 information.
	 </dd><dt><a id="searchBroken"></a><code class="literal">?broken</code>, <code class="literal">~b</code></dt><dd>
	 Matches packages that are “broken”: they have an
	 unfulfilled dependency, predependency, breaks, or conflict.
	 </dd><dt><a id="searchBrokenType"></a><code class="literal">?broken-<code>depType</code></code>, <code class="literal">~B<code>depType</code></code></dt><dd>
	 Matches packages which have an unfulfilled (“broken”)
	 dependency of the given <code>depType</code>.
	 <code>depType</code> can be
	 “<code class="literal">depends</code>”,
	 “<code class="literal">predepends</code>”,
	 “<code class="literal">recommends</code>”,
	 “<code class="literal">suggests</code>”,
	 “<code class="literal">breaks</code>”,
	 “<code class="literal">conflicts</code>”, or
	 “<code class="literal">replaces</code>”.
	 </dd><dt><a id="searchBrokenTypeTerm"></a><code class="literal">?broken-<code>depType</code>(<code>pattern</code>)</code>, <code class="literal">~DB[<code>depType</code>:]<code>pattern</code></code></dt><dd>
	 Matches packages with an unsatisfied dependency of type
	 <code>depType</code> on a package matching
	 <code>pattern</code>.
	 <code>depType</code> may be any one of the
	 dependency types listed in <a class="link" href="ch02s04s05.html#searchBrokenType">the documentation of
	 <code class="literal">?broken-<code>depType</code></code></a>.
	 </dd><dt><a id="searchConflicts"></a><code class="literal">?conflicts(<code>pattern</code>)</code>, <code class="literal">~C<code>pattern</code></code></dt><dd>
	 Matches packages which conflict with a package matching
	 the given <code>pattern</code>. For
	 instance,
	 “<code class="literal">?conflicts(<code class="literal"><a class="link" href="ch02s04s05.html#searchMaintainer">?maintainer</a></code>(dburrows@debian.org))</code>”
	 matches any package which conflicts with a package I
	 maintain.
	 </dd><dt><a id="searchConfigFiles"></a><code class="literal">?config-files</code>, <code class="literal">~c</code></dt><dd>
	 Matches packages which have been removed, but whose
	 configuration files remain on the system (ie, they were
	 removed but not purged).
	 </dd><dt><a id="searchDep"></a><code class="literal">?<code>depType</code>(<code>pattern</code>)</code>, <code class="literal">~D[<code>depType</code>:]<code>pattern</code></code></dt><dd>
	 <code>depType</code> may be any one of the
	 dependency types given in <a class="link" href="ch02s04s05.html#searchBrokenType">the documentation of
	 <code class="literal">?broken-<code>depType</code></code></a>,
	 as well as <code class="literal">provides</code>: for instance,
	 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>(libpng3)</code> will match any
	 package that depends on <code class="literal">libpng3</code>. If
	 the short form (<code class="literal">~D</code>) is used and
	 <code>depType</code> is not present, it
	 defaults to <code class="literal">depends</code>.
	 
	 If <code>depType</code> is
	 “<code class="literal">provides</code>”, matches
	 packages that provide a package matching
	 <code>pattern</code> (the equivalent of
	 <code class="literal"><a class="link" href="ch02s04s05.html#searchProvides">?provides</a></code>). Otherwise, matches packages which declare
	 a dependency of type <code>depType</code>
	 upon a package version which matches
	 <code>pattern</code>.
	 </dd><dt><a id="searchDescription"></a><code class="literal">?description(<code>description</code>)</code>, <code class="literal">~d<code>description</code></code></dt><dd>
	 Matches packages whose description matches the regular
	 expression <code>description</code>.
	 </dd><dt><a id="searchEssential"></a><code class="literal">?essential</code>, <code class="literal">~E</code></dt><dd>
	 Matches Essential packages.
	 </dd><dt><a id="searchExactName"></a><code class="literal">?exact-name(<code>name</code>)</code></dt><dd>
	 Matches packages named <code>name</code>.
	 This is similar to <code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code>, but the name must match
	 exactly. For instance, the following pattern will match
	 only the package <code class="systemitem">apt</code>; with
	 <code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code>, it would also match
	 <code class="systemitem">aptitude</code>,
	 <code class="systemitem">uvccapture</code>, etc.
	 <div class="example"><a id="idSearchExactName"></a>Example 2.4. Use of the <code class="literal">?exact-name</code> term<div class="example-contents">
		<code class="literal">?exact-name(apt)</code>
	 </div></div> </dd><dt><a id="searchFalse"></a><code class="literal">?false</code>, <code class="literal">~F</code></dt><dd>
	 This term does not match any package.
	 <a href="#ftn.idm3897" class="footnote" id="idm3897">[18]</a>
	 </dd><dt><a id="searchFor"></a><code class="literal">?for <code>variable</code>: <code>pattern</code></code></dt><dd>
	 Matches <code>pattern</code>, but the given
	 <code>variable</code> may be used inside
	 <code>pattern</code> to refer to the package
	 or package version this term to.
	 
	 You can use <code>variable</code> in two
	 ways. To apply a <code class="literal">?</code>-style term to
	 the variable, write
	 <code class="literal">?<code>variable</code>:<code>term-name</code>(<code>args</code>)</code>;
	 for instance, <code class="literal">?x:<a class="link" href="ch02s04s05.html#searchDep">depends</a>(apt)</code>. In
	 addition, the term
	 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchEqual">?=</a></code><code>variable</code></code>
	 will select any package or version that matches the
	 value of the given <code>variable</code>.
	 
	 For instance, the following term will match any package
	 <code class="literal">x</code> that both depends and recommends a
	 second package <code class="literal">y</code>.
	 <div class="example"><a id="exampleSearchFor"></a>Example 2.5. Use of the <code class="literal">?for</code> term<div class="example-contents">
		<code class="literal">
		 ?for x: <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>( ?for y: ?x:<a class="link" href="ch02s04s05.html#searchDep">recommends</a>( <code class="literal"><a class="link" href="ch02s04s05.html#searchEqual">?=</a></code>y ) )
		</code>
	 </div></div> 
	 See <a class="xref" href="ch02s04s04.html" title="Explicit search targets">the section called “Explicit search targets”</a> for more
	 information.
	 </dd><dt><a id="searchGarbage"></a><code class="literal">?garbage</code>, <code class="literal">~g</code></dt><dd>
	 Matches packages which are not installed, or which were
	 automatically installed and are not depended upon by any
	 installed package.
	 </dd><dt><a id="searchInstalled"></a><code class="literal">?installed</code>, <code class="literal">~i</code></dt><dd>
	 Matches package versions which are currently installed.
	 
	 Since all versions are tested by default, this normally
	 matches packages which are currently installed.
	 </dd><dt><a id="searchMaintainer"></a><code class="literal">?maintainer(<code>maintainer</code>)</code>, <code class="literal">~m<code>maintainer</code></code></dt><dd>
	 Matches packages whose Maintainer field matches the
	 regular expression
	 <code>maintainer</code>. For instance,
	 “<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchMaintainer">?maintainer</a></code>(joeyh)</code>”
	 will find all packages maintained by Joey Hess.
	 </dd><dt><a id="searchMultiArch"></a><code class="literal">?multiarch(<code>multiarch</code>)</code></dt><dd>
	 Matches packages with the multi-arch capability
	 specified by <code>multiarch</code>. For instance,
	 “<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchMultiArch">?multiarch</a></code>(foreign)</code>”
	 will find all packages which can satisfy dependencies of
	 packages for another architecture.
	 “<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchMultiArch">?multiarch</a></code>(none)</code>”
	 will select packages with no multi-arch capability.
	 </dd><dt><a id="searchNarrow"></a>
	 <code class="literal">?narrow(<code>filter</code>, <code>pattern</code>)</code>, <code class="literal">~S <code>filter</code> <code>pattern</code></code>
	 </dt><dd>
	 This term “narrows” the search to package
	 versions matching <code>filter</code>. In
	 particular, it matches any package version which matches
	 both <code>filter</code> and
	 <code>pattern</code>. The string value of
	 the match is the string value of
	 <code>pattern</code>.
	 </dd><dt><a id="searchTermName"></a><code class="literal">?name(<code>name</code>)</code>, <code class="literal">~n<code>name</code></code></dt><dd>
	 Matches packages whose name matches the regular
	 expression <code>name</code>. For
	 instance, most of the packages that match
	 “<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchTermName">?name</a></code>(^lib)</code>” are
	 libraries of one sort or another.
	 </dd><dt><a id="searchNew"></a><code class="literal">?new</code>, <code class="literal">~N</code></dt><dd>
	 Matches packages which are “new”: that is,
	 they have been added to the archive since the last time
	 the list of packages was cleared using Actions → Forget new packages (f)
	 or the command-line action <code class="literal"><a class="link" href="rn01re01.html#cmdlineForgetNew">forget-new</a></code>.
	 </dd><dt><a id="searchObsolete"></a>
	 <code class="literal">?obsolete</code>, <code class="literal">~o</code>
	 </dt><dd>
	 This term matches any installed package which is not
	 available in any version from any archive. These
	 packages appear as “Obsolete or Locally
	 Installed” in the visual interface.
	 </dd><dt><a id="searchOrigin"></a><code class="literal">?origin(<code>origin</code>)</code>, <code class="literal">~O<code>origin</code></code></dt><dd>
	 Matches package versions whose origin matches the
	 regular expression <code>origin</code>.
	 For instance,
	 “<code class="literal">!?origin(debian)</code>” will
	 find any unofficial packages on your system (packages
	 not from the Debian archive).
	 </dd><dt><a id="searchProvides"></a><code class="literal">?provides(<code>pattern</code>)</code>, <code class="literal">~P<code>pattern</code></code></dt><dd>
	 Matches package versions which provide a package that
	 matches the <code>pattern</code>. For
	 instance,
	 “<code class="literal">?provides(mail-transport-agent)</code>”
	 will match all the packages that provide
	 “<code class="literal">mail-transport-agent</code>”.
	 </dd><dt><a id="searchPriority"></a><code class="literal">?priority(<code>priority</code>)</code>, <code class="literal">~p<code>priority</code></code></dt><dd>
	 Matches packages whose priority is
	 <code>priority</code>;
	 <code>priority</code> must be
	 <code class="literal">extra</code>, <code class="literal">important</code>,
	 <code class="literal">optional</code>,
	 <code class="literal">required</code>, or
	 <code class="literal">standard</code>. For instance,
	 “<code class="literal">?priority(required)</code>”
	 matches packages whose priority is
	 “<code class="literal">required</code>”.
	 </dd><dt><a id="searchReverseDep"></a><code class="literal">?reverse-<code>depType</code>(<code>pattern</code>)</code>, <code class="literal">~R[<code>depType</code>:]<code>pattern</code></code></dt><dd>
	 <code>depType</code> may be either
	 “<code class="literal">provides</code>” or one of the
	 dependency types given in <a class="link" href="ch02s04s05.html#searchBrokenType">the documentation of
	 <code class="literal">?broken-<code>depType</code></code></a>.
	 If <code>depType</code> is not present, it
	 defaults to <code class="literal">depends</code>.
	 
	 If <code>depType</code> is
	 “<code class="literal">provides</code>”, matches
	 packages whose name is provided by a package version
	 matching <code>pattern</code>. Otherwise,
	 matches packages which a package version matching
	 <code>pattern</code> declares a dependency of
	 type <code>depType</code> upon.
	 </dd><dt><a id="searchReverseBrokenDep"></a><code class="literal">?reverse-broken-<code>depType</code>(<code>pattern</code>)</code>, <code class="literal">?broken-reverse-<code>depType</code>(<code>pattern</code>)</code>, <code class="literal">~RB[<code>depType</code>:]<code>pattern</code></code></dt><dd>
	 <code>depType</code> may be either
	 “<code class="literal">provides</code>” or one of the
	 dependency types given in <a class="link" href="ch02s04s05.html#searchBrokenType">the documentation of
	 <code class="literal">?broken-<code>depType</code></code></a>.
	 If <code>depType</code> is not present, it
	 defaults to <code class="literal">depends</code>.
	 
	 Matches packages which a package version matching
	 <code>pattern</code> declares an unsatisfied
	 dependency of type <code>depType</code> upon.
	 </dd><dt><a id="searchSection"></a>
	 <code class="literal">?section(<code>section</code>)</code>, <code class="literal">~s<code>section</code></code>
	 </dt><dd>
	 Matches packages whose section matches the regular
	 expression <code>section</code>.
	 </dd><dt><a id="searchSourcePackage"></a>
	 <code class="literal">?source-package(<code>name</code>)</code>, <code class="literal">~e<code>name</code></code>
	 </dt><dd>
	 Matches packages whose source package name matches the
	 regular expression <code>name</code>.
	 </dd><dt><a id="searchSourceVersion"></a>
	 <code class="literal">?source-version(<code>version</code>)</code>
	 </dt><dd>
	 Matches packages whose source version matches the
	 regular expression <code>version</code>.
	 </dd><dt><a id="searchTag"></a><code class="literal">?tag(<code>tag</code>)</code>, <code class="literal">~G<code>tag</code></code></dt><dd>
	 Matches packages whose Tag field matches the regular
	 expression <code>tag</code>. For
	 instance, the pattern
	 <code class="literal">?tag(game::strategy)</code> would match
	 strategy games.
	 
	 For more information on tags and debtags, see <a class="ulink" href="http://debtags.alioth.debian.org" target="_top">http://debtags.alioth.debian.org</a>.
	 </dd><dt><a id="searchTask"></a>
	 <code class="literal">?task(<code>task</code>)</code>, <code class="literal">~t<code>task</code></code>
	 </dt><dd>
	 Matches packages that appear in a task whose name
	 matches the regular expression
	 <code>task</code>.
	 </dd><dt><a id="searchTerm"></a>
	 <code class="literal">?term(<code>keyword</code>)</code>
	 </dt><dd>
	 This term performs a full-text search for
	 <code>keyword</code> in the apt package
	 cache. When used with “<code class="literal">aptitude
	 search</code>”, <a class="link" href="ch02s01s02.html#menuSearchLimit">Search → Limit Display (l)</a> in the
	 curses front-end, or typed into a package search box in
	 the GTK+ front-end, this term will allow aptitude to
	 accelerate the search using a Xapian index.
	 </dd><dt><a id="searchTermPrefix"></a>
	 <code class="literal">?term-prefix(<code>keyword</code>)</code>
	 </dt><dd>
	 This term performs a full-text search for any keyword
	 beginning with <code>keyword</code> in the
	 apt package cache. When used with
	 “<code class="literal">aptitude search</code>”, <a class="link" href="ch02s01s02.html#menuSearchLimit">Search → Limit Display (l)</a> in the
	 curses front-end, or typed into a package search box in
	 the GTK+ front-end, this term will allow aptitude to
	 accelerate the search using a Xapian index.
	 
	 This is similar to <code class="literal"><a class="link" href="ch02s04s05.html#searchTerm">?term</a></code>, but matches extensions of
	 the <code>keyword</code>. For instance,
	 the following search pattern will match any package
	 indexed under the keywords <code class="literal">hour</code>,
	 <code class="literal">hourglass</code>, <code class="literal">hourly</code>,
	 and so on:
	 <div class="example"><a id="exampleTermPrefix"></a>Example 2.6. Use of the <code class="literal">?term-prefix</code> term<div class="example-contents">
		<code class="literal">
		 ?term-prefix(hour)
		</code>
	 </div></div> </dd><dt><a id="searchTrue"></a>
	 <code class="literal">?true</code>, <code class="literal">~T</code>
	 </dt><dd>
	 This term matches any package. For instance,
	 “<code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchInstalled">?installed</a></code><code class="literal"><a class="link" href="ch02s04s05.html#searchProvides">?provides</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchTrue">?true</a></code>)</code>”
	 matches installed packages which provide any package.
	 </dd><dt><a id="searchUpgradable"></a>
	 <code class="literal">?upgradable</code>, <code class="literal">~U</code>
	 </dt><dd>
	 This term matches any installed package which can be
	 upgraded.
	 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
		Note that this only tests whether there are upgrades available
		for a package, not whether an upgrade could
		be performed (with actions such as
		<code class="literal">safe-upgrade</code> or
		<code class="literal">full-upgrade</code>).
	 
		For instance, there can be upgrades available for several
		packages, but maybe the upgraded versions of a subset conflict
		with each other, so they cannot be co-installed or not all of
		them upgraded at the same time.
	 </td></tr></table></div></dd><dt><a id="searchUserTag"></a>
	 <code class="literal">?user-tag(<code>tag</code>)</code>
	 </dt><dd>
	 This term matches any package that is marked with a
	 user-tag matching the regular expression
	 <code>tag</code>.
	 </dd><dt><a id="searchTermVersion"></a>
	 <code class="literal">?version(<code>version</code>)</code>, <code class="literal">~V<code>version</code></code>
	 </dt><dd>
	 Matches any package version whose version number matches
	 the regular expression
	 <code>version</code>, with the exceptions
	 noted below. For instance,
	 “<code class="literal">?version(debian)</code>”
	 matches packages whose version contains
	 “<code class="literal">debian</code>”.
	 
	 The following values of
	 <code>version</code> are treated
	 specially. To search for version numbers containing
	 these values, preface the value with a backslash; for
	 instance, to find packages whose version number contains
	 <code class="literal">CURRENT</code>, search for
	 <code class="literal">\CURRENT</code>.

<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
		 <code class="literal">CURRENT</code> matches the currently
		 installed version of a package, if any.
		 </li><li class="listitem">
		 <code class="literal">CANDIDATE</code> matches the version,
		 if any, of the package that will be installed if
		 you press + on the package or run
		 <code class="literal">aptitude install</code> on it.
		 </li><li class="listitem">
		 <code class="literal">TARGET</code> matches the version of a
		 package that is currently targeted for
		 installation, if any.
		 </li></ul></div>
	 </dd><dt><a id="searchVirtual"></a>
	 <code class="literal">?virtual</code>, <code class="literal">~v</code>
	 </dt><dd>
	 Matches any package which is purely virtual: that is, its name is
	 provided by a package, but no package of that name exists. For
	 instance,
	 “<code class="literal">?virtual<code class="literal"><a class="link" href="ch02s04s05.html#searchReverseDep">?reverse-provides</a></code>(<code class="literal"><a class="link" href="ch02s04s05.html#searchInstalled">?installed</a></code>)</code>”
	 matches virtual packages which are provided by any installed
	 package.
	 </dd><dt><a id="searchWiden"></a>
	 <code class="literal">?widen(<code>pattern</code>)</code>, <code class="literal">~W<code>pattern</code></code> 
	 </dt><dd>
	 “Widens” the match: if the versions to
	 match against have been limited by an enclosing term
	 (such as <code class="literal"><a class="link" href="ch02s04s05.html#searchDep">?depends</a></code>), these limits are dropped. Thus,
	 <code class="literal"><code class="literal"><a class="link" href="ch02s04s05.html#searchWiden">?widen</a></code>(<code>pattern</code>)</code>
	 matches a package version if
	 <code>pattern</code> matches
	 any version of that package.
	 </dd></dl></div><div class="footnotes"> <hr style="width:100; text-align:left;margin-left: 0" /><div id="ftn.idm3897" class="footnote"><a href="#idm3897" class="para">[18] </a>
		 This is provided largely for symmetry with <code class="literal"><a class="link" href="ch02s04s05.html#searchTrue">?true</a></code>.
		</div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s04s04.html"><img src="images/prev.gif" alt="Prev" /></a> </td><td width="20%" align="center"><a accesskey="u" href="ch02s04.html"><img src="images/up.gif" alt="Up" /></a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s05.html"><img src="images/next.gif" alt="Next" /></a></td></tr><tr><td width="40%" align="left" valign="top">Explicit search targets </td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="images/home.gif" alt="Home" /></a></td><td width="40%" align="right" valign="top"> Customizing aptitude</td></tr></table></div></body></html>

Back to Directory File Manager