Gentoo Archives: gentoo-commits

From: "Zac Medico (zmedico)" <zmedico@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] portage r13449 - main/branches/2.1.6/man
Date: Thu, 30 Apr 2009 06:54:42
Message-Id: E1LzQAK-0005Fv-R4@stork.gentoo.org
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)