diff mbox series

dm flakey: Document "error_writes" feature

Message ID 1539073891-7701-1-git-send-email-nborisov@suse.com (mailing list archive)
State Accepted, archived
Delegated to: Mike Snitzer
Headers show
Series dm flakey: Document "error_writes" feature | expand

Commit Message

Nikolay Borisov Oct. 9, 2018, 8:31 a.m. UTC
Commit ef548c551e72 ("dm flakey: introduce "error_writes" feature")
added the ability to dm flakey to error out writes in contrast to
silently dropping it with 'drop_writes'. Unfortunately this feature
is not currently documented and one has to be either familiar with the
source code of dm flakey or check out xfstests sources to know of
this parameter. So document it.

Signed-off-by: Nikolay Borisov <nborisov@suse.com>
---
 Documentation/device-mapper/dm-flakey.txt | 4 ++++
 1 file changed, 4 insertions(+)

Comments

John Pittman Oct. 10, 2018, 12:18 p.m. UTC | #1
Hi Nikolay, I sent this one to Mike at the end of September.("dm
flakey: add error_writes to documentation -
"https://www.redhat.com/archives/dm-devel/2018-September/msg00146.html).
Unsure if he has picked it up or not.

Best Regards,

John Pittman
Customer Engagement and Experience
Red Hat Inc.

On Wed, Oct 10, 2018 at 4:20 AM Nikolay Borisov <nborisov@suse.com> wrote:
>
> Commit ef548c551e72 ("dm flakey: introduce "error_writes" feature")
> added the ability to dm flakey to error out writes in contrast to
> silently dropping it with 'drop_writes'. Unfortunately this feature
> is not currently documented and one has to be either familiar with the
> source code of dm flakey or check out xfstests sources to know of
> this parameter. So document it.
>
> Signed-off-by: Nikolay Borisov <nborisov@suse.com>
> ---
>  Documentation/device-mapper/dm-flakey.txt | 4 ++++
>  1 file changed, 4 insertions(+)
>
> diff --git a/Documentation/device-mapper/dm-flakey.txt b/Documentation/device-mapper/dm-flakey.txt
> index c43030718cef..9f0e247d0877 100644
> --- a/Documentation/device-mapper/dm-flakey.txt
> +++ b/Documentation/device-mapper/dm-flakey.txt
> @@ -33,6 +33,10 @@ Table parameters
>         All write I/O is silently ignored.
>         Read I/O is handled correctly.
>
> +  error_writes:
> +       All write I/O is failed with an error signalled.
> +       Read I/O is handled correctly.
> +
>    corrupt_bio_byte <Nth_byte> <direction> <value> <flags>:
>         During <down interval>, replace <Nth_byte> of the data of
>         each matching bio with <value>.
> --
> 2.7.4
>
> --
> dm-devel mailing list
> dm-devel@redhat.com
> https://www.redhat.com/mailman/listinfo/dm-devel

--
dm-devel mailing list
dm-devel@redhat.com
https://www.redhat.com/mailman/listinfo/dm-devel
Jonathan Corbet Oct. 12, 2018, 5:31 p.m. UTC | #2
On Tue,  9 Oct 2018 11:31:31 +0300
Nikolay Borisov <nborisov@suse.com> wrote:

> Commit ef548c551e72 ("dm flakey: introduce "error_writes" feature")
> added the ability to dm flakey to error out writes in contrast to
> silently dropping it with 'drop_writes'. Unfortunately this feature
> is not currently documented and one has to be either familiar with the
> source code of dm flakey or check out xfstests sources to know of
> this parameter. So document it.
> 
> Signed-off-by: Nikolay Borisov <nborisov@suse.com>

Applied to the docs tree, thanks.

jon

--
dm-devel mailing list
dm-devel@redhat.com
https://www.redhat.com/mailman/listinfo/dm-devel
diff mbox series

Patch

diff --git a/Documentation/device-mapper/dm-flakey.txt b/Documentation/device-mapper/dm-flakey.txt
index c43030718cef..9f0e247d0877 100644
--- a/Documentation/device-mapper/dm-flakey.txt
+++ b/Documentation/device-mapper/dm-flakey.txt
@@ -33,6 +33,10 @@  Table parameters
 	All write I/O is silently ignored.
 	Read I/O is handled correctly.
 
+  error_writes:
+	All write I/O is failed with an error signalled.
+	Read I/O is handled correctly.
+
   corrupt_bio_byte <Nth_byte> <direction> <value> <flags>:
 	During <down interval>, replace <Nth_byte> of the data of
 	each matching bio with <value>.