hole-punch 0.0.2

A WIP cross platform library for extracting information about holes in sparse files.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

Hole-Punch
==========
![Crates.io](https://img.shields.io/crates/v/hole-punch?style=flat-square&logo=rust)
![License](https://img.shields.io/crates/l/hole-punch?style=flat-square)
![Unsafe](https://img.shields.io/badge/unsafe-very%20yes-important?style=flat-square)
![Maintenance](https://img.shields.io/maintenance/yes/2020?style=flat-square)


A (wip) dead simple, cross platform crate for finding the locations of holes in
sparse files.

Currently supports Unix-like platforms that support the `SEEK_HOLE` and
`SEEK_DATA` commands on `lseek`, as well as windows.

Windows support is not complete and is still being worked on, but should already
be fine for most cases. 

I do not currently have a Mac to test or develop MacOS support on, so no
warranties or claims are currently made about MacOS.

Usage
-----

```rust
use std::fs::File;
use hole_punch::*;

let mut file = File::open("a big sparse file");
let segments = file.scan_chunks().expect("Unable to scan chunks");
for segment in segment {
    if let SegmentType::Data = segment.segment_type {
        let start = segment.start;
        let end = segment.end;

        let length = end - start;
        do_something_with_data(&mut file, start, length);
    }
}
```

License
-------

Hole-Punch is distributed under your choice of the MIT license, or Apache
Version 2.0.

TO-DOs
------

The following features are on my "to implement" list, in order of importance:
1. Windows support
2. Fallback mode (reading the entire file manually looking for chunks of 0s)