Introduction

-Introduction - - -

-qpkg is a flexible tool for determining information about installed -ebuilds. It can provide information about what files belong to which ebuilds, -whether multiple versions of the same package are installed and what a -particular ebuild does. It can also be used to query some information about -ebuilds that have not been installed. -

- -

-Calling qpkg with no arguments prints a list of all ebuilds with -asterisks (*) next to the packages that are installed on the system. -

- - -By default, qpkg prints output in color. To turn this off on the command -line, use the --no-color or -nc flag. - - - -

-Querying Package Information - - -

-One of the most common uses for qpkg is determining what a given package -is. For instance, while looking through net-misc, I saw a package -called neon. Having no idea what it was, I ran qpkg. -

- -

-# qpkg -i net-misc/neon
-net-misc/neon-0.24.4
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-net-misc/neon-0.23.8
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-net-misc/neon-0.24.6
-        HTTP and WebDAV client library [ http://www.webdav.org/neon/ ]
-net-misc/neon-0.24.5
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-net-misc/neon-0.24.0
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-net-misc/neon-0.21.3
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-net-misc/neon-0.23.9
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-net-misc/neon-0.24.7
-        HTTP and WebDAV client library [ http://www.webdav.org/neon/ ]
-net-misc/neon-0.24.2
-        HTTP and WebDAV client library [ http://www.webdav.org/neon ]
-

- -

-qpkg read through the ebuild files for the nine -net-misc/neon ebuilds and printed out the information stored in -DESCRIPTION and HOMEPAGE. -

- - -

-Listing Files Belonging to an Ebuild - - -

-qpkg can also list the files that belong to an installed ebuild. I -know that gentoolkit installed several tools, but I don't know what they -all are. To find out, I can do a qpkg -l. -

- -

-# qpkg -l app-portage/gentoolkit
-app-portage/gentoolkit-0.2.0_pre8 *
-CONTENTS:
-/usr
-/usr/bin
-/usr/bin/euse
-/usr/bin/qpkg
-/usr/bin/etcat
-/usr/bin/revdep-rebuild
-/usr/bin/glsa-check
-/usr/bin/dep-clean
-/usr/bin/equery
-/usr/bin/ewhich
-/usr/bin/pkg-size
-/usr/lib
-/usr/lib/gentoolkit
-/usr/lib/gentoolkit/pym
-/usr/lib/gentoolkit/pym/glsa.py
-/usr/lib/gentoolkit/pym/gentoolkit.py
-/usr/sbin
-/usr/sbin/pkg-clean
-/usr/sbin/mkebuild
-/usr/share
-/usr/share/doc
-/usr/share/doc/gentoolkit-0.2.0_pre8
-/usr/share/doc/gentoolkit-0.2.0_pre8/NEWS
-/usr/share/doc/gentoolkit-0.2.0_pre8/TODO
-/usr/share/doc/gentoolkit-0.2.0_pre8/euse
-/usr/share/doc/gentoolkit-0.2.0_pre8/euse/TODO
-/usr/share/doc/gentoolkit-0.2.0_pre8/euse/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/euse/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/euse/ChangeLog
-/usr/share/doc/gentoolkit-0.2.0_pre8/qpkg
-/usr/share/doc/gentoolkit-0.2.0_pre8/qpkg/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/qpkg/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/qpkg/ChangeLog
-/usr/share/doc/gentoolkit-0.2.0_pre8/etcat
-/usr/share/doc/gentoolkit-0.2.0_pre8/etcat/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/etcat/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/revdep-rebuild
-/usr/share/doc/gentoolkit-0.2.0_pre8/revdep-rebuild/TODO
-/usr/share/doc/gentoolkit-0.2.0_pre8/revdep-rebuild/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/revdep-rebuild/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/equery
-/usr/share/doc/gentoolkit-0.2.0_pre8/equery/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/equery/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/gentoolkit
-/usr/share/doc/gentoolkit-0.2.0_pre8/gentoolkit/TODO
-/usr/share/doc/gentoolkit-0.2.0_pre8/gentoolkit/README
-/usr/share/doc/gentoolkit-0.2.0_pre8/gentoolkit/AUTHORS
-/usr/share/doc/gentoolkit-0.2.0_pre8/gentoolkit/ChangeLog
-/usr/share/doc/gentoolkit-0.2.0_pre8/ChangeLog
-/usr/share/doc/gentoolkit-0.2.0_pre8/COPYING
-/usr/share/man
-/usr/share/man/man1
-/usr/share/man/man1/revdep-rebuild.1.gz
-/usr/share/man/man1/mkebuild.1.gz
-/usr/share/man/man1/qpkg.1.gz
-/usr/share/man/man1/pkg-clean.1.gz
-/usr/share/man/man1/etcat.1.gz
-/usr/share/man/man1/ewhich.1.gz
-/usr/share/man/man1/equery.1.gz
-/usr/share/man/man1/euse.1.gz
-/usr/share/man/man1/dep-clean.1.gz
-/usr/share/man/man1/pkg-size.1.gz
-

- - -In case you have gentoolkit-dev installed, qpkg will list out files for -that as well, i.e. it displays the file list for all installed packages with -the name gentoolkit. - - - -

-Listing Duplicate Packages - - -

-Sometimes multiple versions of the same package may exist. qpkg --dups -will print a list of duplicate packages. The existence of a duplicate package -though may not indicate that the older version may be removed. They may fill -different slots. To look for duplicates in the same slot, use qpkg --dups ---slot. I just updated KDE from 3.0 to 3.0.2, so I have some duplicates in -the same slot. -

- -

-# qpkg --dups --slot
-app-portage/gentoolkit
-kde-base/kdeaddons
-kde-base/kdeadmin
-kde-base/kdeartwork
-kde-base/kdebase
-kde-base/kdegames
-kde-base/kdelibs
-kde-base/kdemultimedia
-kde-base/kdenetwork
-kde-base/kdetoys
-kde-base/kdeutils
-media-libs/freetype
-x11-libs/qt
-

- - -

-Verifying Package Integrity - - -

-Sometimes it is useful to check a package's integrity to know that files have -not been replaced since they were installed. qpkg can verify md5 sums as -well as install times to indicate whether files for the package might have been -corrupted, replaced, or removed. -

- -

-To check both mtimes and md5 sums, use the -c flag. -

- -

-# qpkg cdrtools -c -v
-app-cdr/cdrtools-2.01_alpha25 *
-/etc/default/rscsi.dfl !mtime!
-/usr/bin/devdump !md5! !mtime!
-/usr/bin/mkisofs !md5! !mtime!
-/usr/bin/isovfy !md5! !mtime!
-/usr/bin/readcd !md5! !mtime!
-/usr/bin/cdda2wav !md5! !mtime!
-/usr/bin/cdrecord !md5! !mtime!
-/usr/bin/isodump !md5! !mtime!
-/usr/bin/isoinfo !md5! !mtime!
-/usr/lib/libfile.a !md5! !mtime!
-/usr/lib/librscg.a !md5! !mtime!
-/usr/lib/libunls.a !md5! !mtime!
-/usr/lib/libedc_ecc.a !md5! !mtime!
-/usr/lib/libdeflt.a !md5! !mtime!
-/usr/lib/libhfs.a !md5! !mtime!
-/usr/lib/libscg.a !md5! !mtime!
-/usr/lib/libparanoia.a !md5! !mtime!
-/usr/lib/libschily.a !md5! !mtime!
-/usr/sbin/rscsi !md5! !mtime!
-/usr/share/man/man1/cdrecord.1.gz !md5! !mtime!
-/usr/share/man/man1/readcd.1.gz !md5! !mtime!
-/usr/share/man/man1/cdda2wav.1.gz !md5! !mtime!
-/usr/share/man/man8/mkisofs.8.gz !md5! !mtime!
-76/150
-
-app-cdr/cdrtools-2.01_alpha37 *
-0/122
-

- -

-As you can see, I have more than one version of cdrtools installed. qpkg -reports that many of the files from the older version have been changed since I -installed it. Those packages were most likely modified when I updated from -cdrtools-2.01_alpha25 to cdrtools-2.01_alpha37. Note -that the last two lines indicate that 0 of 122 files from cdrtools-2.01 -_alpha37 have been changed since I installed. That is good. If any of -them had been changed, I would be worried. -

- - -