summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/grouping/metadata.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/server/plugins/grouping/metadata.txt')
-rw-r--r--doc/server/plugins/grouping/metadata.txt66
1 files changed, 66 insertions, 0 deletions
diff --git a/doc/server/plugins/grouping/metadata.txt b/doc/server/plugins/grouping/metadata.txt
index 96fc70ff5..fc452eb2f 100644
--- a/doc/server/plugins/grouping/metadata.txt
+++ b/doc/server/plugins/grouping/metadata.txt
@@ -225,3 +225,69 @@ Probes
The metadata plugin includes client-side probing functionality. This
is fully documented :ref:`here <server-plugins-probes-index>`.
+
+.. _server-plugins-grouping-metadata-clientmetadata:
+
+ClientMetadata
+==============
+
+A special client metadata class is available to the TGenshi and TCheetah
+plugins.
+
++----------------------+------------------------------------------------+-------------------+
+| Attribute | Description | Value |
++======================+================================================+===================+
+| hostname | Client hostname | String |
++----------------------+------------------------------------------------+-------------------+
+| profile | Client profile | String |
++----------------------+------------------------------------------------+-------------------+
+| aliases | Client aliases | List |
++----------------------+------------------------------------------------+-------------------+
+| addresses | Adresses this client is known by | List |
++----------------------+------------------------------------------------+-------------------+
+| groups | Groups this client is a member of | List |
++----------------------+------------------------------------------------+-------------------+
+| categories | Categories of this clients groups | List |
++----------------------+------------------------------------------------+-------------------+
+| uuid | uuid identifier for this client | String |
++----------------------+------------------------------------------------+-------------------+
+| password | bcfg password for this client | String |
++----------------------+------------------------------------------------+-------------------+
+| connectors | connector plugins known to this client | List |
++----------------------+------------------------------------------------+-------------------+
+| query | MetadataQuery object | MetadataQuery |
++----------------------+------------------------------------------------+-------------------+
+
+|
+
++------------------------------+------------------------------------------------+-------------------+
+| Method | Description | Value |
++==============================+================================================+===================+
+| inGroup(group) | True if this client is a memnber of 'group' | Boolean |
++------------------------------+------------------------------------------------+-------------------+
+| group_in_category(category) | Returns the group in 'category' if the client | String |
+| | is a member of 'category', otherwise '' | |
++------------------------------+------------------------------------------------+-------------------+
+
+MetadataQuery
+-------------
+
+This class provides query routines for the servers Metadata.
+
++------------------------------+------------------------------------------------+-------------------+
+| Method | Description | Value |
++==============================+================================================+===================+
+| by_name(client) | Get ClientMetadata object for 'client' | ClientMetadata |
++------------------------------+------------------------------------------------+-------------------+
+| names_by_groups(group) | | |
++------------------------------+------------------------------------------------+-------------------+
+| names_by_profiles(profile) | All clients names in 'profile' | List |
++------------------------------+------------------------------------------------+-------------------+
+| all_clients() | All known client hostnames | List |
++------------------------------+------------------------------------------------+-------------------+
+| all_groups() | All known group names | List |
++------------------------------+------------------------------------------------+-------------------+
+| all_groups_in_category(cat) | All groups in category 'cat' | List |
++------------------------------+------------------------------------------------+-------------------+
+| all() | Get ClientMetadata for all clients | List |
++------------------------------+------------------------------------------------+-------------------+