Format:ESE database (EDB)
| Developer | Microsoft |
|---|---|
| Versions | file format version 0x620, revisions 0x00 to 0x122 |
| Magic | EF CD AB 89 at offset 4 (0x89ABCDEF little-endian) |
| Extensions | .edb, .dit, .stm |
| Endianness | little |
| Website | https://github.com/libyal/libesedb |
| On this wiki | Facts · Code · Notes · Topics |
The Extensible Storage Engine (ESE, JET Blue) database file used by Windows Search, Active Directory (ntds.dit), Exchange, Windows Mail and other Microsoft components: fixed-size pages, a file header at page 0 whose bytes 4-7 are EF CD AB 89, and B+-trees whose tables are listed in the MSysObjects catalog.
Overview
ESE (also called JET Blue, ESENT in Windows components) is Microsoft's embedded transactional database engine. Its data files (.edb; Active Directory uses ntds.dit; Exchange also had streaming .stm files) are used by Windows Search, Active Directory, Exchange, Windows Mail and other programs. The libyal project libesedb documents the format from public MSDN notes and analysis of test data, and says so: parts are marked TODO or unknown there.
File header
The header is in the first page of the file; the rest of that page is zero, and page 1 holds a copy. It is at least 668 bytes. Offset 0 is a 32-bit XOR checksum over the little-endian 32-bit values from offset 4 on, starting from the initial value 0x89ABCDEF. Offset 4 holds the signature EF CD AB 89. Other fields: 8 file format version (0x620), 12 file type (0 database, 1 streaming file), 16 database time, 24 database signature (28 bytes), 52 database state, 232 file format revision, 236 page size in bytes (Fact:ESE database (EDB)/struct/File header).
Database state: 1 just created, 2 dirty shutdown (needs recovery, with the transaction logs; do not copy-and-open), 3 clean shutdown, 4 being converted, 5 force detach (Fact:ESE database (EDB)/enum/Database state).
Version and revision
Version is 0x620 for almost every database (0x623 appears for a New Space Manager variant). The revision identifies the Windows or Exchange generation: 0x09 Windows XP SP3, 0x0B Exchange (page header with ECC checksum), 0x0C Windows Vista, 0x11 Windows 7 (adds 2 KiB, 16 KiB and 32 KiB pages, extended page header, column compression), 0x14 Exchange 2013 and Active Directory 2016, 0xC8 and 0xE6 Windows 11, 0x122 (the upper 4 bits of the first available page tag are reserved) (Fact:ESE database (EDB)/enum/Format revisions). Typical page sizes: 4 KiB for most; Active Directory and Exchange 2007 use 8 KiB.
Pages
Page numbers start at 1 at file offset page size, because the two header pages come first: offset = (page number + 1) x page size (Fact:ESE database (EDB)/behavior/Page offset). A page has a header (40 bytes, 80 bytes extended on large pages from revision 0x11), the values, and page tags stored back to front at the end of the page. Page header fields: 0 checksum, 8 database time of last modification, 16 previous page, 20 next page, 24 father data page (FDP) object id (which B+-tree owns the page), 28 available data size, 36 page flags. Flags: 0x1 root, 0x2 leaf, 0x4 parent/branch, 0x8 empty, 0x20 space tree, 0x40 index, 0x80 long value, 0x2000 new record format and checksum, 0x4000 scrubbed (Fact:ESE database (EDB)/enum/Page flags). Strings are either ASCII with a codepage or UTF-16LE without BOM.
Tables
Tables and indexes are B+-trees. The catalog table MSysObjects (backup copy MSysObjectsShadow) defines every table, column and index; a space tree manages free pages. Values larger than a page go to long value trees. To read a database, find MSysObjects first, then follow table root pages.
Reversing notes
- Identify by the bytes EF CD AB 89 at offset 4, not by the extension.
- Unverified: tools such as libesedb's esedbexport and Microsoft's eseutil (/mh dumps the header) can inspect a copy of a clean database; check state 3 first.
- Do not publish contents of real user databases (mail, directory hashes); the structure is what belongs here.
Code & repositories
- https://github.com/libyal/libesedb @
b0899ab6082ba6c60fb6b4113b5de120c35abc84· license: LGPL-3.0-or-later (declared by the contributor for the files used; GitHub reports LGPL-3.0 for the repository)
libesedb: library and tools for ESE databases; documentation/ holds the EDB format specification (asciidoc).
Tested on: source read, not run: documentation read, not run · checked 2026-10-18; last activity 2026-10-11
See also
Format:SQLite database file, Format:LMDB database file, Format:Berkeley DB database file