wipefs: add --lock and LOCK_BLOCK_DEVICE

[thirdparty/util-linux.git] / disk-utils / cfdisk.8

diff --git a/disk-utils/cfdisk.8 b/disk-utils/cfdisk.8
index ff548d89d5dae601cb685a547ef0be85e0543734..a61aad71f31df03a473ddb23e16d9c76dfcfd7dc 100644 (file)
--- a/disk-utils/cfdisk.8
+++ b/disk-utils/cfdisk.8
@@ -58,9 +58,17 @@ Display help text and exit.
 .BR \-L , " \-\-color" [ = \fIwhen\fR]
 Colorize the output.  The optional argument \fIwhen\fP
 can be \fBauto\fR, \fBnever\fR or \fBalways\fR.  If the \fIwhen\fR argument is omitted,
-it defaults to \fBauto\fR.  The colors can be disabled, for the current built-in default 
+it defaults to \fBauto\fR.  The colors can be disabled, for the current built-in default
 see \fB\-\-help\fR output. See also the COLORS section.
 .TP
+\fB\-\-lock\fR[=\fImode\fR]
+Use exclusive BSD lock for device or file it operates.  The optional argument
+\fImode\fP can be \fByes\fR, \fBno\fR (or 1 and 0) or \fBnonblock\fR.  If the \fImode\fR
+argument is omitted, it defaults to \fB"yes"\fR.  This option overwrites
+environment variable \fB$LOCK_BLOCK_DEVICE\fR.  The default is not to use any
+lock at all, but it's recommended to avoid collisions with udevd or other
+tools.
+.TP
 .BR \-V , " \-\-version"
 Display version information and exit.
 .TP
@@ -101,7 +109,7 @@ position.
 
 The size may be followed by a multiplicative suffix: KiB (=1024),
 MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB
-(the "iB" is optional, e.g. "K" has the same meaning as "KiB").
+(the "iB" is optional, e.g., "K" has the same meaning as "KiB").
 .TP
 .B q
 Quit the program.  This will exit the program without writing any data to
@@ -186,19 +194,21 @@ enables libblkid debug output.
 enables libsmartcols debug output.
 .IP LIBSMARTCOLS_DEBUG_PADDING=on
 use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.
+.IP LOCK_BLOCK_DEVICE=<mode>
+use exclusive BSD lock.  The mode is "1" or "0".  See \fB\-\-lock\fR for more details.
 
-.SH "SEE ALSO"
-.BR fdisk (8),
-.BR parted (8),
-.BR partprobe (8),
-.BR partx (8),
-.BR sfdisk (8)
-.SH AUTHOR
+.SH AUTHORS
 Karel Zak <kzak@redhat.com>
 .PP
 The current cfdisk implementation is based on the original cfdisk
 from Kevin E. Martin (martin@cs.unc.edu).
 
+.SH SEE ALSO
+.BR fdisk (8),
+.BR parted (8),
+.BR partprobe (8),
+.BR partx (8),
+.BR sfdisk (8)
 .SH AVAILABILITY
 The cfdisk command is part of the util-linux package and is available from
 https://www.kernel.org/pub/linux/utils/util-linux/.