/[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.18 Revision 1.19
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.18 2004/12/27 20:32:02 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.19 2005/04/07 17:58:39 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
26<abstract> 26<abstract>
27Gentoolkit is a suite of tools to ease the administration of a Gentoo system. 27Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
28This document covers the basics of some of the tools present in Gentoolkit. 28This document covers the basics of some of the tools present in Gentoolkit.
29</abstract> 29</abstract>
30 30
31<version>1.5</version> 31<version>1.6</version>
32<date>2004-12-27</date> 32<date>2005-04-07</date>
33 33
34<chapter> 34<chapter>
35<title>Introduction</title> 35<title>Introduction</title>
36<section> 36<section>
37<title>What is Gentoolkit?</title> 37<title>What is Gentoolkit?</title>
237<title>euse</title> 237<title>euse</title>
238<section> 238<section>
239<title>Introduction</title> 239<title>Introduction</title>
240<body> 240<body>
241 241
242<warn>
243<c>euse</c> is currently broken as it does not support cascading profiles well.
244</warn>
245
242<p> 246<p>
243<c>euse</c> is a tool to see, set and unset USE flags at various places. For 247<c>euse</c> is a tool to see, set and unset USE flags at various places. For
244more information on USE flags, please refer to the <uri 248more information on USE flags, please refer to the <uri
245link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri>. 249link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri>.
246<c>euse -i</c> lists all USE flags. 250Please see <c>euse -h</c> for complete help and all options.
247</p> 251</p>
248 252
249</body> 253</body>
250</section>
251<section> 254</section>
255<section>
252<title>Reading, Setting and Unsetting USE Flags</title> 256<title>Viewing, Setting and Unsetting USE Flags</title>
253<body> 257<body>
254 258
255<p>
256The <c>euse --conf</c> command reads the current USE flags set/unset from
257make.conf.
258</p> 259<p>
259 260The <c>euse -a</c> command reads the current active USE flags and displays
260<pre caption="Viewing Current flags from make.conf"> 261them.
261# <i> euse --conf</i>
262USE setting in make.conf:
263alsa acpi apache2 cups cdr crypt cscope -doc ethereal fbcon gif gimpprint gnome
264gpm gstreamer gtk2 gtkhtml imlib imlib2 innodb -java javascript jpeg libg++ libwww
265mad md5sum mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses oggvorbis odbc
266offensive opengl pam pdflib perl png python quicktime readline sdl spell sse ssl
267svga tcltk tiff truetype usb vanilla X xml2 xmms xosd xv xvid x86 zlib
268</pre>
269
270<p> 262</p>
271Setting a USE flag is done with the help of the <c>euse --enable</c> command 263
272which requires a mandatory flag name argument. If the flag is not already set, 264<note>
273<c>euse</c> appends the USE flag to the end of the current USE flag settings. 265There are 5 &quot;columns&quot; that <c>euse</c> now uses to show whether a
274In case the USE flag is invalid, there is a warning. Removing a USE flag is 266flag is set/unset and where all the flag has been set. The columns are as
275done using the <c>euse --disable</c> command. If an invalid flag is specified, 267follows -- +/-, set in the Environment, set in make.Conf, set in make.Defaults,
276the user is warned suitably. If the flag is present, it is unset with a -flag 268and set in make.Globals. The output looks like [+ECDG].
277in make.conf 269</note>
270
271<pre caption="Viewing all active USE flags">
272# <i> euse -a</i>
273X [+ CD ]
274aalib [+ ]
275acpi [+ C ]
276alsa [+ C ]
277apache2 [+ C ]
278apm [+ D ]
279avi [+ D ]
280berkdb [+ D ]
281bitmap-fonts [+ D ]
282bonobo [+ ]
283cdr [+ C ]
284crypt [+ CD ]
285cscope [+ C ]
286cups [+ CD ]
287curl [+ ]
288emboss [+ D ]
289encode [+ D ]
290esd [+ ]
291ethereal [+ C ]
292fam [+ ]
293fbcon [+ C ]
294font-server [+ D ]
295foomaticdb [+ D ]
296fortran [+ D ]
297gd [+ C ]
298gdbm [+ D ]
299gif [+ CD ]
300gimpprint [+ C ]
301gnome [+ CD ]
302gphoto2 [+ ]
303gpm [+ CD ]
304gstreamer [+ C ]
305gtk [+ D ]
306gtk2 [+ CD ]
307gtkhtml [+ C ]
308guile [+ ]
309imagemagick [+ ]
310imlib [+ CD ]
311imlib2 [+ ]
312innodb [+ ]
313ipv6 [+ D ]
314javascript [+ C ]
315jpeg [+ CD ]
316kde [+ D ]
317ldap [+ ]
318libg++ [+ CD ]
319libwww [+ CD ]
320mad [+ CD ]
321mbox [+ C ]
322md5sum [+ C ]
323mikmod [+ CD ]
324mmx [+ C ]
325motif [+ CD ]
326mozilla [+ C ]
327mp3 [+ ]
328mpeg [+ CD ]
329mpeg4 [+ C ]
330mysql [+ C ]
331ncurses [+ CD ]
332nls [+ D ]
333nvidia [+ C ]
334odbc [+ ]
335offensive [+ ]
336oggvorbis [+ CD ]
337opengl [+ CD ]
338oss [+ D ]
339pam [+ CD ]
340pdflib [+ CD ]
341perl [+ CD ]
342png [+ CD ]
343python [+ CD ]
344qt [+ D ]
345quicktime [+ CD ]
346readline [+ CD ]
347ruby [+ ]
348sdl [+ CD ]
349slang [+ D ]
350spell [+ CD ]
351sse [+ C ]
352ssl [+ CD ]
353svga [+ CD ]
354tcltk [+ C ]
355tcpd [+ D ]
356tiff [+ C ]
357truetype [+ CD ]
358truetype-fonts [+ D ]
359type1-fonts [+ D ]
360usb [+ C ]
361vanilla [+ C ]
362x86 [+ C ]
363xml [+ ]
364xml2 [+ D ]
365xmms [+ D ]
366xosd [+ C ]
367xv [+ CD ]
368xvid [+ C ]
369zlib [+ CD ]
370</pre>
371
278</p> 372<p>
373Similarly you can use the <c>euse -a -g</c> command to only view active global
374USE flags. The <c>euse -a -l</c> command does the same for active local USE
375flags.<c>-g</c> &amp; <c>-l</c> are suboptions to <c>euse</c> and need an
376option before them (like <c>-a</c>) to function correctly.
377</p>
279 378
379<pre caption="Viewing active local USE flags">
380# <i>euse -a -l</i>
381bitmap-fonts [+ D ]
382font-server [+ D ]
383fortran [+ D ]
384gimpprint [+ C ]
385imlib2 [+ ]
386md5sum [+ C ]
387mpeg4 [+ C ]
388nvidia [+ C ]
389offensive [+ ]
390truetype [+ CD ]
391truetype-fonts [+ D ]
392type1-fonts [+ D ]
393</pre>
394
395<p>
396We can also use <c>euse</c> to set or unset use flags. The commands used for
397this are <c>euse -E flagname</c> (enable a flag) and <c>euse -D flagname</c>
398(disable a flag).
399</p>
400
401<warn>
402Do not use the <c>euse -E</c> or <c>euse -D</c> commands by themselves (without
403a flag). It will set/unset ALL USE flags in <c>/etc/make.conf</c>. Although a
404backup is kept at <path>/etc/make.conf.euse_backup</path>, please be careful
405while using <c>euse -E</c> or <c>euse -D</c>.
406</warn>
407
280<pre caption="Setting a USE Flag, 3dfx"> 408<pre caption="Setting and Unsetting USE flags">
409<comment>(Enabling a USE Flag)</comment>
281# <i>euse --enable 3dfx</i> 410# <i> euse -E 3dfx</i>
282USE setting in make.conf after enabling: 411/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
412
413<comment>(/etc/make.conf after the command)</comment>
283alsa acpi apache2 cups cdr crypt cscope -doc ethereal fbcon gif gimpprint gnome 414USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc ethereal fbcon gd \
284gpm gstreamer gtk2 gtkhtml imlib imlib2 innodb -java javascript jpeg libg++ libwww 415 gif gimpprint gnome gpm gstreamer gtk2 gtkhtml imlib imlib2 \
416 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
285mad md5sum mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses oggvorbis odbc 417 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \
286offensive opengl pam pdflib perl png python quicktime readline sdl spell sse ssl 418 oggvorbis odbc offensive opengl pam pdflib perl png python \
287svga tcltk tiff truetype usb vanilla X xml2 xmms xosd xv xvid x86 zlib 3dfx 419 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
288</pre> 420 vanilla X xml2 xmms xosd xv xvid x86 zlib 3dfx"
289 421
290<pre caption="Unsetting a USE Flag, 3dfx"> 422<comment>(Disabling the USE Flag)</comment>
291# <i>euse --disable 3dfx</i> 423# <i> euse -D 3dfx</i>
292USE setting in make.conf after disabling: 424/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
425
426<comment>(/etc/make.conf after the command)</comment>
293alsa acpi apache2 cups cdr crypt cscope -doc ethereal fbcon gif gimpprint gnome 427USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc ethereal fbcon gd \
294gpm gstreamer gtk2 gtkhtml imlib imlib2 innodb -java javascript jpeg libg++ libwww 428 gif gimpprint gnome gpm gstreamer gtk2 gtkhtml imlib imlib2 \
429 innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
295mad md5sum mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses oggvorbis odbc 430 mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses nvidia \
296offensive opengl pam pdflib perl png python quicktime readline sdl spell sse ssl 431 oggvorbis odbc offensive opengl pam pdflib perl png python \
297svga tcltk tiff truetype usb vanilla X xml2 xmms xosd xv xvid x86 zlib -3dfx 432 quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
433 vanilla X xml2 xmms xosd xv xvid x86 zlib -3dfx"
298</pre> 434</pre>
299 435
300<note> 436<note>
301<c>euse</c> does not physically remove the flag from make.conf. It just adds a 437<c>euse</c> does not physically remove the flag from make.conf. It just adds a
302- (minus) before the flag to unset it. You may have to manually clean up your 438- (minus) before the flag to unset it. You may have to manually clean up your
400<c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's 536<c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's
401(Gentoo Linux Security Advisory) and will eventually be integrated into 537(Gentoo Linux Security Advisory) and will eventually be integrated into
402<c>emerge</c> and <c>equery</c>. For more information, please visit the <uri 538<c>emerge</c> and <c>equery</c>. For more information, please visit the <uri
403link="/proj/en/portage/glsa-integration.xml">Portage GLSA Integration 539link="/proj/en/portage/glsa-integration.xml">Portage GLSA Integration
404Page</uri>. 540Page</uri>.
405</p> 541</p>
406 542
407</body> 543</body>
408</section> 544</section>
409</chapter> 545</chapter>
410 546

Legend:
Removed from v.1.18  
changed lines
  Added in v.1.19

  ViewVC Help
Powered by ViewVC 1.1.20