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

cave resume

Name

cave-resume — Resume a failed resolution from 'cave resolve'

Synopsis

cave resume --resume-file state [ --retry-failed ] [ --retry-skipped ]

DESCRIPTION

Resumes a failed resultion from 'cave resolve'. To enable resumes, use 'cave resolve --resume-file state --execute', and then if errors occur, use 'cave resume --resume-file state [ --retry-failed ] [ --retry-skipped ]' to try again.

OPTIONS

Global Options

Global options, used by every subcommand.

-h , --help
display help message

Retry Options

Retry options. By default, 'cave resume' will treat packages that were already skipped or already failed as skipped or failed, respectively.

-r , --retry-failed (+r , --no-retry-failed)
Retry any job that has already failed
-R , --retry-skipped (+R , --no-retry-skipped)
Retry any job that has already been skipped. Note that the job will just be skipped again unless circumstances have changed.
-s , --skip-failed (+s , --no-skip-failed)
Skip any job that has already failed

EXECUTION OPTIONS

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