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