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

ftjail-datasets-tmpl
====================

Synopsis
--------

**ftjail datasets-tmpl** [**-L**] `dataset-parent-base` `dataset-parent-skeleton` `name`

**ftjail datasets-tmpl** [**-P**]  `dataset-parent-base` `dataset-parent-skeleton` `name`


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

Create ZFS template datasets, i.e. the ro base and the rw skeleton to
be used within Thin Jails.

The ZFS datasets `dataset-parent-base` and `dataset-parent-skeleton`
must exist already.

A child with name `name` must not exist already for both given parent
datasets.

All datasets are creating using :command:`zfs create` and employing its
``-u`` option so that the newly created file system is not mounted
automatically at creation time.

See :manpage:`ftjail-mount-tmpl(8)` for properly mounting the created
datasets.


Options
-------

.. program:: ftjail datasets-tmpl

.. option:: -L

   Create dataset properties optimized for employing a
   :file:`skeleton` subdirectory (i.e. Thin Jails using symbolic links
   from a (read-only) root into the writeable parts of the system).

.. option:: -P

   Create ZFS dataset properties optimized for direct mounts of skeleton
   children over an already mounted base.


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

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


See Also
--------

:manpage:`ftjail(8)`, :manpage:`ftjail-mount-tmpl(8)`,