Skip to content

* correct TUX2/TUX3 native disk-format claims - #192

Open
Hawkynt wants to merge 1 commit into
mainfrom
fix/tux-native-format-claims
Open

* correct TUX2/TUX3 native disk-format claims#192
Hawkynt wants to merge 1 commit into
mainfrom
fix/tux-native-format-claims

Conversation

@Hawkynt

@Hawkynt Hawkynt commented Sep 6, 2026

Copy link
Copy Markdown
Owner

What changed

The TUX2/TUX3 descriptors were advertising native R/W on formats that only round-tripped private Workbench layouts (TUX2FS and TUX3WORM). This removes those interoperability claims instead of preserving synthetic writers behind native filesystem names.

  • TUX2 no longer invents a standalone TUX2FS magic or writer. The historical TUX2 design was an Ext2 variation intended to mount existing Ext2 partitions and never established a stable independent self-identifying disk format. Manual selection now surfaces the raw image plus metadata, with Ext2 magic reported only as a compatibility clue.
  • TUX3 now recognizes the canonical linux-tux3 packed struct disksuper at byte 4096, decodes all integer fields big-endian, and recognizes the current 2014-05-06 disk revision plus the known 2012-12-20 revision.
  • The private TUX3SUPR/TUX3WORM dialect, its writer/modifier/block mover, and the equivalent TUX2 synthetic mutation stack are removed.
  • Tests now use authoritative field offsets/endian values and explicitly reject the former private TUX3 magic instead of proving only self-roundtrip compatibility.

Design / licensing

A valid TUX3 filesystem is more than a stamped superblock: upstream mkfs also creates allocation metadata, internal inodes, the atom table, root directory, and commit state. Emitting only a correct-looking header would be another synthetic format, so CanCreate/CanModify remain withheld until those native structures are implemented and externally accepted.

The canonical TUX3 implementation is GPL. No expressive upstream implementation code is copied or translated. This change is a clean-room implementation from factual/specification-defined field offsets, endian rules, revision magic bytes, and published behavior.

No new dependencies.

References

  • Daniel Phillips, 2000 TUX2 announcement: TUX2 described as an Ext2 variation with the goal of mounting Ext2 partitions as TUX2.
  • OGAWAHirofumi/linux-tux3, fs/tux3/tux3.h: current disk-format magic, SB_LOC, packed struct disksuper, big-endian field types.
  • linux-tux3/userspace mkfs path used as a behavioral/specification oracle for what constitutes a real filesystem.

Validation

CI pending on this PR.

- remove the private TUX2FS/TUX3WORM writers, mutators and record movers
- treat TUX2 as non-self-identifying/opaque instead of inventing a standalone magic
- parse the canonical linux-tux3 packed big-endian disksuper at byte 4096
- recognize current 2014-05-06 and known 2012-12-20 TUX3 disk revisions
- replace self-roundtrip writer tests with native-layout and capability-honesty tests

TUX3 upstream source is GPL; implementation is clean-room from factual on-disk field definitions and constants, with no expressive source translation.
@Hawkynt
Hawkynt marked this pull request as ready for review September 6, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant