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

cave import

Name

cave-import — Import a package from a directory containing its image.

Synopsis

cave import [ --location blah ] cat/pkg [ version ] [ slot ] [ --execute ] [ -- options for 'cave resolve' ]

DESCRIPTION

Import a package from a directory containing its image. A named directory is treated as holding the contents to install, and a dummy package name is provided on the command line. Safe merge, unmerge, upgrade and replace support is provided, as is content tracking for installed files.

OPTIONS

Global Options

Global options, used by every subcommand.

-h , --help
display help message

Execution Options

Control execution.

-x , --execute (+x , --no-execute)
Execute the suggested actions

Contents Options

Options controlling the content to install

-l , --location
Specify the directory containing the image to install (default: current directory)
-u , --install-under
Install under the specified directory, rather than /
-r , --rewrite-ids-over-to-root
Change any UID or GID over this value to 0 (-1 disables, default)
-s , --strip

Specify whether to strip and split objects being installed.

config (c)
Use build_options: symbols from user configuration (default)
always (a)
Split and strip, regardless of user configuration
never (n)
Do not split or strip, regardless of user configuration
-p , --preserve-work

Specify whether to avoid carrying out destructive merge actions (e.g. using rename() rather than copying)

config (c)
Use build_options: preserve_work from user configuration (default)
always (a)
Do not merge destructively, regardless of user configuration
never (n)
Allow desructive merges, regardless of user configuration

Metadata Options

Options specifying metadata for the package being installed

-D , --description
Specify a description for the package
-B , --build-dependency
Specify a build dependency. May be specified multiple times.
-R , --run-dependency
Specify a run dependency. May be specified multiple times.
-P , --preserve-metadata (+P , --no-preserve-metadata)
If replacing a package previously installed using this command, copy its description and dependencies

NOTES

  • This command uses the same underlying logic as 'cave resolve'. Any option that is valid for 'cave resolve' may be passed as a parameter following a '--'. For example, 'cave import cat/pkg --build-dependency some/dep -- --lazy' may be useful. As a special case, '--execute' does not require a '--'.