# MDFS (ModularFS) - Introduction

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

## Documentation Index

### Core Documentation
- [Overview](Overview.md) - MDFS architecture, features, and design
- [ACL Permissions](ACL-Permissions.md) - NTFS-like access control lists
- [Performance Issues](Performance-Issues.md) - ~~Known bottlenecks~~ **✅ FIXED!**
- [How to Replicate](How-To-Replicate.md) - 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](../File-Systems.md) - Overview of all supported filesystems
- [Filesystem API](../Filesystem-API.md) - VFS layer and API documentation
- [Storage Drivers](../Storage-Drivers.md) - ATA, AHCI, and drive support

## Contributing
See [Contributing](../Contributing.md) for guidelines on contributing to MDFS development.

## See Also
- [System Architecture](../System-Architecture.md)
- [Kernel API](../Kernel-API.md)