vbig.1

   1 \"
   2 \" This file is part of vbig.
   3 \" Copyright (C) 2011 Richard Kettlewell
   4 \"
   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.
   9 \"
  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.
  14 \"
  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/>.
  17 \"
  18 .TH vbig 1
  19 .SH NAME
  20 vbig \- create or verify a large but pseudo-random file
  21 .SH SYNOPSIS
  22 \fBvbig \fR[\fB--seed \fRSEED\fR] \fB--create\fR|\fB--verify \fIPATH SIZE
  23 .br
  24 \fBvbig --help
  25 .br
  26 \fBvbig --version
  27 .SH DESCRIPTION
  28 \fBvbig\fR either creates a file of specified size full of predictable
  29 psuedo-random data, or verifies that it has the expected contents.
  30 The intended use is to test whether storage media really do what they
  31 say on the tin.
  32 .PP
  33 \fISIZE\fR may end with \fBK\fR, \fBM\fR or \fBG\fR to select (binary)
  34 kilobytes, megabytes or gigabytes.
  35 .SH OPTIONS
  36 .TP
  37 .B --seed\fR, \fB-s \fISEED
  38 Specifies the random seed to use.
  39 Optional.
  40 .TP
  41 .B --create\fR, \fB-c
  42 Selects create mode.
  43 \fIPATH\fR will be filled with \fISIZE\fR psuedo-random bytes.
  44 .TP
  45 .B --verify\fR, \fB-v
  46 Selects verify mode.
  47 Checks that \fIPATH\fR has exactly the contents that would be produced
  48 by the equivalent \fB--create\fR call.
  49 .TP
  50 .B --flush\fR, \fB-f
  51 Flush cached data after creating the file or before verifying it.
  52 On some platforms, only root can use this option.
  53 .TP
  54 .B --help\fR, \fB-h
  55 Displays a usage message.
  56 .TP
  57 .B --version\fR, \fB-h
  58 Displays the version strings.
  59 .SH AUTHOR
  60 Richard Kettlewell <rjk@greenend.org.uk>