DbEnv::log_register |
![]() ![]() |
#include <db_cxx.h>int DbEnv::log_register(Db *dbp, const char *name, int32_t *fidp);
The DbEnv::log_register method registers a file name with the log manager and copies a file identification number into the memory location referenced by fidp.
This file identification number should be used in all subsequent log messages that refer to operations on the file. The log manager records all file name to file identification number mappings at each checkpoint so that a recovery process can identify the file to which a record in the log refers.
The dbp parameter should be a reference to a Db object.
The DbEnv::log_register 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.
In addition, the DbEnv::log_register method may fail and throw an exception or return a non-zero error for the following conditions:
In addition, the DbEnv::log_register method may fail and throw an exception or return a non-zero error for errors specified for other Berkeley DB and C library or system methods.
![]() ![]() |