From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Format:STFS (Xbox 360 package)" |
|---|
| claim | "Xenia reads the STFS file table by following the hash-table next-block chain from file_table_block_number, parses 64 entries per block until an entry whose name starts with a zero byte, and follows the same chain for every file; it warns, but does not fail, when counts differ." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:STFS (Xbox 360 package)" |
|---|
| observed_in | |
|---|
|
|---|
| data | | function | "StfsContainerDevice::ReadSTFS" |
|---|
| effect | "For up to file_table_block_count blocks: read 0x1000 bytes at BlockToOffsetSTFS(block); stop the block at the first entry with name[0]==0; name length is flags.name_length & 0x3F (not NUL-terminated); parent is the root when directory_index==0xFFFF, otherwise the entry at that index in the list of all entries parsed so far (no bounds check); directory flag -> directory, else file with data_offset of start_block_number. File data: walk blocks from start_block_number while remaining bytes and block != 0xFFFFFF, taking each next block from the level 0 hash entry of the current block (min(0x1000, remaining) per block); the 'contiguous' flag is not used (TODO in source). Table chain: next table block from the hash entry of the current table block; loop ends on 0xFFFFFF." |
|---|
| condition | "volume_type STFS. Checks that only warn (log plus assert_always): bytes found != entry length; chain length != allocated_data_blocks; table blocks read != file_table_block_count. valid_data_blocks is read but not used here. The timestamps are FAT date/time decoded by decode_fat_timestamp (year base 1980, seconds field times 2) with the access time set to the modified time." |
|---|
| notes | "Entry names are 40 bytes; the device reports component_name_max_length 40." |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "ReadSTFS whole function" |
|---|
| repo | "https://github.com/xenia-project/xenia" |
|---|
| commit | "95a5c3ee250f80c3b9d139658649d9ffb6db3eec" |
|---|
| path | "src/xenia/vfs/devices/stfs_container_device.cc" |
|---|
| lines | "521-639" |
|---|
|
| type | "source" |
|---|
| detail | "decode_fat_timestamp bit masks" |
|---|
| repo | "https://github.com/xenia-project/xenia" |
|---|
| commit | "95a5c3ee250f80c3b9d139658649d9ffb6db3eec" |
|---|
| path | "src/xenia/vfs/devices/stfs_xbox.h" |
|---|
| lines | "22-45" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Reading the file table and file chains" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T13:26:30.354Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T16:36:09.454Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read ReadSTFS whole (lines 521-639) at xenia 95a5c3ee plus component_name_max_length (40) in the header and grep of valid_data_blocks/contiguous (valid_data_blocks never used in the .cc; contiguous only in the TODO at line 586). Warn-only checks, 0x3F name mask, 0xFFFF root parent without bounds check all match. Source read only." |
|---|
|
|
|---|