1.\" SPDX-License-Identifier: CDDL-1.0
2.\"
3.\" CDDL HEADER START
4.\"
5.\" The contents of this file are subject to the terms of the
6.\" Common Development and Distribution License (the "License").
7.\" You may not use this file except in compliance with the License.
8.\"
9.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10.\" or https://opensource.org/licenses/CDDL-1.0.
11.\" See the License for the specific language governing permissions
12.\" and limitations under the License.
13.\"
14.\" When distributing Covered Code, include this CDDL HEADER in each
15.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16.\" If applicable, add the following below this CDDL HEADER, with the
17.\" fields enclosed by brackets "[]" replaced with your own identifying
18.\" information: Portions Copyright [yyyy] [name of copyright owner]
19.\"
20.\" CDDL HEADER END
21.\"
22.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
23.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
24.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
25.\" Copyright (c) 2017 Datto Inc.
26.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
27.\" Copyright 2017 Nexenta Systems, Inc.
28.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
29.\"
30.Dd August 9, 2019
31.Dt ZPOOL-OFFLINE 8
32.Os
33.
34.Sh NAME
35.Nm zpool-offline
36.Nd take physical devices offline in ZFS storage pool
37.Sh SYNOPSIS
38.Nm zpool
39.Cm offline
40.Op Fl Sy -power Ns | Ns Op Fl Sy ft
41.Ar pool
42.Ar device Ns …
43.Nm zpool
44.Cm online
45.Op Fl Sy -power
46.Op Fl Sy e
47.Ar pool
48.Ar device Ns …
49.
50.Sh DESCRIPTION
51.Bl -tag -width Ds
52.It Xo
53.Nm zpool
54.Cm offline
55.Op Fl Sy -power Ns | Ns Op Fl Sy ft
56.Ar pool
57.Ar device Ns …
58.Xc
59Takes the specified physical device offline.
60While the
61.Ar device
62is offline, no attempt is made to read or write to the device.
63This command is not applicable to spares.
64.Bl -tag -width Ds
65.It Fl -power
66Power off the device's slot in the storage enclosure.
67This flag currently works on Linux only
68.It Fl f
69Force fault.
70Instead of offlining the disk, put it into a faulted state.
71The fault will persist across imports unless the
72.Fl t
73flag was specified.
74.It Fl t
75Temporary.
76Upon reboot, the specified physical device reverts to its previous state.
77.El
78.It Xo
79.Nm zpool
80.Cm online
81.Op Fl -power
82.Op Fl e
83.Ar pool
84.Ar device Ns …
85.Xc
86Brings the specified physical device online.
87This command is not applicable to spares.
88.Bl -tag -width Ds
89.It Fl -power
90Power on the device's slot in the storage enclosure and wait for the device
91to show up before attempting to online it.
92Alternatively, you can set the
93.Sy ZPOOL_AUTO_POWER_ON_SLOT
94environment variable to always enable this behavior.
95This flag currently works on Linux only
96.It Fl e
97Expand the device to use all available space.
98If the device is part of a mirror or raidz then all devices must be expanded
99before the new space will become available to the pool.
100.El
101.El
102.
103.Sh SEE ALSO
104.Xr zpool-detach 8 ,
105.Xr zpool-remove 8 ,
106.Xr zpool-reopen 8 ,
107.Xr zpool-resilver 8
108