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