Filesystems in the Linux kernel

This under-development manual will, some glorious day, provide comprehensive information on how the Linux virtual filesystem (VFS) layer works, along with the filesystems that sit below it. For now, what we have can be found below.

Core VFS documentation

See these manuals for documentation about the VFS layer itself and how its algorithms work.

• Overview of the Linux Virtual File System
  • Introduction
  • Registering and Mounting a Filesystem
  • The Superblock Object
  • The Inode Object
  • The Address Space Object
  • The File Object
  • Directory Entry Cache (dcache)
  • Mount Options
  • Resources
• Pathname lookup
  • Introduction to pathname lookup
  • RCU-walk - faster pathname lookup in Linux
  • A walk among the symlinks
• Linux Filesystems API summary
  • The Linux VFS
  • The proc filesystem
  • Events based on file descriptors
  • The Filesystem for Exporting Kernel Objects
  • The debugfs filesystem
• splice and pipes
  • splice API
  • pipes API
• Locking
  • dentry_operations
  • inode_operations
  • xattr_handler operations
  • super_operations
  • file_system_type
  • address_space_operations
  • file_lock_operations
  • lock_manager_operations
  • buffer_head
  • block_device_operations
  • file_operations
  • dquot_operations
  • vm_operations_struct
• Directory Locking
• Changes since 2.5.0:

Filesystem support layers

Documentation for the support code within the filesystem layer for use in filesystem implementations.

• The Linux Journalling API
  • Overview
  • Data Types
  • Functions
  • See also
• Filesystem-level encryption (fscrypt)
  • Introduction
  • Threat model
  • Key hierarchy
  • Encryption modes and usage
  • User API
  • Access semantics
  • Encryption policy enforcement
  • Implementation details
  • Tests
• fs-verity: read-only file-based authenticity protection
  • Introduction
  • Use cases
  • User API
  • Accessing verity files
  • File measurement computation
  • Built-in signature verification
  • Filesystem support
  • Implementation details
  • Userspace utility
  • Tests
  • FAQ

Filesystems

Documentation for filesystem implementations.

• v9fs: Plan 9 Resource Sharing for Linux
  • About
  • Usage
  • Options
  • Behavior
  • Resources
• Acorn Disc Filing System - ADFS
  • Filesystems supported by ADFS
  • Mount options for ADFS
  • Mapping of ADFS permissions to Linux permissions
  • RISC OS file type suffix
• Overview of Amiga Filesystems
  • Mount options for the AFFS
  • Handling of the Users/Groups and protection flags
  • Symbolic links
  • Examples
  • IMPORTANT NOTE
  • Bugs, Restrictions, Caveats
• kAFS: AFS FILESYSTEM
  • Overview
  • Compilation
  • Usage
  • Mountpoints
  • Dynamic Root
  • Proc Filesystem
  • The Cell Database
  • Security
  • The @sys Substitution
• autofs - how it works
  • Purpose
  • Context
  • Content
  • Mount Traps
  • Mountpoint expiry
  • Communicating with autofs: detecting the daemon
  • Communicating with autofs: the event pipe
  • Communicating with autofs: root directory ioctls
  • Communicating with autofs: char-device ioctls
  • Catatonic mode
  • The “ignore” mount option
  • autofs, name spaces, and shared mounts
• Miscellaneous Device control operations for the autofs kernel module
  • The problem
  • The Solution
  • autofs Miscellaneous Device mount control interface
  • The ioctls
• BeOS filesystem for Linux
  • Warning
  • License
  • Author
  • What is this Driver?
  • Which is it, BFS or BEFS?
  • How to Install
  • Using BFS
  • Mount Options
  • How to Get Lastest Version
  • Any Known Bugs?
  • Special Thanks
• BFS Filesystem for Linux
• BTRFS
• Ceph Distributed File System
  • Mount Syntax
  • Mount Options
  • More Information
• Cramfs - cram a filesystem onto a small ROM
  • Usage Notes
  • Memory Mapped cramfs image
  • Tools
  • For /usr/share/magic
  • Hacker Notes
• DebugFS
• DLMFS
  • Credits
  • Caveats
  • Mount options
  • Usage
  • Setup
  • Locking
  • See Also
• eCryptfs: A stacked cryptographic filesystem for Linux
  • Mount-wide Passphrase
  • Notes
• efivarfs - a (U)EFI variable filesystem
• Enhanced Read-Only File System - EROFS
  • Overview
  • Mount options
  • On-disk details
• The Second Extended Filesystem
• Options
• Specification
  • Blocks
  • Block Groups
  • The Superblock
  • Inodes
  • Directories
  • Special files
  • Reserved Space
  • Filesystem check
  • Feature Compatibility
  • Metadata
  • Limitations
  • Journaling
