m4_comment([$Id: err.so,v 1.3 2004/09/28 14:13:09 bostic Exp $])

m4_ref_title(Upgrading m4_db Applications,
    [Release 4.3: DB_ENV-__GT__set_errcall, DB-__GT__set_errcall],,
    upgrade.4.3/java, upgrade.4.3/cput)

m4_p([dnl
The signature of the error callback passed to the
m4_ref(dbenv_set_errcall) and m4_refT(dbh_set_errcall)s has changed in
the 4.3 release.  For example, if you previously had a function such as
this:])

m4_indent([dnl
void handle_db_error(const char *prefix, char *message);])

m4_p([dnl
it should be changed to this:])

m4_indent([dnl
void handle_db_error(const DB_ENV *dbenv,
    const char *prefix, const char *message);])

m4_p([dnl
This change adds the m4_ref(DbEnv) handle to provide database
environment context for the callback function, and incidentally makes
it clear the message parameter cannot be changed by the callback.])

m4_page_footer