Update gentoolkit.xml to document the major changes in the gentoolkit.0.3.0 release.
Major updates written by Douglas Anderson.
--- gentoolkit.xml
+++ gentoolkit.xml
@@ -1,5 +1,5 @@
-
+
-
+Below is a list of features
+that work over the majority of modules.
+ Below is a quick introduction to the different
-
-By using the
Sometimes it is useful to check a package's integrity.
-Please note that if you change configuration files after installation,
-these may be reported as "not good".
-
-
-
+
+$ equery belongs -e /usr/bin/glxgears
+ * Searching for /usr/bin/glxgears ...
+ x11-apps/mesa-progs-7.5.1 (/usr/bin/glxgears)
+
+
-# equery belongs /usr/bin/audacious
-[ Searching for file(s) /usr/bin/audacious in *... ]
-media-sound/audacious-1.1.2 (/usr/bin/audacious)
-
+
+
+
+
-# equery check gentoolkit
-[ Checking app-portage/gentoolkit-0.2.0 ]
- * 54 out of 54 files good
+
+$ equery check gentoolkit
+ * Checking app-portage/gentoolkit-0.3.0_rc7 ...
+ 71 out of 71 files passed
-
-# equery depends pygtk
-[ Searching for packages depending on pygtk... ]
-app-office/dia-0.93
-dev-python/gnome-python-2.0.0-r1
-gnome-extra/gdesklets-core-0.26.2
-media-gfx/gimp-2.0.4
-x11-libs/vte-0.11.11-r1
+
+$ equery depends pygtk
+ * Searching for pygtk ...
+app-admin/pessulus-2.24.0 (>=dev-python/pygtk-2.6.0)
+app-editors/gedit-2.24.3 (python ? >=dev-python/pygtk-2.12)
+dev-libs/libgweather-2.24.3 (python ? >=dev-python/pygtk-2)
+dev-python/gnome-python-base-2.22.3 (>=dev-python/pygtk-2.10.3)
+dev-python/gnome-python-desktop-base-2.24.1 (>=dev-python/pygtk-2.10.3)
+[...]
-# equery depgraph cdrtools
-Displaying dependencies for app-cdr/cdrtools-2.01_alpha37
-`-- app-cdr/cdrtools-2.01_alpha37
- `-- sys-libs/glibc-2.3.4.20040808 (virtual/libc)
- `-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers)
- `-- sys-apps/baselayout-1.10.4
- `-- sys-apps/sysvinit-2.85-r1
- `-- sys-apps/gawk-3.1.3-r1
- `-- sys-apps/util-linux-2.12-r4
- `-- sys-apps/sed-4.0.9
- `-- sys-libs/ncurses-5.4-r4
- `-- sys-apps/pam-login-3.14
- `-- sys-libs/pam-0.77-r1
- `-- sys-libs/cracklib-2.7-r10
- `-- sys-apps/miscfiles-1.3-r1
- `-- app-arch/gzip-1.3.5-r1
- `-- sys-apps/portage-2.0.50-r10
+
+$ 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) +[...]
-For example, while glibc is a direct dependency for cdrtools,linux-headers
-are an indirect dependency. Note that the output also includes information
-about virtual packages. In the example above,
-
-# equery files gentoolkit -[ Searching for packages matching gentoolkit... ] -app-portage/gentoolkit-0.2.0 -* Contents of app-portage/gentoolkit-0.2.0: -/usr -/usr/bin -/usr/bin/equery -/usr/bin/etcat -/usr/bin/euse -/usr/bin/glsa-check -/usr/bin/qpkg -/usr/bin/revdep-rebuild -/usr/lib -/usr/lib/gentoolkit -/usr/lib/gentoolkit/pym -/usr/lib/gentoolkit/pym/gentoolkit -/usr/lib/gentoolkit/pym/gentoolkit/__init__.py -/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py -/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py -/usr/lib/gentoolkit/pym/glsa.py -/usr/sbin -/usr/share -/usr/share/doc -/usr/share/doc/gentoolkit-0.2.0_pre10 - +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 executables were installed, use--filter=cmd , and to +quickly find the configuration file location, try--filter=conf . + + ++$ equery files --tree gentoolkit + * Searching for gentoolkit ... + * Contents of app-portage/gentoolkit-0.3.0_rc7: + /etc + > /eclean + + distfiles.exclude + + packages.exclude + > /env.d + + 99gentoolkit-env + > /revdep-rebuild + + 99revdep-rebuild + /usr + > /bin + + eclean + + eclean-dist -> eclean + + eclean-pkg -> eclean + + epkginfo + + equery + + eread + + euse + + glsa-check + + revdep-rebuild + > /lib + > /python2.6 + > /site-packages + > /gentoolkit + + gentoolkit-0.3.0_rc7-py2.6.egg-info + + __init__.py + > /equery + + __init__.py + + belongs.py + + changes.py + + check.py + + depends.py + + depgraph.py + + files.py [...]--The command
-files ofequery provide some options to modify -the output. You can look them all up in theequery man page. -
-If you want to find which packages on your system that make use of a specific
-USE flag,
-# equery hasuse firefox -[ Searching for USE flag firefox in all categories among: ] - * installed packages -[I--] [ ] dev-python/gnome-python-extras-2.14.0-r1 (0) -[I--] [ ] media-video/totem-2.16.4 (0) ++$ 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)
-
-# equery list gentoolkit -[ Searching for package 'gentoolkit' in all categories among: ] - * installed packages -[I--] [ ] app-portage/gentoolkit-0.2.0 (0) ++$ 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) +[...]-The standard query will search our installed packages for the name given. -If found, the following info will be displayed: the package location between -the first square brackets (I for Installed packages, P for Portage, O for -Overlay), the possible masks between the second (~ by keyword, - by arch or -M hard masked), then the category and complete name and last of all, the slot -in which the package is stored. +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
+ +I nstalled and from theP ortage +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. +
+ ++$ 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) ++ ++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. +
+Each package in the Portage tree provides at least some metadata about
+its maintainer, herd, etc. Read about
+$ equery meta gnucash + * app-office/gnucash [gentoo] + Herd: gnome-office (gnome-office@gentoo.org) + Maintainer: tove@gentoo.org (Torsten Veller) + Upstream: None specified + Location: /usr/portage/app-office/gnucash + Keywords: 2.2.9-r1:0: alpha amd64 ppc sparc x86 + Keywords: 2.2.9-r2:0: + Keywords: 2.3.8:0: + Keywords: 2.3.10:0: ~alpha ~amd64 ~ppc ~sparc ~x86 ++
-Another example, this time we are going to use the local options in order -to look for packages in our portage tree and overlay. +When the maintainer provides extra information, it can be very useful:
--# equery list -p -o vim -[ Searching for package 'vim' in all categories among: ] - * installed packages -[I--] [ ] app-editors/vim-6.3-r4 (0) - * Portage tree (/usr/portage) -[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0) -[-P-] [M~] app-editors/vim-7.0_alpha20050201 (0) -[-P-] [ ] app-editors/vim-6.3-r2 (0) -[-P-] [M~] app-editors/vim-7.0_alpha20050122 (0) -[-P-] [M~] app-editors/vim-core-7.0_alpha20050126 (0) -[-P-] [ ] app-editors/vim-core-6.3-r3 (0) -[-P-] [M~] app-editors/vim-core-7.0_alpha20050122 (0) -[-P-] [M~] app-editors/vim-core-7.0_alpha20050201 (0) -[-P-] [ ] app-editors/vim-core-6.3-r4 (0) - * overlay tree (/opt/ebuilds) ++$ 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.
@@ -366,52 +509,65 @@
-# equery size openoffice-bin -* app-office/openoffice-bin-1.1.2 - Total Files : 2908 - Total Size : 223353.31 KiB ++$ equery size openoffice-bin + * app-office/openoffice-bin-3.1.1 + Total files : 4624 + Total size : 361.38 MiB-As you can see,
equery prints the total space used in kilobytes and -also lists the total number of files the package has. +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 .
-
-# equery uses wireshark -[ Colour Code : set unset ] -[ Legend : (U) Col 1 - Current USE flags ] -[ : (I) Col 2 - Installed With USE flags ] - - U I [ Found these USE variables in : net-analyzer/wireshark-0.99.4 ] - - - adns : Adds support for the adns DNS client library - + + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit) - - - ipv6 : Adds support for IP version 6 - - - kerberos : Adds kerberos support - - - portaudio : Adds support for the crossplatform portaudio audio API - - - selinux : !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur - - - snmp : Adds support for the Simple Network Management Protocol if available - + + ssl : Adds support for Secure Socket Layer connections - - - threads : Adds threads support for various packages. Usually pthreads ++$ 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)-I have installed wireshark with only the gtk and ssl flags set, but there are -several other USE flags for wireshark still available. For more information on -USE flags, please refer to the
@@ -419,20 +575,40 @@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 USE Flags chapter of theGentoo Handbook .
-We can also find out which ebuild is being used for a specific package using
-
-# equery which cdrtools -/usr/portage/app-cdr/cdrtools/cdrtools-2.01_alpha37.ebuild ++$ equery which gnome +/usr/portage/gnome-base/gnome/gnome-2.26.3.ebuild++Lastly, if none of the above features of
+ +equery have answered your +question, try usingwhich to manually search an ebuild with programs + likecat ,less orgrep : ++$ grep HOMEPAGE $(equery which gentoolkit) +HOMEPAGE="http://www.gentoo.org/proj/en/portage/tools/index.xml" ++ ++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. +
# 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 + * Configuring search environment for revdep-rebuild -Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild. + * Checking reverse dependencies + * Packages containing binaries and libraries broken by a package update + * will be emerged. + + * Collecting system binaries and libraries + * Generated new 1_files.rr + * Collecting complete LD_LIBRARY_PATH + * Generated new 2_ldpath.rr + * Checking dynamic linking consistency +[ 48% ] * broken /usr/lib/gstreamer-0.10/libgsttaglib.la (requires /usr/lib/libtag.la) +[ 64% ] * broken /usr/lib/libgdkglext-x11-1.0.la (requires /usr/lib/libGLU.la) +[ 67% ] * broken /usr/lib/libgtkglext-x11-1.0.la (requires /usr/lib/libGLU.la) +[ 85% ] * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la (requires /usr/lib/libGLU.la) + * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la (requires /usr/lib/libGLU.la) +[ 97% ] * broken /usr/qt/3/lib/libqt-mt.la (requires -lpng) +[ 100% ] + * Generated new 3_broken.rr + * Assigning files to packages + * /usr/lib/gstreamer-0.10/libgsttaglib.la -> media-plugins/gst-plugins-taglib + * /usr/lib/libgdkglext-x11-1.0.la -> x11-libs/gtkglext + * /usr/lib/libgtkglext-x11-1.0.la -> x11-libs/gtkglext + * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la -> dev-python/pygtkglext + * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la -> dev-python/pygtkglext + * /usr/qt/3/lib/libqt-mt.la -> x11-libs/qt + * Generated new 4_raw.rr and 4_owners.rr + * Cleaning list of packages to rebuild + * Generated new 4_pkgs.rr + * Assigning packages to ebuilds + * Generated new 4_ebuilds.rr + * Evaluating package order + * Generated new 5_order.rr + * All prepared. Starting rebuild +emerge --oneshot --pretend dev-python/pygtkglext:0 +media-plugins/gst-plugins-taglib:0.10 +x11-libs/gtkglext:0 +x11-libs/qt:3 + +These are the packages that would be merged, in order: + +Calculating dependencies... done! +[ebuild R ] media-plugins/gst-plugins-taglib-0.10.17 +[ebuild R ] x11-libs/gtkglext-1.2.0 +[ebuild R ] x11-libs/qt-3.3.8b-r2 +[ebuild R ] dev-python/pygtkglext-1.1.0 + * Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.
@@ -722,7 +890,7 @@
-