2 \" This file is part of vbig.
3 \" Copyright (C) 2011 Richard Kettlewell
5 \" This program is free software: you can redistribute it and/or modify
6 \" it under the terms of the GNU General Public License as published by
7 \" the Free Software Foundation, either version 3 of the License, or
8 \" (at your option) any later version.
10 \" This program is distributed in the hope that it will be useful,
11 \" but WITHOUT ANY WARRANTY; without even the implied warranty of
12 \" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 \" GNU General Public License for more details.
15 \" You should have received a copy of the GNU General Public License
16 \" along with this program. If not, see <http://www.gnu.org/licenses/>.
20 vbig \- create or verify a large but pseudo-random file
22 \fBvbig \fR[\fB--seed \fRSEED\fR] [\fB--both\fR|\fB--create\fR|\fB--verify\fR] \fIPATH \fR[\fISIZE\fR]
28 \fBvbig\fR creates a file of specified size full of predictable
29 psuedo-random data, and/or verifies that it has the expected contents.
30 The intended use is to test whether storage media really do what they
33 \fISIZE\fR may end with \fBK\fR, \fBM\fR or \fBG\fR to select (binary)
34 kilobytes, megabytes or gigabytes.
35 The size is mandatory when creating a file but optional when verifying
36 it, unless \-\-entire is specified. If \fBSIZE\fR not specified when
37 writing-then-verifying, it is as if \fB\-\-entire\fR was specified.
39 A fixed default seed is used if no seed or seed file is specified.
42 .B --seed\fR, \fB-s \fISEED
43 Specifies the random seed to use.
46 .B --seed-file\fR, \fB-S \fISEED-FILE
47 Specifies wehre the random seed should be read from. The
48 first \fISEED-LENGTH\fR bytes will be used, or the whole file
51 .B --seed-length\fR, \fB-L \fISEED-LENGTH
52 Specifies the (maximum) seed length in bytes.
53 Optional; default is 2048.
57 \fIPATH\fR will be filled with \fISIZE\fR psuedo-random bytes and
58 then read to check that it contains the data just written.
63 \fIPATH\fR will be filled with \fISIZE\fR psuedo-random bytes.
67 Checks that \fIPATH\fR has exactly the contents that would be produced
68 by the equivalent \fB--create\fR call.
71 Flush cached data after creating the file or before verifying it.
72 On some platforms, only root can use this option.
75 When writing, keep going until the device is full (No space left
76 on device). When reading, keep going until the end of the file
77 or device. \fISIZE\fR should not be specified. The actual size
78 written or verified will be printed to stdout.
81 Displays a usage message.
83 .B --version\fR, \fB-h
84 Displays the version strings.
86 Richard Kettlewell <rjk@greenend.org.uk>