RPMCACHE(8)							   Red Hat Linux						       RPMCACHE(8)

NAME

       rpmcache - Cache RPM Package Headers

SYNOPSIS

       rpmcache [ PACKAGE_NAME ... ]

DESCRIPTION

       rpmcache walks a file tree, possibly remotely using FTP, filtering paths using glob(7) expressions, reading rpm package headers. The latest
       (i.e. comparing package epoch/version/release for identical package names and using the build time as a tie breaker)  package  headers,	if
       they  are  unique,  are	cached in an rpm database.  The rpm database cache can be used to provide suggested paths to packages that resolve
       unknown dependencies.

       There are no rpmcache specific options, only common rpm options.  See the rpmcache usage message for what is currently implemented.

       The file tree path to be searched is configured using rpm macros. The final path is the concatentaion of 5 individual  elements.  Here  are
       the  macro  names  used	to  configure  rpmcache, in the same order that they will be concatenated to build the file tree path that will be
       walked:

       %_bhpath
	      The "path" level contains the leading part of the file tree path (or URL) for the file tree to be walked.  No  glob(7)  expressions,
	      here, please.

       %_bhcoll
	      The "collection" level contains a string (or glob(7) expression) to match sub-directories of %_bhpath.

       %_bhN  The  "name"  level  contains  a string (or glob(7) expression) to match sub-directories of %_bhcoll.  The PACKAGE_NAME arguments are
	      used to construct a glob(7) expression that will match any of specific package names within the Red Hat build system, and are almost
	      certainly not of use to anyone outside of Red Hat.

       %_bhVR The "version-release" level contains a string (or glob(7) expression) to match sub-directories of %_bhN.

       %_bhA  The "arch" level contains a string (or glob(7) expression) to match sub-directories of %_bhVR.

       The location of the cache database is also configured using an rpm macro:

       %_cache_dbpath
	      The location of the cache database. The default value is /var/spool/up2date/cache.

       The cache database is identical in format to an rpm database, and can be used with rpm from the command line. For example, to use the cache
       database to provide suggestions for packages that provide dependencies needed by a package install, the following macro should  be  config-
       ured in either /etc/rpm/macros or ~/.rpmmacros:

       %_solve_dbpath
	      The location of the database that is used to provide suggested dependency resolutions.

   Example (minimal) configuration for a Red Hat beehive tree:
       %_cache_dbpath  /var/spool/up2date/cache
       %_solve_dbpath  %{_cache_dbpath}
       %_bhpath        file://localhost/mnt/redhat/beehive/comps/dist
       %_bhcoll        7.3
       %_bhN	       @(basesystem|bash|filesystem|glibc-common|glibc|ldconfig|libtermcap|mktemp|setup|termcap)
       %_bhVR	       *
       %_bhA	       @(i[3456]86|noarch)

   Example (minimal) configuration for a Red Hat FTP tree:
       %_cache_dbpath  /var/spool/up2date/cache
       %_solve_dbpath  %{_cache_dbpath}
       %_bhpath        ftp://localhost/mnt/dist
       %_bhcoll        @(7.3|7.2|7.1|7.0|6.2|6.1|6.0|5.2|5.1|5.0)
       %_bhN	       @(%{_arch})
       %_bhVR	       *
       %_bhA	       @(i[3456]86|noarch)

BUGS

       Yup.  Please file bug reports and RFE's against the rpm-devel package using bugzilla: http://bugzilla.redhat.com/ <URL:http://bugzilla.red-
       hat.com/>

SEE ALSO

       rpm(8), glob(7),

	http://www.rpm.org/ <URL:http://www.rpm.org/>

AUTHORS

       Jeff Johnson <jbj@redhat.com>

Red Hat, Inc.							   05 July 2002 						       RPMCACHE(8)