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 ECMAScript 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.