# DbEnv.log_file |

`

###

    import com.sleepycat.db.*;

    public String log_file(DbLsn lsn)
    	throws DbException;

# Description

The DbEnv.log_file method maps DbLsn objects to file names, returning the name of the file containing the record named by lsn.

This mapping of DbLsn objects to files is needed for database administration. For example, a transaction manager typically records the earliest DbLsn needed for restart, and the database administrator may want to archive log files to tape when they contain only DbLsn entries before the earliest one needed for restart.

The DbEnv.log_file method throws an exception that encapsulates a non-zero error value on failure.

# Errors

If a fatal error occurs in Berkeley DB, the DbEnv.log_file method will fail and throw a DbRunRecoveryException, at which point all subsequent database calls will fail in the same way.

In addition, the DbEnv.log_file method may fail and throw an exception encapsulating a non-zero error for the following conditions:

ENOMEM
  The supplied buffer was too small to hold the log file name.

In addition, the DbEnv.log_file method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods.

### Class

DbEnv

# See Also

DbEnv.set_lg_bsize, DbEnv.set_lg_max, DbEnv.log_archive, DbEnv.log_compare, DbEnv.log_file, DbEnv.log_flush, DbEnv.log_get, DbEnv.log_put, DbEnv.log_register, DbEnv.log_stat and DbEnv.log_unregister.`

Copyright Sleepycat Software