Paludis Logo Introduction cave  
Bugs, Requests, Support    
Overview    
FAQ    
Clients    
Configuration    
API    

cave search

Name

cave-search — Search for packages with particular characteristics.

Synopsis

cave search [ --name | --description | --key HOMEPAGE ] pattern …

DESCRIPTION

Searches for packages with particular characteristics.

OPTIONS

Global Options

Global options, used by every subcommand.

-h , --help
display help message

SEARCH CANDIDATE OPTIONS

Candidate Options

Control which packages and versions are selected as candidates for matching.

-a , --all-versions (+a , --no-all-versions)
Search in every version of packages
-v , --visible (+v , --no-visible)
Search only in visible (not masked) versions of packages
-m , --matching
Search only in packages matching the supplied specification

MATCH OPTIONS

Pattern Options

Alter how patterns are matched.

-t , --type

Specify which matching algorithm to use

text (t)
Match an exact text substring, ignoring case (default)
exact (x)
Match only an entire exact string, ignoring case
regex (r)
Match using pcre regular expressions, ignoring case
-C , --case-sensitive (+C , --no-case-sensitive)
Make matching case sensitive.
-& , --and (+& , --no-and)
If multiple patterns are specified, require that all patterns match. Default is to succeed if any pattern matches.
-! , --not (+! , --no-not)
Invert the results of pattern matches.

Search Key Options

Alter the keys used for searching. If no option in this group is specified, matches are carried out on name and description. Otherwise, matches are carried out on all of the specified keys.

-k , --key
Search the named metadata key (e.g. DESCRIPTION). May be specified multiple times.
-n , --name (+n , --no-name)
Search package names.
-d , --description (+d , --no-description)
Search package descriptions.

Key Handling Options

Alter how key values are interpreted.

-e , --enabled-only (+e , --no-enabled-only)
Only search enabled parts of conditional dependency spec trees

INDEX OPTIONS

Index Options

Controls the use of an index. An index may be created using cave manage-search-index. Note that strange errors or partial results may occur if the index is not up to date.

--index
Use the specified index file

NOTES

  • 'cave search' should only be used when a complex metadata search is required. To see information about a known package, use 'cave show' instead.