• References
• Ext3 Filesystem
• WHAT IS Flash-Friendly File System (F2FS)?
  • Background and Design issues
  • Key Features
  • Mount Options
  • Debugfs Entries
  • Sysfs Entries
  • Usage
  • Design
• Global File System
• uevents and GFS2
  • A list of GFS2 uevents
  • Information common to all GFS2 uevents (uevent environment variables)
• Macintosh HFS Filesystem for Linux
  • Mount options
  • Writing to HFS Filesystems
  • Creating HFS filesystems
  • Credits
• Macintosh HFSPlus Filesystem for Linux
  • Mount options
  • References
• Read/Write HPFS 2.09
  • Credits
  • File names
  • Extended attributes
  • Symlinks
  • Codepages
  • Known bugs
  • What does “unbalanced tree” message mean?
  • Bugs in OS/2
  • Codepage bugs described above
  • History
• FUSE
  • Definitions
  • What is FUSE?
  • Filesystem type
  • Mount options
  • Control filesystem
  • Aborting a filesystem connection
  • How do non-privileged mounts work?
  • How are requirements fulfilled?
  • I think these limitations are unacceptable?
  • Kernel - userspace interface
• Inotify - A Powerful yet Simple File Change Notification System
• ISO9660 Filesystem
• NILFS2
  • Caveats
  • Mount options
  • Ioctls
  • NILFS2 usage
  • Disk format
• NFS
  • Reference counting in pnfs
  • RPC Cache
  • rpcsec_gss support for kernel RPC servers
  • NFSv4.1 Server Implementation
  • Kernel NFS Server Statistics
• The Linux NTFS filesystem driver
  • Overview
  • Web site
  • Features
  • Supported mount options
  • Known bugs and (mis-)features
  • Using NTFS volume and stripe sets
• OCFS2 filesystem
  • Credits
  • Caveats
  • Mount options
• OCFS2 file system - online file check
  • Introduction
  • Scope
  • User interface
  • Fixing stuff
• Optimized MPEG Filesystem (OMFS)
  • Overview
  • Options
  • Disk format
• ORANGEFS
  • Mailing List Archives
  • Mailing List Submissions
  • Documentation
  • Running ORANGEFS On a Single Server
  • Userspace Filesystem Source
  • Building ORANGEFS on a Single Server
  • Running xfstests
  • Options
  • Debugging
  • Protocol between Kernel Module and Userspace
• Overlay Filesystem
  • Overlay objects
  • Upper and Lower
  • Directories
  • whiteouts and opaque directories
  • readdir
  • renaming directories
  • Non-directories
  • Permission model
  • Multiple lower layers
  • Metadata only copy up
  • Sharing and copying layers
  • Non-standard behavior
  • Changes to underlying filesystems
  • NFS export
  • Testsuite
• The /proc Filesystem
  • Preface
  • Chapter 1: Collecting System Information
  • Chapter 2: Modifying System Parameters
  • Chapter 3: Per-process Parameters
• The QNX6 Filesystem
  • Option
  • Specification
• Ramfs, rootfs and initramfs
  • Rob Landley <rob@landley.net>
• relay interface (formerly relayfs)
  • Semantics
  • klog and relay-apps example code
  • The relay interface user space API
  • The relay interface kernel API
  • Resources
  • Credits
• ROMFS - ROM File System
• Squashfs 4.0 Filesystem
  • 1. Filesystem Features
  • 2. Using Squashfs
  • 3. Squashfs Filesystem Design
  • 3.1 Compression options
  • 3.2 Inodes
  • 3.3 Directories
  • 3.4 File data
  • 3.5 Fragment lookup table
  • 3.6 Uid/gid lookup table
  • 3.7 Export table
  • 3.8 Xattr table
  • 4. TODOs and Outstanding Issues
  • 4.1 TODO list
  • 4.2 Squashfs Internal Cache
• sysfs - _The_ filesystem for exporting kernel objects
  • What it is:
  • Using sysfs
  • Directory Creation
  • Attributes
  • Subsystem-Specific Callbacks
  • Reading/Writing Attribute Data
  • Top Level Directory Layout
  • Current Interfaces
  • Documentation
• SystemV Filesystem
• Tmpfs
• UBI File System
  • Introduction
  • Mount options
  • Quick usage instructions
  • References
• Introduction
  • MTD, UBI & UBIFS
• UBIFS Authentication
  • Threat Model
  • Authentication
  • Key Management
• Future Extensions
• References
• UDF file system
• virtiofs: virtio-fs host<->guest shared file system
  • Introduction
  • Usage
  • Internals
• VFAT
  • USING VFAT
  • VFAT MOUNT OPTIONS
  • LIMITATION
  • TODO
  • POSSIBLE PROBLEMS
  • TEST SUITE
  • NOTES ON THE STRUCTURE OF THE VFAT FILESYSTEM
• ZoneFS - Zone filesystem for Zoned block devices
  • Introduction
  • Zonefs Overview
  • Zonefs User Space Tools