zfs-patches/0032-Clarify-zinject-8-explanation-of-e.patch

   1 From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
   2 From: Olaf Faaland <faaland1@llnl.gov>
   3 Date: Thu, 15 Feb 2018 09:50:06 -0800
   4 Subject: [PATCH] Clarify zinject(8) explanation of -e
   5 MIME-Version: 1.0
   6 Content-Type: text/plain; charset=UTF-8
   7 Content-Transfer-Encoding: 8bit
   8
   9 Error injection of EIO or ENXIO simply sets the zio's io_error value,
  10 rather than preventing the read or write from occurring.  This is
  11 important information as it affects how the probes must be used.
  12
  13 Reviewed-by: Giuseppe Di Natale <dinatale2@llnl.gov>
  14 Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
  15 Reviewed-by: George Melikov <mail@gmelikov.ru>
  16 Signed-off-by: Olaf Faaland <faaland1@llnl.gov>
  17 Closes #7172
  18 (cherry picked from commit 26941ce90b8f056949a3bc29da606513af799781)
  19 Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
  20 ---
  21  man/man8/zinject.8 | 3 +++
  22  1 file changed, 3 insertions(+)
  23
  24 diff --git a/man/man8/zinject.8 b/man/man8/zinject.8
  25 index 50fecfb64..7f363974b 100644
  26 --- a/man/man8/zinject.8
  27 +++ b/man/man8/zinject.8
  28 @@ -111,6 +111,9 @@ Specify
  29  .BR "dtl" " for an ECHILD error,"
  30  .BR "io" " for an EIO error where reopening the device will succeed, or"
  31  .BR "nxio" " for an ENXIO error where reopening the device will fail."
  32 +For EIO and ENXIO, the "failed" reads or writes still occur.  The probe simply
  33 +sets the error value reported by the I/O pipeline so it appears the read or
  34 +write failed.
  35  .TP
  36  .BI "\-f" " frequency"
  37  Only inject errors a fraction of the time. Expressed as a real number
  38 --
  39 2.14.2
  40