summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorOlaf Faaland <[email protected]>2018-02-15 09:50:06 -0800
committerBrian Behlendorf <[email protected]>2018-02-15 09:50:06 -0800
commitec7c1b914c096ff0ca95c8b04af07ca6d2be3c7a (patch)
tree3c4cc2cd1f06365fba2dfc1cf690ec1d74e4dca2
parentddc751d56beee8bf79d352ca3d8253d6238b2dc2 (diff)
Clarify zinject(8) explanation of -e
Error injection of EIO or ENXIO simply sets the zio's io_error value, rather than preventing the read or write from occurring. This is important information as it affects how the probes must be used. Reviewed-by: Giuseppe Di Natale <[email protected]> Reviewed-by: Brian Behlendorf <[email protected]> Reviewed-by: George Melikov <[email protected]> Signed-off-by: Olaf Faaland <[email protected]> Closes #7172
-rw-r--r--man/man8/zinject.83
1 files changed, 3 insertions, 0 deletions
diff --git a/man/man8/zinject.8 b/man/man8/zinject.8
index 6b6c3733b..c5916e342 100644
--- a/man/man8/zinject.8
+++ b/man/man8/zinject.8
@@ -112,6 +112,9 @@ Specify
.BR "dtl" " for an ECHILD error,"
.BR "io" " for an EIO error where reopening the device will succeed, or"
.BR "nxio" " for an ENXIO error where reopening the device will fail."
+For EIO and ENXIO, the "failed" reads or writes still occur. The probe simply
+sets the error value reported by the I/O pipeline so it appears the read or
+write failed.
.TP
.BI "\-f" " frequency"
Only inject errors a fraction of the time. Expressed as a real number