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

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/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