/[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.30 Revision 1.31
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.30 2007/06/26 04:14:39 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.31 2008/05/20 18:44:03 swift 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 7
8<author title="Author"> 8<author title="Author">
9 <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail> 9 <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail>
10</author> 10</author>
11<author title="Editor"> 11<author title="Editor">
12 <!-- zhen@gentoo.org -->John P. Davis 12 <!-- zhen@gentoo.org -->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"> 17<author title="Editor">
47<body> 47<body>
48 48
49<p> 49<p>
50Gentoo is a unique distribution and presents some complexities that simply 50Gentoo is a unique distribution and presents some complexities that simply
51don't exist for other distributions. As Gentoo developers and contributors 51don't exist for other distributions. As Gentoo developers and contributors
52discovered some of these complexities, they also wrote tools to help users and 52discovered some of these complexities, they also wrote tools to help users and
53administrators work around them. Many of these tools have been contributed to 53administrators work around them. Many of these tools have been contributed to
54the Gentoo project and are included in the package 54the Gentoo project and are included in the package
55<c>app-portage/gentoolkit</c>. 55<c>app-portage/gentoolkit</c>.
56</p> 56</p>
57 57
58<note> 58<note>
59As of now, there are two versions of gentoolkit: <c>app-portage/gentoolkit</c> 59As of now, there are two versions of gentoolkit: <c>app-portage/gentoolkit</c>
60and <c>app-portage/gentoolkit-dev</c>. While the former contains administration 60and <c>app-portage/gentoolkit-dev</c>. While the former contains administration
61scripts, the latter contains scripts specific to help development on Gentoo. 61scripts, the latter contains scripts specific to help development on Gentoo.
62If you are a developer, you can have your scripts included into 62If you are a developer, you can have your scripts included into
63<c>gentoolkit-dev</c> by contacting the Gentoolkit maintainer. This document 63<c>gentoolkit-dev</c> by contacting the Gentoolkit maintainer. This document
64discusses gentoolkit only. 64discusses gentoolkit only.
65</note> 65</note>
66 66
67<p> 67<p>
68Gentoolkit contains a whole bunch of useful tools to help manage your packages 68Gentoolkit contains a whole bunch of useful tools to help manage your packages
69and keep track of what is going on in your system. Most users --&nbsp;particularly 69and keep track of what is going on in your system. Most users
70those who update systems often&nbsp;-- will benefit from having gentoolkit 70--&nbsp;particularly those who update systems often&nbsp;-- will benefit from
71installed. 71having gentoolkit installed.
72</p> 72</p>
73 73
74</body> 74</body>
75</section> 75</section>
76<section> 76<section>
77<title>Installation</title> 77<title>Installation</title>
78<body> 78<body>
79 79
80<p> 80<p>
81Just as with any Gentoo package, installation is just a simple emerge. 81Just as with any Gentoo package, installation is just a simple emerge.
82</p> 82</p>
83 83
84<pre caption="Getting gentoolkit"> 84<pre caption="Getting gentoolkit">
85# <i>emerge gentoolkit</i> 85# <i>emerge gentoolkit</i>
86</pre> 86</pre>
126 126
127<note> 127<note>
128Be aware that equery currently changes the format of the output if it is sent 128Be aware that equery currently changes the format of the output if it is sent
129through a pipe. The piped format is intended to be easier to parse by tools, but 129through a pipe. The piped format is intended to be easier to parse by tools, but
130you can also turn it off by adding the <c>--no-pipe</c> option. If you write 130you can also turn it off by adding the <c>--no-pipe</c> option. If you write
131scripts that employ equery, you should be aware of this. 131scripts that employ equery, you should be aware of this.
132</note> 132</note>
133 133
134</body> 134</body>
135</section> 135</section>
136<section> 136<section>
137<title>Finding the Package That a File Came From</title> 137<title>Finding the Package That a File Came From</title>
138<body> 138<body>
139 139
140<p> 140<p>
141<c>equery</c> also provides the functionality of finding the package that a 141<c>equery</c> also provides the functionality of finding the package that a
142file came from, using <c>belongs</c> command (or just <c>b</c>). 142file came from, using <c>belongs</c> command (or just <c>b</c>).
143</p> 143</p>
144 144
145<pre caption="Finding the ebuild that installed a given file"> 145<pre caption="Finding the ebuild that installed a given file">
146# <i>equery belongs /usr/bin/audacious</i> 146# <i>equery belongs /usr/bin/audacious</i>
147[ Searching for file(s) /usr/bin/audacious in *... ] 147[ Searching for file(s) /usr/bin/audacious in *... ]
148media-sound/audacious-1.1.2 (/usr/bin/audacious) 148media-sound/audacious-1.1.2 (/usr/bin/audacious)
149</pre> 149</pre>
150 150
151<p> 151<p>
152By using the <c>-f</c> option, you may search for packages with files 152By using the <c>-f</c> option, you may search for packages with files
153matching any regular expression. The <c>-e</c> option is useful for 153matching any regular expression. The <c>-e</c> option is useful for
154terminating your search immediately when a match is found. 154terminating your search immediately when a match is found.
155</p> 155</p>
156 156
157</body> 157</body>
158</section> 158</section>
159<section> 159<section>
160<title>Verifying Package Integrity</title> 160<title>Verifying Package Integrity</title>
161<body> 161<body>
162 162
163<p> 163<p>
164Sometimes it is useful to check a package's integrity. <c>equery</c> can 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 165verify md5 sums as well as timestamps to indicate when a package might
166have been corrupted, replaced, or removed. 166have been corrupted, replaced, or removed.
167</p> 167</p>
168 168
169<pre caption="OK package integrity"> 169<pre caption="OK package integrity">
170# <i>equery check gentoolkit</i> 170# <i>equery check gentoolkit</i>
171[ Checking app-portage/gentoolkit-0.2.0 ] 171[ Checking app-portage/gentoolkit-0.2.0 ]
172 * 54 out of 54 files good 172 * 54 out of 54 files good
173</pre> 173</pre>
174 174
175<p> 175<p>
176Please note that if you change configuration files after installation, 176Please note that if you change configuration files after installation,
177these may be reported as "not good". 177these may be reported as "not good".
178</p> 178</p>
179 179
180</body> 180</body>
181</section> 181</section>
182<section> 182<section>
183<title>List of all packages depending on ...</title> 183<title>List of all packages depending on ...</title>
184<body> 184<body>
185 185
186<p> 186<p>
187<c>equery</c> is able to list all direct dependencies matching a package. 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: 188The function we should use to do this is <c>depends</c> and it's as easy as:
189</p> 189</p>
190 190
191<pre caption="Looking for packages depending on pygtk"> 191<pre caption="Looking for packages depending on pygtk">
192# <i>equery depends pygtk</i> 192# <i>equery depends pygtk</i>
193[ Searching for packages depending on pygtk... ] 193[ Searching for packages depending on pygtk... ]
194app-office/dia-0.93 194app-office/dia-0.93
195dev-python/gnome-python-2.0.0-r1 195dev-python/gnome-python-2.0.0-r1
196gnome-extra/gdesklets-core-0.26.2 196gnome-extra/gdesklets-core-0.26.2
197media-gfx/gimp-2.0.4 197media-gfx/gimp-2.0.4
198x11-libs/vte-0.11.11-r1 198x11-libs/vte-0.11.11-r1
199</pre> 199</pre>
200 200
201</body> 201</body>
202</section> 202</section>
203<section> 203<section>
204<title>Dependency Graphs</title> 204<title>Dependency Graphs</title>
205<body> 205<body>
206 206
207<p> 207<p>
208<c>equery</c> is capable of giving us a dependency graph for a specified 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 209package. The dependency graph gives a listing of all the packages that have
210direct and indirect dependencies on the package in question. 210direct and indirect dependencies on the package in question.
211</p> 211</p>
212 212
213<pre caption="Dependency Graph for cdrtools"> 213<pre caption="Dependency Graph for cdrtools">
214# <i>equery depgraph cdrtools</i> 214# <i>equery depgraph cdrtools</i>
215Displaying dependencies for app-cdr/cdrtools-2.01_alpha37 215Displaying dependencies for app-cdr/cdrtools-2.01_alpha37
216`-- app-cdr/cdrtools-2.01_alpha37 216`-- app-cdr/cdrtools-2.01_alpha37
217 `-- sys-libs/glibc-2.3.4.20040808 (virtual/libc) 217 `-- sys-libs/glibc-2.3.4.20040808 (virtual/libc)
218 `-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers) 218 `-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers)
219 `-- sys-apps/baselayout-1.10.4 219 `-- sys-apps/baselayout-1.10.4
220 `-- sys-apps/sysvinit-2.85-r1 220 `-- sys-apps/sysvinit-2.85-r1
221 `-- sys-apps/gawk-3.1.3-r1 221 `-- sys-apps/gawk-3.1.3-r1
222 `-- sys-apps/util-linux-2.12-r4 222 `-- sys-apps/util-linux-2.12-r4
223 `-- sys-apps/sed-4.0.9 223 `-- sys-apps/sed-4.0.9
224 `-- sys-libs/ncurses-5.4-r4 224 `-- sys-libs/ncurses-5.4-r4
225 `-- sys-apps/pam-login-3.14 225 `-- sys-apps/pam-login-3.14
226 `-- sys-libs/pam-0.77-r1 226 `-- sys-libs/pam-0.77-r1
227 `-- sys-libs/cracklib-2.7-r10 227 `-- sys-libs/cracklib-2.7-r10
228 `-- sys-apps/miscfiles-1.3-r1 228 `-- sys-apps/miscfiles-1.3-r1
229 `-- app-arch/gzip-1.3.5-r1 229 `-- app-arch/gzip-1.3.5-r1
230 `-- sys-apps/portage-2.0.50-r10 230 `-- sys-apps/portage-2.0.50-r10
231</pre> 231</pre>
232 232
233<p> 233<p>
234For example, while glibc is a direct dependency for cdrtools,linux-headers 234For example, while glibc is a direct dependency for cdrtools,linux-headers
235are an indirect dependency. Note that the output also includes information 235are an indirect dependency. Note that the output also includes information
236about virtual packages. In the example above, <c>cdrtools</c> is actually 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 237written to require virtual/libc, not sys-libs/glibc, but on the given
238system in the example sys-libs/glibc provides virtual/libc. 238system in the example sys-libs/glibc provides virtual/libc.
239</p> 239</p>
240 240
241</body> 241</body>
242</section> 242</section>
243<section> 243<section>
244<title>Listing Files Belonging to an Ebuild</title> 244<title>Listing Files Belonging to an Ebuild</title>
245<body> 245<body>
246 246
247<p> 247<p>
248<c>equery</c> can list the files that belong to an installed ebuild. If I 248<c>equery</c> can list the files that belong to an installed ebuild. If I
249don't know the files that Gentoolkit has installed on the system, I will 249don't know the files that Gentoolkit has installed on the system, I will
250use <c>equery</c> to show them. 250use <c>equery</c> to show them.
251</p> 251</p>
252 252
253<pre caption="Listing files"> 253<pre caption="Listing files">
254# <i>equery files gentoolkit</i> 254# <i>equery files gentoolkit</i>
255[ Searching for packages matching gentoolkit... ] 255[ Searching for packages matching gentoolkit... ]
256app-portage/gentoolkit-0.2.0 256app-portage/gentoolkit-0.2.0
257* Contents of app-portage/gentoolkit-0.2.0: 257* Contents of app-portage/gentoolkit-0.2.0:
258/usr 258/usr
259/usr/bin 259/usr/bin
260/usr/bin/equery 260/usr/bin/equery
261/usr/bin/etcat 261/usr/bin/etcat
262/usr/bin/euse 262/usr/bin/euse
263/usr/bin/glsa-check 263/usr/bin/glsa-check
268/usr/lib/gentoolkit/pym 268/usr/lib/gentoolkit/pym
269/usr/lib/gentoolkit/pym/gentoolkit 269/usr/lib/gentoolkit/pym/gentoolkit
270/usr/lib/gentoolkit/pym/gentoolkit/__init__.py 270/usr/lib/gentoolkit/pym/gentoolkit/__init__.py
271/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py 271/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py
272/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py 272/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py
273/usr/lib/gentoolkit/pym/glsa.py 273/usr/lib/gentoolkit/pym/glsa.py
274/usr/sbin 274/usr/sbin
275/usr/share 275/usr/share
276/usr/share/doc 276/usr/share/doc
277/usr/share/doc/gentoolkit-0.2.0_pre10 277/usr/share/doc/gentoolkit-0.2.0_pre10
278 278
279[...] 279[...]
280</pre> 280</pre>
281 281
282<p> 282<p>
283The command <c>files</c> of <c>equery</c> provide some options to modify 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. 284the output. You can look them all up in the <c>equery</c> man page.
285</p> 285</p>
286 286
287</body> 287</body>
288</section> 288</section>
289<section> 289<section>
290<title>Looking for packages that use a specific USE flag</title> 290<title>Looking for packages that use a specific USE flag</title>
291<body> 291<body>
292 292
293<p> 293<p>
294If you want to find which packages on your system that make use of a specific 294If you want to find which packages on your system that make use of a specific
295USE flag, <c>equery</c> has the function <c>hasuse</c>: 295USE flag, <c>equery</c> has the function <c>hasuse</c>:
296</p> 296</p>
297 297
298<pre caption="Searching packages which use the firefox USE flag"> 298<pre caption="Searching packages which use the firefox USE flag">
299# <i>equery hasuse firefox</i> 299# <i>equery hasuse firefox</i>
300[ Searching for USE flag firefox in all categories among: ] 300[ Searching for USE flag firefox in all categories among: ]
301 * installed packages 301 * installed packages
302[I--] [ ] dev-python/gnome-python-extras-2.14.0-r1 (0) 302[I--] [ ] dev-python/gnome-python-extras-2.14.0-r1 (0)
303[I--] [ ] media-video/totem-2.16.4 (0) 303[I--] [ ] media-video/totem-2.16.4 (0)
304</pre> 304</pre>
305 305
306</body> 306</body>
307</section> 307</section>
308<section> 308<section>
309<title>Listing Packages</title> 309<title>Listing Packages</title>
310<body> 310<body>
311 311
312<p> 312<p>
313<c>equery</c> has a power feature to list packages belonging to our system, 313<c>equery</c> has a power feature to list packages belonging to our system,
314portage or even an overlay. Let's try this: 314portage or even an overlay. Let's try this:
315</p> 315</p>
316 316
317<pre caption="Listing packages with equery"> 317<pre caption="Listing packages with equery">
318# <i>equery list gentoolkit</i> 318# <i>equery list gentoolkit</i>
319[ Searching for package 'gentoolkit' in all categories among: ] 319[ Searching for package 'gentoolkit' in all categories among: ]
320 * installed packages 320 * installed packages
321[I--] [ ] app-portage/gentoolkit-0.2.0 (0) 321[I--] [ ] app-portage/gentoolkit-0.2.0 (0)
322</pre> 322</pre>
323 323
324<p> 324<p>
325The standard query will search our installed packages for the name given. 325The standard query will search our installed packages for the name given.
326If found, the following info will be displayed: the package location between 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 327the first square brackets (I for Installed packages, P for Portage, O for
328Overlay), the possible masks between the second (~ by keyword, - by arch or 328Overlay), the possible masks between the second (~ by keyword, - by arch or
329M hard masked), then the category and complete name and last of all, the slot 329M hard masked), then the category and complete name and last of all, the slot
330in which the package is stored. 330in which the package is stored.
331</p> 331</p>
332 332
333<p> 333<p>
334Another example, this time we are going to use the local options in order 334Another example, this time we are going to use the local options in order
335to look for packages in our portage tree and overlay. 335to look for packages in our portage tree and overlay.
336</p> 336</p>
337 337
338<pre caption="Using local options with equery"> 338<pre caption="Using local options with equery">
339# <i>equery list -p -o vim</i> 339# <i>equery list -p -o vim</i>
340[ Searching for package 'vim' in all categories among: ] 340[ Searching for package 'vim' in all categories among: ]
341 * installed packages 341 * installed packages
342[I--] [ ] app-editors/vim-6.3-r4 (0) 342[I--] [ ] app-editors/vim-6.3-r4 (0)
343 * Portage tree (/usr/portage) 343 * Portage tree (/usr/portage)
344[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0) 344[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0)
362<p> 362<p>
363Ever been curious to find out how much space a specific package is occupying? 363Ever been curious to find out how much space a specific package is occupying?
364Since a package could have its files over a number of directories, the usual 364Since a package could have its files over a number of directories, the usual
365<c>du -hc</c> might not give you the correct figure. Not to worry, here comes 365<c>du -hc</c> might not give you the correct figure. Not to worry, here comes
366<c>equery</c> to the rescue! 366<c>equery</c> to the rescue!
367</p> 367</p>
368 368
369<pre caption="Package Size"> 369<pre caption="Package Size">
370# <i>equery size openoffice-bin</i> 370# <i>equery size openoffice-bin</i>
371* app-office/openoffice-bin-1.1.2 371* app-office/openoffice-bin-1.1.2
372 Total Files : 2908 372 Total Files : 2908
373 Total Size : 223353.31 KiB 373 Total Size : 223353.31 KiB
374</pre> 374</pre>
375 375
376<p> 376<p>
377As you can see, <c>equery</c> prints the total space used in kilobytes and 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. 378also lists the total number of files the package has.
379</p> 379</p>
380 380
381</body> 381</body>
382</section> 382</section>
383<section> 383<section>
384<title>Package-wise list of USE Flags</title> 384<title>Package-wise list of USE Flags</title>
385<body> 385<body>
386 386
387<p> 387<p>
388<c>equery</c> can be used to give us information about what USE flags 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 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. 390flags are for a package and also what USE flags are available for the package.
391</p> 391</p>
392 392
393<pre caption="Set and Unset USE Flags"> 393<pre caption="Set and Unset USE Flags">
394# <i>equery uses wireshark</i> 394# <i>equery uses wireshark</i>
395[ Colour Code : set unset ] 395[ Colour Code : set unset ]
396[ Legend : (U) Col 1 - Current USE flags ] 396[ Legend : (U) Col 1 - Current USE flags ]
397[ : (I) Col 2 - Installed With USE flags ] 397[ : (I) Col 2 - Installed With USE flags ]
398 398
399 U I [ Found these USE variables in : net-analyzer/wireshark-0.99.4 ] 399 U I [ Found these USE variables in : net-analyzer/wireshark-0.99.4 ]
400 - - adns : Adds support for the adns DNS client library 400 - - adns : Adds support for the adns DNS client library
401 + + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit) 401 + + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit)
402 - - ipv6 : Adds support for IP version 6 402 - - ipv6 : Adds support for IP version 6
403 - - kerberos : Adds kerberos support 403 - - kerberos : Adds kerberos support
404 - - portaudio : Adds support for the crossplatform portaudio audio API 404 - - portaudio : Adds support for the crossplatform portaudio audio API
434</pre> 434</pre>
435 435
436</body> 436</body>
437</section> 437</section>
438</chapter> 438</chapter>
439 439
440<chapter> 440<chapter>
441<title>euse</title> 441<title>euse</title>
442<section> 442<section>
443<title>Introduction</title> 443<title>Introduction</title>
444<body> 444<body>
445 445
446<p> 446<p>
447<c>euse</c> is a tool to see, set and unset USE flags at various places. For 447<c>euse</c> is a tool to see, set and unset USE flags at various places. For
448more information on USE flags, please refer to the <uri 448more information on USE flags, please refer to the <uri
449link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri>. 449link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri>.
450Please see <c>euse -h</c> for complete help and all options. 450Please see <c>euse -h</c> for complete help and all options.
451</p> 451</p>
452 452
453</body> 453</body>
454</section> 454</section>
455<section> 455<section>
456<title>Viewing, Setting and Unsetting USE Flags</title> 456<title>Viewing, Setting and Unsetting USE Flags</title>
457<body> 457<body>
458 458
459<p> 459<p>
460The <c>euse -a</c> command reads the current active USE flags and displays 460The <c>euse -a</c> command reads the current active USE flags and displays
461them. 461them.
462</p> 462</p>
463 463
464<note> 464<note>
465There are 5 &quot;columns&quot; that <c>euse</c> now uses to show whether a 465There are 5 &quot;columns&quot; that <c>euse</c> now uses to show whether a
466flag is set/unset and where all the flag has been set. The columns are as 466flag is set/unset and where all the flag has been set. The columns are as
467follows -- +/-, set in the Environment, set in make.Conf, set in make.Defaults, 467follows -- +/-, set in the Environment, set in make.Conf, set in make.Defaults,
468and set in make.Globals. The output looks like [+ECDG]. 468and set in make.Globals. The output looks like [+ECDG].
469</note> 469</note>
470 470
471<pre caption="Viewing all active USE flags"> 471<pre caption="Viewing all active USE flags">
472# <i>euse -a</i> 472# <i>euse -a</i>
473X [+ CD ] 473X [+ CD ]
474aalib [+ ] 474aalib [+ ]
475acpi [+ C ] 475acpi [+ C ]
476alsa [+ C ] 476alsa [+ C ]
477apache2 [+ C ] 477apache2 [+ C ]
478apm [+ D ] 478apm [+ D ]
479avi [+ D ] 479avi [+ D ]
480berkdb [+ D ] 480berkdb [+ D ]
481bitmap-fonts [+ D ] 481bitmap-fonts [+ D ]
482bonobo [+ ] 482bonobo [+ ]
483cdr [+ C ] 483cdr [+ C ]
551tcltk [+ C ] 551tcltk [+ C ]
552tcpd [+ D ] 552tcpd [+ D ]
553tiff [+ C ] 553tiff [+ C ]
554truetype [+ CD ] 554truetype [+ CD ]
555usb [+ C ] 555usb [+ C ]
556vanilla [+ C ] 556vanilla [+ C ]
557x86 [+ C ] 557x86 [+ C ]
558xml [+ ] 558xml [+ ]
559xosd [+ C ] 559xosd [+ C ]
560xv [+ CD ] 560xv [+ CD ]
561xvid [+ C ] 561xvid [+ C ]
562zlib [+ CD ] 562zlib [+ CD ]
563</pre> 563</pre>
564 564
565<p> 565<p>
566Similarly you can use the <c>euse -a -g</c> command to only view active global 566Similarly you can use the <c>euse -a -g</c> command to only view active global
567USE flags. The <c>euse -a -l</c> command does the same for active local USE 567USE flags. The <c>euse -a -l</c> command does the same for active local USE
568flags.<c>-g</c> &amp; <c>-l</c> are suboptions to <c>euse</c> and need an 568flags.<c>-g</c> &amp; <c>-l</c> are suboptions to <c>euse</c> and need an
569option before them (like <c>-a</c>) to function correctly. 569option before them (like <c>-a</c>) to function correctly.
570</p> 570</p>
571 571
572<pre caption="Viewing active local USE flags"> 572<pre caption="Viewing active local USE flags">
573# <i>euse -a -l</i> 573# <i>euse -a -l</i>
574bitmap-fonts [+ D ] 574bitmap-fonts [+ D ]
575font-server [+ D ] 575font-server [+ D ]
576fortran [+ D ] 576fortran [+ D ]
577gimpprint [+ C ] 577gimpprint [+ C ]
578md5sum [+ C ] 578md5sum [+ C ]
579mpeg4 [+ C ] 579mpeg4 [+ C ]
580nvidia [+ C ] 580nvidia [+ C ]
581offensive [+ ] 581offensive [+ ]
582truetype [+ CD ] 582truetype [+ CD ]
583</pre> 583</pre>
584 584
585<p> 585<p>
586We can also use <c>euse</c> to set or unset use flags. The commands used for 586We can also use <c>euse</c> to set or unset use flags. The commands used for
587this are <c>euse -E flagname</c> (enable a flag) and <c>euse -D flagname</c> 587this are <c>euse -E flagname</c> (enable a flag) and <c>euse -D flagname</c>
588(disable a flag). 588(disable a flag).
589</p> 589</p>
590 590
591<warn> 591<warn>
592Do not use the <c>euse -E</c> or <c>euse -D</c> commands by themselves (without 592Do not use the <c>euse -E</c> or <c>euse -D</c> commands by themselves (without
593a flag). It will set/unset ALL USE flags in <c>/etc/make.conf</c>. Although a 593a flag). It will set/unset ALL USE flags in <c>/etc/make.conf</c>. Although a
594backup is kept at <path>/etc/make.conf.euse_backup</path>, please be careful 594backup is kept at <path>/etc/make.conf.euse_backup</path>, please be careful
595while using <c>euse -E</c> or <c>euse -D</c>. 595while using <c>euse -E</c> or <c>euse -D</c>.
596</warn> 596</warn>
597 597
598<pre caption="Setting and Unsetting USE flags"> 598<pre caption="Setting and Unsetting USE flags">
599<comment>(Enabling a USE Flag)</comment> 599<comment>(Enabling a USE Flag)</comment>
600# <i> euse -E 3dfx</i> 600# <i> euse -E 3dfx</i>
601/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup 601/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
602 602
603<comment>(/etc/make.conf after the command)</comment> 603<comment>(/etc/make.conf after the command)</comment>
604USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ 604USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
605 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ 605 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \
606 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ 606 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
607 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ 607 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \
608 ogg odbc offensive opengl pam pdflib perl png python \ 608 ogg odbc offensive opengl pam pdflib perl png python \
609 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ 609 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
679 broken /usr/bin/avidemux2 (requires libartsc.so.0) 679 broken /usr/bin/avidemux2 (requires libartsc.so.0)
680 broken /usr/bin/pptout (requires libxml++-0.1.so.11) 680 broken /usr/bin/pptout (requires libxml++-0.1.so.11)
681 broken /usr/bin/xml2ps (requires libxml++-0.1.so.11) 681 broken /usr/bin/xml2ps (requires libxml++-0.1.so.11)
682 done. 682 done.
683 (/root/.revdep-rebuild.3_rebuild) 683 (/root/.revdep-rebuild.3_rebuild)
684 684
685Assigning files to ebuilds... done. 685Assigning files to ebuilds... done.
686 (/root/.revdep-rebuild.4_ebuilds) 686 (/root/.revdep-rebuild.4_ebuilds)
687 687
688Evaluating package order... done. 688Evaluating package order... done.
689 (/root/.revdep-rebuild.5_order) 689 (/root/.revdep-rebuild.5_order)
690 690
691All prepared. Starting rebuild... 691All prepared. Starting rebuild...
692emerge --oneshot --nodeps -p =app-cdr/k3b-0.11.14 =app-office/koffice-1.3.2 =app-office/lyx-1.3.4 \ 692emerge --oneshot --nodeps -p =app-cdr/k3b-0.11.14 =app-office/koffice-1.3.2 =app-office/lyx-1.3.4 \
693 =app-office/passepartout-0.2 =dev-lang/lua-5.0.2 =dev-ruby/fxruby-1.0.29 =media-libs/libao-0.8.5 \ 693 =app-office/passepartout-0.2 =dev-lang/lua-5.0.2 =dev-ruby/fxruby-1.0.29 =media-libs/libao-0.8.5 \
694 =media-libs/xine-lib-1_rc5-r3 =media-video/avidemux-2.0.26 =net-libs/loudmouth-0.16 694 =media-libs/xine-lib-1_rc5-r3 =media-video/avidemux-2.0.26 =net-libs/loudmouth-0.16
695 695
696These are the packages that I would merge, in order: 696These are the packages that I would merge, in order:
697 697
698Calculating dependencies ...done! 698Calculating dependencies ...done!
699[ebuild R ] app-cdr/k3b-0.11.14 699[ebuild R ] app-cdr/k3b-0.11.14
700[ebuild R ] app-office/koffice-1.3.2 700[ebuild R ] app-office/koffice-1.3.2
701[ebuild R ] app-office/lyx-1.3.4 701[ebuild R ] app-office/lyx-1.3.4
702[ebuild R ] app-office/passepartout-0.2 702[ebuild R ] app-office/passepartout-0.2
703[ebuild R ] dev-lang/lua-5.0.2 703[ebuild R ] dev-lang/lua-5.0.2
704[ebuild R ] dev-ruby/fxruby-1.0.29 704[ebuild R ] dev-ruby/fxruby-1.0.29
705[ebuild R ] media-libs/libao-0.8.5 705[ebuild R ] media-libs/libao-0.8.5
706[ebuild R ] media-libs/xine-lib-1_rc5-r3 706[ebuild R ] media-libs/xine-lib-1_rc5-r3
707[ebuild R ] media-video/avidemux-2.0.26 707[ebuild R ] media-video/avidemux-2.0.26
708[ebuild R ] net-libs/loudmouth-0.16 708[ebuild R ] net-libs/loudmouth-0.16
709 709
710Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild. 710Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
711</pre> 711</pre>
712 712
713<p> 713<p>
714If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without 714If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without
715the <c>-p</c> flag and the listed packages will be emerged again. 715the <c>-p</c> flag and the listed packages will be emerged again.
716</p> 716</p>
717 717
718</body> 718</body>
719</section> 719</section>
720<section> 720<section>
721<title>glsa-check</title> 721<title>glsa-check</title>
722<body> 722<body>
723 723
749<note> 749<note>
750This is just one way of saving elog messages. For more information on how 750This is just one way of saving elog messages. For more information on how
751Portage's elog system works, please refer to the appropriate page in the <uri 751Portage's elog system works, please refer to the appropriate page in the <uri
752link="/doc/en/handbook/handbook-x86.xml?part=3&amp;chap=1#doc_chap4">Portage 752link="/doc/en/handbook/handbook-x86.xml?part=3&amp;chap=1#doc_chap4">Portage
753Handbook</uri>. 753Handbook</uri>.
754</note> 754</note>
755 755
756<p> 756<p>
757Once you've set up elog to your satisfaction, just run <c>eread</c> to view your 757Once you've set up elog to your satisfaction, just run <c>eread</c> to view your
758log files. 758log files.
759</p> 759</p>
760 760
761<pre caption="Using eread"> 761<pre caption="Using eread">
762$ <i>eread</i> 762$ <i>eread</i>
763 763
764This is a list of portage log items. Choose a number to view that file or type q to quit. 764This is a list of portage log items. Choose a number to view that file or type
765q to quit.
765 766
7661) app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log 7671) app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log
7672) app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log 7682) app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log
7683) app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log 7693) app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log
7694) app-portage:gentoolkit-0.2.3:20070320-000408.log 7704) app-portage:gentoolkit-0.2.3:20070320-000408.log
770Choice? 771Choice?
771</pre> 772</pre>
772 773
773<p> 774<p>
774Select a number and the file will be displayed using the paging program 775Select a number and the file will be displayed using the paging program
775specified in the PAGER environment variable. If PAGER is not set, it will use 776specified in the PAGER environment variable. If PAGER is not set, it will use
776<c>less</c>. 777<c>less</c>.
777</p> 778</p>
778 779
779<p> 780<p>

Legend:
Removed from v.1.30  
changed lines
  Added in v.1.31

  ViewVC Help
Powered by ViewVC 1.1.20