#file-copy #cow #copy #btrfs #reflink #xfs

reflink-copy

copy-on-write mechanism on supported file systems

14 releases

0.1.17 Apr 21, 2024
0.1.15 Mar 1, 2024
0.1.14 Dec 11, 2023
0.1.12 Nov 17, 2023
0.1.5 Jul 12, 2023

#87 in Filesystem

Download history 9096/week @ 2024-01-23 9088/week @ 2024-01-30 6212/week @ 2024-02-06 8812/week @ 2024-02-13 9470/week @ 2024-02-20 12306/week @ 2024-02-27 12685/week @ 2024-03-05 11132/week @ 2024-03-12 12806/week @ 2024-03-19 11965/week @ 2024-03-26 11517/week @ 2024-04-02 15183/week @ 2024-04-09 15934/week @ 2024-04-16 18262/week @ 2024-04-23 13016/week @ 2024-04-30 11553/week @ 2024-05-07

61,222 downloads per month
Used in 68 crates (10 directly)

MIT/Apache

23KB
407 lines

reflink-copy

Build

Cross-platform(!) COW reflink copy of files

Some file systems implement COW (copy on write) functionality in order to speed up file copies. On a high level, the new file does not actually get copied, but shares the same on-disk data with the source file. As soon as one of the files is modified, the actual copying is done by the underlying OS.

This library supports Linux, Android, OSX, ios and Windows. As soon as other OS support the functionality, support will be added. For implementation details, visit the docs.


lib.rs:

Some file systems implement COW (copy on write) functionality in order to speed up file copies. On a high level, the new file does not actually get copied, but shares the same on-disk data with the source file. As soon as one of the files is modified, the actual copying is done by the underlying OS.

This library exposes a single function, reflink, which attempts to copy a file using the underlying OSs' block cloning capabilities. The function signature is identical to std::fs::copy.

At the moment Linux, Android, OSX, iOS, and Windows are supported.

Note: On Windows, the integrity information features are only available on Windows Server editions starting from Windows Server 2012. Client versions of Windows do not support these features. More Information

As soon as other OSes support the functionality, support will be added.

Dependencies

~0–42MB
~643K SLoC