``role::softioc``
=================

This role implements a GFA SoftIOC system.


Parameters
----------

==============  ========  ===================================
enable_afs      bool      hiera('softioc::enable_afs', false)
local_homes     bool      hiera('softioc::local_homes')
mount_root      string    hiera('softioc::mount_root')
mounts          hash      hiera_hash('softioc::mounts', {})
symlink_root    string    hiera('softioc::symlink_root')
users           array     hiera('softioc::users', [])
==============  ========  ===================================


``enable_afs``
~~~~~~~~~~~~~~~

Configures AFS access and pmodule.


``local_homes``
~~~~~~~~~~~~~~~

If this is true, the home directories on the system will be in ``/home/%u``.


``mount_root``
~~~~~~~~~~~~~~

The directory where the mounts given in ``mounts`` are mounted.


``mounts``
~~~~~~~~~~

A hash defining the mounts to be mounted below ``mount_root``.


``symlink_root``
~~~~~~~~~~~~~~~~

This defines the directory where symlinks to the mounts defined by ``mounts``
are created.


``users``
~~~~~~~~~

This overrides the ``aaa::users`` parameter.


Examples
--------

Configuration::

  softioc::mount_root: '/gfa/.mounts'
  softioc::symlink_root: '/sf'
  softioc::mounts:
    'data':
      ...

Resulting files:

- ``/gfa/.mounts/data``: mountpoint for ``data``
- ``/sf/data ``: symlink to ``/gfa/.mounts/data``
