Zonefs is a very simple file system exposing each zone of a zoned block
device as a file. Unlike a regular file system with zoned block device
support (e.g. f2fs or the on-going btrfs effort), zonefs does not hide
the sequential write constraint of zoned block devices to the user.
Files representing sequential write zones of the device must be written
sequentially starting from the end of the file (append only writes).
Zonefs is not a POSIX compliant file system. It's goal is to simplify
the implementation of zoned block devices support in applications by
replacing raw block device file accesses with a richer file based API,
avoiding relying on direct block device file ioctls which may
be more obscure to developers. One example of this approach is the
implementation of LSM (log-structured merge) tree structures (such as
used in RocksDB and LevelDB) on zoned block devices by allowing SSTables
to be stored in a zone file similarly to a regular file system rather
than as a range of sectors of a zoned device. The introduction of the
higher level construct "one file is one zone" can help reducing the
amount of changes needed in the application while at the same time
allowing the use of zoned block devices with various programming
languages other than C.
Zonefs IO management implementation uses the new iomap generic code.
Changes from v11:
* Improved I/O error handling description in the documentation (thanks
to Dave Chinner for the suggestions).
Changes from v10:
* Simplify zonefs_io_error() while extending I/O error and corruption
types coverage.
* Reworked zonefs_create_zgroup() to avoid the use of on-stack file
name string and the need for the array of zone group names.
* Fixed a bug in zonefs_file_buffered_write() (incorrect call to
zonefs_io_error).
* Improved comments throughout the code.
* Fixed documentation to describe I/O error handling as implemented.
Changes from v9:
* Changed mount options to a more useful set of possible actions for
zone corruption handling: repair, remount-ro, zone-ro or zone-offline
* Check IMMUTABLE inodes to prevent write operations
* Documented mount options
Changes from v8:
* Comments typos fixes and improvements as suggested by Darrick and
Dave.
* Improved IO error handling:
- Better sequential file write pointer checks on write IO error
- Extended zone condition checks on IO error to all types of IOs
- Added mount options for controlling the FS behavior when a zone
write pointer corruption is detected.
* Cleanup zonefs_iomap_begin() and its use in zonefs_map_blocks()
* Ignore RWF_NOWAIT to avoid out of order writes on sequential zone
files.
* Improved documentation file
Changes from v7:
* Fixed static checker warnings:
- Set-but-not-used variable in zonefs_file_buffered_write()
- Use S_ISDIR() in zonefs_inode_setattr()
Changes from v6:
* Fixed documentation as suggested by Randy.
Changes from v5:
* Added simple description of zoned block devices to the documentation,
as suggested by Johannes.
* Added a 64-char max label field to the super block to allow label
based identification of volumes using libblkid (checked with a patch
to libblkid).
Changes from v4:
* Use octal values for file and directory permissions
* Set initial directory permissions to 0555 (no write permission)
* Prevent setting write permissions for directories
Changes from v3:
* Fixed many typos in the documentation
* Use symbolic file permission macros instead of octal values
(checkpatch.pl complains about this)
Changes from v2:
* Address comments and suggestions from Darrick:
- Make the inode of OFFLINE and READONLY zones immutable when
mounting. Also do this during zone information check after an IO
error.
- Change super block CRC seed to ~0.
- Avoid potential compiler warning in zonefs_create_zgroup().
* Fixed endianness related compilation warning detected by kbuild bot.
Changes from v1:
* Fixed comment typo
* Improved documentation as suggested by Hannes
Damien Le Moal (2):
fs: New zonefs file system
zonefs: Add documentation
Documentation/filesystems/zonefs.txt | 404 ++++++++
MAINTAINERS | 10 +
fs/Kconfig | 1 +
fs/Makefile | 1 +
fs/zonefs/Kconfig | 9 +
fs/zonefs/Makefile | 4 +
fs/zonefs/super.c | 1441 ++++++++++++++++++++++++++
fs/zonefs/zonefs.h | 190 ++++
include/uapi/linux/magic.h | 1 +
9 files changed, 2061 insertions(+)
create mode 100644 Documentation/filesystems/zonefs.txt
create mode 100644 fs/zonefs/Kconfig
create mode 100644 fs/zonefs/Makefile
create mode 100644 fs/zonefs/super.c
create mode 100644 fs/zonefs/zonefs.h
--
2.24.1
