]> git.ipfire.org Git - thirdparty/util-linux.git/blobdiff - sys-utils/blkdiscard.8.adoc
Wall: Fix terminal flag usage
[thirdparty/util-linux.git] / sys-utils / blkdiscard.8.adoc
index 83687435798ca769a2b1313115d4410fedf5b360..cf661acd9c367b359ca07ad8040d9e22480c4395 100644 (file)
@@ -24,6 +24,8 @@ The _device_ argument is the pathname of the block device.
 
 *WARNING: All data in the discarded region on the device will be lost!*
 
+Since util-linux v2.41, fdisk has the ability to discard sectors on both partitions and unpartitioned areas using the 'T' command.
+
 == OPTIONS
 
 The _offset_ and _length_ arguments may be followed by the multiplicative suffixes 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") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and YB.
@@ -40,6 +42,9 @@ The number of bytes to discard (counting from the starting point). The provided
 *-p*, *--step* _length_::
 The number of bytes to discard within one iteration. The default is to discard all by one ioctl call.
 
+*-q*, *--quiet*::
+Suppress warning messages.
+
 *-s*, *--secure*::
 Perform a secure discard. A secure discard is the same as a regular discard except that all copies of the discarded blocks that were possibly created by garbage collection must also be erased. This requires support from the device.
 
@@ -51,9 +56,23 @@ Display the aligned values of _offset_ and _length_. If the *--step* option is s
 
 include::man-common/help-version.adoc[]
 
+== EXIT STATUS
+
+*blkdiscard* has the following exit status values:
+
+*0*::
+success
+
+*1*::
+failure; incorrect invocation, permissions or any other generic error
+
+*2*::
+failure; since v2.39, the device does not support discard operation
+
 == AUTHORS
 
-mailto:lczerner@redhat.com[Lukas Czerner]
+mailto:lczerner@redhat.com[Lukas Czerner],
+mailto:kzak@redhat.com[Karel Zak]
 
 == SEE ALSO