[ViewVC] Diff of: cvs/BDB/BDB.xs

Comparing BDB/BDB.xs (file contents):
Revision 1.6 by root, Tue Feb 6 01:09:04 2007 UTC vs.
Revision 1.46 by root, Wed Jul 9 21:16:14 2008 UTC

…		…
1	/* solaris */	1	#include "xthread.h"
2	#define _POSIX_PTHREAD_SEMANTICS 1
3
4	#if __linux && !defined(_GNU_SOURCE)
5	# define _GNU_SOURCE
6	#endif
7
8	/* just in case */
9	#define _REENTRANT 1
10		2
11	#include <errno.h>	3	#include <errno.h>
12		4
13	#include "EXTERN.h"	5	#include "EXTERN.h"
14	#include "perl.h"	6	#include "perl.h"
15	#include "XSUB.h"	7	#include "XSUB.h"
16		8
17	#include <pthread.h>	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
18		17
19	#include <stddef.h>	18	#include <stddef.h>
20	#include <stdlib.h>	19	#include <stdlib.h>
21	#include <errno.h>	20	#include <errno.h>
22	#include <sys/time.h>
23	#include <sys/types.h>	21	#include <sys/types.h>
24	#include <limits.h>	22	#include <limits.h>
25	#include <unistd.h>
26	#include <fcntl.h>	23	#include <fcntl.h>
27		24
		25	#ifndef _WIN32
		26	# include <sys/time.h>
		27	# include <unistd.h>
		28	#endif
		29
28	#include <db.h>	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
29		35
30	/* number of seconds after which idle threads exit */	36	/* number of seconds after which idle threads exit */
31	#define IDLE_TIMEOUT 10	37	#define IDLE_TIMEOUT 10
32		38
33	/* wether word reads are potentially non-atomic.	39	typedef DB_ENV DB_ENV_ornull;
34	* this is conservatice, likely most arches this runs	40	typedef DB_TXN DB_TXN_ornull;
35	* on have atomic word read/writes.	41	typedef DBC DBC_ornull;
36	*/	42	typedef DB DB_ornull;
37	#ifndef WORDACCESS_UNSAFE	43	typedef DB_SEQUENCE DB_SEQUENCE_ornull;
38	# if __i386 \|\| __x86_64	44
39	# define WORDACCESS_UNSAFE 0	45	typedef DB_ENV DB_ENV_ornuked;
40	# else	46	typedef DB_TXN DB_TXN_ornuked;
41	# define WORDACCESS_UNSAFE 1	47	typedef DBC DBC_ornuked;
42	# endif	48	typedef DB DB_ornuked;
		49	typedef DB_SEQUENCE DB_SEQUENCE_ornuked;
		50
		51	typedef SV SV8; /* byte-sv, used for argument-checking */
		52	typedef char *bdb_filename;
		53
		54	static SV *prepare_cb;
		55
		56	#if DB_VERSION_MINOR >= 6
		57	# define c_close close
		58	# define c_count count
		59	# define c_del del
		60	# define c_dup dup
		61	# define c_get get
		62	# define c_pget pget
		63	# define c_put put
43	#endif	64	#endif
44		65
45	typedef DB_ENV DB_ENV_ornull;
46	typedef DB_TXN DB_TXN_ornull;
47	typedef DBC DBC_ornull;
48	typedef DB DB_ornull;
49
50	typedef SV SV8; /* byte-sv, used for argument-checking */
51	typedef char *octetstring;
52
53	static SV *prepare_cb;
54
55	static inline char *	66	static char *
		67	get_bdb_filename (SV *sv)
		68	{
		69	if (!SvOK (sv))
		70	return 0;
		71
		72	#if _WIN32
		73	/* win32 madness + win32 perl absolutely brokenness make for horrible hacks */
		74	{
		75	STRLEN len;
		76	char *src = SvPVbyte (sv, len);
		77	SV *t1 = sv_newmortal ();
		78	SV *t2 = sv_newmortal ();
		79
		80	sv_upgrade (t1, SVt_PV); SvPOK_only (t1); SvGROW (t1, len * 16 + 1);
		81	sv_upgrade (t2, SVt_PV); SvPOK_only (t2); SvGROW (t2, len * 16 + 1);
		82
		83	len = MultiByteToWideChar (CP_ACP, 0, src, len, (WCHAR *)SvPVX (t1), SvLEN (t1) / sizeof (WCHAR));
		84	len = WideCharToMultiByte (CP_UTF8, 0, (WCHAR *)SvPVX (t1), len, SvPVX (t2), SvLEN (t2), 0, 0);
		85	SvPOK_only (t2);
		86	SvPVX (t2)[len] = 0;
		87	SvCUR_set (t2, len);
		88
		89	return SvPVX (t2);
		90	}
		91	#else
		92	return SvPVbyte_nolen (sv);
		93	#endif
		94	}
		95
		96	static void
		97	debug_errcall (const DB_ENV dbenv, const char errpfx, const char *msg)
		98	{
		99	printf ("err[%s]\n", msg);
		100	}
		101
		102	static void
		103	debug_msgcall (const DB_ENV dbenv, const char msg)
		104	{
		105	printf ("msg[%s]\n", msg);
		106	}
		107
		108	static char *
