/[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.23 Revision 1.24
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.23 2006/11/02 18:41:52 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.24 2006/11/17 19:26:57 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
24 <mail link="karltk@gentoo.org">Karl Trygve</mail> 24 <mail link="karltk@gentoo.org">Karl Trygve</mail>
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">
30 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
31</author>
29 32
30<abstract> 33<abstract>
31Gentoolkit 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.
32This 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.
33</abstract> 36</abstract>
34 37
35<!-- Licensed under GFDL --> 38<!-- Licensed under GFDL -->
36 39
37<version>1.9</version> 40<version>1.10</version>
38<date>2006-11-02</date> 41<date>2006-11-17</date>
39 42
40<chapter> 43<chapter>
41<title>Introduction</title> 44<title>Introduction</title>
42<section> 45<section>
43<title>What is Gentoolkit?</title> 46<title>What is Gentoolkit?</title>
108<section> 111<section>
109<title>Introduction</title> 112<title>Introduction</title>
110<body> 113<body>
111 114
112<p> 115<p>
113<c>equery</c> is a tool that supports some features of <c>epm</c> (and the 116<c>equery</c> is a tool that displays a great deal of useful information about
114deprecated <c>qpkg</c>) together with its own set of features that make it 117the packages on your system and much more. <c>equery --help</c> gives you the
115really useful. <c>equery --help</c> gives you the full set of options. 118full set of options.
116<c>equery</c> will eventually replace <c>etcat</c> in a future release of
117Gentoolkit.
118</p> 119</p>
119 120
120<note> 121<note>
121Not all features listed by <c>equery --help</c> have been implemented yet. 122Not 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 123Those 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>. 124every command has a short option, e.g. <c>b</c> instead of <c>belongs</c>.
124</note> 125</note>
125 126
126<note> 127<note>
127Be aware that equery currently changes the format of the output if it is 128Be aware that equery currently changes the format of the output if it is sent
128sent through a pipe. The piped format is intended to be easier to parse by 129through a pipe. The piped format is intended to be easier to parse by tools, but
129tools, but has turned out to be less popular and will probably change in 130you can also turn it off by adding the <c>--no-pipe</c> option. If you write
130the future. If you write scripts that employ equery, you should be aware 131scripts that employ equery, you should be aware of this.
131of this.
132</note> 132</note>
133 133
134</body> 134</body>
135</section> 135</section>
136<section> 136<section>
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
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 mozilla USE flag"> 298<pre caption="Searching packages which use the mozilla USE flag">
299# <i>equery hasuse mozilla</i> 299# <i>equery hasuse mozilla</i>
300[ Searching for USE flag mozilla in all categories among: ] 300[ Searching for USE flag mozilla 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-java/blackdown-jre-1.4.2.01 (1.4.2)
303[I--] [ ] mail-client/evolution-2.0.2 (2.0) 303[I--] [ ] mail-client/evolution-2.0.2 (2.0)
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 ethereal</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/ethereal-0.10.6 ] 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
404 - - portaudio : Adds support for the crossplatform portaudio audio API
405 - - selinux : !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur
403 - - snmp : Adds support for the Simple Network Management Protocol if available 406 - - snmp : Adds support for the Simple Network Management Protocol if available
404 + + ssl : Adds support for Secure Socket Layer connections 407 + + 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. 408 - - threads : Adds threads support for various packages. Usually pthreads
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</pre>
409 410
410<p> 411<p>
411I have installed ethereal with only the gtk, ssl and gtk2 flags set, but the 412I have installed wireshark with only the gtk and ssl flags set, but there are
412other USE flags for ethereal are adns, ipv6, snmp and debug. For more 413several other USE flags for wireshark still available. For more information on
413information on USE flags, please refer to the <uri 414USE flags, please refer to the <uri
414link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri> 415link="/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>. 416chapter of the <uri link="/doc/en/handbook/">Gentoo Handbook</uri>.
416</p> 417</p>
417 418
418</body> 419</body>
439<chapter> 440<chapter>
440<title>euse</title> 441<title>euse</title>
441<section> 442<section>
442<title>Introduction</title> 443<title>Introduction</title>
443<body> 444<body>
444
445<warn>
446<c>euse</c> is currently broken as it does not support cascading profiles well.
447</warn>
448 445
449<p> 446<p>
450<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
451more information on USE flags, please refer to the <uri 448more information on USE flags, please refer to the <uri
452link="/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>.
489cups [+ CD ] 486cups [+ CD ]
490curl [+ ] 487curl [+ ]
491emboss [+ D ] 488emboss [+ D ]
492encode [+ D ] 489encode [+ D ]
493esd [+ ] 490esd [+ ]
494ethereal [+ C ]
495fam [+ ] 491fam [+ ]
496fbcon [+ C ] 492fbcon [+ C ]
497font-server [+ D ] 493font-server [+ D ]
498foomaticdb [+ D ] 494foomaticdb [+ D ]
499fortran [+ D ] 495fortran [+ D ]
504gnome [+ CD ] 500gnome [+ CD ]
505gphoto2 [+ ] 501gphoto2 [+ ]
506gpm [+ CD ] 502gpm [+ CD ]
507gstreamer [+ C ] 503gstreamer [+ C ]
508gtk [+ D ] 504gtk [+ D ]
509gtk2 [+ CD ]
510gtkhtml [+ C ] 505gtkhtml [+ C ]
511guile [+ ] 506guile [+ ]
512imagemagick [+ ] 507imagemagick [+ ]
513imlib [+ CD ] 508imlib [+ CD ]
514imlib2 [+ ]
515innodb [+ ] 509innodb [+ ]
516ipv6 [+ D ] 510ipv6 [+ D ]
517javascript [+ C ] 511javascript [+ C ]
518jpeg [+ CD ] 512jpeg [+ CD ]
519kde [+ D ] 513kde [+ D ]
534ncurses [+ CD ] 528ncurses [+ CD ]
535nls [+ D ] 529nls [+ D ]
536nvidia [+ C ] 530nvidia [+ C ]
537odbc [+ ] 531odbc [+ ]
538offensive [+ ] 532offensive [+ ]
539oggvorbis [+ CD ] 533ogg [+ CD ]
540opengl [+ CD ] 534opengl [+ CD ]
541oss [+ D ] 535oss [+ D ]
542pam [+ CD ] 536pam [+ CD ]
543pdflib [+ CD ] 537pdflib [+ CD ]
544perl [+ CD ] 538perl [+ CD ]
556svga [+ CD ] 550svga [+ CD ]
557tcltk [+ C ] 551tcltk [+ C ]
558tcpd [+ D ] 552tcpd [+ D ]
559tiff [+ C ] 553tiff [+ C ]
560truetype [+ CD ] 554truetype [+ CD ]
561truetype-fonts [+ D ]
562type1-fonts [+ D ]
563usb [+ C ] 555usb [+ C ]
564vanilla [+ C ] 556vanilla [+ C ]
565x86 [+ C ] 557x86 [+ C ]
566xml [+ ] 558xml [+ ]
567xml2 [+ D ]
568xosd [+ C ] 559xosd [+ C ]
569xv [+ CD ] 560xv [+ CD ]
570xvid [+ C ] 561xvid [+ C ]
571zlib [+ CD ] 562zlib [+ CD ]
572</pre> 563</pre>
582# <i>euse -a -l</i> 573# <i>euse -a -l</i>
583bitmap-fonts [+ D ] 574bitmap-fonts [+ D ]
584font-server [+ D ] 575font-server [+ D ]
585fortran [+ D ] 576fortran [+ D ]
586gimpprint [+ C ] 577gimpprint [+ C ]
587imlib2 [+ ]
588md5sum [+ C ] 578md5sum [+ C ]
589mpeg4 [+ C ] 579mpeg4 [+ C ]
590nvidia [+ C ] 580nvidia [+ C ]
591offensive [+ ] 581offensive [+ ]
592truetype [+ CD ] 582truetype [+ CD ]
593truetype-fonts [+ D ]
594type1-fonts [+ D ]
595</pre> 583</pre>
596 584
597<p> 585<p>
598We 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
599this 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>
611<comment>(Enabling a USE Flag)</comment> 599<comment>(Enabling a USE Flag)</comment>
612# <i> euse -E 3dfx</i> 600# <i> euse -E 3dfx</i>
613/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
614 602
615<comment>(/etc/make.conf after the command)</comment> 603<comment>(/etc/make.conf after the command)</comment>
616USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc ethereal fbcon gd \ 604USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon gd \
617 gif gimpprint gnome gpm gstreamer gtk2 gtkhtml imlib imlib2 \ 605 gif gimpprint gnome gpm gstreamer gtkhtml imlib \
618 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ 606 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
619 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \ 607 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \
620 oggvorbis odbc offensive opengl pam pdflib perl png python \ 608 ogg odbc offensive opengl pam pdflib perl png python \
621 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ 609 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
622 vanilla X xml2 xosd xv xvid x86 zlib 3dfx" 610 vanilla X xosd xv xvid x86 zlib 3dfx"
623 611
624<comment>(Disabling the USE Flag)</comment> 612<comment>(Disabling the USE Flag)</comment>
625# <i> euse -D 3dfx</i> 613# <i> euse -D 3dfx</i>
626/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
627 615
628<comment>(/etc/make.conf after the command)</comment> 616<comment>(/etc/make.conf after the command)</comment>
629USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc ethereal fbcon gd \ 617USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon gd \
630 gif gimpprint gnome gpm gstreamer gtk2 gtkhtml imlib imlib2 \ 618 gif gimpprint gnome gpm gstreamer gtkhtml imlib \
631 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ 619 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
632 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \ 620 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \
633 oggvorbis odbc offensive opengl pam pdflib perl png python \ 621 ogg odbc offensive opengl pam pdflib perl png python \
634 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ 622 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
635 vanilla X xml2 xosd xv xvid x86 zlib -3dfx" 623 vanilla X xosd xv xvid x86 zlib -3dfx"
636</pre> 624</pre>
637 625
638<note> 626<note>
639<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
640- (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

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

  ViewVC Help
Powered by ViewVC 1.1.20