/[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.24 Revision 1.25
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.24 2006/11/17 19:26:57 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.25 2007/02/20 22:07:04 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 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">
25</author> 25</author>
26<author title="Editor"> 26<author title="Editor">
27 <mail link="yoswink@gentoo.org">José Luis Rivero</mail> 27 <mail link="yoswink@gentoo.org">José Luis Rivero</mail>
28</author> 28</author>
29<author title="Editor"> 29<author title="Editor">
30 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> 30 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
31</author> 31</author>
32 32
33<abstract> 33<abstract>
34Gentoolkit is a suite of tools to ease the administration of a Gentoo system. 34Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
35This document covers the basics of some of the tools present in Gentoolkit. 35This document covers the basics of some of the tools present in Gentoolkit.
36</abstract> 36</abstract>
37 37
38<!-- Licensed under GFDL --> 38<!-- Licensed under GFDL -->
39 39
40<version>1.10</version> 40<version>1.11</version>
41<date>2006-11-17</date> 41<date>2007-02-20</date>
42 42
43<chapter> 43<chapter>
44<title>Introduction</title> 44<title>Introduction</title>
45<section> 45<section>
46<title>What is Gentoolkit?</title> 46<title>What is Gentoolkit?</title>
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>
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 mozilla USE flag"> 298<pre caption="Searching packages which use the firefox USE flag">
299# <i>equery hasuse mozilla</i> 299# <i>equery hasuse firefox</i>
300[ Searching for USE flag mozilla in all categories among: ] 300[ Searching for USE flag firefox in all categories among: ]
301 * installed packages 301 * installed packages
302[I--] [ ] dev-java/blackdown-jre-1.4.2.01 (1.4.2) 302[I--] [ ] dev-python/gnome-python-extras-2.14.0-r1 (0)
303[I--] [ ] mail-client/evolution-2.0.2 (2.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>
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 ]
484crypt [+ CD ] 484crypt [+ CD ]
485cscope [+ C ] 485cscope [+ C ]
486cups [+ CD ] 486cups [+ CD ]
487curl [+ ] 487curl [+ ]
488emboss [+ D ] 488emboss [+ D ]
489encode [+ D ] 489encode [+ D ]
490esd [+ ] 490esd [+ ]
491fam [+ ] 491fam [+ ]
492fbcon [+ C ] 492fbcon [+ C ]
493firefox [+ C ]
493font-server [+ D ] 494font-server [+ D ]
494foomaticdb [+ D ] 495foomaticdb [+ D ]
495fortran [+ D ] 496fortran [+ D ]
496gd [+ C ] 497gd [+ C ]
497gdbm [+ D ] 498gdbm [+ D ]
498gif [+ CD ] 499gif [+ CD ]
499gimpprint [+ C ] 500gimpprint [+ C ]
500gnome [+ CD ] 501gnome [+ CD ]
501gphoto2 [+ ] 502gphoto2 [+ ]
502gpm [+ CD ] 503gpm [+ CD ]
503gstreamer [+ C ] 504gstreamer [+ C ]
504gtk [+ D ] 505gtk [+ D ]
505gtkhtml [+ C ] 506gtkhtml [+ C ]
506guile [+ ] 507guile [+ ]
507imagemagick [+ ] 508imagemagick [+ ]
508imlib [+ CD ] 509imlib [+ CD ]
509innodb [+ ] 510innodb [+ ]
510ipv6 [+ D ] 511ipv6 [+ D ]
511javascript [+ C ] 512javascript [+ C ]
512jpeg [+ CD ] 513jpeg [+ CD ]
513kde [+ D ] 514kde [+ D ]
514ldap [+ ] 515ldap [+ ]
515libg++ [+ CD ] 516libg++ [+ CD ]
516libwww [+ CD ] 517libwww [+ CD ]
517mad [+ CD ] 518mad [+ CD ]
518mbox [+ C ] 519mbox [+ C ]
519md5sum [+ C ] 520md5sum [+ C ]
520mikmod [+ CD ] 521mikmod [+ CD ]
521mmx [+ C ] 522mmx [+ C ]
522motif [+ CD ] 523motif [+ CD ]
523mozilla [+ C ]
524mp3 [+ ] 524mp3 [+ ]
525mpeg [+ CD ] 525mpeg [+ CD ]
526mpeg4 [+ C ] 526mpeg4 [+ C ]
527mysql [+ C ] 527mysql [+ C ]
528ncurses [+ CD ] 528ncurses [+ CD ]
529nls [+ D ] 529nls [+ D ]
530nvidia [+ C ] 530nvidia [+ C ]
531odbc [+ ] 531odbc [+ ]
532offensive [+ ] 532offensive [+ ]
533ogg [+ CD ] 533ogg [+ CD ]
534opengl [+ CD ] 534opengl [+ CD ]
535oss [+ D ] 535oss [+ D ]
536pam [+ CD ] 536pam [+ CD ]
537pdflib [+ CD ] 537pdflib [+ CD ]
538perl [+ CD ] 538perl [+ CD ]
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 gd \ 604USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
605 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 mozilla 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 \
610 vanilla X xosd xv xvid x86 zlib 3dfx" 610 vanilla X xosd xv xvid x86 zlib 3dfx"
611 611
612<comment>(Disabling the USE Flag)</comment> 612<comment>(Disabling the USE Flag)</comment>
613# <i> euse -D 3dfx</i> 613# <i> euse -D 3dfx</i>
614/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup 614/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
615 615
616<comment>(/etc/make.conf after the command)</comment> 616<comment>(/etc/make.conf after the command)</comment>
617USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon gd \ 617USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
618 gif gimpprint gnome gpm gstreamer gtkhtml imlib \ 618 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \
619 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ 619 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
620 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \ 620 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \
621 ogg odbc offensive opengl pam pdflib perl png python \ 621 ogg odbc offensive opengl pam pdflib perl png python \
622 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ 622 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
623 vanilla X xosd xv xvid x86 zlib -3dfx" 623 vanilla X xosd xv xvid x86 zlib -3dfx"
624</pre> 624</pre>
625 625
626<note> 626<note>
627<c>euse</c> does not physically remove the flag from make.conf. It just adds a 627<c>euse</c> does not physically remove the flag from make.conf. It just adds a
628- (minus) before the flag to unset it. You may have to manually clean up your 628- (minus) before the flag to unset it. You may have to manually clean up your
629make.conf to avoid unwanted variables. 629make.conf to avoid unwanted variables.
630</note> 630</note>
631 631
632</body> 632</body>
633</section> 633</section>
634</chapter> 634</chapter>
635 635

Legend:
Removed from v.1.24  
changed lines
  Added in v.1.25

  ViewVC Help
Powered by ViewVC 1.1.20