56	strdup_ornull (const char *s)	109	strdup_ornull (const char *s)
57	{	110	{
58	return s ? strdup (s) : 0;	111	return s ? strdup (s) : 0;
59	}	112	}
60		113
61	static inline void	114	static void
62	sv_to_dbt (DBT dbt, SV sv)	115	sv_to_dbt (DBT dbt, SV sv)
63	{	116	{
64	STRLEN len;	117	STRLEN len;
65	char *data = SvPVbyte (sv, len);	118	char *data = SvPVbyte (sv, len);
66		119
68	memcpy (dbt->data, data, len);	121	memcpy (dbt->data, data, len);
69	dbt->size = len;	122	dbt->size = len;
70	dbt->flags = DB_DBT_REALLOC;	123	dbt->flags = DB_DBT_REALLOC;
71	}	124	}
72		125
73	static inline void	126	static void
74	dbt_to_sv (SV sv, DBT dbt)	127	dbt_to_sv (SV sv, DBT dbt)
75	{	128	{
76	if (sv)	129	if (sv)
77	{	130	{
78	SvREADONLY_off (sv);	131	SvREADONLY_off (sv);
…		…
83	free (dbt->data);	136	free (dbt->data);
84	}	137	}
85		138
86	enum {	139	enum {
87	REQ_QUIT,	140	REQ_QUIT,
88	REQ_ENV_OPEN, REQ_ENV_CLOSE,	141	REQ_ENV_OPEN, REQ_ENV_CLOSE, REQ_ENV_TXN_CHECKPOINT, REQ_ENV_LOCK_DETECT,
		142	REQ_ENV_MEMP_SYNC, REQ_ENV_MEMP_TRICKLE, REQ_ENV_DBREMOVE, REQ_ENV_DBRENAME,
89	REQ_DB_OPEN, REQ_DB_CLOSE, REQ_DB_COMPACT, REQ_DB_SYNC, REQ_DB_PUT, REQ_DB_GET, REQ_DB_PGET, REQ_DB_DEL,	143	REQ_DB_OPEN, REQ_DB_CLOSE, REQ_DB_COMPACT, REQ_DB_SYNC, REQ_DB_UPGRADE,
		144	REQ_DB_PUT, REQ_DB_EXISTS, REQ_DB_GET, REQ_DB_PGET, REQ_DB_DEL, REQ_DB_KEY_RANGE,
90	REQ_TXN_COMMIT, REQ_TXN_ABORT,	145	REQ_TXN_COMMIT, REQ_TXN_ABORT, REQ_TXN_FINISH,
91	REQ_C_CLOSE, REQ_C_COUNT, REQ_C_PUT, REQ_C_GET, REQ_C_PGET, REQ_C_DEL,	146	REQ_C_CLOSE, REQ_C_COUNT, REQ_C_PUT, REQ_C_GET, REQ_C_PGET, REQ_C_DEL,
		147	REQ_SEQ_OPEN, REQ_SEQ_CLOSE, REQ_SEQ_GET, REQ_SEQ_REMOVE,
92	};	148	};
93		149
94	typedef struct aio_cb	150	typedef struct bdb_cb
95	{	151	{
96	struct aio_cb *volatile next;	152	struct bdb_cb *volatile next;
97	SV *callback;	153	SV *callback;
98	int type, pri, result;	154	int type, pri, result;
99		155
100	DB_ENV *env;	156	DB_ENV *env;
101	DB *db;	157	DB *db;
…		…
103	DBC *dbc;	159	DBC *dbc;
104		160
105	UV uv1;	161	UV uv1;
106	int int1, int2;	162	int int1, int2;
107	U32 uint1, uint2;	163	U32 uint1, uint2;
108	char buf1, buf2;	164	char buf1, buf2, *buf3;
109	SV sv1, sv2, *sv3;	165	SV sv1, sv2, *sv3;
110		166
111	DBT dbt1, dbt2, dbt3;	167	DBT dbt1, dbt2, dbt3;
112	} aio_cb;	168	DB_KEY_RANGE key_range;
		169	DB_SEQUENCE *seq;
		170	db_seq_t seq_t;
		171	} bdb_cb;
113		172
114	typedef aio_cb *aio_req;	173	typedef bdb_cb *bdb_req;
115		174
116	enum {	175	enum {
117	PRI_MIN = -4,	176	PRI_MIN = -4,
118	PRI_MAX = 4,	177	PRI_MAX = 4,
119		178
…		…
122	NUM_PRI = PRI_MAX + PRI_BIAS + 1,	181	NUM_PRI = PRI_MAX + PRI_BIAS + 1,
123	};	182	};
124		183
125	#define AIO_TICKS ((1000000 + 1023) >> 10)	184	#define AIO_TICKS ((1000000 + 1023) >> 10)
126		185
		186	static SV *on_next_submit;
		187
127	static unsigned int max_poll_time = 0;	188	static unsigned int max_poll_time = 0;
128	static unsigned int max_poll_reqs = 0;	189	static unsigned int max_poll_reqs = 0;
129		190
130	/* calculcate time difference in ~1/AIO_TICKS of a second */	191	/* calculcate time difference in ~1/AIO_TICKS of a second */
131	static int tvdiff (struct timeval tv1, struct timeval tv2)	192	static int tvdiff (struct timeval tv1, struct timeval tv2)
…		…
136		197
137	static int next_pri = DEFAULT_PRI + PRI_BIAS;	198	static int next_pri = DEFAULT_PRI + PRI_BIAS;
138		199
139	static unsigned int started, idle, wanted;	200	static unsigned int started, idle, wanted;
140		201
141	#if __linux && defined (PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP)
142	# define AIO_MUTEX_INIT PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP
143	#else
144	# define AIO_MUTEX_INIT PTHREAD_MUTEX_INITIALIZER
145	#endif
146
147	#define LOCK(mutex) pthread_mutex_lock (&(mutex))
148	#define UNLOCK(mutex) pthread_mutex_unlock (&(mutex))
149
150	/* worker threads management */	202	/* worker threads management */
151	static pthread_mutex_t wrklock = AIO_MUTEX_INIT;	203	static mutex_t wrklock = X_MUTEX_INIT;
152		204
153	typedef struct worker {	205	typedef struct worker {
154	/* locked by wrklock */	206	/* locked by wrklock */
155	struct worker prev, next;	207	struct worker prev, next;
156		208
157	pthread_t tid;	209	thread_t tid;
158		210
159	/* locked by reslock, reqlock or wrklock */	211	/* locked by reslock, reqlock or wrklock */
160	aio_req req; /* currently processed request */	212	bdb_req req; /* currently processed request */
161	void *dbuf;	213	void *dbuf;
162	DIR *dirp;	214	DIR *dirp;
163	} worker;	215	} worker;
164		216
165	static worker wrk_first = { &wrk_first, &wrk_first, 0 };	217	static worker wrk_first = { &wrk_first, &wrk_first, 0 };
…		…
177	}	229	}
178		230
179	static volatile unsigned int nreqs, nready, npending;	231	static volatile unsigned int nreqs, nready, npending;
180	static volatile unsigned int max_idle = 4;	232	static volatile unsigned int max_idle = 4;
181	static volatile unsigned int max_outstanding = 0xffffffff;	233	static volatile unsigned int max_outstanding = 0xffffffff;
182	static int respipe [2];	234	static int respipe_osf [2], respipe [2] = { -1, -1 };
183		235
184	static pthread_mutex_t reslock = AIO_MUTEX_INIT;	236	static mutex_t reslock = X_MUTEX_INIT;
185	static pthread_mutex_t reqlock = AIO_MUTEX_INIT;	237	static mutex_t reqlock = X_MUTEX_INIT;
186	static pthread_cond_t reqwait = PTHREAD_COND_INITIALIZER;	238	static cond_t reqwait = X_COND_INIT;
187		239
188	#if WORDACCESS_UNSAFE	240	#if WORDACCESS_UNSAFE
189		241
190	static unsigned int get_nready ()	242	static unsigned int get_nready (void)
191	{	243	{
192	unsigned int retval;	244	unsigned int retval;
193		245
194	LOCK (reqlock);	246	X_LOCK (reqlock);
195	retval = nready;	247	retval = nready;
196	UNLOCK (reqlock);	248	X_UNLOCK (reqlock);
197		249
198	return retval;	250	return retval;
199	}	251	}
200		252
201	static unsigned int get_npending ()	253	static unsigned int get_npending (void)
202	{	254	{
203	unsigned int retval;	255	unsigned int retval;
204		256
205	LOCK (reslock);	257	X_LOCK (reslock);
206	retval = npending;	258	retval = npending;
207	UNLOCK (reslock);	259	X_UNLOCK (reslock);
208		260
209	return retval;	261	return retval;
210	}	262	}
211		263
212	static unsigned int get_nthreads ()	264	static unsigned int get_nthreads (void)
213	{	265	{
214	unsigned int retval;	266	unsigned int retval;
215		267
216	LOCK (wrklock);	268	X_LOCK (wrklock);
217	retval = started;	269	retval = started;
218	UNLOCK (wrklock);	270	X_UNLOCK (wrklock);
219		271
220	return retval;	272	return retval;
221	}	273	}
222		274
223	#else	275	#else
…		…
232	* a somewhat faster data structure might be nice, but	284	* a somewhat faster data structure might be nice, but
233	* with 8 priorities this actually needs <20 insns	285	* with 8 priorities this actually needs <20 insns
234	* per shift, the most expensive operation.	286	* per shift, the most expensive operation.
235	*/	287	*/
236	typedef struct {	288	typedef struct {
237	aio_req qs[NUM_PRI], qe[NUM_PRI]; /* qstart, qend */	289	bdb_req qs[NUM_PRI], qe[NUM_PRI]; /* qstart, qend */
238	int size;	290	int size;
239	} reqq;	291	} reqq;
240		292
241	static reqq req_queue;	293	static reqq req_queue;
242	static reqq res_queue;	294	static reqq res_queue;
243		295
244	int reqq_push (reqq *q, aio_req req)	296	int reqq_push (reqq *q, bdb_req req)
245	{	297	{
246	int pri = req->pri;	298	int pri = req->pri;
247	req->next = 0;	299	req->next = 0;
248		300
249	if (q->qe[pri])	301	if (q->qe[pri])
…		…
255	q->qe[pri] = q->qs[pri] = req;	307	q->qe[pri] = q->qs[pri] = req;
256		308
257	return q->size++;	309	return q->size++;
258	}	310	}
259		311
260	aio_req reqq_shift (reqq *q)	312	bdb_req reqq_shift (reqq *q)
261	{	313	{
262	int pri;	314	int pri;
263		315
264	if (!q->size)	316	if (!q->size)
265	return 0;	317	return 0;
266		318
267	--q->size;	319	--q->size;
268		320
269	for (pri = NUM_PRI; pri--; )	321	for (pri = NUM_PRI; pri--; )
270	{	322	{
271	aio_req req = q->qs[pri];	323	bdb_req req = q->qs[pri];
272		324
273	if (req)	325	if (req)
274	{	326	{
275	if (!(q->qs[pri] = req->next))	327	if (!(q->qs[pri] = req->next))
276	q->qe[pri] = 0;	328	q->qe[pri] = 0;
…		…
280	}	332	}
281		333
282	abort ();	334	abort ();
283	}	335	}
284		336
285	static int poll_cb ();	337	static int poll_cb (void);
286	static void req_free (aio_req req);	338	static void req_free (bdb_req req);
287	static void req_cancel (aio_req req);	339	static void req_cancel (bdb_req req);
288		340
289	static int req_invoke (aio_req req)	341	static int req_invoke (bdb_req req)
290	{	342	{
291	dSP;	343	dSP;
292		344
293	if (SvOK (req->callback))	345	if (req->callback)
294	{	346	{
295	ENTER;	347	ENTER;
296	SAVETMPS;	348	SAVETMPS;
297	PUSHMARK (SP);	349	PUSHMARK (SP);
298	EXTEND (SP, 1);
299		350
300	switch (req->type)	351	switch (req->type)
301	{	352	{
302	case REQ_DB_CLOSE:	353	case REQ_DB_CLOSE:
303	SvREFCNT_dec (req->sv1);	354	SvREFCNT_dec (req->sv1);
…		…
312	case REQ_C_PGET:	363	case REQ_C_PGET:
313	dbt_to_sv (req->sv1, &req->dbt1);	364	dbt_to_sv (req->sv1, &req->dbt1);
314	dbt_to_sv (req->sv2, &req->dbt2);	365	dbt_to_sv (req->sv2, &req->dbt2);
315	dbt_to_sv (req->sv3, &req->dbt3);	366	dbt_to_sv (req->sv3, &req->dbt3);
316	break;	367	break;
		368
		369	case REQ_DB_PUT:
		370	case REQ_C_PUT:
		371	dbt_to_sv (0, &req->dbt1);
		372	dbt_to_sv (0, &req->dbt2);
		373	break;
		374
		375	case REQ_DB_KEY_RANGE:
		376	{
		377	AV *av = newAV ();
		378
		379	av_push (av, newSVnv (req->key_range.less));
		380	av_push (av, newSVnv (req->key_range.equal));
		381	av_push (av, newSVnv (req->key_range.greater));
		382
		383	SvREADONLY_off (req->sv1);
		384	sv_setsv_mg (req->sv1, newRV_noinc ((SV *)av));
		385	SvREFCNT_dec (req->sv1);
		386	}
		387	break;
		388
		389	case REQ_SEQ_GET:
		390	SvREADONLY_off (req->sv1);
		391
		392	if (sizeof (IV) > 4)
		393	sv_setiv_mg (req->sv1, (IV)req->seq_t);
		394	else
		395	sv_setnv_mg (req->sv1, (NV)req->seq_t);
		396
		397	SvREFCNT_dec (req->sv1);
		398	break;
317	}	399	}
318		400
319	errno = req->result;	401	errno = req->result;
320		402
321	PUTBACK;	403	PUTBACK;
…		…
327	}	409	}
328		410
329	return !SvTRUE (ERRSV);	411	return !SvTRUE (ERRSV);
330	}	412	}
331		413
332	static void req_free (aio_req req)	414	static void req_free (bdb_req req)
333	{	415	{
		416	SvREFCNT_dec (req->callback);
		417
334	free (req->buf1);	418	free (req->buf1);
335	free (req->buf2);	419	free (req->buf2);
		420	free (req->buf3);
		421
336	Safefree (req);	422	Safefree (req);
337	}	423	}
338		424
339	static void aio_proc (void arg);	425	#ifdef USE_SOCKETS_AS_HANDLES
		426	# define TO_SOCKET(x) (win32_get_osfhandle (x))
		427	#else
		428	# define TO_SOCKET(x) (x)
		429	#endif
		430
		431	static void
		432	create_respipe (void)
		433	{
		434	#ifdef _WIN32
		435	int arg; /* argg */
		436	#endif
		437	int old_readfd = respipe [0];
		438
		439	if (respipe [1] >= 0)
		440	respipe_close (TO_SOCKET (respipe [1]));
		441
		442	#ifdef _WIN32
		443	if (PerlSock_socketpair (AF_UNIX, SOCK_STREAM, 0, respipe))
		444	#else
		445	if (pipe (respipe))
		446	#endif
		447	croak ("unable to initialize result pipe");
		448
		449	if (old_readfd >= 0)
		450	{
		451	if (dup2 (TO_SOCKET (respipe [0]), TO_SOCKET (old_readfd)) < 0)
		452	croak ("unable to initialize result pipe(2)");
		453
		454	respipe_close (respipe [0]);
		455	respipe [0] = old_readfd;
		456	}
		457
		458	#ifdef _WIN32
		459	arg = 1;
		460	if (ioctlsocket (TO_SOCKET (respipe [0]), FIONBIO, &arg)
		461	\|\| ioctlsocket (TO_SOCKET (respipe [1]), FIONBIO, &arg))
		462	#else
		463	if (fcntl (respipe [0], F_SETFL, O_NONBLOCK)
		464	\|\| fcntl (respipe [1], F_SETFL, O_NONBLOCK))
		465	#endif
		466	croak ("unable to initialize result pipe(3)");
		467
		468	respipe_osf [0] = TO_SOCKET (respipe [0]);
		469	respipe_osf [1] = TO_SOCKET (respipe [1]);
		470	}
		471
		472	X_THREAD_PROC (bdb_proc);
340		473
341	static void start_thread (void)	474	static void start_thread (void)
342	{	475	{
343	sigset_t fullsigset, oldsigset;
344	pthread_attr_t attr;
345
346	worker *wrk = calloc (1, sizeof (worker));	476	worker *wrk = calloc (1, sizeof (worker));
347		477
348	if (!wrk)	478	if (!wrk)
349	croak ("unable to allocate worker thread data");	479	croak ("unable to allocate worker thread data");
350		480
351	pthread_attr_init (&attr);
352	pthread_attr_setdetachstate (&attr, PTHREAD_CREATE_DETACHED);
353	#ifdef PTHREAD_SCOPE_PROCESS
354	pthread_attr_setscope (&attr, PTHREAD_SCOPE_PROCESS);
355	#endif
356
357	sigfillset (&fullsigset);
358
359	LOCK (wrklock);	481	X_LOCK (wrklock);
360	pthread_sigmask (SIG_SETMASK, &fullsigset, &oldsigset);
361
362	if (pthread_create (&wrk->tid, &attr, aio_proc, (void *)wrk) == 0)	482	if (thread_create (&wrk->tid, bdb_proc, (void *)wrk))
363	{	483	{
364	wrk->prev = &wrk_first;	484	wrk->prev = &wrk_first;
365	wrk->next = wrk_first.next;	485	wrk->next = wrk_first.next;
366	wrk_first.next->prev = wrk;	486	wrk_first.next->prev = wrk;
367	wrk_first.next = wrk;	487	wrk_first.next = wrk;
368	++started;	488	++started;
369	}	489	}
370	else	490	else
371	free (wrk);	491	free (wrk);
372		492
373	pthread_sigmask (SIG_SETMASK, &oldsigset, 0);
374	UNLOCK (wrklock);	493	X_UNLOCK (wrklock);
375	}	494	}
376		495
377	static void maybe_start_thread ()	496	static void maybe_start_thread (void)
378	{	497	{
379	if (get_nthreads () >= wanted)	498	if (get_nthreads () >= wanted)
380	return;	499	return;
381		500
382	/* todo: maybe use idle here, but might be less exact */	501	/* todo: maybe use idle here, but might be less exact */
…		…
384	return;	503	return;
385		504
386	start_thread ();	505	start_thread ();
387	}	506	}
388		507
389	static void req_send (aio_req req)	508	static void req_send (bdb_req req)
390	{	509	{
391	SV *wait_callback = 0;	510	SV *wait_callback = 0;
392		511
		512	if (on_next_submit)
		513	{
		514	dSP;
		515	SV *cb = sv_2mortal (on_next_submit);
		516
		517	on_next_submit = 0;
		518
		519	PUSHMARK (SP);
		520	PUTBACK;
		521	call_sv (cb, G_DISCARD \| G_EVAL);
		522	}
		523
393	// synthesize callback if none given	524	// synthesize callback if none given
394	if (!SvOK (req->callback))	525	if (!req->callback)
395	{	526	{
		527	int count;
		528
396	dSP;	529	dSP;
397	PUSHMARK (SP);	530	PUSHMARK (SP);
398	PUTBACK;	531	PUTBACK;
399	int count = call_sv (prepare_cb, G_ARRAY);	532	count = call_sv (prepare_cb, G_ARRAY);
400	SPAGAIN;	533	SPAGAIN;
401		534
402	if (count != 2)	535	if (count != 2)
403	croak ("prepare callback must return exactly two values\n");	536	croak ("prepare callback must return exactly two values\n");
404		537
405	wait_callback = SvREFCNT_inc (POPs);	538	wait_callback = POPs;
406	SvREFCNT_dec (req->callback);	539	SvREFCNT_dec (req->callback);
407	req->callback = SvREFCNT_inc (POPs);	540	req->callback = SvREFCNT_inc (POPs);
408	}	541	}
409		542
410	++nreqs;	543	++nreqs;
411		544
412	LOCK (reqlock);	545	X_LOCK (reqlock);
413	++nready;	546	++nready;
414	reqq_push (&req_queue, req);	547	reqq_push (&req_queue, req);
415	pthread_cond_signal (&reqwait);	548	X_COND_SIGNAL (reqwait);
416	UNLOCK (reqlock);	549	X_UNLOCK (reqlock);
417		550
418	maybe_start_thread ();	551	maybe_start_thread ();
419		552
420	if (wait_callback)	553	if (wait_callback)
421	{	554	{
422	dSP;	555	dSP;
423	PUSHMARK (SP);	556	PUSHMARK (SP);
424	PUTBACK;	557	PUTBACK;
425	call_sv (wait_callback, G_DISCARD);	558	call_sv (wait_callback, G_DISCARD);
426	SvREFCNT_dec (wait_callback);
427	}	559	}
428	}	560	}
429		561
430	static void end_thread (void)	562	static void end_thread (void)
431	{	563	{
432	aio_req req;	564	bdb_req req;
433		565
434	Newz (0, req, 1, aio_cb);	566	Newz (0, req, 1, bdb_cb);
435		567
436	req->type = REQ_QUIT;	568	req->type = REQ_QUIT;
437	req->pri = PRI_MAX + PRI_BIAS;	569	req->pri = PRI_MAX + PRI_BIAS;
438		570
439	LOCK (reqlock);	571	X_LOCK (reqlock);
440	reqq_push (&req_queue, req);	572	reqq_push (&req_queue, req);
441	pthread_cond_signal (&reqwait);	573	X_COND_SIGNAL (reqwait);
442	UNLOCK (reqlock);	574	X_UNLOCK (reqlock);
443		575
444	LOCK (wrklock);	576	X_LOCK (wrklock);
445	--started;	577	--started;
446	UNLOCK (wrklock);	578	X_UNLOCK (wrklock);
447	}	579	}
448		580
449	static void set_max_idle (int nthreads)	581	static void set_max_idle (int nthreads)
450	{	582	{
451	if (WORDACCESS_UNSAFE) LOCK (reqlock);	583	if (WORDACCESS_UNSAFE) X_LOCK (reqlock);
452	max_idle = nthreads <= 0 ? 1 : nthreads;	584	max_idle = nthreads <= 0 ? 1 : nthreads;
453	if (WORDACCESS_UNSAFE) UNLOCK (reqlock);	585	if (WORDACCESS_UNSAFE) X_UNLOCK (reqlock);
454	}	586	}
455		587
456	static void min_parallel (int nthreads)	588	static void min_parallel (int nthreads)
457	{	589	{
458	if (wanted < nthreads)	590	if (wanted < nthreads)
…		…
466		598
467	while (started > wanted)	599	while (started > wanted)
468	end_thread ();	600	end_thread ();
469	}	601	}
470		602
471	static void poll_wait ()	603	static void poll_wait (void)
472	{	604	{
473	fd_set rfd;	605	fd_set rfd;
474		606
475	while (nreqs)	607	while (nreqs)
476	{	608	{
477	int size;	609	int size;
478	if (WORDACCESS_UNSAFE) LOCK (reslock);	610	if (WORDACCESS_UNSAFE) X_LOCK (reslock);
479	size = res_queue.size;	611	size = res_queue.size;
480	if (WORDACCESS_UNSAFE) UNLOCK (reslock);	612	if (WORDACCESS_UNSAFE) X_UNLOCK (reslock);
481		613
482	if (size)	614	if (size)
483	return;	615	return;
484		616
485	maybe_start_thread ();	617	maybe_start_thread ();
486		618
487	FD_ZERO(&rfd);	619	FD_ZERO (&rfd);
488	FD_SET(respipe [0], &rfd);	620	FD_SET (respipe [0], &rfd);
489		621
490	select (respipe [0] + 1, &rfd, 0, 0, 0);	622	PerlSock_select (respipe [0] + 1, &rfd, 0, 0, 0);
491	}	623	}
492	}	624	}
493		625
494	static int poll_cb ()	626	static int poll_cb (void)
495	{	627	{
496	dSP;	628	dSP;
497	int count = 0;	629	int count = 0;
498	int maxreqs = max_poll_reqs;	630	int maxreqs = max_poll_reqs;
499	int do_croak = 0;	631	int do_croak = 0;
500	struct timeval tv_start, tv_now;	632	struct timeval tv_start, tv_now;
501	aio_req req;	633	bdb_req req;
502		634
503	if (max_poll_time)	635	if (max_poll_time)
504	gettimeofday (&tv_start, 0);	636	gettimeofday (&tv_start, 0);
505		637
506	for (;;)	638	for (;;)
507	{	639	{
508	for (;;)	640	for (;;)
509	{	641	{
510	maybe_start_thread ();	642	maybe_start_thread ();
511		643
512	LOCK (reslock);	644	X_LOCK (reslock);
513	req = reqq_shift (&res_queue);	645	req = reqq_shift (&res_queue);
514		646
515	if (req)	647	if (req)
516	{	648	{
517	--npending;	649	--npending;
518		650
519	if (!res_queue.size)	651	if (!res_queue.size)
520	{	652	{
521	/* read any signals sent by the worker threads */	653	/* read any signals sent by the worker threads */
522	char buf [4];	654	char buf [4];
523	while (read (respipe [0], buf, 4) == 4)	655	while (respipe_read (respipe [0], buf, 4) == 4)
524	;	656	;
525	}	657	}
526	}	658	}
527		659
528	UNLOCK (reslock);	660	X_UNLOCK (reslock);
529		661
530	if (!req)	662	if (!req)
531	break;	663	break;
532		664
533	--nreqs;	665	--nreqs;
…		…
563	}	695	}
564		696
565	return count;	697	return count;
566	}	698	}
567		699
568	static void create_pipe ()
569	{
570	if (pipe (respipe))
571	croak ("unable to initialize result pipe");
572
573	if (fcntl (respipe [0], F_SETFL, O_NONBLOCK))
574	croak ("cannot set result pipe to nonblocking mode");
575
576	if (fcntl (respipe [1], F_SETFL, O_NONBLOCK))
577	croak ("cannot set result pipe to nonblocking mode");
578	}
579
580	/*****************************************************************************/	700	/*****************************************************************************/
581		701
582	static void aio_proc (void thr_arg)	702	X_THREAD_PROC (bdb_proc)
583	{	703	{
584	aio_req req;	704	bdb_req req;
585	struct timespec ts;	705	struct timespec ts;
586	worker self = (worker )thr_arg;	706	worker self = (worker )thr_arg;
587		707
588	/* try to distribute timeouts somewhat evenly */	708	/* try to distribute timeouts somewhat evenly */
589	ts.tv_nsec = (((unsigned long)self + (unsigned long)ts.tv_sec) & 1023UL)	709	ts.tv_nsec = ((unsigned long)self & 1023UL) * (1000000000UL / 1024UL);
590	* (1000000000UL / 1024UL);
591		710
592	for (;;)	711	for (;;)
593	{	712	{
594	ts.tv_sec = time (0) + IDLE_TIMEOUT;	713	ts.tv_sec = time (0) + IDLE_TIMEOUT;
595		714
596	LOCK (reqlock);	715	X_LOCK (reqlock);
597		716
598	for (;;)	717	for (;;)
599	{	718	{
600	self->req = req = reqq_shift (&req_queue);	719	self->req = req = reqq_shift (&req_queue);
601		720
602	if (req)	721	if (req)
603	break;	722	break;
604		723
605	++idle;	724	++idle;
606		725
607	if (pthread_cond_timedwait (&reqwait, &reqlock, &ts)	726	if (X_COND_TIMEDWAIT (reqwait, reqlock, ts)
608	== ETIMEDOUT)	727	== ETIMEDOUT)
609	{	728	{
610	if (idle > max_idle)	729	if (idle > max_idle)
611	{	730	{
612	--idle;	731	--idle;
613	UNLOCK (reqlock);	732	X_UNLOCK (reqlock);
614	LOCK (wrklock);	733	X_LOCK (wrklock);
615	--started;	734	--started;
616	UNLOCK (wrklock);	735	X_UNLOCK (wrklock);
617	goto quit;	736	goto quit;
618	}	737	}
619		738
620	/* we are allowed to idle, so do so without any timeout */	739	/* we are allowed to idle, so do so without any timeout */
621	pthread_cond_wait (&reqwait, &reqlock);	740	X_COND_WAIT (reqwait, reqlock);
622	ts.tv_sec = time (0) + IDLE_TIMEOUT;	741	ts.tv_sec = time (0) + IDLE_TIMEOUT;
623	}	742	}
624		743
625	--idle;	744	--idle;
626	}	745	}
627		746
628	--nready;	747	--nready;
629		748
630	UNLOCK (reqlock);	749	X_UNLOCK (reqlock);
631		750
632	switch (req->type)	751	switch (req->type)
633	{	752	{
634	case REQ_QUIT:	753	case REQ_QUIT:
		754	req->result = ENOSYS;
635	goto quit;	755	goto quit;
636		756
637	case REQ_ENV_OPEN:	757	case REQ_ENV_OPEN:
638	req->result = req->env->open (req->env, req->buf1, req->uint1, req->int1);	758	req->result = req->env->open (req->env, req->buf1, req->uint1, req->int1);
639	break;	759	break;
640		760
641	case REQ_ENV_CLOSE:	761	case REQ_ENV_CLOSE:
642	req->result = req->env->close (req->env, req->uint1);	762	req->result = req->env->close (req->env, req->uint1);
643	break;	763	break;
644		764
		765	case REQ_ENV_TXN_CHECKPOINT:
		766	req->result = req->env->txn_checkpoint (req->env, req->uint1, req->int1, req->uint2);
		767	break;
		768
		769	case REQ_ENV_LOCK_DETECT:
		770	req->result = req->env->lock_detect (req->env, req->uint1, req->uint2, &req->int1);
		771	break;
		772
		773	case REQ_ENV_MEMP_SYNC:
		774	req->result = req->env->memp_sync (req->env, 0);
		775	break;
		776
		777	case REQ_ENV_MEMP_TRICKLE:
		778	req->result = req->env->memp_trickle (req->env, req->int1, &req->int2);
		779	break;
		780
		781	case REQ_ENV_DBREMOVE:
		782	req->result = req->env->dbremove (req->env, req->txn, req->buf1, req->buf2, req->uint1);
		783	break;
		784
		785	case REQ_ENV_DBRENAME:
		786	req->result = req->env->dbrename (req->env, req->txn, req->buf1, req->buf2, req->buf3, req->uint1);
		787	break;
		788
645	case REQ_DB_OPEN:	789	case REQ_DB_OPEN:
646	req->result = req->db->open (req->db, req->txn, req->buf1, req->buf2, req->int1, req->uint1, req->int2);	790	req->result = req->db->open (req->db, req->txn, req->buf1, req->buf2, req->int1, req->uint1, req->int2);
647	break;	791	break;
648		792
649	case REQ_DB_CLOSE:	793	case REQ_DB_CLOSE:
…		…
656		800
657	case REQ_DB_SYNC:	801	case REQ_DB_SYNC:
658	req->result = req->db->sync (req->db, req->uint1);	802	req->result = req->db->sync (req->db, req->uint1);
659	break;	803	break;
660		804
		805	case REQ_DB_UPGRADE:
		806	req->result = req->db->upgrade (req->db, req->buf1, req->uint1);
		807	break;
		808
661	case REQ_DB_PUT:	809	case REQ_DB_PUT:
662	req->result = req->db->put (req->db, req->txn, &req->dbt1, &req->dbt2, req->uint1);	810	req->result = req->db->put (req->db, req->txn, &req->dbt1, &req->dbt2, req->uint1);
663	break;	811	break;
664		812
		813	#if DB_VERSION_MINOR >= 6
		814	case REQ_DB_EXISTS:
		815	req->result = req->db->exists (req->db, req->txn, &req->dbt1, req->uint1);
		816	break;
		817	#endif
665	case REQ_DB_GET:	818	case REQ_DB_GET:
666	req->result = req->db->get (req->db, req->txn, &req->dbt1, &req->dbt3, req->uint1);	819	req->result = req->db->get (req->db, req->txn, &req->dbt1, &req->dbt3, req->uint1);
667	break;	820	break;
668		821
669	case REQ_DB_PGET:	822	case REQ_DB_PGET:
…		…
672		825
673	case REQ_DB_DEL:	826	case REQ_DB_DEL:
674	req->result = req->db->del (req->db, req->txn, &req->dbt1, req->uint1);	827	req->result = req->db->del (req->db, req->txn, &req->dbt1, req->uint1);
675	break;	828	break;
676		829
		830	case REQ_DB_KEY_RANGE:
		831	req->result = req->db->key_range (req->db, req->txn, &req->dbt1, &req->key_range, req->uint1);
		832	break;
		833
677	case REQ_TXN_COMMIT:	834	case REQ_TXN_COMMIT:
678	req->result = req->txn->commit (req->txn, req->uint1);	835	req->result = req->txn->commit (req->txn, req->uint1);
679	break;	836	break;
680		837
681	case REQ_TXN_ABORT:	838	case REQ_TXN_ABORT:
682	req->result = req->txn->abort (req->txn);	839	req->result = req->txn->abort (req->txn);
		840	break;
		841
		842	case REQ_TXN_FINISH:
		843	if (req->txn->flags & TXN_DEADLOCK)
		844	{
		845	req->result = req->txn->abort (req->txn);
		846	if (!req->result)
		847	req->result = DB_LOCK_DEADLOCK;
		848	}
		849	else
		850	req->result = req->txn->commit (req->txn, req->uint1);
683	break;	851	break;
684		852
685	case REQ_C_CLOSE:	853	case REQ_C_CLOSE:
686	req->result = req->dbc->c_close (req->dbc);	854	req->result = req->dbc->c_close (req->dbc);
687	break;	855	break;
…		…
708		876
709	case REQ_C_DEL:	877	case REQ_C_DEL:
710	req->result = req->dbc->c_del (req->dbc, req->uint1);	878	req->result = req->dbc->c_del (req->dbc, req->uint1);
711	break;	879	break;
712		880
		881	case REQ_SEQ_OPEN:
		882	req->result = req->seq->open (req->seq, req->txn, &req->dbt1, req->uint1);
		883	break;
		884
		885	case REQ_SEQ_CLOSE:
		886	req->result = req->seq->close (req->seq, req->uint1);
		887	break;
		888
		889	case REQ_SEQ_GET:
		890	req->result = req->seq->get (req->seq, req->txn, req->int1, &req->seq_t, req->uint1);
		891	break;
		892
		893	case REQ_SEQ_REMOVE:
		894	req->result = req->seq->remove (req->seq, req->txn, req->uint1);
		895	break;
		896
713	default:	897	default:
714	req->result = ENOSYS;	898	req->result = ENOSYS;
715	break;	899	break;
716	}	900	}
717		901
		902	if (req->txn && (req->result > 0 \|\| req->result == DB_LOCK_NOTGRANTED))
		903	req->txn->flags \|= TXN_DEADLOCK;
		904
718	LOCK (reslock);	905	X_LOCK (reslock);
719		906
720	++npending;	907	++npending;
721		908
722	if (!reqq_push (&res_queue, req))	909	if (!reqq_push (&res_queue, req))
723	/* write a dummy byte to the pipe so fh becomes ready */	910	/* write a dummy byte to the pipe so fh becomes ready */
724	write (respipe [1], &respipe, 1);	911	respipe_write (respipe_osf [1], (const void *)&respipe_osf, 1);
725		912
726	self->req = 0;	913	self->req = 0;
727	worker_clear (self);	914	worker_clear (self);
728		915
729	UNLOCK (reslock);	916	X_UNLOCK (reslock);
730	}	917	}
731		918
732	quit:	919	quit:
733	LOCK (wrklock);	920	X_LOCK (wrklock);
734	worker_free (self);	921	worker_free (self);
735	UNLOCK (wrklock);	922	X_UNLOCK (wrklock);
736		923
737	return 0;	924	return 0;
738	}	925	}
739		926
740	/*****************************************************************************/	927	/*****************************************************************************/
741		928
742	static void atfork_prepare (void)	929	static void atfork_prepare (void)
743	{	930	{
744	LOCK (wrklock);	931	X_LOCK (wrklock);
745	LOCK (reqlock);	932	X_LOCK (reqlock);
746	LOCK (reslock);	933	X_LOCK (reslock);
747	}	934	}
748		935
749	static void atfork_parent (void)	936	static void atfork_parent (void)
750	{	937	{
751	UNLOCK (reslock);	938	X_UNLOCK (reslock);
752	UNLOCK (reqlock);	939	X_UNLOCK (reqlock);
753	UNLOCK (wrklock);	940	X_UNLOCK (wrklock);
754	}	941	}
755		942
756	static void atfork_child (void)	943	static void atfork_child (void)
757	{	944	{
758	aio_req prv;	945	bdb_req prv;
759		946
760	while (prv = reqq_shift (&req_queue))	947	while (prv = reqq_shift (&req_queue))
761	req_free (prv);	948	req_free (prv);
762		949
763	while (prv = reqq_shift (&res_queue))	950	while (prv = reqq_shift (&res_queue))
…		…
778	idle = 0;	965	idle = 0;
779	nreqs = 0;	966	nreqs = 0;
780	nready = 0;	967	nready = 0;
781	npending = 0;	968	npending = 0;
782		969
783	close (respipe [0]);
784	close (respipe [1]);
785	create_pipe ();	970	create_respipe ();
786		971
787	atfork_parent ();	972	atfork_parent ();
788	}	973	}
789		974
790	#define dREQ(reqtype) \	975	#define dREQ(reqtype) \
791	aio_req req; \	976	bdb_req req; \
792	int req_pri = next_pri; \	977	int req_pri = next_pri; \
793	next_pri = DEFAULT_PRI + PRI_BIAS; \	978	next_pri = DEFAULT_PRI + PRI_BIAS; \
794	\	979	\
795	if (SvOK (callback) && !SvROK (callback)) \	980	if (callback && SvOK (callback)) \
796	croak ("callback must be undef or of reference type"); \	981	croak ("callback has illegal type or extra arguments"); \
797	\	982	\
798	Newz (0, req, 1, aio_cb); \	983	Newz (0, req, 1, bdb_cb); \
799	if (!req) \	984	if (!req) \
800	croak ("out of memory during aio_req allocation"); \	985	croak ("out of memory during bdb_req allocation"); \
801	\	986	\
802	req->callback = newSVsv (callback); \	987	req->callback = cb ? SvREFCNT_inc (cb) : 0; \
803	req->type = (reqtype); \	988	req->type = (reqtype); \
804	req->pri = req_pri	989	req->pri = req_pri
805		990
806	#define REQ_SEND \	991	#define REQ_SEND \
807	req_send (req)	992	req_send (req)
808		993
809	#define SvPTR(var, arg, type, class, nullok) \	994	#define SvPTR(var, arg, type, class, nullok) \
810	if (!SvOK (arg)) \	995	if (!SvOK (arg)) \
811	{ \	996	{ \
812	if (!nullok) \	997	if (nullok != 1) \
813	Perl_croak (# var " must be a " # class " object, not undef"); \	998	croak (# var " must be a " # class " object, not undef"); \
814	\	999	\
815	(var) = 0; \	1000	(var) = 0; \
816	} \	1001	} \
817	else if (sv_derived_from ((arg), # class)) \	1002	else if (sv_derived_from ((arg), # class)) \
818	{ \	1003	{ \
819	IV tmp = SvIV ((SV*) SvRV (arg)); \	1004	IV tmp = SvIV ((SV*) SvRV (arg)); \
820	(var) = INT2PTR (type, tmp); \	1005	(var) = INT2PTR (type, tmp); \
821	if (!var) \	1006	if (!var && nullok != 2) \
822	Perl_croak (# var " is not a valid " # class " object anymore"); \	1007	croak (# var " is not a valid " # class " object anymore"); \
823	} \	1008	} \
824	else \	1009	else \
825	Perl_croak (# var " is not of type " # class); \	1010	croak (# var " is not of type " # class);
826	\
827		1011
828	static void	1012	static void
829	ptr_nuke (SV *sv)	1013	ptr_nuke (SV *sv)
830	{	1014	{
831	assert (SvROK (sv));	1015	assert (SvROK (sv));
832	sv_setiv (SvRV (sv), 0);	1016	sv_setiv (SvRV (sv), 0);
833	}	1017	}
		1018
		1019	static int
		1020	errno_get (pTHX_ SV sv, MAGIC mg)
		1021	{
		1022	if (*mg->mg_ptr == '!') // should always be the case
		1023	if (-30999 <= errno && errno <= -30800)
		1024	{
		1025	sv_setnv (sv, (NV)errno);
		1026	sv_setpv (sv, db_strerror (errno));
		1027	SvNOK_on (sv); /* what a wonderful hack! */
		1028	// ^^^ copied from perl sources
		1029	return 0;
		1030	}
		1031
		1032	return PL_vtbl_sv.svt_get (aTHX_ sv, mg);
		1033	}
		1034
		1035	static MGVTBL vtbl_errno;
		1036
		1037	// this wonderful hack :( patches perl's $! variable to support our errno values
		1038	static void
		1039	patch_errno (void)
		1040	{
		1041	SV *sv;
		1042	MAGIC *mg;
		1043
		1044	if (!(sv = get_sv ("!", 1)))
		1045	return;
		1046
		1047	if (!(mg = mg_find (sv, PERL_MAGIC_sv)))
		1048	return;
		1049
		1050	if (mg->mg_virtual != &PL_vtbl_sv)
		1051	return;
		1052
		1053	vtbl_errno = PL_vtbl_sv;
		1054	vtbl_errno.svt_get = errno_get;
		1055	mg->mg_virtual = &vtbl_errno;
		1056	}
		1057
		1058	#if __GNUC__ >= 4
		1059	# define noinline __attribute__ ((noinline))
		1060	#else
		1061	# define noinline
		1062	#endif
		1063
		1064	static noinline SV *
		1065	pop_callback (I32 ritems, SV sv)
		1066	{
		1067	if (SvROK (sv))
		1068	{
		1069	HV *st;
		1070	GV *gvp;
		1071	CV *cv;
		1072	const char *name;
		1073
		1074	/* forgive me */
		1075	if (SvTYPE (SvRV (sv)) == SVt_PVMG
		1076	&& (st = SvSTASH (SvRV (sv)))
		1077	&& (name = HvNAME_get (st))
		1078	&& (name [0] == 'B' && name [1] == 'D' && name [2] == 'B' && name [3] == ':'))
		1079	return 0;
		1080
		1081	if ((cv = sv_2cv (sv, &st, &gvp, 0)))
		1082	{
		1083	--*ritems;
		1084	return (SV *)cv;
		1085	}
		1086	}
		1087
		1088	return 0;
		1089	}
		1090
		1091	#define CALLBACK SV *cb = pop_callback (&items, ST (items - 1));
834		1092
835	MODULE = BDB PACKAGE = BDB	1093	MODULE = BDB PACKAGE = BDB
836		1094
837	PROTOTYPES: ENABLE	1095	PROTOTYPES: ENABLE
838		1096
…		…
854	const_iv (INIT_TXN)	1112	const_iv (INIT_TXN)
855	const_iv (RECOVER)	1113	const_iv (RECOVER)
856	const_iv (INIT_TXN)	1114	const_iv (INIT_TXN)
857	const_iv (RECOVER_FATAL)	1115	const_iv (RECOVER_FATAL)
858	const_iv (CREATE)	1116	const_iv (CREATE)
		1117	const_iv (RDONLY)
859	const_iv (USE_ENVIRON)	1118	const_iv (USE_ENVIRON)
860	const_iv (USE_ENVIRON_ROOT)	1119	const_iv (USE_ENVIRON_ROOT)
861	const_iv (LOCKDOWN)	1120	const_iv (LOCKDOWN)
862	const_iv (PRIVATE)	1121	const_iv (PRIVATE)
863	const_iv (REGISTER)	1122	const_iv (REGISTER)
864	const_iv (SYSTEM_MEM)	1123	const_iv (SYSTEM_MEM)
865	const_iv (AUTO_COMMIT)	1124	const_iv (AUTO_COMMIT)
866	const_iv (CDB_ALLDB)	1125	const_iv (CDB_ALLDB)
867	const_iv (DIRECT_DB)	1126	const_iv (DIRECT_DB)
868	const_iv (DIRECT_LOG)
869	const_iv (DSYNC_DB)	1127	const_iv (DSYNC_DB)
870	const_iv (DSYNC_LOG)
871	const_iv (LOG_AUTOREMOVE)
872	const_iv (LOG_INMEMORY)
873	const_iv (NOLOCKING)	1128	const_iv (NOLOCKING)
874	const_iv (MULTIVERSION)
875	const_iv (NOMMAP)	1129	const_iv (NOMMAP)
876	const_iv (NOPANIC)	1130	const_iv (NOPANIC)
877	const_iv (OVERWRITE)	1131	const_iv (OVERWRITE)
878	const_iv (PANIC_ENVIRONMENT)	1132	const_iv (PANIC_ENVIRONMENT)
879	const_iv (REGION_INIT)	1133	const_iv (REGION_INIT)
880	const_iv (TIME_NOTGRANTED)	1134	const_iv (TIME_NOTGRANTED)
881	const_iv (TXN_NOSYNC)	1135	const_iv (TXN_NOSYNC)
882	const_iv (TXN_SNAPSHOT)	1136	const_iv (TXN_NOT_DURABLE)
883	const_iv (TXN_WRITE_NOSYNC)	1137	const_iv (TXN_WRITE_NOSYNC)
884	const_iv (WRITECURSOR)	1138	const_iv (WRITECURSOR)
885	const_iv (YIELDCPU)	1139	const_iv (YIELDCPU)
886	const_iv (ENCRYPT_AES)	1140	const_iv (ENCRYPT_AES)
887	const_iv (XA_CREATE)	1141	const_iv (XA_CREATE)
…		…
895	const_iv (READ_UNCOMMITTED)	1149	const_iv (READ_UNCOMMITTED)
896	const_iv (TRUNCATE)	1150	const_iv (TRUNCATE)
897	const_iv (NOSYNC)	1151	const_iv (NOSYNC)
898	const_iv (CHKSUM)	1152	const_iv (CHKSUM)
899	const_iv (ENCRYPT)	1153	const_iv (ENCRYPT)
900	const_iv (TXN_NOT_DURABLE)
901	const_iv (DUP)	1154	const_iv (DUP)
902	const_iv (DUPSORT)	1155	const_iv (DUPSORT)
903	const_iv (RECNUM)	1156	const_iv (RECNUM)
904	const_iv (RENUMBER)	1157	const_iv (RENUMBER)
905	const_iv (REVSPLITOFF)	1158	const_iv (REVSPLITOFF)
…		…
910	const_iv (GET_BOTH_RANGE)	1163	const_iv (GET_BOTH_RANGE)
911	//const_iv (SET_RECNO)	1164	//const_iv (SET_RECNO)
912	//const_iv (MULTIPLE)	1165	//const_iv (MULTIPLE)
913	const_iv (SNAPSHOT)	1166	const_iv (SNAPSHOT)
914	const_iv (JOIN_ITEM)	1167	const_iv (JOIN_ITEM)
		1168	const_iv (JOIN_NOSORT)
915	const_iv (RMW)	1169	const_iv (RMW)
916		1170
917	const_iv (NOTFOUND)	1171	const_iv (NOTFOUND)
918	const_iv (KEYEMPTY)	1172	const_iv (KEYEMPTY)
919	const_iv (LOCK_DEADLOCK)	1173	const_iv (LOCK_DEADLOCK)
…		…
930	const_iv (APPEND)	1184	const_iv (APPEND)
931	const_iv (NODUPDATA)	1185	const_iv (NODUPDATA)
932	const_iv (NOOVERWRITE)	1186	const_iv (NOOVERWRITE)
933		1187
934	const_iv (TXN_NOWAIT)	1188	const_iv (TXN_NOWAIT)
935	const_iv (TXN_SNAPSHOT)
936	const_iv (TXN_SYNC)	1189	const_iv (TXN_SYNC)
937		1190
938	const_iv (SET_LOCK_TIMEOUT)	1191	const_iv (SET_LOCK_TIMEOUT)
939	const_iv (SET_TXN_TIMEOUT)	1192	const_iv (SET_TXN_TIMEOUT)
940		1193
941	const_iv (JOIN_ITEM)
942	const_iv (FIRST)	1194	const_iv (FIRST)
943	const_iv (NEXT)	1195	const_iv (NEXT)
944	const_iv (NEXT_DUP)	1196	const_iv (NEXT_DUP)
945	const_iv (NEXT_NODUP)	1197	const_iv (NEXT_NODUP)
946	const_iv (PREV)	1198	const_iv (PREV)
…		…
952	const_iv (AFTER)	1204	const_iv (AFTER)
953	const_iv (CURRENT)	1205	const_iv (CURRENT)
954	const_iv (KEYFIRST)	1206	const_iv (KEYFIRST)
955	const_iv (KEYLAST)	1207	const_iv (KEYLAST)
956	const_iv (NODUPDATA)	1208	const_iv (NODUPDATA)
		1209
		1210	const_iv (FORCE)
		1211
		1212	const_iv (LOCK_DEFAULT)
		1213	const_iv (LOCK_EXPIRE)
		1214	const_iv (LOCK_MAXLOCKS)
		1215	const_iv (LOCK_MAXWRITE)
		1216	const_iv (LOCK_MINLOCKS)
		1217	const_iv (LOCK_MINWRITE)
		1218	const_iv (LOCK_OLDEST)
		1219	const_iv (LOCK_RANDOM)
		1220	const_iv (LOCK_YOUNGEST)
		1221
		1222	const_iv (SEQ_DEC)
		1223	const_iv (SEQ_INC)
		1224	const_iv (SEQ_WRAP)
		1225
		1226	const_iv (BUFFER_SMALL)
		1227	const_iv (DONOTINDEX)
		1228	const_iv (KEYEMPTY )
		1229	const_iv (KEYEXIST )
		1230	const_iv (LOCK_DEADLOCK)
		1231	const_iv (LOCK_NOTGRANTED)
		1232	const_iv (LOG_BUFFER_FULL)
		1233	const_iv (NOSERVER)
		1234	const_iv (NOSERVER_HOME)
		1235	const_iv (NOSERVER_ID)
		1236	const_iv (NOTFOUND)
		1237	const_iv (PAGE_NOTFOUND)
		1238	const_iv (REP_DUPMASTER)
		1239	const_iv (REP_HANDLE_DEAD)
		1240	const_iv (REP_HOLDELECTION)
		1241	const_iv (REP_IGNORE)
		1242	const_iv (REP_ISPERM)
		1243	const_iv (REP_JOIN_FAILURE)
		1244	const_iv (REP_LOCKOUT)
		1245	const_iv (REP_NEWMASTER)
		1246	const_iv (REP_NEWSITE)
		1247	const_iv (REP_NOTPERM)
		1248	const_iv (REP_UNAVAIL)
		1249	const_iv (RUNRECOVERY)
		1250	const_iv (SECONDARY_BAD)
		1251	const_iv (VERIFY_BAD)
		1252	const_iv (VERSION_MISMATCH)
		1253
		1254	const_iv (VERB_DEADLOCK)
		1255	const_iv (VERB_RECOVERY)
		1256	const_iv (VERB_REGISTER)
		1257	const_iv (VERB_REPLICATION)
		1258	const_iv (VERB_WAITSFOR)
		1259
		1260	const_iv (VERSION_MAJOR)
		1261	const_iv (VERSION_MINOR)
		1262	const_iv (VERSION_PATCH)
		1263	#if DB_VERSION_MINOR >= 5
		1264	const_iv (MULTIVERSION)
		1265	const_iv (TXN_SNAPSHOT)
		1266	#endif
		1267	#if DB_VERSION_MINOR >= 6
		1268	const_iv (PREV_DUP)
		1269	const_iv (PRIORITY_UNCHANGED)
		1270	const_iv (PRIORITY_VERY_LOW)
		1271	const_iv (PRIORITY_LOW)
		1272	const_iv (PRIORITY_DEFAULT)
		1273	const_iv (PRIORITY_HIGH)
		1274	const_iv (PRIORITY_VERY_HIGH)
		1275	#endif
		1276	#if DB_VERSION_MINOR >= 7
		1277	const_iv (LOG_DIRECT)
		1278	const_iv (LOG_DSYNC)
		1279	const_iv (LOG_AUTO_REMOVE)
		1280	const_iv (LOG_IN_MEMORY)
		1281	const_iv (LOG_ZERO)
		1282	#else
		1283	const_iv (DIRECT_LOG)
		1284	const_iv (DSYNC_LOG)
		1285	const_iv (LOG_AUTOREMOVE)
		1286	const_iv (LOG_INMEMORY)
		1287	#endif
957	};	1288	};
958		1289
959	for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )	1290	for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
960	newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));	1291	newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
961		1292
962	create_pipe ();	1293	{
		1294	/* we currently only allow version, minor-version and patchlevel to go up to 255 */
		1295	char vstring[3] = { DB_VERSION_MAJOR, DB_VERSION_MINOR, DB_VERSION_PATCH };
		1296
		1297	newCONSTSUB (stash, "VERSION_v", newSVpvn (vstring, 3));
		1298	}
		1299
		1300	newCONSTSUB (stash, "VERSION_STRING", newSVpv (DB_VERSION_STRING, 0));
		1301
		1302	create_respipe ();
		1303
963	pthread_atfork (atfork_prepare, atfork_parent, atfork_child);	1304	X_THREAD_ATFORK (atfork_prepare, atfork_parent, atfork_child);
		1305	patch_errno ();
964	}	1306	}
965		1307
966	void	1308	void
967	max_poll_reqs (int nreqs)	1309	max_poll_reqs (int nreqs)
968	PROTOTYPE: $	1310	PROTOTYPE: $
…		…
1087		1429
1088	int	1430	int
1089	nthreads ()	1431	nthreads ()
1090	PROTOTYPE:	1432	PROTOTYPE:
1091	CODE:	1433	CODE:
1092	if (WORDACCESS_UNSAFE) LOCK (wrklock);	1434	if (WORDACCESS_UNSAFE) X_LOCK (wrklock);
1093	RETVAL = started;	1435	RETVAL = started;
1094	if (WORDACCESS_UNSAFE) UNLOCK (wrklock);	1436	if (WORDACCESS_UNSAFE) X_UNLOCK (wrklock);
1095	OUTPUT:	1437	OUTPUT:
1096	RETVAL	1438	RETVAL
1097		1439
1098	void	1440	void
1099	set_sync_prepare (SV *cb)	1441	set_sync_prepare (SV *cb)
1100	PROTOTYPE: &	1442	PROTOTYPE: &
1101	CODE:	1443	CODE:
1102	SvREFCNT_dec (prepare_cb);	1444	SvREFCNT_dec (prepare_cb);
1103	prepare_cb = newSVsv (cb);	1445	prepare_cb = newSVsv (cb);
		1446
		1447	char *
		1448	strerror (int errorno = errno)
		1449	PROTOTYPE: ;$
		1450	CODE:
		1451	RETVAL = db_strerror (errorno);
		1452	OUTPUT:
		1453	RETVAL
		1454
		1455	void _on_next_submit (SV *cb)
		1456	CODE:
		1457	SvREFCNT_dec (on_next_submit);
		1458	on_next_submit = SvOK (cb) ? newSVsv (cb) : 0;
1104		1459
1105	DB_ENV *	1460	DB_ENV *
1106	db_env_create (U32 env_flags = 0)	1461	db_env_create (U32 env_flags = 0)
1107	CODE:	1462	CODE:
1108	{	1463	{
1109	errno = db_env_create (&RETVAL, env_flags);	1464	errno = db_env_create (&RETVAL, env_flags);
1110	if (errno)	1465	if (errno)
1111	croak ("db_env_create: %s", db_strerror (errno));	1466	croak ("db_env_create: %s", db_strerror (errno));
		1467
		1468	if (0)
		1469	{
		1470	RETVAL->set_errcall (RETVAL, debug_errcall);
		1471	RETVAL->set_msgcall (RETVAL, debug_msgcall);
		1472	}
1112	}	1473	}
1113	OUTPUT:	1474	OUTPUT:
1114	RETVAL	1475	RETVAL
1115		1476
1116	void	1477	void
1117	db_env_open (DB_ENV env, octetstring db_home, U32 open_flags, int mode, SV callback = &PL_sv_undef)	1478	db_env_open (DB_ENV env, bdb_filename db_home, U32 open_flags, int mode, SV callback = 0)
		1479	PREINIT:
		1480	CALLBACK
1118	CODE:	1481	CODE:
1119	{	1482	{
1120	dREQ (REQ_ENV_OPEN);	1483	dREQ (REQ_ENV_OPEN);
1121	req->env = env;	1484	req->env = env;
1122	req->uint1 = open_flags \| DB_THREAD;	1485	req->uint1 = open_flags \| DB_THREAD;
…		…
1124	req->buf1 = strdup_ornull (db_home);	1487	req->buf1 = strdup_ornull (db_home);
1125	REQ_SEND;	1488	REQ_SEND;
1126	}	1489	}
1127		1490
1128	void	1491	void
1129	db_env_close (DB_ENV env, U32 flags = 0, SV callback = &PL_sv_undef)	1492	db_env_close (DB_ENV env, U32 flags = 0, SV callback = 0)
		1493	PREINIT:
		1494	CALLBACK
1130	CODE:	1495	CODE:
1131	{	1496	{
1132	dREQ (REQ_ENV_CLOSE);	1497	dREQ (REQ_ENV_CLOSE);
1133	req->env = env;	1498	req->env = env;
1134	req->uint1 = flags;	1499	req->uint1 = flags;
1135	REQ_SEND;	1500	REQ_SEND;
1136	ptr_nuke (ST (0));	1501	ptr_nuke (ST (0));
1137	}	1502	}
1138		1503
		1504	void
		1505	db_env_txn_checkpoint (DB_ENV env, U32 kbyte = 0, U32 min = 0, U32 flags = 0, SV callback = 0)
		1506	PREINIT:
		1507	CALLBACK
		1508	CODE:
		1509	{
		1510	dREQ (REQ_ENV_TXN_CHECKPOINT);
		1511	req->env = env;
		1512	req->uint1 = kbyte;
		1513	req->int1 = min;
		1514	req->uint2 = flags;
		1515	REQ_SEND;
		1516	}
		1517
		1518	void
		1519	db_env_lock_detect (DB_ENV env, U32 flags = 0, U32 atype = DB_LOCK_DEFAULT, SV dummy = 0, SV *callback = 0)
		1520	PREINIT:
		1521	CALLBACK
		1522	CODE:
		1523	{
		1524	dREQ (REQ_ENV_LOCK_DETECT);
		1525	req->env = env;
		1526	req->uint1 = flags;
		1527	req->uint2 = atype;
		1528	/* req->int2 = 0; dummy */
		1529	REQ_SEND;
		1530	}
		1531
		1532	void
		1533	db_env_memp_sync (DB_ENV env, SV dummy = 0, SV *callback = 0)
		1534	PREINIT:
		1535	CALLBACK
		1536	CODE:
		1537	{
		1538	dREQ (REQ_ENV_MEMP_SYNC);
		1539	req->env = env;
		1540	REQ_SEND;
		1541	}
		1542
		1543	void
		1544	db_env_memp_trickle (DB_ENV env, int percent, SV dummy = 0, SV *callback = 0)
		1545	PREINIT:
		1546	CALLBACK
		1547	CODE:
		1548	{
		1549	dREQ (REQ_ENV_MEMP_TRICKLE);
		1550	req->env = env;
		1551	req->int1 = percent;
		1552	REQ_SEND;
		1553	}
		1554
		1555	void
		1556	db_env_dbremove (DB_ENV env, DB_TXN_ornull txnid, bdb_filename file, bdb_filename database, U32 flags = 0, SV *callback = 0)
		1557	PREINIT:
		1558	CALLBACK
		1559	CODE:
		1560	{
		1561	dREQ (REQ_ENV_DBREMOVE);
		1562	req->env = env;
		1563	req->buf1 = strdup_ornull (file);
		1564	req->buf2 = strdup_ornull (database);
		1565	req->uint1 = flags;
		1566	REQ_SEND;
		1567	}
		1568
		1569	void
		1570	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)
		1571	PREINIT:
		1572	CALLBACK
		1573	CODE:
		1574	{
		1575	dREQ (REQ_ENV_DBRENAME);
		1576	req->env = env;
		1577	req->buf1 = strdup_ornull (file);
		1578	req->buf2 = strdup_ornull (database);
		1579	req->buf3 = strdup_ornull (newname);
		1580	req->uint1 = flags;
		1581	REQ_SEND;
		1582	}
		1583
1139	DB *	1584	DB *
1140	db_create (DB_ENV *env = 0, U32 flags = 0)	1585	db_create (DB_ENV *env = 0, U32 flags = 0)
1141	CODE:	1586	CODE:
1142	{	1587	{
1143	errno = db_create (&RETVAL, env, flags);	1588	errno = db_create (&RETVAL, env, flags);
…		…
1149	}	1594	}
1150	OUTPUT:	1595	OUTPUT:
1151	RETVAL	1596	RETVAL
1152		1597
1153	void	1598	void
1154	db_open (DB db, DB_TXN_ornull txnid, octetstring file, octetstring database, int type, U32 flags, int mode, SV *callback = &PL_sv_undef)	1599	db_open (DB db, DB_TXN_ornull txnid, bdb_filename file, bdb_filename database, int type, U32 flags, int mode, SV *callback = 0)
		1600	PREINIT:
		1601	CALLBACK
1155	CODE:	1602	CODE:
1156	{	1603	{
1157	dREQ (REQ_DB_OPEN);	1604	dREQ (REQ_DB_OPEN);
1158	req->db = db;	1605	req->db = db;
1159	req->txn = txnid;	1606	req->txn = txnid;
…		…
1164	req->int2 = mode;	1611	req->int2 = mode;
1165	REQ_SEND;	1612	REQ_SEND;
1166	}	1613	}
1167		1614
1168	void	1615	void
1169	db_close (DB db, U32 flags = 0, SV callback = &PL_sv_undef)	1616	db_close (DB db, U32 flags = 0, SV callback = 0)
		1617	PREINIT:
		1618	CALLBACK
1170	CODE:	1619	CODE:
1171	{	1620	{
1172	dREQ (REQ_DB_CLOSE);	1621	dREQ (REQ_DB_CLOSE);
1173	req->db = db;	1622	req->db = db;
1174	req->uint1 = flags;	1623	req->uint1 = flags;
…		…
1176	REQ_SEND;	1625	REQ_SEND;
1177	ptr_nuke (ST (0));	1626	ptr_nuke (ST (0));
1178	}	1627	}
1179		1628
1180	void	1629	void
1181	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)	1630	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 = 0)
		1631	PREINIT:
		1632	CALLBACK
