From Xenon Wiki
Jump to navigation Jump to search

XDBF (Xbox Data Base File) files are used by the Xbox 360 as a generic database. It is used as the format for GPD (Gamer Profile Data) and SPA (Statistics, Presence and Achievements) files. SPA files are linked into an Xbox 360 executable during compilation and are used by the dashboard to generate the GPD, Save Game (STFS) Meta-Data and Images. In the XAM the DataFile class handles all of the operations associated with these files.


Total length: 24 bytes (0x18)

Byte ordering: Dependant on magic. If the magic is little endian then the whole file is and is a GFWL, if it's big endian then it's an Xbox file.

Offset Length Type Information
0x0 0x4 ascii string Magic (0x58444246)
0x4 0x4 unsigned int Version (0x10000)
0x8 0x4 unsigned int Entry Table Length (in number of entries)
0xC 0x4 unsigned int Entry Count
0x10 0x4 unsigned int Free Space Table Length (in number of entries)
0x14 0x4 unsigned int Free Space Table Entry Count

Entry Table Length and Free Space Table Length will be a multiple of 512, this is just Xbox's preferred values, but it will read the file if you decrease them to make the size of the file smaller, alot smaller.

Entry Table

The Entry Table is made up of entries, each one under a different namespace and ID. The table length will be Entry Table Length * 18, but only the first Entry Count are used.

Entry Structure

Total length: 18 bytes (0x12)

Offset Length Type Information
0x0 0x2 unsigned short Namespace (see GPD or SPA)
0x2 0x8 unsigned long ID
0xA 0x4 unsigned int OffsetSpecifier
0xE 0x4 unsigned int Length

Free Space Table

The Free Space Table is used to map out the unused space within the file. It is updated whenever n entry changes size. Each entry within the Free Space Table is composed of the OffsetSpecifier and how much space is unused their (Length). The final entry in the Free Space Table isn't actually free space, but rather is information about the length of data after the tables. The OffsetSpecifier would be the length (file length - header and tables) and the Length would be -1 -OffsetSpecifier.

Free Space Entry Structure

Total length: 8 bytes

Offset Length Type Information
0x0 0x4 unsigned int OffsetSpecifier
0x4 0x4 unsigned int Length

Entry Data Offset

To work out the real entry data offset, times the Entry Table Length by 0x12, then times the Free Space Table Length by 0x8 and add the result together, and add 0x18 (file header). This is where the beginning of the entry data begins, then add the OffsetSpecifier by the entry to get the real offset.

(((Entry Table Length * 18) + (Free Space Table Length * 8)) + 24) + OffsetSpecifier

Just to explain a bit more,

Entry Table Length * 18, 18 being the length of each entry, this will workout the actual length of the entry table.

Free Space Table Length * 8, 8 being the length of each free space entry, workout the actual length of the free space table.

+ 24, 24 is the length of the header.