xref: /freebsd/sys/contrib/openzfs/man/man8/zpool-clear.8 (revision b985c9cafd2aedac5cf92428c0211485ea4ede24)
1eda14cbcSMatt Macy.\"
2eda14cbcSMatt Macy.\" CDDL HEADER START
3eda14cbcSMatt Macy.\"
4eda14cbcSMatt Macy.\" The contents of this file are subject to the terms of the
5eda14cbcSMatt Macy.\" Common Development and Distribution License (the "License").
6eda14cbcSMatt Macy.\" You may not use this file except in compliance with the License.
7eda14cbcSMatt Macy.\"
8eda14cbcSMatt Macy.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9271171e0SMartin Matuska.\" or https://opensource.org/licenses/CDDL-1.0.
10eda14cbcSMatt Macy.\" See the License for the specific language governing permissions
11eda14cbcSMatt Macy.\" and limitations under the License.
12eda14cbcSMatt Macy.\"
13eda14cbcSMatt Macy.\" When distributing Covered Code, include this CDDL HEADER in each
14eda14cbcSMatt Macy.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15eda14cbcSMatt Macy.\" If applicable, add the following below this CDDL HEADER, with the
16eda14cbcSMatt Macy.\" fields enclosed by brackets "[]" replaced with your own identifying
17eda14cbcSMatt Macy.\" information: Portions Copyright [yyyy] [name of copyright owner]
18eda14cbcSMatt Macy.\"
19eda14cbcSMatt Macy.\" CDDL HEADER END
20eda14cbcSMatt Macy.\"
21eda14cbcSMatt Macy.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
22eda14cbcSMatt Macy.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
23eda14cbcSMatt Macy.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
24eda14cbcSMatt Macy.\" Copyright (c) 2017 Datto Inc.
25eda14cbcSMatt Macy.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
26eda14cbcSMatt Macy.\" Copyright 2017 Nexenta Systems, Inc.
27eda14cbcSMatt Macy.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
28eda14cbcSMatt Macy.\"
2916038816SMartin Matuska.Dd May 27, 2021
30eda14cbcSMatt Macy.Dt ZPOOL-CLEAR 8
31eda14cbcSMatt Macy.Os
3216038816SMartin Matuska.
33eda14cbcSMatt Macy.Sh NAME
347877fdebSMatt Macy.Nm zpool-clear
3516038816SMartin Matuska.Nd clear device errors in ZFS storage pool
36eda14cbcSMatt Macy.Sh SYNOPSIS
377877fdebSMatt Macy.Nm zpool
38eda14cbcSMatt Macy.Cm clear
39b356da80SMartin Matuska.Op Fl -power
40eda14cbcSMatt Macy.Ar pool
4116038816SMartin Matuska.Oo Ar device Oc Ns …
4216038816SMartin Matuska.
43eda14cbcSMatt Macy.Sh DESCRIPTION
44eda14cbcSMatt MacyClears device errors in a pool.
45eda14cbcSMatt MacyIf no arguments are specified, all device errors within the pool are cleared.
46eda14cbcSMatt MacyIf one or more devices is specified, only those errors associated with the
47eda14cbcSMatt Macyspecified device or devices are cleared.
48e92ffd9bSMartin Matuska.Pp
49e92ffd9bSMartin MatuskaIf the pool was suspended it will be brought back online provided the
50e92ffd9bSMartin Matuskadevices can be accessed.
51e92ffd9bSMartin MatuskaPools with
5216038816SMartin Matuska.Sy multihost
53*b985c9caSMartin Matuskaenabled which have been suspended cannot be resumed when there is evidence
54*b985c9caSMartin Matuskathat the pool was imported by another host.
55*b985c9caSMartin MatuskaThe same checks performed during an import will be applied before the clear
56*b985c9caSMartin Matuskaproceeds.
57b356da80SMartin Matuska.Bl -tag -width Ds
58b356da80SMartin Matuska.It Fl -power
59b356da80SMartin MatuskaPower on the devices's slot in the storage enclosure and wait for the device
60b356da80SMartin Matuskato show up before attempting to clear errors.
61b356da80SMartin MatuskaThis is done on all the devices specified.
62b356da80SMartin MatuskaAlternatively, you can set the
63b356da80SMartin Matuska.Sy ZPOOL_AUTO_POWER_ON_SLOT
64b356da80SMartin Matuskaenvironment variable to always enable this behavior.
65b356da80SMartin MatuskaNote: This flag currently works on Linux only.
66b356da80SMartin Matuska.El
6716038816SMartin Matuska.
68eda14cbcSMatt Macy.Sh SEE ALSO
69eda14cbcSMatt Macy.Xr zdb 8 ,
70eda14cbcSMatt Macy.Xr zpool-reopen 8 ,
71eda14cbcSMatt Macy.Xr zpool-status 8
72