xref: /freebsd/sys/contrib/openzfs/man/man8/zpool-offline.8 (revision eda14cbc264d6969b02f2b1994cef11148e914f1)
1*eda14cbcSMatt Macy.\"
2*eda14cbcSMatt Macy.\" CDDL HEADER START
3*eda14cbcSMatt Macy.\"
4*eda14cbcSMatt Macy.\" The contents of this file are subject to the terms of the
5*eda14cbcSMatt Macy.\" Common Development and Distribution License (the "License").
6*eda14cbcSMatt Macy.\" You may not use this file except in compliance with the License.
7*eda14cbcSMatt Macy.\"
8*eda14cbcSMatt Macy.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*eda14cbcSMatt Macy.\" or http://www.opensolaris.org/os/licensing.
10*eda14cbcSMatt Macy.\" See the License for the specific language governing permissions
11*eda14cbcSMatt Macy.\" and limitations under the License.
12*eda14cbcSMatt Macy.\"
13*eda14cbcSMatt Macy.\" When distributing Covered Code, include this CDDL HEADER in each
14*eda14cbcSMatt Macy.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*eda14cbcSMatt Macy.\" If applicable, add the following below this CDDL HEADER, with the
16*eda14cbcSMatt Macy.\" fields enclosed by brackets "[]" replaced with your own identifying
17*eda14cbcSMatt Macy.\" information: Portions Copyright [yyyy] [name of copyright owner]
18*eda14cbcSMatt Macy.\"
19*eda14cbcSMatt Macy.\" CDDL HEADER END
20*eda14cbcSMatt Macy.\"
21*eda14cbcSMatt Macy.\"
22*eda14cbcSMatt Macy.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
23*eda14cbcSMatt Macy.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
24*eda14cbcSMatt Macy.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
25*eda14cbcSMatt Macy.\" Copyright (c) 2017 Datto Inc.
26*eda14cbcSMatt Macy.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
27*eda14cbcSMatt Macy.\" Copyright 2017 Nexenta Systems, Inc.
28*eda14cbcSMatt Macy.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
29*eda14cbcSMatt Macy.\"
30*eda14cbcSMatt Macy.Dd August 9, 2019
31*eda14cbcSMatt Macy.Dt ZPOOL-OFFLINE 8
32*eda14cbcSMatt Macy.Os
33*eda14cbcSMatt Macy.Sh NAME
34*eda14cbcSMatt Macy.Nm zpool Ns Pf - Cm offline
35*eda14cbcSMatt Macy.Nd Take a physical device in a ZFS storage pool offline
36*eda14cbcSMatt Macy.Sh SYNOPSIS
37*eda14cbcSMatt Macy.Nm
38*eda14cbcSMatt Macy.Cm offline
39*eda14cbcSMatt Macy.Op Fl f
40*eda14cbcSMatt Macy.Op Fl t
41*eda14cbcSMatt Macy.Ar pool Ar device Ns ...
42*eda14cbcSMatt Macy.Nm
43*eda14cbcSMatt Macy.Cm online
44*eda14cbcSMatt Macy.Op Fl e
45*eda14cbcSMatt Macy.Ar pool Ar device Ns ...
46*eda14cbcSMatt Macy.Sh DESCRIPTION
47*eda14cbcSMatt Macy.Bl -tag -width Ds
48*eda14cbcSMatt Macy.It Xo
49*eda14cbcSMatt Macy.Nm
50*eda14cbcSMatt Macy.Cm offline
51*eda14cbcSMatt Macy.Op Fl f
52*eda14cbcSMatt Macy.Op Fl t
53*eda14cbcSMatt Macy.Ar pool Ar device Ns ...
54*eda14cbcSMatt Macy.Xc
55*eda14cbcSMatt MacyTakes the specified physical device offline.
56*eda14cbcSMatt MacyWhile the
57*eda14cbcSMatt Macy.Ar device
58*eda14cbcSMatt Macyis offline, no attempt is made to read or write to the device.
59*eda14cbcSMatt MacyThis command is not applicable to spares.
60*eda14cbcSMatt Macy.Bl -tag -width Ds
61*eda14cbcSMatt Macy.It Fl f
62*eda14cbcSMatt MacyForce fault. Instead of offlining the disk, put it into a faulted
63*eda14cbcSMatt Macystate. The fault will persist across imports unless the
64*eda14cbcSMatt Macy.Fl t
65*eda14cbcSMatt Macyflag was specified.
66*eda14cbcSMatt Macy.It Fl t
67*eda14cbcSMatt MacyTemporary.
68*eda14cbcSMatt MacyUpon reboot, the specified physical device reverts to its previous state.
69*eda14cbcSMatt Macy.El
70*eda14cbcSMatt Macy.It Xo
71*eda14cbcSMatt Macy.Nm
72*eda14cbcSMatt Macy.Cm online
73*eda14cbcSMatt Macy.Op Fl e
74*eda14cbcSMatt Macy.Ar pool Ar device Ns ...
75*eda14cbcSMatt Macy.Xc
76*eda14cbcSMatt MacyBrings the specified physical device online.
77*eda14cbcSMatt MacyThis command is not applicable to spares.
78*eda14cbcSMatt Macy.Bl -tag -width Ds
79*eda14cbcSMatt Macy.It Fl e
80*eda14cbcSMatt MacyExpand the device to use all available space.
81*eda14cbcSMatt MacyIf the device is part of a mirror or raidz then all devices must be expanded
82*eda14cbcSMatt Macybefore the new space will become available to the pool.
83*eda14cbcSMatt Macy.El
84*eda14cbcSMatt Macy.El
85*eda14cbcSMatt Macy.Sh SEE ALSO
86*eda14cbcSMatt Macy.Xr zpool-detach 8 ,
87*eda14cbcSMatt Macy.Xr zpool-remove 8 ,
88*eda14cbcSMatt Macy.Xr zpool-reopen 8 ,
89*eda14cbcSMatt Macy.Xr zpool-resilver 8
90