xref: /freebsd/sys/contrib/openzfs/man/man8/zpool-reguid.8 (revision e2df9bb44109577475aeb186e7186ac040f9bde1)
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.
28*e2df9bb4SMartin Matuska.\" Copyright (c) 2024, Klara Inc.
29*e2df9bb4SMartin Matuska.\" Copyright (c) 2024, Mateusz Piotrowski
30eda14cbcSMatt Macy.\"
31*e2df9bb4SMartin Matuska.Dd June 21, 2023
32eda14cbcSMatt Macy.Dt ZPOOL-REGUID 8
33eda14cbcSMatt Macy.Os
3416038816SMartin Matuska.
35eda14cbcSMatt Macy.Sh NAME
367877fdebSMatt Macy.Nm zpool-reguid
3716038816SMartin Matuska.Nd generate new unique identifier for ZFS storage pool
38eda14cbcSMatt Macy.Sh SYNOPSIS
397877fdebSMatt Macy.Nm zpool
40eda14cbcSMatt Macy.Cm reguid
41*e2df9bb4SMartin Matuska.Op Fl g Ar guid
42eda14cbcSMatt Macy.Ar pool
4316038816SMartin Matuska.
44eda14cbcSMatt Macy.Sh DESCRIPTION
45eda14cbcSMatt MacyGenerates a new unique identifier for the pool.
46eda14cbcSMatt MacyYou must ensure that all devices in this pool are online and healthy before
47eda14cbcSMatt Macyperforming this action.
4816038816SMartin Matuska.
49*e2df9bb4SMartin Matuska.Bl -tag -width Ds
50*e2df9bb4SMartin Matuska.It Fl g Ar guid
51*e2df9bb4SMartin MatuskaSet the pool GUID to the provided value.
52*e2df9bb4SMartin MatuskaThe GUID can be any 64-bit value accepted by
53*e2df9bb4SMartin Matuska.Xr strtoull 3
54*e2df9bb4SMartin Matuskain base 10.
55*e2df9bb4SMartin Matuska.Nm
56*e2df9bb4SMartin Matuskawill return an error if the provided GUID is already in use.
57*e2df9bb4SMartin Matuska.El
58eda14cbcSMatt Macy.Sh SEE ALSO
59eda14cbcSMatt Macy.Xr zpool-export 8 ,
60eda14cbcSMatt Macy.Xr zpool-import 8
61