On Wed, Jan 4, 2023 at 8:39 AM Darrick J. Wong <djwong@xxxxxxxxxx> wrote: > > On Thu, Dec 29, 2022 at 12:12:48AM -0800, Sarthak Kukreti wrote: > > FALLOC_FL_PROVISION is a new fallocate() allocation mode that > > sends a hint to (supported) thinly provisioned block devices to > > allocate space for the given range of sectors via REQ_OP_PROVISION. > > > > The man pages for both fallocate(2) and posix_fallocate(3) describe > > the default allocation mode as: > > > > ``` > > The default operation (i.e., mode is zero) of fallocate() > > allocates the disk space within the range specified by offset and len. > > ... > > subsequent writes to bytes in the specified range are guaranteed > > not to fail because of lack of disk space. > > ``` > > > > For thinly provisioned storage constructs (dm-thin, filesystems on sparse > > files), the term 'disk space' is overloaded and can either mean the apparent > > disk space in the filesystem/thin logical volume or the true disk > > space that will be utilized on the underlying non-sparse allocation layer. > > > > The use of a separate mode allows us to cleanly disambiguate whether fallocate() > > causes allocation only at the current layer (default mode) or whether it propagates > > allocations to underlying layers (provision mode) > > Why is it important to make this distinction? The outcome of fallocate > is supposed to be that subsequent writes do not fail with ENOSPC. In my > (fs developer) mind, REQ_OP_PROVISION simply an extra step to be taken > after allocating file blocks. > Some use cases still benefit from keeping the default mode - eg. virtual machines running on massive storage pools that don't expect to hit the storage limit anytime soon (like most cloud storage providers). Essentially, if the 'no ENOSPC' guarantee is maintained via other means, then REQ_OP_PROVISION adds latency that isn't needed (and cloud storage providers don't need to set aside that extra space that may or may not be used). > If you *don't* add this API flag and simply bake the REQ_OP_PROVISION > call into mode 0 fallocate, then the new functionality can be added (or > even backported) to existing kernels and customers can use it > immediately. If you *do*, then you get to wait a few years for > developers to add it to their codebases only after enough enterprise > distros pick up a new kernel to make it worth their while. > > > for thinly provisioned filesystems/ > > block devices. For devices that do not support REQ_OP_PROVISION, both these > > allocation modes will be equivalent. Given the performance cost of sending provision > > requests to the underlying layers, keeping the default mode as-is allows users to > > preserve existing behavior. > > How expensive is this expected to be? Is this why you wanted a separate > mode flag? > Yes, the exact latency will depend on the stacked block devices and the fragmentation at the allocation layers. I did a quick test for benchmarking fallocate() with an: A) ext4 filesystem mounted with 'noprovision' B) ext4 filesystem mounted with 'provision' on a dm-thin device. C) ext4 filesystem mounted with 'provision' on a loop device with a sparse backing file on the filesystem in (B). I tested file sizes from 512M to 8G, time taken for fallocate() in (A) remains expectedly flat at ~0.01-0.02s, but for (B), it scales from 0.03-0.4s and for (C) it scales from 0.04s-0.52s (I captured the exact time distribution in the cover letter https://marc.info/?l=linux-ext4&m=167230113520636&w=2) +0.5s for a 8G fallocate doesn't sound a lot but I think fragmentation and how the block device is layered can make this worse... > --D > > > Signed-off-by: Sarthak Kukreti <sarthakkukreti@xxxxxxxxxxxx> > > --- > > block/fops.c | 15 +++++++++++---- > > include/linux/falloc.h | 3 ++- > > include/uapi/linux/falloc.h | 8 ++++++++ > > 3 files changed, 21 insertions(+), 5 deletions(-) > > > > diff --git a/block/fops.c b/block/fops.c > > index 50d245e8c913..01bde561e1e2 100644 > > --- a/block/fops.c > > +++ b/block/fops.c > > @@ -598,7 +598,8 @@ static ssize_t blkdev_read_iter(struct kiocb *iocb, struct iov_iter *to) > > > > #define BLKDEV_FALLOC_FL_SUPPORTED \ > > (FALLOC_FL_KEEP_SIZE | FALLOC_FL_PUNCH_HOLE | \ > > - FALLOC_FL_ZERO_RANGE | FALLOC_FL_NO_HIDE_STALE) > > + FALLOC_FL_ZERO_RANGE | FALLOC_FL_NO_HIDE_STALE | \ > > + FALLOC_FL_PROVISION) > > > > static long blkdev_fallocate(struct file *file, int mode, loff_t start, > > loff_t len) > > @@ -634,9 +635,11 @@ static long blkdev_fallocate(struct file *file, int mode, loff_t start, > > filemap_invalidate_lock(inode->i_mapping); > > > > /* Invalidate the page cache, including dirty pages. */ > > - error = truncate_bdev_range(bdev, file->f_mode, start, end); > > - if (error) > > - goto fail; > > + if (mode != FALLOC_FL_PROVISION) { > > + error = truncate_bdev_range(bdev, file->f_mode, start, end); > > + if (error) > > + goto fail; > > + } > > > > switch (mode) { > > case FALLOC_FL_ZERO_RANGE: > > @@ -654,6 +657,10 @@ static long blkdev_fallocate(struct file *file, int mode, loff_t start, > > error = blkdev_issue_discard(bdev, start >> SECTOR_SHIFT, > > len >> SECTOR_SHIFT, GFP_KERNEL); > > break; > > + case FALLOC_FL_PROVISION: > > + error = blkdev_issue_provision(bdev, start >> SECTOR_SHIFT, > > + len >> SECTOR_SHIFT, GFP_KERNEL); > > + break; > > default: > > error = -EOPNOTSUPP; > > } > > diff --git a/include/linux/falloc.h b/include/linux/falloc.h > > index f3f0b97b1675..b9a40a61a59b 100644 > > --- a/include/linux/falloc.h > > +++ b/include/linux/falloc.h > > @@ -30,7 +30,8 @@ struct space_resv { > > FALLOC_FL_COLLAPSE_RANGE | \ > > FALLOC_FL_ZERO_RANGE | \ > > FALLOC_FL_INSERT_RANGE | \ > > - FALLOC_FL_UNSHARE_RANGE) > > + FALLOC_FL_UNSHARE_RANGE | \ > > + FALLOC_FL_PROVISION) > > > > /* on ia32 l_start is on a 32-bit boundary */ > > #if defined(CONFIG_X86_64) > > diff --git a/include/uapi/linux/falloc.h b/include/uapi/linux/falloc.h > > index 51398fa57f6c..2d323d113eed 100644 > > --- a/include/uapi/linux/falloc.h > > +++ b/include/uapi/linux/falloc.h > > @@ -77,4 +77,12 @@ > > */ > > #define FALLOC_FL_UNSHARE_RANGE 0x40 > > > > +/* > > + * FALLOC_FL_PROVISION acts as a hint for thinly provisioned devices to allocate > > + * blocks for the range/EOF. > > + * > > + * FALLOC_FL_PROVISION can only be used with allocate-mode fallocate. > > + */ > > +#define FALLOC_FL_PROVISION 0x80 > > + > > #endif /* _UAPI_FALLOC_H_ */ > > -- > > 2.37.3 > >
