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) 2009 Sun Microsystems, Inc. All Rights Reserved. 23*eda14cbcSMatt Macy.\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org> 24*eda14cbcSMatt Macy.\" Copyright (c) 2011, 2019 by Delphix. All rights reserved. 25*eda14cbcSMatt Macy.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved. 26*eda14cbcSMatt Macy.\" Copyright (c) 2014, Joyent, Inc. All rights reserved. 27*eda14cbcSMatt Macy.\" Copyright (c) 2014 by Adam Stevko. All rights reserved. 28*eda14cbcSMatt Macy.\" Copyright (c) 2014 Integros [integros.com] 29*eda14cbcSMatt Macy.\" Copyright 2019 Richard Laager. All rights reserved. 30*eda14cbcSMatt Macy.\" Copyright 2018 Nexenta Systems, Inc. 31*eda14cbcSMatt Macy.\" Copyright 2019 Joyent, Inc. 32*eda14cbcSMatt Macy.\" 33*eda14cbcSMatt Macy.Dd June 30, 2019 34*eda14cbcSMatt Macy.Dt ZFS-PROMOTE 8 35*eda14cbcSMatt Macy.Os 36*eda14cbcSMatt Macy.Sh NAME 37*eda14cbcSMatt Macy.Nm zfs Ns Pf - Cm promote 38*eda14cbcSMatt Macy.Nd Promotes a clone file system to no longer be dependent on its origin snapshot. 39*eda14cbcSMatt Macy.Sh SYNOPSIS 40*eda14cbcSMatt Macy.Nm 41*eda14cbcSMatt Macy.Cm promote 42*eda14cbcSMatt Macy.Ar clone-filesystem 43*eda14cbcSMatt Macy.Sh DESCRIPTION 44*eda14cbcSMatt Macy.Bl -tag -width "" 45*eda14cbcSMatt Macy.It Xo 46*eda14cbcSMatt Macy.Nm 47*eda14cbcSMatt Macy.Cm promote 48*eda14cbcSMatt Macy.Ar clone-filesystem 49*eda14cbcSMatt Macy.Xc 50*eda14cbcSMatt MacyThe 51*eda14cbcSMatt Macy.Cm promote 52*eda14cbcSMatt Macycommand makes it possible to destroy the file system that the clone was created 53*eda14cbcSMatt Macyfrom. 54*eda14cbcSMatt MacyThe clone parent-child dependency relationship is reversed, so that the origin 55*eda14cbcSMatt Macyfile system becomes a clone of the specified file system. 56*eda14cbcSMatt Macy.Pp 57*eda14cbcSMatt MacyThe snapshot that was cloned, and any snapshots previous to this snapshot, are 58*eda14cbcSMatt Macynow owned by the promoted clone. 59*eda14cbcSMatt MacyThe space they use moves from the origin file system to the promoted clone, so 60*eda14cbcSMatt Macyenough space must be available to accommodate these snapshots. 61*eda14cbcSMatt MacyNo new space is consumed by this operation, but the space accounting is 62*eda14cbcSMatt Macyadjusted. 63*eda14cbcSMatt MacyThe promoted clone must not have any conflicting snapshot names of its own. 64*eda14cbcSMatt MacyThe 65*eda14cbcSMatt Macy.Xr zfs-rename 8 66*eda14cbcSMatt Macysubcommand can be used to rename any conflicting snapshots. 67*eda14cbcSMatt Macy.El 68*eda14cbcSMatt Macy.Sh SEE ALSO 69*eda14cbcSMatt Macy.Xr zfs-clone 8 70