``profile::files``
==================

This profile creates symlinks.


Parameters
----------

===============================  ========  ================================================
**Name**                         **Type**  **Default**
-------------------------------  --------  ------------------------------------------------
symlinks                         hash      hiera('files::symlinks')
directories                      hash      hiera_hash('files::directories')
===============================  ========  ================================================


``symlinks``
~~~~~~~~~~~~

A hash specifying symlinks to be created. The keys of the hash are the absolute
pathnames of the symlinks, the values of the hash are the corresponding symlink
targets.

Example::

  files::symlinks:
    '/opt/foo': '/var/lib/foo'



``directories``
~~~~~~~~~~~~~~~

A hash specifying directories to be created. The keys of the hash are the absolute
pathnames of the directory, the optional values can be ``owner``, ``group`` (default is ``root`` for both) and the ``mode`` (default ``755``). Parent directories are automatically created with default settings. If that is not desired, do a custom definition for each parent directory too.

Example::

  files::directories:
    /etc/test1:
    /etc/test2/foo/bar:
      owner: 'buchel_k'
      group: 'unx-nogroup'
      mode: '775'