1182	CODE:	1633	CODE:
1183	{	1634	{
1184	dREQ (REQ_DB_COMPACT);	1635	dREQ (REQ_DB_COMPACT);
1185	req->db = db;	1636	req->db = db;
1186	req->txn = txn;	1637	req->txn = txn;
…		…
1189	req->uint1 = flags;	1640	req->uint1 = flags;
1190	REQ_SEND;	1641	REQ_SEND;
1191	}	1642	}
1192		1643
1193	void	1644	void
1194	db_sync (DB db, U32 flags = 0, SV callback = &PL_sv_undef)	1645	db_sync (DB db, U32 flags = 0, SV callback = 0)
		1646	PREINIT:
		1647	CALLBACK
1195	CODE:	1648	CODE:
1196	{	1649	{
1197	dREQ (REQ_DB_SYNC);	1650	dREQ (REQ_DB_SYNC);
1198	req->db = db;	1651	req->db = db;
1199	req->uint1 = flags;	1652	req->uint1 = flags;
1200	REQ_SEND;	1653	REQ_SEND;
1201	}	1654	}
1202		1655
1203	void	1656	void
		1657	db_upgrade (DB db, bdb_filename file, U32 flags = 0, SV callback = 0)
		1658	PREINIT:
		1659	CALLBACK
		1660	CODE:
		1661	{
		1662	dREQ (REQ_DB_SYNC);
		1663	req->db = db;
		1664	req->buf1 = strdup (file);
		1665	req->uint1 = flags;
		1666	REQ_SEND;
		1667	}
		1668
		1669	void
		1670	db_key_range (DB db, DB_TXN_ornull txn, SV key, SV key_range, U32 flags = 0, SV *callback = 0)
		1671	PREINIT:
		1672	CALLBACK
		1673	CODE:
		1674	{
		1675	dREQ (REQ_DB_KEY_RANGE);
		1676	req->db = db;
		1677	req->txn = txn;
		1678	sv_to_dbt (&req->dbt1, key);
		1679	req->uint1 = flags;
		1680	req->sv1 = SvREFCNT_inc (key_range); SvREADONLY_on (key_range);
		1681	REQ_SEND;
		1682	}
		1683
		1684	void
