TitanXFS is an independent, clean-room ISO C++23 Silicon Graphics XFS storage engine, WinFsp user-mode filesystem driver, and background management daemon for Windows NT, MicaNT, and POSIX platforms.
Designed strictly under 17 U.S.C. § 1201(f) and Google v. Oracle interoperability standards, TitanXFS delivers native XFS v5 volume formatting, userland File Explorer mounting via WinFsp, B+ tree extent resolution, Allocation Group (AG) telemetry, and background consistency scrubbing without third-party kernel drivers or blue screen (BSOD) risks.
- Red Hat Enterprise Linux (RHEL) & CentOS Compatibility: Seamlessly mount, browse, read, and verify disks formatted with RHEL, Rocky Linux, AlmaLinux, CentOS, Fedora, or SGI IRIX directly in Windows.
- WinFsp User-Mode Driver Bridge (
titanxfs_mount): Mount any XFS disk image, raw partition, or physical drive to a native Windows drive letter (e.g.X:\) with full integration into Windows File Explorer, PowerShell, Command Prompt, and WSL. ReportsFileSystemName = L"XFS". - 1-Click Turnkey Installer (
titanxfs_setup.exe): Self-contained installer embedding all binaries, high-resolution hero artwork, and signed WinFsp runtime MSI using LZ4 PE overlay compression. - Windows NT Background Daemon (
titanxfs_svc.exe): Autonomous background service supporting boot-time auto-mounts, Named Pipe IPC (\\.\pipe\titanxfs_ipc), and scheduled 24-hour integrity scrubbing. - CLI Utilities:
titanxfs_format.exe: Format disk images or physical drives to standard XFS v5.titanxfs_check.exe: Filesystem scrubber, superblock validator, and bit-rot diagnostic tool.
- Unified Titan Storage Hub Integration: Full management and telemetry support in Titan Storage Hub.
To mount XFS volumes as Windows drive letters, WinFsp (Windows File System Proxy) is required.
- Install WinFsp:
- Download and install the latest release from the WinFsp Official GitHub, or run the bundled installer in
redist/winfsp-2.1.25156.msi. - Alternatively, install via WinGet:
winget install WinFsp.WinFsp
- Download and install the latest release from the WinFsp Official GitHub, or run the bundled installer in
- Administrator Privileges:
- Required only when accessing physical drives (e.g.,
\\.\PhysicalDrive2). - Mounting regular disk images (
.img,.raw) does not require Administrator rights.
- Required only when accessing physical drives (e.g.,
# Format a new 512 MB XFS v5 disk image:
titanxfs_format.exe rhel_storage.img --size 512 --label "RhelData"
# Or format a physical partition/drive (Run as Administrator):
titanxfs_format.exe \\.\PhysicalDrive3 --label "Enterprise"# Mount disk image to drive X:
titanxfs_mount.exe rhel_storage.img X:
# Mount with custom volume label in read-only mode:
titanxfs_mount.exe rhel_storage.img X: --label "RhelBackup" --readonly
# Mount a physical disk partition (Run as Administrator):
titanxfs_mount.exe \\.\PhysicalDrive3 M: --label "EnterpriseXFS"Once mounted, X:\ appears immediately in Windows Explorer, PowerShell, and Command Prompt. Press Ctrl+C in the console anytime to cleanly unmount.
Usage: titanxfs_mount <device_or_image_path> <drive_letter:> [options]
Options:
--label <name> Set volume label in Windows Explorer (default: disk label)
--readonly Mount volume in read-only modeUsage: titanxfs_format <target_device_or_file> [options]
Options:
--size <MB> Specify size in MB when creating a new disk image
--label <name> Set volume label (max 12 characters)
--agcount <count> Number of Allocation Groups (default: 4)titanxfs_check.exe rhel_storage.img# Install as Windows NT service (Run as Administrator):
titanxfs_svc.exe --install
# Start service:
net start TitanXFS
# Run interactively:
titanxfs_svc.exe --run
# Uninstall:
titanxfs_svc.exe --uninstall| Component | Offset / Magic | Purpose |
|---|---|---|
Superblock (xfs_sb_t) |
Offset 0x00 (0x58465342 "XFSB") |
64-bit volume geometry, root inode pointer, block size, UUID, and feature flags |
Allocation Group Free (XFS_AGF) |
Sector 1 (0x58414746 "XAGF") |
AG free block counts, longest extents, and free space btree roots (ABTB, ABTC) |
Allocation Group Inode (XFS_AGI) |
Sector 2 (0x58414749 "XAGI") |
AG allocated inode counters and inode btree roots (IBT, FIBT) |
Allocation Group Free List (XFS_AGFL) |
Sector 3 (0x5841474C "XAGL") |
Dynamic free block cache for btree block splits and merges |
Dynamic Inode (xfs_dinode_t) |
0x494E ("IN") |
512-byte v3 dinode with B+ tree data fork, extent records, and metadata |
# Configure CMake with Clang & Ninja
cmake -B build -G "Ninja" -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_BUILD_TYPE=Release
# Build all targets (-j2)
cmake --build build -j2
# Run tests
ctest --test-dir build --output-on-failure
.\build\titanxfs_tests.exe- WinFsp is not installed. Download and install WinFsp from https://winfsp.dev or run
winget install WinFsp.WinFsp.
- Windows requires Administrator rights to access raw block devices. Re-launch PowerShell or Command Prompt with Run as administrator.
- The drive letter
X:is already assigned or in use. Choose another letter (e.g.M:,S:,L:).
Licensed under the Apache License, Version 2.0. All reverse-engineering and format structures adhere strictly to statutory interoperability protections under 17 U.S.C. § 1201(f) and Google LLC v. Oracle America, Inc..
