Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:XDVDFS (Xbox disc filesystem)

From ReverseEngineering.wiki
Format
Platforms Platform:Xbox, Platform:Xbox 360
Magic MICROSOFT*XBOX*MEDIA
Extensions .iso, .xiso
Endianness little
On this wiki Facts · Code · Notes · Topics

Filesystem of Xbox and Xbox 360 game discs: 2048-byte sectors, a volume descriptor at sector 32 of the game partition starting with MICROSOFT*XBOX*MEDIA, and a directory made of binary-search-tree nodes.

Overview

XDVDFS (also called GDFX on the 360) is a read-only filesystem with 2048-byte sectors. A dumped disc is wider than the game partition: video partition and padding come first, so the filesystem starts at an offset that depends on the disc generation.

Locating the volume descriptor

The descriptor is at sector 32 of the game partition (byte 0x10000 from its start) and begins with the 20-byte string MICROSOFT*XBOX*MEDIA (it is repeated at the end of the descriptor). Try these partition offsets: 0 (plain/trimmed XISO), 0xFB20 (alternate, seen in xenia), 0x20600, 0x02080000 (XGD3), 0x0FD90000 (XGD2) and 0x18300000 (XGD1). See Fact:XDVDFS (Xbox disc filesystem)/identification/Game partition offsets.

Volume descriptor

After the 20-byte magic: u32 root directory sector (offset 0x14), u32 root directory size in bytes (0x18), a 64-bit FILETIME, padding up to the 0x7C8 unused bytes, and the magic again. See Fact:XDVDFS (Xbox disc filesystem)/struct/Directory entry for the node format.

Directory

A directory is a sequence of 4-byte aligned entries forming a binary search tree sorted by name (case-insensitive): left offset u16 and right offset u16 (in 4-byte units; 0 means none, 0xFFFF padding), start sector u32, size u32, attribute byte (0x10 directory, 0x01 read-only, 0x02 hidden, 0x04 system, 0x20 archive, 0x80 normal), name length byte, then the name. Padding bytes are 0xFF. Files are contiguous: start sector and size are all you need.

xenia's reader is a compact reference: root sector at +20 and size at +24 of the descriptor, size under 13 or over 32 MiB rejected, entries visited left, self, right, and an entry is a directory when attribute 0x10 is set and its size is non-zero (Fact:XDVDFS (Xbox disc filesystem)/behavior/xenia GDFX reader). Its partition offset list has no 0x18300000 (XGD1) entry, unlike extract-xiso.

Tools

extract-xiso (BSD-style license) lists, extracts, creates and rewrites images; it writes the tag in!xiso!<version> at byte 31337 of images it optimised. xemu and xenia read the format. 360 Games on Demand (SVOD) packages carry the same filesystem inside the data files of Format:STFS (Xbox 360 package) volume type 1.

Related

Platform:Xbox, Platform:Xbox 360, Format:XBE (Xbox executable), Format:XEX2 (Xbox 360 executable).

Code & repositories

  • https://github.com/XboxDev/extract-xiso @ 3f5b62cfe68f000b0e3c8a30104973f3a297948e · license: BSD-3-Clause (read from LICENSE.TXT; GitHub's detector did not classify it)
    xdvdfs image lister, extractor and creator; extract-xiso.c defines the volume descriptor magic, partition offsets and directory entry layout
    Tested on: source read, not run: source reading only · checked 2026-10-18; last activity 2026-09-11; Note: the latest release ships binaries; the wiki links only the source, never the binaries