xref: /freebsd/sys/contrib/openzfs/man/man8/zpool-destroy.8 (revision 271171e0d97b88ba2a7c3bf750c9672b484c1c13)
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
9*271171e0SMartin 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.\"
29da5137abSMartin Matuska.Dd March 16, 2022
30eda14cbcSMatt Macy.Dt ZPOOL-DESTROY 8
31eda14cbcSMatt Macy.Os
3216038816SMartin Matuska.
33eda14cbcSMatt Macy.Sh NAME
347877fdebSMatt Macy.Nm zpool-destroy
3516038816SMartin Matuska.Nd destroy ZFS storage pool
36eda14cbcSMatt Macy.Sh SYNOPSIS
377877fdebSMatt Macy.Nm zpool
38eda14cbcSMatt Macy.Cm destroy
39eda14cbcSMatt Macy.Op Fl f
40eda14cbcSMatt Macy.Ar pool
4116038816SMartin Matuska.
42eda14cbcSMatt Macy.Sh DESCRIPTION
43eda14cbcSMatt MacyDestroys the given pool, freeing up any devices for other use.
44eda14cbcSMatt MacyThis command tries to unmount any active datasets before destroying the pool.
45eda14cbcSMatt Macy.Bl -tag -width Ds
46eda14cbcSMatt Macy.It Fl f
4716038816SMartin MatuskaForcefully unmount all active datasets.
48eda14cbcSMatt Macy.El
49da5137abSMartin Matuska.
50da5137abSMartin Matuska.Sh EXAMPLES
51da5137abSMartin Matuska.\" These are, respectively, examples 7 from zpool.8
52da5137abSMartin Matuska.\" Make sure to update them bidirectionally
53da5137abSMartin Matuska.Ss Example 1 : No Destroying a ZFS Storage Pool
54da5137abSMartin MatuskaThe following command destroys the pool
55da5137abSMartin Matuska.Ar tank
56da5137abSMartin Matuskaand any datasets contained within:
57da5137abSMartin Matuska.Dl # Nm zpool Cm destroy Fl f Ar tank
58