1204	db_put (DB db, DB_TXN_ornull txn, SV key, SV data, U32 flags = 0, SV *callback = &PL_sv_undef)	1685	db_put (DB db, DB_TXN_ornull txn, SV key, SV data, U32 flags = 0, SV *callback = 0)
		1686	PREINIT:
		1687	CALLBACK
1205	CODE:	1688	CODE:
1206	{	1689	{
1207	dREQ (REQ_DB_PUT);	1690	dREQ (REQ_DB_PUT);
1208	req->db = db;	1691	req->db = db;
1209	req->txn = txn;	1692	req->txn = txn;
…		…
1211	sv_to_dbt (&req->dbt2, data);	1694	sv_to_dbt (&req->dbt2, data);
1212	req->uint1 = flags;	1695	req->uint1 = flags;
1213	REQ_SEND;	1696	REQ_SEND;
1214	}	1697	}
1215		1698
		1699	#if DB_VERSION_MINOR >= 6
		1700
1216	void	1701	void
		1702	db_exists (DB db, DB_TXN_ornull txn, SV key, U32 flags = 0, SV callback = 0)
		1703	PREINIT:
		1704	CALLBACK
		1705	CODE:
		1706	{
		1707	dREQ (REQ_DB_EXISTS);
		1708	req->db = db;
		1709	req->txn = txn;
		1710	req->uint1 = flags;
		1711	sv_to_dbt (&req->dbt1, key);
		1712	REQ_SEND;
		1713	}
		1714
		1715	#endif
		1716
		1717	void
