#file-copy #copy #cow #btrfs #write-file #reflink

reflink-copy

copy-on-write mechanism on supported file systems

16 releases

0.1.19 Jul 4, 2024
0.1.17 Apr 21, 2024
0.1.15 Mar 1, 2024
0.1.14 Dec 11, 2023
0.1.5 Jul 12, 2023

#100 in Filesystem

Download history 17641/week @ 2024-06-12 15192/week @ 2024-06-19 15336/week @ 2024-06-26 14233/week @ 2024-07-03 12617/week @ 2024-07-10 13470/week @ 2024-07-17 16094/week @ 2024-07-24 15653/week @ 2024-07-31 17179/week @ 2024-08-07 15624/week @ 2024-08-14 18825/week @ 2024-08-21 17774/week @ 2024-08-28 18082/week @ 2024-09-04 17644/week @ 2024-09-11 18822/week @ 2024-09-18 15502/week @ 2024-09-25

73,059 downloads per month
Used in 82 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–39MB
~609K SLoC