rpmcache

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 lat-
       est  (i.e. comparing package epoch/version/release for identical pack-
       age 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 concatenation 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) expres-
	      sion) 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 configured
       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)