reconcilio(1)
Name
reconcilio - Rebuilds packages with broken linkage.
Synopsis
reconcilio [ --fix-linkage ] [fix linkage options]
reconcilio --help
Description
reconcilio searches for and rebuilds packages that are linked against libraries that are not present on the system, or a specific library named by the user.
Options
Actions
Selects which basic action to perform. At most one action should be specified.
- --fix-linkage
- Search for and rebuild packages linked against non-existant libraries (default)
- -V, --version
- Display program version
- -h, --help
- Display program help
General options
Options which are relevant for most or all actions.
- --log-level
- Specify the log level
- debug
- Show debug output (noisy)
- qa
- Show QA messages and warnings only (default)
- warning
- Show warnings only
- silent
- Suppress all log messages (UNSAFE)
- --no-colour
- Do not use colour
- --no-color
- Alias for --no-colour
- -E, --environment
- Environment specification (class:suffix, both parts optional)
- --exact (--no-exact)
- Rebuild the same package version that is currently installed
- --resume-command-template
- Save the resume command to a file. If the filename contains 'XXXXXX', use mkstemp(3) to generate the filename
- --compact (--no-compact)
- Display output using one line per entry
Fix Linkage options
Options which are relevant for --fix-linkage.
- --library
- Only rebuild packages linked against this library, even if it exists
Install options
Options which are relevant for the install process.
- -p, --pretend
- Pretend only
- --no-config-protection
- Disable config file protection (dangerous)
- --debug-build
- What to do with debug information
- none
- Discard debug information
- split
- Split debug information (default)
- internal
- Keep debug information
- --checks
- Whether to run post-build checks
- none
- Don't run checks, even if they should be run
- default
- Run checks if they should be run by default (default)
- always
- Always run checks
- -f, --fetch
- Only fetch sources; don't install anything
- --no-safe-resume
- Do not allow interrupted downloads to be resumed
- --show-reasons
- Show why packages are being (un)installed
- none
- Don't show any information
- summary
- Show a summary (default)
- full
- Show full output (can be very verbose)
- --show-use-descriptions
- Show descriptions of USE flags
- none
- Don't show any descriptions
- new
- Show for new use flags
- changed
- Show for new and changed flags (default)
- all
- Show for all flags
- --show-package-descriptions
- Show package descriptions
- none
- Don't show any descriptions
- new
- Show descriptions for new packages (default)
- all
- Show descriptions for all packages
- --continue-on-failure
- Whether to continue after a fetch or install error
- if-fetch-only
- If fetching only (default)
- never
- Never
- if-satisfied
- If remaining packages' dependencies are satisfied
- if-independent
- If independent of failed and skipped packages
- always
- Always (UNSAFE)
DepList behaviour
Modify dependency list generation behaviour. Use with caution.
- --dl-reinstall
- When to reinstall packages
- never
- Never (default)
- always
- Always
- if-use-changed
- If USE flags have changed
- --dl-reinstall-scm
- When to reinstall scm packages
- never
- Never (default)
- always
- Always
- daily
- If they are over a day old
- weekly
- If they are over a week old
- --dl-upgrade
- When to upgrade packages
- always
- Always
- as-needed
- As needed (default)
- --dl-new-slots
- When to pull in new slots (works with --dl-upgrade)
- always
- Always
- as-needed
- As needed (default)
- --dl-downgrade
- When to downgrade packages
- as-needed
- As needed
- warning
- As needed, but warn when doing so (default)
- error
- Downgrades should be treated as errors
- --dl-deps-default
- Override default behaviour for all dependency classes
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies
- try-post
- As post dependencies, with no error for failures
- discard
- Discard
- --dl-installed-deps-pre
- How to handle pre dependencies for installed packages
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies
- try-post
- As post dependencies, with no error for failures
- discard
- Discard (default)
- --dl-installed-deps-runtime
- How to handle runtime dependencies for installed packages
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies
- try-post
- As post dependencies, with no error for failures (default)
- discard
- Discard
- --dl-installed-deps-post
- How to handle post dependencies for installed packages
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies
- try-post
- As post dependencies, with no error for failures (default)
- discard
- Discard
- --dl-uninstalled-deps-pre
- How to handle pre dependencies for uninstalled packages
- pre
- As pre dependencies (default)
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies
- try-post
- As post dependencies, with no error for failures
- discard
- Discard
- --dl-uninstalled-deps-runtime
- How to handle runtime dependencies for uninstalled packages
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed (default)
- post
- As post dependencies
- try-post
- As post dependencies, with no error for failures
- discard
- Discard
- --dl-uninstalled-deps-post
- How to handle post dependencies for uninstalled packages
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies (default)
- try-post
- As post dependencies, with no error for failures
- discard
- Discard
- --dl-uninstalled-deps-suggested
- How to handle suggested dependencies for uninstalled packages (only with --dl-suggested install)
- pre
- As pre dependencies
- pre-or-post
- As pre dependencies, or post dependencies where needed
- post
- As post dependencies (default)
- try-post
- As post dependencies, with no error for failures
- discard
- Discard
- --dl-suggested
- How to handle suggested dependencies
- show
- Display, but do not install (default)
- install
- Install
- discard
- Discard
- --dl-circular
- How to handle circular dependencies
- error
- Raise an error (default)
- discard
- Discard
- --dl-blocks
- How to handle blocks
- accumulate
- Accumulate and show in the dependency list (default)
- error
- Error straight away
- discard
- Discard (dangerous)
- --dl-override-masks
- Zero or more mask kinds that can be overridden as necessary (default: tilde-keyword and license)
- none
- None (overrides defaults, not user selections)
- tilde-keyword
- Keyword masks where accepting ~ would work
- unkeyworded
- Keyword masks where a package is unkeyworded
- repository
- Repository masks
- profile
- Deprecated synonym for repository
- license
- License masks
- --dl-fall-back
- When to fall back to installed packages
- as-needed-except-targets
- Where necessary, but not for target packages (default)
- as-needed
- Where necessary, including for target packages
- never
- Never
Environment
- RECONCILIO_OPTIONS
- Default command-line options.
Examples
reconcilio --pretend
Find and display any packages that appear to have broken linkage. (Requires read access to files to be checked, so best run as root.)
reconcilio --pretend --exact
The same, but try to reinstall exact versions, even if an upgrade is available.
reconcilio --pretend --library 'libXi.so.6
Find and display any packages that need a named library.