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

ftjail-populate-tmpl
====================

Synopsis
--------

**ftjail populate-tmpl** [**-b**] **-L** `directory` `path/to/base.txz` [`path/to/kernel.txz`]

**ftjail populate-tmpl** [**-b**] **-P** `directory` `path/to/base.txz` [`path/to/kernel.txz`]


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

Populate the directory in `directory` with a FreeBSD base system.
The base system's archive ist in `path/to/base.txz`.

Optionally a FreeBSD kernel can be extracted also.

The directory in `directory` must already have a proper
directory layout.
This can be accomplished by :manpage:`ftjail-mount-tmpl(8)`.

Apply knowledge of the type and typical layout of the RW skeleton
(e.g. handle the :file:`skeleton` symlink properly).


Options
-------

.. program:: ftjail populate-tmpl

.. option:: -L

   Copy dataset properties optimized for employing a :file:`skeleton`
   subdirectory.

.. option:: -P

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

.. option:: -b

   Do not empty the ``/boot`` folder in `directory` but preserve it.
   This option is implied if a `path/to/kernel.txz` is given.


See Also
--------

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