ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/BDB/BDB.pm
(Generate patch)

Comparing BDB/BDB.pm (file contents):
Revision 1.56 by root, Fri Jan 9 22:32:12 2009 UTC vs.
Revision 1.70 by root, Thu Jan 18 16:45:27 2018 UTC

27 db_sync $db; 27 db_sync $db;
28 28
29 # when you also use Coro, management is easy: 29 # when you also use Coro, management is easy:
30 use Coro::BDB; 30 use Coro::BDB;
31 31
32 # automatic event loop intergration with AnyEvent: 32 # automatic event loop integration with AnyEvent:
33 use AnyEvent::BDB; 33 use AnyEvent::BDB;
34 34
35 # automatic result processing with EV: 35 # automatic result processing with EV:
36 my $WATCHER = EV::io BDB::poll_fileno, EV::READ, \&BDB::poll_cb; 36 my $WATCHER = EV::io BDB::poll_fileno, EV::READ, \&BDB::poll_cb;
37 37
103 103
104=cut 104=cut
105 105
106package BDB; 106package BDB;
107 107
108no warnings; 108use common::sense;
109use strict 'vars';
110 109
111use base 'Exporter'; 110use base 'Exporter';
112 111
113our $VERSION; 112our $VERSION;
114 113
115BEGIN { 114BEGIN {
116 $VERSION = '1.83'; 115 $VERSION = '1.92';
117 116
118 our @BDB_REQ = qw( 117 our @BDB_REQ = qw(
119 db_env_open db_env_close db_env_txn_checkpoint db_env_lock_detect 118 db_env_open db_env_close db_env_txn_checkpoint db_env_lock_detect
120 db_env_memp_sync db_env_memp_trickle db_env_dbrename db_env_dbremove 119 db_env_memp_sync db_env_memp_trickle db_env_dbrename db_env_dbremove
121 db_env_log_archive 120 db_env_log_archive db_env_lsn_reset db_env_fileid_reset
122 db_open db_close db_compact db_sync db_verify db_upgrade 121 db_open db_close db_compact db_sync db_verify db_upgrade
123 db_put db_exists db_get db_pget db_del db_key_range 122 db_put db_exists db_get db_pget db_del db_key_range
124 db_txn_commit db_txn_abort db_txn_finish 123 db_txn_commit db_txn_abort db_txn_finish
125 db_c_close db_c_count db_c_put db_c_get db_c_pget db_c_del 124 db_c_close db_c_count db_c_put db_c_get db_c_pget db_c_del
126 db_sequence_open db_sequence_close 125 db_sequence_open db_sequence_close
204 db_env_memp_sync (DB_ENV *env, SV *dummy = 0, SV *callback = 0) 203 db_env_memp_sync (DB_ENV *env, SV *dummy = 0, SV *callback = 0)
205 db_env_memp_trickle (DB_ENV *env, int percent, SV *dummy = 0, SV *callback = 0) 204 db_env_memp_trickle (DB_ENV *env, int percent, SV *dummy = 0, SV *callback = 0)
206 db_env_dbremove (DB_ENV *env, DB_TXN_ornull *txnid, bdb_filename file, bdb_filename database, U32 flags = 0, SV *callback = 0) 205 db_env_dbremove (DB_ENV *env, DB_TXN_ornull *txnid, bdb_filename file, bdb_filename database, U32 flags = 0, SV *callback = 0)
207 db_env_dbrename (DB_ENV *env, DB_TXN_ornull *txnid, bdb_filename file, bdb_filename database, bdb_filename newname, U32 flags = 0, SV *callback = 0) 206 db_env_dbrename (DB_ENV *env, DB_TXN_ornull *txnid, bdb_filename file, bdb_filename database, bdb_filename newname, U32 flags = 0, SV *callback = 0)
208 db_env_log_archive (DB_ENV *env, SV *listp, U32 flags = 0, SV *callback = 0) 207 db_env_log_archive (DB_ENV *env, SV *listp, U32 flags = 0, SV *callback = 0)
208 db_env_lsn_reset (DB_ENV *env, bdb_filename db, U32 flags = 0, SV *callback = 0)
209 db_env_fileid_reset (DB_ENV *env, bdb_filename db, U32 flags = 0, SV *callback = 0)
209 210
210 $db = db_create (DB_ENV *env = 0, U32 flags = 0) 211 $db = db_create (DB_ENV *env = 0, U32 flags = 0)
211 flags: XA_CREATE 212 flags: XA_CREATE
212 213
213 db_open (DB *db, DB_TXN_ornull *txnid, bdb_filename file, bdb_filename database, int type, U32 flags, int mode, SV *callback = 0) 214 db_open (DB *db, DB_TXN_ornull *txnid, bdb_filename file, bdb_filename database, int type, U32 flags, int mode, SV *callback = 0)
772 773
773=head2 Unexpected Crashes 774=head2 Unexpected Crashes
774 775
775Remember that, by default, BDB will execute requests in parallel, in 776Remember that, by default, BDB will execute requests in parallel, in
776somewhat random order. That means that it is easy to run a C<db_get> 777somewhat random order. That means that it is easy to run a C<db_get>
777request on thesa me database as a concurrent C<db_close> request, leading 778request on the same database as a concurrent C<db_close> request, leading
778to a crash, silent data corruption, eventually the next world war on 779to a crash, silent data corruption, eventually the next world war on
779terrorism. 780terrorism.
780 781
781If you only ever use foreground requests (without a callback), this will 782If you only ever use foreground requests (without a callback), this will
782not be an issue. 783not be an issue (unless you use threads).
783 784
784=head2 Unexpected Freezes or Deadlocks 785=head2 Unexpected Freezes or Deadlocks
785 786
786Remember that, by default, BDB will execute requests in parallel, which 787Remember that, by default, BDB will execute requests in parallel, which
787easily leads to deadlocks (even concurrent put's on the same database can 788easily leads to deadlocks (even concurrent put's on the same database can

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines