rpmdb Class Reference
[PYTHON.]
A python rpmdb object represents an RPM database.
More...
Detailed Description
A python rpmdb object represents an RPM database.
Instances of the rpmdb object provide access to the records of a RPM database. The records are accessed by index number. To retrieve the header data in the RPM database, the rpmdb object is subscripted as you would access members of a list.
The rpmdb class contains the following methods:
- firstkey() Returns the index of the first record in the database.
- Deprecated:
- Legacy, use rpmdbMatchIterator instead.
- nextkey(index) Returns the index of the next record after "index" in the database.
- Parameters:
-
| index | current rpmdb location |
- Deprecated:
- Legacy, use rpmdbMatchIterator instead.
- findbyfile(file) Returns a list of the indexes to records that own file "file".
- Parameters:
-
| file | absolute path to file |
- findbyname(name) Returns a list of the indexes to records for packages named "name".
- Parameters:
-
- findbyprovides(dep) Returns a list of the indexes to records for packages that provide "dep".
- Parameters:
-
| dep | provided dependency string |
To obtain a rpmdb object, the opendb function in the rpm module must be called. The opendb function takes two optional arguments. The first optional argument is a boolean flag that specifies if the database is to be opened for read/write access or read-only access. The second argument specifies an alternate root directory for RPM to use.
An example of opening a database and retrieving the first header in the database, then printing the name of the package that the header represents:
import rpm
rpmdb = rpm.opendb()
index = rpmdb.firstkey()
header = rpmdb[index]
print header[rpm.RPMTAG_NAME]
To print all of the packages in the database that match a package name, the code will look like this: import rpm
rpmdb = rpm.opendb()
indexes = rpmdb.findbyname("foo")
for index in indexes:
header = rpmdb[index]
print "%s-%s-%s" % (header[rpm.RPMTAG_NAME],
header[rpm.RPMTAG_VERSION],
header[rpm.RPMTAG_RELEASE])
The documentation for this class was generated from the following file:
Generated on Wed Mar 8 22:44:31 2006 for rpm by
1.4.6