Viewing file:  env_set_paniccall.html (3.28 KB) -rw-r--r--
Select action/file-type:
 (+) | (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
Berkeley DB: DB_ENV->set_paniccall
DB_ENV->set_paniccall
|
 |
#include <db.h>
int
DB_ENV->set_paniccall(DB_ENV *dbenv,
void (*db_panic_fcn)(DB_ENV *dbenv, int errval));
Description: DB_ENV->set_paniccall
Errors can occur in the Berkeley DB library where the only solution is to shut
down the application and run recovery (for example, if Berkeley DB is unable
to allocate heap memory). In such cases, the Berkeley DB methods will
return DB_RUNRECOVERY.
It is often easier to simply exit the application when such errors occur
rather than gracefully return up the stack. The DB_ENV->set_paniccall method
specifies a function to be called when
DB_RUNRECOVERY is about to be returned
from a Berkeley DB method.
The DB_ENV->set_paniccall method may be called at any time during the life of the
application.
The DB_ENV->set_paniccall method
returns a non-zero error value on failure
and 0 on success.
Parameters
- db_panic_fcn
- The db_panic_fcn parameter is the application-specified function
called in the case of a database environment panic. The function takes
two arguments:
- dbenv
- The dbenv parameter is the enclosing database environment handle.
- errval
- The errval parameter is the error value that would have been
returned to the caller if DB_RUNRECOVERY were not going to be
returned instead.
Class
DB_ENV
See Also
Database Environments and Related Methods
Copyright (c) 1996-2004 Sleepycat Software, Inc. - All rights reserved.
|