diff options
author | Sol Jerome <sol.jerome@gmail.com> | 2015-09-01 10:23:10 -0500 |
---|---|---|
committer | Sol Jerome <sol.jerome@gmail.com> | 2015-09-01 10:23:10 -0500 |
commit | 75466a831a92ab136a9cc2b6b875d20f0b00a889 (patch) | |
tree | e83728ee5a1f67e072e4d6fba0b7c71ecb352253 /doc | |
parent | 824879eb85a1065e842930485778a594b914c77f (diff) | |
parent | 3259a1611edf97241b3a2d1bd585185907fe4e9c (diff) | |
download | bcfg2-75466a831a92ab136a9cc2b6b875d20f0b00a889.tar.gz bcfg2-75466a831a92ab136a9cc2b6b875d20f0b00a889.tar.bz2 bcfg2-75466a831a92ab136a9cc2b6b875d20f0b00a889.zip |
Merge branch 'rules-replace_name' of https://github.com/AlexanderS/bcfg2
Diffstat (limited to 'doc')
-rw-r--r-- | doc/releases/1.4.0pre2.txt | 1 | ||||
-rw-r--r-- | doc/server/plugins/generators/rules.txt | 20 | ||||
-rw-r--r-- | doc/server/plugins/structures/defaults.txt | 7 |
3 files changed, 28 insertions, 0 deletions
diff --git a/doc/releases/1.4.0pre2.txt b/doc/releases/1.4.0pre2.txt index 1dcdf237b..1ed2ae70f 100644 --- a/doc/releases/1.4.0pre2.txt +++ b/doc/releases/1.4.0pre2.txt @@ -19,6 +19,7 @@ environments. * NagiosGen: Add bundles to configuration * HomeBrew: Initial add of plugin +* Rules/Defaults: Add possibility to use name of entry in attributes backwards-incompatible user-facing changes ------------------------------------------ diff --git a/doc/server/plugins/generators/rules.txt b/doc/server/plugins/generators/rules.txt index e4f47c2bf..7aeec6990 100644 --- a/doc/server/plugins/generators/rules.txt +++ b/doc/server/plugins/generators/rules.txt @@ -512,3 +512,23 @@ you'd have to explicitly specify ``<Service name="bcfg2.*".../>``. Note that only one Rule can apply to any abstract entry, so you cannot specify multiple regexes to match the same rule. + +Replacing the name of the Entry in Attributes +============================================= + +If you are using regular expressions to match the abstract configuration +entries, you may need the concrete name of the entry in some attributes. +To use this feature, you have to enable it. It is only useful, if used +together with regex matching. :: + + [rules] + regex = yes + replace_name = yes + +You now can write something like that in your xml file: + +.. code-block:: xml + + <POSIXUser name='.*' home='/somewhere/%{name}'/> + +``%{name}`` will be correctly replaced with the username for each POSIXUser. diff --git a/doc/server/plugins/structures/defaults.txt b/doc/server/plugins/structures/defaults.txt index 58b9feddb..9d37b8e64 100644 --- a/doc/server/plugins/structures/defaults.txt +++ b/doc/server/plugins/structures/defaults.txt @@ -29,3 +29,10 @@ on Fedora 15 and the ``chkconfig`` tool on Fedora 14, you could do:: If you were to specify a ``type`` attribute for a Service entry in Rules (or a ``type`` attribute for a BoundService entry in Bundler), that would take precendence over the default. + +Like :ref:`server-plugins-generators-rules`, Defaults can also replace +``%{name}`` in attributes with the real name of the entry. To enable this, +add the following setting to ``bcfg2.conf``:: + + [defaults] + replace_name = yes |