chiark / gitweb /
New --entire option
[vbig.git] / vbig.1
diff --git a/vbig.1 b/vbig.1
index ccd98f247ba5efc724b8785ef91987384a3d5651..a3f963ba76034c9e8fa9af4bd7e1e8febbefd7c2 100644 (file)
--- a/vbig.1
+++ b/vbig.1
@@ -19,7 +19,7 @@
 .SH NAME
 vbig \- create or verify a large but pseudo-random file
 .SH SYNOPSIS
-\fBvbig \fR[\fB--seed \fRSEED\fR] \fB--create\fR|\fB--verify \fIPATH SIZE
+\fBvbig \fR[\fB--seed \fRSEED\fR] \fB--create\fR|\fB--verify \fIPATH \fR[\fISIZE\fR]
 .br
 \fBvbig --help
 .br
@@ -32,6 +32,8 @@ say on the tin.
 .PP
 \fISIZE\fR may end with \fBK\fR, \fBM\fR or \fBG\fR to select (binary)
 kilobytes, megabytes or gigabytes.
+The size is mandatory when creating a file but optional when verifying
+it, unless \-\-entire is specified.
 .SH OPTIONS
 .TP
 .B --seed\fR, \fB-s \fISEED
@@ -51,6 +53,12 @@ by the equivalent \fB--create\fR call.
 Flush cached data after creating the file or before verifying it.
 On some platforms, only root can use this option.
 .TP
+.B --entire\fR, \fB-e
+When writing, keep going until the device is full (No space left
+on device).  When reading, keep going until the end of the file
+or device.  \fISIZE\fR should not be specified.  The actual size
+written or verified will be printed to stdout.
+.TP
 .B --help\fR, \fB-h
 Displays a usage message.
 .TP