From 66a9d611747b3ae2b1f58f41e63e4cdb52cc593c Mon Sep 17 00:00:00 2001 From: Brian Behlendorf Date: Fri, 14 Jan 2022 15:30:07 -0800 Subject: [PATCH] Clarify `failmode=wait` documentation Nowhere in the description of the failmode property does it clearly state how to bring a suspended pool back online. Add a few words to property description and the zpool-clear(8) man page. Reviewed-by: George Melikov Signed-off-by: Brian Behlendorf Closes #12907 Closes #9395 --- man/man7/zpoolprops.7 | 3 ++- man/man8/zpool-clear.8 | 7 +++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/man/man7/zpoolprops.7 b/man/man7/zpoolprops.7 index 513f02e0314f..543920a1d58e 100644 --- a/man/man7/zpoolprops.7 +++ b/man/man7/zpoolprops.7 @@ -337,7 +337,8 @@ The behavior of such an event is determined as follows: .Bl -tag -width "continue" .It Sy wait Blocks all I/O access until the device connectivity is recovered and the errors -are cleared. +are cleared with +.Nm zpool Cm clear . This is the default behavior. .It Sy continue Returns diff --git a/man/man8/zpool-clear.8 b/man/man8/zpool-clear.8 index 6e41566ca6da..0b256b28bd21 100644 --- a/man/man8/zpool-clear.8 +++ b/man/man8/zpool-clear.8 @@ -44,9 +44,12 @@ Clears device errors in a pool. If no arguments are specified, all device errors within the pool are cleared. If one or more devices is specified, only those errors associated with the specified device or devices are cleared. -If +.Pp +If the pool was suspended it will be brought back online provided the +devices can be accessed. +Pools with .Sy multihost -is enabled and the pool has been suspended, this will not resume I/O. +enabled which have been suspended cannot be resumed. While the pool was suspended, it may have been imported on another host, and resuming I/O could result in pool damage. .