man/emirrordist.1

   1 .TH "EMIRRORDIST" "1" "Jul 2013" "Portage VERSION" "Portage"
   2 .SH "NAME"
   3 emirrordist \- a fetch tool for mirroring of package distfiles
   4 .SH SYNOPSIS
   5 .B emirrordist
   6 [\fIoptions\fR] \fI<action>\fR
   7 .SH ACTIONS
   8 .TP
   9 \fB\-h\fR, \fB\-\-help\fR
  10 Show a help message and exit.
  11 .TP
  12 \fB\-\-version\fR
  13 Display portage version and exit.
  14 .TP
  15 \fB\-\-mirror\fR
  16 Mirror distfiles for the selected repository.
  17 .SH OPTIONS
  18 .TP
  19 \fB\-\-dry\-run\fR
  20 Perform a trial run with no changes made (typically combined
  21 with \fI\-v\fR or \fI\-vv\fR).
  22 .TP
  23 \fB\-v\fR, \fB\-\-verbose\fR
  24 Display extra information on stderr (multiple occurences
  25 increase verbosity).
  26 .TP
  27 \fB\-\-ignore\-default\-opts\fR
  28 Do not use the \fIEMIRRORDIST_DEFAULT_OPTS\fR environment
  29 variable.
  30 .TP
  31 \fB\-\-distfiles\fR=\fIDIR\fR
  32 Distfiles directory to use (required).
  33 .TP
  34 \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fIJOBS\fR
  35 Number of concurrent jobs to run.
  36 .TP
  37 \fB\-l\fR LOAD, \fB\-\-load\-average\fR=\fILOAD\fR
  38 Load average limit for spawning of new concurrent jobs.
  39 .TP
  40 \fB\-\-tries\fR=\fITRIES\fR
  41 Maximum number of tries per file, 0 means unlimited
  42 (default is 10).
  43 .TP
  44 \fB\-\-repo\fR=\fIREPO\fR
  45 Name of repo to operate on.
  46 .TP
  47 \fB\-\-config\-root\fR=\fIDIR\fR
  48 Location of portage config files.
  49 .TP
  50 \fB\-\-portdir\fR=\fIDIR\fR
  51 Override the PORTDIR variable. This option is deprecated in favor of
  52 \-\-repositories\-configuration option.
  53 .TP
  54 \fB\-\-portdir\-overlay\fR=\fIPORTDIR_OVERLAY\fR
  55 Override the PORTDIR_OVERLAY variable. This option is deprecated in favor of
  56 \-\-repositories\-configuration option.
  57 .TP
  58 \fB\-\-repositories\-configuration\fR=\fIREPOSITORIES_CONFIGURATION\fR
  59 Override configuration of repositories. The argument of this option has
  60 the same format as repos.conf (see \fBportage\fR(5)).
  61 .TP
  62 \fB\-\-strict\-manifests=\fR<y|n>
  63 Manually override "strict" FEATURES setting.
  64 .TP
  65 \fB\-\-failure\-log\fR=\fIFILE\fR
  66 Log file for fetch failures, with tab\-delimited output, for
  67 reporting purposes. Opened in append mode.
  68 .TP
  69 \fB\-\-success\-log\fR=\fIFILE\fR
  70 Log file for fetch successes, with tab\-delimited output, for
  71 reporting purposes. Opened in append mode.
  72 .TP
  73 \fB\-\-scheduled\-deletion\-log\fR=\fIFILE\fR
  74 Log file for scheduled deletions, with tab\-delimited output, for
  75 reporting purposes. Overwritten with each run.
  76 .TP
  77 \fB\-\-delete\fR
  78 Enable deletion of unused distfiles.
  79 .TP
  80 \fB\-\-deletion\-db\fR=\fIFILE\fR
  81 Database file used to track lifetime of files scheduled for
  82 delayed deletion.
  83 .TP
  84 \fB\-\-deletion\-delay\fR=\fISECONDS\fR
  85 Delay time for deletion of unused distfiles, measured in seconds.
  86 .TP
  87 \fB\-\-temp\-dir\fR=\fIDIR\fR
  88 Temporary directory for downloads.
  89 .TP
  90 \fB\-\-mirror\-overrides\fR=\fIFILE\fR
  91 File holding a list of mirror overrides.
  92 .TP
  93 \fB\-\-mirror\-skip\fR=\fIMIRROR_SKIP\fR
  94 Comma delimited list of mirror targets to skip when
  95 fetching.
  96 .TP
  97 \fB\-\-restrict\-mirror\-exemptions\fR=\fIRESTRICT_MIRROR_EXEMPTIONS\fR
  98 Comma delimited list of mirror targets for which to ignore
  99 RESTRICT="mirror" (see \fBebuild\fR(5)).
 100 .TP
 101 \fB\-\-verify\-existing\-digest\fR
 102 Use digest as a verification of whether existing
 103 distfiles are valid.
 104 .TP
 105 \fB\-\-distfiles\-local\fR=\fIDIR\fR
 106 The distfiles\-local directory to use.
 107 .TP
 108 \fB\-\-distfiles\-db\fR=\fIFILE\fR
 109 Database file used to track which ebuilds a distfile belongs to.
 110 .TP
 111 \fB\-\-recycle\-dir\fR=\fIDIR\fR
 112 Directory for extended retention of files that are removed from
 113 distdir with the \-\-delete option. These files may be be recycled if
 114 they are needed again, instead of downloading them again.
 115 .TP
 116 \fB\-\-recycle\-db\fR=\fIFILE\fR
 117 Database file used to track lifetime of files in recycle dir.
 118 .TP
 119 \fB\-\-recycle\-deletion\-delay\fR=\fISECONDS\fR
 120 Delay time for deletion of unused files from recycle dir,
 121 measured in seconds (defaults to the equivalent of 60 days).
 122 .TP
 123 \fB\-\-fetch\-log\-dir\fR=\fIDIR\fR
 124 Directory for individual fetch logs.
 125 .TP
 126 \fB\-\-whitelist\-from\fR=\fIFILE\fR
 127 Specifies a file containing a list of files to whitelist, one per line,
 128 # prefixed lines ignored. Use this option multiple times in order to
 129 specify multiple whitelists.
 130 .SH "REPORTING BUGS"
 131 Please report bugs via http://bugs.gentoo.org/
 132 .SH "THANKS"
 133 Special thanks to Brian Harring, author of the mirror\-dist program from
 134 which emirrordist is derived.
 135 .SH "AUTHORS"
 136 .nf
 137 Zac Medico <zmedico@gentoo.org>
 138 Arfrever Frehtes Taifersar Arahesis <arfrever@apache.org>
 139 .fi
 140 .SH "FILES"
 141 .TP
 142 .B /etc/portage/make.conf
 143 Contains variables.
 144 .SH "SEE ALSO"
 145 .BR ebuild (5),
 146 .BR egencache (1),
 147 .BR make.conf (5),
 148 .BR portage (5)