man/equery.1

   1 .TH "EQUERY" "1" "August 2009" "GENTOOLKIT" ""
   2 .SH "NAME"
   3 equery \- Gentoo Package Query Tool
   4
   5 .SH "SYNOPSIS"
   6 .BI "equery " "[global\-options] " "module " "[local\-options]"
   7
   8 .SH "DESCRIPTION"
   9 .B Equery
  10 is a collection of modules for querying the state of Gentoo packages, files and USE flags.
  11
  12 .SH "GLOBAL OPTIONS"
  13 .HP
  14 .B \-h, \-\-help
  15 .br
  16 Output a help message.
  17 .HP
  18 .B \-q, \-\-quiet
  19 .br
  20 Be less verbose where possible. In some modules, this option can increase the output speed.
  21 .HP
  22 .B \-C, \-\-no\-color
  23 .br
  24 Do not colorize output.
  25 .HP
  26 .B \-N, \-\-no\-pipe
  27 .br
  28 Turn off automatic pipe detection. Use this option if you do not want
  29 .B equery
  30 to detect if the output is being directed to the screen or to another program and adjust color and verbosity accordingly.
  31 .HP
  32 .B \-V, \-\-version
  33 .br
  34 Display \fBGentoolkit\fP's version. Please include this in all bug reports. (see
  35 .B BUGS
  36 below)
  37
  38 .SH "MODULES"
  39 .B Equery
  40 uses a system of modules. Each module has both a long and short name. The list below uses the notation "\fBmodule (m)\fP", where \fIm\fP is the short name and \fImodule\fP is the long name.
  41 .P
  42 You can view the
  43 .B help
  44 message for a specific module by using
  45 .BR "\-h" ", " "\-\-help "
  46 as either a global option (after
  47 .B equery
  48 and before the module name) or as a local option (after the module name).
  49
  50 .SS
  51 .BI "belongs (b) [OPTIONS] " "FILE"
  52 List the package that owns \fIFILE\fP.
  53 .P
  54 .BI Note:
  55 Normally, only one package will own \fIFILE\fP. If multiple packages own the
  56 same file it should be reported. (see
  57 .B BUGS
  58 below)
  59
  60 .I R "LOCAL OPTIONS" ":"
  61 .HP
  62 .B \-f, \-\-full\-regex
  63 .br
  64 The supplied query is a regular expression.
  65 .HP
  66 .B \-e, \-\-early\-out
  67 .br
  68 Stop when the first match is found. This is generally a safe optimization when searching for the owner of a single file.
  69 .HP
  70 .B \-n, \-\-name\-only
  71 .br
  72 Do not print the version.
  73 .P
  74 .I R "EXAMPLES" ":"
  75 .EX
  76 .HP
  77 equery belongs \-\-early\-out /usr/bin/euse
  78 .EE
  79 .br
  80 Find out what package installed a certain command.
  81 .EX
  82 .HP
  83 emerge \-p $(equery \-q belongs \-nf '^/usr/bin/g?vim.*')
  84 .EE
  85 .br
  86 Tell
  87 .B emerge
  88 to reinstall or update any package that installed a file matching a regular expression.
  89
  90 .SS
  91 .BI "changes (c) [OPTIONS] " "PKG"
  92 Display the Gentoo ChangeLog entry for the latest installable version of \fIPKG\fP.
  93
  94 .I R "LOCAL OPTIONS" ":"
  95 .HP
  96 .B \-l, \-\-latest
  97 .br
  98 Display only the latest ChangeLog entry. It's not uncommon for changes to be prepended to the ChangeLog without a version header if the changes did not require a version bump. Use this option to display such entries.
  99 .HP
 100 .B \-f, \-\-full
 101 .br
 102 Display the full ChangeLog.
 103 .br
 104 \fBHint\fP: Try piping (|) the output to a pager, like 'less'.
 105 .HP
 106 .BI "\-\-limit=" "NUM"
 107 .br
 108 Limit the \fINUM\fP of entries displayed. Use  this option in conjunction with \fB\-\-full\fP. \fB\-\-limit=3\fP would display the three latest entries.
 109 .HP
 110 .BI "\-\-from=" "VER"
 111 .br
 112 Set which \fIVER\fP to display from. Using this option by itself is equivalent to passing \fBchanges\fP a ranged package atom, e.g., '>=foo/bar\-1.5'. It can be used in conjunction with \fB\-\-to\fP to request a more complex range of entries.
 113 .HP
 114 .BI "\-\-to=" "VER"
 115 .br
 116 Set which \fIVER\fP to display to. (See \fB\-\-from\fP)
 117 .P
 118 .I R "EXAMPLES" ":"
 119 .EX
 120 .HP
 121 equery changes portage
 122 .EE
 123 .br
 124 Display the Gentoo ChangeLog entry for the latest installable version of Portage.
 125 .EX
 126 .HP
 127 equery changes '=sys\-apps/portage\-2.1.6*'
 128 .EE
 129 .br
 130 Use Portage's atom syntax. (See \fBman 5 ebuild\fP)
 131 .EX
 132 .HP
 133 equery changes portage \-\-from=2.2_rc1 \-\-to=2.2
 134 .EE
 135 .br
 136 Display any ChangeLog entry within a range of versions.
 137
 138 .SS
 139 .BI "check (k) [OPTIONS] " "PKG"
 140 Check timestamps and MD5 sums for files owned by \fIPKG\fP, where \fIPKG\fP is an installed package.
 141
 142 .I R "LOCAL OPTIONS" ":"
 143 .HP
 144 .B \-f, \-\-full\-regex
 145 .br
 146 The supplied query is a regular expression.
 147 .HP
 148 .B \-o, \-\-only\-failures
 149 .br
 150 Only display packages which don't pass all checks.
 151 .P
 152 .I R "EXAMPLES" ":"
 153 .EX
 154 .HP
 155 equery check \-\-only\-failures '*'
 156 .EE
 157 .br
 158 Verify timestamps and MD5 sums for all installed packages and show only packages which fail checks.
 159 .EX
 160 .HP
 161 equery check 'dev\-python/*' dev\-lang/python
 162 .EE
 163 .br
 164 Verify every installed package in the \fBdev\-python\fP category, and Python itself.
 165
 166 .SS
 167 .BI "depends (d) [OPTIONS] " "PKG"
 168 List all packages that depend on \fIPKG\fP.
 169
 170 .I R "LOCAL OPTIONS" ":"
 171 .HP
 172 .B \-a, \-\-all\-packages
 173 .br
 174 Include dependencies that are not installed. This can take a while.
 175 .HP
 176 .B \-D, \-\-indirect
 177 .br
 178 Search for both direct and indirect dependencies.
 179 .HP
 180 .BI "\-\-depth=" "NUM"
 181 .br
 182 Limit the indirect dependency tree to a depth of \fINUM\fP. \fB\-\-depth=0\fP is equivalent to not using \fB\-\-indirect\fP.
 183 .P
 184 .I R "EXAMPLES" ":"
 185 .EX
 186 .HP
 187 equery depends \-\-indirect xulrunner
 188 .EE
 189 .br
 190 Figure out why a package got installed on your system.
 191
 192 .SS
 193 .BI "depgraph (g) [OPTIONS] " "PKG"
 194 Display a direct dependency graph for every matching version of \fIPKG\fP. A dependency graph is an
 195 indented tree showing the relationship between packages and their dependencies.
 196
 197 .I R "LOCAL OPTIONS" ":"
 198 .HP
 199 .B \-A, \-\-no\-atom
 200 .br
 201 Do not show the dependency atom that match the package.
 202 .HP
 203 .B \-U, \-\-no\-useflags
 204 .br
 205 Do not show USE flags.
 206 .HP
 207 .B \-l, \-\-linear
 208 .br
 209 Do not format the graph by indenting dependencies. This option will print the
 210 recursion depth in square brackets before the package name for easier viewing
 211 in narrow terminals.
 212 .HP
 213 .BI "\-\-depth=" "NUM"
 214 .br
 215 Limit the dependency graph to a depth of \fINUM\fP. \fB\-\-depth=0\fP means no
 216 maximum depth. Default depth is set to 1.
 217 .P
 218 .I R "EXAMPLES" ":"
 219 .EX
 220 .HP
 221 equery depgraph \-\-depth=0 portage
 222 .EE
 223 .br
 224 View a full tree of all direct and indirect compile\-time, run\-time, and post\-merge dependencies for a package.
 225
 226 .SS
 227 .BI "files (f) [OPTIONS] " "PKG"
 228 List files and directories installed by \fIPKG\fP.
 229
 230 .I R "LOCAL OPTIONS" ":"
 231 .HP
 232 .B \-m, \-\-md5sum
 233 .br
 234 Include the file's MD5 sum in the output.
 235 .HP
 236 .B \-s, \-\-timestamp
 237 .br
 238 Include the file's timestamp in the output.
 239 .HP
 240 .B \-t, \-\-type
 241 .br
 242 Include the file type in the output.
 243 .HP
 244 .B \-\-tree
 245 .br
 246 Display files in a tree format. This option turns off all other local options.
 247 .HP
 248 .BI "\-f, \-\-filter=" "RULES"
 249 .br
 250 Filter output by file type.
 251 .HP
 252 RULES
 253 .br
 254 A comma\-separated list (no spaces); choose from:
 255 .br
 256 .B dir, obj, sym, dev, path, conf, cmd, doc, man, info
 257 .P
 258 .I R "EXAMPLES" ":"
 259 .EX
 260 .HP
 261 equery files \-\-tree vlc
 262 .EE
 263 .br
 264 View a file tree of all files installed by a package.
 265 .EX
 266 .HP
 267 equery files \-\-filter=cmd vlc
 268 .EE
 269 .br
 270 Find out where a package installed its executables.
 271
 272 .SS
 273 .BI "has (a) [OPTIONS] " "KEY  VALUE"
 274 List all installed packages that have a given \fIPKG\fP match.
 275
 276 \fBNote\fP: \fBKEY\fP is case sensitive. Also \fBhas\fP does not currently have the ability to inteligently compare values dependending on the type of information being looked up.  It performs a simple string match. It can only list which packages have the matching \fBVALUE\fP as given on the command line. It is a general purpose lookup for most information available via portage's dbapi.aux_get() function.  Warning the quality of the results printed is dependant on the quality of the search (given the limited comparison method) and the recorded data available in the vardb. (See \fIEXAMPLES\fP)
 277
 278 .I R "LOCAL OPTIONS" ":"
 279 .HP
 280 .B \-I, \-\-exclude\-installed
 281 .br
 282 Exclude installed packages from being output.
 283 .HP
 284 .B \-o, \-\-overlay\-tree
 285 .br
 286 Include package from overlays in the search path.
 287 .HP
 288 .B \-p, \-\-portage\-tree
 289 .br
 290 Include all packages from the Portage tree in the search path. Use this option to search through all standard Gentoo packages, including those that are not installed.
 291 .HP
 292 .B \-F, \-\-format=\fITMPL\fP
 293 .br
 294 Customize the output format of the matched packages using the template string \fITMPL\fP. See the \fB\-\-format\fP option for \fBlist\fP below for a description of the \fITMPL\fP argument.
 295 .P
 296 .I R "OUTPUT" ":"
 297 .HP
 298 (See \fIOUTPUT\fP for \fBlist\fP below)
 299 .P
 300 .I R "EXAMPLES" ":"
 301 .EX
 302 .HP
 303 equery has SLOT 2.4
 304 .EE
 305 .br
 306 View all installed Gentoo packages that have a recorded SLOT = "2.4".
 307 .EX
 308 .HP
 309 equery has repository sunrise
 310 .EE
 311 .br
 312 View all installed Gentoo packages that were recorded to be installed from ebuilds from the "sunrise" overlay.
 313 .EX
 314 .HP
 315 equery has EAPI 2
 316 .EE
 317 .br
 318 View all installed Gentoo packages that were installed with ebuilds with a recorded EAPI of "2".
 319
 320 .SS
 321 .BI "hasuse (h) [OPTIONS] " "USE"
 322 List all installed packages that have a given \fIPKG\fP flag.
 323
 324 \fBNote\fP: \fBhasuse\fP does not currently have the ability to display if packages are built with the given USE flag or not. It can only list which packages have the flag as an option. (See \fIEXAMPLES\fP)
 325
 326 .I R "LOCAL OPTIONS" ":"
 327 .HP
 328 .B \-I, \-\-exclude\-installed
 329 .br
 330 Exclude installed packages from being output.
 331 .HP
 332 .B \-o, \-\-overlay\-tree
 333 .br
 334 Include package from overlays in the search path.
 335 .HP
 336 .B \-p, \-\-portage\-tree
 337 .br
 338 Include all packages from the Portage tree in the search path. Use this option to search through all standard Gentoo packages, including those that are not installed.
 339 .HP
 340 .B \-F, \-\-format=\fITMPL\fP
 341 .br
 342 Customize the output format of the matched packages using the template string \fITMPL\fP. See the \fB\-\-format\fP option for \fBlist\fP below for a description of the \fITMPL\fP argument.
 343 .P
 344 .I R "OUTPUT" ":"
 345 .HP
 346 (See \fIOUTPUT\fP for \fBlist\fP below)
 347 .P
 348 .I R "EXAMPLES" ":"
 349 .EX
 350 .HP
 351 equery hasuse \-pI perl
 352 .EE
 353 .br
 354 View all Gentoo packages that have the "perl" USE flag, exluding installed packages.
 355 .EX
 356 .HP
 357 USE="perl"; for PKG in $(equery \-q hasuse $USE); do echo $PKG: $(equery \-q uses $PKG |grep $USE); done
 358 .EE
 359 .br
 360 This Bash one\-liner uses \fBhasuse\fP to find a list of packages that have a certain USE flag, and \fBuses\fP to check whether the flag is enabled or disabled. Modify \fBUSE="perl"\fP to change the query.
 361
 362 .SS
 363 .BI "list (l) [OPTIONS] " "PKG"
 364 List installed versions of \fIPKG\fP or all packages matching the query pattern.
 365
 366 .I R "LOCAL OPTIONS" ":"
 367 .HP
 368 .B \-d, \-\-duplicates
 369 .br
 370 List only packages with more than one version installed.
 371 .HP
 372 .B \-f, \-\-full\-regex
 373 .br
 374 The supplied query is a regular expression.
 375 .HP
 376 .B \-m, \-\-mask\-reason
 377 .br
 378 Print the reason why a package was masked.
 379 .HP
 380 .B \-I, \-\-exclude\-installed
 381 .br
 382 Exclude installed packages from being output.
 383 .HP
 384 .B \-o, \-\-overlay\-tree
 385 .br
 386 Include package from overlays in the search path.
 387 .HP
 388 .B \-p, \-\-portage\-tree
 389 .br
 390 Include all packages from the Portage tree in the search path. Use this option to search through all standard Gentoo packages, including those that are not installed.
 391 .HP
 392 .B \-F, \-\-format=\fITMPL\fP
 393 .br
 394 Customize the output format of the matched packages using the template string \fITMPL\fP. \fITMPL\fP can contain the following placeholders:
 395 .RS
 396 .TP
 397 \fB$cp\fP \- Contains the category and the package name only (e.g 'app\-portage/gentoolkit').
 398 .TP
 399 \fB$cpv\fP \- Contains the category, the package name and the full version (e.g. 'app\-portage/gentoolkit\-0.3.0_rc10\-r1').
 400 .TP
 401 \fB$category\fP \- Contains just the category (e.g. 'app\-portage').
 402 .TP
 403 \fB$name\fP \- Contains just the package name (e.g. 'gentoolkit').
 404 .TP
 405 \fB$version\fP \- Contains the package version (without the revision) (e.g. '0.3.0_rc10').
 406 .TP
 407 \fB$revision\fP \- Contains the package revision (e.g. 'r1').
 408 .TP
 409 \fB$fullversion\fP \- Contains the package version including its revision (e.g. '0.3.0_rc10\-r1').
 410 .TP
 411 \fB$slot\fP \- Contains the package's slot.
 412 .TP
 413 \fB$repo\fP \- Contains the name of the package's repository (e.g. 'gentoo').
 414 .TP
 415 \fB$mask\fP \- The Mask\-status field (\fB~M\-??\fP), see \fIOUTPUT\fP below for an explanation.
 416 .TP
 417 \fB$mask2\fP \- Contains a verbose description of the packages masking status.
 418 .TP
 419 \fB$location\fP \- The Location field (\fBIPO\-\fP), see \fIOUTPUT\fP below for an explanation.
 420 .P
 421 Apart from the above placeholders the template string can contain arbitrary
 422 text as desired. Similar to bash variables, curly braces can be used to
 423 disambiguate the variable names from the enclosing text.
 424 .RE
 425 .P
 426 .I R "OUTPUT" ":"
 427
 428 .EX
 429 $ equery list binutils
 430  * Searching for binutils ...
 431  [I\-\-] [??] sys\-devel/binutils\-2.18\-r1:i686\-pc\-linux\-gnu\-2.18
 432  [IP\-] [ ~] sys\-devel/binutils\-2.19.1\-r1:i686\-pc\-linux\-gnu\-2.19.1
 433 .EE
 434 .HP
 435 Location field (\fB[IPO\-]\fP):
 436 .br
 437 The first field shows the location and install status of the package. It consists of three letters in square brackets. \fBI\fP indicates the package is currently installed. \fBP\fP indicates the package is available in the Portage tree. \fBO\fP indicates the package is available in at least one overlay. \fB\-\fP is a place holder and has no meaning. \fB[I\-O]\fP would mean that the package is installed and available from an overlay, but not available from the Portage tree.
 438 .HP
 439 Mask\-status field (\fB[ ~M\-??]\fP):
 440 .br
 441 The second field shows the mask status of the package. Empty brackets indicate that the package is unmasked. A \fB~\fP means the package is masked by keyword, e.g., you are running a stable system and the package is marked testing). \fBM\fP means hard masked, e.g., the package maintainer has determined the package is unfit for widespread usage. \fB\-\fP means arch masked, e.g., you are running an amd64 system, but this package only works on x86. Lastly, \fB??\fP only occurs when the location field is \fB[I\-\-]\fP. Together, they indicate that the package was installed from the Portage tree or an overlay, but has since been removed from that tree; therefore \fBequery\fP can not determine a mask status for it.
 442 .HP
 443 Package name:
 444 .br
 445 The third field is the full package name and version.
 446 .HP
 447 Slot:
 448 .br
 449 The fourth field, after the colon, is the package's slot. \fB0\fP is the default slot. To find all packages with multiple slots installed, use \fB\-\-duplicates\fP.
 450 .P
 451 \fBNote:\fP Because it takes extra processing time to determine the location, mask status and slot, you can speed up output by passing the \fB\-\-quiet\fP global option to \fBequery\fP when you don't care about the extra information.
 452
 453 \fBNote:\fP Additionally, when using \-\-quiet, if no matches are found, instead of printing an error, the equery list module will return with an exit value of 3.
 454
 455 .P
 456 .I R "EXAMPLES" ":"
 457 .EX
 458 .HP
 459 equery list '*'
 460 .EE
 461 .br
 462 List all installed packages. This is equivalent to '\fBequery list\fP' in \fBGentoolkit\fP versions prior to 0.3.0.
 463 .EX
 464 .HP
 465 equery list \-op mozilla\-firefox
 466 .EE
 467 .br
 468 List all available versions of the package exactly matching 'mozilla\-firefox'. This is equivalent to '\fBequery list \-\-exact\-name \-o \-p mozilla\-firefox\fP' in \fBGentoolkit\fP versions prior to 0.3.0.
 469 .EX
 470 .HP
 471 equery list '*zilla*'
 472 .EE
 473 .br
 474 List all packages that contain (fuzzy match) 'zilla'. This is equivalent to '\fBequery list zilla\fP' in \fBGentoolkit\fP versions prior to 0.3.0.
 475 .EX
 476 .HP
 477 equery list 'www\-client/*'
 478 .EE
 479 .br
 480 List all packages in the category \fBwww\-client\fP. This is equivalent to '\fBequery list \-\-category=www\-client\fP' in \fBGentoolkit\fP versions prior to 0.3.0.
 481 .EX
 482 .HP
 483 equery list \-\-duplicates '*'
 484 .EE
 485 .br
 486 List all packages with more than one version installed. This is equivalent to '\fBequery list \-\-duplicates\fP' in \fBGentoolkit\fP versions prior to 0.3.0.
 487 .EX
 488 .HP
 489 equery list \-F '$cp:$slot' '*'
 490 .EE
 491 .br
 492 Get a list of slotted atoms for all installed packages.
 493 .EX
 494 .HP
 495 equery list \-po \-F '[$location] [$mask] $cpv:$slot [$repo]' '*'
 496 .EE
 497 .br
 498 Show all packages in the default (verbose) output format but also include their repository name.
 499
 500 .SS
 501 .BI "meta (m) [OPTIONS] " "PKG"
 502 Display metadata about \fIPKG\fP.
 503
 504 \fBmeta\fP reads a file called metadata.xml which must be included with all Portage tree packages. \fBmeta\fP does not read ebuilds, so it can only return version independent metadata. Since until now there had not been an easy way for users to view metadata.xml, and because package maintainers are only required to fill out a very small portion of the file, there are still many packages without detailed metadata available. For more information about metadata.xml, see:
 505 .br
 506 .EX
 507 http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=4
 508 .EE
 509
 510 .I R "LOCAL OPTIONS" ":"
 511 .HP
 512 .B \-d, \-\-description
 513 .br
 514 Show an extended package description.
 515 .HP
 516 .B \-H, \-\-herd
 517 .br
 518 Show the herd(s) for the package. When not piping and not passing \fB\-\-quiet\fP as a global option, also show the herd's email address. (shown by default)
 519 .HP
 520 .B \-k, \-\-keywords
 521 .br
 522 Show keywords for all matching versions. \fBkeywords\fP does not list all keywords for all versions. Instead, it filters the list to make it easier to spot versions that need bumping or are okay to remove from the tree. It filters by slot. For example:
 523 .br
 524 Keywords:    1.35.0\-r3:\fB0\fP:
 525 .br
 526 Keywords:    1.35.0\-r5:\fB0\fP: amd64 hppa ppc x86 ~alpha ~arm ~ia64 ~mips ~ppc64 ~s390 ~sh ~sparc
 527 .br
 528 In this output from \fBequery meta boost\fP, \-r5 is the highest available version in slot 0, so all keywords are listed. The actual keywords for \-r3 are "~amd64 ~hppa ~ppc ~x86", but since a higher version in the same slot has the same or more stable keywording, they are filtered out. Arch mask keywords (\-*) are always shown.
 529 .HP
 530 .B \-m, \-\-maintainer
 531 .br
 532 Show the package maintainer(s) email address. If the metadata is available, also show the maitainer's name and/or job description. (shown by default)
 533 .HP
 534 .B \-u, \-\-useflags
 535 .br
 536 Show per\-package USE flag descriptions. Per\-package USE flag descriptions are sometimes added to metadata.xml if the affect of the USE flag is unusual, or if the USE flag is rare enough to be undefined in the global definition file. \fBequery uses\fP now displays these same local descriptions as well, so this option is left in \fBmeta\fP for completeness only.
 537 .HP
 538 .B \-U, \-\-upstream
 539 .br
 540 Show information about the package's upstream project, including the author's email, upstream bug tracker or upstream documentation. At the time of writing, most maintainers do not provide this information. (shown by default)
 541 .HP
 542 .B \-x, \-\-xml
 543 .br
 544 Dump the plain XML file to the screen.
 545 .P
 546 .I R "EXAMPLES" ":"
 547 .EX
 548 .HP
 549 equery meta gnucash
 550 .EE
 551 .br
 552 Show general information about maintainership, including herd, maintainer and upstream.
 553 .EX
 554 .HP
 555 equery meta \-\-description screen
 556 .EE
 557 .br
 558 See if the package maintainer has provided an extended description.
 559 .EX
 560 .HP
 561 equery \-N meta \-H gnome |grep \-o \-\-color=never '[^( ]*@gentoo.org'
 562 .EE
 563 .br
 564 Extract the herd's email address to let them know they're doing a great job. Remember, bug reports should go to bugs.gentoo.org. The above example will extract one or more emails if available, or return nothing if the herd is \fBno\-herd\fP.
 565
 566 .SS
 567 .BI "size (s) [OPTIONS] " "PKG"
 568 Print total size of files contained in a given \fIPKG\fP.
 569
 570 .I R "LOCAL OPTIONS" ":"
 571 .HP
 572 .B \-b, \-\-bytes
 573 .br
 574 Report package size in bytes.
 575 .HP
 576 .B \-f, \-\-full\-regex
 577 .br
 578 The query is a regular expression.
 579 .P
 580 .I R "EXAMPLES" ":"
 581 .EX
 582 .HP
 583 equery \-q size 'www\-client/*'
 584 .EE
 585 .br
 586 Get a one\-line summary of the number of files and total size (in bytes) of those files for each installed package in a category.
 587
 588 .SS
 589 .BI "uses (u) [OPTIONS] " "PKG"
 590 Display USE flag statuses and descriptions for a given \fRPKG\fP.
 591
 592 .I R "LOCAL OPTIONS" ":"
 593 .HP
 594 .B \-a, \-\-all
 595 .br
 596 Display all package versions. Without this option, \fBequery\fP will choose the best available version.
 597 .P
 598 .I R "EXAMPLES" ":"
 599 .EX
 600 .HP
 601 equery uses app\-misc/beagle
 602 .EE
 603 .br
 604 See which USE flags are enabled for a specific package.
 605 .EX
 606 .HP
 607 USE="perl"; for PKG in $(equery \-q hasuse $USE); do echo $PKG: $(equery \-q uses $PKG |grep $USE); done
 608 .EE
 609 .br
 610 This Bash one\-liner uses \fBhasuse\fP to find a list of packages that have a certain USE flag, and \fBuses\fP to check whether the flag is enabled or disabled. Modify \fBUSE="perl"\fP to change the query.
 611
 612 .SS
 613 .BI "which (w) [OPTIONS] " "PKG"
 614 Display the path to the ebuild that would be used by Portage with the current configuration.
 615
 616 .I R "LOCAL OPTIONS" ":"
 617 .HP
 618 .B \-m, \-\-include\-masked
 619 .br
 620 Return the path to the hightest version ebuild available.
 621 .P
 622 .I R "EXAMPLES" ":"
 623 .EX
 624 .HP
 625 less $(equery which xorg\-server)
 626 .EE
 627 .br
 628 View the most recent installable ebuild.
 629
 630 .SH "BUGS"
 631 Submit bug reports to http://bugs.gentoo.org.
 632
 633 .SH "AUTHORS"
 634 Karl Trygve Kalleberg <karltk@gentoo.org>, 2003
 635 .br
 636 Katerina Barone\-Adesi <katerinab@gmail.com>, 2004
 637 .br
 638 Douglas Anderson <douglasjanderson@gmail.com>, 2009