.. -*- coding: utf-8; indent-tabs-mode: nil; -*-

fzfs-clone-tree
===============

.. program:: fzfs clone-tree


Synopsis
--------

**fzfs clone-tree** [**-k**] [**-n**] `source-dataset` `dest-dataset`


Description
-----------

Clone the ZFS snapshot that is rooted at `source-dataset` and all
descendent snapshots into the destination dataset rooted at
`dest-dataset`.

`source-dataset` must be a snapshot. All of its children must have a
snapshot with the very same snapshot.

`dest-dataset` must not exist already.

All properties that are of type ``local`` or ``received`` are copied to the
destination. This is also true for `canmount` and `mountpoint`.

The cloned datasets will are *not* mounted automatically.

If something fails it is tried to delete the intermediately created
datasets.


Options
-------

.. option:: -k

   Do not try to destroy intermediately cloned datasets on errors but
   keep them.

.. option:: -n

   Dry-run. Do not really clone datasets but show what would be done.


Environment
-----------

All environment variables that affect :command:`zfs` are effective also.


See Also
--------

:manpage:`fzfs(8)`