m4_comment([$Id: func.so,v 11.9 2001/03/01 15:58:20 bostic Exp $])m4_ref_title(Upgrading m4_db Applications,    Release 3.0: function arguments,, upgrade.3.0/envopen, upgrade.3.0/dbenv)m4_p([dnlIn m4_db 3.0, there are no longer separate structures that representeach subsystem (for example, DB_LOCKTAB or DB_TXNMGR), and an overallm4_ref(DbEnv) environment structure.  Instead there is only them4_ref(DbEnv) structure.  This means that m4_ref(DbEnv) referencesshould be passed around by your application instead of passing aroundDB_LOCKTAB or DB_TXNMGR references.])m4_p([dnlEach of the following functions:])m4_indent([dnllock_detectlock_getlock_idlock_putlock_statlock_vec])m4_p([dnlshould have its first argument, a reference to the DB_LOCKTAB structure,replaced with a reference to the enclosing m4_ref(DbEnv) structure.  Forexample, the following line of code from a m4_db 2.X application:])m4_indent([dnlDB_LOCKTAB *lt;DB_LOCK lock;	ret = lock_put(lt, lock);])m4_p([dnlshould now be written as follows:])m4_indent([dnlDB_ENV *dbenv;DB_LOCK *lock;	ret = lock_put(dbenv, lock);])m4_p([dnlSimilarly, all of the functions:])m4_indent([dnllog_archivelog_comparelog_filelog_flushlog_getlog_putlog_registerlog_statlog_unregister])m4_p([dnlshould have their DB_LOG argument replaced with a reference to am4_ref(DbEnv) structure, and the functions:])m4_indent([dnlmemp_fopenmemp_registermemp_statmemp_syncmemp_trickle])m4_p([dnlshould have their DB_MPOOL argument replaced with a reference to am4_ref(DbEnv) structure.])m4_p([dnlYou should remove all references to DB_LOCKTAB, DB_LOG, DB_MPOOL, andDB_TXNMGR structures from your application, they are no longer usefulin any way.  In fact, a simple way to identify all of the places thatneed to be upgraded is to remove all such structures and variablesthey declare, and then compile.  You will see a warning message fromyour compiler in each case that needs to be upgraded.])m4_page_footer