emirrordist - Man Page
a fetch tool for mirroring of package distfiles
Synopsis
emirrordist [options] <action>
Actions
- -h, ā--help
Show a help message and exit.
- --version
Display portage version and exit.
- --mirror
Mirror distfiles for the selected repository.
Options
- --dry-run
Perform a trial run with no changes made (typically combined with -v or -vv).
- -v, ā--verbose
Display extra information on stderr (multiple occurences increase verbosity).
- --ignore-default-opts
Do not use the EMIRRORDIST_DEFAULT_OPTS environment variable.
- --distfiles=DIR
Distfiles directory to use (required).
- -j JOBS, --jobs=JOBS
Number of concurrent jobs to run.
- -l LOAD, --load-average=LOAD
Load average limit for spawning of new concurrent jobs.
- --tries=TRIES
Maximum number of tries per file, 0 means unlimited (default is 10).
- --repo=REPO
Name of repo to operate on.
- --config-root=DIR
Location of portage config files.
- --repositories-configuration=REPOSITORIES_CONFIGURATION
Override configuration of repositories. The argument of this option has the same format as repos.conf (see portage(5)).
- --strict-manifests=<y|n>
Manually override "strict" FEATURES setting.
- --failure-log=FILE
Log file for fetch failures, with tab-delimited output, for reporting purposes. Opened in append mode.
- --success-log=FILE
Log file for fetch successes, with tab-delimited output, for reporting purposes. Opened in append mode.
- --scheduled-deletion-log=FILE
Log file for scheduled deletions, with tab-delimited output, for reporting purposes. Overwritten with each run.
- --delete
Enable deletion of unused distfiles.
- --deletion-db=FILE
Database file used to track lifetime of files scheduled for delayed deletion.
- --deletion-delay=SECONDS
Delay time for deletion of unused distfiles, measured in seconds.
- --temp-dir=DIR
Temporary directory for downloads.
- --mirror-overrides=FILE
File holding a list of mirror overrides.
- --mirror-skip=MIRROR_SKIP
Comma delimited list of mirror targets to skip when fetching.
- --restrict-mirror-exemptions=RESTRICT_MIRROR_EXEMPTIONS
Comma delimited list of mirror targets for which to ignore RESTRICT="mirror" (see ebuild(5)).
- --verify-existing-digest
Use digest as a verification of whether existing distfiles are valid.
- --distfiles-local=DIR
The distfiles-local directory to use.
- --distfiles-db=FILE
Database file used to track which ebuilds a distfile belongs to.
- --recycle-dir=DIR
Directory for extended retention of files that are removed from distdir with the --delete option. These files may be be recycled if they are needed again, instead of downloading them again.
- --recycle-db=FILE
Database file used to track lifetime of files in recycle dir.
- --recycle-deletion-delay=SECONDS
Delay time for deletion of unused files from recycle dir, measured in seconds (defaults to the equivalent of 60 days).
- --fetch-log-dir=DIR
Directory for individual fetch logs.
- --whitelist-from=FILE
Specifies a file containing a list of files to whitelist, one per line, # prefixed lines ignored. Use this option multiple times in order to specify multiple whitelists.
- --symlinks
Use symbolic links to link distfiles to the primary layout from other specified layouts. If not specified, hard links are used instead.
- --layout-conf=FILE
Specifies alternate mirror layout.conf file to use in order to select the desired distfile layout. If not specified, layout.conf in --distfiles directory will be used if present, otherwise flat layout will be assumed.
Reporting Bugs
Please report bugs via https://bugs.gentoo.org/
Thanks
Special thanks to Brian Harring, author of the mirror-dist program from which emirrordist is derived.
Authors
Zac Medico <zmedico@gentoo.org> Arfrever Frehtes Taifersar Arahesis <arfrever@apache.org>
Files
- /etc/portage/make.conf
Contains variables.