import com.sleepycat.db.*;

public String file(DbLsn lsn)
	throws DbException;

Description

The DbLog.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 DbLog.file method throws an exception that encapsulates an errno on failure.

Errors

The DbLog.file method may fail and throw an exception for any of the errors specified for the following Berkeley DB and C library functions: abort(3), close(3), fcntl(3), fflush(3), fprintf(3), free(3), getenv(3), getpid(3), getuid(3), isdigit(3), malloc(3), memcpy(3), memset(3), open(3), sigfillset(3), sigprocmask(3), snprintf(3), stat(3), strcpy(3), strerror(3), strlen(3), unlink(3), vfprintf(3), and vsnprintf(3).

In addition, the DbLog.file method may fail and throw an exception encapsulating errno for the following conditions:

ENOMEM

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

Class

See Also