1 |
Author: zmedico |
2 |
Date: 2009-04-30 06:54:40 +0000 (Thu, 30 Apr 2009) |
3 |
New Revision: 13449 |
4 |
|
5 |
Added: |
6 |
main/branches/2.1.6/man/egencache.1 |
7 |
Log: |
8 |
Add a man page for egencache(1). (trunk r13270) |
9 |
|
10 |
Copied: main/branches/2.1.6/man/egencache.1 (from rev 13270, main/trunk/man/egencache.1) |
11 |
=================================================================== |
12 |
--- main/branches/2.1.6/man/egencache.1 (rev 0) |
13 |
+++ main/branches/2.1.6/man/egencache.1 2009-04-30 06:54:40 UTC (rev 13449) |
14 |
@@ -0,0 +1,69 @@ |
15 |
+.TH "EGENCACHE" "1" "March 2009" "Portage 2.2" "Portage" |
16 |
+.SH "NAME" |
17 |
+egencache \- generate metadata cache for ebuild repositories |
18 |
+.SH "SYNOPSIS" |
19 |
+.B egencache |
20 |
+.I [options] --update [ATOM]\fR... |
21 |
+.SH "DESCRIPTION" |
22 |
+The egencache program generates metadata cache for ebuild repositories. |
23 |
+.SH "ATOMS" |
24 |
+An optional list of specific package atoms to update. If no package atoms are |
25 |
+specified then all will be updated. See ebuild(5) for the details on package |
26 |
+atom syntax. |
27 |
+.SH OPTIONS |
28 |
+.TP |
29 |
+.BR "\-\-cache\-dir=CACHE_DIR" |
30 |
+Location of the metadata cache. |
31 |
+.br |
32 |
+Defaults to /var/cache/edb/dep. |
33 |
+.TP |
34 |
+.BR "\-\-config\-root=CONFIG_ROOT" |
35 |
+Location of portage config files. |
36 |
+.br |
37 |
+Defaults to /. |
38 |
+.TP |
39 |
+.BR "\-\-ignore-default-opts" |
40 |
+Causes \fIEGENCACHE_DEFAULT_OPTS\fR to be ignored. |
41 |
+.TP |
42 |
+.BR "\-\-jobs=JOBS" |
43 |
+Specifies the maximum number of ebuild processes to spawn simultaneously. |
44 |
+Also see the related \fB\-\-load\-average\fR option. |
45 |
+.TP |
46 |
+.BR \-\-load\-average=LOAD |
47 |
+Specifies that maximum load allowed when spawning multiple jobs. |
48 |
+.TP |
49 |
+.BR "\-\-rsync" |
50 |
+When used together with the \fB\-\-update\fR options, this enables a workaround |
51 |
+for cases in which the content of a cache entry changes and neither the file |
52 |
+mtime nor size changes, preventing rsync from detecting changes. Such cases are |
53 |
+handled by bumping the mtime on the ebuild (and the corresponding cache entry). |
54 |
+This option should only be needed for distribution via something like |
55 |
+\fBrsync\fR(1), which relies on timestamps and file sizes to detect changes |
56 |
+(see \fBbug 139134\fR). It's not needed with \fBgit\fR(1) since that uses a |
57 |
+more thorough mechanism which allows it to detect changed inode numbers |
58 |
+(described in \fIracy-git.txt\fR in the git technical docs). |
59 |
+.TP |
60 |
+.BR "\-\-update [ATOM] ... " |
61 |
+Update the \fImetadata/cache/\fR directory (generate metadata as necessary). |
62 |
+If no package atoms are specified then all will be updated. |
63 |
+.SH "ENVIRONMENT OPTIONS" |
64 |
+.TP |
65 |
+\fBEGENCACHE_DEFAULT_OPTS\fR |
66 |
+If this variable is set in \fBmake.conf\fR(5) then any options that it |
67 |
+contains will be added to the beginning of the command line on every |
68 |
+invocation. These options will not be added if the |
69 |
+\fB\-\-ignore-default\-opts\fR option is specified. |
70 |
+.SH "REPORTING BUGS" |
71 |
+Please report bugs via http://bugs.gentoo.org/ |
72 |
+.SH "AUTHORS" |
73 |
+.nf |
74 |
+Zac Medico <zmedico@g.o> |
75 |
+.fi |
76 |
+.SH "FILES" |
77 |
+.TP |
78 |
+.B /etc/make.conf |
79 |
+Contains variables. |
80 |
+.SH "SEE ALSO" |
81 |
+.BR emerge (1), |
82 |
+.BR make.conf (5), |
83 |
+.BR portage (5) |