#include <db.h>
int
DB_ENV->dbbackup(DB_ENV *dbenv, const char *dbfile, const char *target,
u_int32_t flags);
The DB_ENV->dbbackup() method performs a hot
backup of a single database file contained within the environment.
To back up an entire environment, use the DB_ENV->backup() method.
This method's default behavior can be changed by setting backup callbacks. See DB_ENV->set_backup_callbacks() for more information. Additional tuning parameters can also be set using the DB_ENV->set_backup_config() method.
The DB_ENV->dbbackup() method may only be
called after the environment handle has been opened.
The DB_ENV->dbbackup()
method returns a non-zero error value on failure and 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 DB_ENV->dbbackup()
method may fail and 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.