/[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.36 Revision 1.37
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.36 2011/08/15 19:30:36 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.37 2012/07/24 12:12:51 swift Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide> 5<guide>
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">
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<author title="Editor"> 32<author title="Editor">
33 <mail link="douglasjanderson@gmail.com">Douglas Anderson</mail> 33 <mail link="douglasjanderson@gmail.com">Douglas Anderson</mail>
34</author> 34</author>
35 35
36<abstract> 36<abstract>
37Gentoolkit is a suite of tools to ease the administration of a Gentoo system. 37Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
38This document covers the basics of some of the tools present in Gentoolkit. 38This document covers the basics of some of the tools present in Gentoolkit.
39</abstract> 39</abstract>
40 40
41<!-- Licensed under GFDL --> 41<!-- Licensed under GFDL -->
42 42
43<version>4</version> 43<version>5</version>
44<date>2011-08-16</date> 44<date>2012-07-24</date>
45 45
46<chapter> 46<chapter>
47<title>Introduction</title> 47<title>Introduction</title>
48<section> 48<section>
49<title>What is Gentoolkit?</title> 49<title>What is Gentoolkit?</title>
50<body> 50<body>
51 51
52<p> 52<p>
53Gentoo is a unique distribution and presents some complexities that simply 53Gentoo is a unique distribution and presents some complexities that simply
54don't exist for other distributions. As Gentoo developers and contributors 54don't exist for other distributions. As Gentoo developers and contributors
55discovered some of these complexities, they also wrote tools to help users and 55discovered some of these complexities, they also wrote tools to help users and
56administrators work around them. Many of these tools have been contributed to 56administrators work around them. Many of these tools have been contributed to
57the Gentoo project and are included in the package 57the Gentoo project and are included in the package
58<c>app-portage/gentoolkit</c>. 58<c>app-portage/gentoolkit</c>.
59</p> 59</p>
761md5sum [+ C ] 761md5sum [+ C ]
762mpeg4 [+ C ] 762mpeg4 [+ C ]
763nvidia [+ C ] 763nvidia [+ C ]
764offensive [+ ] 764offensive [+ ]
765truetype [+ CD ] 765truetype [+ CD ]
766</pre> 766</pre>
767 767
768<p> 768<p>
769We can also use <c>euse</c> to set or unset use flags. The commands used for 769We can also use <c>euse</c> to set or unset use flags. The commands used for
770this are <c>euse -E flagname</c> (enable a flag) and <c>euse -D flagname</c> 770this are <c>euse -E flagname</c> (enable a flag) and <c>euse -D flagname</c>
771(disable a flag). 771(disable a flag).
772</p> 772</p>
773 773
774<warn> 774<warn>
775Do not use the <c>euse -E</c> or <c>euse -D</c> commands by themselves (without 775Do not use the <c>euse -E</c> or <c>euse -D</c> commands by themselves (without
776a flag). It will set/unset ALL USE flags in <c>/etc/make.conf</c>. Although a 776a flag). It will set/unset ALL USE flags in <c>/etc/portage/make.conf</c>. Although a
777backup is kept at <path>/etc/make.conf.euse_backup</path>, please be careful 777backup is kept at <path>/etc/portage/make.conf.euse_backup</path>, please be careful
778while using <c>euse -E</c> or <c>euse -D</c>. 778while using <c>euse -E</c> or <c>euse -D</c>.
779</warn> 779</warn>
780 780
781<pre caption="Setting and Unsetting USE flags"> 781<pre caption="Setting and Unsetting USE flags">
782<comment>(Enabling a USE Flag)</comment> 782<comment>(Enabling a USE Flag)</comment>
783# <i> euse -E 3dfx</i> 783# <i> euse -E 3dfx</i>
784/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup 784/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup
785 785
786<comment>(/etc/make.conf after the command)</comment> 786<comment>(/etc/portage/make.conf after the command)</comment>
787USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ 787USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
788 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ 788 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \
789 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ 789 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
790 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ 790 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \
791 ogg odbc offensive opengl pam pdflib perl png python \ 791 ogg odbc offensive opengl pam pdflib perl png python \
792 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ 792 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
793 vanilla X xosd xv xvid x86 zlib 3dfx" 793 vanilla X xosd xv xvid x86 zlib 3dfx"
794 794
795<comment>(Disabling the USE Flag)</comment> 795<comment>(Disabling the USE Flag)</comment>
796# <i> euse -D 3dfx</i> 796# <i> euse -D 3dfx</i>
797/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup 797/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup
798 798
799<comment>(/etc/make.conf after the command)</comment> 799<comment>(/etc/portage/make.conf after the command)</comment>
800USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ 800USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
801 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ 801 firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \
802 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ 802 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
803 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ 803 mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \
804 ogg odbc offensive opengl pam pdflib perl png python \ 804 ogg odbc offensive opengl pam pdflib perl png python \
805 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ 805 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
806 vanilla X xosd xv xvid x86 zlib -3dfx" 806 vanilla X xosd xv xvid x86 zlib -3dfx"
807</pre> 807</pre>
808 808
809<note> 809<note>
810<c>euse</c> does not physically remove the flag from make.conf. It just adds a 810<c>euse</c> does not physically remove the flag from make.conf. It just adds a
811- (minus) before the flag to unset it. You may have to manually clean up your 811- (minus) before the flag to unset it. You may have to manually clean up your
812make.conf to avoid unwanted variables. 812make.conf to avoid unwanted variables.
813</note> 813</note>
814 814
899<p> 899<p>
900<c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's 900<c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's
901(Gentoo Linux Security Advisory) and will eventually be integrated into 901(Gentoo Linux Security Advisory) and will eventually be integrated into
902<c>emerge</c> and <c>equery</c>. 902<c>emerge</c> and <c>equery</c>.
903</p> 903</p>
904 904
905</body> 905</body>
906</section> 906</section>
907<section> 907<section>
908<title>eread</title> 908<title>eread</title>
909<body> 909<body>
910 910
911<p> 911<p>
912<c>eread</c> is a simple utility to display elog files produced by 912<c>eread</c> is a simple utility to display elog files produced by
913>=<c>portage-2.1</c>. You can set the saving of elog files by setting a couple 913>=<c>portage-2.1</c>. You can set the saving of elog files by setting a couple
914of variables in <path>/etc/make.conf</path>: 914of variables in <path>/etc/portage/make.conf</path>:
915</p> 915</p>
916 916
917<pre caption="Enabling elog in /etc/make.conf"> 917<pre caption="Enabling elog in /etc/portage/make.conf">
918PORTAGE_ELOG_CLASSES="log" 918PORTAGE_ELOG_CLASSES="log"
919PORTAGE_ELOG_SYSTEM="save" 919PORTAGE_ELOG_SYSTEM="save"
920</pre> 920</pre>
921 921
922<note> 922<note>
923This is just one way of saving elog messages. For more information on how 923This is just one way of saving elog messages. For more information on how
924Portage's elog system works, please refer to the appropriate page in the <uri 924Portage's elog system works, please refer to the appropriate page in the <uri
925link="/doc/en/handbook/handbook-x86.xml?part=3&amp;chap=1#doc_chap4">Portage 925link="/doc/en/handbook/handbook-x86.xml?part=3&amp;chap=1#doc_chap4">Portage
926Handbook</uri>. 926Handbook</uri>.
927</note> 927</note>
928 928
929<p> 929<p>
930Once you've set up elog to your satisfaction, just run <c>eread</c> to view your 930Once you've set up elog to your satisfaction, just run <c>eread</c> to view your
931log files. 931log files.
932</p> 932</p>

Legend:
Removed from v.1.36  
changed lines
  Added in v.1.37

  ViewVC Help
Powered by ViewVC 1.1.20