#file-copy #write-file #copy #cow #btrfs #data-file

reflink-copy

copy-on-write mechanism on supported file systems

17 releases

0.1.20 Nov 10, 2024
0.1.19 Jul 4, 2024
0.1.18 Jun 11, 2024
0.1.15 Mar 1, 2024
0.1.5 Jul 12, 2023

#77 in Filesystem

Download history 19686/week @ 2024-08-22 18291/week @ 2024-08-29 16791/week @ 2024-09-05 17832/week @ 2024-09-12 19801/week @ 2024-09-19 18392/week @ 2024-09-26 16577/week @ 2024-10-03 17970/week @ 2024-10-10 21861/week @ 2024-10-17 18313/week @ 2024-10-24 17461/week @ 2024-10-31 17396/week @ 2024-11-07 21676/week @ 2024-11-14 21835/week @ 2024-11-21 23989/week @ 2024-11-28 20909/week @ 2024-12-05

92,158 downloads per month
Used in 90 crates (11 directly)

MIT/Apache

29KB
515 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–39MB
~604K SLoC