]> git.ipfire.org Git - thirdparty/linux.git/commitdiff
bcache: remove discard sysfs interface document
authorColy Li <colyli@fnnas.com>
Thu, 13 Nov 2025 05:36:25 +0000 (13:36 +0800)
committerJens Axboe <axboe@kernel.dk>
Thu, 13 Nov 2025 16:18:06 +0000 (09:18 -0700)
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>
Documentation/ABI/testing/sysfs-block-bcache
Documentation/admin-guide/bcache.rst

index 9e4bbc5d51fd50fff1270d99361687a07696860e..9344a657ca70f2080cc6e9e21975770aebc324c8 100644 (file)
@@ -106,13 +106,6 @@ Description:
                will be discarded from the cache. Should not be turned off with
                writeback caching enabled.
 
-What:          /sys/block/<disk>/bcache/discard
-Date:          November 2010
-Contact:       Kent Overstreet <kent.overstreet@gmail.com>
-Description:
-               For a cache, a boolean allowing discard/TRIM to be turned off
-               or back on if the device supports it.
-
 What:          /sys/block/<disk>/bcache/bucket_size
 Date:          November 2010
 Contact:       Kent Overstreet <kent.overstreet@gmail.com>
index 6fdb495ac46652ac75f39ee8d3fd595a335f316e..f71f349553e4265644a8fdaedc409b012f69bd88 100644 (file)
@@ -17,8 +17,7 @@ The latest bcache kernel code can be found from mainline Linux kernel:
 It's designed around the performance characteristics of SSDs - it only allocates
 in erase block sized buckets, and it uses a hybrid btree/log to track cached
 extents (which can be anywhere from a single sector to the bucket size). It's
-designed to avoid random writes at all costs; it fills up an erase block
-sequentially, then issues a discard before reusing it.
+designed to avoid random writes at all costs.
 
 Both writethrough and writeback caching are supported. Writeback defaults to
 off, but can be switched on and off arbitrarily at runtime. Bcache goes to
@@ -618,19 +617,11 @@ bucket_size
 cache_replacement_policy
   One of either lru, fifo or random.
 
-discard
-  Boolean; if on a discard/TRIM will be issued to each bucket before it is
-  reused. Defaults to off, since SATA TRIM is an unqueued command (and thus
-  slow).
-
 freelist_percent
   Size of the freelist as a percentage of nbuckets. Can be written to to
   increase the number of buckets kept on the freelist, which lets you
   artificially reduce the size of the cache at runtime. Mostly for testing
-  purposes (i.e. testing how different size caches affect your hit rate), but
-  since buckets are discarded when they move on to the freelist will also make
-  the SSD's garbage collection easier by effectively giving it more reserved
-  space.
+  purposes (i.e. testing how different size caches affect your hit rate).
 
 io_errors
   Number of errors that have occurred, decayed by io_error_halflife.