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

cave execute-resolution

Name

cave-execute-resolution — Executes a dependency resolution created using 'cave resolve'.

DESCRIPTION

Execute a dependency resolution created using 'cave resolve'. Mostly for internal use; most users will not use this command directly.

OPTIONS

Global Options

Global options, used by every subcommand.

-h , --help
display help message

General Options

General options.

--pretend
Only carry out the pretend action
--set
Our target is a set rather than package specs
--world-specs
Use the specified spec or set name for updating world
--removed-if-dependent-names
If nothing is left with the specified name, also remove it from world

EXECUTION OPTIONS

World Options

Options controlling how the 'world' set is modified

-1 , --preserve-world (+1 , --no-preserve-world)
Do not modify the 'world' set

Failure Options

Failure handling options.

-C , --continue-on-failure

Whether to continue after an error occurs

never (n)
Never (default)
if-satisfied (s)
If remaining packages' dependencies are satisfied
if-independent (i)
If remaining packages do not depend upon any failing package
always (a)
Always (dangerous)
--resume-file (--no-resume-file)
Write resume information to the specified file. If a build fails, or if '--execute' is not specified, then 'cave resume' can resume execution from this file.

Jobs Options

Options controlling jobs and parallelism.

-f , --fetch (+f , --no-fetch)
Skip any jobs that are not fetch jobs. Should be combined with --continue-on-failure if any of the packages to be merged have fetch dependencies.
-J , --fetch-jobs
The number of parallel fetch jobs to launch. If set to 0, fetches will be carried out sequentially with other jobs. Values higher than 1 are currently treated as being 1. Defaults to 1, or if --fetch is specified, 0.

Phase Options

Options controlling which phases to execute. No sanity checking is done, allowing you to shoot as many feet off as you desire. Phase names do not have the src_, pkg_ or builtin_ prefix, so 'init', 'preinst', 'unpack', 'merge', 'strip' etc.

--skip-phase
Skip the named phases
--abort-at-phase
Abort when a named phase is encountered
--skip-until-phase
Skip every phase until a named phase is encountered
--change-phases-for

Control to which package or packages these phase options apply

all
All packages (default)
first
Only the first package on the list
!first
Everything except the first package on the list
last
Only the last package on the list
!last
Everything except the last package on the list
targets
Only packages that are targets
!targets
Only packages that are not targets

PROGRAM OPTIONS

Program Options

Options controlling which programs are used to carry out various tasks. Any replacement to the standard program must provide exactly the same interface. In all cases, $CAVE can be used to get the path of the main 'cave' executable. Note that unless an option is explicitly specified, an internal implementation of the default command might be used instead of spawning a new process.

--display-resolution-program
The program used to display the resolution. Defaults to '$CAVE display-resolution'.
--graph-jobs-resolution-program
The program used to graph jobs. Defaults to '$CAVE graph-jobs'.
--execute-resolution-program
The program used to execute the resolution. Defaults to '$CAVE execute-resolution'.
--perform-program
The program used to perform actions. Defaults to '$CAVE perform'.
--update-world-program
The program used to perform world updates. Defaults to '$CAVE update-world'.
--graph-program
The program used to create Graphviz graphs. Defaults to 'dot'.

IMPORT OPTIONS

Import Options

Options controlling additional imported packages. These options should not be specified manually; they are for use by 'cave import'.

--unpackaged-repository-params
Specifies the parameters used to construct an unpackaged repository, for use by 'cave import'.

ENVIRONMENT

PALUDIS_SERIALISED_RESOLUTION_FD
The file descriptor on which the serialised resolution can be found.