From ec7c1b914c096ff0ca95c8b04af07ca6d2be3c7a Mon Sep 17 00:00:00 2001 From: Olaf Faaland Date: Thu, 15 Feb 2018 09:50:06 -0800 Subject: 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 Reviewed-by: Brian Behlendorf Reviewed-by: George Melikov Signed-off-by: Olaf Faaland Closes #7172 --- man/man8/zinject.8 | 3 +++ 1 file changed, 3 insertions(+) (limited to 'man/man8/zinject.8') 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 -- cgit v1.2.3