1217	db_get (DB db, DB_TXN_ornull txn, SV key, SV data, U32 flags = 0, SV *callback = &PL_sv_undef)	1718	db_get (DB db, DB_TXN_ornull txn, SV key, SV data, U32 flags = 0, SV *callback = 0)
		1719	PREINIT:
		1720	CALLBACK
1218	CODE:	1721	CODE:
		1722	if (SvREADONLY (data))
		1723	croak ("can't modify read-only data scalar in db_get");
1219	{	1724	{
1220	dREQ (REQ_DB_GET);	1725	dREQ (REQ_DB_GET);
1221	req->db = db;	1726	req->db = db;
1222	req->txn = txn;	1727	req->txn = txn;
1223	req->uint1 = flags;	1728	req->uint1 = flags;
…		…
1226	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);	1731	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1227	REQ_SEND;	1732	REQ_SEND;
1228	}	1733	}
1229		1734
1230	void	1735	void
1231	db_pget (DB db, DB_TXN_ornull txn, SV key, SV pkey, SV data, U32 flags = 0, SV callback = &PL_sv_undef)	1736	db_pget (DB db, DB_TXN_ornull txn, SV key, SV pkey, SV data, U32 flags = 0, SV callback = 0)
		1737	PREINIT:
		1738	CALLBACK
