Version 2.4.1
WT_EVENT_HANDLER Struct Reference

The interface implemented by applications to handle error, informational and progress messages. More...

Public Attributes

int(* handle_error )(WT_EVENT_HANDLER *handler, WT_SESSION *session, int error, const char *message)
 Callback to handle error messages; by default, error messages are written to the stderr stream. More...
 
int(* handle_message )(WT_EVENT_HANDLER *handler, WT_SESSION *session, const char *message)
 Callback to handle informational messages; by default, informational messages are written to the stdout stream. More...
 
int(* handle_progress )(WT_EVENT_HANDLER *handler, WT_SESSION *session, const char *operation, uint64_t progress)
 Callback to handle progress messages; by default, no progress messages are written. More...
 
int(* handle_close )(WT_EVENT_HANDLER *handler, WT_SESSION *session, WT_CURSOR *cursor)
 Callback to handle automatic close of a WiredTiger handle. More...
 

Detailed Description

The interface implemented by applications to handle error, informational and progress messages.

Entries set to NULL are ignored and the default handlers will continue to be used.

Member Data Documentation

int(* WT_EVENT_HANDLER::handle_close)(WT_EVENT_HANDLER *handler, WT_SESSION *session, WT_CURSOR *cursor)

Callback to handle automatic close of a WiredTiger handle.

Close handler returns are not ignored: if the handler returns non-zero, the error may cause the WiredTiger function posting the event to fail, and may even cause operation or library failure.

Parameters
sessionThe session handle that is being closed if the cursor parameter is NULL.
cursorThe cursor handle that is being closed, or NULL if it is a session handle being closed.
int(* WT_EVENT_HANDLER::handle_error)(WT_EVENT_HANDLER *handler, WT_SESSION *session, int error, const char *message)

Callback to handle error messages; by default, error messages are written to the stderr stream.

Error handler returns are not ignored: if the handler returns non-zero, the error may cause the WiredTiger function posting the event to fail, and may even cause operation or library failure.

Parameters
sessionthe WiredTiger session handle in use when the error was generated. The handle may have been created by the application or automatically by WiredTiger.
errora WiredTiger, C99 or POSIX error code, which can be converted to a string using wiredtiger_strerror
messagean error string
int(* WT_EVENT_HANDLER::handle_message)(WT_EVENT_HANDLER *handler, WT_SESSION *session, const char *message)

Callback to handle informational messages; by default, informational messages are written to the stdout stream.

Message handler returns are not ignored: if the handler returns non-zero, the error may cause the WiredTiger function posting the event to fail, and may even cause operation or library failure.

Parameters
sessionthe WiredTiger session handle in use when the message was generated. The handle may have been created by the application or automatically by WiredTiger.
messagean informational string
int(* WT_EVENT_HANDLER::handle_progress)(WT_EVENT_HANDLER *handler, WT_SESSION *session, const char *operation, uint64_t progress)

Callback to handle progress messages; by default, no progress messages are written.

Progress handler returns are not ignored: if the handler returns non-zero, the error may cause the WiredTiger function posting the event to fail, and may even cause operation or library failure.

Parameters
sessionthe WiredTiger session handle in use when the progress message was generated. The handle may have been created by the application or automatically by WiredTiger.
operationa string representation of the operation
progressa counter