/[gentoo]/xml/htdocs/doc/en/gentoolkit.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoolkit.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.8 Revision 1.23
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.8 2004/03/06 17:06:19 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.23 2006/11/02 18:41:52 nightmorph Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link = "/doc/en/gentoolkit.xml"> 5<guide link="/doc/en/gentoolkit.xml">
6<title>Gentoolkit</title> 6<title>Gentoolkit</title>
7<author title="Author"><mail link="mbutcher@aleph-null.tv"> 7
8Matt Butcher</mail> 8<author title="Author">
9 <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail>
9</author> 10</author>
10 11<author title="Editor">
11<author title="Editor"><!-- zhen@gentoo.org --> 12 <!-- zhen@gentoo.org -->John P. Davis
12 John P. Davis
13</author> 13</author>
14<author title="Editor"> 14<author title="Editor">
15 <mail link="erwin@gentoo.org">Erwin</mail> 15 <mail link="erwin@gentoo.org">Erwin</mail>
16</author> 16</author>
17<author title="Editor">
18 <mail link="fox2mike@gentoo.org">Shyam Mani</mail>
19</author>
20<author title="Editor">
21 <mail link="neysx@gentoo.org">Xavier Neys</mail>
22</author>
23<author title="Editor">
24 <mail link="karltk@gentoo.org">Karl Trygve</mail>
25</author>
26<author title="Editor">
27 <mail link="yoswink@gentoo.org">José Luis Rivero</mail>
28</author>
29
30<abstract>
31Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
32This document covers the basics of some of the tools present in Gentoolkit.
33</abstract>
34
17<!-- Licensed under GFDL --> 35<!-- Licensed under GFDL -->
18 36
19<abstract>
20 Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
21 This document covers the basics of
22 some of the tools present in Gentoolkit.
23</abstract>
24
25<version>1.2</version> 37<version>1.9</version>
26<date>December 1, 2003</date> 38<date>2006-11-02</date>
27 39
28<chapter> 40<chapter>
29 <title>Introduction</title> 41<title>Introduction</title>
30 <section> 42<section>
31 <title>What is Gentoolkit?</title> 43<title>What is Gentoolkit?</title>
32 <body> 44<body>
45
46<p>
33 <p>Gentoo is a unique distribution, and presents some complexities that 47Gentoo is a unique distribution and presents some complexities that simply
34 simply don't exist for other distributions. As Gentoo developers 48don't exist for other distributions. As Gentoo developers and contributors
35 and contributors discovered some of these complexities, they also 49discovered some of these complexities, they also wrote tools to help users and
36 wrote tools to help users and administrators work around them. 50administrators work around them. Many of these tools have been contributed to
37 Many of these tools have been contributed to the Gentoo project, 51the Gentoo project and are included in the package
38 and are included in the package <path>app-portage/gentoolkit</path>. 52<c>app-portage/gentoolkit</c>.
39 </p> 53</p>
40 54
55<note>
56As of now, there are two versions of gentoolkit: <c>app-portage/gentoolkit</c>
57and <c>app-portage/gentoolkit-dev</c>. While the former contains administration
58scripts, the latter contains scripts specific to help development on Gentoo.
59If you are a developer, you can have your scripts included into
60<c>gentoolkit-dev</c> by contacting the Gentoolkit maintainer. This document
61discusses gentoolkit only.
62</note>
63
64<p>
41 <p>Gentoolkit contains a whole bunch of useful tools to help manage 65Gentoolkit contains a whole bunch of useful tools to help manage your packages
42 Portage and the ebuild architecture. Most users -- particularly 66and keep track of what is going on in your system. Most users --&nbsp;particularly
43 those who update systems often -- will benefit from having 67those who update systems often&nbsp;-- will benefit from having gentoolkit
44 gentoolkit installed.</p> 68installed.
69</p>
70
45 </body> 71</body>
46 </section> 72</section>
47 <section> 73<section>
48 <title>Installation</title> 74<title>Installation</title>
49 <body> 75<body>
76
77<p>
50 <p>Just as with any Gentoo package, installation is just a simple 78Just as with any Gentoo package, installation is just a simple emerge.
51 emerge. 79</p>
52 </p>
53 80
54 <pre> 81<pre caption="Getting gentoolkit">
55<i>emerge gentoolkit </i> 82# <i>emerge gentoolkit</i>
56 </pre> 83</pre>
84
85<note>
57 <note>Many of the tools in gentoolkit reveal important information 86Many of the tools in gentoolkit reveal important information about your system
58 about your system or require root permissions. For that reason, 87or require root privilege. For that reason, some of the programs may only be
59 some of the programs may only be executed (or only function 88executed (or only function properly) if run by a user with root permission.
60 properly) if run by a user with root permissions.</note> 89</note>
90
61 </body> 91</body>
62 </section> 92</section>
63 <section> 93<section>
64 <title>Finding Documentation</title> 94<title>Finding Documentation</title>
65 <body> 95<body>
66 96
67 <p> 97<p>
68 At the time of this writing, not all of the programs in gentoolkit
69 are well documented. Some have man pages, but not all. Any documentation
70 that a program might have (other than man pages) is stored in 98Any documentation that a program might have (other than man pages) is stored in
71 <path>/usr/doc/gentoolkit-[version]/[program-name]/</path>. 99<path>/usr/doc/gentoolkit-[version]/[program-name]/</path>.
72 </p> 100</p>
101
73 </body> 102</body>
74 </section> 103</section>
75</chapter> 104</chapter>
105
76<chapter> 106<chapter>
77 <title>Querying Package Data with qpkg</title> 107<title>equery</title>
78 <section> 108<section>
79
80 <title>Introduction</title> 109<title>Introduction</title>
81 <body> 110<body>
82 <p><c>qpkg</c> is flexible tool for determining information about ebuilds,
83 whether installed or not. It can provide information about what files belong
84 to which ebuilds, whether multiple versions of the same package are installed,
85 and what a particular ebuild does.
86 </p>
87 <p>Calling <c>qpkg</c> with no arguments prints a list of all ebuilds, with asterisks
88 (*) next to the packages that are installed on the system.
89 </p>
90 <note>By default, <c>qpkg</c> prints output in color. To turn this off on the command
91 line, use the <c>--no-color</c> or <c>-nc</c> flag.</note>
92 111
112<p>
113<c>equery</c> is a tool that supports some features of <c>epm</c> (and the
114deprecated <c>qpkg</c>) together with its own set of features that make it
115really useful. <c>equery --help</c> gives you the full set of options.
116<c>equery</c> will eventually replace <c>etcat</c> in a future release of
117Gentoolkit.
118</p>
119
120<note>
121Not all features listed by <c>equery --help</c> have been implemented yet.
122Those that have not been, are mentioned clearly. You will also see that
123every command has a short option, e.g. <c>b</c> instead of <c>belongs</c>.
124</note>
125
126<note>
127Be aware that equery currently changes the format of the output if it is
128sent through a pipe. The piped format is intended to be easier to parse by
129tools, but has turned out to be less popular and will probably change in
130the future. If you write scripts that employ equery, you should be aware
131of this.
132</note>
133
93 </body> 134</body>
94 </section> 135</section>
95 <section> 136<section>
96 <title>Querying Package Information</title> 137<title>Finding the Package That a File Came From</title>
97 <body> 138<body>
98 <p>One of the most common uses for <c>qpkg</c> is determining what a given package
99 is. For instance, while looking through <path>net-misc</path>, I saw a package
100 called <path>neon</path>. Having no idea what it was, I ran qpkg.
101 </p>
102 139
103 <pre> 140<p>
104hebron root # <i>qpkg -i net-misc/neon 141<c>equery</c> also provides the functionality of finding the package that a
105net-misc/neon-0.15.3-r1 142file came from, using <c>belongs</c> command (or just <c>b</c>).
106 HTTP and WebDAV client library [ http://www.webdav.org/neon ] 143</p>
107net-misc/neon-0.18.5 144
108 HTTP and WebDAV client library [ http://www.webdav.org/neon ] 145<pre caption="Finding the ebuild that installed a given file">
109net-misc/neon-0.19.2 146# <i>equery belongs /usr/bin/audacious</i>
110 HTTP and WebDAV client library [ http://www.webdav.org/neon ] 147[ Searching for file(s) /usr/bin/audacious in *... ]
111net-misc/neon-0.19.2-r1 148media-sound/audacious-1.1.2 (/usr/bin/audacious)
112 HTTP and WebDAV client library [ http://www.webdav.org/neon ]
113net-misc/neon-0.21.1
114 HTTP and WebDAV client library [ http://www.webdav.org/neon ] </i>
115 </pre> 149</pre>
116 <p> 150
117 <c>qpkg</c> read through the ebuild files for the five <path>net-misc/neon</path> 151<p>
118 ebuilds and printed out the information stored in DESCRIPTION and HOMEPAGE. 152By using the <c>-f</c> option, you may search for packages with files
119 </p> 153matching any regular expression. The <c>-e</c> option is useful for
154terminating your search immediately when a match is found.
155</p>
156
120 </body> 157</body>
121
122 </section> 158</section>
123 <section> 159<section>
160<title>Verifying Package Integrity</title>
161<body>
162
163<p>
164Sometimes it is useful to check a package's integrity. <c>equery</c> can
165verify md5 sums as well as timestamps to indicate when a package might
166have been corrupted, replaced, or removed.
167</p>
168
169<pre caption="OK package integrity">
170# <i>equery check gentoolkit</i>
171[ Checking app-portage/gentoolkit-0.2.0 ]
172 * 54 out of 54 files good
173</pre>
174
175<p>
176Please note that if you change configuration files after installation,
177these may be reported as "not good".
178</p>
179
180</body>
181</section>
182<section>
183<title>List of all packages depending on ...</title>
184<body>
185
186<p>
187<c>equery</c> is able to list all direct dependencies matching a package.
188The function we should use to do this is <c>depends</c> and it's as easy as:
189</p>
190
191<pre caption="Looking for packages depending on pygtk">
192# <i>equery depends pygtk</i>
193[ Searching for packages depending on pygtk... ]
194app-office/dia-0.93
195dev-python/gnome-python-2.0.0-r1
196gnome-extra/gdesklets-core-0.26.2
197media-gfx/gimp-2.0.4
198x11-libs/vte-0.11.11-r1
199</pre>
200
201</body>
202</section>
203<section>
204<title>Dependency Graphs</title>
205<body>
206
207<p>
208<c>equery</c> is capable of giving us a dependency graph for a specified
209package. The dependency graph gives a listing of all the packages that have
210direct and indirect dependencies on the package in question.
211</p>
212
213<pre caption="Dependency Graph for cdrtools">
214# <i>equery depgraph cdrtools</i>
215Displaying dependencies for app-cdr/cdrtools-2.01_alpha37
216`-- app-cdr/cdrtools-2.01_alpha37
217 `-- sys-libs/glibc-2.3.4.20040808 (virtual/libc)
218 `-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers)
219 `-- sys-apps/baselayout-1.10.4
220 `-- sys-apps/sysvinit-2.85-r1
221 `-- sys-apps/gawk-3.1.3-r1
222 `-- sys-apps/util-linux-2.12-r4
223 `-- sys-apps/sed-4.0.9
224 `-- sys-libs/ncurses-5.4-r4
225 `-- sys-apps/pam-login-3.14
226 `-- sys-libs/pam-0.77-r1
227 `-- sys-libs/cracklib-2.7-r10
228 `-- sys-apps/miscfiles-1.3-r1
229 `-- app-arch/gzip-1.3.5-r1
230 `-- sys-apps/portage-2.0.50-r10
231</pre>
232
233<p>
234For example, while glibc is a direct dependency for cdrtools,linux-headers
235are an indirect dependency. Note that the output also includes information
236about virtual packages. In the example above, <c>cdrtools</c> is actually
237written to require virtual/libc, not sys-libs/glibc, but on the given
238system in the example sys-libs/glibc provides virtual/libc.
239</p>
240
241</body>
242</section>
243<section>
124 <title>Listing Files Belonging to an Ebuild</title> 244<title>Listing Files Belonging to an Ebuild</title>
125 <body> 245<body>
126 <p> 246
247<p>
127 <c>qpkg</c> can also list the files that belong to an installed ebuild. I 248<c>equery</c> can list the files that belong to an installed ebuild. If I
128 Know that gentoolkit installed several tools, but I don't know what they 249don't know the files that Gentoolkit has installed on the system, I will
129 all are. To find out, I can do a <c>qpkg -l</c> 250use <c>equery</c> to show them.
251</p>
130 252
131 </p> 253<pre caption="Listing files">
132 <pre> 254#<i> equery files gentoolkit</i>
133hebron portage # <i>qpkg -l app-portage/gentoolkit 255[ Searching for packages matching gentoolkit... ]
134app-portage/gentoolkit-0.1.14-r1 * 256app-portage/gentoolkit-0.2.0
135CONTENTS: 257* Contents of app-portage/gentoolkit-0.2.0:
136/usr 258/usr
259/usr/bin
260/usr/bin/equery
261/usr/bin/etcat
262/usr/bin/euse
263/usr/bin/glsa-check
264/usr/bin/qpkg
265/usr/bin/revdep-rebuild
266/usr/lib
267/usr/lib/gentoolkit
268/usr/lib/gentoolkit/pym
269/usr/lib/gentoolkit/pym/gentoolkit
270/usr/lib/gentoolkit/pym/gentoolkit/__init__.py
271/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py
272/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py
273/usr/lib/gentoolkit/pym/glsa.py
274/usr/sbin
137/usr/share 275/usr/share
138/usr/share/gentoolkit
139/usr/share/gentoolkit/histogram.awk
140/usr/share/doc 276/usr/share/doc
141/usr/share/doc/gentoolkit-0.1.14-r1 277/usr/share/doc/gentoolkit-0.2.0_pre10
142/usr/share/doc/gentoolkit-0.1.14-r1/gentool 278
143/usr/share/doc/gentoolkit-0.1.14-r1/gentool/ChangeLog.gz 279[...]
144/usr/share/doc/gentoolkit-0.1.14-r1/lintool
145/usr/share/doc/gentoolkit-0.1.14-r1/lintool/checklist-for-ebuilds.gz
146/usr/share/doc/gentoolkit-0.1.14-r1/lintool/ChangeLog.gz
147/usr/share/doc/gentoolkit-0.1.14-r1/etc-update
148/usr/share/doc/gentoolkit-0.1.14-r1/etc-update/ChangeLog.gz
149/usr/share/man
150/usr/share/man/man1
151/usr/share/man/man1/qpkg.1.gz
152/usr/share/man/man1/lintool.1.gz
153/usr/share/man/man1/etc-update.1.gz
154/usr/bin
155/usr/bin/gentool-bump-revision
156/usr/bin/gentool-total-coverage
157/usr/bin/gentool-author-coverage
158/usr/bin/gentool-package-count
159/usr/bin/qpkg
160/usr/bin/pkg-size
161/usr/bin/lintool
162/usr/sbin
163/usr/sbin/pkg-clean
164/usr/sbin/mkebuild
165/usr/sbin/emerge-webrsync
166/usr/sbin/epm
167/usr/sbin/etc-update
168/etc
169/etc/etc-update.conf </i>
170 </pre> 280</pre>
281
282<p>
283The command <c>files</c> of <c>equery</c> provide some options to modify
284the output. You can look them all up in the <c>equery</c> man page.
285</p>
286
171 </body> 287</body>
172 </section> 288</section>
173 <section> 289<section>
174 <title>Finding the Package from Where a File Came</title> 290<title>Looking for packages that use a specific USE flag</title>
175 <body> 291<body>
176 292
177 <p> 293<p>
178 To find the package that a file came from, use the <c>-f</c> 294If you want to find which packages on your system that make use of a specific
179 or <c>--find-file</c> flag. 295USE flag, <c>equery</c> has the function <c>hasuse</c>:
180 </p> 296</p>
181 <pre> 297
182 hebron portage # <i>qpkg -f net-www/mozilla * </i> 298<pre caption="Searching packages which use mozilla USE flag">
299# <i>equery hasuse mozilla</i>
300[ Searching for USE flag mozilla in all categories among: ]
301 * installed packages
302[I--] [ ] dev-java/blackdown-jre-1.4.2.01 (1.4.2)
303[I--] [ ] mail-client/evolution-2.0.2 (2.0)
183 </pre> 304</pre>
184 305
185 </body> 306</body>
186 </section> 307</section>
187 <section> 308<section>
188 <title>Listing Duplicate Packages</title> 309<title>Listing Packages</title>
189 <body> 310<body>
190 <p>
191 Sometimes multiple versions of the same package may exist. <c>qpkg --dup</c>
192 311
193 will print a list of duplicate packages. The existence of a duplicate package 312<p>
194 though may not indicate that the older version may be removed. They may fill 313<c>equery</c> has a power feature to list packages belonging to our system,
195 different slots. To look for duplicates in the same slot, use 314portage or even an overlay. Let's try this:
196 <c>qpkg --dups --slot</c>. I just updated KDE from 3.0 to 3.0.2, so I have some 315</p>
197 duplicates in the same slot. 316
198 </p> 317<pre caption="Listing packages with equery">
199 <pre> 318# <i>equery list gentoolkit</i>
200hebron portage # <i>qpkg --dups --slot 319[ Searching for package 'gentoolkit' in all categories among: ]
201app-portage/gentoolkit 320 * installed packages
202kde-base/kdeaddons 321[I--] [ ] app-portage/gentoolkit-0.2.0 (0)
203kde-base/kdeadmin
204kde-base/kdeartwork
205kde-base/kdebase
206kde-base/kdegames
207kde-base/kdelibs
208kde-base/kdemultimedia
209kde-base/kdenetwork
210kde-base/kdetoys
211kde-base/kdeutils
212media-libs/freetype
213x11-libs/qt </i>
214 </pre> 322</pre>
323
324<p>
325The standard query will search our installed packages for the name given.
326If found, the following info will be displayed: the package location between
327the first square brackets (I for Installed packages, P for Portage, O for
328Overlay), the possibles masks between the second (~ by keyword, - by arch or
329M hard masked), then the category and complete name and last of all, the slot
330in which the package is stored.
331</p>
332
333<p>
334Another example, this time we are going to use the local options in order
335to look for packages in our portage tree and overlay.
336</p>
337
338<pre caption="Using local options with equery">
339# <i>equery list -p -o vim</i>
340[ Searching for package 'vim' in all categories among: ]
341 * installed packages
342[I--] [ ] app-editors/vim-6.3-r4 (0)
343 * Portage tree (/usr/portage)
344[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0)
345[-P-] [M~] app-editors/vim-7.0_alpha20050201 (0)
346[-P-] [ ] app-editors/vim-6.3-r2 (0)
347[-P-] [M~] app-editors/vim-7.0_alpha20050122 (0)
348[-P-] [M~] app-editors/vim-core-7.0_alpha20050126 (0)
349[-P-] [ ] app-editors/vim-core-6.3-r3 (0)
350[-P-] [M~] app-editors/vim-core-7.0_alpha20050122 (0)
351[-P-] [M~] app-editors/vim-core-7.0_alpha20050201 (0)
352[-P-] [ ] app-editors/vim-core-6.3-r4 (0)
353 * overlay tree (/opt/ebuilds)
354</pre>
355
215 </body> 356</body>
216 </section> 357</section>
217 <section> 358<section>
218 <title>Verifying Package Integrity</title> 359<title>Finding Package Sizes</title>
219
220 <body> 360<body>
221 <p>
222 Sometimes it is useful to check a package's integrity to know that files
223 have not been replaced since they were installed. <c>qpkg</c> can
224 verify md5 sums as well as install times to indicate whether or not files
225 for the package might have been corrupted, replaced, or removed.
226 </p>
227 <p>To check both mtimes and md5 sums, use the <c>-c</c> flag.</p>
228 <pre>
229 361
230hebron portage # <i>qpkg gnupg -c -v 362<p>
231app-crypt/gnupg-1.0.6 * 363Ever been curious to find out how much space a specific package is occupying?
232/usr/lib/gnupg/rndunix !md5! !mtime! 364Since a package could have its files over a number of directories, the usual
233/usr/lib/gnupg/rndegd !md5! !mtime! 365<c>du -hc</c> might not give you the correct figure. Not to worry, here comes
234/usr/lib/gnupg/tiger !md5! !mtime! 366<c>equery</c> to the rescue!
235/usr/bin/gpg !md5! !mtime! 367</p>
236/usr/bin/gpgv !md5! !mtime!
237/usr/share/gnupg/options.skel !md5! !mtime!
238/usr/share/gnupg/FAQ !md5! !mtime!
239/usr/share/gnupg/faq.html !md5! !mtime!
240/usr/share/locale/da/LC_MESSAGES/gnupg.mo !md5! !mtime!
241/usr/share/locale/de/LC_MESSAGES/gnupg.mo !md5! !mtime!
242/usr/share/locale/eo/LC_MESSAGES/gnupg.mo !md5! !mtime!
243/usr/share/locale/et/LC_MESSAGES/gnupg.mo !md5! !mtime!
244/usr/share/locale/fr/LC_MESSAGES/gnupg.mo !md5! !mtime!
245/usr/share/locale/id/LC_MESSAGES/gnupg.mo !md5! !mtime!
246/usr/share/locale/it/LC_MESSAGES/gnupg.mo !md5! !mtime!
247/usr/share/locale/ja/LC_MESSAGES/gnupg.mo !md5! !mtime!
248/usr/share/locale/nl/LC_MESSAGES/gnupg.mo !md5! !mtime!
249/usr/share/locale/pl/LC_MESSAGES/gnupg.mo !md5! !mtime!
250/usr/share/locale/pt_BR/LC_MESSAGES/gnupg.mo !md5! !mtime!
251/usr/share/locale/sv/LC_MESSAGES/gnupg.mo !md5! !mtime!
252/usr/share/locale/tr/LC_MESSAGES/gnupg.mo !md5! !mtime!
253/usr/share/info/gpgv.info.gz !md5! !mtime!
254/usr/share/man/man1/gpg.1.gz !md5! !mtime!
255/usr/share/man/man1/gpgv.1.gz !md5! !mtime!
25624/92
257 368
258app-crypt/gnupg-1.0.7 * 369<pre caption="Package Size">
2590/101 </i> 370# <i>equery size openoffice-bin</i>
371* app-office/openoffice-bin-1.1.2
372 Total Files : 2908
373 Total Size : 223353.31 KiB
260 </pre> 374</pre>
261 <p>
262 As you can see, I have more than one version of GnuPG installed. <c>qpkg</c>
263 reports that many of the files from the older version have been changed since I
264 installed it. Those packages were most likely modified when I updated
265 from <path>gnupg-1.0.6</path> to <path>gnupg-1.0.7</path>. Note that the last two
266lines indicate
267 that 0 of 101 files from <path>gnupg-1.0.7</path> have been changed since I
268installed. That
269 is good. If any of them had been changed, I would be worried.
270 </p>
271 375
376<p>
377As you can see, <c>equery</c> prints the total space used in kilobytes and
378also lists the total number of files the package has.
379</p>
380
272 </body> 381</body>
273 </section> 382</section>
274 <section> 383<section>
275 <title>But Wait... There's More</title> 384<title>Package-wise list of USE Flags</title>
276 <body> 385<body>
277 <p>
278 <c>qpkg</c> can be used for other querying tasks that I will not go over here. There
279is a very complete
280 manpage for <c>qpkg</c>. Consult that for more information.
281 </p>
282 386
387<p>
388<c>equery</c> can be used to give us information about what USE flags
389are being used by a specific package. It also tells us what our current USE
390flags are for a package and also what USE flags are available for the package.
391</p>
392
393<pre caption="Set and Unset USE Flags">
394# <i>equery uses ethereal</i>
395[ Colour Code : set unset ]
396[ Legend : (U) Col 1 - Current USE flags ]
397[ : (I) Col 2 - Installed With USE flags ]
398
399 U I [ Found these USE variables in : net-analyzer/ethereal-0.10.6 ]
400 - - adns : Adds support for the adns DNS client library
401 + + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit)
402 - - ipv6 : Adds support for IP version 6
403 - - snmp : Adds support for the Simple Network Management Protocol if available
404 + + ssl : Adds support for Secure Socket Layer connections
405 + + gtk2 : Use gtk+-2.0.0 over gtk+-1.2 in cases where a program supports both.
406 - - debug : Tells configure and the makefiles to build for debugging. Effects vary across packages,
407 but generally it will at least add -g to CFLAGS. Remember to set FEATURES=nostrip too
408</pre>
409
410<p>
411I have installed ethereal with only the gtk, ssl and gtk2 flags set, but the
412other USE flags for ethereal are adns, ipv6, snmp and debug. For more
413information on USE flags, please refer to the <uri
414link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri>
415chapter of the <uri link="/doc/en/handbook/">Gentoo Handbook</uri>.
416</p>
417
283 </body> 418</body>
284 </section> 419</section>
420<section>
421<title>Where's the ebuild?</title>
422<body>
423
424<p>
425We can also find out which ebuild is being used for a specific package using
426<c>equery</c>. This is done my using the <c>equery which</c> command which
427displays the full path to the ebuild.
428</p>
429
430<pre caption="Displaying the ebuild path">
431# <i>equery which cdrtools</i>
432/usr/portage/app-cdr/cdrtools/cdrtools-2.01_alpha37.ebuild
433</pre>
434
435</body>
436</section>
285</chapter> 437</chapter>
438
286<chapter> 439<chapter>
287 <title>lintool</title> 440<title>euse</title>
288 <section> 441<section>
289 <title>Introduction</title> 442<title>Introduction</title>
290 <body> 443<body>
291 <p>
292 444
293 <c>lintool</c> is a program that checks ebuild scripts for conformance to 445<warn>
294 standards and requirements. It is important for ebuild developers to use <c>lintool</c> 446<c>euse</c> is currently broken as it does not support cascading profiles well.
295 to ensure that they are doing things correctly and not requiring the core team 447</warn>
296 to do more than they already have to in order to include the ebuild in the Gentoo 448
297 repository. 449<p>
298 </p> 450<c>euse</c> is a tool to see, set and unset USE flags at various places. For
451more information on USE flags, please refer to the <uri
452link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri>.
453Please see <c>euse -h</c> for complete help and all options.
454</p>
455
299 </body> 456</body>
300 </section> 457</section>
301 <section> 458<section>
302 <title>Use</title> 459<title>Viewing, Setting and Unsetting USE Flags</title>
303
304 <body> 460<body>
305 <p>
306 Running <c>lintool</c> will produce a nicely formatted list of checks and results that
307 it performs.
308 </p>
309 <pre>
310hebron portage # <i>lintool app-crypt/gnupg/gnupg-1.0.7.ebuild
311app-crypt/gnupg/gnupg-1.0.7.ebuild : Not OK
312 461
313------------------------------------------------------------------------------- 462<p>
314 Summary for all 1 ebuild(s) checked # errors/warns 463The <c>euse -a</c> command reads the current active USE flags and displays
315 ------------------------------------------------------------------------------- 464them.
316 Testing for illegal space characters, weird backslash formatting : 0 / 0 465</p>
317 Testing for malformed headers : 0 / 1
318 Testing for occurence of deprecated try : 0 / 0
319 Testing for superfluous A=${P}.tar.gz : 0 / 0
320 Testing for empty DEPEND : 0 / 0
321 Testing for empty HOMEPAGE : 0 / 0
322 Testing for empty DESCRIPTION : 0 / 0
323 Testing for presence of env vars : 1 / 1
324 Testing for sane USE flag usage : 0 / 0
325 466
326 Total number of ebuilds with errors : 1 (100%) 467<note>
327 Total number of ebuilds with warnings : 1 (100%) 468There are 5 &quot;columns&quot; that <c>euse</c> now uses to show whether a
328 </i> </pre> 469flag is set/unset and where all the flag has been set. The columns are as
329 <p> 470follows -- +/-, set in the Environment, set in make.Conf, set in make.Defaults,
330 The first line summarizes whether the ebuild is okay or not. In the case of 471and set in make.Globals. The output looks like [+ECDG].
331 <c>gnupg-1.0.7.ebuild</c>, it's not. Reading through the list of checks, we can see 472</note>
332 that it got a warning for malformed headers and an error for presence of env
333 vars.
334 </p>
335 473
336 <p> 474<pre caption="Viewing all active USE flags">
337 Looking at the ebuild, I see that it is missing a couple of required 475# <i> euse -a</i>
338 env vars (LICENSE and RDEPEND). Adding those fixes the error. But there are 476X [+ CD ]
339 still two warnings -- one for malformed headers and one for env vars. To help 477aalib [+ ]
340 me find those, I can run <c>lintool</c> again with <c>--show-details</c> 478acpi [+ C ]
341 </p> 479alsa [+ C ]
342 <pre> 480apache2 [+ C ]
343hebron gnupg # <i>lintool --show-details ./gnupg-1.0.7.ebuild 481apm [+ D ]
344 482avi [+ D ]
345------------------------------------------------------------------------------- 483berkdb [+ D ]
346# Some data cut for brevity.... 484bitmap-fonts [+ D ]
485bonobo [+ ]
486cdr [+ C ]
487crypt [+ CD ]
488cscope [+ C ]
489cups [+ CD ]
490curl [+ ]
491emboss [+ D ]
492encode [+ D ]
493esd [+ ]
494ethereal [+ C ]
495fam [+ ]
496fbcon [+ C ]
497font-server [+ D ]
498foomaticdb [+ D ]
499fortran [+ D ]
500gd [+ C ]
501gdbm [+ D ]
502gif [+ CD ]
503gimpprint [+ C ]
504gnome [+ CD ]
505gphoto2 [+ ]
506gpm [+ CD ]
507gstreamer [+ C ]
508gtk [+ D ]
509gtk2 [+ CD ]
510gtkhtml [+ C ]
511guile [+ ]
512imagemagick [+ ]
513imlib [+ CD ]
514imlib2 [+ ]
515innodb [+ ]
516ipv6 [+ D ]
517javascript [+ C ]
518jpeg [+ CD ]
519kde [+ D ]
520ldap [+ ]
521libg++ [+ CD ]
522libwww [+ CD ]
523mad [+ CD ]
524mbox [+ C ]
525md5sum [+ C ]
526mikmod [+ CD ]
527mmx [+ C ]
528motif [+ CD ]
529mozilla [+ C ]
530mp3 [+ ]
531mpeg [+ CD ]
532mpeg4 [+ C ]
533mysql [+ C ]
534ncurses [+ CD ]
535nls [+ D ]
536nvidia [+ C ]
537odbc [+ ]
538offensive [+ ]
539oggvorbis [+ CD ]
540opengl [+ CD ]
541oss [+ D ]
542pam [+ CD ]
543pdflib [+ CD ]
544perl [+ CD ]
545png [+ CD ]
546python [+ CD ]
547qt [+ D ]
548quicktime [+ CD ]
549readline [+ CD ]
550ruby [+ ]
551sdl [+ CD ]
552slang [+ D ]
553spell [+ CD ]
554sse [+ C ]
555ssl [+ CD ]
556svga [+ CD ]
557tcltk [+ C ]
558tcpd [+ D ]
559tiff [+ C ]
560truetype [+ CD ]
561truetype-fonts [+ D ]
562type1-fonts [+ D ]
563usb [+ C ]
564vanilla [+ C ]
565x86 [+ C ]
566xml [+ ]
567xml2 [+ D ]
568xosd [+ C ]
569xv [+ CD ]
570xvid [+ C ]
571zlib [+ CD ]
572</pre>
347 573
348 Status for ./gnupg-1.0.7.ebuild 574<p>
349* Testing for malformed headers : passed 575Similarly you can use the <c>euse -a -g</c> command to only view active global
350- (W) Has illegal or suspect headers: 576USE flags. The <c>euse -a -l</c> command does the same for active local USE
351 |Suspect copyright year: # Copyright 1999-2000 Gentoo Technologies, Inc. 577flags.<c>-g</c> &amp; <c>-l</c> are suboptions to <c>euse</c> and need an
352 * Testing for occurence of deprecated try : passed 578option before them (like <c>-a</c>) to function correctly.
353 * Testing for superfluous A=${P}.tar.gz : passed 579</p>
354 * Testing for empty DEPEND : passed
355 * Testing for empty HOMEPAGE : passed
356 * Testing for empty DESCRIPTION : passed
357 * Testing for presence of env vars : passed
358 - (W) Missing SLOT=
359 * Testing for sane USE flag usage : passed
360 580
361 ------------------------------------------------------------------------------- 581<pre caption="Viewing active local USE flags">
362 Summary for all 1 ebuild(s) checked # errors/warns 582# <i>euse -a -l</i>
363 ------------------------------------------------------------------------------- 583bitmap-fonts [+ D ]
364 Testing for illegal space characters, weird backslash formatting : 0 / 0 584font-server [+ D ]
365 Testing for malformed headers : 0 / 1 585fortran [+ D ]
366 Testing for occurence of deprecated try : 0 / 0 586gimpprint [+ C ]
367 Testing for superfluous A=${P}.tar.gz : 0 / 0 587imlib2 [+ ]
368 Testing for empty DEPEND : 0 / 0 588md5sum [+ C ]
369 Testing for empty HOMEPAGE : 0 / 0 589mpeg4 [+ C ]
370 Testing for empty DESCRIPTION : 0 / 0 590nvidia [+ C ]
371 Testing for presence of env vars : 0 / 1 591offensive [+ ]
372 Testing for sane USE flag usage : 0 / 0 592truetype [+ CD ]
593truetype-fonts [+ D ]
594type1-fonts [+ D ]
595</pre>
373 596
374 Total number of ebuilds with errors : 0 (0%) 597<p>
375 Total number of ebuilds with warnings : 1 (100%) 598We can also use <c>euse</c> to set or unset use flags. The commands used for
376 </i> </pre> 599this are <c>euse -E flagname</c> (enable a flag) and <c>euse -D flagname</c>
377 <p>Now I can see that the year in the ebuild is probably wrong, and that it is 600(disable a flag).
378 missing the SLOT variable. Fixing those eliminates all warnings.</p> 601</p>
379 602
603<warn>
604Do not use the <c>euse -E</c> or <c>euse -D</c> commands by themselves (without
605a flag). It will set/unset ALL USE flags in <c>/etc/make.conf</c>. Although a
606backup is kept at <path>/etc/make.conf.euse_backup</path>, please be careful
607while using <c>euse -E</c> or <c>euse -D</c>.
608</warn>
609
610<pre caption="Setting and Unsetting USE flags">
611<comment>(Enabling a USE Flag)</comment>
612# <i> euse -E 3dfx</i>
613/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
614
615<comment>(/etc/make.conf after the command)</comment>
616USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc ethereal fbcon gd \
617 gif gimpprint gnome gpm gstreamer gtk2 gtkhtml imlib imlib2 \
618 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
619 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \
620 oggvorbis odbc offensive opengl pam pdflib perl png python \
621 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
622 vanilla X xml2 xosd xv xvid x86 zlib 3dfx"
623
624<comment>(Disabling the USE Flag)</comment>
625# <i> euse -D 3dfx</i>
626/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
627
628<comment>(/etc/make.conf after the command)</comment>
629USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc ethereal fbcon gd \
630 gif gimpprint gnome gpm gstreamer gtk2 gtkhtml imlib imlib2 \
631 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
632 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \
633 oggvorbis odbc offensive opengl pam pdflib perl png python \
634 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
635 vanilla X xml2 xosd xv xvid x86 zlib -3dfx"
636</pre>
637
638<note>
639<c>euse</c> does not physically remove the flag from make.conf. It just adds a
640- (minus) before the flag to unset it. You may have to manually clean up your
641make.conf to avoid unwanted variables.
642</note>
643
380 </body> 644</body>
381 </section> 645</section>
382</chapter> 646</chapter>
647
383<chapter> 648<chapter>
384 649<title>Other tools</title>
385 <title>epm</title>
386 <section> 650<section>
387 <title>Introduction</title> 651<title>revdep-rebuild</title>
388 <body> 652<body>
389 <p>
390 <c>epm</c> is a package managing tool that clones Red Hat rpm commands. As it stands
391 now, it does not offer all of the features of rpm, but it offers some of the more
392 powerful rpm query options.
393 </p>
394 653
395 <p> 654<p>
396 It also handles removing packages, which is not covered here. Use <c>epm --help</c> 655This tool is Gentoo's Reverse Dependency rebuilder. It will scan your installed
397 to learn more about deleting packages with <c>epm</c>. 656ebuilds to find packages that have become broken as a result of an upgrade of a
398 </p> 657package they depend on. It can emerge those packages for you but it can also
658happen that a given package does not work anymore with the currently installed
659dependencies, in which case you should upgrade the broken package to a more
660recent version. revdep-rebuild will pass flags to emerge which lets you use the
661<c>--pretend</c> flag to see what is going to be emerged again before you go any
662further.
663</p>
664
665<pre caption="Running revdep-rebuild in pretend mode">
666# <i>revdep-rebuild -p</i>
667
668Checking reverse dependencies...
669Packages containing binaries and libraries broken by any package update,
670will be recompiled.
671
672Collecting system binaries and libraries... done.
673 (/root/.revdep-rebuild.1_files)
674
675Collecting complete LD_LIBRARY_PATH... done.
676 (/root/.revdep-rebuild.2_ldpath)
677
678Checking dynamic linking consistency...
679 broken /usr/lib/ao/plugins-2/libarts.so (requires libartsc.so.0)
680 broken /usr/lib/kde3/libkpresenterpart.so (requires libartskde.so.1 libqtmcop.so.1
681 libsoundserver_idl.so.1 libkmedia2_idl.so.1 libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
682 broken /usr/lib/ruby/site_ruby/1.8/i686-linux/fox.so (requires libFOX-1.0.so.0)
683 broken /usr/lib/xine/plugins/1.0.0/xineplug_ao_out_arts.so (requires libartsc.so.0)
684 broken /usr/lib/perl5/vendor_perl/5.8.0/i686-linux/auto/SDL_perl/SDL_perl.so (requires libSDL_gfx.so.0)
685 broken /usr/lib/libloudmouth-1.so.0.0.0 (requires libgnutls.so.10)
686 broken /usr/bin/k3b (requires libartskde.so.1 libqtmcop.so.1 libsoundserver_idl.so.1 libkmedia2_idl.so.1
687 libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
688 broken /usr/bin/lua (requires libhistory.so.4)
689 broken /usr/bin/lyx (requires libAiksaurus-1.0.so.0)
690 broken /usr/bin/luac (requires libhistory.so.4)
691 broken /usr/bin/avidemux2 (requires libartsc.so.0)
692 broken /usr/bin/pptout (requires libxml++-0.1.so.11)
693 broken /usr/bin/xml2ps (requires libxml++-0.1.so.11)
694 done.
695 (/root/.revdep-rebuild.3_rebuild)
696
697Assigning files to ebuilds... done.
698 (/root/.revdep-rebuild.4_ebuilds)
699
700Evaluating package order... done.
701 (/root/.revdep-rebuild.5_order)
702
703All prepared. Starting rebuild...
704emerge --oneshot --nodeps -p =app-cdr/k3b-0.11.14 =app-office/koffice-1.3.2 =app-office/lyx-1.3.4 \
705 =app-office/passepartout-0.2 =dev-lang/lua-5.0.2 =dev-ruby/fxruby-1.0.29 =media-libs/libao-0.8.5 \
706 =media-libs/xine-lib-1_rc5-r3 =media-video/avidemux-2.0.26 =net-libs/loudmouth-0.16
707
708These are the packages that I would merge, in order:
709
710Calculating dependencies ...done!
711[ebuild R ] app-cdr/k3b-0.11.14
712[ebuild R ] app-office/koffice-1.3.2
713[ebuild R ] app-office/lyx-1.3.4
714[ebuild R ] app-office/passepartout-0.2
715[ebuild R ] dev-lang/lua-5.0.2
716[ebuild R ] dev-ruby/fxruby-1.0.29
717[ebuild R ] media-libs/libao-0.8.5
718[ebuild R ] media-libs/xine-lib-1_rc5-r3
719[ebuild R ] media-video/avidemux-2.0.26
720[ebuild R ] net-libs/loudmouth-0.16
721
722Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
723</pre>
724
725<p>
726If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without
727the <c>-p</c> flag and the listed packages will be emerged again.
728</p>
729
399 </body> 730</body>
400 </section> 731</section>
732
401 <section> 733<section>
402 734<title>glsa-check</title>
403 <title>Querying Packages with epm</title>
404 <body> 735<body>
405 <p>
406 <c>epm</c> functions with essentially the same command line functions as Red Hat's
407 rpm. <c>epm -qa</c> lists all packages installed. <c>epm -ql</c> lists all the
408 files from a specific ebuild.
409 </p>
410 736
411 <pre> 737<p>
412hebron etc # <i>epm -ql ethereal 738<c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's
413/usr/lib/ethereal/plugins/0.8.20/gryphon.so 739(Gentoo Linux Security Advisory) and will eventually be integrated into
414/usr/lib/ethereal/plugins/0.8.20/gryphon.la 740<c>emerge</c> and <c>equery</c>. For more information, please visit the <uri
415/usr/lib/ethereal/plugins/0.8.20/gryphon.a 741link="/proj/en/portage/glsa-integration.xml">Portage GLSA Integration
416/usr/lib/ethereal/plugins/0.8.20/mgcp.so 742Page</uri>.
417/usr/lib/ethereal/plugins/0.8.20/mgcp.la 743</p>
418/usr/lib/ethereal/plugins/0.8.20/mgcp.a
419/usr/lib/ethereal/plugins/0.8.20/cosnaming.so
420/usr/lib/ethereal/plugins/0.8.20/cosnaming.la
421/usr/lib/ethereal/plugins/0.8.20/cosnaming.a
422/usr/lib/ethereal/plugins/0.8.20/coseventcomm.so
423/usr/lib/ethereal/plugins/0.8.20/coseventcomm.la
424/usr/lib/ethereal/plugins/0.8.20/coseventcomm.a
425/usr/bin/ethereal
426/usr/bin/editcap
427/usr/bin/mergecap
428/usr/bin/tethereal
429/usr/bin/text2pcap
430/usr/bin/idl2eth
431/usr/share/man/man1/idl2eth.1.gz
432/usr/share/man/man1/tethereal.1.gz
433/usr/share/man/man1/text2pcap.1.gz
434/usr/share/man/man1/editcap.1.gz
435/usr/share/man/man1/ethereal.1.gz
436/usr/share/man/man1/mergecap.1.gz
437/usr/share/doc/ethereal-0.8.20/AUTHORS.gz
438/usr/share/doc/ethereal-0.8.20/COPYING.gz
439/usr/share/doc/ethereal-0.8.20/NEWS.gz
440/usr/share/doc/ethereal-0.8.20/ChangeLog.gz
441/usr/share/doc/ethereal-0.8.20/README.gz
442/usr/share/doc/ethereal-0.8.20/INSTALL.configure.gz
443/usr/share/doc/ethereal-0.8.20/TODO.gz
444/usr/share/doc/ethereal-0.8.20/README.aix.gz
445/usr/share/doc/ethereal-0.8.20/README.bsd.gz
446/usr/share/doc/ethereal-0.8.20/README.hpux.gz
447/usr/share/doc/ethereal-0.8.20/README.irix.gz
448/usr/share/doc/ethereal-0.8.20/README.linux.gz
449/usr/share/doc/ethereal-0.8.20/README.tru64.gz
450/usr/share/doc/ethereal-0.8.20/README.win32.gz
451/usr/share/doc/ethereal-0.8.20/README.vmware.gz
452/etc/ethereal/manuf </i>
453 </pre>
454 <p>
455 <c>epm</c> offers a few advanced query options that are not present in <c>qpkg</c>
456at the
457 time of this writing. For instance, it can query for just configuration files or
458just documentation
459 files.
460 </p>
461 <pre>
462 744
463hebron etc # <i>epm -qc ethereal
464/etc/ethereal/manuf
465
466hebron etc # epm -qd ethereal
467/usr/share/man/man1/idl2eth.1.gz
468/usr/share/man/man1/tethereal.1.gz
469/usr/share/man/man1/text2pcap.1.gz
470/usr/share/man/man1/editcap.1.gz
471/usr/share/man/man1/ethereal.1.gz
472/usr/share/man/man1/mergecap.1.gz
473/usr/share/doc/ethereal-0.8.20/AUTHORS.gz
474/usr/share/doc/ethereal-0.8.20/COPYING.gz
475/usr/share/doc/ethereal-0.8.20/NEWS.gz
476/usr/share/doc/ethereal-0.8.20/ChangeLog.gz
477/usr/share/doc/ethereal-0.8.20/README.gz
478/usr/share/doc/ethereal-0.8.20/INSTALL.configure.gz
479/usr/share/doc/ethereal-0.8.20/TODO.gz
480/usr/share/doc/ethereal-0.8.20/README.aix.gz
481/usr/share/doc/ethereal-0.8.20/README.bsd.gz
482/usr/share/doc/ethereal-0.8.20/README.hpux.gz
483/usr/share/doc/ethereal-0.8.20/README.irix.gz
484/usr/share/doc/ethereal-0.8.20/README.linux.gz
485/usr/share/doc/ethereal-0.8.20/README.tru64.gz
486/usr/share/doc/ethereal-0.8.20/README.win32.gz
487/usr/share/doc/ethereal-0.8.20/README.vmware.gz
488 </i> </pre>
489 <note>
490 <c>epm --help</c> lists the options that epm <e>will eventually</e> support. Note,
491however, that
492 options prefixed with asterisks (*) are not yet implemented.
493 </note>
494 </body> 745</body>
495 </section> 746</section>
496</chapter> 747</chapter>
497 748
498<chapter>
499 <title>Others</title>
500 <section>
501 <title>etc-update</title>
502 <body>
503 <!--
504 - Feel free to add more to this. It probably deserves its own chapter, but I don't
505 - use it, so I can't really write much about it.
506 -->
507 <p>
508 <c>etc-update</c> provides a convenient alternative to updating configuration
509 files by hand. After running an emerge that changes configuration files, you
510 can run etc-update to step you through the process of updating all impacted
511 configuration files.
512 </p>
513
514 <p>
515 It is driven by a menu-based interface and includes the ability to view and merge
516 in config files before deciding what to do.
517 </p>
518 </body>
519 </section>
520 <section>
521 <title>gentool</title>
522 <body>
523 <p>gentool is a collective name for several small scripts that analyze ebuild
524statistics.
525 For instance, gentool-total-coverage prints a list of email addresses and the
526 number of ebuilds each has in the portage tree.
527 </p>
528
529 </body>
530 </section>
531 <section>
532 <title>pkg-size</title>
533 <body>
534 <p><c>pkg-size</c> prints the size of the installed files in a given package.
535 </p>
536 <pre>
537
538hebron portage # <i>pkg-size nmap
539net-analyzer/nmap-2.54_beta24-r1 897024 (876KB) </i>
540 </pre>
541 </body>
542 </section>
543 <section>
544 <title>mkebuild</title>
545 <body>
546 <p><c>mkebuild</c> simplifies the process of creating a new ebuild by automating as
547much
548 of the process as possible. Running <c>mkebuild [filename]</c> will create an
549 ebuild for that file. the file should be an archive of some kind. As it works, it
550 will provide
551 feedback about changes you may need to make.
552 </p>
553
554 </body>
555 </section>
556 <section>
557 <title>emerge-webrsync</title>
558 <body>
559 <!-- Can't find any documentation on this anywhere... not even a comment in the
560code. -->
561 <p>Downloads the daily snapshot over HTTP with wget, and (optionally) syncs with
562portage.
563 </p>
564 </body>
565
566 </section>
567</chapter>
568</guide> 749</guide>
569

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.23

  ViewVC Help
Powered by ViewVC 1.1.20