ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/BDB/BDB.xs
Revision: 1.16
Committed: Mon Aug 13 12:01:45 2007 UTC (16 years, 9 months ago) by root
Branch: MAIN
CVS Tags: rel-1_0
Changes since 1.15: +23 -5 lines
Log Message:
vastly improved docs

File Contents

# Content
1 #include "xthread.h"
2
3 #include <errno.h>
4
5 #include "EXTERN.h"
6 #include "perl.h"
7 #include "XSUB.h"
8
9 // perl stupidly defines these as macros, breaking
10 // lots and lots of code.
11 #undef open
12 #undef close
13 #undef abort
14 #undef malloc
15 #undef free
16 #undef send
17
18 #include <stddef.h>
19 #include <stdlib.h>
20 #include <errno.h>
21 #include <sys/types.h>
22 #include <limits.h>
23 #include <fcntl.h>
24
25 #ifndef _WIN32
26 # include <sys/time.h>
27 # include <unistd.h>
28 #endif
29
30 #include <db.h>
31
32 #if DB_VERSION_MAJOR < 4 || (DB_VERSION_MAJOR == 4 && DB_VERSION_MINOR < 4)
33 # error you need Berkeley DB 4.4 or newer installed
34 #endif
35
36 /* number of seconds after which idle threads exit */
37 #define IDLE_TIMEOUT 10
38
39 typedef DB_ENV DB_ENV_ornull;
40 typedef DB_TXN DB_TXN_ornull;
41 typedef DBC DBC_ornull;
42 typedef DB DB_ornull;
43 typedef DB_SEQUENCE DB_SEQUENCE_ornull;
44
45 typedef SV SV8; /* byte-sv, used for argument-checking */
46 typedef char *octetstring;
47
48 static SV *prepare_cb;
49
50 #if DB_VERSION_MINOR >= 6
51 # define c_close close
52 # define c_count count
53 # define c_del del
54 # define c_dup dup
55 # define c_get get
56 # define c_pget pget
57 # define c_put put
58 #endif
59
60 static void
61 debug_errcall (const DB_ENV *dbenv, const char *errpfx, const char *msg)
62 {
63 printf ("err[%s]\n", msg);
64 }
65
66 static void
67 debug_msgcall (const DB_ENV *dbenv, const char *msg)
68 {
69 printf ("msg[%s]\n", msg);
70 }
71
72 static char *
73 strdup_ornull (const char *s)
74 {
75 return s ? strdup (s) : 0;
76 }
77
78 static void
79 sv_to_dbt (DBT *dbt, SV *sv)
80 {
81 STRLEN len;
82 char *data = SvPVbyte (sv, len);
83
84 dbt->data = malloc (len);
85 memcpy (dbt->data, data, len);
86 dbt->size = len;
87 dbt->flags = DB_DBT_REALLOC;
88 }
89
90 static void
91 dbt_to_sv (SV *sv, DBT *dbt)
92 {
93 if (sv)
94 {
95 SvREADONLY_off (sv);
96 sv_setpvn_mg (sv, dbt->data, dbt->size);
97 SvREFCNT_dec (sv);
98 }
99
100 free (dbt->data);
101 }
102
103 enum {
104 REQ_QUIT,
105 REQ_ENV_OPEN, REQ_ENV_CLOSE, REQ_ENV_TXN_CHECKPOINT, REQ_ENV_LOCK_DETECT,
106 REQ_ENV_MEMP_SYNC, REQ_ENV_MEMP_TRICKLE,
107 REQ_DB_OPEN, REQ_DB_CLOSE, REQ_DB_COMPACT, REQ_DB_SYNC,
108 REQ_DB_PUT, REQ_DB_GET, REQ_DB_PGET, REQ_DB_DEL, REQ_DB_KEY_RANGE,
109 REQ_TXN_COMMIT, REQ_TXN_ABORT,
110 REQ_C_CLOSE, REQ_C_COUNT, REQ_C_PUT, REQ_C_GET, REQ_C_PGET, REQ_C_DEL,
111 REQ_SEQ_OPEN, REQ_SEQ_CLOSE, REQ_SEQ_GET, REQ_SEQ_REMOVE,
112 };
113
114 typedef struct aio_cb
115 {
116 struct aio_cb *volatile next;
117 SV *callback;
118 int type, pri, result;
119
120 DB_ENV *env;
121 DB *db;
122 DB_TXN *txn;
123 DBC *dbc;
124
125 UV uv1;
126 int int1, int2;
127 U32 uint1, uint2;
128 char *buf1, *buf2;
129 SV *sv1, *sv2, *sv3;
130
131 DBT dbt1, dbt2, dbt3;
132 DB_KEY_RANGE key_range;
133 DB_SEQUENCE *seq;
134 db_seq_t seq_t;
135 } aio_cb;
136
137 typedef aio_cb *aio_req;
138
139 enum {
140 PRI_MIN = -4,
141 PRI_MAX = 4,
142
143 DEFAULT_PRI = 0,
144 PRI_BIAS = -PRI_MIN,
145 NUM_PRI = PRI_MAX + PRI_BIAS + 1,
146 };
147
148 #define AIO_TICKS ((1000000 + 1023) >> 10)
149
150 static unsigned int max_poll_time = 0;
151 static unsigned int max_poll_reqs = 0;
152
153 /* calculcate time difference in ~1/AIO_TICKS of a second */
154 static int tvdiff (struct timeval *tv1, struct timeval *tv2)
155 {
156 return (tv2->tv_sec - tv1->tv_sec ) * AIO_TICKS
157 + ((tv2->tv_usec - tv1->tv_usec) >> 10);
158 }
159
160 static int next_pri = DEFAULT_PRI + PRI_BIAS;
161
162 static unsigned int started, idle, wanted;
163
164 /* worker threads management */
165 static mutex_t wrklock = X_MUTEX_INIT;
166
167 typedef struct worker {
168 /* locked by wrklock */
169 struct worker *prev, *next;
170
171 thread_t tid;
172
173 /* locked by reslock, reqlock or wrklock */
174 aio_req req; /* currently processed request */
175 void *dbuf;
176 DIR *dirp;
177 } worker;
178
179 static worker wrk_first = { &wrk_first, &wrk_first, 0 };
180
181 static void worker_clear (worker *wrk)
182 {
183 }
184
185 static void worker_free (worker *wrk)
186 {
187 wrk->next->prev = wrk->prev;
188 wrk->prev->next = wrk->next;
189
190 free (wrk);
191 }
192
193 static volatile unsigned int nreqs, nready, npending;
194 static volatile unsigned int max_idle = 4;
195 static volatile unsigned int max_outstanding = 0xffffffff;
196 static int respipe [2], respipe_osf [2];
197
198 static mutex_t reslock = X_MUTEX_INIT;
199 static mutex_t reqlock = X_MUTEX_INIT;
200 static cond_t reqwait = X_COND_INIT;
201
202 #if WORDACCESS_UNSAFE
203
204 static unsigned int get_nready ()
205 {
206 unsigned int retval;
207
208 X_LOCK (reqlock);
209 retval = nready;
210 X_UNLOCK (reqlock);
211
212 return retval;
213 }
214
215 static unsigned int get_npending ()
216 {
217 unsigned int retval;
218
219 X_LOCK (reslock);
220 retval = npending;
221 X_UNLOCK (reslock);
222
223 return retval;
224 }
225
226 static unsigned int get_nthreads ()
227 {
228 unsigned int retval;
229
230 X_LOCK (wrklock);
231 retval = started;
232 X_UNLOCK (wrklock);
233
234 return retval;
235 }
236
237 #else
238
239 # define get_nready() nready
240 # define get_npending() npending
241 # define get_nthreads() started
242
243 #endif
244
245 /*
246 * a somewhat faster data structure might be nice, but
247 * with 8 priorities this actually needs <20 insns
248 * per shift, the most expensive operation.
249 */
250 typedef struct {
251 aio_req qs[NUM_PRI], qe[NUM_PRI]; /* qstart, qend */
252 int size;
253 } reqq;
254
255 static reqq req_queue;
256 static reqq res_queue;
257
258 int reqq_push (reqq *q, aio_req req)
259 {
260 int pri = req->pri;
261 req->next = 0;
262
263 if (q->qe[pri])
264 {
265 q->qe[pri]->next = req;
266 q->qe[pri] = req;
267 }
268 else
269 q->qe[pri] = q->qs[pri] = req;
270
271 return q->size++;
272 }
273
274 aio_req reqq_shift (reqq *q)
275 {
276 int pri;
277
278 if (!q->size)
279 return 0;
280
281 --q->size;
282
283 for (pri = NUM_PRI; pri--; )
284 {
285 aio_req req = q->qs[pri];
286
287 if (req)
288 {
289 if (!(q->qs[pri] = req->next))
290 q->qe[pri] = 0;
291
292 return req;
293 }
294 }
295
296 abort ();
297 }
298
299 static int poll_cb ();
300 static void req_free (aio_req req);
301 static void req_cancel (aio_req req);
302
303 static int req_invoke (aio_req req)
304 {
305 dSP;
306
307 if (SvOK (req->callback))
308 {
309 ENTER;
310 SAVETMPS;
311 PUSHMARK (SP);
312
313 switch (req->type)
314 {
315 case REQ_DB_CLOSE:
316 SvREFCNT_dec (req->sv1);
317 break;
318
319 case REQ_DB_GET:
320 case REQ_DB_PGET:
321 dbt_to_sv (req->sv3, &req->dbt3);
322 break;
323
324 case REQ_C_GET:
325 case REQ_C_PGET:
326 dbt_to_sv (req->sv1, &req->dbt1);
327 dbt_to_sv (req->sv2, &req->dbt2);
328 dbt_to_sv (req->sv3, &req->dbt3);
329 break;
330
331 case REQ_DB_KEY_RANGE:
332 {
333 AV *av = newAV ();
334
335 av_push (av, newSVnv (req->key_range.less));
336 av_push (av, newSVnv (req->key_range.equal));
337 av_push (av, newSVnv (req->key_range.greater));
338
339 SvREADONLY_off (req->sv1);
340 sv_setsv_mg (req->sv1, newRV_noinc ((SV *)av));
341 SvREFCNT_dec (req->sv1);
342 }
343 break;
344
345 case REQ_SEQ_GET:
346 SvREADONLY_off (req->sv1);
347
348 if (sizeof (IV) > 4)
349 sv_setiv_mg (req->sv1, req->seq_t);
350 else
351 sv_setnv_mg (req->sv1, req->seq_t);
352
353 SvREFCNT_dec (req->sv1);
354 break;
355 }
356
357 errno = req->result;
358
359 PUTBACK;
360 call_sv (req->callback, G_VOID | G_EVAL);
361 SPAGAIN;
362
363 FREETMPS;
364 LEAVE;
365 }
366
367 return !SvTRUE (ERRSV);
368 }
369
370 static void req_free (aio_req req)
371 {
372 free (req->buf1);
373 free (req->buf2);
374 Safefree (req);
375 }
376
377 #ifdef USE_SOCKETS_AS_HANDLES
378 # define TO_SOCKET(x) (win32_get_osfhandle (x))
379 #else
380 # define TO_SOCKET(x) (x)
381 #endif
382
383 static void
384 create_pipe (int fd[2])
385 {
386 #ifdef _WIN32
387 int arg = 1;
388 if (PerlSock_socketpair (AF_UNIX, SOCK_STREAM, 0, fd)
389 || ioctlsocket (TO_SOCKET (fd [0]), FIONBIO, &arg)
390 || ioctlsocket (TO_SOCKET (fd [1]), FIONBIO, &arg))
391 #else
392 if (pipe (fd)
393 || fcntl (fd [0], F_SETFL, O_NONBLOCK)
394 || fcntl (fd [1], F_SETFL, O_NONBLOCK))
395 #endif
396 croak ("unable to initialize result pipe");
397
398 respipe_osf [0] = TO_SOCKET (respipe [0]);
399 respipe_osf [1] = TO_SOCKET (respipe [1]);
400 }
401
402 X_THREAD_PROC (bdb_proc);
403
404 static void start_thread (void)
405 {
406 worker *wrk = calloc (1, sizeof (worker));
407
408 if (!wrk)
409 croak ("unable to allocate worker thread data");
410
411 X_LOCK (wrklock);
412 if (thread_create (&wrk->tid, bdb_proc, (void *)wrk))
413 {
414 wrk->prev = &wrk_first;
415 wrk->next = wrk_first.next;
416 wrk_first.next->prev = wrk;
417 wrk_first.next = wrk;
418 ++started;
419 }
420 else
421 free (wrk);
422
423 X_UNLOCK (wrklock);
424 }
425
426 static void maybe_start_thread ()
427 {
428 if (get_nthreads () >= wanted)
429 return;
430
431 /* todo: maybe use idle here, but might be less exact */
432 if (0 <= (int)get_nthreads () + (int)get_npending () - (int)nreqs)
433 return;
434
435 start_thread ();
436 }
437
438 static void req_send (aio_req req)
439 {
440 SV *wait_callback = 0;
441
442 // synthesize callback if none given
443 if (!SvOK (req->callback))
444 {
445 int count;
446
447 dSP;
448 PUSHMARK (SP);
449 PUTBACK;
450 count = call_sv (prepare_cb, G_ARRAY);
451 SPAGAIN;
452
453 if (count != 2)
454 croak ("prepare callback must return exactly two values\n");
455
456 wait_callback = SvREFCNT_inc (POPs);
457 SvREFCNT_dec (req->callback);
458 req->callback = SvREFCNT_inc (POPs);
459 }
460
461 ++nreqs;
462
463 X_LOCK (reqlock);
464 ++nready;
465 reqq_push (&req_queue, req);
466 X_COND_SIGNAL (reqwait);
467 X_UNLOCK (reqlock);
468
469 maybe_start_thread ();
470
471 if (wait_callback)
472 {
473 dSP;
474 PUSHMARK (SP);
475 PUTBACK;
476 call_sv (wait_callback, G_DISCARD);
477 SvREFCNT_dec (wait_callback);
478 }
479 }
480
481 static void end_thread (void)
482 {
483 aio_req req;
484
485 Newz (0, req, 1, aio_cb);
486
487 req->type = REQ_QUIT;
488 req->pri = PRI_MAX + PRI_BIAS;
489
490 X_LOCK (reqlock);
491 reqq_push (&req_queue, req);
492 X_COND_SIGNAL (reqwait);
493 X_UNLOCK (reqlock);
494
495 X_LOCK (wrklock);
496 --started;
497 X_UNLOCK (wrklock);
498 }
499
500 static void set_max_idle (int nthreads)
501 {
502 if (WORDACCESS_UNSAFE) X_LOCK (reqlock);
503 max_idle = nthreads <= 0 ? 1 : nthreads;
504 if (WORDACCESS_UNSAFE) X_UNLOCK (reqlock);
505 }
506
507 static void min_parallel (int nthreads)
508 {
509 if (wanted < nthreads)
510 wanted = nthreads;
511 }
512
513 static void max_parallel (int nthreads)
514 {
515 if (wanted > nthreads)
516 wanted = nthreads;
517
518 while (started > wanted)
519 end_thread ();
520 }
521
522 static void poll_wait ()
523 {
524 fd_set rfd;
525
526 while (nreqs)
527 {
528 int size;
529 if (WORDACCESS_UNSAFE) X_LOCK (reslock);
530 size = res_queue.size;
531 if (WORDACCESS_UNSAFE) X_UNLOCK (reslock);
532
533 if (size)
534 return;
535
536 maybe_start_thread ();
537
538 FD_ZERO (&rfd);
539 FD_SET (respipe [0], &rfd);
540
541 PerlSock_select (respipe [0] + 1, &rfd, 0, 0, 0);
542 }
543 }
544
545 static int poll_cb ()
546 {
547 dSP;
548 int count = 0;
549 int maxreqs = max_poll_reqs;
550 int do_croak = 0;
551 struct timeval tv_start, tv_now;
552 aio_req req;
553
554 if (max_poll_time)
555 gettimeofday (&tv_start, 0);
556
557 for (;;)
558 {
559 for (;;)
560 {
561 maybe_start_thread ();
562
563 X_LOCK (reslock);
564 req = reqq_shift (&res_queue);
565
566 if (req)
567 {
568 --npending;
569
570 if (!res_queue.size)
571 {
572 /* read any signals sent by the worker threads */
573 char buf [4];
574 while (respipe_read (respipe [0], buf, 4) == 4)
575 ;
576 }
577 }
578
579 X_UNLOCK (reslock);
580
581 if (!req)
582 break;
583
584 --nreqs;
585
586 if (!req_invoke (req))
587 {
588 req_free (req);
589 croak (0);
590 }
591
592 count++;
593
594 req_free (req);
595
596 if (maxreqs && !--maxreqs)
597 break;
598
599 if (max_poll_time)
600 {
601 gettimeofday (&tv_now, 0);
602
603 if (tvdiff (&tv_start, &tv_now) >= max_poll_time)
604 break;
605 }
606 }
607
608 if (nreqs <= max_outstanding)
609 break;
610
611 poll_wait ();
612
613 ++maxreqs;
614 }
615
616 return count;
617 }
618
619 /*****************************************************************************/
620
621 X_THREAD_PROC (bdb_proc)
622 {
623 aio_req req;
624 struct timespec ts;
625 worker *self = (worker *)thr_arg;
626
627 /* try to distribute timeouts somewhat evenly */
628 ts.tv_nsec = ((unsigned long)self & 1023UL) * (1000000000UL / 1024UL);
629
630 for (;;)
631 {
632 ts.tv_sec = time (0) + IDLE_TIMEOUT;
633
634 X_LOCK (reqlock);
635
636 for (;;)
637 {
638 self->req = req = reqq_shift (&req_queue);
639
640 if (req)
641 break;
642
643 ++idle;
644
645 if (X_COND_TIMEDWAIT (reqwait, reqlock, ts)
646 == ETIMEDOUT)
647 {
648 if (idle > max_idle)
649 {
650 --idle;
651 X_UNLOCK (reqlock);
652 X_LOCK (wrklock);
653 --started;
654 X_UNLOCK (wrklock);
655 goto quit;
656 }
657
658 /* we are allowed to idle, so do so without any timeout */
659 X_COND_WAIT (reqwait, reqlock);
660 ts.tv_sec = time (0) + IDLE_TIMEOUT;
661 }
662
663 --idle;
664 }
665
666 --nready;
667
668 X_UNLOCK (reqlock);
669
670 switch (req->type)
671 {
672 case REQ_QUIT:
673 goto quit;
674
675 case REQ_ENV_OPEN:
676 req->result = req->env->open (req->env, req->buf1, req->uint1, req->int1);
677 break;
678
679 case REQ_ENV_CLOSE:
680 req->result = req->env->close (req->env, req->uint1);
681 break;
682
683 case REQ_ENV_TXN_CHECKPOINT:
684 req->result = req->env->txn_checkpoint (req->env, req->uint1, req->int1, req->uint2);
685 break;
686
687 case REQ_ENV_LOCK_DETECT:
688 req->result = req->env->lock_detect (req->env, req->uint1, req->uint2, &req->int1);
689 break;
690
691 case REQ_ENV_MEMP_SYNC:
692 req->result = req->env->memp_sync (req->env, 0);
693 break;
694
695 case REQ_ENV_MEMP_TRICKLE:
696 req->result = req->env->memp_trickle (req->env, req->int1, &req->int2);
697 break;
698
699 case REQ_DB_OPEN:
700 req->result = req->db->open (req->db, req->txn, req->buf1, req->buf2, req->int1, req->uint1, req->int2);
701 break;
702
703 case REQ_DB_CLOSE:
704 req->result = req->db->close (req->db, req->uint1);
705 break;
706
707 case REQ_DB_COMPACT:
708 req->result = req->db->compact (req->db, req->txn, &req->dbt1, &req->dbt2, 0, req->uint1, 0);
709 break;
710
711 case REQ_DB_SYNC:
712 req->result = req->db->sync (req->db, req->uint1);
713 break;
714
715 case REQ_DB_PUT:
716 req->result = req->db->put (req->db, req->txn, &req->dbt1, &req->dbt2, req->uint1);
717 break;
718
719 case REQ_DB_GET:
720 req->result = req->db->get (req->db, req->txn, &req->dbt1, &req->dbt3, req->uint1);
721 break;
722
723 case REQ_DB_PGET:
724 req->result = req->db->pget (req->db, req->txn, &req->dbt1, &req->dbt2, &req->dbt3, req->uint1);
725 break;
726
727 case REQ_DB_DEL:
728 req->result = req->db->del (req->db, req->txn, &req->dbt1, req->uint1);
729 break;
730
731 case REQ_DB_KEY_RANGE:
732 req->result = req->db->key_range (req->db, req->txn, &req->dbt1, &req->key_range, req->uint1);
733 break;
734
735 case REQ_TXN_COMMIT:
736 req->result = req->txn->commit (req->txn, req->uint1);
737 break;
738
739 case REQ_TXN_ABORT:
740 req->result = req->txn->abort (req->txn);
741 break;
742
743 case REQ_C_CLOSE:
744 req->result = req->dbc->c_close (req->dbc);
745 break;
746
747 case REQ_C_COUNT:
748 {
749 db_recno_t recno;
750 req->result = req->dbc->c_count (req->dbc, &recno, req->uint1);
751 req->uv1 = recno;
752 }
753 break;
754
755 case REQ_C_PUT:
756 req->result = req->dbc->c_put (req->dbc, &req->dbt1, &req->dbt2, req->uint1);
757 break;
758
759 case REQ_C_GET:
760 req->result = req->dbc->c_get (req->dbc, &req->dbt1, &req->dbt3, req->uint1);
761 break;
762
763 case REQ_C_PGET:
764 req->result = req->dbc->c_pget (req->dbc, &req->dbt1, &req->dbt2, &req->dbt3, req->uint1);
765 break;
766
767 case REQ_C_DEL:
768 req->result = req->dbc->c_del (req->dbc, req->uint1);
769 break;
770
771 case REQ_SEQ_OPEN:
772 req->result = req->seq->open (req->seq, req->txn, &req->dbt1, req->uint1);
773 break;
774
775 case REQ_SEQ_CLOSE:
776 req->result = req->seq->close (req->seq, req->uint1);
777 break;
778
779 case REQ_SEQ_GET:
780 req->result = req->seq->get (req->seq, req->txn, req->int1, &req->seq_t, req->uint1);
781 break;
782
783 case REQ_SEQ_REMOVE:
784 req->result = req->seq->remove (req->seq, req->txn, req->uint1);
785 break;
786
787 default:
788 req->result = ENOSYS;
789 break;
790 }
791
792 X_LOCK (reslock);
793
794 ++npending;
795
796 if (!reqq_push (&res_queue, req))
797 /* write a dummy byte to the pipe so fh becomes ready */
798 respipe_write (respipe_osf [1], (const void *)&respipe_osf, 1);
799
800 self->req = 0;
801 worker_clear (self);
802
803 X_UNLOCK (reslock);
804 }
805
806 quit:
807 X_LOCK (wrklock);
808 worker_free (self);
809 X_UNLOCK (wrklock);
810
811 return 0;
812 }
813
814 /*****************************************************************************/
815
816 static void atfork_prepare (void)
817 {
818 X_LOCK (wrklock);
819 X_LOCK (reqlock);
820 X_LOCK (reslock);
821 }
822
823 static void atfork_parent (void)
824 {
825 X_UNLOCK (reslock);
826 X_UNLOCK (reqlock);
827 X_UNLOCK (wrklock);
828 }
829
830 static void atfork_child (void)
831 {
832 aio_req prv;
833
834 while (prv = reqq_shift (&req_queue))
835 req_free (prv);
836
837 while (prv = reqq_shift (&res_queue))
838 req_free (prv);
839
840 while (wrk_first.next != &wrk_first)
841 {
842 worker *wrk = wrk_first.next;
843
844 if (wrk->req)
845 req_free (wrk->req);
846
847 worker_clear (wrk);
848 worker_free (wrk);
849 }
850
851 started = 0;
852 idle = 0;
853 nreqs = 0;
854 nready = 0;
855 npending = 0;
856
857 respipe_close (respipe [0]);
858 respipe_close (respipe [1]);
859
860 create_pipe (respipe);
861
862 atfork_parent ();
863 }
864
865 #define dREQ(reqtype) \
866 aio_req req; \
867 int req_pri = next_pri; \
868 next_pri = DEFAULT_PRI + PRI_BIAS; \
869 \
870 if (SvOK (callback) && !SvROK (callback)) \
871 croak ("callback must be undef or of reference type"); \
872 \
873 Newz (0, req, 1, aio_cb); \
874 if (!req) \
875 croak ("out of memory during aio_req allocation"); \
876 \
877 req->callback = newSVsv (callback); \
878 req->type = (reqtype); \
879 req->pri = req_pri
880
881 #define REQ_SEND \
882 req_send (req)
883
884 #define SvPTR(var, arg, type, class, nullok) \
885 if (!SvOK (arg)) \
886 { \
887 if (!nullok) \
888 croak (# var " must be a " # class " object, not undef"); \
889 \
890 (var) = 0; \
891 } \
892 else if (sv_derived_from ((arg), # class)) \
893 { \
894 IV tmp = SvIV ((SV*) SvRV (arg)); \
895 (var) = INT2PTR (type, tmp); \
896 if (!var) \
897 croak (# var " is not a valid " # class " object anymore"); \
898 } \
899 else \
900 croak (# var " is not of type " # class); \
901 \
902
903 static void
904 ptr_nuke (SV *sv)
905 {
906 assert (SvROK (sv));
907 sv_setiv (SvRV (sv), 0);
908 }
909
910 MODULE = BDB PACKAGE = BDB
911
912 PROTOTYPES: ENABLE
913
914 BOOT:
915 {
916 HV *stash = gv_stashpv ("BDB", 1);
917
918 static const struct {
919 const char *name;
920 IV iv;
921 } *civ, const_iv[] = {
922 #define const_iv(name) { # name, (IV)DB_ ## name },
923 const_iv (RPCCLIENT)
924 const_iv (INIT_CDB)
925 const_iv (INIT_LOCK)
926 const_iv (INIT_LOG)
927 const_iv (INIT_MPOOL)
928 const_iv (INIT_REP)
929 const_iv (INIT_TXN)
930 const_iv (RECOVER)
931 const_iv (INIT_TXN)
932 const_iv (RECOVER_FATAL)
933 const_iv (CREATE)
934 const_iv (USE_ENVIRON)
935 const_iv (USE_ENVIRON_ROOT)
936 const_iv (LOCKDOWN)
937 const_iv (PRIVATE)
938 const_iv (REGISTER)
939 const_iv (SYSTEM_MEM)
940 const_iv (AUTO_COMMIT)
941 const_iv (CDB_ALLDB)
942 const_iv (DIRECT_DB)
943 const_iv (DIRECT_LOG)
944 const_iv (DSYNC_DB)
945 const_iv (DSYNC_LOG)
946 const_iv (LOG_AUTOREMOVE)
947 const_iv (LOG_INMEMORY)
948 const_iv (NOLOCKING)
949 const_iv (NOMMAP)
950 const_iv (NOPANIC)
951 const_iv (OVERWRITE)
952 const_iv (PANIC_ENVIRONMENT)
953 const_iv (REGION_INIT)
954 const_iv (TIME_NOTGRANTED)
955 const_iv (TXN_NOSYNC)
956 const_iv (TXN_WRITE_NOSYNC)
957 const_iv (WRITECURSOR)
958 const_iv (YIELDCPU)
959 const_iv (ENCRYPT_AES)
960 const_iv (XA_CREATE)
961 const_iv (BTREE)
962 const_iv (HASH)
963 const_iv (QUEUE)
964 const_iv (RECNO)
965 const_iv (UNKNOWN)
966 const_iv (EXCL)
967 const_iv (READ_COMMITTED)
968 const_iv (READ_UNCOMMITTED)
969 const_iv (TRUNCATE)
970 const_iv (NOSYNC)
971 const_iv (CHKSUM)
972 const_iv (ENCRYPT)
973 const_iv (TXN_NOT_DURABLE)
974 const_iv (DUP)
975 const_iv (DUPSORT)
976 const_iv (RECNUM)
977 const_iv (RENUMBER)
978 const_iv (REVSPLITOFF)
979 const_iv (INORDER)
980 const_iv (CONSUME)
981 const_iv (CONSUME_WAIT)
982 const_iv (GET_BOTH)
983 const_iv (GET_BOTH_RANGE)
984 //const_iv (SET_RECNO)
985 //const_iv (MULTIPLE)
986 const_iv (SNAPSHOT)
987 const_iv (JOIN_ITEM)
988 const_iv (RMW)
989
990 const_iv (NOTFOUND)
991 const_iv (KEYEMPTY)
992 const_iv (LOCK_DEADLOCK)
993 const_iv (LOCK_NOTGRANTED)
994 const_iv (RUNRECOVERY)
995 const_iv (OLD_VERSION)
996 const_iv (REP_HANDLE_DEAD)
997 const_iv (REP_LOCKOUT)
998 const_iv (SECONDARY_BAD)
999
1000 const_iv (FREE_SPACE)
1001 const_iv (FREELIST_ONLY)
1002
1003 const_iv (APPEND)
1004 const_iv (NODUPDATA)
1005 const_iv (NOOVERWRITE)
1006
1007 const_iv (TXN_NOWAIT)
1008 const_iv (TXN_SYNC)
1009
1010 const_iv (SET_LOCK_TIMEOUT)
1011 const_iv (SET_TXN_TIMEOUT)
1012
1013 const_iv (JOIN_ITEM)
1014 const_iv (FIRST)
1015 const_iv (NEXT)
1016 const_iv (NEXT_DUP)
1017 const_iv (NEXT_NODUP)
1018 const_iv (PREV)
1019 const_iv (PREV_NODUP)
1020 const_iv (SET)
1021 const_iv (SET_RANGE)
1022 const_iv (LAST)
1023 const_iv (BEFORE)
1024 const_iv (AFTER)
1025 const_iv (CURRENT)
1026 const_iv (KEYFIRST)
1027 const_iv (KEYLAST)
1028 const_iv (NODUPDATA)
1029
1030 const_iv (FORCE)
1031
1032 const_iv (LOCK_DEFAULT)
1033 const_iv (LOCK_EXPIRE)
1034 const_iv (LOCK_MAXLOCKS)
1035 const_iv (LOCK_MAXWRITE)
1036 const_iv (LOCK_MINLOCKS)
1037 const_iv (LOCK_MINWRITE)
1038 const_iv (LOCK_OLDEST)
1039 const_iv (LOCK_RANDOM)
1040 const_iv (LOCK_YOUNGEST)
1041
1042 const_iv (SEQ_DEC)
1043 const_iv (SEQ_INC)
1044 const_iv (SEQ_WRAP)
1045
1046 const_iv (BUFFER_SMALL)
1047 const_iv (DONOTINDEX)
1048 const_iv (KEYEMPTY )
1049 const_iv (KEYEXIST )
1050 const_iv (LOCK_DEADLOCK)
1051 const_iv (LOCK_NOTGRANTED)
1052 const_iv (LOG_BUFFER_FULL)
1053 const_iv (NOSERVER)
1054 const_iv (NOSERVER_HOME)
1055 const_iv (NOSERVER_ID)
1056 const_iv (NOTFOUND)
1057 const_iv (OLD_VERSION)
1058 const_iv (PAGE_NOTFOUND)
1059 const_iv (REP_DUPMASTER)
1060 const_iv (REP_HANDLE_DEAD)
1061 const_iv (REP_HOLDELECTION)
1062 const_iv (REP_IGNORE)
1063 const_iv (REP_ISPERM)
1064 const_iv (REP_JOIN_FAILURE)
1065 const_iv (REP_LOCKOUT)
1066 const_iv (REP_NEWMASTER)
1067 const_iv (REP_NEWSITE)
1068 const_iv (REP_NOTPERM)
1069 const_iv (REP_UNAVAIL)
1070 const_iv (RUNRECOVERY)
1071 const_iv (SECONDARY_BAD)
1072 const_iv (VERIFY_BAD)
1073 const_iv (VERSION_MISMATCH)
1074
1075 const_iv (VERB_DEADLOCK)
1076 const_iv (VERB_RECOVERY)
1077 const_iv (VERB_REGISTER)
1078 const_iv (VERB_REPLICATION)
1079 const_iv (VERB_WAITSFOR)
1080
1081 const_iv (VERSION_MAJOR)
1082 const_iv (VERSION_MINOR)
1083 const_iv (VERSION_PATCH)
1084 #if DB_VERSION_MINOR >= 5
1085 const_iv (MULTIVERSION)
1086 const_iv (TXN_SNAPSHOT)
1087 #endif
1088 #if DB_VERSION_MINOR >= 6
1089 const_iv (PREV_DUP)
1090 # if 0
1091 const_iv (PRIORITY_UNCHANGED)
1092 const_iv (PRIORITY_VERY_LOW)
1093 const_iv (PRIORITY_LOW)
1094 const_iv (PRIORITY_DEFAULT)
1095 const_iv (PRIORITY_HIGH)
1096 const_iv (PRIORITY_VERY_HIGH)
1097 # endif
1098 #endif
1099 };
1100
1101 for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
1102 newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
1103
1104 newCONSTSUB (stash, "DB_VERSION", newSVnv (DB_VERSION_MAJOR + DB_VERSION_MINOR * .1));
1105 newCONSTSUB (stash, "DB_VERSION_STRING", newSVpv (DB_VERSION_STRING, 0));
1106
1107 create_pipe (respipe);
1108
1109 X_THREAD_ATFORK (atfork_prepare, atfork_parent, atfork_child);
1110 #ifdef _WIN32
1111 X_MUTEX_CHECK (wrklock);
1112 X_MUTEX_CHECK (reslock);
1113 X_MUTEX_CHECK (reqlock);
1114
1115 X_COND_CHECK (reqwait);
1116 #endif
1117 }
1118
1119 void
1120 max_poll_reqs (int nreqs)
1121 PROTOTYPE: $
1122 CODE:
1123 max_poll_reqs = nreqs;
1124
1125 void
1126 max_poll_time (double nseconds)
1127 PROTOTYPE: $
1128 CODE:
1129 max_poll_time = nseconds * AIO_TICKS;
1130
1131 void
1132 min_parallel (int nthreads)
1133 PROTOTYPE: $
1134
1135 void
1136 max_parallel (int nthreads)
1137 PROTOTYPE: $
1138
1139 void
1140 max_idle (int nthreads)
1141 PROTOTYPE: $
1142 CODE:
1143 set_max_idle (nthreads);
1144
1145 int
1146 max_outstanding (int maxreqs)
1147 PROTOTYPE: $
1148 CODE:
1149 RETVAL = max_outstanding;
1150 max_outstanding = maxreqs;
1151 OUTPUT:
1152 RETVAL
1153
1154 int
1155 dbreq_pri (int pri = 0)
1156 PROTOTYPE: ;$
1157 CODE:
1158 RETVAL = next_pri - PRI_BIAS;
1159 if (items > 0)
1160 {
1161 if (pri < PRI_MIN) pri = PRI_MIN;
1162 if (pri > PRI_MAX) pri = PRI_MAX;
1163 next_pri = pri + PRI_BIAS;
1164 }
1165 OUTPUT:
1166 RETVAL
1167
1168 void
1169 dbreq_nice (int nice = 0)
1170 CODE:
1171 nice = next_pri - nice;
1172 if (nice < PRI_MIN) nice = PRI_MIN;
1173 if (nice > PRI_MAX) nice = PRI_MAX;
1174 next_pri = nice + PRI_BIAS;
1175
1176 void
1177 flush ()
1178 PROTOTYPE:
1179 CODE:
1180 while (nreqs)
1181 {
1182 poll_wait ();
1183 poll_cb ();
1184 }
1185
1186 int
1187 poll ()
1188 PROTOTYPE:
1189 CODE:
1190 poll_wait ();
1191 RETVAL = poll_cb ();
1192 OUTPUT:
1193 RETVAL
1194
1195 int
1196 poll_fileno ()
1197 PROTOTYPE:
1198 CODE:
1199 RETVAL = respipe [0];
1200 OUTPUT:
1201 RETVAL
1202
1203 int
1204 poll_cb (...)
1205 PROTOTYPE:
1206 CODE:
1207 RETVAL = poll_cb ();
1208 OUTPUT:
1209 RETVAL
1210
1211 void
1212 poll_wait ()
1213 PROTOTYPE:
1214 CODE:
1215 poll_wait ();
1216
1217 int
1218 nreqs ()
1219 PROTOTYPE:
1220 CODE:
1221 RETVAL = nreqs;
1222 OUTPUT:
1223 RETVAL
1224
1225 int
1226 nready ()
1227 PROTOTYPE:
1228 CODE:
1229 RETVAL = get_nready ();
1230 OUTPUT:
1231 RETVAL
1232
1233 int
1234 npending ()
1235 PROTOTYPE:
1236 CODE:
1237 RETVAL = get_npending ();
1238 OUTPUT:
1239 RETVAL
1240
1241 int
1242 nthreads ()
1243 PROTOTYPE:
1244 CODE:
1245 if (WORDACCESS_UNSAFE) X_LOCK (wrklock);
1246 RETVAL = started;
1247 if (WORDACCESS_UNSAFE) X_UNLOCK (wrklock);
1248 OUTPUT:
1249 RETVAL
1250
1251 void
1252 set_sync_prepare (SV *cb)
1253 PROTOTYPE: &
1254 CODE:
1255 SvREFCNT_dec (prepare_cb);
1256 prepare_cb = newSVsv (cb);
1257
1258 char *
1259 strerror (int errorno = errno)
1260 PROTOTYPE: ;$
1261 CODE:
1262 RETVAL = db_strerror (errorno);
1263 OUTPUT:
1264 RETVAL
1265
1266 DB_ENV *
1267 db_env_create (U32 env_flags = 0)
1268 CODE:
1269 {
1270 errno = db_env_create (&RETVAL, env_flags);
1271 if (errno)
1272 croak ("db_env_create: %s", db_strerror (errno));
1273
1274 if (0)
1275 {
1276 RETVAL->set_errcall (RETVAL, debug_errcall);
1277 RETVAL->set_msgcall (RETVAL, debug_msgcall);
1278 }
1279 }
1280 OUTPUT:
1281 RETVAL
1282
1283 void
1284 db_env_open (DB_ENV *env, octetstring db_home, U32 open_flags, int mode, SV *callback = &PL_sv_undef)
1285 CODE:
1286 {
1287 dREQ (REQ_ENV_OPEN);
1288
1289 env->set_thread_count (env, wanted + 2);
1290
1291 req->env = env;
1292 req->uint1 = open_flags | DB_THREAD;
1293 req->int1 = mode;
1294 req->buf1 = strdup_ornull (db_home);
1295 REQ_SEND;
1296 }
1297
1298 void
1299 db_env_close (DB_ENV *env, U32 flags = 0, SV *callback = &PL_sv_undef)
1300 CODE:
1301 {
1302 dREQ (REQ_ENV_CLOSE);
1303 req->env = env;
1304 req->uint1 = flags;
1305 REQ_SEND;
1306 ptr_nuke (ST (0));
1307 }
1308
1309 void
1310 db_env_txn_checkpoint (DB_ENV *env, U32 kbyte = 0, U32 min = 0, U32 flags = 0, SV *callback = &PL_sv_undef)
1311 CODE:
1312 {
1313 dREQ (REQ_ENV_TXN_CHECKPOINT);
1314 req->env = env;
1315 req->uint1 = kbyte;
1316 req->int1 = min;
1317 req->uint2 = flags;
1318 REQ_SEND;
1319 }
1320
1321 void
1322 db_env_lock_detect (DB_ENV *env, U32 flags = 0, U32 atype = DB_LOCK_DEFAULT, SV *dummy = 0, SV *callback = &PL_sv_undef)
1323 CODE:
1324 {
1325 dREQ (REQ_ENV_LOCK_DETECT);
1326 req->env = env;
1327 req->uint1 = flags;
1328 req->uint2 = atype;
1329 REQ_SEND;
1330 }
1331
1332 void
1333 db_env_memp_sync (DB_ENV *env, SV *dummy = 0, SV *callback = &PL_sv_undef)
1334 CODE:
1335 {
1336 dREQ (REQ_ENV_MEMP_SYNC);
1337 req->env = env;
1338 REQ_SEND;
1339 }
1340
1341 void
1342 db_env_memp_trickle (DB_ENV *env, int percent, SV *dummy = 0, SV *callback = &PL_sv_undef)
1343 CODE:
1344 {
1345 dREQ (REQ_ENV_MEMP_TRICKLE);
1346 req->env = env;
1347 req->int1 = percent;
1348 REQ_SEND;
1349 }
1350
1351
1352 DB *
1353 db_create (DB_ENV *env = 0, U32 flags = 0)
1354 CODE:
1355 {
1356 errno = db_create (&RETVAL, env, flags);
1357 if (errno)
1358 croak ("db_create: %s", db_strerror (errno));
1359
1360 if (RETVAL)
1361 RETVAL->app_private = (void *)newSVsv (ST (0));
1362 }
1363 OUTPUT:
1364 RETVAL
1365
1366 void
1367 db_open (DB *db, DB_TXN_ornull *txnid, octetstring file, octetstring database, int type, U32 flags, int mode, SV *callback = &PL_sv_undef)
1368 CODE:
1369 {
1370 dREQ (REQ_DB_OPEN);
1371 req->db = db;
1372 req->txn = txnid;
1373 req->buf1 = strdup_ornull (file);
1374 req->buf2 = strdup_ornull (database);
1375 req->int1 = type;
1376 req->uint1 = flags | DB_THREAD;
1377 req->int2 = mode;
1378 REQ_SEND;
1379 }
1380
1381 void
1382 db_close (DB *db, U32 flags = 0, SV *callback = &PL_sv_undef)
1383 CODE:
1384 {
1385 dREQ (REQ_DB_CLOSE);
1386 req->db = db;
1387 req->uint1 = flags;
1388 req->sv1 = (SV *)db->app_private;
1389 REQ_SEND;
1390 ptr_nuke (ST (0));
1391 }
1392
1393 void
1394 db_compact (DB *db, DB_TXN_ornull *txn = 0, SV *start = 0, SV *stop = 0, SV *unused1 = 0, U32 flags = DB_FREE_SPACE, SV *unused2 = 0, SV *callback = &PL_sv_undef)
1395 CODE:
1396 {
1397 dREQ (REQ_DB_COMPACT);
1398 req->db = db;
1399 req->txn = txn;
1400 sv_to_dbt (&req->dbt1, start);
1401 sv_to_dbt (&req->dbt2, stop);
1402 req->uint1 = flags;
1403 REQ_SEND;
1404 }
1405
1406 void
1407 db_sync (DB *db, U32 flags = 0, SV *callback = &PL_sv_undef)
1408 CODE:
1409 {
1410 dREQ (REQ_DB_SYNC);
1411 req->db = db;
1412 req->uint1 = flags;
1413 REQ_SEND;
1414 }
1415
1416 void
1417 db_key_range (DB *db, DB_TXN_ornull *txn, SV *key, SV *key_range, U32 flags = 0, SV *callback = &PL_sv_undef)
1418 CODE:
1419 {
1420 dREQ (REQ_DB_KEY_RANGE);
1421 req->db = db;
1422 req->txn = txn;
1423 sv_to_dbt (&req->dbt1, key);
1424 req->uint1 = flags;
1425 req->sv1 = SvREFCNT_inc (key_range); SvREADONLY_on (key_range);
1426 REQ_SEND;
1427 }
1428
1429 void
1430 db_put (DB *db, DB_TXN_ornull *txn, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
1431 CODE:
1432 {
1433 dREQ (REQ_DB_PUT);
1434 req->db = db;
1435 req->txn = txn;
1436 sv_to_dbt (&req->dbt1, key);
1437 sv_to_dbt (&req->dbt2, data);
1438 req->uint1 = flags;
1439 REQ_SEND;
1440 }
1441
1442 void
1443 db_get (DB *db, DB_TXN_ornull *txn, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
1444 CODE:
1445 {
1446 dREQ (REQ_DB_GET);
1447 req->db = db;
1448 req->txn = txn;
1449 req->uint1 = flags;
1450 sv_to_dbt (&req->dbt1, key);
1451 req->dbt3.flags = DB_DBT_MALLOC;
1452 req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1453 REQ_SEND;
1454 }
1455
1456 void
1457 db_pget (DB *db, DB_TXN_ornull *txn, SV *key, SV *pkey, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
1458 CODE:
1459 {
1460 dREQ (REQ_DB_PGET);
1461 req->db = db;
1462 req->txn = txn;
1463 req->uint1 = flags;
1464 sv_to_dbt (&req->dbt1, key);
1465 sv_to_dbt (&req->dbt2, pkey);
1466 req->dbt3.flags = DB_DBT_MALLOC;
1467 req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1468 REQ_SEND;
1469 }
1470
1471 void
1472 db_del (DB *db, DB_TXN_ornull *txn, SV *key, U32 flags = 0, SV *callback = &PL_sv_undef)
1473 CODE:
1474 {
1475 dREQ (REQ_DB_DEL);
1476 req->db = db;
1477 req->txn = txn;
1478 req->uint1 = flags;
1479 sv_to_dbt (&req->dbt1, key);
1480 REQ_SEND;
1481 }
1482
1483 void
1484 db_txn_commit (DB_TXN *txn, U32 flags = 0, SV *callback = &PL_sv_undef)
1485 CODE:
1486 {
1487 dREQ (REQ_TXN_COMMIT);
1488 req->txn = txn;
1489 req->uint1 = flags;
1490 REQ_SEND;
1491 ptr_nuke (ST (0));
1492 }
1493
1494 void
1495 db_txn_abort (DB_TXN *txn, SV *callback = &PL_sv_undef)
1496 CODE:
1497 {
1498 dREQ (REQ_TXN_ABORT);
1499 req->txn = txn;
1500 REQ_SEND;
1501 ptr_nuke (ST (0));
1502 }
1503
1504 void
1505 db_c_close (DBC *dbc, SV *callback = &PL_sv_undef)
1506 CODE:
1507 {
1508 dREQ (REQ_C_CLOSE);
1509 req->dbc = dbc;
1510 REQ_SEND;
1511 ptr_nuke (ST (0));
1512 }
1513
1514 void
1515 db_c_count (DBC *dbc, SV *count, U32 flags = 0, SV *callback = &PL_sv_undef)
1516 CODE:
1517 {
1518 dREQ (REQ_C_COUNT);
1519 req->dbc = dbc;
1520 req->sv1 = SvREFCNT_inc (count);
1521 REQ_SEND;
1522 }
1523
1524 void
1525 db_c_put (DBC *dbc, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
1526 CODE:
1527 {
1528 dREQ (REQ_C_PUT);
1529 req->dbc = dbc;
1530 sv_to_dbt (&req->dbt1, key);
1531 sv_to_dbt (&req->dbt2, data);
1532 req->uint1 = flags;
1533 REQ_SEND;
1534 }
1535
1536 void
1537 db_c_get (DBC *dbc, SV *key, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
1538 CODE:
1539 {
1540 dREQ (REQ_C_GET);
1541 req->dbc = dbc;
1542 req->uint1 = flags;
1543 if ((flags & DB_SET) == DB_SET
1544 || (flags & DB_SET_RANGE) == DB_SET_RANGE)
1545 sv_to_dbt (&req->dbt1, key);
1546 else
1547 req->dbt1.flags = DB_DBT_MALLOC;
1548
1549 req->sv1 = SvREFCNT_inc (key); SvREADONLY_on (key);
1550
1551 if ((flags & DB_GET_BOTH) == DB_GET_BOTH
1552 || (flags & DB_GET_BOTH_RANGE) == DB_GET_BOTH_RANGE)
1553 sv_to_dbt (&req->dbt3, data);
1554 else
1555 req->dbt3.flags = DB_DBT_MALLOC;
1556
1557 req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1558 REQ_SEND;
1559 }
1560
1561 void
1562 db_c_pget (DBC *dbc, SV *key, SV *pkey, SV *data, U32 flags = 0, SV *callback = &PL_sv_undef)
1563 CODE:
1564 {
1565 dREQ (REQ_C_PGET);
1566 req->dbc = dbc;
1567 req->uint1 = flags;
1568 if ((flags & DB_SET) == DB_SET
1569 || (flags & DB_SET_RANGE) == DB_SET_RANGE)
1570 sv_to_dbt (&req->dbt1, key);
1571 else
1572 req->dbt1.flags = DB_DBT_MALLOC;
1573
1574 req->sv1 = SvREFCNT_inc (key); SvREADONLY_on (key);
1575
1576 req->dbt2.flags = DB_DBT_MALLOC;
1577 req->sv2 = SvREFCNT_inc (pkey); SvREADONLY_on (pkey);
1578
1579 if ((flags & DB_GET_BOTH) == DB_GET_BOTH
1580 || (flags & DB_GET_BOTH_RANGE) == DB_GET_BOTH_RANGE)
1581 sv_to_dbt (&req->dbt3, data);
1582 else
1583 req->dbt3.flags = DB_DBT_MALLOC;
1584
1585 req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1586 REQ_SEND;
1587 }
1588
1589 void
1590 db_c_del (DBC *dbc, U32 flags = 0, SV *callback = &PL_sv_undef)
1591 CODE:
1592 {
1593 dREQ (REQ_C_DEL);
1594 req->dbc = dbc;
1595 req->uint1 = flags;
1596 REQ_SEND;
1597 }
1598
1599
1600 void
1601 db_sequence_open (DB_SEQUENCE *seq, DB_TXN_ornull *txnid, SV *key, U32 flags = 0, SV *callback = &PL_sv_undef)
1602 CODE:
1603 {
1604 dREQ (REQ_SEQ_OPEN);
1605 req->seq = seq;
1606 req->txn = txnid;
1607 req->uint1 = flags | DB_THREAD;
1608 sv_to_dbt (&req->dbt1, key);
1609 REQ_SEND;
1610 }
1611
1612 void
1613 db_sequence_close (DB_SEQUENCE *seq, U32 flags = 0, SV *callback = &PL_sv_undef)
1614 CODE:
1615 {
1616 dREQ (REQ_SEQ_CLOSE);
1617 req->seq = seq;
1618 req->uint1 = flags;
1619 REQ_SEND;
1620 ptr_nuke (ST (0));
1621 }
1622
1623 void
1624 db_sequence_get (DB_SEQUENCE *seq, DB_TXN_ornull *txnid, int delta, SV *seq_value, U32 flags = DB_TXN_NOSYNC, SV *callback = &PL_sv_undef)
1625 CODE:
1626 {
1627 dREQ (REQ_SEQ_GET);
1628 req->seq = seq;
1629 req->txn = txnid;
1630 req->int1 = delta;
1631 req->uint1 = flags;
1632 req->sv1 = SvREFCNT_inc (seq_value); SvREADONLY_on (seq_value);
1633 REQ_SEND;
1634 }
1635
1636 void
1637 db_sequence_remove (DB_SEQUENCE *seq, DB_TXN_ornull *txnid = 0, U32 flags = 0, SV *callback = &PL_sv_undef)
1638 CODE:
1639 {
1640 dREQ (REQ_SEQ_REMOVE);
1641 req->seq = seq;
1642 req->txn = txnid;
1643 req->uint1 = flags;
1644 REQ_SEND;
1645 }
1646
1647
1648 MODULE = BDB PACKAGE = BDB::Env
1649
1650 void
1651 DESTROY (DB_ENV_ornull *env)
1652 CODE:
1653 if (env)
1654 env->close (env, 0);
1655
1656 int set_data_dir (DB_ENV *env, const char *dir)
1657 CODE:
1658 RETVAL = env->set_data_dir (env, dir);
1659 OUTPUT:
1660 RETVAL
1661
1662 int set_tmp_dir (DB_ENV *env, const char *dir)
1663 CODE:
1664 RETVAL = env->set_tmp_dir (env, dir);
1665 OUTPUT:
1666 RETVAL
1667
1668 int set_lg_dir (DB_ENV *env, const char *dir)
1669 CODE:
1670 RETVAL = env->set_lg_dir (env, dir);
1671 OUTPUT:
1672 RETVAL
1673
1674 int set_shm_key (DB_ENV *env, long shm_key)
1675 CODE:
1676 RETVAL = env->set_shm_key (env, shm_key);
1677 OUTPUT:
1678 RETVAL
1679
1680 int set_cachesize (DB_ENV *env, U32 gbytes, U32 bytes, int ncache = 0)
1681 CODE:
1682 RETVAL = env->set_cachesize (env, gbytes, bytes, ncache);
1683 OUTPUT:
1684 RETVAL
1685
1686 int set_flags (DB_ENV *env, U32 flags, int onoff)
1687 CODE:
1688 RETVAL = env->set_flags (env, flags, onoff);
1689 OUTPUT:
1690 RETVAL
1691
1692 void set_errfile (DB_ENV *env, FILE *errfile = 0)
1693 CODE:
1694 env->set_errfile (env, errfile);
1695
1696 void set_msgfile (DB_ENV *env, FILE *msgfile = 0)
1697 CODE:
1698 env->set_msgfile (env, msgfile);
1699
1700 int set_verbose (DB_ENV *env, U32 which, int onoff = 1)
1701 CODE:
1702 RETVAL = env->set_verbose (env, which, onoff);
1703 OUTPUT:
1704 RETVAL
1705
1706 int set_encrypt (DB_ENV *env, const char *password, U32 flags = 0)
1707 CODE:
1708 RETVAL = env->set_encrypt (env, password, flags);
1709 OUTPUT:
1710 RETVAL
1711
1712 int set_timeout (DB_ENV *env, NV timeout, U32 flags)
1713 CODE:
1714 RETVAL = env->set_timeout (env, timeout * 1000000, flags);
1715 OUTPUT:
1716 RETVAL
1717
1718 int set_mp_max_openfd (DB_ENV *env, int maxopenfd);
1719 CODE:
1720 RETVAL = env->set_mp_max_openfd (env, maxopenfd);
1721 OUTPUT:
1722 RETVAL
1723
1724 int set_mp_max_write (DB_ENV *env, int maxwrite, int maxwrite_sleep);
1725 CODE:
1726 RETVAL = env->set_mp_max_write (env, maxwrite, maxwrite_sleep);
1727 OUTPUT:
1728 RETVAL
1729
1730 int set_mp_mmapsize (DB_ENV *env, int mmapsize_mb)
1731 CODE:
1732 RETVAL = env->set_mp_mmapsize (env, ((size_t)mmapsize_mb) << 20);
1733 OUTPUT:
1734 RETVAL
1735
1736 int set_lk_detect (DB_ENV *env, U32 detect = DB_LOCK_DEFAULT)
1737 CODE:
1738 RETVAL = env->set_lk_detect (env, detect);
1739 OUTPUT:
1740 RETVAL
1741
1742 int set_lk_max_lockers (DB_ENV *env, U32 max)
1743 CODE:
1744 RETVAL = env->set_lk_max_lockers (env, max);
1745 OUTPUT:
1746 RETVAL
1747
1748 int set_lk_max_locks (DB_ENV *env, U32 max)
1749 CODE:
1750 RETVAL = env->set_lk_max_locks (env, max);
1751 OUTPUT:
1752 RETVAL
1753
1754 int set_lk_max_objects (DB_ENV *env, U32 max)
1755 CODE:
1756 RETVAL = env->set_lk_max_objects (env, max);
1757 OUTPUT:
1758 RETVAL
1759
1760 int set_lg_bsize (DB_ENV *env, U32 max)
1761 CODE:
1762 RETVAL = env->set_lg_bsize (env, max);
1763 OUTPUT:
1764 RETVAL
1765
1766 int set_lg_max (DB_ENV *env, U32 max)
1767 CODE:
1768 RETVAL = env->set_lg_max (env, max);
1769 OUTPUT:
1770 RETVAL
1771
1772 DB_TXN *
1773 txn_begin (DB_ENV *env, DB_TXN_ornull *parent = 0, U32 flags = 0)
1774 CODE:
1775 errno = env->txn_begin (env, parent, &RETVAL, flags);
1776 if (errno)
1777 croak ("DB_ENV->txn_begin: %s", db_strerror (errno));
1778 OUTPUT:
1779 RETVAL
1780
1781 MODULE = BDB PACKAGE = BDB::Db
1782
1783 void
1784 DESTROY (DB_ornull *db)
1785 CODE:
1786 if (db)
1787 {
1788 SV *env = (SV *)db->app_private;
1789 db->close (db, 0);
1790 SvREFCNT_dec (env);
1791 }
1792
1793 int set_cachesize (DB *db, U32 gbytes, U32 bytes, int ncache = 0)
1794 CODE:
1795 RETVAL = db->set_cachesize (db, gbytes, bytes, ncache);
1796 OUTPUT:
1797 RETVAL
1798
1799 int set_flags (DB *db, U32 flags)
1800 CODE:
1801 RETVAL = db->set_flags (db, flags);
1802 OUTPUT:
1803 RETVAL
1804
1805 int set_encrypt (DB *db, const char *password, U32 flags)
1806 CODE:
1807 RETVAL = db->set_encrypt (db, password, flags);
1808 OUTPUT:
1809 RETVAL
1810
1811 int set_lorder (DB *db, int lorder)
1812 CODE:
1813 RETVAL = db->set_lorder (db, lorder);
1814 OUTPUT:
1815 RETVAL
1816
1817 int set_bt_minkey (DB *db, U32 minkey)
1818 CODE:
1819 RETVAL = db->set_bt_minkey (db, minkey);
1820 OUTPUT:
1821 RETVAL
1822
1823 int set_re_delim (DB *db, int delim)
1824 CODE:
1825 RETVAL = db->set_re_delim (db, delim);
1826 OUTPUT:
1827 RETVAL
1828
1829 int set_re_pad (DB *db, int re_pad)
1830 CODE:
1831 RETVAL = db->set_re_pad (db, re_pad);
1832 OUTPUT:
1833 RETVAL
1834
1835 int set_re_source (DB *db, char *source)
1836 CODE:
1837 RETVAL = db->set_re_source (db, source);
1838 OUTPUT:
1839 RETVAL
1840
1841 int set_re_len (DB *db, U32 re_len)
1842 CODE:
1843 RETVAL = db->set_re_len (db, re_len);
1844 OUTPUT:
1845 RETVAL
1846
1847 int set_h_ffactor (DB *db, U32 h_ffactor)
1848 CODE:
1849 RETVAL = db->set_h_ffactor (db, h_ffactor);
1850 OUTPUT:
1851 RETVAL
1852
1853 int set_h_nelem (DB *db, U32 h_nelem)
1854 CODE:
1855 RETVAL = db->set_h_nelem (db, h_nelem);
1856 OUTPUT:
1857 RETVAL
1858
1859 int set_q_extentsize (DB *db, U32 extentsize)
1860 CODE:
1861 RETVAL = db->set_q_extentsize (db, extentsize);
1862 OUTPUT:
1863 RETVAL
1864
1865 DBC *
1866 cursor (DB *db, DB_TXN_ornull *txn = 0, U32 flags = 0)
1867 CODE:
1868 errno = db->cursor (db, txn, &RETVAL, flags);
1869 if (errno)
1870 croak ("DB->cursor: %s", db_strerror (errno));
1871 OUTPUT:
1872 RETVAL
1873
1874 DB_SEQUENCE *
1875 sequence (DB *db, U32 flags = 0)
1876 CODE:
1877 {
1878 errno = db_sequence_create (&RETVAL, db, flags);
1879 if (errno)
1880 croak ("db_sequence_create: %s", db_strerror (errno));
1881 }
1882 OUTPUT:
1883 RETVAL
1884
1885
1886 MODULE = BDB PACKAGE = BDB::Txn
1887
1888 void
1889 DESTROY (DB_TXN_ornull *txn)
1890 CODE:
1891 if (txn)
1892 txn->abort (txn);
1893
1894 int set_timeout (DB_TXN *txn, NV timeout, U32 flags)
1895 CODE:
1896 RETVAL = txn->set_timeout (txn, timeout * 1000000, flags);
1897 OUTPUT:
1898 RETVAL
1899
1900
1901 MODULE = BDB PACKAGE = BDB::Cursor
1902
1903 void
1904 DESTROY (DBC_ornull *dbc)
1905 CODE:
1906 if (dbc)
1907 dbc->c_close (dbc);
1908
1909 MODULE = BDB PACKAGE = BDB::Sequence
1910
1911 void
1912 DESTROY (DB_SEQUENCE_ornull *seq)
1913 CODE:
1914 if (seq)
1915 seq->close (seq, 0);
1916
1917 int initial_value (DB_SEQUENCE *seq, db_seq_t value)
1918 CODE:
1919 RETVAL = seq->initial_value (seq, value);
1920 OUTPUT:
1921 RETVAL
1922
1923 int set_cachesize (DB_SEQUENCE *seq, U32 size)
1924 CODE:
1925 RETVAL = seq->set_cachesize (seq, size);
1926 OUTPUT:
1927 RETVAL
1928
1929 int set_flags (DB_SEQUENCE *seq, U32 flags)
1930 CODE:
1931 RETVAL = seq->set_flags (seq, flags);
1932 OUTPUT:
1933 RETVAL
1934
1935 int set_range (DB_SEQUENCE *seq, db_seq_t min, db_seq_t max)
1936 CODE:
1937 RETVAL = seq->set_range (seq, min, max);
1938 OUTPUT:
1939 RETVAL
1940