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

cave match

Name

cave-match — Determine whether a particular package version has certain properties

Synopsis

cave match spec pattern …

DESCRIPTION

Determines whether a particular package version has certain properties. Mostly for use by 'cave search'; not generally for use by end users.

OPTIONS

Global Options

Global options, used by every subcommand.

-h , --help
display help message

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