+I&Berkeley DB: DbLog.file[P

DbLog.file





import com.sleepycat.db.*;

public String file(DbLsn lsn) throws DbException;





Description



The DbLog.file method maps;DbLsn objectsto file names,Ireturning 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, a2transaction manager typically records the earliest3DbLsnFneeded for restart, and the database administrator may want to archive(log files to tape when they contain only3DbLsn3entries before the earliest one needed for restart.

The DbLog.fileHmethod throws an exception that encapsulates an errno on failure.



Errors

RIf a fatal error occurs in Berkeley DB, the DbLog.file method may fail and throw a}DbRunRecoveryException, at which point all subsequent database%calls will also fail in the same way.

The DbLog.file&method may fail and throw an exceptionKfor 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 exceptionencapsulating errnofor the following conditions:

M

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




Class

3DbLog



See Also

>DbLog.archive,:DbLog.close,>DbLog.compare, DbLog.file,:DbLog.flush,6DbLog.get,8DbLog.open,6DbLog.put,FDbLog.db_register,8DbLog.stat,;DbLog.unlinkandJDbLog.db_unregister.
ÿÿ