projects / mirror_zfs.git / blame
| Commit | Line | Data |
|---|---|---|
| c5ebfbbe RW |
1 | .\" |
| 2 | .\" CDDL HEADER START | |
| 3 | .\" | |
| 4 | .\" The contents of this file are subject to the terms of the | |
| 5 | .\" Common Development and Distribution License (the "License"). | |
| 6 | .\" You may not use this file except in compliance with the License. | |
| 7 | .\" | |
| 8 | .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE | |
| 1d3ba0bf | 9 | .\" or https://opensource.org/licenses/CDDL-1.0. |
| c5ebfbbe RW |
10 | .\" See the License for the specific language governing permissions |
| 11 | .\" and limitations under the License. | |
| 12 | .\" | |
| 13 | .\" When distributing Covered Code, include this CDDL HEADER in each | |
| 14 | .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. | |
| 15 | .\" If applicable, add the following below this CDDL HEADER, with the | |
| 16 | .\" fields enclosed by brackets "[]" replaced with your own identifying | |
| 17 | .\" information: Portions Copyright [yyyy] [name of copyright owner] | |
| 18 | .\" | |
| 19 | .\" CDDL HEADER END | |
| 20 | .\" | |
| c5ebfbbe RW |
21 | .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. |
| 22 | .\" Copyright (c) 2012, 2018 by Delphix. All rights reserved. | |
| 23 | .\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. | |
| 24 | .\" Copyright (c) 2017 Datto Inc. | |
| 25 | .\" Copyright (c) 2018 George Melikov. All Rights Reserved. | |
| 26 | .\" Copyright 2017 Nexenta Systems, Inc. | |
| 27 | .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. | |
| 28 | .\" | |
| f84fe3fc | 29 | .Dd May 27, 2021 |
| c5ebfbbe | 30 | .Dt ZPOOL-CLEAR 8 |
| 6706552e | 31 | .Os |
| f84fe3fc | 32 | . |
| c5ebfbbe | 33 | .Sh NAME |
| 1e36af8c | 34 | .Nm zpool-clear |
| f84fe3fc | 35 | .Nd clear device errors in ZFS storage pool |
| c5ebfbbe | 36 | .Sh SYNOPSIS |
| 1e36af8c | 37 | .Nm zpool |
| c5ebfbbe | 38 | .Cm clear |
| 69142125 | 39 | .Op Fl -power |
| c5ebfbbe | 40 | .Ar pool |
| f84fe3fc AZ |
41 | .Oo Ar device Oc Ns … |
| 42 | . | |
| c5ebfbbe | 43 | .Sh DESCRIPTION |
| c5ebfbbe RW |
44 | Clears device errors in a pool. |
| 45 | If no arguments are specified, all device errors within the pool are cleared. | |
| 46 | If one or more devices is specified, only those errors associated with the | |
| 47 | specified device or devices are cleared. | |
| 7adc1900 BB |
48 | .Pp |
| 49 | If the pool was suspended it will be brought back online provided the | |
| 50 | devices can be accessed. | |
| 51 | Pools with | |
| f84fe3fc | 52 | .Sy multihost |
| 7adc1900 | 53 | enabled which have been suspended cannot be resumed. |
| f84fe3fc | 54 | While the pool was suspended, it may have been imported on |
| c5ebfbbe | 55 | another host, and resuming I/O could result in pool damage. |
| 69142125 TH |
56 | .Bl -tag -width Ds |
| 57 | .It Fl -power | |
| 58 | Power on the devices's slot in the storage enclosure and wait for the device | |
| 59 | to show up before attempting to clear errors. | |
| 60 | This is done on all the devices specified. | |
| 61 | Alternatively, you can set the | |
| 62 | .Sy ZPOOL_AUTO_POWER_ON_SLOT | |
| 63 | environment variable to always enable this behavior. | |
| 64 | Note: This flag currently works on Linux only. | |
| 65 | .El | |
| f84fe3fc | 66 | . |
| c5ebfbbe RW |
67 | .Sh SEE ALSO |
| 68 | .Xr zdb 8 , | |
| 69 | .Xr zpool-reopen 8 , | |
| 70 | .Xr zpool-status 8 |