about summary refs log tree commit diff
path: root/holes.1
blob: 2edbaf9f7333fa29edd95b33951fde19429dbe21 (plain) (blame)
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
.Dd August 21, 2017
.Dt HOLES 1
.Os
.Sh NAME
.Nm holes
.Nd find runs of zero bytes
.Sh SYNOPSIS
.Nm
.Op Fl b Ar byte
.Op Fl n Ar minlen
.Op Ar files\ ...
.Sh DESCRIPTION
.Nm
looks for runs of zero bytes (a.k.a. holes) in the specified input files
(or the standard input),
and prints the start adresses (in hexadecimal)
as well as the lengths (in decimal).
When multiple input files are specified,
.Nm
prefixes each line with the file name.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl b Ar byte
Count runs of
.Ar byte ,
a number between 0 and 255,
instead of zero bytes.
.It Fl n Ar minlen
Change minimum size of holes reported.
By default,
only holes of at least 64 bytes are reported.
.El
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr fallocate 1 ,
.Xr truncate 1 ,
.Xr virt-sparsify 1
.Sh AUTHORS
.An Leah Neukirchen Aq Mt leah@vuxu.org
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/