CHANGES

   1 btrfs-progs-4.8.3 (2016-11-11)
   2   * check:
   3     * support for clearing space cache (v1)
   4     * size reduction of inode backref structure
   5   * send:
   6     * fix handling of multiple snapshots (-p and -c options)
   7     * transfer buffer increased (should reduce number of context switches)
   8     * reuse existing file for output (-f), eg. when root cannot create files (NFS)
   9   * dump-tree:
  10     * print missing items for various structures
  11     * new: dev stats, balance status item
  12     * sync key names with kernel (the persistent items)
  13   * subvol show: now able to print the toplevel subvolume -- the creation time
  14     might be wrong though
  15   * mkfs:
  16     * store the creation time of toplevel root inode
  17     * print UUID in the summary
  18   * build: travis CI for devel
  19   * other:
  20     * lots of cleanups and refactoring
  21     * switched to on-stack path structure
  22     * fixes from coverity, asan, ubsan
  23     * new tests
  24     * updates in testing infrastructure
  25     * fixed convert test 005
  26
  27 btrfs-progs-4.8.2 (2016-10-26)
  28   * convert: also convert file attributes
  29   * convert: fix wrong tree block alignment for unalianged block group
  30   * check: quota verify fixes, handle reloc tree
  31   * build: add stub for FIEMAP_EXTENT_SHARED, compiles on ancient kernels
  32   * build: add stub for BUILD_ASSERT when ioctl.h is included
  33   * dump-tree: don't crash on unrecognized tree id for -t
  34   * tests:
  35     * add more ioctl tests
  36     * convert: more symlink tests, attribute tests
  37     * quota verify for reloc tree
  38   * other cleanups
  39
  40 btrfs-progs-4.8.1 (2016-10-12)
  41   * 32bit builds fixed
  42   * build without backtrace support fixed
  43
  44 btrfs-progs-4.8 (2016-10-05)
  45   * error handling improvements all over the place
  46   * new fuzzed images, test updates
  47   * doc fixups
  48   * minor cleanups and improvements
  49   * kernel library helpers moved to own directory
  50   * qgroup: fix regression leading to incorrect status after check,
  51     introduced in 4.7
  52
  53 btrfs-progs-4.7.3 (2016-09-21)
  54   * fixed free space tree compat status
  55   * check: low-mem mode: handle partially dropped snapshots
  56   * dump-super: consolidate options for superblock copy
  57   * tree-stats: check mount status
  58   * subvol delete: handle verbosity option
  59   * defrag: print correct error string
  60   * mkfs: fix reading rotational status
  61   * other:
  62     * UBSAN build option
  63     * documentation updates
  64     * enhanced tests: convert, fuzzed images, more tools to run on fuzzed
  65       images
  66
  67 btrfs-progs-4.7.2 (2016-09-05)
  68   * check:
  69     * urgent fix: false report of backref mismatches; do not --repair
  70       last unaffected version 4.6.1 (code reverted to that state)
  71   * fuzzing and fixes
  72     * added more sanity checks for various structures
  73     * testing images added
  74   * build: udev compatibility: do not install .rules on version < 190
  75   * other:
  76     * dump-super: do not crash on garbage value in csum_type
  77     * minor improvements in messages and help strings
  78   * documentation:
  79     * filesystem features
  80
  81 btrfs-progs-4.7.1 (2016-08-25)
  82   * check:
  83     * new optional mode: optimized for low memory usage (memory/io tradeoff)
  84     * --mode=lowmem, not default, still considered experimental
  85     * does not work with --repair yet
  86   * convert: regression fix, ext2_subvol/image rw permissions
  87   * mkfs/convert:
  88     * two-staged creation, partially created filesystem will not be recognized
  89     * improved error handling (fewer BUG_ONs)
  90   * convert: preparation for more filesystems to convert from
  91   * documentation updates: quota, qgroup
  92   * other
  93     * message updates
  94     * more tests
  95     * more build options, enhanced debugging
  96
  97 btrfs-progs-4.7 (2016-07-29)
  98   * convert: fix creating discontig extents
  99   * check: speed up traversing heavily reflinked extents within a file
 100   * check: verify qgroups of higher levels
 101   * check: repair can now fix wrong qgroup numbers
 102   * balance: new option to run in the background
 103   * defrag: default extent target size changed to 32MiB
 104   * du: silently skip non-btrfs dirs/files
 105   * documentation updates: btrfs(5), btrfs(8), balance, subvolume, scrub,
 106     filesystem, convert
 107   * bugfixes:
 108     * unaligned access (reported for sparc64) in raid56 parity calculations
 109     * use /bin/bash
 110     * other stability fixes and cleanups
 111   * more tests
 112
 113 btrfs-progs-4.6.1 (2016-06-24)
 114   * fi resize: negative resize argument accepted again
 115   * qgroup rescan: fix skipping when rescan is in progress
 116   * mkfs: initialize stripesize to correct value
 117   * testsuite updates, mostly convert tests
 118   * documentation updates
 119     * btrfs-device, btrfs-restore manual pages enhanced
 120     * misc fixups
 121
 122 btrfs-progs-4.6 (2016-06-10)
 123   * convert - major rewrite:
 124     * fix a long-standing bug that led to mixing data blocks into metadata block
 125       groups
 126     * the workaround was to do full balance after conversion, which was
 127       recommended practice anyway
 128     * explicitly set the lowest supported version of e2fstools to 1.41
 129   * provide and install udev rules file that addresses problems with device
 130     mapper devices, renames after removal
 131   * send: new option: quiet
 132   * dev usage: report slack space (device size minus filesystem area on the dev)
 133   * image: support DUP
 134   * build: short options to enable debugging builds
 135   * other:
 136     * code cleanups
 137     * build fixes
 138     * more tests and other enhancements
 139
 140 btrfs-progs-4.5.3 (2016-05-11)
 141   * ioctl: fix unaligned access in buffer from TREE_SEARCH; might cause SIGBUS
 142     on architectures that do not support unaligned access and do not performa
 143     any fixups
 144   * improved validation checks of superblock and chunk-related structures
 145   * subvolume sync: fix handling of -s option
 146   * balance: adjust timing of safety delay countdown with --full-balance
 147   * rescue super-recover: fix reversed condition check
 148   * check: fix bytes_used accounting
 149   * documentation updates: mount options, scrub, send, receive, select-super,
 150     check, mkfs
 151   * testing: new fuzzed images, for superblock and chunks
 152
 153 btrfs-progs-4.5.2 (2016-05-02)
 154   * new/moved command: btrfs-calc-stats -> btrfs inspect tree-stats
 155   * check: fix false alert for metadata blocks crossing stripe boundary
 156   * check: catch when qgroup numbers mismatch
 157   * check: detect running quota rescan and report mismatches
 158   * balance start: add safety delay before doing a full balance
 159   * fi sync: is now silent
 160   * fi show: don't miss filesystems with partially matching uuids
 161   * dev ready: accept only one argument for device
 162   * dev stats: print "devid:N" for a missing device instead of "(null)"
 163   * other:
 164     * lowest supported version of e2fsprogs is 1.41
 165     * minor cleanups, test updates
 166
 167 btrfs-progs-4.5.1 (2016-03-31)
 168   * mkfs: allow DUP on multi-device filesystems
 169   * bugfixes: build fixes, assorted other fixes
 170
 171 btrfs-progs-4.5 (2016-03-20)
 172   New/moved commands:
 173     * btrfs-show-super -> btrfs inspect-internal dump-super
 174     * btrfs-debug-tree -> btrfs inspect-internal dump-tree
 175
 176   New commands:
 177     * btrfs fi du - calculate disk usage, including shared extents
 178
 179   Enhancements:
 180     * device delete - delete by id (needs kernel support, not merged to
 181       4.6)
 182     * check - new option to specify chunk root
 183     * debug-tree/dump-tree - option -t understands human readable name of
 184       the tree (along numerical ids)
 185     * btrfs-debugfs - can dump block group information
 186
 187   Bugfixes:
 188     * all commands should accept the option separator "--"
 189     * several fixes in device scan
 190     * restore works on filesystems with sectorsize > 4k
 191     * debug-tree/dump-tree - print compression type as string
 192     * subvol sync: fix crash, memory corruption
 193     * argument parsing fixes: subvol get-default, qgroup create/destroy/
 194       assign, inspect subvolid-resolve
 195     * check for block device or regular file in several commands
 196
 197   Other:
 198     * documentation updates
 199     * manual pages for the moved tools now point to btrfs-filesystem
 200     * testsuite updates
 201
 202 btrfs-progs-4.4.1 (2016-02-26)
 203   * find-root: don't skip the first chunk
 204   * free-space-tree compat bits fix
 205   * build: target symlinks
 206   * documentation updates
 207   * test updates
 208
 209 btrfs-progs-4.4 (2016-01-18)
 210   User visible changes:
 211     * mkfs.btrfs --data dup
 212
 213   People asked about duplicating data on a single device for a long time. There
 214   are no technical obstacles preventing that, so it got enabled with a warning
 215   about potential dangers when the device will not do the duplicated copies. See
 216   mkfs.btrfs section DUP PROFILES ON A SINGLE DEVICE.
 217
 218     * support balance filters added/enhanced in linux 4.4
 219       * usage=min..max -- enhanced to take range
 220       * stripes=min..max -- new, filter by stripes for raid0/10/5/6
 221       * limit=min..max -- enhanced to take range
 222   Note: due to backward compatibility, the range maximum for 'usage' is not
 223   inclusive as for the others, to keep the same behaviour as usage=N .
 224
 225     * manual pages enhanced (btrfs, mkfs, mount, filesystem, balance)
 226     * error messages updates, rewordings -- some fstests may break due to that
 227     * added support for free-space-tree implementation of space cache -- this
 228       requires kernel 4.5 and is not recommended for non-developers yet
 229     * btrfs filesystem usage works with mixed blockgroups
 230
 231   Other:
 232     * installation to /usr/local -- this has unintentionally changed during
 233       conversion to autotools in 3.19
 234     * check: fix a false alert where extent record has wrong metadata flag
 235     * improved stability on fuzzed/crafted images when reading sys array in
 236       superblock
 237     * build: the 'ar' tool is properly detected during cross-compilation
 238     * debug-tree: option -t understands ids for tree root and chunk tree
 239     * preparatory work for btrfs-convert rewrite
 240     * sparse, gcc warning fixes
 241     * more memory allocation failure handling
 242     * cleanups
 243     * more tests
 244
 245   Bugfixes:
 246     * chunk recovery: fix floating point exception
 247     * chunk recovery: endianity bugfix during rebuild
 248     * mkfs with 64K pages and nodesize reported superblock checksum mismatch
 249     * check: properly reset nlink of multi-linked file
 250
 251 btrfs-progs-4.3.1 (2015-11-16)
 252   * fixes
 253     * device delete: recognize 'missing' again
 254     * mkfs: long names are not trimmed when doing ssd check
 255     * support partitioned loop devices
 256   * other
 257     * replace several mallocs with on-stack variables
 258     * more memory allocation failure handling
 259     * add tests for bugs fixed
 260     * cmd-device: switch to new message printing helpers
 261     * minor code cleanups
 262
 263 btrfs-progs-4.3 (2015-11-06)
 264   * mkfs
 265     * mixed mode is not forced for filesystems smaller than 1GiB
 266     * mixed mode broken with mismatching sectorsize and nodesize, fixed
 267     * print version info earlier
 268     * print devices sorted by id
 269     * do not truncate target image with --rootsize
 270   * fi usage:
 271     * don't print global block reserve
 272     * print device id
 273     * minor output tuning
 274     * other cleanups
 275   * calc-size:
 276     * div-by-zero fix on an empty filesystem
 277     * fix crash
 278   * bugfixes:
 279     * more superblock sanity checks
 280     * consistently round size of all devices down to sectorsize
 281     * misc leak fixes
 282     * convert: don't try to rollback with a half-deleted ext2_saved
 283       subvolume
 284   * other:
 285     * check: add progress indicator
 286     * scrub: enhanced error message
 287     * show-super: read superblock from a given offset
 288     * add README
 289     * docs: update manual page for mkfs.btrfs, btrfstune, balance,
 290       convert and inspect-internal
 291     * build: optional build with more warnings (W=...)
 292     * build: better support for static checkers
 293     * build: html output of documentation
 294     * pretty-print: last_snapshot for root_item
 295     * pretty-print: stripe dev uuid
 296     * error reporting wrappers, introduced and example use
 297     * refactor open_file_or_dir
 298     * other docs and help updates
 299   * testing:
 300     * test for nodes crossing stripes
 301     * test for broken 'subvolume sync'
 302     * basic tests for mkfs, raid option combinations
 303     * basic tests for fuzzed images (check)
 304     * command intrumentation (eg valgrind)
 305     * print commands if requested
 306     * add README for tests
 307
 308 btrfs-progs-4.2.3 (2015-10-19)
 309   * subvol sync: make it actually work again: it's been broken since 4.1.2,
 310     due to a reversed condition it returned immediately instead of waiting
 311   * scanning: do not scan already discovered filesystems (minor optimization)
 312   * convert: better error message in case the filesystem is not finalized
 313   * restore: off-by-one symlink path check fix
 314
 315 btrfs-progs-4.2.2 (2015-10-05)
 316   * fi label: use fallback if the label ioctl is not available
 317   * convert: check nodesize constraints against commandline features (-O)
 318   * scrub: report status 'running' until all devices are finished
 319   * device scanning might crash in some scenarios
 320   * fi usage: print summary for non-root users
 321
 322 btrfs-progs-4.2.1 (2015-09-20)
 323   * fix an off-by-one error in cross-stripe boundary check
 324     * if nodesize was 64k, any metadata block was reported as crossing,
 325       this leads to mkfs failure for example due to "no free blocks
 326       found"
 327     * for other nodesizes, if the end of the metadata block was 64k
 328       aligned, it was incorrectly reported by fsck
 329   * convert: don't write uninitialized data to image
 330   * image:
 331     * don't loop with option -t0
 332     * don't create threads if compression is not requested
 333   * other: minor cleanups
 334
 335 btrfs-progs-4.2 (2015-09-03)
 336   * enhancements:
 337     * mkfs: do not create extra single chunks on multiple devices
 338     * resize: try to guess the minimal size, 'inspect min-dev-size'
 339     * qgroup assign: add option to schedule rescan
 340     * chunk-recover: be more verbose about the scanning process
 341   * fixes:
 342     * check:
 343         * find stripes crossing stripe boundary -- created by convert
 344         * print correct range for file hole when there are no extents
 345           and learn how to fix it
 346     * replace: more sanity checks
 347     * convert: concurrency fixes related to reporting progress
 348     * find-root: option -a will not skip the current root anymore
 349     * subvol list: fix occasional crash
 350     * do not create stripes crossing stripe boundary
 351   * build:
 352     * fixes for musl libc
 353     * preliminary support for android (not working yet, more code changes
 354       needed)
 355     * new EXTRA_CFLAGS and EXTRA_LDFLAGS
 356   * other:
 357     * lots of cleanups
 358     * tests: lots of updates, new tests, framework improvements
 359     * documentation updates
 360     * debugging: print-tree shows stripe length
 361
 362 btrfs-progs-4.1.2 (2015-07-14)
 363   * urgent bugfix: mkfs creates invalid filesystem, must be recreated
 364
 365 btrfs-progs-4.1.1 (2015-07-10) -- Do not use this version!
 366   Bugfixes:
 367     * defrag: threshold overflow fix
 368     * fsck:
 369       * check if items fit into the leaf space
 370       * fix wrong nbytes
 371     * mkfs:
 372       * create only desired block groups for single device
 373       * preparatory work for fix on multiple devices
 374   Enhancements:
 375     * new alias for 'device delete': 'device remove'
 376   Other:
 377     * fix compilation on old gcc (4.3)
 378     * documentation updates
 379     * debug-tree: print nbytes
 380     * test: image for corrupted nbytes
 381     * corrupt-block: let it kill nbytes
 382
 383 btrfs-progs-4.1 (2015-06-22)
 384   Bugfixes:
 385     * fsck.btrfs: no bash-isms
 386     * bugzilla 97171: invalid memory access (with tests)
 387     * receive:
 388       * cloning works with --chroot
 389       * capabilities not lost
 390     * mkfs: do not try to register bare file images
 391     * option --help accepted by the standalone utilities
 392
 393   Enhancements:
 394     * corrupt block: ability to remove csums
 395     * mkfs:
 396       * warn if metadata redundancy is lower than for data
 397       * options to make the output quiet (only errors)
 398       * mixed case names of raid profiles accepted
 399       * rework the output:
 400       * more comprehensive, 'key: value' format
 401     * subvol:
 402       * show:
 403         * print received uuid
 404         * update the output
 405         * new options to specify size units
 406       * sync: grab all deleted ids and print them as they're removed,
 407         previous implementation only checked if there are any to be
 408         deleted - change in command semantics
 409     * scrub: print timestamps in days HMS format
 410     * receive:
 411       * can specify mount point, do not rely on /proc
 412       * can work inside subvolumes
 413     * send: new option to send stream without data (NO_FILE_DATA)
 414     * convert: specify incompat features on the new fs
 415     * qgroup:
 416       * show: distinguish no limits and 0 limit value
 417       * limit: ability to clear the limit
 418     * help for 'btrfs' is shorter, 1st level command overview
 419     * debug tree: print key names according to their C name
 420
 421   New:
 422     * rescue zero-log
 423     * btrfsune:
 424       * rewrite uuid on a filesystem image
 425       * new option to turn on NO_HOLES incompat feature
 426
 427   Deprecated:
 428     * standalone btrfs-zero-log
 429
 430   Other:
 431     * testing framework updates
 432       * uuid rewrite test
 433       * btrfstune feature setting test
 434       * zero-log tests
 435       * more testing image formats
 436     * manual page updates
 437     * ioctl.h synced with current kernel uapi version
 438     * convert: preparatory works for more filesystems (reiserfs pending)
 439     * use static buffers for path handling where possible
 440     * add new helpers for send uilts that check memory allocations,
 441       switch all users, deprecate old helpers
 442     * Makefile: fix build dependency generation
 443     * map-logical: make it work again
 444
 445 btrfs-progs-4.0.1 (2015-05-20)
 446   * restore:
 447     * can restore symlinks, new option --symlinks
 448     * long option variants added
 449   * convert: dropped dependency on acl.h header and libacl is not required
 450     for build
 451   * fix for 'check' crash
 452   * device remove error message fix
 453   * preparatory works for fsid change
 454
 455 btrfs-progs-4.0 (2015-04-29)
 456   * resize:
 457     * don't accept file as an argument (it's confusing)
 458     * print better error message in case of an error
 459   * restore: optionally restore metadata (time, mode, uid/gid)
 460   * receive: optionally enforce chroot
 461   * new rescue subcommand 'zero-log', same as btrfs-zero-log, but now also
 462     part of the main utility
 463   * check:
 464     * free space checks match kernel, fixes incorrect reports
 465   * convert: fix setting of checksum bit if --no-datasum is used
 466   * fsck.btrfs: don't print messages
 467   * fix quota rescan on PPC64 (mangled ioctl number)
 468   * test updates
 469   * documentation: files renamed to .asciidoc, misc fixups
 470
 471 btrfs-progs-3.19.1 (2015-03-25)
 472   * convert:
 473     * new option to specify metadata block size
 474     * --no-progress actually works
 475   * restore: properly handle the page boundary corner case
 476   * build fixes:
 477     * missing macro from public header, BTRFS_BUILD_VERSION
 478     * wrong handling of --enable-convert
 479   * fi usage: reports correct space for degraded mounts
 480   * other:
 481     * mkfs: help string updates
 482     * completion: added 'usage' subcommands
 483     * cleanups in qgroup code, preparatory work
 484
 485 btrfs-progs-3.19 (2015-03-11)
 486   * build converted to autotools
 487   * btrfs-image
 488     * restore can now run in parallel threads
 489     * fixed restore of multiple image from multiple devices onto a single
 490       dev
 491     * introduced metadump v2
 492   * check: make --init-csum-tree and --init-extent-tree work together
 493   * find-new: option to search through all metadata even if a root was
 494     already found
 495   * convert: show progress by default, can be turned off
 496   * corrupt-block: option to work on a specific root
 497   * bash completion script for all subcommands
 498
 499 btrfs-progs-3.18.2 (2015-01-27)
 500   * qgroup show: print human readable sizes, options to say otherwise
 501   * check: new option to explicitly say no to writes
 502   * mkfs: message about trimming is not printed to stderr
 503   * fi show: fixed return value
 504   * tests: new infrastructure
 505   * btrfstune: force flag can be used together with seeding option
 506   * backtrace support is back
 507   * getopt cleanups
 508   * doc and help updates
 509
 510 btrfs-progs-3.18.1 (2015-01-09)
 511   * minor fixes
 512   * documentation updates
 513
 514 btrfs-progs-3.18 (2014-12-30)
 515   * mkfs - skinny-metadata feature is now on by default, first introduced in
 516     kernel 3.10
 517   * filesystem usage - give an overview of fs usage in a way that's more
 518     comprehensible than existing 'fi df'
 519   * device usage - more detailed information about per-device allocations
 520   * check
 521     * option to set a different tree root byte number
 522     * ability to link lost files to lost+found, caused by a recent kernel
 523       bug
 524     * repair of severely corrupted fs (use with care)
 525   * convert - option to show progress
 526   * subvol create - print the commit mode inline, print the global mode only
 527     if --verbose
 528   * other updates: musl-libc support, coverity bugfixes, new test images,
 529     documentation
 530
 531 btrfs-progs-3.17.3 (2014-12-04)
 532   * convert: fix conversion of sparse ext* filesystems
 533   * show: resolve to the correct path
 534   * fsck: more verbose error for root dir problems
 535
 536 btrfs-progs-3.17.2 (2014-11-19)
 537   * check improvements
 538     * add ability to replace missing dir item/dir indexes
 539     * fix missing inode items
 540     * create missing root dirid
 541   * corrupt block: enhancements for testing fsck
 542   * zero-log: able to reset a fs with bogus log tree pointer (bug_72151)
 543
 544 btrfs-progs-3.17.1 (2014-11-04)
 545   * fi df: argument handling
 546   * fix linking with libbtrfs
 547   * replace: better error reporting
 548   * fi show: fixed stall if run concurrently with balance
 549   * check: fixed argument parsing for --subvol-extents
 550   * fi df: SI prefixes corrected
 551
 552 btrfs-progs-3.17 (2014-10-17)
 553   * check: --init-csum-tree actually does something useful, rebuilds the
 554     whole csum tree
 555   * /dev scanning for btrfs devices is gone
 556   * /proc/partitions scanning is gone, blkid is used exclusively
 557   * new subcommand subvolume sync
 558   * filesystem df: new options to set unit format
 559   * convert: allow to copy label from the origin, or specify a new one
 560
 561 btrfs-progs-3.16.2 (2014-10-01)
 562   * a few fixes in fsck and image tools
 563
 564 btrfs-progs-3.16.1 (2014-09-15)
 565   * print GlobalReserve in fi df output
 566   * new option -R in subvol list
 567   * library version defines
 568   * static build is fixed
 569   * build without documentation is possible
 570
 571 btrfs-progs-3.16 (2014-08-26)
 572   * mkfs: new option to specify UUID, drop experimental notice
 573   * check: new option to verify quotas, reduced memory requirements, new
 574     option to print extent sharing
 575   * restore: check length before decompression, more error handling, option
 576     to loop during restoring
 577   * balance: new filter 'limit'
 578   * recover: allow to read all sb copies
 579   * btrfstune: new option to force dangerous changes
 580   * receive: new option to limit number of errors
 581   * show-super: skip unrecognized sb, add option to force
 582   * debug-tree: print tree by id
 583   * documentation updates
 584
 585 btrfs-progs-3.14.2 (2014-05-29)
 586   * documentation is now written in asciidoc and there are manpages for each
 587     subcommand
 588   * misc bugfixes
 589
 590 btrfs-progs-3.14.1 (2014-04-18)
 591   * properties: fix handling of option -t
 592   * restore: fix reading of compressed extents
 593   * minor code and doc updates
 594
 595 btrfs-progs-3.14 (2014-04-06)
 596   * fsck: fixes and enhancements to --init-extent-tree mode
 597   * fsck: chunk-recover updates
 598   * scrub: add force option -f
 599   * send: check if subvolumes are read-only
 600   * subvol delete: add options to affect commit behaviour
 601   * btrfs: add property command group
 602   * restore: add dry-run option
 603   * restore: fix restoring of compressed files
 604   * mkfs: support for no-holes feature
 605   * mkfs: option -r deals with hardlinks and relative paths
 606   * mkfs: discard phase is interruptible
 607   * documentation updates
 608
 609 btrfs-progs-3.12 (2013-11-25)
 610   * announcement, tarballs
 611   * first release after 0.19 (2009/06) with a lot of changes