/[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.34 Revision 1.35
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.34 2011/08/14 17:02:52 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.35 2011/08/15 19:29:48 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>3</version> 43<version>4</version>
44<date>2011-06-24</date> 44<date>2011-08-15</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>
275 275
276</body> 276</body>
277</section> 277</section>
278<section> 278<section>
279<title>Getting Dependency Graphs with depgraph (g)</title> 279<title>Getting Dependency Graphs with depgraph (g)</title>
280<body> 280<body>
281 281
282<p> 282<p>
283<c>depgraph</c> is the opposite of <c>depends</c>. You pass it a package, and 283<c>depgraph</c> is the opposite of <c>depends</c>. You pass it a package, and
284it will find the packages <e>it</e> depends on (not that depend on it). 284it will find the packages <e>it</e> depends on (not that depend on it).
285When it finds a dependency, it will recursively search for all of 285When it finds a dependency, it will recursively search for all of
286<e>that</e> package's dependencies. Control how deep the tree gets with 286<e>that</e> package's dependencies. Control how deep the tree gets with
287the <c>--depth</c> option. 287the <c>--depth</c> option.
288</p> 288</p>
289 289
290<pre caption="Viewing Dependency Graph for cdrtools"> 290<pre caption="Viewing Dependency Graph for mozilla-firefox">
291$ <i>equery depgraph mozilla-firefox</i> 291$ <i>equery depgraph mozilla-firefox</i>
292 * Searching for mozilla-firefox ... 292 * Searching for mozilla-firefox ...
293 * dependency graph for www-client/mozilla-firefox-2.0.0.19: 293 * dependency graph for www-client/mozilla-firefox-2.0.0.19:
294`-- www-client/mozilla-firefox-2.0.0.19 294`-- www-client/mozilla-firefox-2.0.0.19
295 `-- virtual/jre-1.6.0 (virtual/jre) [java] 295 `-- virtual/jre-1.6.0 (virtual/jre) [java]
296 `-- virtual/jdk-1.6.0 (virtual/jdk-1.6.0*) 296 `-- virtual/jdk-1.6.0 (virtual/jdk-1.6.0*)
297 `-- dev-java/icedtea6-bin (unable to resolve: package masked or removed) 297 `-- dev-java/icedtea6-bin (unable to resolve: package masked or removed)
298 `-- dev-java/sun-jdk-1.6.0.15 298 `-- dev-java/sun-jdk-1.6.0.15
299 `-- dev-java/java-sdk-docs-1.6.0.10 [doc] 299 `-- dev-java/java-sdk-docs-1.6.0.10 [doc]
300 `-- app-arch/unzip-6.0-r1 300 `-- app-arch/unzip-6.0-r1
301 `-- app-arch/bzip2-1.0.5-r1 [bzip2] 301 `-- app-arch/bzip2-1.0.5-r1 [bzip2]
302 `-- sys-libs/glibc-2.9_p20081201-r2 302 `-- sys-libs/glibc-2.9_p20081201-r2
303 `-- sys-devel/gettext-0.17 [nls] 303 `-- sys-devel/gettext-0.17 [nls]
304 `-- virtual/libiconv-0 (virtual/libiconv) 304 `-- virtual/libiconv-0 (virtual/libiconv)
305[...] 305[...]
306</pre> 306</pre>
307 307
308<p> 308<p>
309Notice how <c>jre</c> is a direct dependency and <c>jdk</c> is an indirect 309Notice how <c>jre</c> is a direct dependency and <c>jdk</c> is an indirect
310dependency if the <c>java</c> USE flag is set. 310dependency if the <c>java</c> USE flag is set.
311</p> 311</p>
312 312
313</body> 313</body>
314</section> 314</section>
315<section> 315<section>
316<title>Listing Files Installed by a Package with files (f)</title> 316<title>Listing Files Installed by a Package with files (f)</title>
317<body> 317<body>
318 318
319<p> 319<p>
320<c>equery</c> can list all the files installed by an ebuild with the 320<c>equery</c> can list all the files installed by an ebuild with the
321<c>files</c> command. Try <c>--tree</c> to get an easy to read directory 321<c>files</c> module. Try <c>--tree</c> to get an easy to read directory
322layout. Use <c>--filter</c> to only find a certain type of file. For example, 322layout. Use <c>--filter</c> to only find a certain type of file. For example,
323to find where executables were installed, use <c>--filter=cmd</c>, and to 323to find where executables were installed, use <c>--filter=cmd</c>, and to
324quickly find the configuration file location, try <c>--filter=conf</c>. 324quickly find the configuration file location, try <c>--filter=conf</c>.
325</p> 325</p>
326 326
327<pre caption="Listing Installed Files in Tree Format"> 327<pre caption="Listing Installed Files in Tree Format">
328$ <i>equery files --tree gentoolkit</i> 328$ <i>equery files --tree gentoolkit</i>
329 * Searching for gentoolkit ... 329 * Searching for gentoolkit ...
330 * Contents of app-portage/gentoolkit-0.3.0_rc7: 330 * Contents of app-portage/gentoolkit-0.3.0_rc7:
331 /etc 331 /etc
332 > /eclean 332 > /eclean
333 + distfiles.exclude 333 + distfiles.exclude
334 + packages.exclude 334 + packages.exclude
335 > /env.d 335 > /env.d
336 + 99gentoolkit-env 336 + 99gentoolkit-env

Legend:
Removed from v.1.34  
changed lines
  Added in v.1.35

  ViewVC Help
Powered by ViewVC 1.1.20