1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Berkeley DB Library Version 11.2.5.3 Change Log</title>
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
<link rel="up" href="upgrade_53_toc.html" title="Chapter 11. Upgrading Berkeley DB 11.2.5.2 applications to Berkeley DB 11.2.5.3" />
<link rel="prev" href="upgrade_11gr2_53_xa_mvcc.html" title="Berkeley DB X/Open Compliant XA Resource Manager and Transaction Snapshots" />
<link rel="next" href="upgrade_52_toc.html" title="Chapter 12. Upgrading Berkeley DB 11.2.5.1 applications to Berkeley DB 11.2.5.2" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
<p>Library Version 12.1.6.1</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Berkeley DB Library Version 11.2.5.3 Change Log</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="upgrade_11gr2_53_xa_mvcc.html">Prev</a> </td>
<th width="60%" align="center">Chapter 11. Upgrading Berkeley DB 11.2.5.2 applications to Berkeley DB 11.2.5.3 </th>
<td width="20%" align="right"> <a accesskey="n" href="upgrade_52_toc.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="changelog_5_3"></a>Berkeley DB Library Version 11.2.5.3 Change Log</h2>
</div>
</div>
</div>
<div class="toc">
<dl>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1207192">Database or Log File On-Disk Format Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1200256">New Features</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1206088">Database Environment Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1211048">Access Method Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1208744">SQL API Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1199152">Java-specific API changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1208832">Replication Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1199992">Locking Subsystem Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1217800">Logging Subsystem Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1209392">Memory Pool Subsystem Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1226336">Mutex Subsystem Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1218216">Transaction Subsystem Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1231856">Utility Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1226152">Configuration, Documentation, Sample Apps, Portability and Build Changes</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="changelog_5_3.html#idp1235024">Known Bugs</a>
</span>
</dt>
</dl>
</div>
<p>
This is the changelog for Berkeley DB
11<span class="emphasis"><em>g</em></span> Release 2 (library
version 11.2.5.3).
</p>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1207192"></a>Database or Log File On-Disk Format Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Existing database file formats were unchanged in library version 11.2.5.3.
</p>
</li>
<li>
<p>
The log file format changed in library version 11.2.5.3.
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1200256"></a>New Features</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Added support for verifying named in-memory dbs. [#16941]
</p>
</li>
<li>
<p>
Added an integer key comparison function to improve performance through the SQL API. [#19609]
</p>
</li>
<li>
<p>
Support build on the platforms where pthread_t is a struct. [#19876]
</p>
</li>
<li>
<p>
Added an API call so the user can specify the size of the region in a heap db. [#19914]
</p>
</li>
<li>
<p>
Improved Replication Manager's ability to recover from the (perhaps rare) phenomenon of two sites trying to connect to each other simultaneously, which used to result in loss of both connections, requiring a retry after the CONNECTION_RETRY timeout period. [#19980]
</p>
</li>
<li>
<p>
Enhanced the interface for copying databases for a hot backup. Added configure support for --enable-atomicfileread. [#20129]
</p>
</li>
<li>
<p>
Enhaced the log reading routine to detect that a log file is missing rather than returning that a zero length record was found. [#20130]
</p>
</li>
<li>
<p>
Added pragma bdbsql_shared_resources to set or report the maximum amount of memory to be used by shared structures in the main environment region and bdbsql_lock_tablesize to set or report the number of buckets in the lock object hash table. These are advanced tuning features for applications with large number of tables or needs to reduce locking on concurrent long running transactions. [#20156]
</p>
</li>
<li>
<p>
Added set_metadata_dir() and get_metadata_dir() to enable storage of persistent metadata files in a location other than the environment home directory. [#20174]
</p>
</li>
<li>
<p>
Improved the error handling through the SQL API. Errors can be sent to a file with the use of the BDBSQL_ERROR_FILE pragma. [#20213]
</p>
</li>
<li>
<p>
Database handles can now be configured to give exclusive access to the database. [#20331]
</p>
</li>
<li>
<p>
XA transactions will now use transaction snapshots if the XA databases they operate on were configured with DB_MULTIVERSION. [#20332]
</p>
</li>
<li>
<p>
Added additional stats fields into the C# API [#20693]
</p>
</li>
<li>
<p>
Added pragma bdbsql_single_process to keep the Berkeley DB environment information on the heap instead of in shared memory. This option cannot be used if the database is accessed from multiple processes. [#20789]
</p>
</li>
<li>
<p>
Improved the ability of DB->compact to move DB_HASH database pages to the begining of the file. [#20815]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1206088"></a>Database Environment Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug that could cause a segmentation violation when closing an environment handle which has open database handles on partition databases. [#20281]
</p>
</li>
<li>
<p>
Fixed a bug that could cause a segmentation violation if a region was extended leaving a very small fragment at the end. [#20414]
</p>
</li>
<li>
<p>
Changed the behavior of the DB_REGISTER | DB_RECOVER flag combination, so that recovery is always run if the environment panic bit is set. [#20767]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1211048"></a>Access Method Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug were database configuration settings could be lost when the database was opened if the open operation was blocked for any amount of time. [#20860]
</p>
</li>
<li>
<p>
Fixed a bug that bulk update operations did not work correctly on compressed databases. [#19017]
</p>
</li>
<li>
<p>
Improved the log flushing performance when ftruncate() is not available on a system. [#19725]
</p>
</li>
<li>
<p>
When performing partial puts in a heap database, empty pieces will no longer be left in a split record chain. [#20052]
</p>
</li>
<li>
<p>
Fixed a bug where, on systems without FTRUNCATE, db_verify will return an error for truncated heap databases. [#20195]
</p>
</li>
<li>
<p>
Fixed a bug where BDB could run out of mutexes when many databases are renamed. [#20228]
</p>
</li>
<li>
<p>
Fixed a bug where the metadata page in hash databases would not be flushed to disk. [#20265]
</p>
</li>
<li>
<p>
Fixed a bug that could leave deleted pages from a HEAP database in the buffer cache. [#20309]
</p>
</li>
<li>
<p>
Fixed a bug where the library would fail to put records with overflow keys into hash duplicate database. [#20329]
</p>
</li>
<li>
<p>
Fixed a bug in DB->compact of btrees that could cause a bad pointer reference. [#20360]
</p>
</li>
<li>
<p>
Fixed a bug that could cause the last page number stored on the metadata page to be wrong after rolling forward a db->compact operation that freed more pages than will fit in a single log record. [#20646]
</p>
</li>
<li>
<p>
Fixed a bug that could cause DB->stat to block on a mutex while holding a lock on the metadata page. [#20770]
</p>
</li>
<li>
<p>
Fixed a bug that could cause DB->compact of a DB_HASH database to fail to mark a page it updated as dirty. [#20778]
</p>
</li>
<li>
<p>
Fixed a bug where internal HEAP structures were not rebuilt during database handle refresh. [#20821]
</p>
</li>
<li>
<p>
Fixed a bug with secondary indices, off-page duplicates and DB_READ_COMMITTED which could erroneously release the lock on the page holding a returned record. [#20853]
</p>
</li>
<li>
<p>
Fixed a bug that could cause a hang or improperly report an empty queue when the queue record numbers wrapped around at 2^32. [#20956]
</p>
</li>
<li>
<p>
Fixed a bug on Linux or Windows that could generate a checksum error if a database file was being opened while the meta data page happened to be flushed from the cache. [#20996]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1208744"></a>SQL API Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed several memory leaks in the Online Backup API. [#19850]
</p>
</li>
<li>
<p>
Fixed a bug in the SQL API when using large blob items and multiple concurrent connections. [#19945]
</p>
</li>
<li>
<p>
To avoid a race condition that could cause a snapshot reader to see a wrong version it is now not permitted to open a DB handle specifying DB_MULTIVERSION if that database is currently opened by a handle which did not specify DB_MULTIVERSION. [#19940]
</p>
</li>
<li>
<p>
Pragma replication=on can now enable replication on an existing database. Turning replication off is now permanent. [#20180]
</p>
</li>
<li>
<p>
Fixed a bug in the SQL API where it was possible for a schema update to be ignored when accessing a database from multiple processes. [#20319]
</p>
</li>
<li>
<p>
Fixed a bug where aborting an exclusive transaction followed by an auto-commit read operation causes an assert failure. [#20567]
</p>
</li>
<li>
<p>
Fixed a bug in the SQL API where using the journal_mode pragma could cause a crash when used as the first operation in a connection on an existing database. [#20620]
</p>
</li>
<li>
<p>
Turn off the DBSQL encryption option on Windows/WinCE by default to match the behavior on the other platforms. [#20671]
</p>
</li>
<li>
<p>
Renamed the BDBSQL_OMIT_SHARING preprocessor flag to BDBSQL_SINGLE_PROCESS. [#20789]
</p>
</li>
<li>
<p>
Fixed a bug dealing with handle lock modes not reflecting the correct state which was causing a deadlock in the SQL API. [#20862]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1199152"></a>Java-specific API changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Added ReplicationManagerConnectionStatus class and ReplicationManagerSiteInfo.getConnectionStatus(). Deprecated ReplicationManagerSiteInfo.isConnected(). [#18068]
</p>
</li>
<li>
<p>
Updated EID_MASTER to be "public static final" so that it would be exposed in Java docs. [#20184]
</p>
</li>
<li>
<p>
Fixed a bug where calls that return Stat objects could cause a segfault. [#20377]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1208832"></a>Replication Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed quorum computation when most sites are unelectable. [#15251]
</p>
</li>
<li>
<p>
Made Replication more resilient to random input on its port. [#15712]
</p>
</li>
<li>
<p>
Fixed a bug where the datadir structure was not maintained during an internal init. [#19041]
</p>
</li>
<li>
<p>
Fixed a repmgr memory leak when using DB_PRIVATE. [#19363]
</p>
</li>
<li>
<p>
Fixed a minor bug to handle ENOMEM when using an in-memory temp database. [#20197]
</p>
</li>
<li>
<p>
Fixed a bug where multiple long running transactions across checkpoints could cause Log Sequence errors on client systems. [#20421]
</p>
</li>
<li>
<p>
Fixed a bug where multiple Replication Manager processes would sometimes not all conform to replication-group-aware log archiving. [#20342]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1199992"></a>Locking Subsystem Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug that could cause an early lock timeout if a previous error left a lock timeout value set. [#19973]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1217800"></a>Logging Subsystem Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug which could cause an incompletely written log record to be recognized as valid, resulting in recovery failing with the message "Illegal record type <integer, usually 0> in log". [#17851]
</p>
</li>
<li>
<p>
Fixed a bug where printlog would fail on in-memory heap databases. [#20269]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1209392"></a>Memory Pool Subsystem Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug which overstated the number of clean and dirty pages evicted from the cache. [#20410]
</p>
</li>
<li>
<p>
Fixed a bug that left a small fragment at the end of a region when extending. [#20414]
</p>
</li>
<li>
<p>
Fixed a bug where the file bucket was always zero when creating a mpoolfile using the mpool API. [#20468]
</p>
</li>
<li>
<p>
Fixed a bug with multiversion concurrency control which could cause versions of pages to remain in the cache even though they are no longer needed. [#20570]
</p>
</li>
<li>
<p>
The memory pool allocator will now start freezing MVCC versions of buffers if it sees more than 1/4 of the available buffers are taken up by versions. [#20836]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1226336"></a>Mutex Subsystem Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug in which DB_ENV->mutex_set_align() could cause DB_ENV->mutex_stat_print(dbenv, DB_STAT_ALL) to display only the first mutex. [#20522]
</p>
</li>
<li>
<p>
Fixed a bug with DB_ENV->mutex_stat_print() in which the information on some mutexes would not be displayed, if any mutex had been freed and not yet reallocated. [#20533]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1218216"></a>Transaction Subsystem Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug where a malloc failure could result in a segfault when doing a put on a database with secondaries. [#20641]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1231856"></a>Utility Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
Fixed a bug that would cause verify to call the wrong compare function if there are user defined compare functions used and the database has multilevel off page sorted duplicate trees. [#20284]
</p>
</li>
<li>
<p>
Fixed a bug that could cause recovery to fail if DB->compact moved the meta data page of a HASH subdatabase. [#20708]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1226152"></a>Configuration, Documentation, Sample Apps, Portability and Build Changes</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
The DB_CONFIG configuration commands which specify directory pathnames ("set_data_dir", "set_lg_dir", and "set_tmp_dir") now accept names containing whitespace characters. [#20158]
</p>
</li>
</ol>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idp1235024"></a>Known Bugs</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
<li>
<p>
If two SQL processes are concurrently altering the schema of the same tables in a database, there is a race condition that can cause the application to hang. [#20513]
</p>
</li>
<li>
<p>
Replication groups including machines of different endianness do not support the heap access method. [#21016]
</p>
</li>
<li>
<p>
If a txn that is attempting to remove a region page from a heap database is aborted and another txn is trying to update that same page then it can cause the original txn to abort. This is timing dependant. [#20939]
</p>
</li>
</ol>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="upgrade_11gr2_53_xa_mvcc.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="upgrade_53_toc.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="upgrade_52_toc.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Berkeley DB X/Open Compliant XA Resource Manager and Transaction Snapshots </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Chapter 12. Upgrading Berkeley DB 11.2.5.1 applications to Berkeley DB 11.2.5.2 </td>
</tr>
</table>
</div>
</body>
</html>
|
