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

Comparing BDB/BDB.pm (file contents):
Revision 1.40 by root, Tue Jul 8 08:35:12 2008 UTC vs.
Revision 1.44 by root, Wed Jul 9 21:08:29 2008 UTC

… …
109use strict 'vars'; 109use strict 'vars';
110 110
111use base 'Exporter'; 111use base 'Exporter';
112 112
113BEGIN { 113BEGIN {
114 our $VERSION = '1.6'; 114 our $VERSION = '1.7';
115 115
116 our @BDB_REQ = qw( 116 our @BDB_REQ = qw(
117 db_env_open db_env_close db_env_txn_checkpoint db_env_lock_detect 117 db_env_open db_env_close db_env_txn_checkpoint db_env_lock_detect
118 db_env_memp_sync db_env_memp_trickle db_env_dbrename db_env_dbremove 118 db_env_memp_sync db_env_memp_trickle db_env_dbrename db_env_dbremove
119 db_open db_close db_compact db_sync db_upgrade 119 db_open db_close db_compact db_sync db_upgrade
120 db_put db_get db_pget db_del db_key_range 120 db_put db_exists db_get db_pget db_del db_key_range
121 db_txn_commit db_txn_abort db_txn_finish 121 db_txn_commit db_txn_abort db_txn_finish
122 db_c_close db_c_count db_c_put db_c_get db_c_pget db_c_del 122 db_c_close db_c_count db_c_put db_c_get db_c_pget db_c_del
123 db_sequence_open db_sequence_close 123 db_sequence_open db_sequence_close
124 db_sequence_get db_sequence_remove 124 db_sequence_get db_sequence_remove
125 ); 125 );
… …
160In the following, C<$int> signifies an integer return value, 160In the following, C<$int> signifies an integer return value,
161C<bdb_filename> is a "filename" (octets on unix, madness on windows), 161C<bdb_filename> is a "filename" (octets on unix, madness on windows),
162C<U32> is an unsigned 32 bit integer, C<int> is some integer, C<NV> is a 162C<U32> is an unsigned 32 bit integer, C<int> is some integer, C<NV> is a
163floating point value. 163floating point value.
164 164
165The C<SV *> types are generic perl scalars (for input and output of data 165Most C<SV *> types are generic perl scalars (for input and output of data
166values), and the C<SV *callback> is the optional callback function to call 166values).
167when the request is completed.
168 167
169The various C<DB_ENV> etc. arguments are handles return by 168The various C<DB_ENV> etc. arguments are handles return by
170C<db_env_create>, C<db_create>, C<txn_begin> and so on. If they have an 169C<db_env_create>, C<db_create>, C<txn_begin> and so on. If they have an
171appended C<_ornull> this means they are optional and you can pass C<undef> 170appended C<_ornull> this means they are optional and you can pass C<undef>
172for them, resulting a NULL pointer on the C level. 171for them, resulting a NULL pointer on the C level.
172
173The C<SV *callback> is the optional callback function to call when the
174request is completed. This last callback argument is special: the callback
175is simply the last argument passed. If there are "optional" arguments
176before the callback they can be left out. The callback itself can be left
177out or specified as C<undef>, in which case the function will be executed
178synchronously.
179
180For example, C<db_env_txn_checkpoint> usually is called with all integer
181arguments zero. These can be left out, so all of these specify a call
182to C<< DB_ENV->txn_checkpoint >>, to be executed asynchronously with a
183callback to be called:
184
185 db_env_txn_checkpoint $db_env, 0, 0, 0, sub { };
186 db_env_txn_checkpoint $db_env, 0, 0, sub { };
187 db_env_txn_checkpoint $db_env, sub { };
188
189While these all specify a call to C<< DB_ENV->txn_checkpoint >> to be
190executed synchronously:
191
192 db_env_txn_checkpoint $db_env, 0, 0, 0, undef;
193 db_env_txn_checkpoint $db_env, 0, 0, 0;
194 db_env_txn_checkpoint $db_env, 0;
173 195
174=head3 BDB functions 196=head3 BDB functions
175 197
176Functions in the BDB namespace, exported by default: 198Functions in the BDB namespace, exported by default:
177 199
… …
202 flags: FREELIST_ONLY FREE_SPACE 224 flags: FREELIST_ONLY FREE_SPACE
203 db_sync (DB *db, U32 flags = 0, SV *callback = &PL_sv_undef) 225 db_sync (DB *db, U32 flags = 0, SV *callback = &PL_sv_undef)
204 db_key_range (DB *db, DB_TXN_ornull *txn, SV *key, SV *key_range, U32 flags = 0, SV *callback = &PL_sv_undef) 226 db_key_range (DB *db, DB_TXN_ornull *txn, SV *key, SV *key_range, U32 flags = 0, SV *callback = &PL_sv_undef)
205 db_put (DB *db, DB_TXN_ornull *txn, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef) 227 db_put (DB *db, DB_TXN_ornull *txn, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
206 flags: APPEND NODUPDATA NOOVERWRITE 228 flags: APPEND NODUPDATA NOOVERWRITE
229 db_exists (DB *db, DB_TXN_ornull *txn, SV *key, U32 flags = 0, SV *callback = 0)
207 db_get (DB *db, DB_TXN_ornull *txn, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef) 230 db_get (DB *db, DB_TXN_ornull *txn, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
208 flags: CONSUME CONSUME_WAIT GET_BOTH SET_RECNO MULTIPLE READ_COMMITTED READ_UNCOMMITTED RMW 231 flags: CONSUME CONSUME_WAIT GET_BOTH SET_RECNO MULTIPLE READ_COMMITTED READ_UNCOMMITTED RMW
209 db_pget (DB *db, DB_TXN_ornull *txn, SV *key, SV *pkey, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef) 232 db_pget (DB *db, DB_TXN_ornull *txn, SV *key, SV *pkey, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
210 flags: CONSUME CONSUME_WAIT GET_BOTH SET_RECNO MULTIPLE READ_COMMITTED READ_UNCOMMITTED RMW 233 flags: CONSUME CONSUME_WAIT GET_BOTH SET_RECNO MULTIPLE READ_COMMITTED READ_UNCOMMITTED RMW
211 db_del (DB *db, DB_TXN_ornull *txn, SV *key, U32 flags = 0, SV *callback = &PL_sv_undef) 234 db_del (DB *db, DB_TXN_ornull *txn, SV *key, U32 flags = 0, SV *callback = &PL_sv_undef)
… …
302 $int = $env->mutex_set_max (U32 max) 325 $int = $env->mutex_set_max (U32 max)
303 $int = $env->mutex_set_align (U32 align) 326 $int = $env->mutex_set_align (U32 align)
304 327
305 $txn = $env->txn_begin (DB_TXN_ornull *parent = 0, U32 flags = 0) 328 $txn = $env->txn_begin (DB_TXN_ornull *parent = 0, U32 flags = 0)
306 flags: READ_COMMITTED READ_UNCOMMITTED TXN_NOSYNC TXN_NOWAIT TXN_SNAPSHOT TXN_SYNC TXN_WAIT TXN_WRITE_NOSYNC 329 flags: READ_COMMITTED READ_UNCOMMITTED TXN_NOSYNC TXN_NOWAIT TXN_SNAPSHOT TXN_SYNC TXN_WAIT TXN_WRITE_NOSYNC
330 $txn = $env->cdsgroup_begin;
307 331
308=head4 Example: 332=head4 Example:
309 333
310 use AnyEvent; 334 use AnyEvent;
311 use BDB; 335 use BDB;

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines