rpmdb(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPERATIONS | OPTIONS | CONFIGURATION | EXIT STATUS | EXAMPLES | OPTIONS | SEE ALSO | COLOPHON

RPMDB(8)                 System Manager's Manual                 RPMDB(8)

NAME         top

       rpmdb - RPM Database Tool

SYNOPSIS         top

       rpmdb [options] {--initdb|--rebuilddb}

       rpmdb [options] {--verifydb}

       rpmdb [options] {--exportdb|--importdb}

DESCRIPTION         top

       The rpmdb is used for rpm database maintenance operations.

OPERATIONS         top

       --initdb
           Create a new database if one doesn't already exist. An
           existing database is not overwritten.

       --rebuilddb
           Rebuild database from the installed package headers.
           Rebuilding discards any unreadable (corrupt) headers from the
           database, but also compacts the database in case it has grown
           large over time.

           Can also be used to convert between different rpmdb formats.

       --verifydb
           Perform a low-level integrity check on the database. Rarely
           useful, for system health rpm --verify -a is a far more
           meaningful operation.

       --exportdb
           Export the database in header-list format, suitable for
           transporting to another host or database type. The data is
           output to standard output.

       --importdb
           Imports a database from a header-list format as created by
           --exportdb. The data is read from standard input.

OPTIONS         top

       See rpm-common(8) for the options common to all rpm executables.

CONFIGURATION         top

       There are several configurables affecting the rpmdb operations,
       but in particular the following (see rpm-config(5) for details):
       •   %_dbpath%_db_backend

EXIT STATUS         top

       On success, 0 is returned, a nonzero failure code otherwise.

EXAMPLES         top

       rpmdb --initdb --dbpath /tmp/testdb
           Initialize a new database in /tmp/testdb directory.

       rpmdb --rebuilddb
           Rebuild the system rpmdb.

       rpmdb --verifydb --root /mnt
           Verify the system database of a system image mounted at /mnt.

       rpmdb --exportdb > /tmp/headers
           Export the system database to /tmp/headers file.

       rpmdb --importdb --define "_db_backend ndb" --dbpath /tmp/newdb <
       /tmp/headers
           Import contents of /tmp/headers header list to a (new) ndb-
           format database in /tmp/newdb.

OPTIONS         top

       See rpm-common(8) for the options common to all operations.

SEE ALSO         top

       popt(3), rpm(8), rpm-common(8)

       rpmdb --help - as rpm(8) supports customizing the options via popt
       aliases it's impossible to guarantee that what's described in the
       manual matches what's available.

       http://www.rpm.org/ 

COLOPHON         top

       This page is part of the rpm (RPM Package Manager) project.
       Information about the project can be found at 
       ⟨https://github.com/rpm-software-management/rpm⟩.  It is not known
       how to report bugs for this man page; if you know, please send a
       mail to man-pages@man7.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/rpm-software-management/rpm.git⟩ on
       2026-01-16.  (At that time, the date of the most recent commit
       that was found in the repository was 2026-01-15.)  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

RPM 6.0.90                      2026-01-16                       RPMDB(8)

Pages that refer to this page: yum-ovl(1)rpm(8)rpm-common(8)