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
  • eventpoll (epoll) interfaces
  • 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
• The Devpts Filesystem
• Linux Directory Notification
  • Implementation expectations (features and bugs :-))
  • Configuration
  • Example
  • NOTE
• Fiemap Ioctl
  • Request Basics
  • Extent Mapping
  • VFS -> File System Implementation
• File management in the Linux kernel
• File Locking Release Notes
  • 1. What’s New?
• Filesystem Mount API
  • Overview
  • The Filesystem context
  • The Filesystem Context Operations
  • Filesystem context Security
  • VFS Filesystem context API
  • Superblock Creation Helpers
  • Parameter Description
  • Parameter Helper Functions
• Quota subsystem
  • Quota netlink interface
• The seq_file Interface
  • Deprecated create_proc_entry
  • The iterator interface
  • Formatted output
  • Making it all work
  • seq_list
  • The extra-simple version
• Shared Subtrees
  • 1) Overview
  • 2) Features
  • 4) Use cases
  • 5) Detailed semantics
• Idmappings
  • Formal notes
  • General notes
  • Translation algorithms
  • Idmappings when creating filesystem objects
  • Idmappings on idmapped mounts
  • Shortcircuting
• Automount Support
  • In-Kernel Automounting
  • Automatic Mountpoint Expiry
  • Userspace Driven Expiry
• Filesystem Caching
  • General Filesystem Caching
  • In-Kernel Cache Object Representation and Management
  • FS-Cache Cache backend API
  • CacheFiles: CACHE ON ALREADY MOUNTED FILESYSTEM
  • FS-Cache Network Filesystem API
  • Asynchronous Operations Handling
• 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
  • Inline encryption support
  • Implementation details
  • Tests
• fs-verity: read-only file-based authenticity protection
  • Introduction
  • Use cases
  • User API
  • Accessing verity files
  • File digest computation
  • Built-in signature verification
  • Filesystem support
  • Implementation details
  • Userspace utility
  • Tests
  • FAQ
• NETWORK FILESYSTEM HELPER LIBRARY
  • Overview
  • Buffered Read Helpers

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
• CIFS
  • KSMBD - SMB3 Kernel Server
  • Mounting root file system via SMB (cifs.ko)
• Ceph Distributed File System
  • Mount Syntax
  • Mount Options
  • More Information
• Coda Kernel-Venus Interface
  • 1. Introduction
  • 2. Servicing Coda filesystem calls
  • 3. The message layer
  • 4. The interface at the call level
  • 5. The minicache and downcalls
  • 6. Initialization and cleanup
• Configfs - Userspace-driven Kernel Object Configuration
  • What is configfs?
  • Using configfs
  • Configuring FakeNBD: an Example
  • Coding With configfs
  • struct config_item
  • struct config_item_type
  • struct configfs_attribute
  • struct configfs_bin_attribute
  • struct config_group
  • struct configfs_subsystem
  • An Example
  • Hierarchy Navigation and the Subsystem Mutex
  • Item Aggregation Via symlink(2)
  • Automatically Created Subgroups
  • Dependent Subsystems
  • Committable Items
• Cramfs - cram a filesystem onto a small ROM
  • Usage Notes
  • Memory Mapped cramfs image
  • Tools
  • For /usr/share/magic
  • Hacker Notes
• Direct Access for files
  • Motivation
  • Usage
  • Enabling DAX on ext2
  • Enabling DAX on xfs and ext4
  • Summary
  • Details
  • Implementation Tips for Block Driver Writers
  • Implementation Tips for Filesystem Writers
  • Handling Media Errors
  • Shortcomings
• 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
  • References
• Ext3 Filesystem
• ext4 Data Structures and Algorithms
  • 1. About this Book
  • 2. High Level Design
  • 3. Global Structures
  • 4. Dynamic Structures
• WHAT IS Flash-Friendly File System (F2FS)?
  • Background and Design issues
  • Key Features
  • Mount Options
  • Debugfs Entries
  • Sysfs Entries
  • Usage
  • Design
• Global File System 2
• uevents and GFS2
  • A list of GFS2 uevents
  • Information common to all GFS2 uevents (uevent environment variables)
• Glock internal locking rules
  • Glock Statistics
• 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
• Fuse I/O Modes
• 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
  • Reexporting NFS filesystems
• The Linux NTFS filesystem driver
  • Overview
  • Web site
  • Features
  • Supported mount options
  • Known bugs and (mis-)features
  • Using NTFS volume and stripe sets
• NTFS3
  • Summary and Features
  • Mount Options
  • Todo list
  • References
• 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
  • Volatile mount
  • User xattr
  • Testsuite
• The /proc Filesystem
  • Preface
  • Chapter 1: Collecting System Information
  • Chapter 2: Modifying System Parameters
  • Chapter 3: Per-process Parameters
  • Chapter 4: Configuring procfs
  • Chapter 5: Filesystem behavior
• 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
• SPU Filesystem
  • spufs
  • spu_create
  • spu_run
• 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
• UBIFS Authentication Support
  • Introduction
  • UBIFS Authentication
  • 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
• XFS Delayed Logging Design
  • Introduction to Re-logging in XFS
  • Delayed Logging: Concepts
  • Delayed Logging: Design
• XFS Self Describing Metadata
  • Introduction
  • Self Describing Metadata
  • Runtime Validation
  • Structures
  • Inodes and Dquots
• ZoneFS - Zone filesystem for Zoned block devices
  • Introduction
  • Zonefs Overview
  • Zonefs User Space Tools