cave
Name
cave — A commandline client for the other package mangler.
Synopsis
cave [ --environment class:suffix ] [ --log-level level ] COMMAND [ARGS…]
cave help [ --all ]
DESCRIPTION
The front-end to a number of commands.
For the COMMAND argument, see 'cave help' for a list of common commands, or 'cave help --all' for all commands. To see documentation for a command named 'foo', use 'man cave-foo'.
In addition to built-in commands, cave will also look in the directories named in the colon-separated CAVE_COMMANDS_PATH environment variable, or, if unset, '/usr/local/libexec/cave/commands'. Any executables in this path will also be available as commands (with any file extension stripped); these executables may use the $CAVE environment variable to get access to the main cave program.
Arguments specified after the COMMAND are handled by the individual commands. Arguments before the COMMAND are global arguments shared by all commands.
OPTIONS
Global Options
Global options, used by every subcommand.
- -E , --environment
- Environment specification (class:suffix, both parts optional)
- -L , --log-level
Specify the log level
- debug (d)
- Show debug output (noisy)
- qa (q)
- Show QA messages and warnings only (default)
- warning (w)
- Show warnings only
- silent (s)
- Suppress all log messages (UNSAFE)
- -c , --colour
Specify whether to use colour
- auto (a)
- Yes if stdout is connected to a terminal (default)
- yes (y)
- Yes
- no (n)
- No
- -h , --help
- display help message
- -v , --version
- display version information
ENVIRONMENT
- CAVE_COMMANDS_PATH
- Colon-separated paths in which to look for additional commands.
SEE ALSO
cave-fix-linkage cave-import cave-info cave-purge cave-report cave-resolve cave-resume cave-search cave-show cave-sync cave-uninstall cave-config cave-contents cave-dump-cave-formats-conf cave-executables cave-fix-cache cave-generate-metadata cave-help cave-manage-search-index cave-owner cave-size cave-sync-protocol-options cave-update-world cave-verify cave-digest cave-mirror cave-has-version cave-print-best-version cave-print-categories cave-print-checksum cave-print-checksum-algorithms cave-print-commands cave-print-dependent-ids cave-print-environment-metadata cave-print-id-actions cave-print-id-contents cave-print-id-environment-variable cave-print-id-executables cave-print-id-masks cave-print-id-metadata cave-print-id-size cave-print-ids cave-print-owners cave-print-packages cave-print-repositories cave-print-repository-formats cave-print-repository-metadata cave-print-set cave-print-sets cave-print-spec cave-print-sync-protocols cave-print-unmanaged-files cave-print-unused-distfiles cave-display-resolution cave-execute-resolution cave-find-candidates cave-graph-jobs cave-match cave-perform cave-print-resolution-required-confirmations