DOKK / manpages / debian 12 / libconfig-model-perl / Config::Model::Value::LayeredInclude.3pm.en
Config::Model::Value::LayeredInclude(3pm) User Contributed Perl Documentation Config::Model::Value::LayeredInclude(3pm)

Config::Model::Value::LayeredInclude - Include a sub layer configuration

version 2.152

    # in a model declaration:
    'element' => [
      'include' => {
        'class' => 'Config::Model::Value::LayeredInclude',
        # usual Config::Model::Value parameters
        'type' => 'leaf',
        'value_type' => 'uniline',
        'convert' => 'lc',
        'summary' => 'Include file for cascaded configuration',
        'description' => 'To support multiple variants of ...'
      },
    ]

This class inherits from Config::Model::Value. It overrides _store to trigger a refresh of layered value when a value is changed. I.e. changing this value trigger a reload of the referred configuration file which values are used as default value. This class was designed to cope with multistrap <http://wiki.debian.org/Multistrap> configuration.

CAUTION

A configuration file can support 2 kinds of include:

  • Layered include which sets default values like multistrap or ssh. These includes are read-only.
  • Real includes like "apache". In this cases modified configuration items can be written to included files.

This class works only with the first type

Dominique Dumont

This software is Copyright (c) 2005-2022 by Dominique Dumont.

This is free software, licensed under:

  The GNU Lesser General Public License, Version 2.1, February 1999
2022-07-28 perl v5.34.0