[#3242] Added bare-bones perfmon hook library

New files:
    arm/hooks-perfmon.rst
	src/hooks/dhcp/perfmon/.gitattributes
	src/hooks/dhcp/perfmon/.gitignore
	src/hooks/dhcp/perfmon/Makefile.am
	src/hooks/dhcp/perfmon/libloadtests/.gitignore
	src/hooks/dhcp/perfmon/libloadtests/Makefile.am
	src/hooks/dhcp/perfmon/libloadtests/load_unload_unittests.cc
	src/hooks/dhcp/perfmon/libloadtests/run_unittests.cc
	src/hooks/dhcp/perfmon/perfmon.dox
	src/hooks/dhcp/perfmon/perfmon_callouts.cc
	src/hooks/dhcp/perfmon/perfmon_log.cc
	src/hooks/dhcp/perfmon/perfmon_log.h
	src/hooks/dhcp/perfmon/perfmon_messages.cc
	src/hooks/dhcp/perfmon/perfmon_messages.h
	src/hooks/dhcp/perfmon/perfmon_messages.mes
	src/hooks/dhcp/perfmon/tests/.gitignore
	src/hooks/dhcp/perfmon/tests/Makefile.am
	src/hooks/dhcp/perfmon/tests/run_unittests.cc
	src/hooks/dhcp/perfmon/version.cc

Modified:
	configure.ac
	arm/hooks-perfmon.rst
	arm/hooks.rst
	arm/logging.rst
	arm/rst_arm_sources.mk
	conf.py
	src/hooks/dhcp/Makefile.am

doc/sphinx/arm/hooks-perfmon.rst

@@ -0,0 +1,39 @@
+.. ischooklib:: libdhcp_perfmon.so
+.. _hooks-perfmon:
+
+``libdhcp_perfmon.so``: PerfMon
+===============================
+
+This hook library can be loaded by either kea-dhcp4 or kea-dhcp6 servers
+to extend them with the ability to track and report performance related data.
+
+.. note::
+
+    This library is currently under development and not yet functional.
+
+Overview
+~~~~~~~~
+
+The library, added in Kea 2.5.6, can be loaded by the :iscman:`kea-dhcp4` or
+:iscman:`kea-dhcp6` daemon by adding it to the ``hooks-libraries`` element of
+the server's configuration:
+
+.. code-block:: javascript
+
+    {
+        "hooks-libraries": [
+            {
+                "library": "/usr/local/lib/libdhcp_perfmon.so",
+                "parameters": {
+                    ...
+                }
+            },
+            ...
+        ],
+        ...
+    }
+
+Configuration
+~~~~~~~~~~~~~
+
+    TBD

doc/sphinx/arm/hooks.rst

@@ -527,6 +527,10 @@ loaded by the correct process per the table below.
    |                                                           |              | a repository for the Kea configuration information. Kea      |
    |                                                           |              | servers use this library to fetch their configurations.      |
    +-----------------------------------------------------------+--------------+--------------------------------------------------------------+
+   | :ref:`PerfMon <hooks-perfmon>`                            | Kea open     | With this hook library, :iscman:`kea-dhcp4` server and       |
+   |                                                           | source       | :iscman:`kea-dhcp6` servers can track and report performance |
+   |                                                           |              | data. CURRENTLY UNDER DEVELOPMENT                            |
+   +-----------------------------------------------------------+--------------+--------------------------------------------------------------+
    | :ref:`Ping Check <hooks-ping-check>`                      | ISC support  | With this hook library, :iscman:`kea-dhcp4` server can       |
    |                                                           | customers    | perform ping checks of candidate lease addresses before      |
    |                                                           |              | offering them to clients.                                    |
@@ -611,6 +615,7 @@ sections.
 .. include:: hooks-legal-log.rst
 .. include:: hooks-limits.rst
 .. include:: hooks-cb-mysql.rst
+.. include:: hooks-perfmon.rst
 .. include:: hooks-ping-check.rst
 .. include:: hooks-cb-pgsql.rst
 .. include:: hooks-radius.rst

doc/sphinx/arm/logging.rst

@@ -427,6 +427,10 @@ libraries), or hook libraries (open source or premium).
    |                                  |                                       | message carried in             |
    |                                  |                                       | the packet is parsed.          |
    +----------------------------------+---------------------------------------+--------------------------------+
+   | ``kea-dhcp4.perfmon-hooks``      | :ischooklib:`libdhcp_perfmon.so`      | Used                           |
+   | ``kea-dhcp6.perfmon-hooks``      | open-source hook library              | to log messages related to     |
+   |                                  |                                       | performan monitoring.          |
+   +----------------------------------+---------------------------------------+--------------------------------+
    | ``kea-dhcp4.ping-check-hooks``   | :ischooklib:`libdhcp_ping_check.so`   | Used                           |
    |                                  | subscription hook library             | to log messages related to     |
    |                                  |                                       | carrying out pre-offer ping    |

doc/sphinx/arm/rst_arm_sources.mk

@@ -31,6 +31,7 @@ rst_arm_sources += arm/hooks-limits.rst
 rst_arm_sources += arm/hooks-cb-mysql.rst
 rst_arm_sources += arm/hooks-cb-pgsql.rst
 rst_arm_sources += arm/hooks-legal-log.rst
+rst_arm_sources += arm/hooks-perfmon.rst
 rst_arm_sources += arm/hooks-ping-check.rst
 rst_arm_sources += arm/hooks-radius.rst
 rst_arm_sources += arm/hooks-rbac.rst

doc/sphinx/conf.py

@@ -96,6 +96,7 @@ exclude_patterns = [
     'arm/hooks-lease-cmds.rst',
     'arm/hooks-lease-query.rst',
     'arm/hooks-limits.rst',
+    'arm/hooks-perfmon.rst',
     'arm/hooks-ping-check.rst',
     'arm/hooks-radius.rst',
     'arm/hooks-rbac.rst',