MDFS Introduction

MDFS (ModularFS) - Introduction

This directory contains comprehensive documentation for MDFS, the native filesystem of ModuOS.

Documentation Index

Core Documentation

• Overview - MDFS architecture, features, and design
• ACL Permissions - NTFS-like access control lists
• Performance Issues - Known bottlenecks ✅ FIXED!
• How to Replicate - Implement MDFS in other systems

Quick Links

MDFS Features

• Block-based filesystem with 4KB blocks
• Inode-based architecture (256-byte inodes)
• Directory structure with exFAT-style entry sets
• NTFS-like ACL permissions (new!)
• Indirect block pointers (single, double, triple)
• CRC32 checksums for metadata integrity

MDFS Versions

• Version 1: Basic block-based filesystem
• Version 2: Current version with ACL support

Key Specifications

• Block Size: 4096 bytes
• Inode Size: 256 bytes
• Max Direct Pointers: 12
• Max ACEs per file: 16
• Max Filename Length: 255 bytes (UTF-8)

Related Documentation

• File Systems - Overview of all supported filesystems
• Filesystem API - VFS layer and API documentation
• Storage Drivers - ATA, AHCI, and drive support

Contributing

See Contributing for guidelines on contributing to MDFS development.

See Also

• System Architecture
• Kernel API