CHANGELOG-1.3.md

Note that we start to track changes starting from v1.3.7.

---

v1.3.13(TBD)

BoltDB

• Fix Bucket.Stats() panic on branch pages with zero elements

---

v1.3.12(2025-08-19)

BoltDB

• Add protection on meta page when it's being written
• Fix potential data corruption in (*Tx)WriteTo if underlying db file is overwritten

---

v1.3.11(2024-08-21)

BoltDB

• Fix the freelist.allocs isn't rollbacked when a tx is rollbacked.

CMD

• Add -gobench-output option for bench command to adapt to benchstat.

Other

• Bump go version to 1.22.x.
• This patch also added dmflakey package, which can be reused by other projects. See #812.

---

v1.3.10(2024-05-06)

BoltDB

• Remove deprecated UnsafeSlice and use unsafe.Slice
• Stabilize the behaviour of Prev when the cursor already points to the first element

Other

• Bump go version to 1.21.9

---

v1.3.9(2024-02-24)

BoltDB

• Clone the key before operating data in bucket against the key

CMD

• Fix bbolt keys and bbolt get to prevent them from panicking when no parameter provided

---

v1.3.8(2023-10-26)

BoltDB

• Fix db.close() doesn't unlock the db file if db.munnmap() fails.
• Avoid syscall.Syscall use on OpenBSD.
• Fix rollback panicking after mlock failed or both meta pages corrupted.
• Fix bbolt panicking due to 64bit unaligned on arm32.

CMD

• Update the usage of surgery command.

---

v1.3.7(2023-01-31)

BoltDB

• Add recursive checker to confirm database consistency.
• Add support to get the page size from the second meta page if the first one is invalid.
• Add support for loong64 arch.
• Add internal iterator to Bucket that goes over buckets.
• Add validation on page read and write.
• Add PreLoadFreelist option to support loading free pages in readonly mode.
• Add (*Tx) CheckWithOption to support generating human-readable diagnostic messages.
• Fix Use golang.org/x/sys/windows for FileLockEx/UnlockFileEx.
• Fix readonly file mapping on windows.
• Fix the "Last" method might return no data due to not skipping the empty pages.
• Fix panic on db.meta when rollback.

CMD

• Add support for get keys in sub buckets in bbolt get command.
• Add support for --format flag for bbolt keys command.
• Add safeguards to bbolt CLI commands.
• Add bbolt page supports --all and --value-format=redacted formats.
• Add bbolt surgery commands.
• Fix open db file readonly mode for commands which shouldn't update the db file, see also pull/292.

Other

• Build bbolt CLI tool, test and format the source code using golang 1.17.13.
• Bump golang.org/x/sys to v0.4.0.

Summary

Release v1.3.7 contains following critical fixes:

• fix to problem that Last method might return incorrect value (#341)
• fix of potential panic when performing transaction's rollback (#362)

Other changes focused on defense-in-depth (#358, #294, #225, #395)

bbolt command line tool was expanded to:

• allow fixing simple corruptions by bbolt surgery (#370)
• be flexible about output formatting (#306, #359)
• allow accessing data in subbuckets (#295)