Conary:conary repquery
From rPath Wiki
| conary repquery / conary rq | ||
| conary repquery [args] trovename[=version][<flavor>] | ||
| Example> conary repquery example | ||
|
Use conary repquery, often abbreviated conary rq, to display information about software available from one or more Conary repositories.
When used with no additional parameters, conary repquery lists available packages and their revisions from all the labels Conary is configured to search. This configuration is maintained by the installLabelPath setting on the local system, which can be viewed using conary config:
$> conary config | grep installLabelPath installLabelPath conary.rpath.com@rpl:1 foresight.rpath.org@fl:desktop
Labels contain a Conary repository's hostname and branch. The label and the revision make up a complete version string. The branch makes it possible for a single repository to contain software meant for different purposes (such as for either software under development or stable software) or different system environments (such as for either rPath Linux or Foresight Linux).
Given the amount of output generated from such a command, consider piping it with more or less:
$> conary rq | less Cheetah=1.0-1-0.1 Cheetah:source=1.0-1 ... cairo:source=/conary.rpath.com@rpl:devel//1/1.0.2-1.1 cairo:source=/foresight.rpath.org@fl:desktop/1.2.0-2 ... muine=0.8.5-1-1 muine:source=0.8.5-2 ... zsnes=1.42-6-1 zsnes:source=1.42-6
Read the Revisions
The command displays the latest revision of each package on each branch. It also displays source components, which do not have a source count at the end of their revisions (such as the -1 on zsnes which is not shown for zsnes:source). Note that the revision of the source components may differ from the package, such as with muine in the example, because sources for the code may have been built since the last time binaries were created.
 | See Conary:Version String for details about each part of a Conary version string. |
The conary rq output only displays sufficient information to make all output unique; in the example, cairo:source exists in repositories on both conary.rpath.com and foresight.rpath.org, so the output displays a more complete version string
Add a Trove Name Argument
Add a package (or other trove) name to query all labels in the install label path for troves of that name:
$> conary rq gaim gaim=/conary.rpath.com@rpl:devel//1/1.5.0-4.2-1 gaim=/foresight.rpath.org@fl:1-devel//1/2.0.0beta6-3-7
Recognize Flavor Affinity
The output from conary rq is always flavor-appropriate for your system. For example, issuing conary rq on a 32-bit system only displays troves that are designated as compatible with 32-bit systems. The flavor and some additional information can be displayed using the --info option:
$> conary rq --info gaim
Name : gaim Build time: Tue Jan 17 14:26:37 2006
Version : 1.5.0-4.2-1 Label : conary.rpath.com@rpl:1
Size : 11073132
Flavor : is: x86
License : License :: OSI Approved :: GNU General Public License (GPL)
Category : Topic :: Communications :: Chat
Category : Topic :: Communications :: Chat :: AOL Instant Messenger
Category : Topic :: Communications :: Chat :: ICQ
Category : Topic :: Communications :: Chat :: Internet Relay Chat
Category : Topic :: System :: Networking
Summary : A GTK2-based instant messaging client.
Description:
Gaim is a GTK2-based instant messenger application...
Change log: Example User (user@example.com)
Add missing buildreqs
(The description text was truncated to provide a more concise example.)
In addition to illustrating the use of conary rq --info, this example shows how adding a trove name to the command restricts the output to just the specified trove (in this case, the gaim package).
| | If you need more information than the shortened version strings conary rq displays, use the --full-versions option to view the complete version string for each trove. |
Query Labels Not in the Install Label Path (--install-label)
Use --install-label to display the contents of any given label regardless of whether Conary has been configured to search that label by default:
$> conary rq --install-label contrib.rpath.org@rpl:1 gaim-encryption=2.38-0.1-1 gaim-encryption:source=2.38-0.1 gaim-otr:source=3.0.0-1 lyx=1.4.2-4-1 lyx:source=1.4.2-4
In this example, Conary displays the contents of contrib.rpath.org by explicitly specifying the label (contrib.rpath.org@rpl:1).
Show Results Only From the Installed Label and Flavor (--affinity)
Use --affinity to restrict results to the label and flavor installed on the system:
$> conary q gaim --labels gaim=conary.rpath.com@rpl:1/1.5.0-4.2-1 $> conary rq gaim gaim=/conary.rpath.com@rpl:devel//1/1.5.0-4.2-1 gaim=/conary.rpath.com@rpl:devel//foresight.rpath.org@fl:desktop/2.0.0beta3-0.4-1 $> conary rq --affinity gaim gaim=1.5.0-4.2-1
In the example, the conary q command with the --labels option provides the label of the package installed on the system. Because of this output and the version of gaim output when using --affinity, the example confirms that the user executing the command has installed the gaim associated with the first label listed and not the Foresight branch. The conary update command used to update the package will update the software from that label.
| | See the conary manual page (man conary) for additional options available for use with conary repquery. |