summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/grouping/metadata.txt
diff options
context:
space:
mode:
authorSol Jerome <sol.jerome@gmail.com>2010-12-08 19:43:54 -0600
committerSol Jerome <sol.jerome@gmail.com>2010-12-08 19:43:54 -0600
commit477c0fc85218cba12597cf3daf7728b127b0fd64 (patch)
tree0da3e2c73535cd97c22791e51e20b18b3192506c /doc/server/plugins/grouping/metadata.txt
parent9f55492d9213861c75496e6c493ad90bb5c23872 (diff)
downloadbcfg2-477c0fc85218cba12597cf3daf7728b127b0fd64.tar.gz
bcfg2-477c0fc85218cba12597cf3daf7728b127b0fd64.tar.bz2
bcfg2-477c0fc85218cba12597cf3daf7728b127b0fd64.zip
doc: Finish merging remaining documentation updates
Signed-off-by: Sol Jerome <sol.jerome@gmail.com>
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 |
++------------------------------+------------------------------------------------+-------------------+