/*
 *     Copyright (c) 2000-2006 Alberto Reggiori <areggiori@webweaving.org>
 *                        Dirk-Willem van Gulik <dirkx@webweaving.org>
 *
 * NOTICE
 *
 * This product is distributed under a BSD/ASF like license as described in the 'LICENSE'
 * file you should have received together with this source code. If you did not get a
 * a copy of such a license agreement you can pick up one at:
 *
 *     http://rdfstore.sourceforge.net/LICENSE
 *
 */ 

Call back hanlder
	(void)hanlder( dbms_cause_t event, int counter)
	
	dbms_cause_t:
		DBMS_EVENT_RECONNECT		Lost connection, is reconnecting
		DBMS_EVENT_WAITING		Is connecting but long wait


	Return values possible

	dbms *			General struct. Do not touch.
	dbms_error_t		Error value; either errno or one of the E_ values see below.

extern char *
get_dbms_error( 
	dbms * me 
);

extern dbms *
dbms_connect(
        char *name, char * host, int port, int mode,
        void *(*_my_malloc)( size_t size),
        void(*_my_free)(void *),
        void(*_my_report)(dbms_cause_t cause, int count),
	int bt_compare_fcn_type
);

extern dbms_error_t
dbms_comms (
        dbms * me,
        int token, 
        int * retval,
        DBT * v1, 
        DBT * v2,
        DBT * r1,
        DBT * r2
        );

dbms_error_t values; beside normal
errno values from libc et. al.

E_UNDEF   
E_NONNUL   
E_FULLREAD  
E_FULLWRITE  
E_CLOSE       
E_HOSTNAME     
E_VERSION       
E_PROTO 
E_ERROR  
E_NOMEM   
E_RETRY   
E_NOPE
E_XXX  
E_TOOBIG
E_BUG   

Trick

	if 'DBMS_LOG' is set
		transactions are logged to that file.