1232	CODE:	1739	CODE:
		1740	if (SvREADONLY (data))
		1741	croak ("can't modify read-only data scalar in db_pget");
1233	{	1742	{
1234	dREQ (REQ_DB_PGET);	1743	dREQ (REQ_DB_PGET);
1235	req->db = db;	1744	req->db = db;
1236	req->txn = txn;	1745	req->txn = txn;
1237	req->uint1 = flags;	1746	req->uint1 = flags;
…		…
1241	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);	1750	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1242	REQ_SEND;	1751	REQ_SEND;
1243	}	1752	}
1244		1753
1245	void	1754	void
1246	db_del (DB db, DB_TXN_ornull txn, SV key, U32 flags = 0, SV callback = &PL_sv_undef)	1755	db_del (DB db, DB_TXN_ornull txn, SV key, U32 flags = 0, SV callback = 0)
		1756	PREINIT:
		1757	CALLBACK
1247	CODE:	1758	CODE:
1248	{	1759	{
1249	dREQ (REQ_DB_DEL);	1760	dREQ (REQ_DB_DEL);
1250	req->db = db;	1761	req->db = db;
1251	req->txn = txn;	1762	req->txn = txn;
…		…
1253	sv_to_dbt (&req->dbt1, key);	1764	sv_to_dbt (&req->dbt1, key);
1254	REQ_SEND;	1765	REQ_SEND;
1255	}	1766	}
1256		1767
1257	void	1768	void
1258	db_txn_commit (DB_TXN txn, U32 flags = 0, SV callback = &PL_sv_undef)	1769	db_txn_commit (DB_TXN txn, U32 flags = 0, SV callback = 0)
		1770	PREINIT:
		1771	CALLBACK
