diff options
author | Matthew Wilcox (Oracle) <willy@infradead.org> | 2024-04-16 04:17:50 +0100 |
---|---|---|
committer | Andrew Morton <akpm@linux-foundation.org> | 2024-05-05 17:53:40 -0700 |
commit | b73a936f99914e23fbe236f75ecf257923cb06e7 (patch) | |
tree | 54b303e9fe186a73e995fd538038202d0787003b /include | |
parent | 66924fdaf835f5fc6fe78d92a79afcca7d4db7ec (diff) | |
download | linux-stable-b73a936f99914e23fbe236f75ecf257923cb06e7.tar.gz linux-stable-b73a936f99914e23fbe236f75ecf257923cb06e7.tar.bz2 linux-stable-b73a936f99914e23fbe236f75ecf257923cb06e7.zip |
buffer: add kernel-doc for bforget() and __bforget()
Distinguish these functions from brelse() and __brelse().
Link: https://lkml.kernel.org/r/20240416031754.4076917-7-willy@infradead.org
Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Pankaj Raghav <p.raghav@samsung.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Diffstat (limited to 'include')
-rw-r--r-- | include/linux/buffer_head.h | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/include/linux/buffer_head.h b/include/linux/buffer_head.h index c145817c6ca0..a1c0bdd0cca6 100644 --- a/include/linux/buffer_head.h +++ b/include/linux/buffer_head.h @@ -325,6 +325,16 @@ static inline void brelse(struct buffer_head *bh) __brelse(bh); } +/** + * bforget - Discard any dirty data in a buffer. + * @bh: The buffer to forget. + * + * Call this function instead of brelse() if the data written to a buffer + * no longer needs to be written back. It will clear the buffer's dirty + * flag so writeback of this buffer will be skipped. + * + * Context: Any context. + */ static inline void bforget(struct buffer_head *bh) { if (bh) |