Attachment 207628 Details for Bug 269071 – html version of gentoolkit.xml for ease of proof-reading

html version of gentoolkit.xml for ease of proof-reading

gentoolkit.html (text/plain), 46.49 KB, created by Douglas Anderson on 2009-10-20 06:27:42 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Douglas Anderson

Created: 2009-10-20 06:27:42 UTC

Size: 46.49 KB

patch

obsolete

><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
><html lang="en">
><head>
><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
><link title="new" rel="stylesheet" href="../../css/main.css" type="text/css">
><link REL="shortcut icon" HREF="../../favicon.ico" TYPE="image/x-icon">
><link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/www-gentoo-org.xml" title="Gentoo Website">
><link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/forums-gentoo-org.xml" title="Gentoo Forums">
><link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/bugs-gentoo-org.xml" title="Gentoo Bugzilla">
><link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/packages-gentoo-org.xml" title="Gentoo Packages">
><link rel="search" type="application/opensearchdescription+xml" href="http://www.gentoo.org/search/archives-gentoo-org.xml" title="Gentoo List Archives">
><title>Gentoo Linux Documentation
>--
> Gentoolkit</title>
></head>
><body style="margin:0px;" bgcolor="#ffffff"><table width="100%" border="0" cellspacing="0" cellpadding="0">
><tr><td valign="top" height="125" bgcolor="#45347b"><a href="/"><img border="0" src="../../images/gtop-www.jpg" alt="Gentoo Logo"></a></td></tr>
><tr><td valign="top" align="right" colspan="1" bgcolor="#ffffff"><table border="0" cellspacing="0" cellpadding="0" width="100%"><tr>
><td width="99%" class="content" valign="top" align="left">
> <h1>Gentoolkit</h1>
><form name="contents" action="http://www.gentoo.org">
>Content:
> <select name="url" size="1" OnChange="location.href=form.url.options[form.url.selectedIndex].value" style="font-family:sans-serif,Arial,Helvetica"><option value="#doc_chap1">1. Introduction</option>
><option value="#doc_chap2">2. equery</option>
><option value="#doc_chap3">3. euse</option>
><option value="#doc_chap4">4. Other tools</option></select>
></form>
><a name="doc_chap1"></a>1.Â 
> Introduction
><a name="doc_chap1_sect1">What is Gentoolkit?</a>
>
>Gentoo is a unique distribution and presents some complexities that simply
>don't exist for other distributions. As Gentoo developers and contributors
>discovered some of these complexities, they also wrote tools to help users and
>administrators work around them. Many of these tools have been contributed to
>the Gentoo project and are included in the package
>app-portage/gentoolkit.
>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb">Note: 
>As of now, there are two versions of gentoolkit: app-portage/gentoolkit
>and app-portage/gentoolkit-dev. While the former contains administration
>scripts, the latter contains scripts specific to help development on Gentoo.
>If you are a developer, you can have your scripts included into
>gentoolkit-dev by contacting the Gentoolkit maintainer. This document
>discusses gentoolkit only.
></td></tr></table>
>
>Gentoolkit contains a whole bunch of useful tools to help manage your packages
>and keep track of what is going on in your system. Most users
>-- particularly those who update systems often -- will benefit from
>having gentoolkit installed.
>
><a name="doc_chap1_sect2">Installation</a>
>
>Just as with any Gentoo package, installation is just a simple emerge.
>
><a name="doc_chap1_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 1.1: Getting gentoolkit</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
># emerge gentoolkit
></pre></td></tr>
></table>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb">Note: 
>Many of the tools in gentoolkit reveal important information about your system
>or require root privilege. For that reason, some of the programs may only be
>executed (or only function properly) if run by a user with root permission.
></td></tr></table>
><a name="doc_chap1_sect3">Finding Documentation</a>
>
>Any documentation that a program might have (other than man pages) is stored in
>/usr/share/doc/gentoolkit-[version]/[program-name]/.
>
><a name="doc_chap2"></a>2.Â 
> equery
><a name="doc_chap2_sect1">Introduction</a>
>
>equery is a tool that displays useful information about the packages on
>your system. equery is based on a system of modules. 
>Every module has a shorthand name. For example equery l gcc is the same
>as equery list gcc. equery --help explains global options
> and lists all available modules and their shorthand names. 
> equery --help module will display the help screen for a specific
> module. Lastly, man equery provides a detailed explanation of all
> available modules and options, and provides useful examples.
>
>
>Below is a list of features
>that work over the majority of modules.
>
><a name="doc_chap2_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.1: Examples of Acceptable Input</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>(Many modules require a package argument. equery accepts all emerge-like input):
>$ equery --quiet list gcc # package
>sys-devel/gcc-4.3.2-r3
>$ equery --quiet list sys-devel/gcc # category/package
>sys-devel/gcc-4.3.2-r3
>$ equery --quiet list '&gt;=sys-devel/gcc-4' # atom syntax
>sys-devel/gcc-4.3.2-r3
>
>(Like emerge, equery doesn't understand partial package names):
>$ equery check zilla
>!!! No package found matching zilla
>
>(Unlike emerge, equery can accept shell-like globbing in the category and/or pakage name):
>$ equery check '*zilla*'
> * Checking www-client/mozilla-firefox-3.0.14 ...
> 90 out of 90 files passed
>$ equery check www-c*/*
> * Checking www-client/links-2.2 ...
> 30 out of 30 files passed
> * Checking www-client/mozilla-firefox-3.0.14 ...
> 90 out of 90 files passed
>
>(Most equery modules take multiple input):
>$ equery hasuse sse sse2
> * Searching for USE flag sse ... 
>[IP-] [ ] media-libs/flac-1.2.1-r3 (0)
>[IP-] [ ] media-libs/speex-1.2_beta3_p2 (0)
>
> * Searching for USE flag sse2 ... 
>[IP-] [ ] dev-libs/openssl-0.9.8k (0)
>[IP-] [ ] x11-libs/pixman-0.16.0 (0)
>
>(A few modules also allow full regular expressions):
>$ equery -q list --portage-tree --full-regex '[kr]?flickr.*'
>dev-dotnet/flickrnet-bin-2.2
>dev-ruby/flickr-1.0.2-r1
>dev-ruby/flickr-1.0.2-r2
>dev-ruby/rflickr-20060201
>media-gfx/kflickr-0.6
>[...]
></pre></td></tr>
></table>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb">Note: 
>Globbing support replaced a number of older options in equery.
> For example, to act on all packages in a certain set, use '*'. 
>To act on all packages in a category, use 'category-name/*'.
></td></tr></table>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffbbbb">Warning: Don't forget to quote input when using special shell charaters 
>like asterisks or greater than/less than signs.</td></tr></table>
>Below is a quick introduction to the different equery modules.
><a name="doc_chap2_sect2">Finding the Package That a File Came From with belongs (b)</a>
><a name="doc_chap2_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.2: Finding the Package that Installed a Given File</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery belongs -e /usr/bin/glxgears
> * Searching for /usr/bin/glxgears ... 
> x11-apps/mesa-progs-7.5.1 (/usr/bin/glxgears)
></pre></td></tr>
></table>
>
>belongs can search for files matching a regular expression with the
>-f option. The -e option stops searching after it finds a match.
>Since no file on your system should be owned by two packages, this is a safe
>optimization.
>
><a name="doc_chap2_sect3">Viewing ChangeLog Entries with changes (c)</a>
>
>changes lets you view ChangeLog entries for a package version or range
> of versions. Imagine after an emerge --sync, you 
>notice Portage is going to be upgraded and want to check what has changed:
>
><a name="doc_chap2_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.3: Viewing Gentoo ChangeLog Entries</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>(Show the latest installable version's entry):
>$ equery changes portage
>*portage-2.1.6.13 (03 May 2009)
>
> 03 May 2009; Zac Medico &lt;zmedico@gentoo.org&gt; +portage-2.1.6.13.ebuild:
> 2.1.6.13 bump. This fixes bug #268398 (document econf automatic die)
> and bug #267104 (handle insufficient space interaction with userfetch).
> Bug #268228 tracks all bugs fixed since 2.1.6.11.
></pre></td></tr>
></table>
><a name="doc_chap2_sect4">Verifying Package Integrity with check (k)</a>
>
>Sometimes it is useful to check a package's integrity. equery can
>verify MD5 sums as well as timestamps to indicate when a package might
>have been corrupted, replaced, or removed.
>
><a name="doc_chap2_pre4"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.4: Checking Package Integrity</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery check gentoolkit
> * Checking app-portage/gentoolkit-0.3.0_rc7 ...
> 71 out of 71 files passed
></pre></td></tr>
></table>
><a name="doc_chap2_sect5">Listing All Packages Depending on Package X with depends (d)</a>
>
>Ever wonder why a certain package has been installed on your system?
> equery can tell which packages list it as a dependency with depends. Include indirect dependencies with the -D
>option.
>
><a name="doc_chap2_pre5"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.5: Looking for Packages Depending on pygtk</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery depends pygtk
> * Searching for pygtk ...
>app-admin/pessulus-2.24.0 (&gt;=dev-python/pygtk-2.6.0)
>app-editors/gedit-2.24.3 (python ? &gt;=dev-python/pygtk-2.12)
>dev-libs/libgweather-2.24.3 (python ? &gt;=dev-python/pygtk-2)
>dev-python/gnome-python-base-2.22.3 (&gt;=dev-python/pygtk-2.10.3)
>dev-python/gnome-python-desktop-base-2.24.1 (&gt;=dev-python/pygtk-2.10.3)
>[...]
></pre></td></tr>
></table>
><a name="doc_chap2_sect6">Getting Dependency Graphs with depgraph (g)</a>
>
>depgraph is the opposite of depends. You pass it a package, and
>it will find the packages it depends on (not that depend on it).
> When it finds a dependency, it will recursively search for all of
> that package's dependencies. Control how deep the tree gets with
> the --depth option. 
>
><a name="doc_chap2_pre6"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.6: Viewing Dependency Graph for cdrtools</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery depgraph mozilla-firefox
> * Searching for mozilla-firefox ...
> * dependency graph for www-client/mozilla-firefox-2.0.0.19:
>`-- www-client/mozilla-firefox-2.0.0.19
> `-- virtual/jre-1.6.0 (virtual/jre) [java]
> `-- virtual/jdk-1.6.0 (virtual/jdk-1.6.0*)
> `-- dev-java/icedtea6-bin (unable to resolve: package masked or removed)
> `-- dev-java/sun-jdk-1.6.0.15
> `-- dev-java/java-sdk-docs-1.6.0.10 [doc]
> `-- app-arch/unzip-6.0-r1
> `-- app-arch/bzip2-1.0.5-r1 [bzip2]
> `-- sys-libs/glibc-2.9_p20081201-r2
> `-- sys-devel/gettext-0.17 [nls]
> `-- virtual/libiconv-0 (virtual/libiconv)
>[...]
></pre></td></tr>
></table>
>
>Notice how jre is a direct dependency and jdk is an indirect
>dependency if the java USE flag is set.
>
><a name="doc_chap2_sect7">Listing Files Installed by a Package with files (f)</a>
>
>equery can list all the files installed by an ebuild with the
>files command. Try --tree to get an easy to read directory
>layout. Use --filter to only find a certain type of file. For example,
>to find where exectables were installed, use --filter=cmd, and to
>quickly find the configuration file location, try --filter=conf.
>
><a name="doc_chap2_pre7"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.7: Listing Installed Files in Tree Format</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery files --tree gentoolkit
> * Searching for gentoolkit ...
> * Contents of app-portage/gentoolkit-0.3.0_rc7:
> /etc
> &gt; /eclean
> + distfiles.exclude
> + packages.exclude
> &gt; /env.d
> + 99gentoolkit-env
> &gt; /revdep-rebuild
> + 99revdep-rebuild
> /usr
> &gt; /bin
> + eclean
> + eclean-dist -&gt; eclean
> + eclean-pkg -&gt; eclean
> + epkginfo
> + equery
> + eread
> + euse
> + glsa-check
> + revdep-rebuild
> &gt; /lib
> &gt; /python2.6
> &gt; /site-packages
> &gt; /gentoolkit
> + gentoolkit-0.3.0_rc7-py2.6.egg-info
> + __init__.py
> &gt; /equery
> + __init__.py
> + belongs.py
> + changes.py
> + check.py
> + depends.py
> + depgraph.py
> + files.py
>[...]
></pre></td></tr>
></table>
><a name="doc_chap2_sect8">Looking for Packages that Have a Specific USE Flag with hasuse (h)</a>
>
>You can use hasuse to find out which packages have a given USE flag.
>hasuse won't tell you if the flag is enabled, only if the ebuild lists
>it as an option. See the EXAMPLES section of hasuse in the 
>equery man page for more tip on getting that information.
>
><a name="doc_chap2_pre8"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.8: Searching For Installed Packages that Use the qt3 or qt4 USE Flags</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery hasuse qt3 qt4
> * Searching for USE flag qt3 ... 
>[IP-] [ ] app-crypt/pinentry-0.7.5 (0)
>[IP-] [ ] net-dns/avahi-0.6.24-r2 (0)
>[IP-] [ ] net-wireless/wpa_supplicant-0.6.9 (0)
>
> * Searching for USE flag qt4 ... 
>[IP-] [ ] net-dns/avahi-0.6.24-r2 (0)
>[IP-] [ ] net-wireless/wpa_supplicant-0.6.9 (0)
></pre></td></tr>
></table>
><a name="doc_chap2_sect9">Listing Packages with list (l)</a>
>
>list is a simple but powerful module to list packages that are installed,
>in the Portage tree or in an overlay.
>
><a name="doc_chap2_pre9"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.9: Listing Installed Packages with list</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery list '*'
> * Searching for * ...
>[IP-] [ ] app-admin/eselect-1.2.3 (0)
>[IP-] [ ] app-admin/eselect-ctags-1.10 (0)
>[IP-] [ ] app-admin/eselect-esd-20060719 (0)
>[IP-] [ ] app-admin/eselect-fontconfig-1.0 (0)
>[IP-] [ ] app-admin/eselect-opengl-1.0.8-r1 (0)
>[IP-] [ ] app-admin/eselect-python-20090824 (0)
>[IP-] [ ] app-admin/eselect-ruby-20081227 (0)
>[IP-] [ ] app-admin/eselect-vi-1.1.5 (0)
>[IP-] [ ] app-admin/perl-cleaner-1.05 (0)
>[IP-] [ ] app-admin/pessulus-2.24.0 (0)
>[IP-] [ ] app-admin/python-updater-0.7 (0)
>[IP-] [ ] app-admin/sudo-1.7.2_p1 (0)
>[...]
></pre></td></tr>
></table>
>
>The standard query will search installed packages for the given package name.
>Passing in '*' displays all packages in the set. In the left-most field, we 
>see that all the above packages are Installed and from the Portage
>tree. They're not masked (the second field is blank), and they're all installed
>in the default slot (0).
>
>
>This time we are going to use local options to look for packages in the
> Portage tree and overlays.
>
><a name="doc_chap2_pre10"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.10: Using Local Options with list</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery list -po vim
> * Searching for vim ...
>[-P-] [ ] app-editors/vim-7.0.235 (0)
>[-P-] [ ~] app-editors/vim-7.0.243 (0)
>[-P-] [ ] app-editors/vim-7.1.123 (0)
>[-P-] [ ~] app-editors/vim-7.1.330 (0)
>[-P-] [ ] app-editors/vim-7.2 (0)
>[-P-] [ ~] app-editors/vim-7.2.108 (0)
>[IP-] [ ] app-editors/vim-7.2.182 (0)
>[-P-] [ ~] app-editors/vim-7.2.238 (0)
>[-P-] [ ~] app-editors/vim-7.2.264 (0)
></pre></td></tr>
></table>
>
>In this example you can see version 7.2.182 is installed and there are no
> versions available from an overlay. You can see which versions are keyword 
>masked by the ~ in the second field.
>
><a name="doc_chap2_sect10">Viewing Package Metadata with meta (m)</a>
>
>Each package in the Portage tree provides at least some metadata about
>its maintainer, herd, etc. Read about <a href="/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4">Gentoo Metadata</a>. 
>The amount of useful information depends on how much package maintainers
>decide to provide. With no options, meta returns some basic useful
>information.
>
><a name="doc_chap2_pre11"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.11: Getting Package Metadata with meta</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery meta gnucash
> * app-office/gnucash
>Herd: gnome-office (gnome-office@gentoo.org)
>Maintainer: tove@gentoo.org
> Torsten Veller
>Upstream: None specified
></pre></td></tr>
></table>
>
>When the maintainer provides extra information, it can be very useful:
>
><a name="doc_chap2_pre12"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.12: Getting Long Package Descriptions with meta</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery meta --description emacs
> * app-editors/emacs
> GNU Emacs is an extensible, customizable text editor - and more. At its core
> is an interpreter for Emacs Lisp, a dialect of the Lisp programming language
> with extensions to support text editing. The features of GNU Emacs include:
> * Content-sensitive editing modes, including syntax coloring, for a wide
> variety of file types including plain text, source code, and HTML.
> * Complete built-in documentation, including a tutorial for new users.
> * Support for many languages and their scripts, including all the European
> "Latin" scripts, Russian, Greek, Japanese, Chinese, Korean, Thai,
> Vietnamese, Lao, Ethiopian, and some Indian scripts.
> * Highly customizable, using Emacs Lisp code or a graphical customization
> interface.
> * A large number of extensions that add other functionality, including a
> project planner, mail and news reader, debugger interface, calendar, and
> more. Many of these extensions are distributed with GNU Emacs; others are
> available separately.
></pre></td></tr>
></table>
><a name="doc_chap2_sect11">Finding Package Sizes with size (s)</a>
>
>Ever been curious to find out how much space a specific package is occupying?
>Since a package could have its files over a number of directories, the usual
>du -hc might not give you the correct figure. Not to worry, here comes
>equery to the rescue!
>
><a name="doc_chap2_pre13"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.13: Displaying Package Size</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery size openoffice-bin
> * app-office/openoffice-bin-3.1.1
> Total files : 4624
> Total size : 361.38 MiB
></pre></td></tr>
></table>
>
>As you can see, size prints the total space used in human-readable
>units and also lists the total number of files the package has. To get the
>total size in bytes, use --bytes.
>
><a name="doc_chap2_sect12">Listing Per-Package USE Flags with uses (u)</a>
>
>equery's uses module can provide information about what USE
>flags are available for a specific package, and which of those flags is
>currently enabled.
>
><a name="doc_chap2_pre14"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.14: Showing Set and Unset USE Flags</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery uses gst-plugins-meta
> * Searching for gst-plugins-meta ...
>[ Legend : U - flag is set in make.conf ]
>[ : I - package is installed with flag ]
>[ Colors : set, unset ]
> * Found these USE flags for media-plugins/gst-plugins-meta-0.10-r2:
> U I
> + + X : Adds support for X11
> - - a52 : Enables support for decoding ATSC A/52 streams used in DVD
> + + alsa : Adds support for media-libs/alsa-lib (Advanced Linux Sound
> Architecture)
> - - dvb : Adds support for DVB (Digital Video Broadcasting)
> + + dvd : Adds support for DVDs
> + + esd : Adds support for media-sound/esound (Enlightened Sound Daemon)
> + + ffmpeg : Enable ffmpeg-based audio/video codec support
> + + flac : Adds support for FLAC: Free Lossless Audio Codec
> - - mad : Adds support for mad (high-quality mp3 decoder library and cli
> frontend)
> + + mpeg : Adds libmpeg3 support to various packages
> - - mythtv : Support for retrieval from media-tv/mythtv backend
> + + ogg : Adds support for the Ogg container format (commonly used by
> Vorbis, Theora and flac)
> - - oss : Adds support for OSS (Open Sound System)
> + + theora : Adds support for the Theora Video Compression Codec
> + + vorbis : Adds support for the OggVorbis audio codec
> - - xv : Adds in optional support for the Xvideo extension (an X API for
> video playback)
></pre></td></tr>
></table>
>
>Here, a number of USE flags are enabled in gstreamer's plugin
> meta-package, but you can see that there are other USE flags available.
> For more information on USE flags, please refer to the <a href="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</a>
>chapter of the <a href="/doc/en/handbook/">Gentoo Handbook</a>.
>
><a name="doc_chap2_sect13">Finding the Ebuild Path with which (w)</a>
>
>which is a simple script to help you quickly find the file path to an
> ebuild. If you pass an unversioned package name, which will return the
>path to the newest installable ebuild version, in other words, the ebuild
>Portage would use if you typed emerge package. Pass in a versioned
> package to get the path to that ebuild.
>
><a name="doc_chap2_pre15"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.15: Displaying the Latest Installable Ebuild Path</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ equery which gnome
>/usr/portage/gnome-base/gnome/gnome-2.26.3.ebuild
></pre></td></tr>
></table>
>
>Lastly, if none of the above features of equery have answered your 
>question, try using which to manually search an ebuild with programs
> like cat, less or grep:
>
><a name="doc_chap2_pre16"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 2.16: Other Useful Ways to Use which</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ grep HOMEPAGE $(equery which gentoolkit)
>HOMEPAGE="http://www.gentoo.org/proj/en/portage/tools/index.xml"
></pre></td></tr>
></table>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffbbbb">Warning: 
>Be aware that equery currently changes the format of the output if it is sent
>through a pipe. The piped format is intended to be easier to parse by tools, but
>you can also turn it off by adding the --no-pipe option. If you write
>scripts that employ equery, you should be aware of this.
></td></tr></table>
><a name="doc_chap3"></a>3.Â 
> euse
><a name="doc_chap3_sect1">Introduction</a>
>
>euse is a tool to see, set and unset USE flags at various places. For
>more information on USE flags, please refer to the <a href="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</a>.
>Please see euse -h for complete help and all options.
>
><a name="doc_chap3_sect2">Viewing, Setting and Unsetting USE Flags</a>
>
>The euse -a command reads the current active USE flags and displays
>them.
>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb">Note: 
>There are 5 "columns" that euse now uses to show whether a
>flag is set/unset and where all the flag has been set. The columns are as
>follows -- +/-, set in the Environment, set in make.Conf, set in make.Defaults,
>and set in make.Globals. The output looks like [+ECDG].
></td></tr></table>
><a name="doc_chap3_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 3.1: Viewing all active USE flags</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
># euse -a
>X [+ CD ]
>aalib [+ ]
>acpi [+ C ]
>alsa [+ C ]
>apache2 [+ C ]
>apm [+ D ]
>avi [+ D ]
>berkdb [+ D ]
>bitmap-fonts [+ D ]
>bonobo [+ ]
>cdr [+ C ]
>crypt [+ CD ]
>cscope [+ C ]
>cups [+ CD ]
>curl [+ ]
>emboss [+ D ]
>encode [+ D ]
>esd [+ ]
>fam [+ ]
>fbcon [+ C ]
>firefox [+ C ]
>font-server [+ D ]
>foomaticdb [+ D ]
>fortran [+ D ]
>gd [+ C ]
>gdbm [+ D ]
>gif [+ CD ]
>gimpprint [+ C ]
>gnome [+ CD ]
>gphoto2 [+ ]
>gpm [+ CD ]
>gstreamer [+ C ]
>gtk [+ D ]
>gtkhtml [+ C ]
>guile [+ ]
>imagemagick [+ ]
>imlib [+ CD ]
>innodb [+ ]
>ipv6 [+ D ]
>javascript [+ C ]
>jpeg [+ CD ]
>kde [+ D ]
>ldap [+ ]
>libg++ [+ CD ]
>libwww [+ CD ]
>mad [+ CD ]
>mbox [+ C ]
>md5sum [+ C ]
>mikmod [+ CD ]
>mmx [+ C ]
>motif [+ CD ]
>mp3 [+ ]
>mpeg [+ CD ]
>mpeg4 [+ C ]
>mysql [+ C ]
>ncurses [+ CD ]
>nls [+ D ]
>nvidia [+ C ]
>odbc [+ ]
>offensive [+ ]
>ogg [+ CD ]
>opengl [+ CD ]
>oss [+ D ]
>pam [+ CD ]
>pdflib [+ CD ]
>perl [+ CD ]
>png [+ CD ]
>python [+ CD ]
>qt [+ D ]
>quicktime [+ CD ]
>readline [+ CD ]
>ruby [+ ]
>sdl [+ CD ]
>slang [+ D ]
>spell [+ CD ]
>sse [+ C ]
>ssl [+ CD ]
>svga [+ CD ]
>tcltk [+ C ]
>tcpd [+ D ]
>tiff [+ C ]
>truetype [+ CD ]
>usb [+ C ]
>vanilla [+ C ]
>x86 [+ C ]
>xml [+ ]
>xosd [+ C ]
>xv [+ CD ]
>xvid [+ C ]
>zlib [+ CD ]
></pre></td></tr>
></table>
>
>Similarly you can use the euse -a -g command to only view active global
>USE flags. The euse -a -l command does the same for active local USE
>flags.-g &amp; -l are suboptions to euse and need an
>option before them (like -a) to function correctly.
>
><a name="doc_chap3_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 3.2: Viewing active local USE flags</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
># euse -a -l
>bitmap-fonts [+ D ]
>font-server [+ D ]
>fortran [+ D ]
>gimpprint [+ C ]
>md5sum [+ C ]
>mpeg4 [+ C ]
>nvidia [+ C ]
>offensive [+ ]
>truetype [+ CD ]
></pre></td></tr>
></table>
>
>We can also use euse to set or unset use flags. The commands used for
>this are euse -E flagname (enable a flag) and euse -D flagname
>(disable a flag).
>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffbbbb">Warning: 
>Do not use the euse -E or euse -D commands by themselves (without
>a flag). It will set/unset ALL USE flags in /etc/make.conf. Although a
>backup is kept at /etc/make.conf.euse_backup, please be careful
>while using euse -E or euse -D.
></td></tr></table>
><a name="doc_chap3_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 3.3: Setting and Unsetting USE flags</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>(Enabling a USE Flag)
># euse -E 3dfx
>/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
>
>(/etc/make.conf after the command)
>USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
> firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \
> innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
> mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \
> ogg odbc offensive opengl pam pdflib perl png python \
> quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
> vanilla X xosd xv xvid x86 zlib 3dfx"
>
>(Disabling the USE Flag)
># euse -D 3dfx
>/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
>
>(/etc/make.conf after the command)
>USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \
> firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \
> innodb -java javascript jpeg libg++ libwww mad mbox md5sum \
> mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \
> ogg odbc offensive opengl pam pdflib perl png python \
> quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \
> vanilla X xosd xv xvid x86 zlib -3dfx"
></pre></td></tr>
></table>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb">Note: 
>euse does not physically remove the flag from make.conf. It just adds a
>- (minus) before the flag to unset it. You may have to manually clean up your
>make.conf to avoid unwanted variables.
></td></tr></table>
><a name="doc_chap4"></a>4.Â 
> Other tools
><a name="doc_chap4_sect1">revdep-rebuild</a>
>
>This tool is Gentoo's Reverse Dependency rebuilder. It will scan your installed
>ebuilds to find packages that have become broken as a result of an upgrade of a
>package they depend on. It can emerge those packages for you but it can also
>happen that a given package does not work anymore with the currently installed
>dependencies, in which case you should upgrade the broken package to a more
>recent version. revdep-rebuild will pass flags to emerge which lets you use the
>--pretend flag to see what is going to be emerged again before you go any
>further.
>
><a name="doc_chap4_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 4.1: Running revdep-rebuild in pretend mode</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
># revdep-rebuild -p
>
>Checking reverse dependencies...
>Packages containing binaries and libraries broken by any package update,
>will be recompiled.
>
>Collecting system binaries and libraries... done.
> (/root/.revdep-rebuild.1_files)
>
>Collecting complete LD_LIBRARY_PATH... done.
> (/root/.revdep-rebuild.2_ldpath)
>
>Checking dynamic linking consistency...
> broken /usr/lib/ao/plugins-2/libarts.so (requires libartsc.so.0)
> broken /usr/lib/kde3/libkpresenterpart.so (requires libartskde.so.1 libqtmcop.so.1
> libsoundserver_idl.so.1 libkmedia2_idl.so.1 libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
> broken /usr/lib/ruby/site_ruby/1.8/i686-linux/fox.so (requires libFOX-1.0.so.0)
> broken /usr/lib/xine/plugins/1.0.0/xineplug_ao_out_arts.so (requires libartsc.so.0)
> broken /usr/lib/perl5/vendor_perl/5.8.0/i686-linux/auto/SDL_perl/SDL_perl.so (requires libSDL_gfx.so.0)
> broken /usr/lib/libloudmouth-1.so.0.0.0 (requires libgnutls.so.10)
> broken /usr/bin/k3b (requires libartskde.so.1 libqtmcop.so.1 libsoundserver_idl.so.1 libkmedia2_idl.so.1
> libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
> broken /usr/bin/lua (requires libhistory.so.4)
> broken /usr/bin/lyx (requires libAiksaurus-1.0.so.0)
> broken /usr/bin/luac (requires libhistory.so.4)
> broken /usr/bin/avidemux2 (requires libartsc.so.0)
> broken /usr/bin/pptout (requires libxml++-0.1.so.11)
> broken /usr/bin/xml2ps (requires libxml++-0.1.so.11)
> done.
> (/root/.revdep-rebuild.3_rebuild)
>
>Assigning files to ebuilds... done.
> (/root/.revdep-rebuild.4_ebuilds)
>
>Evaluating package order... done.
> (/root/.revdep-rebuild.5_order)
>
>All prepared. Starting rebuild...
>emerge --oneshot --nodeps -p =app-cdr/k3b-0.11.14 =app-office/koffice-1.3.2 =app-office/lyx-1.3.4 \
> =app-office/passepartout-0.2 =dev-lang/lua-5.0.2 =dev-ruby/fxruby-1.0.29 =media-libs/libao-0.8.5 \
> =media-libs/xine-lib-1_rc5-r3 =media-video/avidemux-2.0.26 =net-libs/loudmouth-0.16
>
>These are the packages that I would merge, in order:
>
>Calculating dependencies ...done!
>[ebuild R ] app-cdr/k3b-0.11.14
>[ebuild R ] app-office/koffice-1.3.2
>[ebuild R ] app-office/lyx-1.3.4
>[ebuild R ] app-office/passepartout-0.2
>[ebuild R ] dev-lang/lua-5.0.2
>[ebuild R ] dev-ruby/fxruby-1.0.29
>[ebuild R ] media-libs/libao-0.8.5
>[ebuild R ] media-libs/xine-lib-1_rc5-r3
>[ebuild R ] media-video/avidemux-2.0.26
>[ebuild R ] net-libs/loudmouth-0.16
>
>Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
></pre></td></tr>
></table>
>
>If you need to rebuild some packages, you may run revdep-rebuild without
>the -p flag and the listed packages will be emerged again.
>
><a name="doc_chap4_sect2">glsa-check</a>
>
>glsa-check is mainly a test tool that keeps track of the various GLSA's
>(Gentoo Linux Security Advisory) and will eventually be integrated into
>emerge and equery. For more information, please visit the <a href="/proj/en/portage/glsa-integration.xml">Portage GLSA Integration
>Page</a>.
>
><a name="doc_chap4_sect3">eread</a>
>
>eread is a simple utility to display elog files produced by
>&gt;=portage-2.1. You can set the saving of elog files by setting a couple
>of variables in /etc/make.conf:
>
><a name="doc_chap4_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 4.2: Enabling elog in /etc/make.conf</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>PORTAGE_ELOG_CLASSES="log"
>PORTAGE_ELOG_SYSTEM="save"
></pre></td></tr>
></table>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb">Note: 
>This is just one way of saving elog messages. For more information on how
>Portage's elog system works, please refer to the appropriate page in the <a href="/doc/en/handbook/handbook-x86.xml?part=3&amp;chap=1#doc_chap4">Portage
>Handbook</a>.
></td></tr></table>
>
>Once you've set up elog to your satisfaction, just run eread to view your
>log files.
>
><a name="doc_chap4_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td bgcolor="#7a5ada">Code ListingÂ 4.3: Using eread</td></tr>
><tr><td bgcolor="#eeeeff" align="left" dir="ltr"><pre>
>$ eread
>
>This is a list of portage log items. Choose a number to view that file or type
>q to quit.
>
>1) app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log
>2) app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log
>3) app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log
>4) app-portage:gentoolkit-0.2.3:20070320-000408.log
>Choice?
></pre></td></tr>
></table>
>
>Select a number and the file will be displayed using the paging program
>specified in the PAGER environment variable. If PAGER is not set, it will use
>less.
>
>
>After displaying the elog item, you will be prompted if you want to delete the
>file.
>
> 
></td>
><td width="1%" bgcolor="#dddaec" valign="top"><table border="0" cellspacing="4px" cellpadding="4px">
><tr><td class="topsep" align="center"><a title="View a printer-friendly version" class="altlink" href="/doc/en/gentoolkit.xml?style=printable">Print</a></td></tr>
><tr><td class="topsep" align="center">Updated October 16, 2009</td></tr>
><tr><td class="topsep" align="left">Summary: 
>Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
>This document covers the basics of some of the tools present in Gentoolkit.
></td></tr>
><tr><td align="left" class="topsep">
> <a href="mailto:mbutcher@aleph-null.tv" class="altlink">Matt Butcher</a>
> Author 
> John P. Davis
> Editor 
> <a href="mailto:erwin@gentoo.org" class="altlink">Erwin</a>
> Editor 
> <a href="mailto:fox2mike@gentoo.org" class="altlink">Shyam Mani</a>
> Editor 
> <a href="mailto:neysx@gentoo.org" class="altlink">Xavier Neys</a>
> Editor 
> <a href="mailto:karltk@gentoo.org" class="altlink">Karl Trygve</a>
> Editor 
> <a href="mailto:yoswink@gentoo.org" class="altlink">JosÃ© Luis Rivero</a>
> Editor 
> <a href="mailto:nightmorph@gentoo.org" class="altlink">Joshua Saddler</a>
> Editor 
> <a href="mailto:douglasjanderson@gmail.com" class="altlink">Douglas Anderson</a>
> Editor </td></tr>
><tr lang="en"><td align="center" class="topsep">
>Donate to support our development efforts.
> 
><form action="https://www.paypal.com/cgi-bin/webscr" method="post">
><input type="hidden" name="cmd" value="_xclick"><input type="hidden" name="business" value="paypal@gentoo.org"><input type="hidden" name="item_name" value="Gentoo Linux Support"><input type="hidden" name="item_number" value="1000"><input type="hidden" name="image_url" value="/images/paypal.png"><input type="hidden" name="no_shipping" value="1"><input type="hidden" name="return" value="http://www.gentoo.org"><input type="hidden" name="cancel_return" value="http://www.gentoo.org"><input type="image" src="http://images.paypal.com/images/x-click-but21.gif" name="submit" alt="Donate to Gentoo">
></form>
></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://osuosl.org/contribute"><img src="../../images/osuosl.png" width="125" height="50" alt="Support OSL" title="Support OSL" border="0"></a></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://www.vr.org"><img src="../../images/vr-ad.png" width="125" height="144" alt="Gentoo Centric Hosting: vr.org" title="Gentoo Centric Hosting: vr.org" border="0"></a></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://www.tek.net" target="_top"><img src="../../images/tek-gentoo.gif" width="125" height="125" alt="Tek Alchemy" title="Tek Alchemy" border="0"></a></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://www.sevenl.net" target="_top"><img src="../../images/sponsors/sevenl_ad.png" width="125" height="144" alt="SevenL.net" title="SevenL.net" border="0"></a></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://www.gni.com" target="_top"><img src="../../images/gni_logo.png" width="125" alt="Global Netoptex Inc." title="Global Netoptex Inc." border="0"></a></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://www.bytemark.co.uk/r/gentoo-home" target="_top"><img src="../../images/sponsors/bytemark_ad.png" width="125" alt="Bytemark" title="Bytemark" border="0"></a></td></tr>
><tr lang="en"><td align="center" class="topsep"><a href="http://www.online-kredit-index.de/" target="_top"><img src="../../images/sponsors/kredit-ad.jpg" width="125" alt="Online Kredit Index" title="Online Kredit Index" border="0"></a></td></tr>
><tr><td align="center" class="topsep"></td></tr>
></table></td>
></tr></table></td></tr>
><tr><td colspan="2" align="right" class="infohead">
>Copyright 2001-2009 Gentoo Foundation, Inc. Questions, Comments? <a class="highlight" href="/main/en/contact.xml">Contact us</a>.
></td></tr>
></table></body>
></html>

Actions: View

Attachments on bug 269071: 201492 | 207627 | 207628 | 228315 | 272787 | 278035 | 283455