public String log_file(DbLsn lsn)
The DbEnv.log_file method maps
returning the name of the file containing the record named by lsn.
The len argument is the length of the namep buffer in bytes.
If namep is too short to hold the filename, DbEnv.log_file will
(Log filenames are normally quite short, on the order of 10 characters.)
This mapping of
to files is needed for database administration. For example, a
transaction manager typically records the earliest
needed for restart, and the database administrator may want to archive
log files to tape when they contain only
entries before the earliest one needed for restart.
The DbEnv.log_file method throws an exception that encapsulates a non-zero error value on
The DbEnv.log_file method may fail and throw an exception encapsulating a non-zero error for the following conditions:
- The supplied buffer was too small to hold the log filename.
The DbEnv.log_file method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods.
If a catastrophic error has occurred, the DbEnv.log_file method may fail and
throw a DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
DbEnv, DbLogc, DbLsn
Logging Subsystem and Related Methods
Copyright Sleepycat Software