Changelog

From btrfs Wiki
(Difference between revisions)
Jump to: navigation, search
(By version (btrfs-progs): remove contents, link to RTD)
(By feature: delete contents, link to RTD)
 
Line 1: Line 1:
 
= By feature =
 
= By feature =
Major features or significant feature enhancements by kernel version. For more information look below.
 
  
'''WARNING:''' The "Version" row states at which version a feature has been merged into the mainline kernel. It does not tell anything about at which kernel version it is considered mature enough for production use. For an estimation on stability of features see [[Status]] page.
+
Features by version have been moved to https://btrfs.readthedocs.io/en/latest/Feature-by-version.html
 
+
{| class="wikitable" border=1
+
|-
+
! Feature !! Version !! Description !! Notes
+
{{FeatureMerged
+
|name=scrub
+
|version=3.0
+
|text=Read all data and verify checksums, repair if possible.
+
}}
+
{{FeatureMerged
+
|name=auto raid repair
+
|version=3.2
+
|text=Automatic repair of broken data from a good copy
+
}}
+
{{FeatureMerged
+
|name=root backups
+
|version=3.2
+
|text=Save a few previous versions of the most imporant tree roots at commit time, used by ''-o recovery''
+
}}
+
{{FeatureMerged
+
|name=integrity checker
+
|version=3.3
+
|text=Optional infrastructure to verify integrity of written metadata blocks
+
}}
+
{{FeatureMerged
+
|name=backref walking
+
|version=3.3
+
|text=Groundwork to allow tracking owner of blocks, used via ''inspect-internal''
+
}}
+
{{FeatureMerged
+
|name=restriper
+
|version=3.3
+
|text=RAID profiles can be changed on-line, balance filters
+
}}
+
{{FeatureMerged
+
|name=big metadata blocks
+
|version=3.4
+
|text=Support for metadata blocks larger than page size
+
|note=Default nodesize is 16k since btrfs-progs 3.12
+
}}
+
{{FeatureMerged
+
|name=error handling
+
|version=3.4
+
|text=Generic infrastructure for graceful error handling (EIO)
+
}}
+
{{FeatureMerged
+
|name=device statistics
+
|version=3.5
+
|text=Persistent statistics about device errors
+
}}
+
{{FeatureMerged
+
|name=fsync speedup
+
|version=3.5
+
|text=Noticeable improvements in fsync() implementation
+
}}
+
{{FeatureMerged
+
|name=qgroups
+
|version=3.6
+
|text=Subvolume-aware quotas
+
}}
+
{{FeatureMerged
+
|name=send/receive
+
|version=3.6
+
|text=Ability to transfer one filesystem via a data stream (full or incremental) and apply the changes on a remote filesystem.
+
}}
+
{{FeatureMerged
+
|name=extrefs
+
|version=3.7
+
|text=Hardlink count limit is lifted to 64k
+
|note=Default since btrfs-progs 3.12
+
}}
+
{{FeatureMerged
+
|name=hole puching
+
|version=3.7
+
|text=Implement the FALLOC_FL_PUNCH_HOLE mode of ''fallocate''
+
}}
+
{{FeatureMerged
+
|name=device replace
+
|version=3.8
+
|text=Efficient replacement of existing device (add/remove in one go)
+
}}
+
{{FeatureMerged
+
|name=raid 5/6 ''(incomplete)''
+
|version=3.9
+
|text=Basic support for RAD5/6 profiles, no crash resiliency, replace and scrub support
+
}}
+
{{FeatureMerged
+
|name=snapshot-aware defrag
+
|version=3.9
+
|text=Defrag does not break links between shared extents (snapshots, reflinked files)
+
|note=Disabled since 3.14 (and backported to some stable kernel versions) due to problems. Will be enabled in the future.
+
}}
+
{{FeatureMerged
+
|name=lightweight send
+
|version=3.9
+
|text=A mode of ''send'' that does not add the actual file data to the stream
+
}}
+
{{FeatureMerged
+
|name=on-line label set/get
+
|version=3.9
+
|text=Label editable on mounted filesystems
+
}}
+
{{FeatureMerged
+
|name=skinny metadata
+
|version=3.10
+
|text=Reduced metadata size (format change) of extents
+
|note=Default since btrfs-progs 3.18
+
}}
+
{{FeatureMerged
+
|name=qgroup rescan
+
|version=3.10
+
|text=Sync qgroups with existing filesystem data
+
}}
+
{{FeatureMerged
+
|name=uuid tree
+
|version=3.12
+
|text=A map of subvolume/UUID that vastly speeds up send/receive
+
}}
+
{{FeatureMerged
+
|name=out-of-bound dedup
+
|version=3.12
+
|text=Support for deduplicating extents on a given set of files.
+
}}
+
{{FeatureMerged
+
|name=no-holes
+
|version=3.14
+
|text=No extent representation for file holes (format change), may reduce overall metadata consumption
+
|note=Default since btrfs-progs 5.15
+
}}
+
{{FeatureMerged
+
|name=feature bits in sysfs
+
|version=3.14
+
|text=/sys/fs/btrfs exports various bits about filesystem capabilities and feature support
+
}}
+
{{FeatureMerged
+
|name=O_TMPFILE
+
|version=3.16
+
|text=Mode of open() to safely create a temporary file
+
}}
+
{{FeatureMerged
+
|name=search ioctl v2
+
|version=3.16
+
|text=The extended SEARCH_TREE ioctl able to get more than a 4k data
+
}}
+
{{FeatureMerged
+
|name=auto blockgroup reclaim
+
|version=3.18
+
|text=Automatically remove blockgroups (aka. chunks) that become completely empty.
+
}}
+
{{FeatureMerged
+
|name=raid56: scrub, replace
+
|version=3.19
+
|text=Scrub and device replace works on RAID56 filesystems.
+
}}
+
{{FeatureMerged
+
|name=store otime
+
|version=4.0
+
|text=Save creation time (otime) for all new files and directories. For future use, current tool cannot read it directly.
+
}}
+
{{FeatureMerged
+
|name=rootid ioctl accessible
+
|version=4.2
+
|text=The INO_LOOKUP will return root id (id of the containing subvolume), unrestricted and to all users if the ''treeid'' is 0.
+
}}
+
{{FeatureMerged
+
|name=dedupe possible on the same inode
+
|version=4.2
+
|text=The EXTENT_SAME ioctl will accept the same inode as source and destination (ranges must not overlap).
+
}}
+
{{FeatureMerged
+
|name=trim all free space
+
|version=4.3
+
|text=Trim will be performed also on the space that's not allocated by the chunks, not only free space within the allocated chunks.
+
}}
+
{{FeatureMerged
+
|name=balance filter updates
+
|version=4.4
+
|text=Enhanced syntax and new balance filters:
+
* limit=min..max
+
* usage=min..max
+
* stripes=min..max
+
}}
+
{{FeatureMerged
+
|name=free space tree
+
|version=4.5
+
|text=Improved implementation of free space cache (aka v2), using b-trees.
+
|note=Default since btrfs-progs 5.15, Kernel 4.9 fixes endianity bugs on big-endian machines, x86* is ok
+
}}
+
{{FeatureMerged
+
|name=balance filter updates
+
|version=4.5
+
|text=Conversion to data/DUP profile possible through balance filters -- on single-device filesytem.
+
|note=mkfs.btrfs allows creating DUP on single device in the non-mixed mode since 4.4
+
}}
+
{{FeatureMerged
+
|name=max_inline default
+
|version=4.6
+
|text=The default value of max_inline changed to 2048.
+
}}
+
{{FeatureMerged
+
|name=read features from control device
+
|version=4.6
+
|text=The existing ioctl GET_SUPPORTED_FEATURES can be now used on the control device (/dev/btrfs-control) and returns the supported features without any mounted filesystem.
+
}}
+
{{FeatureMerged
+
|name=delete device by id
+
|version=4.7
+
|text=Add new ioctl RM_DEV_V2, pass device to be deleted by its ID.
+
}}
+
{{FeatureMerged
+
|name=more renameat2 modes
+
|version=4.7
+
|text=Add support for RENAME_EXCHANGE and RENAME_WHITEOUT to ''renameat2'' syscall. This also means that ''overlayfs'' is now supported on top of btrfs.
+
}}
+
{{FeatureMerged
+
|name=balance filter updates
+
|version=4.7
+
|text=Conversion to data/DUP profile possible through balance filters -- on multiple-device filesystems.
+
|note=mkfs.btrfs allows creating DUP on multiple devices since 4.5.1
+
}}
+
{{FeatureMerged
+
|name=raid56: auto repair
+
|version=4.12
+
|text=Scrub will attempt auto-repair (similar to raid1/raid10)
+
}}
+
{{FeatureMerged
+
|name=statx
+
|version=4.13
+
|text=Support for the enhanced statx syscall; file creation timestamp
+
}}
+
{{FeatureMerged
+
|name=sysfs qgroups override
+
|version=4.13
+
|text=qgroups: new sysfs control file to allow temporary quota override with CAP_SYS_RESOURCE
+
}}
+
{{FeatureMerged
+
|name=''deprecated mount option alloc_start''
+
|version=4.13
+
|text=That was a debugging helper, not used and not supposed to be used nowadays.
+
}}
+
{{FeatureMerged
+
|name=ZSTD compression
+
|version=4.14
+
|text=New compression algorithm ZSTD, supposedly better ratio/speed performance.
+
}}
+
{{FeatureMerged
+
|name=improved degraded mount
+
|version=4.14
+
|text=Allow degraded mount based on the chunk constraints, not device number constraints. Eg. when one device is missing but the remaining one holds all ''single'' chunks.
+
}}
+
{{FeatureMerged
+
|name=''deprecated user transaction ioctl''
+
|version=4.14
+
|text=BTRFS_IOC_TRANS_START and BTRFS_IOC_TRANS_END, no known users, tricky to use; scheduled to be removed in 4.17
+
}}
+
{{FeatureMerged
+
|name=refine SSD optimizations
+
|version=4.14
+
|text=The mount option ''ssd'' does not make any assumptions about block layout or management by the device anymore, leaving only the speedups based on low seek cost active.
+
This could avoid some corner cases leading to excessive fragmentation. [https://git.kernel.org/linus/583b723151794e2ff1691f1510b4e43710293875 The story so far.]
+
}}
+
{{FeatureMerged
+
|name=overlayfs
+
|version=4.15
+
|text=Overlayfs can now use btrfs as the lower filesystem.
+
}}
+
{{FeatureMerged
+
|name=<i>ref-verify</i>
+
|version=4.15
+
|text=Debugging functionality to verify extent references. New mount option <i>ref-verify</i>, must be built with CONFIG_BTRFS_FS_REF_VERIFY.
+
}}
+
{{FeatureMerged
+
|name=zlib level
+
|version=4.15
+
|text=Allow to set the zlib compression level via mount option, eg. like <i>compress=zlib:9</i>. The levels match the default zlib compression levels. The default is 3.
+
}}
+
{{FeatureMerged
+
|name=v2 of LOGICAL_INO ioctl
+
|version=4.15
+
|text=An enhanced version of ioctl that can translate logical extent offset to inode numbers, "who owns this block". For certain usecases the V1 performs bad and this is addressed by V2. [https://git.kernel.org/linus/d24a67b2d997c860a42516076f3315c2ad2d2884 Read more.]
+
}}
+
{{FeatureMerged
+
|name=compression heuristics
+
|version=4.15
+
|text=Apply a few heuristics to the data before they're compressed to decide if it's likely to gain any space savings. The methods: frequency sampling, repeated pattern detection, Shannon entropy calculation.
+
}}
+
{{FeatureMerged
+
|name=fallocate: zero range
+
|version=4.16
+
|text=Mode of the [http://man7.org/linux/man-pages/man2/fallocate.2.html ''fallocate''] syscall to zero file range.
+
}}
+
{{FeatureMerged
+
|name=''removed user transaction ioctl''
+
|version=4.17
+
|text=deprecated in 4.14, see above
+
}}
+
{{FeatureMerged
+
|name=''rmdir'' on subvolumes
+
|version=4.18
+
|text=Allow rmdir to delete an empty subvolume.
+
}}
+
{{FeatureMerged
+
|name=XFLAGS ioctl
+
|version=4.18
+
|text=Add support for ioctl FS_IOC_FSSETXATTR/FS_IOC_FSGETXATTR, successor of
+
FS_IOC_SETFLAGS/FS_IOC_GETFLAGS ioctl. Currently supports: APPEND, IMMUTABLE,
+
NOATIME, NODUMP, SYNC. Note that the naming is very confusing, though it's
+
named ''xattr'', it does not mean the extended attributes. It should be
+
referenced as extended inode flags or ''xflags''.
+
}}
+
{{FeatureMerged
+
|name=EXTENT_SAME ioctl / 16MiB chunks
+
|version=4.18
+
|text=The range for out-of-band deduplication implemented by the EXTENT_SAME
+
ioctl will split the range into 16MiB chunks. Up to now this was the overall
+
limit and effectively only the first 16MiB was deduplicated.
+
}}
+
{{FeatureMerged
+
|name=GET_SUBVOL_INFO ioctl
+
|version=4.18
+
|text=New ioctl to read subvolume information (id, directory name, generation,
+
flags, UUIDs, time). This does not require root permissions, only the regular
+
access to to the subvolume.
+
}}
+
{{FeatureMerged
+
|name=GET_SUBVOL_ROOTREF ioctl
+
|version=4.18
+
|text=New ioctl to enumerate subvolume references of a given subvolume. This
+
does not require root permissions, only the regular access to to the
+
subvolume.
+
}}
+
{{FeatureMerged
+
|name=INO_LOOKUP_USER ioctl
+
|version=4.18
+
|text=New ioctl to lookup path by inode number. This does not require root
+
permissions, only the regular access to to the subvolume, unlike the
+
INO_LOOKUP ioctl.
+
}}
+
{{FeatureMerged
+
|name=defrag ro/rw
+
|version=4.19
+
|text=Allow to run defrag on files that are normally accesible for read-write, but are currently opened in read-only mode.
+
}}
+
{{FeatureMerged
+
|name=swapfile
+
|version=5.0
+
|text=With some limitations where COW design does not work well with the swap implementation (nodatacow file, no compression, cannot be snapshotted, not possible on multiple devices, ...), as this is the most restricted but working setup, we'll try to improve that in the future
+
}}
+
{{FeatureMerged
+
|name=metadata uuid
+
|version=5.0
+
|text=An optional incompat feature to assign a new filesystem UUID without overwriting all metadata blocks, stored only in superblock, unlike what <tt>btrfstune -u</tt>
+
}}
+
{{FeatureMerged
+
|name=FORGET_DEV ioctl
+
|version=5.1
+
|text=Unregister devices previously added by the scan ioctl, same effect as if the kernel module is reloaded.
+
}}
+
{{FeatureMerged
+
|name=zstd level
+
|version=5.1
+
|text=Allow to set the zstd compression level via mount option, eg. like <i>compress=zstd:9</i>. The levels match the default zstd compression levels. The default is 3, maximum is 15.
+
}}
+
{{FeatureMerged
+
|name=pre-write checks
+
|version=5.2
+
|text=Verify metadata blocks before submitting them to the devices. This can catch consistency problems or bitflips.
+
}}
+
{{FeatureMerged
+
|name=more checksums
+
|version=5.5
+
|text=New checksum algorithms: xxhash (64b), SHA256 (256b), BLAKE2b (256b).
+
}}
+
{{FeatureMerged
+
|name=RAID1C34
+
|version=5.5
+
|text=RAID1 with 3- and 4- copies (over all devices).
+
}}
+
{{FeatureMerged
+
|name=async discard
+
|version=5.6
+
|text=Mode of discard (''mount -o discard=async'') that merges freed extents to larger chunks and submits them for discard in a less intrusive way
+
}}
+
{{FeatureMerged
+
|name=device info in sysfs
+
|version=5.6
+
|text=More information about device state can be found in per-filesystem sysfs directory.
+
}}
+
{{FeatureMerged
+
|name=reflink/clone works on inline files
+
|version=5.7
+
|text=Inline files can be reflinked to the tail extent of other files
+
}}
+
{{FeatureMerged
+
|name=faster balance cancel
+
|version=5.7
+
|text=More cancellation points in balance that will shorten the time to stop processing once <tt>btrfs balance cancel</tt> is called.
+
}}
+
{{FeatureMerged
+
|name=''removed flag BTRFS_SUBVOL_CREATE_ASYNC''
+
|version=5.7
+
|text=Remove support of flag BTRFS_SUBVOL_CREATE_ASYNC from subvolume creation ioctl.
+
}}
+
{{FeatureMerged
+
|name=v2 of snapshot deletion ioctl
+
|version=5.7
+
|text=New ioctl BTRFS_IOC_SNAP_DESTROY_V2, deletion by subvolume id is now possible.
+
}}
+
{{FeatureMerged
+
|name=mount option ''rescue''
+
|version=5.9
+
|text=Unified mount option for actions that may help to access a damaged filesystem. Now supports: nologreplay, usebackuproot
+
}}
+
{{FeatureMerged
+
|name=qgroups in sysfs
+
|version=5.9
+
|text=The information about qgroup status and relations is exported in ''/sys/fs/UUID/qgroups''
+
}}
+
{{FeatureMerged
+
|name=FS_INFO ioctl
+
|version=5.9
+
|text=Export more information: checksum type, checksum size, generation, metadata_uuid
+
}}
+
{{FeatureMerged
+
|name=exclusive ops in sysfs
+
|version=5.10
+
|text=Export which filesystem exclusive operation is running (balance, resize, device add/delete/relpace, ...)
+
}}
+
{{FeatureMerged
+
|name=remove ''inode_cache''
+
|version=5.11
+
|text=Remove inode number caching feature (mount -o inode_cache)
+
}}
+
{{FeatureMerged
+
|name=more rescue=
+
|version=5.11
+
|text=Additional modes for mount option ''rescue='': ignorebadroots/ibadroots, ignoredatacsums/idatacsums. All are exported in sysfs.
+
}}
+
{{FeatureMerged
+
|name=zoned mode
+
|version=5.12
+
|text=Support for zoned devices with special allocation/write mode to fixed-size zones. See [[Zoned]].
+
}}
+
{{FeatureMerged
+
|name=supported_sectorsizes in sysfs
+
|version=5.13
+
|text=List supported sector sizes in sysfs file /sys/fs/btrfs/features/supported_sectorsizes
+
}}
+
{{FeatureMerged
+
|name=sysfs scrub bw limit
+
|version=5.14
+
|text=Tunable bandwidth limit (/sys/fs/btrfs/FSID/devinfo/DEVID/scrub_speed_max) for scrub (and device replace) for a given device.
+
}}
+
{{FeatureMerged
+
|name=sysfs device stats
+
|version=5.14
+
|text=The device stats can be also found in /sys/fs/btrfs/FSID/devinfo/DEVID/error_stats.
+
}}
+
{{FeatureMerged
+
|name=cancellable resize, device delete
+
|version=5.14
+
|text=The filesystem resize and device delete operations can be cancelled by specifying ''cancel'' as the device name.
+
}}
+
{{FeatureMerged
+
|name=property value reset
+
|version=5.14
+
|text=Change how empty value is interpreted. New behaviour will delete the value and reset it to default. This affects ''btrfs.compression'' where value ''no'' sets NOCOMPRESS bit while empty value resets all compression settings (either compression or NOCOMPRESS bit).
+
}}
+
{{FeatureMerged
+
|name=fsverity
+
|version=5.15
+
|text=The fs-verity is a support layer that filesystems can hook into to support transparent integrity and authenticity protection of read-only files. https://www.kernel.org/doc/html/latest/filesystems/fsverity.html
+
}}
+
{{FeatureMerged
+
|name=idmapped mount
+
|version=5.15
+
|text=Support mount with uid/gid mapped according to another namespace. https://lwn.net/Articles/837566/
+
}}
+
{{FeatureMerged
+
|name=ZNS in zoned
+
|version=5.16
+
|text=Zoned namespaces. https://zonedstorage.io/docs/introduction/zns https://lwn.net/Articles/865988/
+
}}
+
{{FeatureMerged
+
|name=send and relocation
+
|version=5.17
+
|text=Send and relocation (balance, device remove, shrink, block group reclaim) can now work in parallel
+
}}
+
{{FeatureMerged
+
|name=device add vs balance
+
|version=5.17
+
|text=It is possible to add a device with paused balance
+
|note=Since kernel 5.17.7 and btrfs-progs 5.17.1
+
}}
+
{{FeatureMerged
+
|name=''no warning with flushoncommit''
+
|version=5.17
+
|text=Mounting with ''-o flushoncommit'' does not triggher the (harmless) warning at each transaction commit
+
|note=Also backported to 5.15.27 and 5.16.13
+
}}
+
{{FeatureMerged
+
|name=zoned and DUP metadata
+
|version=5.18
+
|text=DUP metadata works with zoned mode
+
}}
+
{{FeatureMerged
+
|name=encoded data ioctl
+
|version=5.18
+
|text=New ioctls to read and write pre-encoded data (ie. no transformation and directly written as extents), now works for compressed data
+
}}
+
{{FeatureMerged
+
|name=''removed balance ioctl v1''
+
|version=5.18
+
|text=The support for ioctl BTRFS_IOC_BALANCE has been removed, superseded by BTRFS_IOC_BALANCE_V2m long time ago
+
}}
+
|}
+
  
 
= By version (btrfs-progs) =
 
= By version (btrfs-progs) =

Latest revision as of 17:49, 15 June 2022

Contents

[edit] By feature

Features by version have been moved to https://btrfs.readthedocs.io/en/latest/Feature-by-version.html

[edit] By version (btrfs-progs)

Tarballs: https://www.kernel.org/pub/linux/kernel/people/kdave/btrfs-progs/

Version changelogs have been moved to https://btrfs.readthedocs.io/en/latest/CHANGES.html

[edit] By version (linux kernel)

[edit] v5.17 (Mar 2022)

Features:

  • make send work with concurrent block group relocation
  • new exclusive operation 'balance paused' to allow adding a device to filesystem with paused balance
  • new sysfs file for fsid stored in the per-device directory to help distinguish devices when seeding is enabled

Performance:

  • less metadata needed for directory logging, directory deletion is 20-40% faster
  • in zoned mode, cache zone information during mount to speed up repeated queries (about 50% speedup)
  • free space tree entries get indexed and searched by size (latency -30%, search run time -30%)
  • less contention in tree node locking when inserting a key and no splits are needed (files/sec in fsmark improves by 1-20%)

Fixes:

  • defrag rewrite from 5.16 fixed
  • get rid of warning when mounted with flushoncommit

Core:

  • global reserve stealing got simplified and cleaned up in evict
  • more preparatory work for extent tree v2
  • remove readahead framework
  • error handling improvements
  • for other changes see the pull request

[edit] v5.16 (Jan 2022)

Related projects: kernel port of zstd 1.4.10 also released in 5.16

Performance related:

  • misc small inode logging improvements (+3% throughput, -11% latency on sample dbench workload)
  • more efficient directory logging: bulk item insertion, less tree searches and locking
  • speed up bulk insertion of items into a b-tree, which is used when logging directories, when running delayed items for directories (fsync and transaction commits) and when running the slow path (full sync) of an fsync (bulk creation run time -4%, deletion -12%)

Core:

  • continued subpage support
    • make defragmentation work
    • make compression write work
  • zoned mode
    • support ZNS (zoned namespaces), zone capacity is number of usable blocks in each zone
    • add dedicated block group (zoned) for relocation, to prevent out of order writes in some cases
    • greedy block group reclaim, pick the ones with least usable space first
  • preparatory work for send protocol updates
  • error handling improvements
  • cleanups and refactoring
  • for other changes see the pull request

[edit] v5.15 (Nov 2021)

Features:

  • fs-verity support, using standard ioctls, backward compatible with read-only limitation on inodes with previously enabled fs-verity
  • idmapped mount support
  • make mount with rescue=ibadroots more tolerant to partially damaged trees
  • allow raid0 on a single device and raid10 on two devices, degenerate cases but might be useful as an intermediate step during conversion to other profiles
  • zoned mode block group auto reclaim can be disabled via sysfs knob

Performance improvements:

  • continue readahead of node siblings even if target node is in memory, could speed up full send (on sample test +11%)
  • batching of delayed items can speed up creating many files
  • fsync/tree-log speedups
    • avoid unnecessary work (gains +2% throughput, -2% run time on sample load)
    • reduced lock contention on renames (on dbench +4% throughput, up to -30% latency)

Fixes:

  • various zoned mode fixes
  • preemptive flushing threshold tuning, avoid excessive work on almost full filesystems

Core:

  • continued subpage support, preparation for implementing remaining features like compression and defragmentation; with some limitations, write is now enabled on 64K page systems with 4K sectors, still considered experimental
    • no readahead on compressed reads
    • inline extents disabled
    • disabled raid56 profile conversion and mount
  • improved flushing logic, fixing early ENOSPC on some workloads
  • inode flags have been internally split to read-only and read-write incompat bit parts, used by fs-verity
  • new tree items for fs-verity: descriptor item, Merkle tree item
  • inode operations extended to be namespace-aware
  • cleanups and refactoring
  • for other changes see the pull request

[edit] v5.14 (Aug 2021)

Hilights:

  • new sysfs knob to limit scrub IO bandwidth per device
  • device stats are also available in /sys/fs/btrfs/FSID/devinfo/DEVID/error_stats
  • support cancellable resize and device delete ioctls
  • change how the empty value is interpreted when setting a property, so far we have only 'btrfs.compression' and we need to distinguish a reset to defaults and setting "do not compress", in general the empty value will always mean 'reset to defaults' for any other property, for compression it's either 'no' or 'none' to forbid compression
  • performance improvements (xattrs, truncate)
  • space handling improvements, preemptive flushing
  • more subpage support preparation
  • for other changes see the pull request

[edit] v5.13 (Jun 2021)

  • User visible improvements
    • readahead for send, improving run time of full send by 10% and for incremental by 25%
    • make reflinks respect O_SYNC, O_DSYNC and S_SYNC flags
    • export supported sectorsize values in sysfs (currently only page size, more once full subpage support lands)
    • more graceful errors and warnings on 32bit systems when logical addresses for metadata reach the limit posed by unsigned long in page::index
      • error: fail mount if there's a metadata block beyond the limit
      • error: new metadata block would be at unreachable address
      • warn when 5/8th of the limit is reached, for 4K page systems it's 10T, for 64K page it's 160T
    • zoned mode
      • relocated zones get reset at the end instead of discard
      • automatic background reclaim of zones that have 75%+ of unusable space, the threshold is tunable in sysfs
  • Fixes
    • fix inefficient preemptive reclaim calculations
    • fix exhaustion of the system chunk array due to concurrent allocations
    • fix fallback to no compression when racing with remount
    • fix unmountable seed device after fstrim
    • fix fiemap to print extents that could get misreported due to internal extent splitting and logical merging for fiemap output
    • preemptive fix for dm-crypt on zoned device that does not properly advertise zoned support
  • Core changes
    • add inode lock to synchronize mmap and other block updates (eg. deduplication, fallocate, fsync)
    • subpage support (continued)
      • metadata changes now support read and write
    • error handling through out relocation call paths
    • many other cleanups and code simplifications
  • for other changes see the pull request

[edit] v5.12 (Apr 2021)

  • features
    • zoned mode (SMR/ZBC/ZNS friendly allocation mode), first working version with limitations
  • misc performance improvements
    • flushing and ticket space reservations
    • preemptive background flushing
    • less lock contention for delayed refs
    • dbench-like workload (+7% throughput, -20% latency)
  • core changes:
    • subpage block size support peparations
  • fixes
    • swapfile fixes (vs scrub, activation vs snapshot creation)
  • for other changes see the pull request

[edit] v5.11 (Feb 2021)

  • new mount option rescue, various modes how to access a damaged filesystem
  • sysfs updates: filesystem generation, supported rescue modes, read mirror policy
  • removed feature: mount -o inode_cache
  • free space tree fixes, v1 cache removed during conversion
  • core
    • locking switched to standard rw semaphores
    • direct IO ported to iomap infrastructure
    • zoned allocation mode preparation
    • subpage blocksize preparation
    • various performance improvements (skipping unnecessary work)
  • for other changes see the pull request

[edit] v5.10 (Dec 2020)

  • hilights
    • performance improvements in fsync (dbench workload: higher throughput, lower latency)
    • sysfs exports current exclusive operataion (balance, resize, device add/del/...)
    • sysfs exports supported send stream version
  • core
    • direct io uses iomap infrastructure (no more struct buffer_head)
    • space reservations for data now use ticket infrastructure
    • cleanups, refactoring, preparatory work
    • error handling improvements
    • fixes
  • for other changes see the pull request

[edit] v5.9 (Oct 2020)

  • hilights
    • add mount option rescue to unify options for various recovery tasks on a mounted filesystems
    • mount option inode_cache is deprecated and will be removed in 5.11
    • removed deprecated options alloc_start and subvolrootid
    • sysfs exports information about qgroups and relations
    • FS_INFO ioctl exports more information from the filesystem (notably type of checksum)
    • running balance detects Ctrl-C too
    • performance improvements in fsync
    • mount-time prefetch of chunk tree
  • for other changes see the pull request

[edit] v5.8 (Aug 2020)

  • Hilights:
    • speedup dead root detection during orphan cleanup
    • send will emit file capabilities after chown
  • Core changes:
    • improved global block reserve utilization
    • direct io cleanups and fixes
    • refactored block group reading code
    • lots of other core changes see the pull request

[edit] v5.7 (May 2020)

  • hilights
    • v2 of ioctl to delete subvolumes, allowing to delete by id and more future extensions
    • removal of obsolete ioctl flag BTRFS_SUBVOL_CREATE_ASYNC
    • more responsive balance cancel
    • speedup of extent back reference resolution
    • reflink/clone_range works on inline extents
  • lots of othe core changes, see the pull request

[edit] v5.6 (Mar 2020)

  • Highlights:
    • async discard
      • "mount -o discard=async" to enable it
      • freed extents are not discarded immediatelly, but grouped together and trimmed later, with IO rate limiting
      • the actual discard IO requests have been moved out of transaction commit to a worker thread, improving commit latency
      • IO rate and request size can be tuned by sysfs files, for now enabled only with CONFIG_BTRFS_DEBUG as we might need to add/delete the files and don't have a stable-ish ABI for general use, defaults are conservative
    • export device state info in sysfs, eg. missing, writeable
    • no discard of extents known to be untouched on disk (eg. after reservation)
    • device stats reset is logged with process name and PID that called the ioctl
  • Core changes:
    • qgroup assign returns ENOTCONN when quotas not enabled, used to return EINVAL that was confusing
    • device closing does not need to allocate memory anymore
    • snapshot aware code got removed, disabled for years due to performance problems, reimplmentation will allow to select wheter defrag breaks or does not break COW on shared extents
    • tree-checker:
      • check leaf chunk item size, cross check against number of stripes
      • verify location keys for DIR_ITEM, DIR_INDEX and XATTR items
      • new self test for physical -> logical mapping code, used for super block range exclusion
  • Fixes:
    • fix missing hole after hole punching and fsync when using NO_HOLES
    • writeback: range cyclic mode could miss some dirty pages and lead to OOM
    • two more corner cases for metadata_uuid change after power loss during the change
    • fix infinite loop during fsync after mix of rename operations
  • see pull request

[edit] v5.5 (Jan 2020)

  • new block group profiles: RAID1 with 3- and 4- copies
    • RAID1 in btrfs has always 2 copies, now add support for 3 and 4
    • this is an incompat feature (named RAID1C34)
    • recommended use of RAID1C3 is replacement of RAID6 profile on metadata, this brings a more reliable resiliency against 2 device loss/damage
  • support for new checksums
    • per-filesystem, set at mkfs time
    • fast hash (crc32c successor): xxhash, 64bit digest
    • strong hashes (both 256bit): sha256 (slower, FIPS), blake2b (faster)
  • speed up lseek, don't take inode locks unnecessarily, this can speed up parallel SEEK_CUR/SEEK_SET/SEEK_END by 80%
  • send:
    • allow clone operations within the same file
    • limit maximum number of sent clone references to avoid slow backref walking
  • error message improvements: device scan prints process name and PID
  • new tree-checker sanity tests (INODE_ITEM, DIR_ITEM, DIR_INDEX, INODE_REF, XATTR)
  • more in the pull request

[edit] v5.4 (Nov 2019)

  • tree checker: adde sanity checks for tree items, extent items, and references
  • deprecated subvolume creation mode BTRFS_SUBVOL_CREATE_ASYNC
  • qgroup relation deletion tries harder, orphan entries are removed too
  • space handling improvements (ticket reservations, flushing, overcommit logic)
  • fix possible lockups during send of large subvolumes
  • see pull request

[edit] v5.3 (Sep 2019)

  • new features, hilights:
    • chunks that have been trimmed and unchanged since last mount are tracked and skipped on repeated trims
    • use hw assisted crc32c on more arches
    • the RAID56 incompat bit is automatically removed when the last block group of that type is removed
  • fixes
    • update ctime/mtime/iversion after hole punching
    • fsync fixes
    • send and balance can't be run at the same time
  • other
    • code refactoring, file splits
    • preparatory work for more checksums
    • tree checker to verify lengths of various items
    • delayed iput happens at unlink time, not in cleaner thread
    • new tracepoints for space updates
  • see pull request

[edit] v5.2 (Jul 2019)

  • user visible changes, hilights
    • better read time and write checks to catch errors early and before writing data to disk
    • qgroups + metadata relocation: last speed up patch in the series there should be no overhead comparing balance with and without qgroups
    • FIEMAP ioctl does not start a transaction unnecessarily
    • LOGICAL_INO (v1, v2) does not start transaction unnecessarily
    • fsync on files with many (but not too many) hardlinks is faster
    • send tries harder to find ranges to clone
    • trim/discard will skip unallocated chunks that haven't been touched since the last mount
    • tree-checker does more validations: device item, inode item, block group item:
    • improved space flushing logic for intense DIO vs buffered workloads
    • metadata reservations for delalloc reworked to better adapt in many-writers/low-space scenarios
  • fixes
    • send flushes delayed allocation before start
    • fix fallocate with qgroups accounting underflow
    • send and dedupe can't be run at the same time
    • fix crash in relocation/balance after resume
  • other
    • new tracepoints for locking
    • async write preallocates memory to avoid failures deep in call chains
    • lots of cleanups
  • see pull request

[edit] v5.1 (May 2019)

  • new features, hilights
    • zstd compression levels can be set as mount options
    • new ioctl to unregister scanned devices
    • scrub prints messages about start/stop/cancel to the log
  • other changes
    • qgroups skip some work (est. speedup during balance 20%)
    • reclaim vs GFP_KERNEL fixes
    • fsync fixes for rename/unlink/rmdir
    • improved enospc handling on a highly fragmented filesystem
    • no trim on filesystem with unreplayed log
  • see pull request

[edit] v5.0 (Mar 2019)

  • features, hilights
    • swapfile support (with some limitations)
    • metadata uuid - new feature that allows fast uuid change without rewriting all metadata blocks (backward incompatible)
    • balance messages in the syslog when operations start or stop
  • fixes
    • improved check of filesystem id associated with a device during scan to detect duplicate devices that could be mixed up during mount
    • fix device replace state transitions
    • fix a crash due to a race when quotas are enabled during snapshot creation
    • GFP_NOFS/memalloc_nofs_* fixes
    • fsync fixes
  • other
    • remove first phase of balance that tried to remove some space (not necessary)
    • separate reserve for delayed refs from global reserve
    • cleanups
  • see pull request

[edit] By version (linux kernel) 4.x

[edit] v4.20 (Dec 2018)

  • performance improvements
    • fewer wakeups and blocking during b-tree traversals, improved latencies and scalability
    • qgroups: 30+% run time improvement during balance, no accounting on unchanged subtrees (continued)
    • use a cached variant of rb-tree, speeds up traversal in some cases
  • fixes
    • trim
      • could miss some block groups, if logical offset was too high and did not fit the range
      • better error reporting, continue as far as possible
      • less interaction with transaction commit
    • fsync: fix log replay and O_TMPFILE warnings
    • qgroups: fix rescan that might misc some dirty groups
    • don't clean dirty pages during buffered writes, this could lead to lost updates in some corner cases
    • some block groups could have been delayed in creation, if the allocation triggered another one
    • error handling improvements
  • other cleanups and refactoring
  • pull request

[edit] v4.19 (Oct 2018)

  • hilights, no big changes in this releaase
    • allow defrag on opened read-only files that have rw permissions
    • tree checker improvements, reported by fuzzing
    • send, fix incorrect file layout after hole punching beyond eof
    • reset on-disk device stats value after replace
  • assorted fixes, cleanups and dead code removal
  • pull request

[edit] v4.18 (Aug 2018)

  • added support for the ioctl FS_IOC_FSGETXATTR, per-inode flags, successor of GET/SETFLAGS; now supports only existing flags: append, immutable, noatime, nodump, sync
  • 3 new unprivileged ioctls to allow users to enumerate subvolumes
  • dedupe syscall implementation does not restrict the range to 16MiB, though it still splits the whole range to 16MiB chunks
  • on user demand, rmdir() is able to delete an empty subvolume, export the capability in sysfs
  • fix inode number types in tracepoints, other cleanups
  • send: improved speed when dealing with a large removed directory, measurements show decrease from 2000 minutes to 2 minutes on a directory with 2 million entries
  • pre-commit check of superblock to detect a mysterious in-memory corruption
  • log message updates
  • pull request

[edit] v4.17 (Jun 2018)

  • mount options: new nossd_spread; subvolid will detect junk after the number and fail the mount
  • add message after cancelled device replace
  • direct module dependency on libcrc32, removed own crc wrappers
  • removed user space transaction ioctls
  • use lighter locking when reading /proc/self/mounts (RCU)
  • skip writeback of last page when truncating file to same size
  • send: do not issue unnecessary truncate operations
  • selftests: more tree block validation
  • fix fsync after hole punching when using no-holes feature
  • raid56:
    • make sure target is identical to source when raid56 rebuild fails after dev-replace
    • faster rebuild during scrub, batch by stripes and not block-by-block
    • make more use of cached data when rebuilding from a missing device
  • pull request

[edit] v4.16 (Apr 2018)

  • fallocate: implement zero range mode
  • avoid losing data raid profile when deleting a device
  • tree item checker: more checks for directory items and xattrs
  • raid56 recovery: don't use cached stripes, that could be potentially changed and a later RMW or recovery would lead to corruptions or failures
  • let raid56 try harder to rebuild damaged data, reading from all stripes if necessary
  • fix scrub to repair raid56 in a similar way as in the case above
  • cleanups: device freeing, removed some call indirections, redundant bio_put/_get, unused parameters, refactorings and renames
  • RCU list traversal fixups
  • simplify mount callchain, remove recursing back when mounting a subvolume
  • plug for fsync, may improve bio merging on multiple devices
  • compression heuristic: replace heap sort with radix sort, gains some performance
  • add extent map selftests, buffered write vs dio
  • see pull request

[edit] v4.15 (Jan 2018)

  • new features
    • extend mount options to specify zlib compression level, -o compress=zlib:9
    • v2 of ioctl "extent to inode mapping"
    • populate compression heuristics logic
    • enable indexing for btrfs as lower filesystem in overlayfs
    • speedup page cache readahead during send on large files
  • internal changes
    • more sanity checks of b-tree items when reading them from disk
    • more EINVAL/EUCLEAN fixups, missing BLK_STS_* conversion, other errno or error handling fixes
    • remove some homegrown IO-related logic, that's been obsoleted by core block layer changes (batching, plug/unplug, own counters)
    • add ref-verify, optional debugging feature to verify extent reference accounting
    • simplify code handling outstanding extents, make it more clear where and how the accounting is done
    • make delalloc reservations per-inode, simplify the code and make the logic more straightforward
    • extensive cleanup of delayed refs code
  • fix send ioctl on 32bit with 64bit kernel

[edit] v4.14 (Nov 2017)

  • added zstd compression
  • fine-grained check for degraded mount (verify raid constraints on chunk level, not device level)
  • userspace transaction ioctl has been deprecated, scheduled for removal in 4.17
  • foundation code for compression heuristics
  • mount option 'ssd' does not force block allocation alignments
  • fixes
    • potential raid repair and compression crash
    • prevent to set invalid default subvolid
    • resume qgroup rescan on rw remount
    • better reporting of detected checksum mismatches for DIO
    • compression for defrag vs per-file behaves as expected, respecting the requested value
    • possible deadlock with readdir and pagefault
    • emission of invalid clone operations in send
  • cleanups and refactoring

[edit] v4.13 (Sep 2017)

  • deprecated: mount option alloc_start
  • qgroups: new sysctl to allow temporary quota override with CAP_SYS_RESOURCE
  • statx syscall support
  • nowait AIO support
  • lots of cleanups around bio processing and error handling
  • memory allocation constraint cleanups and improvements
  • more sanity checks (for dir_item)
  • compression will be skipped if there's no improvement (at least one block)
  • fix invalid extent maps due to hole punching
  • fix: sgid not cleared when changing acls
  • some enospc corner case fixes
  • send fixes
  • other cleanups

[edit] v4.12 (Jul 2017)

  • new tracepoints: file item
  • fix qgoup accounting when inode_cache is in use
  • fix incorrect number report in stat::t_blocks under certain conditions
  • raid56 fixes:
    • enable auto-repair during read (ie. similar to what raid1 and raid10 do)
    • fix potential crash with concurrent scrub and dev-replace
    • fix potential crash when cancelling dev-replace
    • fix false reports during scrub when it's possible to do repair
    • fix wrong mirror report during repair
  • many cleanups

[edit] v4.11 (May 2017)

  • mostly a cleanup release
  • improved csum mismatch messages
  • move some qgroup work out of transaction commit
  • let unlink temporarily exceed quotas
  • fix truncate and lockless DIO writes
  • incremental send fixes
  • fix remount using ssd and nossd combinations

[edit] v4.10 (Feb 2017)

  • balance: human readable block group descripion in the log
  • balance: fix storing of stripes_min, stripes_max filters to the on-disk item
  • qgroup: fix accounting bug during concurrent balance run
  • better worker thread resource limit checks
  • fix ENOSPC during hole punching
  • fix ENOSPC when reflinking a heavily fragmented file
  • fix crash when certain tracepoints are enabled
  • fix compat ioctl calls on non-compat systems
  • improved delayed ref iteration performance
  • many cleanups

[edit] v4.9 (Dec 2016)

  • improved performance of extent sharing detection in FIEMAP
  • fixes:
    • device delete hang at the end of the operation
    • free space tree bitmap endianity fixed on big-endian machines
    • parallel incremental send and balance issue fixed
    • cloning ioctl can be interrupted by a fatal signal
  • other stability fixes or cleanups

[edit] v4.8 (Oct 2016)

  • space reservations and handling uses ticketed system, this should improve latency and fairness in case when there are several threads blocked on flushing
  • fixes of bugs triggered by fuzzed images
  • global ratelmit of all printed messages
  • several send, qgroup fixes
  • cleanups

[edit] v4.7 (Jul 2016)

  • allow balancing to dup with multi-device
  • device deletion by id (additionally to by path)
  • renameat2: add support for RENAME_EXCHANGE and RENAME_WHITEOUT
  • enhanced selftests
  • more preparatory work for "blocksize < page size"
  • more validation checks of superblock (discovered by fuzzing)
  • advertise which crc32c implementation is being used at module load
  • fixed space report by df with mixed block groups
  • log replay fixes
  • device replace fixes

[edit] v4.6 (May 2016)

  • mount options:
    • usebackuproot - replace 'recovery' (works but is deprecated)
    • logreplay, nologreplay - disable log replay at mount time, does no writes to the device
    • norecovery - synthetic option to disable recovery at mount time and disable writes (now does: nologreplay)
  • default inline limit is now 2048 (instead of page size, usually 4096)
  • /dev/btrfs-control now understands the GET_SUPPORTE_FEATURES ioctl
  • get rid of harmless message "could not find root %llu"
  • preparatory work for subpage-blocksize patchset
  • fix bug when using overlayfs
  • fixes in readahead, log replay, fsync, and more

[edit] v4.5 (Mar 2016)

  • free space cache v2: an incompat feature to track the free space cache as a b-tree
  • balance:
    • '-dconvert=dup' supported
    • continue but warn if metadata have lower redundancy than data
  • fixes:
    • trim does not overwrite bootloader area (introduced in 4.3, fixed in 4.4.x stable kernels)
  • assorted bugfixes, improvements or cleanups

[edit] v4.4 (Jan 2016)

  • send fixes: cloning, sending with parent
  • improved handling of framgented space using bitmaps
  • new mount option for debugging: fragment=data|metadata|all
  • updated balance filters: limit, stripes, usage
  • more bugfixes and cleanups

[edit] v4.3 (Nov 2015)

  • fix raid56 rebuild with missing device
  • discard ioctl will return the number of bytes
  • more bugfixes and cleanups

[edit] v4.2 (Aug 2015)

  • enhancements
    • transaction abort now reports the caller, not the helper function
    • INO_LOOKUP ioctl: unprivileged if used to just get the rootid (aka. subvolume id)
    • unified subvol= and subvolid= mounting, show the mounted subvol in mount options; also, /proc/self/mountinfo now always correctly shows the mounted subvolume
    • reworked internal qgroup logic
    • send: use received_uuid of parent during send
    • sysfs: preparatory works for exporting more stats about devices
    • deduplication on the same inode works
    • deduplication does not change mtime/ctime
  • fixes:
    • in send: cloning, renames, orphans,
    • few more ENOSPC fixes in case of block group creation/removal
    • fix hang during inode eviction due to concurrent readahead
    • EXTENT_SAME ioctl: handle unaligned length
    • more fixes around automatic block group removal
    • deadlock with EXTENT_SAME and readahead
    • for feature NO_HOLES: fsync, truncate

[edit] v4.1 (Jun 2015)

  • fixes
    • regression in chunk removal, conversion to raid1 possible again
    • log tree corruption fix with -o discard mount
    • bare xattr namespace attribute is not accepted
    • orphan cleanup is started for implicitly mounted default subvolume
    • send fixes
    • cloning within same file
    • EXTENT_SAME ioctl infinite loop fix
    • avoid more ENOSPC in delayed-iput context
    • a few ENOMEM fixes
    • automatic empty block group removal fixups
  • speedups
    • large file deletion: run delayed refs more often
    • large file deletion: don't build up too much work from crc
    • transaction commit latency improved
    • block group cache writeout
  • qgroup:
    • limits are shared upon snapshot
    • allow to remove qgroup which has parent but no child
    • fix status of qgroup consistency after rescan
    • fix quota status bits after dsiabling
    • mark qgroups inconsistent after assign/delete actions
  • code cleanups

[edit] v4.0 (Apr 2015)

  • file creation time is stored (no easy interface to read it yet)
  • fsync and log replay fixes
  • lots of cleanups and other fixes

[edit] By version (linux kernel) 3.x

[edit] v3.19 (Feb 2015)

  • raid56 supports scrub and device replace

[edit] v3.18 (Dec 2014)

[edit] v3.17 (Oct 2014)

  • fix for the infamous deadlock [1]
  • fixed longstanding bug in qgroups accounting after snapshot deletion [2]
  • updated (less inaccurate) df numbers [3]
  • speedup for rename and truncate, less strict flushes [4]
  • updated and fixes to the seeding feature

[edit] v3.16 (Aug 2014)

  • O_TMPFILE support [5]
  • reworked qgroup accounting, to fix negative numbers after subvol deletion
  • SEARCH_TREE ioctl v2, extended for retrieving more data [6]
  • new balance filter limit for more finegrained balancing [7]
  • ioctl FS_INFO and it's sysfs counterpart export information about nodesize, sectorsize and clone_alignment
  • snapshots are protected during send

[edit] v3.15 (Jun 2014)

  • pile of send fixes (stability, speed)
  • worker threads now use kernel workqueues

[edit] v3.14 (Mar 2014)

  • optional incompat disk format improvement aiming at speedup, removing file hole representation, named no-holes
  • ioctl to query/change feature bits (e.g. switching on extended refs on-line now possible)
  • export filesystem info through sysfs: features, allocation profiles
  • added pairing mount options (for remount)
  • heap of small performance optimizations
  • snapshot-aware defrag was disabled due to problems

[edit] v3.13 (Jan 2014)

  • fiemap exports information about shared extents
  • bugfix and stability foucsed release

[edit] v3.12 (Nov 2013)

  • Major performance improvement for send/receive with large numbers of subvolumes
  • Support for batch deduplication (userspace tools required)
  • new mount option commit to set the commit interval
  • Lots of stability and bugfix patches

[edit] v3.11 (Sep 2013)

  • extent cloning within one file
  • ioctl to wait for quota rescan completion
  • device deletion returns error code to userspace (not in syslog anymore)
  • usual load of small fixes and improvements

[edit] v3.10 (Jun 2013)

  • reduced size of metadata by so-called skinny extents [8]
  • enhanced syslog message format [9]
  • the mount option subvolrootid is deprecated
  • lots of stability improvements, removed many BUG_ONs
  • qgroups are automatically created when quotas are enabled [10]
  • qgroups are able to rescan current filesystem and sync the quota state with the existing subvolumes
  • enhanced send/recv format for multiplexing more data into one stream [11]
  • various unsorted code cleanups, minor performance updates

[edit] v3.9 (Apr 2013)

  • preliminary Raid 5/6 support (details in the announcement)
  • snapshot-aware defrag
  • a mode of send to avoid transferring file data
  • direct IO speedup (numbers)
  • new ioctls to set/get filesystem label
  • defrag is cancellable

[edit] v3.8 (Feb 2013)

  • ability to replace devices at runtime in an effective way (description)
  • speed improvements (cumulative effect of many small improvements)
  • a few more bugfixes

[edit] v3.7 (Dec 2012)

  • fsync speedups
  • removed limitation of number of hardlinks in a single directory
  • file hole punching (LWN article)
  • per-file NOCOW
  • fixes to send/receive

[edit] v3.6 (Sep 2012)

  • subvolume-aware quotas (qgroups)
  • support for send/receive between snapshot changes (LWN article)
  • atime is not updated on read-only snapshots (LWN article)
  • allowed cross-subvolume file clone (aka. reflink)
  • remount with no compression possible
  • new ioctl to read device readiness status
  • speed improvement for concurrent multithreaded reads

[edit] v3.5 (Jun 2012)

  • collect device statistics (read/write failures, checksum errors, corrupted blocks)
  • integrity checker (3.3+) supports bigblocks (3.4+)
  • more friendly NFS support (native i_version)
  • thread_pool mount option tunable via remount
  • fsync speed improvements
  • several fixes related to read-only mounts
  • scrub thread priority lowered to idle
  • preparatory works for 3.6 features (tree_mod_log)

[edit] v3.4 (May 2012)

  • Allow metadata blocks larger than the page size (4K). This allows metadata blocks up to 64KB in size. In practice 16K and 32K seem to work best. For workloads with lots of metadata, this cuts down the size of the extent allocation tree dramatically and fragments much less. (Chris Mason)
  • Improved error handling (IO errors). This gives Btrfs the ability to abort transactions and go read-only on errors other than internal logic errors and ENOMEM more gracefully instead of crashing. (Jeff Mahoney)
  • Reworked the way in which metadata interacts with the page cache. page->private now points to the btrfs extent_buffer object, which makes everything faster. The code was changed so it now writes a whole extent buffer at a time instead of allowing individual pages to go down. It is now more aggressive about dropping pages for metadata blocks that were freed due to COW. Overall, metadata caching is much faster now. (Josef Bacik)

[edit] v3.3 (Mar 2012)

  • restriper - infrastructure to change btrfs raid profiles on the fly via balance
  • optional integrity checker infrastructure (details)
  • fixed a few corner cases where TRIM did not process some blocks
  • cluster allocator improvements (less fragmentation, some speedups)

[edit] v3.2 (Jan 2012)

  • Log of past roots to aid recovery (option recovery)
  • Subvolumes mountable by full path
  • Added nospace_cache option
  • Lots of space accounting fixes
  • Improved scrub performance thanks to new read-ahead infrastructure
  • Scrub prints paths of corrupted files
  • ioctl for resolving logical->inode and inode->path
  • Integrated raid-repair (if possible)
  • Data corruption fix for parallel snapshot creation
  • Write barriers for multiple devices were fixed to be more resistant in case of power failure

[edit] v3.1 (Oct 2011)

  • Stability fixes (lots of them, really), notably fixing early ENOSPC, improved handling of a few error paths and corner cases, fix for the crash during log replay.

[edit] v3.0 (Jul 2011)

  • Filesystem scrub
  • Auto-defragmentation (autodefrag mount option)
  • Improved block allocator
  • Sped up file creation/deletion by delayed operation

[edit] By version (linux kernel) 2.6.x

[edit] v2.6.39 (May 2011)

Per-file compression and NOCOW control. Support for bulk TRIM on SSDs.

[edit] v2.6.38 (March 2011)

Added LZO compression method, FIEMAP bugfixes with delalloc, subvol flags get/set ioctl, allow compression during defrag.

[edit] v2.6.37 (January 2011)

On-disk free space cache, asynchronous snapshots, unprivileged subvolume deletion, extent buffer switches from a rbtree with spinlocks to a radix tree with RCU. (Explanations of these features are described in this article [registration needed]).

[edit] v2.6.35 (August 2010)

Direct I/O support and -ENOSPC handling of volume management operations, completing the -ENOSPC support.

[edit] v2.6.34 (May 2010)

Support for changing the default subvolume, a new userspace tool (btrfs), an ioctl that lists all subvolumes, an ioctl to allow improved df math, and other improvements.

[edit] v2.6.33 (February 2010)

Some minor -ENOSPC improvements.

[edit] v2.6.32 (December 2009)

[edit] -ENOSPC

Btrfs has not had serious -ENOSPC ("no space") handling, the COW oriented design makes handling such situations more difficult than filesystems that just rewrite the blocks. In this release Josef Bacik (Red Hat) has added the necessary infrastructure to fix that problem. Note: The filesystem may run out of space and still show some free space. That space comes from a data/metadata chunk that can't get filled because there's not space left to create its metadata/data counterpart chunk. This is unrelated to the -ENOSPC handling and will be fixed in the future. Code: (commit)

[edit] Proper snapshot and subvolume deletion

In the last btrfs-progs version you have options that allow to delete snapshots and subvolumes without having to use rm. This is much faster because it does the deletion via btree walking. It's also now possible to rename snapshots and subvols. Work done by Yan Zheng (Oracle). Code: (commit 1), 2)

[edit] Performance improvements

Streaming writes on very fast hardware were previously CPU bound at around 400MB/s. Chris Mason (Oracle) has improved the code so that now it can push over 1GB/s while using the same CPU as XFS (factoring out checksums). There are also improvements for writing large portions of extents, and other workloads. Multidevice setups are also much faster due to the per-BDI writeback changes. The performance of fsync() was greatly improved, which fixed a severe slowdown while using yum in Fedora 11.

[edit] Support for "discard" operation on SSD devices

"Discard" support is a way to telling SSD devices which blocks are free so that the underlying firmware knows that it's safe to do some optimizations (commit), (commit)

[edit] v0.19 (June 2009)

v0.19 is a forward rolling format change, which means that it can read the v0.18 disk format but older kernels and older btrfs-progs code will not be able to read filesystems created with v0.19. The new code changes the way that extent back references are recorded, making them significantly more efficient. In general, v0.19 is a dramatic speed improvement over v0.18 in almost every workload.

The v0.19 utilities are meant for use with kernels 2.6.31-rc1 and higher. Git trees are available with the new format code for 2.6.30 kernels, please see the download section for details.

If you do not wish to roll forward to the new disk format, use the v0.18 utilities.

[edit] v0.18 (January 2009)

v0.18 has the same disk format as 0.17, but a bug was found in the ioctl interface shared between 32 bit and 64 bit programs. This was fixed by changing the ioctl interface. Anyone using 2.6.29-rc2 will need to update to v0.18 of the btrfs progs.

There is no need to reformat though, the disk format is still compatible.

[edit] v0.17 (January 2009)

[edit] Btrfs is now in 2.6.29-rc1!

v0.17 has a new disk format since v0.16. Future releases will try to maintain backwards compatibility with this new format.

[edit] Compression

Transparent zlib compression of file data is enabled by mount -o compress.

[edit] Improved block allocation routines (Josef Bacik)

Many performance problems in the allocator are addressed in this release

[edit] Improved block sharing while moving extents (Yan Zheng)

The btrfs-vol commands to add, remove and balance space across devices triggers a COW of metadata and data blocks. This release is much better at maintaining shared blocks between snapshots when that COW happens.

[edit] Seed Device support

It is now possible to create a filesystem to seed other Btrfs filesystems. The original filesystem and devices are included as a readonly starting point to the new FS. All modifications go onto different devices and the COW machinery makes sure the original is unchanged.

[edit] Many bug fixes and performance improvements

[edit] v0.16 (August 2008)

v0.16 does change the disk format from v0.15, and it includes a long list of performance and stability updates.

[edit] Fine grained Btree locking

Locking is now done in a top down fashion while searching the btree, and higher level locks are freed when they are no longer required. Extent allocations still have a coarse grained lock, but that will be improved in the next release.

[edit] Improved data=ordered

Ordered data mode loosely means any system that prevents garbage or stale data blocks after a crash. It was previously implemented the same way ext3 does it, which is to force pending data writes down before a transaction commits.

The data=ordered code was changed to only modify metadata in the btree after data extents are fully written on disk. This allows a transaction commit to proceed without waiting for all the data writes on the FS to finish.

A single fsync or synchronous write no longer forces all the dirty data on the FS to disk, as it does in ext3 and reiserfsv3.

Although it is not implemented yet, the new data=ordered code would allow atomic writes of almost any size to a single file to be exported to userland.

[edit] ACL support (Josef Bacik)

ACLs are implemented and enabled by default.

[edit] Lost file prevention (Josef Bacik)

The VFS and posix APIs force filesystems allow files to be unlinked from a directory before they are deleted from the FS. If the system crashes between the unlink and the deletion, the file is still consuming space on disk, but not listed in any directory.

Btrfs now tracks these files and makes sure they are reclaimed if the system crashes before they are fully deleted.

[edit] New directory index format (Josef Bacik)

Btrfs indexes directories in two ways. The first index allows fast name lookups, and the second is optimized to return inodes in something close to disk order for readdir. The second index is an important part of good performance for full filesystem backups.

A per-directory sequence number is now used for the second index, removing some worst case conditions around files that are hard linked into the same directory many times.

[edit] Faster unmount times (Yan Zheng)

Btrfs waits for old transactions to be completely removed from the FS before unmount finishes. A new reference count cache was added to make this much less IO intensive, improving FS performance in all workloads.

[edit] Improved streaming reads and writes

The new data=ordered code makes streaming writes much faster. Streaming reads are improved by tuning the thread pools used to process data checksums after the read is done. On machines with sufficient CPU power to keep up with the disks, data checksumming is able to run as fast as nodatasum mounts.

[edit] v0.15 (May 29, 2008)

  • Metadata back references
  • Online growing and shrinking
  • Conversion program from Ext3
  • data=ordered support
  • COW-free data writes.
  • focus on stability fixes for the multiple device code

[edit] v0.14 (April 30, 2008)

  • Support for multiple devices
  • raid0, raid1 and raid10, single spindle metadata duplication

[edit] v0.13 and older

  • Copy on write FS
  • Checksumming
  • Transactions
  • Snapshotting
  • Subvolumes
Personal tools