Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

bcache: remove discard sysfs interface document

This patch removes documents of bcache discard sysfs interface, it
drops discard related sections from,
- Documentation/ABI/testing/sysfs-block-bcache
- Documentation/admin-guide/bcache.rst

Signed-off-by: Coly Li <colyli@fnnas.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>

authored by

Coly Li and committed by
Jens Axboe
7bf90cd7 73a004f8

+2 -18
-7
Documentation/ABI/testing/sysfs-block-bcache
··· 106 106 will be discarded from the cache. Should not be turned off with 107 107 writeback caching enabled. 108 108 109 - What: /sys/block/<disk>/bcache/discard 110 - Date: November 2010 111 - Contact: Kent Overstreet <kent.overstreet@gmail.com> 112 - Description: 113 - For a cache, a boolean allowing discard/TRIM to be turned off 114 - or back on if the device supports it. 115 - 116 109 What: /sys/block/<disk>/bcache/bucket_size 117 110 Date: November 2010 118 111 Contact: Kent Overstreet <kent.overstreet@gmail.com>
+2 -11
Documentation/admin-guide/bcache.rst
··· 17 17 It's designed around the performance characteristics of SSDs - it only allocates 18 18 in erase block sized buckets, and it uses a hybrid btree/log to track cached 19 19 extents (which can be anywhere from a single sector to the bucket size). It's 20 - designed to avoid random writes at all costs; it fills up an erase block 21 - sequentially, then issues a discard before reusing it. 20 + designed to avoid random writes at all costs. 22 21 23 22 Both writethrough and writeback caching are supported. Writeback defaults to 24 23 off, but can be switched on and off arbitrarily at runtime. Bcache goes to ··· 617 618 cache_replacement_policy 618 619 One of either lru, fifo or random. 619 620 620 - discard 621 - Boolean; if on a discard/TRIM will be issued to each bucket before it is 622 - reused. Defaults to off, since SATA TRIM is an unqueued command (and thus 623 - slow). 624 - 625 621 freelist_percent 626 622 Size of the freelist as a percentage of nbuckets. Can be written to to 627 623 increase the number of buckets kept on the freelist, which lets you 628 624 artificially reduce the size of the cache at runtime. Mostly for testing 629 - purposes (i.e. testing how different size caches affect your hit rate), but 630 - since buckets are discarded when they move on to the freelist will also make 631 - the SSD's garbage collection easier by effectively giving it more reserved 632 - space. 625 + purposes (i.e. testing how different size caches affect your hit rate). 633 626 634 627 io_errors 635 628 Number of errors that have occurred, decayed by io_error_halflife.