#include <db_cxx.h>
int
DbEnv::dbbackup(const char *dbfile, const char *target,
u_int32_t flags);
The DbEnv::dbbackup() method performs a hot
backup of a single database file contained within the environment.
To back up an entire environment, use the DbEnv::backup() method.
This method's default behavior can be changed by setting backup callbacks. See DbEnv::set_backup_callbacks() for more information. Additional tuning parameters can also be set using the DbEnv::set_backup_config() method.
The DbEnv::dbbackup() method may only be
called after the environment handle has been opened.
The DbEnv::dbbackup()
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.
Identifies the directory in which the back up will be
placed. This target must exist; otherwise this method
exits with an ENOENT error return.
Note that if the backup callbacks are set, then the value
specified to this parameter is passed on to the
open_func() callback. If this
parameter is NULL, then the target must be specified
directly to the open_func() callback.
The DbEnv::dbbackup()
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:
DB_EXCL was specified for the
flags parameter, and an existing target
file was discovered when attempting to back up a source
file.