Skip to contentSkip to conversation

Systemcall for offline deduplication

DISCUSSION Bob Marley 4 participants 6 messages Oct 15, 2012 – Oct 26, 2012 Btrfs file system

lore
Share & tools
lore

Bob Marley

author
#0 lore raw

Hello all btrfs developers

I would really appreciate a systemcall (or ioctl or the like) to allow deduplication of a block of a file against a block of another file. (ok if blocks need to be aligned to filesystem blocks)

So that if I know that bytes 32768...65536 of FileA are identical to bytes 131072...163840 of FileB I can call that syscall to have the regions deduplicated one against the other atomically and with the filesystem running. The syscall should presumably check that the regions are really equal and perform the deduplication atomically.

This would be the start for a lot of deduplication algorithms in userspace. It would be a killer feature for backup systems.

Thank you,
Bob

#1 lore raw
Quoted 3 lines · Bob Marley

I would really appreciate a systemcall (or ioctl or the like) to allow deduplication of a block of a file against a block of another file. (ok if blocks need to be aligned to filesystem blocks)

It exists, is called

BTRFS_IOC_CLONE_RANGE
(http://lxr.free-electrons.com/source/fs/btrfs/ioctl.h#L399)

btrfs_ioctl_clone_range_args
http://lxr.free-electrons.com/source/fs/btrfs/ioctl.h#L254

Quoted 5 lines

The syscall should presumably check that the regions are really equal and perform the deduplication atomically.

This would be the start for a lot of deduplication algorithms in userspace. It would be a killer feature for backup systems.

It doesn't do any checks if the range contents match, but for a backup system, the ranges can be merged at a calm state, ie not new data in flight.

david

#2 lore raw
Quoted 16 lines · David Sterba
Quoted 3 lines · Bob Marley

I would really appreciate a systemcall (or ioctl or the like) to allow deduplication of a block of a file against a block of another file. (ok if blocks need to be aligned to filesystem blocks)

It exists, is called

BTRFS_IOC_CLONE_RANGE
(http://lxr.free-electrons.com/source/fs/btrfs/ioctl.h#L399)

btrfs_ioctl_clone_range_args
http://lxr.free-electrons.com/source/fs/btrfs/ioctl.h#L254

Quoted 3 lines

The syscall should presumably check that the regions are really equal and perform the deduplication atomically.

Quoted 7 lines
Quoted 3 lines

This would be the start for a lot of deduplication algorithms in userspace.
It would be a killer feature for backup systems.

It doesn't do any checks if the range contents match, but for a backup system, the ranges can be merged at a calm state, ie not new data in flight.

Thanks for bringing this up.

I'm the author of bedup[1], a btrfs deduplication tool which currently uses the IOC_CLONE_RANGE syscall (and a host of other btrfs features:
search, fiemap, inode-to-path backrefs, etc).

By far the biggest drawback is that the same-range check is done in userland; that means I need to lock files in userland to guarantee I have exclusive access to both files at the time the clone call is done. I've found a way that might be okay against non-root users, but I wouldn't swear to it, and if it isn't that creates a security risk.

The other drawbacks come from CLONE_RANGE being a write operation. It can't be done with read-only subvolumes, which is a shame because backup filesystems containing mostly read-only snapshots are a great candidate for deduplication. And it updates the mtime, when deduplication should be an implementation detail with no impact on file metadata.

Now, here's my proposal for fixing that:
A BTRFS_IOC_SAME_RANGE ioctl would be ideal. Takes two file descriptors, two offsets, one length, does some locking, checks that the ranges are identical (returns EINVAL if not), and defers to an implementation that works like clone_range with the metadata update and the writable volume restriction moved out.

I didn't go with something block-based or extent-based because with compression and fragmentation, extents would very easily fail to be aligned.

Thoughts on this interface?
Anyone interested in getting this implemented, or at least providing some guidance and patch review?

[1] https://github.com/g2p/bedup#readme

#3 lore raw
Quoted 50 lines · Gabriel
Quoted 16 lines · David Sterba
Quoted 3 lines · Bob Marley

I would really appreciate a systemcall (or ioctl or the like) to allow deduplication of a block of a file against a block of another file. (ok if blocks need to be aligned to filesystem blocks)

It exists, is called

BTRFS_IOC_CLONE_RANGE
(http://lxr.free-electrons.com/source/fs/btrfs/ioctl.h#L399)

btrfs_ioctl_clone_range_args
http://lxr.free-electrons.com/source/fs/btrfs/ioctl.h#L254

Quoted 3 lines

The syscall should presumably check that the regions are really equal and perform the deduplication atomically.

Quoted 7 lines
Quoted 3 lines

This would be the start for a lot of deduplication algorithms in userspace.
It would be a killer feature for backup systems.

It doesn't do any checks if the range contents match, but for a backup system, the ranges can be merged at a calm state, ie not new data in flight.

Thanks for bringing this up.

I'm the author of bedup[1], a btrfs deduplication tool which currently uses the IOC_CLONE_RANGE syscall (and a host of other btrfs features:
search, fiemap, inode-to-path backrefs, etc).

By far the biggest drawback is that the same-range check is done in userland; that means I need to lock files in userland to guarantee I have exclusive access to both files at the time the clone call is done. I've found a way that might be okay against non-root users, but I wouldn't swear to it, and if it isn't that creates a security risk.

The other drawbacks come from CLONE_RANGE being a write operation. It can't be done with read-only subvolumes, which is a shame because backup filesystems containing mostly read-only snapshots are a great candidate for deduplication. And it updates the mtime, when deduplication should be an implementation detail with no impact on file metadata.

Now, here's my proposal for fixing that:
A BTRFS_IOC_SAME_RANGE ioctl would be ideal. Takes two file descriptors, two offsets, one length, does some locking, checks that the ranges are identical (returns EINVAL if not), and defers to an implementation that works like clone_range with the metadata update and the writable volume restriction moved out.

Quoted 7 lines

I didn't go with something block-based or extent-based because with compression and fragmentation, extents would very easily fail to be aligned.

Thoughts on this interface?
Anyone interested in getting this implemented, or at least providing some guidance and patch review?

This sounds quite a bit like what Josef had proposed with the FILE_EXTENT_SAME ioctl a couple of years ago[1]. At the time, he was only interested in writing a userland dedupe program for various reasons, and afaict it hasn't gone anywhere. If you're going to do the comparing from userspace, I'd imagine you ought to have a better method to pin an extent than chattr +i...

I guess you could create a temporary file, F_E_S the parts of the files you're trying to compare into the temp file, link together whichever parts you want to, and punch_hole the entire temp file before moving on. I think it's the case that if the candidate files get rewritten during the dedupe operation, the new data will be written elsewhere; the punch hole operation will release the disk space if its refcount becomes zero. The offline dedupe scheme seems like a good way to reclaim disk space if you don't mind having fewer copies of data.

As for online dedupe (which seems useful for reducing writes), would it be useful if one could, given a write request, compare each of the dirty pages in that request against whatever else the fs has loaded in the page cache, and try to dedupe against that? We could probably speed up the search by storing hashes of whatever we have in the page cache and using that to find candidates for the memcmp() test. This of course is not a comprehensive solution, but (a) we combine it with offline dedupe later and (b) we don't make a disk write out data that we've recently read or written. Obviously you'd want to be able to opt-in to this sort of thing with an inode flag or something.

Does any of this sound reasonable?

--D

[1] http://www.mail-archive.com/[email protected]/msg07779.html

Quoted 6 lines

[1] https://github.com/g2p/bedup#readme

--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html

#4 lore raw
Quoted 15 lines · Darrick J. Wong
Quoted 7 lines

Now, here's my proposal for fixing that:
A BTRFS_IOC_SAME_RANGE ioctl would be ideal. Takes two file descriptors, two offsets, one length, does some locking, checks that the ranges are identical (returns EINVAL if not), and defers to an implementation that works like clone_range with the metadata update and the writable volume restriction moved out.

Quoted 7 lines

I didn't go with something block-based or extent-based because with compression and fragmentation, extents would very easily fail to be aligned.

Thoughts on this interface?
Anyone interested in getting this implemented, or at least providing some guidance and patch review?

Quoted 6 lines

This sounds quite a bit like what Josef had proposed with the FILE_EXTENT_SAME ioctl a couple of years ago[1]. At the time, he was only interested in writing a userland dedupe program for various reasons, and afaict it hasn't gone anywhere. If you're going to do the comparing from userspace, I'd imagine you ought to have a better method to pin an extent than chattr +i...

The immutable hack is a bit lame, but it will have to stay until we get a good kernel API.

Quoted 6 lines

I guess you could create a temporary file, F_E_S the parts of the files you're trying to compare into the temp file, link together whichever parts you want to, and punch_hole the entire temp file before moving on.
I think it's the case that if the candidate files get rewritten during
the dedupe operation, the new data will be written elsewhere; the punch hole operation will release the disk space if its refcount becomes zero.

The FILE_EXTENT_SAME proposal is not the one I'd prefer.
The parameters (fds, offsets, one length) are fine.
It's not as extent-based as the name implies (no extents in the parameters), except that it sill needs a single extent on the left side, which won't work for fragmented files. That alone may be worked around by creating a new tempfile to use on the source side, but that has
downsides: it will unshare extents and might actually increase disk use, and it won't work on read-only snapshots.
It is better to just pass fragmented offsets to the kernel and not put workarounds that reduce visibility for the implementation.

The restrictions for compressed or encrypted files and cross-subvolume dedup are also inconvenient. That makes me more interested in an implementation based on clone_range, which has neither limitation. That's the proposal above.

Quoted 2 lines

The offline dedupe scheme seems like a good way to reclaim disk space
if you don't mind having fewer copies of data.

I'm happy with the gains, although they are entirely dependent on having a lot of redundant data in the first place. The messier the better.

Quoted 11 lines

As for online dedupe (which seems useful for reducing writes), would it be useful if one could, given a write request, compare each of the dirty pages in that request against whatever else the fs has loaded in the page cache, and try to dedupe against that? We could probably speed up the search by storing hashes of whatever we have in the page cache and using that to find candidates for the memcmp() test. This of course is not a comprehensive solution, but (a)
we combine it with offline dedupe later and (b) we don't make a disk write out data that we've recently read or written. Obviously you'd want to be able to opt-in to this sort of thing with an inode flag or something.

That's another kettle of fish, and will require an entirely different approach. ZFS has some experience doing that. While their implementation may reduce writes it is at the cost of storing hashes of every block in RAM.

Quoted 4 lines

[1]
http://www.mail-archive.com/[email protected]/msg07779.html

Quoted 1 line

[1] https://github.com/g2p/bedup#readme

#5 lore raw
Quoted 12 lines
Quoted 11 lines

As for online dedupe (which seems useful for reducing writes), would it be useful if one could, given a write request, compare each of the dirty pages in that request against whatever else the fs has loaded in the page cache, and try to dedupe against that? We could probably speed up the search by storing hashes of whatever we have in the page cache and using that to find candidates for the memcmp() test. This of course is not a comprehensive solution, but (a)
we combine it with offline dedupe later and (b) we don't make a disk write out data that we've recently read or written. Obviously you'd want to be able to opt-in to this sort of thing with an inode flag or something.

Quoted 4 lines

That's another kettle of fish, and will require an entirely different approach. ZFS has some experience doing that. While their implementation may reduce writes it is at the cost of storing hashes of every block in RAM.

Though your proposal is quite different from the ZFS thing, and might actually be useful for a larger public, so forget I said anything about it.