1259	CODE:	1772	CODE:
1260	{	1773	{
1261	dREQ (REQ_TXN_COMMIT);	1774	dREQ (REQ_TXN_COMMIT);
1262	req->txn = txn;	1775	req->txn = txn;
1263	req->uint1 = flags;	1776	req->uint1 = flags;
1264	REQ_SEND;	1777	REQ_SEND;
1265	ptr_nuke (ST (0));	1778	ptr_nuke (ST (0));
1266	}	1779	}
1267		1780
1268	void	1781	void
1269	db_txn_abort (DB_TXN txn, SV callback = &PL_sv_undef)	1782	db_txn_abort (DB_TXN txn, SV callback = 0)
		1783	PREINIT:
		1784	CALLBACK
1270	CODE:	1785	CODE:
1271	{	1786	{
1272	dREQ (REQ_TXN_ABORT);	1787	dREQ (REQ_TXN_ABORT);
1273	req->txn = txn;	1788	req->txn = txn;
1274	REQ_SEND;	1789	REQ_SEND;
1275	ptr_nuke (ST (0));	1790	ptr_nuke (ST (0));
1276	}	1791	}
1277		1792
1278	void	1793	void
		1794	db_txn_finish (DB_TXN txn, U32 flags = 0, SV callback = 0)
		1795	PREINIT:
		1796	CALLBACK
		1797	CODE:
		1798	{
		1799	dREQ (REQ_TXN_FINISH);
		1800	req->txn = txn;
		1801	req->uint1 = flags;
		1802	REQ_SEND;
		1803	ptr_nuke (ST (0));
		1804	}
		1805
		1806	void
1279	db_c_close (DBC dbc, SV callback = &PL_sv_undef)	1807	db_c_close (DBC dbc, SV callback = 0)
		1808	PREINIT:
		1809	CALLBACK
1280	CODE:	1810	CODE:
1281	{	1811	{
1282	dREQ (REQ_C_CLOSE);	1812	dREQ (REQ_C_CLOSE);
1283	req->dbc = dbc;	1813	req->dbc = dbc;
1284	REQ_SEND;	1814	REQ_SEND;
1285	ptr_nuke (ST (0));	1815	ptr_nuke (ST (0));
1286	}	1816	}
1287		1817
1288	void	1818	void
1289	db_c_count (DBC dbc, SV count, U32 flags = 0, SV *callback = &PL_sv_undef)	1819	db_c_count (DBC dbc, SV count, U32 flags = 0, SV *callback = 0)
		1820	PREINIT:
		1821	CALLBACK
1290	CODE:	1822	CODE:
1291	{	1823	{
1292	dREQ (REQ_C_COUNT);	1824	dREQ (REQ_C_COUNT);
1293	req->dbc = dbc;	1825	req->dbc = dbc;
1294	req->sv1 = SvREFCNT_inc (count);	1826	req->sv1 = SvREFCNT_inc (count);
1295	REQ_SEND;	1827	REQ_SEND;
1296	}	1828	}
1297		1829
1298	void	1830	void
1299	db_c_put (DBC dbc, SV key, SV data, U32 flags = 0, SV callback = &PL_sv_undef)	1831	db_c_put (DBC dbc, SV key, SV data, U32 flags = 0, SV callback = 0)
		1832	PREINIT:
		1833	CALLBACK
1300	CODE:	1834	CODE:
1301	{	1835	{
1302	dREQ (REQ_C_PUT);	1836	dREQ (REQ_C_PUT);
1303	req->dbc = dbc;	1837	req->dbc = dbc;
1304	sv_to_dbt (&req->dbt1, key);	1838	sv_to_dbt (&req->dbt1, key);
…		…
1306	req->uint1 = flags;	1840	req->uint1 = flags;
1307	REQ_SEND;	1841	REQ_SEND;
1308	}	1842	}
1309		1843
1310	void	1844	void
1311	db_c_get (DBC dbc, SV key, SV data, U32 flags = 0, SV callback = &PL_sv_undef)	1845	db_c_get (DBC dbc, SV key, SV data, U32 flags = 0, SV callback = 0)
		1846	PREINIT:
		1847	CALLBACK
1312	CODE:	1848	CODE:
1313	{	1849	{
1314	dREQ (REQ_C_GET);	1850	dREQ (REQ_C_GET);
1315	req->dbc = dbc;	1851	req->dbc = dbc;
1316	req->uint1 = flags;	1852	req->uint1 = flags;
…		…
1331	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);	1867	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1332	REQ_SEND;	1868	REQ_SEND;
1333	}	1869	}
1334		1870
1335	void	1871	void
1336	db_c_pget (DBC dbc, SV key, SV pkey, SV data, U32 flags = 0, SV *callback = &PL_sv_undef)	1872	db_c_pget (DBC dbc, SV key, SV pkey, SV data, U32 flags = 0, SV *callback = 0)
		1873	PREINIT:
		1874	CALLBACK
1337	CODE:	1875	CODE:
1338	{	1876	{
1339	dREQ (REQ_C_PGET);	1877	dREQ (REQ_C_PGET);
1340	req->dbc = dbc;	1878	req->dbc = dbc;
1341	req->uint1 = flags;	1879	req->uint1 = flags;
…		…
1359	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);	1897	req->sv3 = SvREFCNT_inc (data); SvREADONLY_on (data);
1360	REQ_SEND;	1898	REQ_SEND;
1361	}	1899	}
1362		1900
1363	void	1901	void
1364	db_c_del (DBC dbc, U32 flags = 0, SV callback = &PL_sv_undef)	1902	db_c_del (DBC dbc, U32 flags = 0, SV callback = 0)
		1903	PREINIT:
		1904	CALLBACK
1365	CODE:	1905	CODE:
1366	{	1906	{
1367	dREQ (REQ_C_DEL);	1907	dREQ (REQ_C_DEL);
1368	req->dbc = dbc;	1908	req->dbc = dbc;
1369	req->uint1 = flags;	1909	req->uint1 = flags;
1370	REQ_SEND;	1910	REQ_SEND;
1371	}	1911	}
1372		1912
1373		1913
		1914	void
		1915	db_sequence_open (DB_SEQUENCE seq, DB_TXN_ornull txnid, SV key, U32 flags = 0, SV callback = 0)
		1916	PREINIT:
		1917	CALLBACK
		1918	CODE:
		1919	{
		1920	dREQ (REQ_SEQ_OPEN);
		1921	req->seq = seq;
		1922	req->txn = txnid;
		1923	req->uint1 = flags \| DB_THREAD;
		1924	sv_to_dbt (&req->dbt1, key);
		1925	REQ_SEND;
		1926	}
		1927
		1928	void
		1929	db_sequence_close (DB_SEQUENCE seq, U32 flags = 0, SV callback = 0)
		1930	PREINIT:
		1931	CALLBACK
		1932	CODE:
		1933	{
		1934	dREQ (REQ_SEQ_CLOSE);
		1935	req->seq = seq;
		1936	req->uint1 = flags;
		1937	REQ_SEND;
		1938	ptr_nuke (ST (0));
		1939	}
		1940
		1941	void
		1942	db_sequence_get (DB_SEQUENCE seq, DB_TXN_ornull txnid, int delta, SV seq_value, U32 flags = DB_TXN_NOSYNC, SV callback = 0)
		1943	PREINIT:
		1944	CALLBACK
		1945	CODE:
		1946	{
		1947	dREQ (REQ_SEQ_GET);
		1948	req->seq = seq;
		1949	req->txn = txnid;
		1950	req->int1 = delta;
		1951	req->uint1 = flags;
		1952	req->sv1 = SvREFCNT_inc (seq_value); SvREADONLY_on (seq_value);
		1953	REQ_SEND;
		1954	}
		1955
		1956	void
		1957	db_sequence_remove (DB_SEQUENCE seq, DB_TXN_ornull txnid = 0, U32 flags = 0, SV *callback = 0)
		1958	PREINIT:
		1959	CALLBACK
		1960	CODE:
		1961	{
		1962	dREQ (REQ_SEQ_REMOVE);
		1963	req->seq = seq;
		1964	req->txn = txnid;
		1965	req->uint1 = flags;
		1966	REQ_SEND;
		1967	}
		1968
		1969
1374	MODULE = BDB PACKAGE = BDB::Env	1970	MODULE = BDB PACKAGE = BDB::Env
1375		1971
1376	void	1972	void
1377	DESTROY (DB_ENV_ornull *env)	1973	DESTROY (DB_ENV_ornuked *env)
1378	CODE:	1974	CODE:
1379	if (env)	1975	if (env)
1380	env->close (env, 0);	1976	env->close (env, 0);
1381		1977
		1978	int set_data_dir (DB_ENV env, const char dir)
		1979	CODE:
		1980	RETVAL = env->set_data_dir (env, dir);
		1981	OUTPUT:
		1982	RETVAL
		1983
		1984	int set_tmp_dir (DB_ENV env, const char dir)
		1985	CODE:
		1986	RETVAL = env->set_tmp_dir (env, dir);
		1987	OUTPUT:
		1988	RETVAL
		1989
		1990	int set_lg_dir (DB_ENV env, const char dir)
		1991	CODE:
		1992	RETVAL = env->set_lg_dir (env, dir);
		1993	OUTPUT:
		1994	RETVAL
		1995
		1996	int set_shm_key (DB_ENV *env, long shm_key)
		1997	CODE:
		1998	RETVAL = env->set_shm_key (env, shm_key);
		1999	OUTPUT:
		2000	RETVAL
		2001
1382	int set_cachesize (DB_ENV *env, U32 gbytes, U32 bytes, int ncache = 0)	2002	int set_cachesize (DB_ENV *env, U32 gbytes, U32 bytes, int ncache = 0)
1383	CODE:	2003	CODE:
1384	RETVAL = env->set_cachesize (env, gbytes, bytes, ncache);	2004	RETVAL = env->set_cachesize (env, gbytes, bytes, ncache);
1385	OUTPUT:	2005	OUTPUT:
1386	RETVAL	2006	RETVAL
1387		2007
1388	int set_flags (DB_ENV *env, U32 flags, int onoff)	2008	int set_flags (DB_ENV *env, U32 flags, int onoff = 1)
1389	CODE:	2009	CODE:
1390	RETVAL = env->set_flags (env, flags, onoff);	2010	RETVAL = env->set_flags (env, flags, onoff);
1391	OUTPUT:	2011	OUTPUT:
1392	RETVAL	2012	RETVAL
1393		2013
		2014	#if DB_VERSION_MINOR >= 7
		2015
		2016	int set_intermediate_dir_mode (DB_ENV env, const char mode)
		2017	CODE:
		2018	RETVAL = env->set_intermediate_dir_mode (env, mode);
		2019	OUTPUT:
		2020	RETVAL
		2021
		2022	int log_set_config (DB_ENV *env, U32 flags, int onoff = 1)
		2023	CODE:
		2024	RETVAL = env->log_set_config (env, flags, onoff);
		2025	OUTPUT:
		2026	RETVAL
		2027
		2028	#endif
		2029
		2030
		2031	void set_errfile (DB_ENV env, FILE errfile = 0)
		2032	CODE:
		2033	env->set_errfile (env, errfile);
		2034
		2035	void set_msgfile (DB_ENV env, FILE msgfile = 0)
		2036	CODE:
		2037	env->set_msgfile (env, msgfile);
		2038
		2039	int set_verbose (DB_ENV *env, U32 which = -1, int onoff = 1)
		2040	CODE:
		2041	RETVAL = env->set_verbose (env, which, onoff);
		2042	OUTPUT:
		2043	RETVAL
		2044
