#include <db_cxx.h>
int
DbEnv::log_verify(DB_ENV *dbenv, const DB_LOG_VERIFY_CONFIG *config);
The DbEnv::log_verify() method verifies the integrity
of the log records of an environment and writes both error
and normal messages to the error/message output facility of the database environment handle.
The DbEnv::log_verify() method does not perform the
locking function, even in Berkeley DB environments that are configured with a
locking subsystem. Because this function does not access any database files, you can call it even when the environment has other threads of control
attached and running.
The DbEnv::log_verify() method returns DB_LOG_VERIFY_BAD when either log errors
are detected or the internal data storage layer does not work.
It returns EINVAL if you specify wrong configurations.
Unless otherwise specified, the DbEnv::log_verify()
method either returns a non-zero error value or throws an
exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
struct __db_logvrfy_config {
int continue_after_fail, verbose;
u_int32_t cachesize;
const char *temp_envhome;
const char *dbfile, *dbname;
DB_LSN start_lsn, end_lsn;
time_t start_time, end_time;
};
The continue_after_fail parameter specifies whether or not continue the verification process when an error in the log is detected.
The verbose parameter specifies whether or not to display verbose output during the verification process.
The cachesize parameter specifies the size of the cache of the temporary internal environment in bytes.
The temp_envhome parameter is the home directory of the temporary database environment that is used internally during the verification. It can be NULL, meaning the environment and all databases are in-memory.
The dbfile parameter specifies that for log records involving a database file, only those related to this database file are verified. Log records not involving database files are verified regardless of this parameter.
The dbname parameter specifies that for log records involving a database file, only those related to this database file are verified. Log records not involving database files are verified regardless of this parameter.
The start_lsn and end_lsn parameters specify the range of log records from the entire log set, that must be verified. Either of them can be [0][0], to specify an open ended range. If both of them are [0][0] (by default) the entire log is verified.
The start_time and end_time parameters specify range of log records from the entire log set that must be verified for a time range. Either of them can be 0, to specify an open ended range. If both of them are 0 (by default), the entire log is verified.
Note that the time range specified is not precise, because such a time range is converted to an lsn range based on the time points we know from transaction commits and checkpoints.
You can specify either an lsn range or a time range. You can neither specify both nor specify an lsn and a time as a range.
If the database is opened within a database environment, the
environment variable DB_HOME can be used as the path of the
database environment home.
The DbEnv::log_verify()
method may fail and throw a DbException
exception, encapsulating one of the following non-zero errors, or return one
of the following non-zero errors:
EINVAL or DB_LOG_VERIFY_BAD.