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

Configure Feed

Select the types of activity you want to include in your feed.

docs: document iomap writeback's iomap_finish_folio_write() requirement

Document that iomap_finish_folio_write() must be called after writeback
on the range completes.

Signed-off-by: Joanne Koong <joannelkoong@gmail.com>
Link: https://patch.msgid.link/20251111193658.3495942-4-joannelkoong@gmail.com
Reviewed-by: Christoph Hellwig <hch@lst.de>
Reviewed-by: Darrick J. Wong <djwong@kernel.org>
Signed-off-by: Christian Brauner <brauner@kernel.org>

authored by

Joanne Koong and committed by
Christian Brauner 7e6cea5a 9d875e0e

+7
+3
Documentation/filesystems/iomap/operations.rst
··· 361 361 delalloc reservations to avoid having delalloc reservations for 362 362 clean pagecache. 363 363 This function must be supplied by the filesystem. 364 + If this succeeds, iomap_finish_folio_write() must be called once writeback 365 + completes for the range, regardless of whether the writeback succeeded or 366 + failed. 364 367 365 368 - ``writeback_submit``: Submit the previous built writeback context. 366 369 Block based file systems should use the iomap_ioend_writeback_submit
+4
include/linux/iomap.h
··· 435 435 * An existing mapping from a previous call to this method can be reused 436 436 * by the file system if it is still valid. 437 437 * 438 + * If this succeeds, iomap_finish_folio_write() must be called once 439 + * writeback completes for the range, regardless of whether the 440 + * writeback succeeded or failed. 441 + * 438 442 * Returns the number of bytes processed or a negative errno. 439 443 */ 440 444 ssize_t (*writeback_range)(struct iomap_writepage_ctx *wpc,