From: Francis Dupont Date: Thu, 27 Sep 2018 12:37:11 +0000 (+0200) Subject: [65-libyang-pd-pool] Fixed doxygen comments X-Git-Tag: 153-netconf-agent_base~1^2~3^2^2^2^2^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=8c9d071f1ed5763a85542b601f7dc32f79f97b59;p=thirdparty%2Fkea.git [65-libyang-pd-pool] Fixed doxygen comments --- diff --git a/src/lib/yang/translator_option_data.h b/src/lib/yang/translator_option_data.h index 17a2ed3dbd..d286d68d80 100644 --- a/src/lib/yang/translator_option_data.h +++ b/src/lib/yang/translator_option_data.h @@ -13,66 +13,66 @@ namespace isc { namespace yang { -// Option data translation between YANG and JSON -// -// JSON syntax for Kea DHCP with command channel is: -// @code -// { -// "code": , -// "name": , -// "space": , -// "csv-format": , -// "data": , -// "always-send": , -// "user-context": { }, -// "comment": "" -// } -// @endcode -// -// YANG syntax for kea-dhcp[46] with code and space as keys is: -// @code -// +--rw name? string -// +--rw data? string -// +--rw code uint8 / uint16 -// +--rw space string -// +--rw csv-format? string -// +--rw always-send? boolean -// +--rw user-context? string -// @endcode -// -// An example in JSON and YANG formats: -// @code -// [ -// { -// "code": 100, -// "space": "dns", -// "csv-format": false, -// "data": "12121212", -// "always-send": false -// } -// ] -// @endcode -// @code -// /kea-dhcp6-server:config (container) -// /kea-dhcp6-server:config/option-data-list (container) -// /kea-dhcp6-server:config/option-data-list/ -// option-data[code='100'][space='dns'] (list instance) -// /kea-dhcp6-server:config/option-data-list/ -// option-data[code='100'][space='dns']/code = 100 -// /kea-dhcp6-server:config/option-data-list/ -// option-data[code='100'][space='dns']/space = dns -// /kea-dhcp6-server:config/option-data-list/ -// option-data[code='100'][space='dns']/data = 12121212 -// /kea-dhcp6-server:config/option-data-list/ -// option-data[code='100'][space='dns']/csv-format = false -// /kea-dhcp6-server:config/option-data-list/ -// option-data[code='100'][space='dns']/always-send = false -// @endcode - -// @brief A translator class for converting an option data between -// YANG and JSON. -// -// Currently supports on kea-dhcp[46]-server, not yet ietf-dhcpv6-server. +/// Option data translation between YANG and JSON +/// +/// JSON syntax for Kea DHCP with command channel is: +/// @code +/// { +/// "code": , +/// "name": , +/// "space": , +/// "csv-format": , +/// "data": , +/// "always-send": , +/// "user-context": { }, +/// "comment": "" +/// } +/// @endcode +/// +/// YANG syntax for kea-dhcp[46] with code and space as keys is: +/// @code +/// +--rw name? string +/// +--rw data? string +/// +--rw code uint8 / uint16 +/// +--rw space string +/// +--rw csv-format? string +/// +--rw always-send? boolean +/// +--rw user-context? string +/// @endcode +/// +/// An example in JSON and YANG formats: +/// @code +/// [ +/// { +/// "code": 100, +/// "space": "dns", +/// "csv-format": false, +/// "data": "12121212", +/// "always-send": false +/// } +/// ] +/// @endcode +/// @code +/// /kea-dhcp6-server:config (container) +/// /kea-dhcp6-server:config/option-data-list (container) +/// /kea-dhcp6-server:config/option-data-list/ +/// option-data[code='100'][space='dns'] (list instance) +/// /kea-dhcp6-server:config/option-data-list/ +/// option-data[code='100'][space='dns']/code = 100 +/// /kea-dhcp6-server:config/option-data-list/ +/// option-data[code='100'][space='dns']/space = dns +/// /kea-dhcp6-server:config/option-data-list/ +/// option-data[code='100'][space='dns']/data = 12121212 +/// /kea-dhcp6-server:config/option-data-list/ +/// option-data[code='100'][space='dns']/csv-format = false +/// /kea-dhcp6-server:config/option-data-list/ +/// option-data[code='100'][space='dns']/always-send = false +/// @endcode + +/// @brief A translator class for converting an option data between +/// YANG and JSON. +/// +/// Currently supports on kea-dhcp[46]-server, not yet ietf-dhcpv6-server. class TranslatorOptionData : virtual public TranslatorBasic { public: @@ -119,10 +119,10 @@ protected: std::string model_; }; -// @brief A translator class for converting an option data list between -// YANG and JSON. -// -// Currently supports on kea-dhcp[46]-server, not yet ietf-dhcpv6-server. +/// @brief A translator class for converting an option data list between +/// YANG and JSON. +/// +/// Currently supports on kea-dhcp[46]-server, not yet ietf-dhcpv6-server. class TranslatorOptionDataList : virtual public TranslatorOptionData { public: diff --git a/src/lib/yang/translator_pd_pool.h b/src/lib/yang/translator_pd_pool.h index 8a0674ef9a..7fe0881980 100644 --- a/src/lib/yang/translator_pd_pool.h +++ b/src/lib/yang/translator_pd_pool.h @@ -13,106 +13,106 @@ namespace isc { namespace yang { -// Prefix delegation pool translation between YANG and JSON -// -// JSON syntax for both kea-dhcp4 and kea-dhcp6 is: -// @code -// { -// "prefix": , -// "prefix-len": , -// "delegated-len": , -// "excluded-prefix": , -// "excluded-prefix-len": , -// "option-data": [ ], -// "client-class": "", -// "require-client-classes": [ ], -// "user-context": { }, -// "comment": "" -// } -// @endcode -// -// YANG syntax for ietf-dhcpv6-server is with pool-id as the key. -// @code -// +--rw pool-id uint32 -// +--rw prefix inet:ipv6-prefix -// +--rw prefix-length uint8 -// +--rw valid-lifetime yang:timeticks -// +--rw renew-time yang:timeticks -// +--rw rebind-time yang:timeticks -// +--rw preferred-lifetime yang:timeticks -// +--rw rapid-commit? boolean -// +--rw client-class? string -// +--rw max-pd-space-utilization? threshold -// +--rw option-set-id? -// /server/server-config/option-sets/option-set/option-set-id -// @endcode -// -// YANG syntax for kea-dhcp6 is with prefix as the key. -// @code -// +--rw prefix? inet:ipv6-prefix -// +--rw delegated-len? uint8 -// +--rw excluded-prefix? inet:ipv6-prefix -// +--rw option-data-list option-data* -// +--rw client-class? string -// +--rw require-client-classes* string -// +--rw user-context? string -// @endcode -// -// An example in JSON and YANG formats: -// @code -// [ -// { -// "prefix": "2001:db8:0:1000::", -// "prefix-len": 56, -// "delegated-len": 64 -// } -// ] -// @endcode -// @code -// /ietf-dhcpv6-server:server (container) -// /ietf-dhcpv6-server:server/server-config (container) -// /ietf-dhcpv6-server:server/server-config/network-ranges (container) -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111'] (list instance) -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111']/network-range-id = 111 -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111']/network-prefix = 2001:db8::/48 -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111']/pd-pools (container) -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111']/pd-pools/ -// pd-pool[pool-id='0'] (list instance) -// /ietf-dhcpv6-server:server/server-config/network-ranges/ -// pd-pool[pool-id='0']/pool-id = 0 -// network-range[network-range-id='111']/pd-pools/ -// pd-pool[pool-id='0']/prefix = 2001:db8:0:1000::/56 -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111']/pd-pools/ -// pd-pool[pool-id='0']/prefix-length = 56 -// /ietf-dhcpv6-server:server/server-config/network-ranges -// network-range[network-range-id='111']/pd-pools/ -// pd-pool[pool-id='0']/max-pd-space-utilization = disabled -// @endcode -// @code -// /kea-dhcp6-server:config (container) -// /kea-dhcp6-server:config/subnet6 (container) -// /kea-dhcp6-server:config/subnet6/subnet6[id='111'] (list instance) -// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/id = 111 -// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/subnet = 2001:db8::/48 -// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools (container) -// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools/ -// pd-pool[prefix='2001:db8:0:1000::/56' (list instance) -// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools/ -// pd-pool[prefix='2001:db8:0:1000::/56'/prefix = 2001:db8:0:1000::/56 -// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools/ -// pd-pool[prefix='2001:db8:0:1000::/56'/delegated-len = 64 -// @endcode - -// @brief A translator class for converting a pd-pool between -// YANG and JSON. -// -// Currently supports on kea-dhcp[46]-server and partially ietf-dhcpv6-server. +/// Prefix delegation pool translation between YANG and JSON +/// +/// JSON syntax for both kea-dhcp4 and kea-dhcp6 is: +/// @code +/// { +/// "prefix": , +/// "prefix-len": , +/// "delegated-len": , +/// "excluded-prefix": , +/// "excluded-prefix-len": , +/// "option-data": [ ], +/// "client-class": "", +/// "require-client-classes": [ ], +/// "user-context": { }, +/// "comment": "" +/// } +/// @endcode +/// +/// YANG syntax for ietf-dhcpv6-server is with pool-id as the key. +/// @code +/// +--rw pool-id uint32 +/// +--rw prefix inet:ipv6-prefix +/// +--rw prefix-length uint8 +/// +--rw valid-lifetime yang:timeticks +/// +--rw renew-time yang:timeticks +/// +--rw rebind-time yang:timeticks +/// +--rw preferred-lifetime yang:timeticks +/// +--rw rapid-commit? boolean +/// +--rw client-class? string +/// +--rw max-pd-space-utilization? threshold +/// +--rw option-set-id? +/// /server/server-config/option-sets/option-set/option-set-id +/// @endcode +/// +/// YANG syntax for kea-dhcp6 is with prefix as the key. +/// @code +/// +--rw prefix? inet:ipv6-prefix +/// +--rw delegated-len? uint8 +/// +--rw excluded-prefix? inet:ipv6-prefix +/// +--rw option-data-list option-data* +/// +--rw client-class? string +/// +--rw require-client-classes* string +/// +--rw user-context? string +/// @endcode +/// +/// An example in JSON and YANG formats: +/// @code +/// [ +/// { +/// "prefix": "2001:db8:0:1000::", +/// "prefix-len": 56, +/// "delegated-len": 64 +/// } +/// ] +/// @endcode +/// @code +/// /ietf-dhcpv6-server:server (container) +/// /ietf-dhcpv6-server:server/server-config (container) +/// /ietf-dhcpv6-server:server/server-config/network-ranges (container) +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111'] (list instance) +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111']/network-range-id = 111 +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111']/network-prefix = 2001:db8::/48 +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111']/pd-pools (container) +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111']/pd-pools/ +/// pd-pool[pool-id='0'] (list instance) +/// /ietf-dhcpv6-server:server/server-config/network-ranges/ +/// pd-pool[pool-id='0']/pool-id = 0 +/// network-range[network-range-id='111']/pd-pools/ +/// pd-pool[pool-id='0']/prefix = 2001:db8:0:1000::/56 +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111']/pd-pools/ +/// pd-pool[pool-id='0']/prefix-length = 56 +/// /ietf-dhcpv6-server:server/server-config/network-ranges +/// network-range[network-range-id='111']/pd-pools/ +/// pd-pool[pool-id='0']/max-pd-space-utilization = disabled +/// @endcode +/// @code +/// /kea-dhcp6-server:config (container) +/// /kea-dhcp6-server:config/subnet6 (container) +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111'] (list instance) +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/id = 111 +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/subnet = 2001:db8::/48 +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools (container) +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools/ +/// pd-pool[prefix='2001:db8:0:1000::/56' (list instance) +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools/ +/// pd-pool[prefix='2001:db8:0:1000::/56'/prefix = 2001:db8:0:1000::/56 +/// /kea-dhcp6-server:config/subnet6/subnet6[id='111']/pd-pools/ +/// pd-pool[prefix='2001:db8:0:1000::/56'/delegated-len = 64 +/// @endcode + +/// @brief A translator class for converting a pd-pool between +/// YANG and JSON. +/// +/// Currently supports on kea-dhcp[46]-server and partially ietf-dhcpv6-server. class TranslatorPdPool : virtual public TranslatorOptionDataList { public: @@ -173,10 +173,10 @@ protected: std::string model_; }; -// @brief A translator class for converting a pd-pool list between -// YANG and JSON. -// -// Currently supports on kea-dhcp[46]-server and partially ietf-dhcpv6-server. +/// @brief A translator class for converting a pd-pool list between +/// YANG and JSON. +/// +/// Currently supports on kea-dhcp[46]-server and partially ietf-dhcpv6-server. class TranslatorPdPools : virtual public TranslatorPdPool { public: