Paludis Logo Introduction Main page
Bugs, Requests, Support Release Notes
Overview ChangeLog
FAQ  
Clients  
Configuration  
API  

cave

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/x86_64-pc-linux-gnu/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.