]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#3569] added doxygen
authorRazvan Becheriu <razvan@isc.org>
Mon, 31 Mar 2025 18:05:55 +0000 (21:05 +0300)
committerRazvan Becheriu <razvan@isc.org>
Mon, 31 Mar 2025 18:05:55 +0000 (21:05 +0300)
src/hooks/dhcp/forensic_log/legal_syslog.h
src/hooks/dhcp/forensic_log/rotating_file.h
src/hooks/dhcp/mysql/mysql_legal_log.h
src/hooks/dhcp/pgsql/pgsql_legal_log.h

index f72250dff8e6853e4f54a348840d311a7fce8f4b..381e25d382ae14666a7134ebbb332711575c910f 100644 (file)
@@ -16,6 +16,11 @@ class LegalSyslog : public isc::dhcp::LegalLogMgr {
 public:
     /// @brief Constructor.
     ///
+    /// @note The supported parameters are:
+    /// - syslog parameters:
+    ///       - pattern
+    ///       - facility
+    ///
     /// @param parameters A data structure relating keywords and values
     ///        concerned with the manager configuration.
     LegalSyslog(const isc::db::DatabaseConnection::ParameterMap& parameters);
index 866e0ee5e7dbdc88654268999a7b63e8c1df360e..f7e4b0b3e2cd4a9691f464a21dc022f6522c3d15 100644 (file)
@@ -67,6 +67,15 @@ public:
     /// 'count' number of days, months or years (when the write function call
     /// detects that the day, month or year has changed).
     ///
+    /// @note The supported parameters are:
+    /// - logfile parameters:
+    ///       - path
+    ///       - base-name
+    ///       - time-unit - one of: second, day, month, year
+    ///       - prerotate
+    ///       - postrotate
+    ///       - count
+    ///
     /// @param parameters A data structure relating keywords and values
     ///        concerned with the manager configuration.
     ///
index 603161ae9e0deb8674ad80a7dec2fa500ea45300..1733e69fc306b5774a3c31cdab7c253247683dd0 100644 (file)
@@ -87,17 +87,24 @@ public:
 
     /// @brief Constructor
     ///
-    /// The following keywords in the parameters passed to it will be used
-    /// to connect to the database:
-    /// - name - Name of the database to which to connect (mandatory)
-    /// - host - Host to which to connect (optional, defaults to "localhost")
-    /// - user - Username under which to connect (optional)
-    /// - password - Password for "user" on the database (optional)
-    /// - trust-anchor - Trust anchor aka certificate authority file
-    ///   or directory (optional)
-    /// - cert-file - Client certificate file name (optional)
-    /// - key-file - Private key file name (optional)
-    /// - cipher-list - Cipher list (optional)
+    /// @note The supported parameters are:
+    /// - database parameters:
+    ///       - name
+    ///       - host
+    ///       - password
+    ///       - port
+    ///       - user
+    ///       - trust-anchor (MySQL only)
+    ///       - cert-file (MySQL only)
+    ///       - key-file (MySQL only)
+    ///       - cipher-list (MySQL only)
+    ///       - reconnect-wait-time
+    ///       - max-reconnect-tries
+    ///       - on-fail
+    ///       - retry-on-startup
+    ///       - connect-timeout
+    ///       - read-timeout (MySQL only)
+    ///       - write-timeout (MySQL only)
     ///
     /// @param parameters A data structure relating keywords and values
     ///        concerned with the database.
index 7b4369cd6a1679760f7877b3cbc400e8bd70139b..b6cb375fd9de61462375a137456a369f8f71da69 100644 (file)
@@ -86,13 +86,19 @@ public:
 
     /// @brief Constructor
     ///
-    /// The following keywords in the parameters passed to it will be used
-    /// to connect to the database:
-    /// - name - Name of the database to which to connect (mandatory)
-    /// - host - Host to which to connect (optional, defaults to "localhost")
-    /// - user - Username under which to connect (optional)
-    /// - password - Password for "user" on the database (optional)
-    /// - trust-anchor, cert-file, key-file and cipher-list (ignored)
+    /// @note The supported parameters are:
+    /// - database parameters:
+    ///       - name
+    ///       - host
+    ///       - password
+    ///       - port
+    ///       - user
+    ///       - reconnect-wait-time
+    ///       - max-reconnect-tries
+    ///       - on-fail
+    ///       - retry-on-startup
+    ///       - connect-timeout
+    ///       - tcp-user-timeout (PostgreSQL only)
     ///
     /// @param parameters A data structure relating keywords and values
     ///        concerned with the database.