summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorChris St. Pierre <chris.a.st.pierre@gmail.com>2013-02-05 08:58:41 -0500
committerChris St. Pierre <chris.a.st.pierre@gmail.com>2013-02-05 08:58:41 -0500
commitf05d66c4858f9757b1a372f0a5de2c956c058f00 (patch)
treeda2775f1c99ce2a930a720cb3957663c91442ffe /doc
parentc3c449f509e5f849212e853b410b7b74341d3e1e (diff)
downloadbcfg2-f05d66c4858f9757b1a372f0a5de2c956c058f00.tar.gz
bcfg2-f05d66c4858f9757b1a372f0a5de2c956c058f00.tar.bz2
bcfg2-f05d66c4858f9757b1a372f0a5de2c956c058f00.zip
Decisions: use StructFile instead of host- or group-specific XML files
Diffstat (limited to 'doc')
-rw-r--r--doc/server/plugins/generators/decisions.txt25
1 files changed, 12 insertions, 13 deletions
diff --git a/doc/server/plugins/generators/decisions.txt b/doc/server/plugins/generators/decisions.txt
index 9a40ab8fd..f0afeba0a 100644
--- a/doc/server/plugins/generators/decisions.txt
+++ b/doc/server/plugins/generators/decisions.txt
@@ -29,18 +29,23 @@ client's whitelists or blacklists.
is not used. See `Decision Mode`_ below.
The Decisions plugin uses a directory in the Bcfg2 repository called
-Decisions. Files in the Decisions subdirectory are named similarly to
-files managed by Cfg and Probes, so you can use host- and
-group-specific files and the like after their basename. File basenames
-are either ``whitelist`` or ``blacklist``. These files have a simple
-format; the following is an example.
+Decisions, which may contain two files: ``whitelist.xml`` and
+``blacklist.xml``. These files have a simple format:
+
+.. xml:type:: DecisionsType
+ :linktotype:
+ :noautodep: py:genshiElements
+
+For example:
.. code-block:: xml
- $ cat Decisions/whitelist
+ $ cat Decisions/whitelist.xml
<Decisions>
<Decision type='Service' name='*'/>
- <Decision type='Path' name='/etc/apt/apt.conf'/>
+ <Group name="debian">
+ <Decision type='Path' name='/etc/apt/apt.conf'/>
+ </Group>
</Decisions>
This example, included as a whitelist due to its name, enables all services,
@@ -60,12 +65,6 @@ list. This list is sent to the client.
control these via their respective options (``-I`` or ``-n``, for
example).
-To add syntax highlighting to Decisions files in vim and emacs, you
-can add comments such as this::
-
- <Decisions><!--*- mode: xml; -*-->
- <!-- vim: set ft=xml : -->
-
Decision Mode
=============