1394	int set_encrypt (DB_ENV env, const char password, U32 flags = 0)	2045	int set_encrypt (DB_ENV env, const char password, U32 flags = 0)
1395	CODE:	2046	CODE:
1396	RETVAL = env->set_encrypt (env, password, flags);	2047	RETVAL = env->set_encrypt (env, password, flags);
1397	OUTPUT:	2048	OUTPUT:
1398	RETVAL	2049	RETVAL
1399		2050
1400	int set_timeout (DB_ENV *env, NV timeout, U32 flags)	2051	int set_timeout (DB_ENV *env, NV timeout, U32 flags = DB_SET_TXN_TIMEOUT)
1401	CODE:	2052	CODE:
1402	RETVAL = env->set_timeout (env, timeout * 1000000, flags);	2053	RETVAL = env->set_timeout (env, timeout * 1000000, flags);
1403	OUTPUT:	2054	OUTPUT:
		2055	RETVAL
		2056
		2057	int set_mp_max_openfd (DB_ENV *env, int maxopenfd);
		2058	CODE:
		2059	RETVAL = env->set_mp_max_openfd (env, maxopenfd);
		2060	OUTPUT:
		2061	RETVAL
		2062
		2063	int set_mp_max_write (DB_ENV *env, int maxwrite, int maxwrite_sleep);
		2064	CODE:
		2065	RETVAL = env->set_mp_max_write (env, maxwrite, maxwrite_sleep);
		2066	OUTPUT:
		2067	RETVAL
		2068
		2069	int set_mp_mmapsize (DB_ENV *env, int mmapsize_mb)
		2070	CODE:
		2071	RETVAL = env->set_mp_mmapsize (env, ((size_t)mmapsize_mb) << 20);
		2072	OUTPUT:
		2073	RETVAL
		2074
		2075	int set_lk_detect (DB_ENV *env, U32 detect = DB_LOCK_DEFAULT)
		2076	CODE:
		2077	RETVAL = env->set_lk_detect (env, detect);
		2078	OUTPUT:
		2079	RETVAL
		2080
		2081	int set_lk_max_lockers (DB_ENV *env, U32 max)
		2082	CODE:
		2083	RETVAL = env->set_lk_max_lockers (env, max);
		2084	OUTPUT:
		2085	RETVAL
		2086
		2087	int set_lk_max_locks (DB_ENV *env, U32 max)
		2088	CODE:
		2089	RETVAL = env->set_lk_max_locks (env, max);
		2090	OUTPUT:
		2091	RETVAL
		2092
		2093	int set_lk_max_objects (DB_ENV *env, U32 max)
		2094	CODE:
		2095	RETVAL = env->set_lk_max_objects (env, max);
		2096	OUTPUT:
		2097	RETVAL
		2098
		2099	int set_lg_bsize (DB_ENV *env, U32 max)
		2100	CODE:
		2101	RETVAL = env->set_lg_bsize (env, max);
		2102	OUTPUT:
		2103	RETVAL
		2104
		2105	int set_lg_max (DB_ENV *env, U32 max)
		2106	CODE:
		2107	RETVAL = env->set_lg_max (env, max);
		2108	OUTPUT:
		2109	RETVAL
		2110
		2111	int mutex_set_max (DB_ENV *env, U32 max)
		2112	CODE:
		2113	RETVAL = env->mutex_set_max (env, max);
		2114	OUTPUT:
		2115	RETVAL
		2116
		2117	int mutex_set_increment (DB_ENV *env, U32 increment)
		2118	CODE:
		2119	RETVAL = env->mutex_set_increment (env, increment);
		2120	OUTPUT:
		2121	RETVAL
		2122
		2123	int mutex_set_tas_spins (DB_ENV *env, U32 tas_spins)
		2124	CODE:
		2125	RETVAL = env->mutex_set_tas_spins (env, tas_spins);
		2126	OUTPUT:
		2127	RETVAL
		2128
		2129	int mutex_set_align (DB_ENV *env, U32 align)
		2130	CODE:
		2131	RETVAL = env->mutex_set_align (env, align);
		2132	OUTPUT:
1404	RETVAL	2133	RETVAL
1405		2134
1406	DB_TXN *	2135	DB_TXN *
1407	txn_begin (DB_ENV env, DB_TXN_ornull parent = 0, U32 flags = 0)	2136	txn_begin (DB_ENV env, DB_TXN_ornull parent = 0, U32 flags = 0)
1408	CODE:	2137	CODE:
…		…
1410	if (errno)	2139	if (errno)
1411	croak ("DB_ENV->txn_begin: %s", db_strerror (errno));	2140	croak ("DB_ENV->txn_begin: %s", db_strerror (errno));
1412	OUTPUT:	2141	OUTPUT:
1413	RETVAL	2142	RETVAL
1414		2143
		2144	#if DB_VERSION_MINOR >= 5
		2145
		2146	DB_TXN *
		2147	cdsgroup_begin (DB_ENV *env)
		2148	CODE:
		2149	errno = env->cdsgroup_begin (env, &RETVAL);
		2150	if (errno)
		2151	croak ("DB_ENV->cdsgroup_begin: %s", db_strerror (errno));
		2152	OUTPUT:
		2153	RETVAL
		2154
		2155	#endif
		2156
1415	MODULE = BDB PACKAGE = BDB::Db	2157	MODULE = BDB PACKAGE = BDB::Db
1416		2158
1417	void	2159	void
1418	DESTROY (DB_ornull *db)	2160	DESTROY (DB_ornuked *db)
1419	CODE:	2161	CODE:
1420	if (db)	2162	if (db)
1421	{	2163	{
1422	SV env = (SV )db->app_private;	2164	SV env = (SV )db->app_private;
1423	db->close (db, 0);	2165	db->close (db, 0);
…		…
1428	CODE:	2170	CODE:
1429	RETVAL = db->set_cachesize (db, gbytes, bytes, ncache);	2171	RETVAL = db->set_cachesize (db, gbytes, bytes, ncache);
1430	OUTPUT:	2172	OUTPUT:
1431	RETVAL	2173	RETVAL
1432		2174
1433	int set_flags (DB *db, U32 flags);	2175	int set_flags (DB *db, U32 flags)
1434	CODE:	2176	CODE:
1435	RETVAL = db->set_flags (db, flags);	2177	RETVAL = db->set_flags (db, flags);
1436	OUTPUT:	2178	OUTPUT:
1437	RETVAL	2179	RETVAL
1438		2180
…		…
1446	CODE:	2188	CODE:
1447	RETVAL = db->set_lorder (db, lorder);	2189	RETVAL = db->set_lorder (db, lorder);
1448	OUTPUT:	2190	OUTPUT:
1449	RETVAL	2191	RETVAL
1450		2192
1451
1452	int set_bt_minkey (DB *db, U32 minkey)	2193	int set_bt_minkey (DB *db, U32 minkey)
1453	CODE:	2194	CODE:
1454	RETVAL = db->set_bt_minkey (db, minkey);	2195	RETVAL = db->set_bt_minkey (db, minkey);
1455	OUTPUT:	2196	OUTPUT:
1456	RETVAL	2197	RETVAL
1457		2198
1458	int set_re_delim(DB *db, int delim);	2199	int set_re_delim (DB *db, int delim)
1459	CODE:	2200	CODE:
1460	RETVAL = db->set_re_delim (db, delim);	2201	RETVAL = db->set_re_delim (db, delim);
1461	OUTPUT:	2202	OUTPUT:
1462	RETVAL	2203	RETVAL
1463		2204
…		…
1504	if (errno)	2245	if (errno)
1505	croak ("DB->cursor: %s", db_strerror (errno));	2246	croak ("DB->cursor: %s", db_strerror (errno));
1506	OUTPUT:	2247	OUTPUT:
1507	RETVAL	2248	RETVAL
1508		2249
		2250	DB_SEQUENCE *
		2251	sequence (DB *db, U32 flags = 0)
		2252	CODE:
		2253	{
		2254	errno = db_sequence_create (&RETVAL, db, flags);
		2255	if (errno)
		2256	croak ("db_sequence_create: %s", db_strerror (errno));
		2257	}
		2258	OUTPUT:
		2259	RETVAL
		2260
1509		2261
1510	MODULE = BDB PACKAGE = BDB::Txn	2262	MODULE = BDB PACKAGE = BDB::Txn
1511		2263
1512	void	2264	void
1513	DESTROY (DB_TXN_ornull *txn)	2265	DESTROY (DB_TXN_ornuked *txn)
1514	CODE:	2266	CODE:
1515	if (txn)	2267	if (txn)
1516	txn->abort (txn);	2268	txn->abort (txn);
1517		2269
1518	int set_timeout (DB_TXN *txn, NV timeout, U32 flags)	2270	int set_timeout (DB_TXN *txn, NV timeout, U32 flags = DB_SET_TXN_TIMEOUT)
1519	CODE:	2271	CODE:
1520	RETVAL = txn->set_timeout (txn, timeout * 1000000, flags);	2272	RETVAL = txn->set_timeout (txn, timeout * 1000000, flags);
1521	OUTPUT:	2273	OUTPUT:
1522	RETVAL	2274	RETVAL
1523		2275
		2276	int failed (DB_TXN *txn)
		2277	CODE:
		2278	RETVAL = !!(txn->flags & TXN_DEADLOCK);
		2279	OUTPUT:
		2280	RETVAL
		2281
1524		2282
1525	MODULE = BDB PACKAGE = BDB::Cursor	2283	MODULE = BDB PACKAGE = BDB::Cursor
1526		2284
1527	void	2285	void
1528	DESTROY (DBC_ornull *dbc)	2286	DESTROY (DBC_ornuked *dbc)
1529	CODE:	2287	CODE:
1530	if (dbc)	2288	if (dbc)
1531	dbc->c_close (dbc);	2289	dbc->c_close (dbc);
1532		2290
		2291	#if DB_VERSION_MINOR >= 6
		2292
		2293	int set_priority (DBC *dbc, int priority)
		2294	CODE:
		2295	dbc->set_priority (dbc, priority);
		2296
		2297	#endif
		2298
		2299	MODULE = BDB PACKAGE = BDB::Sequence
		2300
		2301	void
		2302	DESTROY (DB_SEQUENCE_ornuked *seq)
		2303	CODE:
		2304	if (seq)
		2305	seq->close (seq, 0);
		2306
		2307	int initial_value (DB_SEQUENCE *seq, db_seq_t value)
		2308	CODE:
		2309	RETVAL = seq->initial_value (seq, value);
		2310	OUTPUT:
		2311	RETVAL
		2312
		2313	int set_cachesize (DB_SEQUENCE *seq, U32 size)
		2314	CODE:
		2315	RETVAL = seq->set_cachesize (seq, size);
		2316	OUTPUT:
		2317	RETVAL
		2318
		2319	int set_flags (DB_SEQUENCE *seq, U32 flags)
		2320	CODE:
		2321	RETVAL = seq->set_flags (seq, flags);
		2322	OUTPUT:
		2323	RETVAL
		2324
		2325	int set_range (DB_SEQUENCE *seq, db_seq_t min, db_seq_t max)
		2326	CODE:
		2327	RETVAL = seq->set_range (seq, min, max);
		2328	OUTPUT:
		2329	RETVAL
		2330
		2331

Diff Legend

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

Comparing BDB/BDB.xs (file contents): Revision 1.6 by root, Tue Feb 6 01:09:04 2007 UTC vs. Revision 1.46 by root, Wed Jul 9 21:16:14 2008 UTC

Diff Legend

Comparing BDB/BDB.xs (file contents):
Revision 1.6 by root, Tue Feb 6 01:09:04 2007 UTC vs.
Revision 1.46 by root, Wed Jul 9 21:16:14 2008 UTC