From a62434960530f6e8a27df1ab8993621aba6aa1f1 Mon Sep 17 00:00:00 2001
From: Iustin Pop <iustin@google.com>
Date: Sat, 13 Nov 2010 20:24:40 +0100
Subject: [PATCH] Add RST version of ganeti-confd man page
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Iustin Pop <iustin@google.com>
Reviewed-by: RenΓ© Nussbaumer <rn@google.com>
---
 man/ganeti-confd.rst | 49 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 man/ganeti-confd.rst

diff --git a/man/ganeti-confd.rst b/man/ganeti-confd.rst
new file mode 100644
index 000000000..3370664eb
--- /dev/null
+++ b/man/ganeti-confd.rst
@@ -0,0 +1,49 @@
+ganeti-confd(8) Ganeti | Version @GANETI_VERSION@
+=================================================
+
+Name
+----
+
+ganeti-confd - Ganeti conf daemon
+
+Synopsis
+--------
+
+**ganeti-confd** [-f] [-d]
+
+DESCRIPTION
+-----------
+
+**ganeti-confd** is a daemon used to answer queries related to the
+configuration of a Ganeti cluster.
+
+For testing purposes, you can give the ``-f`` option and the
+program won't detach from the running terminal.
+
+Debug-level message can be activated by giving the ``-d`` option.
+
+ROLE
+~~~~
+
+The role of the conf daemon is to make sure we have a highly available
+and very fast way to query cluster configuration values.  This daemon
+is automatically active on all master candidates, and so has no single
+point of failure. It communicates via UDP so each query can easily be
+sent to multiple servers, and it answers queries from a cached copy of
+the config it keeps in memory, so no disk access is required to get an
+answer.
+
+The config is reloaded from disk automatically when it changes, with a
+rate limit of once per second.
+
+If the conf daemon is stopped on all nodes, its clients won't be able
+to get query answers.
+
+COMMUNICATION PROTOCOL
+~~~~~~~~~~~~~~~~~~~~~~
+
+The confd protocol is an HMAC authenticated json-encoded custom
+format, over UDP. A client library is provided to make it easy to
+write software to query confd. More information can be found in the
+Ganeti 2.1 design doc, and an example usage can be seen in the
+(external) NBMA daemon for Ganeti.
-- 
GitLab