Adding upstream version 2.2.0.upstream/2.2.0upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

27 files changed, 6877 insertions, 0 deletions

diff --git a/doc/examples/kea6/advanced.json b/doc/examples/kea6/advanced.json
new file mode 100644
index 0000000..7704f8d
--- /dev/null
+++ b/doc/examples/kea6/advanced.json
@@ -0,0 +1,188 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It attempts to showcase some of the more advanced features.
+// Topology wise, it's a basic scenario with one IPv6 subnet configured.
+// It is assumed that one subnet (2001:db8:1::/64) is available directly
+// over eth0 interface.
+//
+// The following features are currently showcased here:
+// 1. Configuration of MAC/hardware address sources in DHCPv6
+// 2. RSOO (Relay supplied options) - Some relays may insert options with the
+//    intention for the server to insert them into client directed messages.
+// 3. Control socket. Kea can open a socket and listen for incoming
+//    commands.
+
+{ "Dhcp6":
+
+{
+    // Kea is told to listen on eth0 network interface only.
+    "interfaces-config": {
+        "interfaces": [ "eth0" ],
+
+        // This makes interfaces to be re-detected at each (re-)configuration.
+        // By default it is true.
+        "re-detect": true
+    },
+
+    // We need to specify the database used to store leases. As of
+    // June 2022, three database backends are supported: MySQL,
+    // PostgreSQL and the in-memory database, Memfile.
+    // We will use memfile  because it doesn't require any prior set up.
+    "lease-database": {
+        "type": "memfile",
+        "lfc-interval": 3600
+    },
+
+     "sanity-checks": {
+        // This parameter determines what to do when a new lease appears in the
+        // system (i.e. either is read from disk during memfile startup or is
+        // added via lease commands). There are five modes supported:
+        // none - do nothing, accept them as is
+        // warn - if subnet-id problems are detected, print a warning, but
+        //        otherwise load the lease as is. This is the default value.
+        // fix - attempt to fix the lease by finding appropriate subnet-id value.
+        //       if there is no suitable subnet, the lease is loaded as is.
+        // fix-del - attempt to fix the lease by finding appropriate subnet-id
+        //           value. If there is no suitable subnet, the lease is deleted.
+        // del - delete leases that have incorrect subnet-id values.
+        "lease-checks": "fix-del"
+    },
+
+    // Kea 0.9.1 introduced MAC/hardware addresses support in DHCPv6. There is
+    // no single reliable method of getting MAC address information in DHCPv6.
+    // Kea supports several methods. Depending on your network set up, some
+    // methods may be more preferable than others, hence the configuration
+    // parameter. 'mac-sources' is a list of methods. Allowed parameters are:
+    // any, raw, duid, ipv6-link-local, client-link-addr-option, rfc6939 (which
+    // is an alias for client-link-addr-option), remote-id, rfc4649 (which is an
+    // alias for remote-id, subscriber-id, rfc4580 (which is an alias for
+    // subscriber-id) and docsis.
+    //
+    // Note that the order matters. Methods are attempted one by one in the
+    // order specified until hardware address is obtained. If you don't care
+    // which method is used, using 'any' is marginally faster than enumerating
+    // them all.
+    //
+    // If mac-sources are not specified, a default value of 'any' is used.
+    "mac-sources": [ "client-link-addr-option", "duid", "ipv6-link-local" ],
+
+    // RFC6422 defines a mechanism called relay-supplied options option. The
+    // relay agent may insert certain options that the server will echo back to
+    // the client, if certain criteria are met. One condition is that the option
+    // must be RSOO-enabled (i.e. allowed to be echoed back). IANA maintains a
+    // list of those options here:
+    // http://www.iana.org/assignments/dhcpv6-parameters/dhcpv6-parameters.xhtml#options-relay-supplied
+    // However, it is possible to allow the server to echo back additional
+    // options.  This entry marks options 110, 120 and 130 as RSOO-enabled.
+    "relay-supplied-options": [ "110", "120", "130" ],
+
+    // This defines a control socket. If defined, Kea will open a UNIX socket
+    // and will listen for incoming commands. See section 15 of the Kea User's
+    // Guide for list of supported commands.
+    "control-socket": {
+        "socket-type": "unix",
+        "socket-name": "/tmp/kea6-ctrl-socket"
+    },
+
+    // Addresses will be assigned with preferred and valid lifetimes
+    // being 3000 and 4000, respectively. Client is told to start
+    // renewing after 1000 seconds. If the server does not respond
+    // after 2000 seconds since the lease was granted, client is supposed
+    // to start REBIND procedure (emergency renewal that allows switching
+    // to a different server).
+    "preferred-lifetime": 3000,
+    "valid-lifetime": 4000,
+    "renew-timer": 1000,
+    "rebind-timer": 2000,
+
+    // The following list defines subnets. Each subnet consists of at
+    // least subnet and pool entries. Note the user-context being
+    // used throughout the definitions. This is something that is not
+    // being used by Kea, it's simply parsed and stored in appropriate
+    // structures. You can put anything you want in the user-context
+    // as long as it is a valid JSON and it starts with a map (i.e.
+    // is enclosed by curly brackets).
+    // A comment entry is translated into a user-context with a
+    // "comment" property so you can include comments inside the
+    // configuration itself.
+    "subnet6": [
+    {
+        "pools": [
+            {
+                "pool": "2001:db8:1::/80",
+
+                // This is user context specified for this particular
+                // pool. You can use it to describe the pool in some way.
+                // Just keep in mind that the structure will not be used
+                // by Kea itself. It will be made available to hooks if
+                // they want to use it.
+                "user-context": { "department": "engineering" }
+            }],
+
+        // Here's the user-context for the whole subnet.
+        "user-context": { "comment": "Floor one, west wing" },
+        // Equivalent using smart parser
+        // "comment": "Floor one, west wing",
+
+        // This defines PD (prefix delegation) pools. In this case
+        // we have only one pool. That consists of /64 prefixes
+        // being delegated out of large /48 pool. Each delegated
+        // prefix will contain an excluded-prefix option.
+        "pd-pools": [
+        {
+            "prefix": "2001:db8:abcd::",
+            "prefix-len": 48,
+            "delegated-len": 64,
+            "excluded-prefix": "2001:db8:abcd:0:1234::",
+            "excluded-prefix-len": 80,
+
+            // Another user-context for this PD pool. Again, you can put
+            // anything you want in there as long as it's valid JSON and
+            // starts with a map.
+            "user-context": {
+                "purpose": "For CPE devices"
+            }
+        }
+        ], // end of pools
+
+        "subnet": "2001:db8:1::/64",
+        "interface": "eth0",
+
+        // Sometimes the relay may use an odd IPv6 address that's not matching
+        // the subnet. This is discouraged, but there are valid cases when it
+        // makes sense. One case is when the relay has only link-local address
+        // and another is when there is a shared subnet scenario.
+        "relay": {
+            "ip-address": "3000::1"
+        }
+    }
+    ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout",
+                    // Several additional parameters are possible in addition
+                    // to the typical output. Flush determines whether logger
+                    // flushes output to a file. Maxsize determines maximum
+                    // filesize before the file is being rotated. maxver
+                    // specifies the maximum number of rotated files being
+                    // kept.
+                    "flush": true,
+                    "maxsize": 204800,
+                    "maxver": 4,
+                    // We use pattern to specify custom log message layout
+                    "pattern": "%d{%y.%m.%d %H:%M:%S.%q} %-5p [%c/%i] %m\n"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/all-keys-netconf.json b/doc/examples/kea6/all-keys-netconf.json
new file mode 100644
index 0000000..cce7e8e
--- /dev/null
+++ b/doc/examples/kea6/all-keys-netconf.json
@@ -0,0 +1,1129 @@
+// WARNING: This example configuration is not meant for production use.
+// The Kea DHCPv6 server will refuse this configuration because it contains
+// mutually exclusive configuration parameters.
+//
+// The primary purpose of the example file is to provide a comprehensive
+// list of parameters supported by Kea DHCPv6 server along with the brief
+// description of each parameter.
+//
+// This stable version is used for YANG as we do not want to update code
+// and models each time a keyword is added to the syntax.
+{
+    // Kea DHCPv6 server configuration begins here.
+    "Dhcp6": {
+        // Ordered list of client classes used by the DHCPv6 server.
+        "client-classes": [
+            {
+                // Class name.
+                "name": "phones_server1",
+
+                // Class specific DHCPv6 options list.
+                "option-data": [],
+
+                // Class selection expression. The DHCP packet is assigned to this
+                // class when the given expression evaluates to true.
+                "test": "member('HA_server1')",
+
+                // Class valid lifetime.
+                "valid-lifetime": 6000,
+
+                // Class min valid lifetime.
+                "min-valid-lifetime": 4000,
+
+                // Class max valid lifetime.
+                "max-valid-lifetime": 8000,
+
+                // Class preferred lifetime.
+                "preferred-lifetime": 7000,
+
+                // Class min preferred lifetime.
+                "min-preferred-lifetime": 5000,
+
+                // Class max preferred lifetime.
+                "max-preferred-lifetime": 9000
+            },
+            {
+                // Second class name.
+                "name": "phones_server2",
+
+                // Class specific DHCPv6 options list.
+                "option-data": [],
+
+                // Class selection expression. The DHCP packet is assigned to this
+                // class when the given expression evaluates to true.
+                "test": "member('HA_server2')"
+            },
+            {
+                // Third class name.
+                "name": "late",
+
+                // Boolean flag indicating that the class expression is only evaluated
+                // when the class is required, e.g. selected address pool configuration
+                // includes this class name in its "require-client-classes" list. The
+                // default value false means that the class test expression must
+                // always be evaluated.
+                "only-if-required": true,
+
+                // Class selection expression.
+                "test": "member('ALL')"
+            }
+        ],
+
+        // Parameters for triggering behaviors compatible with broken or
+        // non-compliant clients, relays or other agents
+        "compatibility": {
+            // Parse options more leniently where fields can be deduced
+            // deterministically even if against RFC or common practice.
+            "lenient-option-parsing": true
+        },
+
+        // Command control socket configuration parameters for Kea DHCPv6 server.
+        "control-socket": {
+            // Location of the unix domain socket file the DHCPv6 server uses
+            // to receive control commands from the Kea Control Agent or the
+            // local server administrator.
+            "socket-name": "/tmp/kea6-ctrl-socket",
+
+            // Control socket type used by the Kea DHCPv6 server. The 'unix'
+            // socket is currently the only supported type.
+            "socket-type": "unix"
+        },
+
+        // Specifies a prefix to be prepended to the generated Client FQDN.
+        // It may be specified at the global, shared-network and subnet levels.
+        "ddns-generated-prefix": "myhost",
+
+        // Boolean flag indicating that server should ignore DHCP client
+        // wishes to update DNS on its own. With that flag set to true
+        // the server will send DNS updates for both forward and
+        // reverse DNS data. The default value is false, which indicates
+        // that the server will delegate DNS update to the client when
+        // requested.  It may be specified at the global, shared-network
+        // and subnet levels.
+        "ddns-override-client-update": false,
+
+        // Boolean flag indicating that the server should override DHCP
+        // client's wish to not update the DNS. With this parameter
+        // set to true the server will send DNS update even when
+        // the client requested no update.  It may be specified at the
+        // global, shared-network and subnet levels.
+        "ddns-override-no-update": false,
+
+        // Suffix appended to the partial name sent to the DNS. The
+        // default value is an empty string which indicates that no
+        // suffix is appended.  It may be specified at the global,
+        // shared-network and subnet levels.
+        "ddns-qualifying-suffix": "",
+
+        // Enumeration specifying whether the server should honor
+        // hostname or Client FQDN sent by the client or replace
+        // this name. The acceptable values are: "never" (use the
+        // name the client sent), "always" (replace the name the
+        // client sent), "when-present" (replace the name the client
+        // sent, but do not generate one when the client didn't sent
+        // the name), "when-not-present" (generate the name when
+        // client didn't send one, otherwise leave the name the
+        // client sent). The default value is "never".  It may be
+        // specified at the global, shared-network and subnet levels.
+        "ddns-replace-client-name": "never",
+
+        // Boolean flag which enables or disables the DDNS updating. It
+        // defaults to true.  It may be specified at the global, shared-
+        // network and subnet levels. It works in conjunction with
+        // dhcp-ddns:enable-updates which must be true to enable connectivity
+        // to kea-dhcp-ddns.
+        "ddns-send-updates": true,
+
+        // Boolean flag, which when true instructs the server to always
+        // update DNS when leases are renewed, even if the DNS information
+        // has not changed.  The server's default behavior (i.e. flag is false)
+        // is to only update DNS if the DNS information has changed.  It
+        // may be specified at the global, shared-network and subnet levels.
+        "ddns-update-on-renew": true,
+
+        // Boolean flag, which is passed to kea-dhcp-ddns with each DDNS
+        // update request to indicate whether or not DNS update conflict
+        // resolution as described in RFC 4703 should be employed for the
+        // given update request.  The default value for this flag is true.
+        // It may be specified at the global, shared-network and subnet levels.
+        "ddns-use-conflict-resolution": true,
+
+        // Time in seconds specifying how long a declined lease should be
+        // excluded from DHCP assignments. The default value is 24 hours.
+        "decline-probation-period": 86400,
+
+        // Name Change Requests forwarding configuration for Kea DHCPv6 server.
+        // NCRs are sent to Kea D2 module to update DNS upon allocation of the
+        // DHCP leases.
+        "dhcp-ddns": {
+            // Boolean flag indicating if Kea DHCPv6 server should connect to
+            // kea-dhcp-ddns.  This must be true for NCRs to be created and
+            // sent to kea-dhcp-ddns. By default NCRs are not generated.
+            "enable-updates": false,
+
+            // Specifies maximum number of NCRs to queue waiting to be sent
+            // to Kea D2 server.
+            "max-queue-size": 1024,
+
+            // Packet format to use when sending NCRs to Kea D2 server.
+            // Currently, only JSON format is supported.
+            "ncr-format": "JSON",
+
+            // Socket protocol to use when sending NCRs to D2. Currently,
+            // only UDP is supported.
+            "ncr-protocol": "UDP",
+
+            // IP address that Kea DHCPv6 server should use to send
+            // NCRs to D2. Default value of zero indicates that Kea
+            // should pick suitable address.
+            "sender-ip": "::1",
+
+            // Port number that Kea DHCPv6 server should use to send
+            // NCRs to D2. Default value of zero indicates that Kea
+            // should pick suitable port.
+            "sender-port": 0,
+
+            // IP address on which D2 listens for NCRs.
+            "server-ip": "::1",
+
+            // Port number on which D2 listens for NCRs.
+            "server-port": 53001,
+
+            // The follow parameters are DEPRECATED.  They have been
+            // replaced with parameters that may be set at the global,
+            // shared-network, and subnet6 scopes.  They are listed here
+            // as configuration parsing still accepts them.  Eventually
+            // support for them will be removed.
+            "generated-prefix": "myhost",
+            "hostname-char-replacement": "x",
+            "hostname-char-set": "[^A-Za-z0-9.-]",
+            "override-client-update": false,
+            "override-no-update": false,
+            "qualifying-suffix": "",
+            "replace-client-name": "never"
+        },
+
+        // Specifies the first of the two consecutive ports of the UDP
+        // sockets used for communication between DHCPv6 and DHCPv4
+        // servers. See RFC 7341.
+        "dhcp4o6-port": 0,
+
+        // Collection of Kea DHCPv6 server parameters configuring how
+        // the server should process expired DHCP leases.
+        "expired-leases-processing": {
+            // Specifies the number of seconds since last removal of
+            // the expired leases when next removal should occur.
+            "flush-reclaimed-timer-wait-time": 25,
+
+            // Specifies the time period in seconds to keep expired
+            // leases in the lease database (lease affinity).
+            "hold-reclaimed-time": 3600,
+
+            // Specifies the maximum number of expired leases that can be
+            // processed in a single attempt to clean up the lease
+            // database from the expired leases. If there are more
+            // expired leases, they will be processed during the next
+            // cleanup attempt.
+            "max-reclaim-leases": 100,
+
+            // Specifies the maximum time in milliseconds that the single
+            // attempt to cleanup the lease database from the expired
+            // leases may take.
+            "max-reclaim-time": 250,
+
+            // Specifies the time period in seconds since last attempt
+            // to process expired leases to initiate the next attempt.
+            "reclaim-timer-wait-time": 10,
+
+            // Specifies the maximum number of expired leases processing
+            // cycles which didn't result in full cleanup of the lease
+            // database from the expired leases, after which a
+            // warning message is issued.
+            "unwarned-reclaim-cycles": 5
+        },
+
+        // List of hooks libraries and their specific configuration parameters
+        // to be loaded by Kea DHCPv4 server.
+        "hooks-libraries": [
+            {
+                // Location of the hooks library to be loaded.
+                "library": "/opt/lib/kea/hooks/libdhcp_lease_cmds.so",
+
+                // Hook library specific configuration parameters.
+                "parameters": { }
+            }
+        ],
+
+        // List of access credentials to external sources of IPv6 reservations,
+        "hosts-databases": [
+            {
+                // Name of the database to connect to.
+                "name": "keatest",
+
+                // Host on which the database resides.
+                "host": "localhost",
+
+                // Database password.
+                "password": "keatest",
+
+                // Port on which the database is available.
+                "port": 3306,
+
+                // Type of the database, e.g. "mysql", "postgresql".
+                "type": "mysql",
+
+                // User name to be used to access the database.
+                "user": "keatest",
+
+                // Read only mode.
+                "readonly": false,
+
+                // Next entries are for the OpenSSL support in MySQL.
+                // Trust anchor aka certificate authority file or directory.
+                "trust-anchor": "my-ca",
+
+                // Client certificate file name.
+                "cert-file": "my-cert",
+
+                // Private key file name.
+                "key-file": "my-key",
+
+                // Cipher list (see the OpenSSL ciphers command manual).
+                "cipher-list": "AES"
+            },
+            {
+                // Name of the database to connect to.
+                "name": "keatest",
+
+                // Host on which the database resides.
+                "host": "localhost",
+
+                // Database password.
+                "password": "keatest",
+
+                // Port on which the database is available.
+                "port": 5432,
+
+                // Type of the database, e.g. "mysql", "postgresql".
+                "type": "postgresql",
+
+                // User name to be used to access the database.
+                "user": "keatest",
+
+                // Connection reconnect wait time.
+                // This parameter governs how long Kea waits before attempting
+                // to reconnect. Expressed in milliseconds. The default is 0
+                // (disabled) for MySQL and PostgreSQL.
+                "reconnect-wait-time": 3000,
+
+                // Connection maximum reconnect tries.
+                "max-reconnect-tries": 3,
+
+                // Action to take when connection recovery fails.
+                // Supported values: stop-retry-exit, serve-retry-exit,
+                // serve-retry-continue
+                "on-fail": "stop-retry-exit",
+
+                // Connection connect timeout.
+                "connect-timeout": 100
+            }
+        ],
+
+        // List of host reservation identifier types to be used by the
+        // Kea DHCPv6 server to fetch static reservations for the
+        // DHCP clients. All identifiers are used by default, which
+        // means that the server will issue multiple queries to the
+        // database to find if there is a reservation for the particular
+        // client. If the particular deployment uses only subset, e.g.
+        // one, identifier type, this identifier should be only listed
+        // here to prevent unnecessary queries to the database.
+        "host-reservation-identifiers": [
+            "hw-address",
+            "duid",
+            "flex-id"
+        ],
+
+        // Specifies configuration of interfaces on which the Kea DHCPv6
+        // server is listening to the DHCP queries.
+        "interfaces-config": {
+            // Specifies a list of interfaces on which the Kea DHCPv6
+            // server should listen to the DHCP requests.
+            "interfaces": [
+                "eth0"
+            ],
+
+            // Boolean flag indicating if the available interfaces should
+            // be re-detected upon server reconfiguration. The default value
+            // is true which means that the interfaces are always
+            // re-detected.
+            "re-detect": true,
+
+            // Kea tries to bind the service sockets during initialization. It may
+            // fail due to a port being already opened or misconfiguration. Kea can
+            // suppress these errors and only logs them. This flag prevents starting
+            // the DHCP server without binding all sockets. If unspecified, it
+            // defaults to false.
+            "service-sockets-require-all": true,
+
+            // Kea tries to bind the service sockets during initialization. This
+            // option specifies how many times binding to interface will be retried.
+            // The default value is 0 which means that the operation will not be
+            // repeated.
+            "service-sockets-max-retries": 5,
+
+            // The time interval in milliseconds to wait before the next attempt to
+            // retry opening a service socket.
+            "service-sockets-retry-wait-time": 5000
+        },
+
+        // Boolean parameter which controls whether an early global host
+        // reservations lookup should be performed. This lookup takes place
+        // before subnet selection and when a global reservation is found
+        // with some client classes, it triggers a second phase classification.
+        // It can also be used to drop queries using host reservations as a
+        // decision table indexed by reservation identifiers.
+        "early-global-reservations-lookup": true,
+
+        // Boolean parameter which controls DHCP server's behavior with respect
+        // to creating host reservations for the same IP address or delegated
+        // prefix. By default this flag is set to true in which case the server
+        // prevents creation of multiple host reservations for the same IP address
+        // or delegated prefix. When this parameter is set to false, the server
+        // allows for creating multiple reservations for the same IP address or
+        // delegated prefix within a subnet. This setting is useful in deployments
+        // in which a given host may be communicating with a DHCP server over
+        // multiple interfaces and depending on the chosen interface different
+        // MAC address (or other identifier) will be used to identify the host.
+        // Note that some host backends do not support the mode in which multiple
+        // reservations for the same IP address or delegated prefix are used.
+        // If these backends are in use and this setting is attempted a
+        // configuration error will occur. The MySQL and PostgreSQL backends do
+        // support this mode.
+        "ip-reservations-unique": true,
+
+        /// Boolean parameter which controls whether host reservations lookup
+        /// should be performed before lease lookup. This parameter has effect
+        /// only when multi-threading is disabled. When multi-threading is
+        /// enabled, host reservations lookup is always performed first to avoid
+        /// lease lookup resource locking.
+        "reservations-lookup-first": true,
+
+        // Specifies credentials to access lease database.
+        "lease-database": {
+            // memfile backend specific parameter specifying the interval
+            // in seconds at which lease file should be cleaned up (outdated
+            // lease entries are removed to prevent lease file from growing
+            // infinitely).
+            "lfc-interval": 3600,
+
+            // Maximum number of lease file read errors allowed before
+            // loading the file is abandoned.  Defaults to 0 (no limit).
+            "max-row-errors": 100,
+
+            // Name of the lease file. In case of database it specifies the
+            // database name.
+            "name": "/tmp/kea-dhcp6.csv",
+
+            // memfile specific parameter indicating whether leases should
+            // be saved on persistent storage (disk) or not. The true value
+            // is the default and it indicates that leases are stored in the
+            // persistent storage. This setting must be used in production.
+            // The false value should only be used for testing purposes
+            // because non stored leases will be lost upon Kea server restart.
+            "persist": true,
+
+            // Lease database backend type, i.e. "memfile", "mysql" or
+            // "postgresql".
+            "type": "memfile"
+        },
+
+        // List of parameters indicating how the client's MAC address can be
+        // inferred from the DHCP query. Supported values are listed in the
+        // Kea Administrator Reference Manual.
+        "mac-sources": [ "duid" ],
+
+        // List of global DHCP options that Kea DHCPv6 server assigns to the
+        // clients.
+        "option-data": [
+            {
+                // Boolean flag indicating if the given option is always
+                // send in response or only when requested. The default
+                // value of false indicates that it is only sent when
+                // requested.
+                "always-send": false,
+
+                // Option code. It is not required if the option name is
+                // provided.
+                "code": 23,
+
+                // Boolean value indicating whether the option data specified
+                // in the "data" field is specified as a string of hexadecimal
+                // digits or in human readable CSV format.
+                "csv-format": true,
+
+                // Option data to be stored in the option payload.
+                "data": "2001:db8:2::45, 2001:db8:2::100",
+
+                // Option name. It is not required of the option code is
+                // provided.
+                "name": "dns-servers",
+
+                // Option space. The default is the "dhcp6" option space which
+                // groups top level DHCPv6 options.
+                "space": "dhcp6"
+            }
+        ],
+
+        // List of global option definitions, i.e. option formats, that the
+        // Kea DHCPv6 server is using.
+        "option-def": [
+            {
+                // Boolean flag indicating if the option definition comprises
+                // an array of values of some type, e.g. array of IPv6 addresses.
+                // The default value of false means that the option does not
+                // comprise an array of values.
+                "array": false,
+
+                // Option code.
+                "code": 6,
+
+                // Holds a name of the option space encapsulated by this option.
+                // All options that belong to this option space will be sent
+                // as sub-options of this option. Empty string means that this
+                // option doesn't encapsulate any option.
+                "encapsulate": "",
+
+                // Option name.
+                "name": "my-option",
+
+                // Specifies the types of fields within the option if the option
+                // is said to be a "record" (see "type"). in this particular example
+                // this option comprises two fields, 1 byte and 2 bytes long.
+                "record-types": "uint8, uint16",
+
+                // Name of the option space to which this option belongs.
+                "space": "my-space",
+
+                // Option type. All possible types are listed in the Kea
+                // Administrator Reference Manual.
+                "type": "record"
+            }
+        ],
+
+        // Global value which limits the number of client packets (e.g.
+        // REQUESTs,RENEWs...) that may be parked while waiting for
+        // hook library work to complete, prior to a response (e.g. REPLY)
+        // being sent back to the client.  A typical example is when kea-dhcp6
+        // parks a REQUEST while it sends the lease update(s) to its
+        // HA peer(s). The packet is unparked once the update(s) have been
+        // acknowledged.  This value limits the number of packets that can
+        // be held pending the updates. In times of heavy client traffic,
+        // this value can keep kea-dhcp6 from building an insurmountable
+        // backlog of updates.
+        "parked-packet-limit": 128,
+
+        // Global (default) value of the preferred lifetime.
+        "preferred-lifetime": 50,
+
+        // Global min value of the preferred lifetime.
+        "min-preferred-lifetime": 40,
+
+        // Global max value of the preferred lifetime.
+        "max-preferred-lifetime": 60,
+
+        // Global value for the rebind timer, i.e. the time after which the
+        // DHCP client enters rebind state if it fails to renew the lease.
+        "rebind-timer": 40,
+
+        // List of relay supplied option codes. See RFC 6422.
+        "relay-supplied-options": [ "110", "120", "130" ],
+
+        // Global value for the renew timer, i.e. the timer after which the
+        // DHCP client renews the lease.
+        "renew-timer": 30,
+
+        // Global value to store extended information (e.g. relay agent
+        // information) with each lease.
+        "store-extended-info": true,
+
+        // Statistics keep some samples per observation point.
+        // There are two default values: maximum count and maximum age.
+        // Set the maximum count to zero disables it.
+        "statistic-default-sample-count": 0,
+
+        // When the maximum count is 0 the maximum age (in seconds) applies.
+        "statistic-default-sample-age": 60,
+
+        // Multi-threading parameters.
+        "multi-threading": {
+            // By default Kea processes packets on a single thread (default
+            // 'false' value for this option). To enable multi-threading, this
+            // option can be set ('true' value).
+            "enable-multi-threading": false,
+
+            // When multi-threading is enabled, Kea will process packets on a
+            // number of multiple threads configurable through this option. The
+            // value must be a positive integer (0 means auto detect).
+            "thread-pool-size": 0,
+
+            // When multi-threading is enabled, Kea will read packets from the
+            // interface and append a working item to the thread pool. This
+            // option configures the maximum number of items that can be queued.
+            // The value must be a positive integer (0 means unlimited).
+            "packet-queue-size": 0
+        },
+
+        // Governs how the Kea DHCPv6 server should deal with the invalid
+        // data received from the client.
+        "sanity-checks": {
+            // Specifies how the Kea DHCPv6 server should behave when invalid
+            // data is read for a lease from the lease file. The following
+            // values are supported "none" (don't attempt to correct the
+            // lease information), "warn" (print a warning for subnet-id
+            // related inconsistencies), "fix" (correct the subnet id by
+            // trying to find the suitable subnet), "fix-del" (similar
+            // to "fix" but delete the lease if no suitable subnet found),
+            // "del" (delete the lease if the lease has invalid subnet
+            // identifier value).
+            "lease-checks": "warn"
+        },
+
+        // Custom DUID used by the DHCPv6 server.
+        "server-id": {
+            // Type of the DUID. Possible values are "LLT", "EN", and "LL".
+            "type": "EN",
+
+            // Enterprise id used for "EN" duid.
+            "enterprise-id": 2495,
+
+            // Identifier part of the DUID.
+            "identifier": "0123456789",
+
+            // Boolean flag indicating if the DUID should be persisted on
+            // disk.
+            "persist": false
+        },
+
+        // List of shared networks used by Kea DHCPv6 server. The shared
+        // networks group subnets together.
+        "shared-networks": [
+            {
+                // Restricts this shared network to allow only clients
+                // that belong to the particular client class. If an
+                // empty string is provided, no restriction is applied.
+                "client-class": "",
+
+                // Shared network level value. See description at the global level.
+                "ddns-generated-prefix": "myhost",
+
+                // Shared network level value. See description at the global level.
+                "ddns-override-client-update": false,
+
+                // Shared network level value. See description at the global level.
+                "ddns-override-no-update": false,
+
+                // Shared network level value. See description at the global level.
+                "ddns-qualifying-suffix": "",
+
+                // Shared network level value. See description at the global level.
+                "ddns-replace-client-name": "never",
+
+                // Shared network level value. See description at the global level.
+                "ddns-send-updates": true,
+
+                // Shared network level value. See description at the global level.
+                "ddns-update-on-renew": true,
+
+                // Shared network level value. See description at the global level.
+                "ddns-use-conflict-resolution": true,
+
+                // Shared network level value. See description at the global level.
+                "hostname-char-replacement": "x",
+
+                // Shared network level value. See description at the global level.
+                "hostname-char-set": "[^A-Za-z0-9.-]",
+
+                // Specifies that this shared network is selected for the
+                // requests received on the particular interface.
+                "interface": "eth0",
+
+                // Specifies the content of the interface-id option used
+                // by relays to identify the interface on the relay to
+                // which the response is sent.
+                "interface-id": "",
+
+                // Shared network name.
+                "name": "my-secret-network",
+
+                // List of shared network specific DHCP options.
+                "option-data": [],
+
+                // Shared network specific (default) preferred lifetime.
+                "preferred-lifetime": 2000,
+
+                // Shared network specific min preferred lifetime.
+                "min-preferred-lifetime": 1500,
+
+                // Shared network specific ma xpreferred lifetime.
+                "max-preferred-lifetime": 2500,
+
+                // Boolean flag indicating if the server can respond to
+                // a Solicit message including a Rapid Commit option with
+                // the Reply message (See DHCPv6 rapid commit).
+                "rapid-commit": false,
+
+                // List of IPv6 relay addresses for which this shared
+                // network is selected.
+                "relay": {
+                    "ip-addresses": []
+                },
+
+                // Shared network level rebind timer.
+                "rebind-timer": 41,
+
+                // Shared network level renew timer.
+                "renew-timer": 31,
+
+                // Shared network level compute T1 and T2 timers.
+                "calculate-tee-times": true,
+
+                // T1 = valid lifetime * .5.
+                "t1-percent": .5,
+
+                // T2 = valid lifetime * .75.
+                "t2-percent": .75,
+
+                // Cache threshold = valid lifetime * .25.
+                "cache-threshold": .25,
+
+                // Cache maximum: when the client last transmission time
+                // is close enough the lease is not renewed and current
+                // lease is returned as it was "cached".
+                "cache-max-age": 10,
+
+                // Enumeration specifying server's mode of operation when it
+                // fetches host reservations.
+                // "reservation-mode": "all",
+                // It is replaced by the "reservations-global",
+                // "reservations-in-subnet" and "reservations-out-of-pool"
+                // parameters.
+
+                // Specify if server should lookup global reservations.
+                "reservations-global": false,
+
+                // Specify if server should lookup in-subnet reservations.
+                "reservations-in-subnet": true,
+
+                // Specify if server can assume that all reserved addresses
+                // are out-of-pool.
+                // Ignored when reservations-in-subnet is false.
+                // If specified, it is inherited by "subnet6" levels.
+                "reservations-out-of-pool": false,
+
+                // List of client classes which must be evaluated when this shared
+                // network is selected for client assignments.
+                "require-client-classes": [ "late" ],
+
+                // Turn off storage of extended information (e.g. relay agent
+                // information) with each lease for this shared-network.
+                "store-extended-info": false,
+
+                // List of IPv6 subnets belonging to this shared network.
+                "subnet6": [
+                    {
+                        // Restricts this subnet to allow only clients that belong
+                        // to the particular client class. If an empty string is
+                        // provided, no restriction is applied.
+                        "client-class": "",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-generated-prefix": "myhost",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-override-client-update": false,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-override-no-update": false,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-qualifying-suffix": "",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-replace-client-name": "never",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-send-updates": true,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-update-on-renew": true,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-use-conflict-resolution": true,
+
+                        // Subnet level value. See description at the global level.
+                        "hostname-char-replacement": "x",
+
+                        // Subnet level value. See description at the global level.
+                        "hostname-char-set": "[^A-Za-z0-9.-]",
+
+                        // Subnet unique identifier.
+                        "id": 1,
+
+                        // Specifies that this subnet is selected for the requests
+                        // received on the particular interface.
+                        "interface": "eth0",
+
+                        // Specifies the content of the interface-id option used
+                        // by relays to identify the interface on the relay to
+                        // which the response is sent.
+                        "interface-id": "",
+
+                        // Turn on storage of extended information (e.g. relay agent
+                        // information) with each lease for this subnet.
+                        "store-extended-info": true,
+
+                        // Subnet level list of DHCP options.
+                        "option-data": [
+                            {
+                                // Boolean flag indicating if the particular option
+                                // should be always sent or sent only when requested.
+                                "always-send": false,
+
+                                // Option code.
+                                "code": 7,
+
+                                // Boolean flag indicating if the option value specified
+                                // in "data" is a string of hexadecimal values or human
+                                // readable CSV value.
+                                "csv-format": false,
+
+                                // Option data to be included in the option payload.
+                                "data": "0xf0",
+
+                                // Option name.
+                                "name": "preference",
+
+                                // Option space. The default value "dhcp6" designates the
+                                // top level option space.
+                                "space": "dhcp6"
+                            }
+                        ],
+
+                        // List of pools from which delegated prefixes are assigned to the
+                        // clients.
+                        "pd-pools": [
+                            {
+                                // Restricts this prefix pool to be used only for the client
+                                // requests belonging to a particular client class.
+                                "client-class": "phones_server1",
+
+                                // Length of prefixes delegated to clients.
+                                "delegated-len": 64,
+
+                                // Excluded prefix (address) from client assignments.
+                                "excluded-prefix": "2001:db8:1::",
+
+                                // Excluded prefix (length) from client assignments.
+                                "excluded-prefix-len": 72,
+
+                                // Prefix pool level list of DHCP options.
+                                "option-data": [],
+
+                                // Prefix range (address) used for client assignments.
+                                "prefix": "2001:db8:1::",
+
+                                // Prefix range (length) used for client assignments.
+                                "prefix-len": 48,
+
+                                // List of client classes which must be evaluated
+                                // when this prefix pool is selected for client assignments.
+                                "require-client-classes": []
+                            }
+                        ],
+
+                        "pools": [
+                            {
+                                // Restricts this pool to be only used for the client
+                                // requests belonging to a particular client class.
+                                "client-class": "phones_server1",
+
+                                // Pool level list of DHCP options.
+                                "option-data": [],
+
+                                // Address range used for client assignments.
+                                "pool": "2001:db8:0:1::/64",
+
+                                // List of client classes which must be evaluated when this pool
+                                // is selected for client assignments.
+                                "require-client-classes": [ "late" ]
+                            },
+                            {
+                                // Restricts this pool to be only used for the client
+                                // requests belonging to a particular client class.
+                                "client-class": "phones_server2",
+
+                                // Pool level list of DHCP options.
+                                "option-data": [],
+
+                                // Address range used for client assignments.
+                                "pool": "2001:db8:0:3::/64",
+
+                                // List of client classes which must be evaluated when this pool
+                                // is selected for client assignments.
+                                "require-client-classes": []
+                            }
+                        ],
+
+                        // Subnet specific (default) preferred lifetime.
+                        "preferred-lifetime": 2000,
+
+                        // Subnet specific min preferred lifetime.
+                        "min-preferred-lifetime": 1500,
+
+                        // Subnet specific max referred lifetime.
+                        "max-preferred-lifetime": 2500,
+
+                        // Boolean flag indicating if the server can respond to
+                        // a Solicit message including a Rapid Commit option with
+                        // the Reply message (See DHCPv6 rapid commit).
+                        "rapid-commit": false,
+
+                        // Subnet level rebind timer.
+                        "rebind-timer": 40,
+
+                        // List of IPv4 relay addresses for which this subnet
+                        // is selected.
+                        "relay": {
+                            "ip-addresses": [
+                                "2001:db8:0:f::1"
+                            ]
+                        },
+
+                        // Subnet level renew timer.
+                        "renew-timer": 30,
+
+                        // Enumeration specifying server's mode of operation when it
+                        // fetches host reservations.
+                        // "reservation-mode": "all",
+                        // It is replaced by the "reservations-global",
+                        // "reservations-in-subnet" and
+                        // "reservations-out-of-pool" parameters.
+
+                        // Specify if server should lookup global reservations.
+                        "reservations-global": false,
+
+                        // Specify if server should lookup in-subnet reservations.
+                        "reservations-in-subnet": true,
+
+                        // Specify if server can assume that all reserved
+                        // addresses are out-of-pool.
+                        // Ignored when reservations-in-subnet is false.
+                        "reservations-out-of-pool": false,
+
+                        // Subnet level compute T1 and T2 timers.
+                        "calculate-tee-times": true,
+
+                        // T1 = valid lifetime * .5.
+                        "t1-percent": .5,
+
+                        // T2 = valid lifetime * .75.
+                        "t2-percent": .75,
+
+                        // Cache threshold = valid lifetime * .25.
+                        "cache-threshold": .25,
+
+                        // Subnet level cache maximum.
+                        "cache-max-age": 10,
+
+                        // List of static IPv6 reservations assigned to the clients belonging
+                        // to this subnet. For detailed example see reservations.json.
+                        "reservations": [
+                            {
+                                // Identifier used for client matching. Supported values are
+                                // "duid", "hw-address" and "flex-id".
+                                "duid": "01:02:03:04:05:06:07:08:09:0A",
+
+                                // List of reserved IPv6 addresses.
+                                "ip-addresses": [ "2001:db8:1:cafe::1" ],
+
+                                // List of reserved IPv6 prefixes.
+                                "prefixes": [ "2001:db8:2:abcd::/64" ],
+
+                                // Reserved hostname.
+                                "hostname": "foo.example.com",
+
+                                // Reservation specific option data.
+                                "option-data": [
+                                    {
+                                        // Option name.
+                                        "name": "vendor-opts",
+
+                                        // Option value.
+                                        "data": "4491"
+                                    }
+                                ]
+                            }
+                        ],
+
+                        // List of client classes which must be evaluated when this subnet
+                        // is selected for client assignments.
+                        "require-client-classes": [ "late" ],
+
+                        // Subnet prefix.
+                        "subnet": "2001:db8::/32",
+
+                        // Subnet level (default) valid lifetime.
+                        "valid-lifetime": 6000,
+
+                        // Subnet level min valid lifetime.
+                        "min-valid-lifetime": 4000,
+
+                        // Subnet level max valid lifetime.
+                        "max-valid-lifetime": 8000
+                    }
+                ],
+
+                // Shared network level (default) valid lifetime.
+                "valid-lifetime": 6001,
+
+                // Shared network level min valid lifetime.
+                "min-valid-lifetime": 4001,
+
+                // Shared network level max valid lifetime.
+                "max-valid-lifetime": 8001
+            }
+        ],
+
+        // List of IPv6 subnets which don't belong to any shared network.
+        "subnet6": [],
+
+        // Global (default) valid lifetime value.
+        "valid-lifetime": 6000,
+
+        // Global min valid lifetime value.
+        "min-valid-lifetime": 4000,
+
+        // Global max valid lifetime value.
+        "max-valid-lifetime": 8000,
+
+        // Reservations (examples are in other files).
+        "reservations": [],
+
+        // Configuration control (currently not used, i.e. this syntax
+        // is already defined but corresponding feature is not implemented).
+        "config-control": {
+            // Only configuration databases entry is defined.
+            "config-databases": [
+                {
+                    // Name of the database to connect to.
+                    "name": "config",
+
+                    // Type of the database, e.g. "mysql", "postgresql".
+                    "type": "mysql"
+                }
+            ],
+            // Intervals between attempts to fetch configuration updates
+            // via the configuration backends used.
+            "config-fetch-wait-time": 30
+        },
+
+        // Server tag.
+        "server-tag": "my DHCPv6 server",
+
+        // DHCP queue control parameters.
+        "dhcp-queue-control": {
+            // Enable queue is mandatory.
+            "enable-queue": true,
+
+            // Queue type was mandatory.
+            "queue-type": "kea-ring6",
+
+            // Capacity is optional.
+            "capacity": 64
+        },
+
+        // Fetches host reservations.
+        // "reservation-mode": "all",
+        // It is replaced by the "reservations-global",
+        // "reservations-in-subnet" and "reservations-out-of-pool" parameters.
+
+        // Specify if server should lookup global reservations.
+        "reservations-global": false,
+
+        // Specify if server should lookup in-subnet reservations.
+        "reservations-in-subnet": true,
+
+        // Specify if server can assume that all reserved addresses
+        // are out-of-pool.
+        // Ignored when reservations-in-subnet is false.
+        // If specified, it is inherited by "shared-networks" and
+        // "subnet6" levels.
+        "reservations-out-of-pool": false,
+
+        // Data directory.
+        "data-directory": "/tmp",
+
+        // Global compute T1 and T2 timers.
+        "calculate-tee-times": true,
+
+        // T1 = valid lifetime * .5.
+        "t1-percent": .5,
+
+        // T2 = valid lifetime * .75.
+        "t2-percent": .75,
+
+        // Cache threshold = valid lifetime * .25.
+        "cache-threshold": .25,
+
+        // Global cache maximum.
+        "cache-max-age": 10,
+
+        // String of zero or more characters with which to replace each
+        // invalid character in the Client FQDN. The default
+        // value is an empty string which will cause invalid characters
+        // to be omitted rather than replaced.
+        "hostname-char-replacement": "x",
+
+        // Regular expression describing the invalid character set in
+        // the Client FQDN.
+        "hostname-char-set": "[^A-Za-z0-9.-]",
+
+        // List of loggers used by the servers using this configuration file.
+        "loggers": [
+            {
+                // Debug level, a value between 0..99. The greater the value
+                // the more detailed debug log.
+                "debuglevel": 99,
+
+                // Name of the logger.
+                "name": "kea-dhcp6",
+
+                // Configures how the log should be output.
+                "output_options": [
+                    {
+                        // Determines whether the log should flushed to a file.
+                        "flush": true,
+
+                        // Specifies maximum filesize before the file is being rotated.
+                        "maxsize": 10240000,
+
+                        // Specifies the maximum number of rotated files being kept.
+                        "maxver": 1,
+
+                        // Specifies logging destination.
+                        "output": "stdout",
+
+                        // Specifies log entry content
+                        "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p [%c/%i] %m\n"
+                    }
+                ],
+
+                // Specifies logging severity, i.e. "ERROR", "WARN", "INFO", "DEBUG".
+                "severity": "INFO"
+            }
+        ],
+
+        // Look at advanced example for the use of user-contexts.
+        "user-context": { }
+    }
+}
diff --git a/doc/examples/kea6/all-keys.json b/doc/examples/kea6/all-keys.json
new file mode 100644
index 0000000..c9e2512
--- /dev/null
+++ b/doc/examples/kea6/all-keys.json
@@ -0,0 +1,1145 @@
+// WARNING: This example configuration is not meant for production use.
+// The Kea DHCPv6 server will refuse this configuration because it contains
+// mutually exclusive configuration parameters.
+//
+// The primary purpose of the example file is to provide a comprehensive
+// list of parameters supported by Kea DHCPv6 server along with the brief
+// description of each parameter.
+//
+// This current version should be up to date, i.e. new keywords should be
+// added in this file at the same time than in the syntax.
+{
+    // Kea DHCPv6 server configuration begins here.
+    "Dhcp6": {
+        // Ordered list of client classes used by the DHCPv6 server.
+        "client-classes": [
+            {
+                // Class name.
+                "name": "phones_server1",
+
+                // Class specific DHCPv6 options list.
+                "option-data": [],
+
+                // Class selection expression. The DHCP packet is assigned to this
+                // class when the given expression evaluates to true.
+                "test": "member('HA_server1')",
+
+                // Class valid lifetime.
+                "valid-lifetime": 6000,
+
+                // Class min valid lifetime.
+                "min-valid-lifetime": 4000,
+
+                // Class max valid lifetime.
+                "max-valid-lifetime": 8000,
+
+                // Class preferred lifetime.
+                "preferred-lifetime": 7000,
+
+                // Class min preferred lifetime.
+                "min-preferred-lifetime": 5000,
+
+                // Class max preferred lifetime.
+                "max-preferred-lifetime": 9000
+            },
+            {
+                // Second class name.
+                "name": "phones_server2",
+
+                // Class specific DHCPv6 options list.
+                "option-data": [],
+
+                // Class selection expression. The DHCP packet is assigned to this
+                // class when the given expression evaluates to true.
+                "test": "member('HA_server2')"
+            },
+            {
+                // Third class name.
+                "name": "late",
+
+                // Boolean flag indicating that the class expression is only evaluated
+                // when the class is required, e.g. selected address pool configuration
+                // includes this class name in its "require-client-classes" list. The
+                // default value false means that the class test expression must
+                // always be evaluated.
+                "only-if-required": true,
+
+                // Class selection expression.
+                "test": "member('ALL')"
+            }
+        ],
+
+        // Parameters for triggering behaviors compatible with broken or
+        // non-compliant clients, relays or other agents
+        "compatibility": {
+            // Parse options more leniently where fields can be deduced
+            // deterministically even if against RFC or common practice.
+            "lenient-option-parsing": true
+        },
+
+        // Command control socket configuration parameters for Kea DHCPv6 server.
+        "control-socket": {
+            // Location of the unix domain socket file the DHCPv6 server uses
+            // to receive control commands from the Kea Control Agent or the
+            // local server administrator.
+            "socket-name": "/tmp/kea6-ctrl-socket",
+
+            // Control socket type used by the Kea DHCPv6 server. The 'unix'
+            // socket is currently the only supported type.
+            "socket-type": "unix"
+        },
+
+        // Specifies a prefix to be prepended to the generated Client FQDN.
+        // It may be specified at the global, shared-network and subnet levels.
+        "ddns-generated-prefix": "myhost",
+
+        // Boolean flag indicating that server should ignore DHCP client
+        // wishes to update DNS on its own. With that flag set to true
+        // the server will send DNS updates for both forward and
+        // reverse DNS data. The default value is false, which indicates
+        // that the server will delegate DNS update to the client when
+        // requested.  It may be specified at the global, shared-network
+        // and subnet levels.
+        "ddns-override-client-update": false,
+
+        // Boolean flag indicating that the server should override DHCP
+        // client's wish to not update the DNS. With this parameter
+        // set to true the server will send DNS update even when
+        // the client requested no update.  It may be specified at the
+        // global, shared-network and subnet levels.
+        "ddns-override-no-update": false,
+
+        // Suffix appended to the partial name sent to the DNS. The
+        // default value is an empty string which indicates that no
+        // suffix is appended.  It may be specified at the global,
+        // shared-network and subnet levels.
+        "ddns-qualifying-suffix": "",
+
+        // Enumeration specifying whether the server should honor
+        // hostname or Client FQDN sent by the client or replace
+        // this name. The acceptable values are: "never" (use the
+        // name the client sent), "always" (replace the name the
+        // client sent), "when-present" (replace the name the client
+        // sent, but do not generate one when the client didn't sent
+        // the name), "when-not-present" (generate the name when
+        // client didn't send one, otherwise leave the name the
+        // client sent). The default value is "never".  It may be
+        // specified at the global, shared-network and subnet levels.
+        "ddns-replace-client-name": "never",
+
+        // Boolean flag which enables or disables the DDNS updating. It
+        // defaults to true.  It may be specified at the global, shared-
+        // network and subnet levels. It works in conjunction with
+        // dhcp-ddns:enable-updates which must be true to enable connectivity
+        // to kea-dhcp-ddns.
+        "ddns-send-updates": true,
+
+        // Boolean flag, which when true instructs the server to always
+        // update DNS when leases are renewed, even if the DNS information
+        // has not changed.  The server's default behavior (i.e. flag is false)
+        // is to only update DNS if the DNS information has changed.  It
+        // may be specified at the global, shared-network and subnet levels.
+        "ddns-update-on-renew": true,
+
+        // Boolean flag, which is passed to kea-dhcp-ddns with each DDNS
+        // update request to indicate whether or not DNS update conflict
+        // resolution as described in RFC 4703 should be employed for the
+        // given update request.  The default value for this flag is true.
+        // It may be specified at the global, shared-network and subnet levels.
+        "ddns-use-conflict-resolution": true,
+
+        // Time in seconds specifying how long a declined lease should be
+        // excluded from DHCP assignments. The default value is 24 hours.
+        "decline-probation-period": 86400,
+
+        // Name Change Requests forwarding configuration for Kea DHCPv6 server.
+        // NCRs are sent to Kea D2 module to update DNS upon allocation of the
+        // DHCP leases.
+        "dhcp-ddns": {
+            // Boolean flag indicating if Kea DHCPv6 server should connect to
+            // kea-dhcp-ddns.  This must be true for NCRs to be created and
+            // sent to kea-dhcp-ddns. By default NCRs are not generated.
+            "enable-updates": false,
+
+            // Specifies maximum number of NCRs to queue waiting to be sent
+            // to Kea D2 server.
+            "max-queue-size": 1024,
+
+            // Packet format to use when sending NCRs to Kea D2 server.
+            // Currently, only JSON format is supported.
+            "ncr-format": "JSON",
+
+            // Socket protocol to use when sending NCRs to D2. Currently,
+            // only UDP is supported.
+            "ncr-protocol": "UDP",
+
+            // IP address that Kea DHCPv6 server should use to send
+            // NCRs to D2. Default value of zero indicates that Kea
+            // should pick suitable address.
+            "sender-ip": "::1",
+
+            // Port number that Kea DHCPv6 server should use to send
+            // NCRs to D2. Default value of zero indicates that Kea
+            // should pick suitable port.
+            "sender-port": 0,
+
+            // IP address on which D2 listens for NCRs.
+            "server-ip": "::1",
+
+            // Port number on which D2 listens for NCRs.
+            "server-port": 53001,
+
+            // The follow parameters are DEPRECATED.  They have been
+            // replaced with parameters that may be set at the global,
+            // shared-network, and subnet6 scopes.  They are listed here
+            // as configuration parsing still accepts them.  Eventually
+            // support for them will be removed.
+            "generated-prefix": "myhost",
+            "hostname-char-replacement": "x",
+            "hostname-char-set": "[^A-Za-z0-9.-]",
+            "override-client-update": false,
+            "override-no-update": false,
+            "qualifying-suffix": "",
+            "replace-client-name": "never"
+        },
+
+        // Specifies the first of the two consecutive ports of the UDP
+        // sockets used for communication between DHCPv6 and DHCPv4
+        // servers. See RFC 7341.
+        "dhcp4o6-port": 0,
+
+        // Collection of Kea DHCPv6 server parameters configuring how
+        // the server should process expired DHCP leases.
+        "expired-leases-processing": {
+            // Specifies the number of seconds since last removal of
+            // the expired leases when next removal should occur.
+            "flush-reclaimed-timer-wait-time": 25,
+
+            // Specifies the time period in seconds to keep expired
+            // leases in the lease database (lease affinity).
+            "hold-reclaimed-time": 3600,
+
+            // Specifies the maximum number of expired leases that can be
+            // processed in a single attempt to clean up the lease
+            // database from the expired leases. If there are more
+            // expired leases, they will be processed during the next
+            // cleanup attempt.
+            "max-reclaim-leases": 100,
+
+            // Specifies the maximum time in milliseconds that the single
+            // attempt to cleanup the lease database from the expired
+            // leases may take.
+            "max-reclaim-time": 250,
+
+            // Specifies the time period in seconds since last attempt
+            // to process expired leases to initiate the next attempt.
+            "reclaim-timer-wait-time": 10,
+
+            // Specifies the maximum number of expired leases processing
+            // cycles which didn't result in full cleanup of the lease
+            // database from the expired leases, after which a
+            // warning message is issued.
+            "unwarned-reclaim-cycles": 5
+        },
+
+        // List of hooks libraries and their specific configuration parameters
+        // to be loaded by Kea DHCPv4 server.
+        "hooks-libraries": [
+            {
+                // Location of the hooks library to be loaded.
+                "library": "/opt/lib/kea/hooks/libdhcp_lease_cmds.so",
+
+                // Hook library specific configuration parameters.
+                "parameters": { }
+            }
+        ],
+
+        // List of access credentials to external sources of IPv6 reservations,
+        "hosts-databases": [
+            {
+                // Name of the database to connect to.
+                "name": "keatest",
+
+                // Host on which the database resides.
+                "host": "localhost",
+
+                // Database password.
+                "password": "keatest",
+
+                // Port on which the database is available.
+                "port": 3306,
+
+                // Type of the database, e.g. "mysql", "postgresql".
+                "type": "mysql",
+
+                // User name to be used to access the database.
+                "user": "keatest",
+
+                // Read only mode.
+                "readonly": false,
+
+                // Next entries are for the OpenSSL support in MySQL.
+                // Trust anchor aka certificate authority file or directory.
+                "trust-anchor": "my-ca",
+
+                // Client certificate file name.
+                "cert-file": "my-cert",
+
+                // Private key file name.
+                "key-file": "my-key",
+
+                // Cipher list (see the OpenSSL ciphers command manual).
+                "cipher-list": "AES"
+            },
+            {
+                // Name of the database to connect to.
+                "name": "keatest",
+
+                // Host on which the database resides.
+                "host": "localhost",
+
+                // Database password.
+                "password": "keatest",
+
+                // Port on which the database is available.
+                "port": 5432,
+
+                // Type of the database, e.g. "mysql", "postgresql".
+                "type": "postgresql",
+
+                // User name to be used to access the database.
+                "user": "keatest"
+            },
+            {
+                // Name of the database to connect to.
+                "name": "keatest",
+
+                // Database password.
+                "password": "keatest",
+
+                // Port on which the database is available.
+                "port": 9042,
+
+                // Type of the database, e.g. "mysql", "postgresql".
+                "type": "mysql",
+
+                // User name to be used to access the database.
+                "user": "keatest",
+
+                // Connection reconnect wait time.
+                // This parameter governs how long Kea waits before attempting
+                // to reconnect. Expressed in milliseconds. The default is 0
+                // (disabled) for MySQL and PostgreSQL.
+                "reconnect-wait-time": 3000,
+
+                // Connection maximum reconnect tries.
+                "max-reconnect-tries": 3,
+
+                // Action to take when connection recovery fails.
+                // Supported values: stop-retry-exit, serve-retry-exit,
+                // serve-retry-continue
+                "on-fail": "stop-retry-exit",
+
+                // Connection connect timeout.
+                "connect-timeout": 100
+            }
+        ],
+
+        // List of host reservation identifier types to be used by the
+        // Kea DHCPv6 server to fetch static reservations for the
+        // DHCP clients. All identifiers are used by default, which
+        // means that the server will issue multiple queries to the
+        // database to find if there is a reservation for the particular
+        // client. If the particular deployment uses only subset, e.g.
+        // one, identifier type, this identifier should be only listed
+        // here to prevent unnecessary queries to the database.
+        "host-reservation-identifiers": [
+            "hw-address",
+            "duid",
+            "flex-id"
+        ],
+
+        // Specifies configuration of interfaces on which the Kea DHCPv6
+        // server is listening to the DHCP queries.
+        "interfaces-config": {
+            // Specifies a list of interfaces on which the Kea DHCPv6
+            // server should listen to the DHCP requests.
+            "interfaces": [
+                "eth0"
+            ],
+
+            // Boolean flag indicating if the available interfaces should
+            // be re-detected upon server reconfiguration. The default value
+            // is true which means that the interfaces are always
+            // re-detected.
+            "re-detect": true,
+
+            // Kea tries to bind the service sockets during initialization. It may
+            // fail due to a port being already opened or misconfiguration. Kea can
+            // suppress these errors and only logs them. This flag prevents starting
+            // the DHCP server without binding all sockets. If unspecified, it
+            // defaults to false.
+            "service-sockets-require-all": true,
+
+            // Kea tries to bind the service sockets during initialization. This
+            // option specifies how many times binding to interface will be retried.
+            // The default value is 0 which means that the operation will not be
+            // repeated.
+            "service-sockets-max-retries": 5,
+
+            // The time interval in milliseconds to wait before the next attempt to
+            // retry opening a service socket.
+            "service-sockets-retry-wait-time": 5000
+        },
+
+        // Boolean parameter which controls whether an early global host
+        // reservations lookup should be performed. This lookup takes place
+        // before subnet selection and when a global reservation is found
+        // with some client classes, it triggers a second phase classification.
+        // It can also be used to drop queries using host reservations as a
+        // decision table indexed by reservation identifiers.
+        "early-global-reservations-lookup": true,
+
+        // Boolean parameter which controls DHCP server's behavior with respect
+        // to creating host reservations for the same IP address or delegated
+        // prefix. By default this flag is set to true in which case the server
+        // prevents creation of multiple host reservations for the same IP address
+        // or delegated prefix. When this parameter is set to false, the server
+        // allows for creating multiple reservations for the same IP address or
+        // delegated prefix within a subnet. This setting is useful in deployments
+        // in which a given host may be communicating with a DHCP server over
+        // multiple interfaces and depending on the chosen interface different
+        // MAC address (or other identifier) will be used to identify the host.
+        // Note that some host backends do not support the mode in which multiple
+        // reservations for the same IP address or delegated prefix are used.
+        // If these backends are in use and this setting is attempted a
+        // configuration error will occur. The MySQL and PostgreSQL backends do
+        // support this mode.
+        "ip-reservations-unique": true,
+
+        /// Boolean parameter which controls whether host reservations lookup
+        /// should be performed before lease lookup. This parameter has effect
+        /// only when multi-threading is disabled. When multi-threading is
+        /// enabled, host reservations lookup is always performed first to avoid
+        /// lease lookup resource locking.
+        "reservations-lookup-first": true,
+
+        // Specifies credentials to access lease database.
+        "lease-database": {
+            // memfile backend specific parameter specifying the interval
+            // in seconds at which lease file should be cleaned up (outdated
+            // lease entries are removed to prevent lease file from growing
+            // infinitely).
+            "lfc-interval": 3600,
+
+            // Maximum number of lease file read errors allowed before
+            // loading the file is abandoned.  Defaults to 0 (no limit).
+            "max-row-errors": 100,
+
+            // Name of the lease file. In case of database it specifies the
+            // database name.
+            "name": "/tmp/kea-dhcp6.csv",
+
+            // memfile specific parameter indicating whether leases should
+            // be saved on persistent storage (disk) or not. The true value
+            // is the default and it indicates that leases are stored in the
+            // persistent storage. This setting must be used in production.
+            // The false value should only be used for testing purposes
+            // because non stored leases will be lost upon Kea server restart.
+            "persist": true,
+
+            // Lease database backend type, i.e. "memfile", "mysql" or
+            // "postgresql".
+            "type": "memfile"
+        },
+
+        // List of parameters indicating how the client's MAC address can be
+        // inferred from the DHCP query. Supported values are listed in the
+        // Kea Administrator Reference Manual.
+        "mac-sources": [ "duid" ],
+
+        // List of global DHCP options that Kea DHCPv6 server assigns to the
+        // clients.
+        "option-data": [
+            {
+                // Boolean flag indicating if the given option is always
+                // send in response or only when requested. The default
+                // value of false indicates that it is only sent when
+                // requested.
+                "always-send": false,
+
+                // Option code. It is not required if the option name is
+                // provided.
+                "code": 23,
+
+                // Boolean value indicating whether the option data specified
+                // in the "data" field is specified as a string of hexadecimal
+                // digits or in human readable CSV format.
+                "csv-format": true,
+
+                // Option data to be stored in the option payload.
+                "data": "2001:db8:2::45, 2001:db8:2::100",
+
+                // Option name. It is not required of the option code is
+                // provided.
+                "name": "dns-servers",
+
+                // Option space. The default is the "dhcp6" option space which
+                // groups top level DHCPv6 options.
+                "space": "dhcp6"
+            }
+        ],
+
+        // List of global option definitions, i.e. option formats, that the
+        // Kea DHCPv6 server is using.
+        "option-def": [
+            {
+                // Boolean flag indicating if the option definition comprises
+                // an array of values of some type, e.g. array of IPv6 addresses.
+                // The default value of false means that the option does not
+                // comprise an array of values.
+                "array": false,
+
+                // Option code.
+                "code": 6,
+
+                // Holds a name of the option space encapsulated by this option.
+                // All options that belong to this option space will be sent
+                // as sub-options of this option. Empty string means that this
+                // option doesn't encapsulate any option.
+                "encapsulate": "",
+
+                // Option name.
+                "name": "my-option",
+
+                // Specifies the types of fields within the option if the option
+                // is said to be a "record" (see "type"). in this particular example
+                // this option comprises two fields, 1 byte and 2 bytes long.
+                "record-types": "uint8, uint16",
+
+                // Name of the option space to which this option belongs.
+                "space": "my-space",
+
+                // Option type. All possible types are listed in the Kea
+                // Administrator Reference Manual.
+                "type": "record"
+            }
+        ],
+
+        // Global value which limits the number of client packets (e.g.
+        // REQUESTs,RENEWs...) that may be parked while waiting for
+        // hook library work to complete, prior to a response (e.g. REPLY)
+        // being sent back to the client.  A typical example is when kea-dhcp6
+        // parks a REQUEST while it sends the lease update(s) to its
+        // HA peer(s). The packet is unparked once the update(s) have been
+        // acknowledged.  This value limits the number of packets that can
+        // be held pending the updates. In times of heavy client traffic,
+        // this value can keep kea-dhcp6 from building an insurmountable
+        // backlog of updates.
+        "parked-packet-limit": 128,
+
+        // Global (default) value of the preferred lifetime.
+        "preferred-lifetime": 50,
+
+        // Global min value of the preferred lifetime.
+        "min-preferred-lifetime": 40,
+
+        // Global max value of the preferred lifetime.
+        "max-preferred-lifetime": 60,
+
+        // Global value for the rebind timer, i.e. the time after which the
+        // DHCP client enters rebind state if it fails to renew the lease.
+        "rebind-timer": 40,
+
+        // List of relay supplied option codes. See RFC 6422.
+        "relay-supplied-options": [ "110", "120", "130" ],
+
+        // Global value for the renew timer, i.e. the timer after which the
+        // DHCP client renews the lease.
+        "renew-timer": 30,
+
+        // Global value to store extended information (e.g. relay agent
+        // information) with each lease.
+        "store-extended-info": true,
+
+        // Statistics keep some samples per observation point.
+        // There are two default values: maximum count and maximum age.
+        // Set the maximum count to zero disables it.
+        "statistic-default-sample-count": 0,
+
+        // When the maximum count is 0 the maximum age (in seconds) applies.
+        "statistic-default-sample-age": 60,
+
+        // Multi-threading parameters.
+        "multi-threading": {
+            // By default Kea processes packets on a single thread (default
+            // 'false' value for this option). To enable multi-threading, this
+            // option can be set ('true' value).
+            "enable-multi-threading": false,
+
+            // When multi-threading is enabled, Kea will process packets on a
+            // number of multiple threads configurable through this option. The
+            // value must be a positive integer (0 means auto detect).
+            "thread-pool-size": 0,
+
+            // When multi-threading is enabled, Kea will read packets from the
+            // interface and append a working item to the thread pool. This
+            // option configures the maximum number of items that can be queued.
+            // The value must be a positive integer (0 means unlimited).
+            "packet-queue-size": 0
+        },
+
+        // Governs how the Kea DHCPv6 server should deal with the invalid
+        // data received from the client.
+        "sanity-checks": {
+            // Specifies how the Kea DHCPv6 server should behave when invalid
+            // data is read for a lease from the lease file. The following
+            // values are supported "none" (don't attempt to correct the
+            // lease information), "warn" (print a warning for subnet-id
+            // related inconsistencies), "fix" (correct the subnet id by
+            // trying to find the suitable subnet), "fix-del" (similar
+            // to "fix" but delete the lease if no suitable subnet found),
+            // "del" (delete the lease if the lease has invalid subnet
+            // identifier value).
+            "lease-checks": "warn"
+        },
+
+        // Custom DUID used by the DHCPv6 server.
+        "server-id": {
+            // Type of the DUID. Possible values are "LLT", "EN", and "LL".
+            "type": "EN",
+
+            // Enterprise id used for "EN" duid.
+            "enterprise-id": 2495,
+
+            // Identifier part of the DUID.
+            "identifier": "0123456789",
+
+            // Boolean flag indicating if the DUID should be persisted on
+            // disk.
+            "persist": false
+        },
+
+        // List of shared networks used by Kea DHCPv6 server. The shared
+        // networks group subnets together.
+        "shared-networks": [
+            {
+                // Restricts this shared network to allow only clients
+                // that belong to the particular client class. If an
+                // empty string is provided, no restriction is applied.
+                "client-class": "",
+
+                // Shared network level value. See description at the global level.
+                "ddns-generated-prefix": "myhost",
+
+                // Shared network level value. See description at the global level.
+                "ddns-override-client-update": false,
+
+                // Shared network level value. See description at the global level.
+                "ddns-override-no-update": false,
+
+                // Shared network level value. See description at the global level.
+                "ddns-qualifying-suffix": "",
+
+                // Shared network level value. See description at the global level.
+                "ddns-replace-client-name": "never",
+
+                // Shared network level value. See description at the global level.
+                "ddns-send-updates": true,
+
+                // Shared network level value. See description at the global level.
+                "ddns-update-on-renew": true,
+
+                // Shared network level value. See description at the global level.
+                "ddns-use-conflict-resolution": true,
+
+                // Shared network level value. See description at the global level.
+                "hostname-char-replacement": "x",
+
+                // Shared network level value. See description at the global level.
+                "hostname-char-set": "[^A-Za-z0-9.-]",
+
+                // Specifies that this shared network is selected for the
+                // requests received on the particular interface.
+                "interface": "eth0",
+
+                // Specifies the content of the interface-id option used
+                // by relays to identify the interface on the relay to
+                // which the response is sent.
+                "interface-id": "",
+
+                // Shared network name.
+                "name": "my-secret-network",
+
+                // List of shared network specific DHCP options.
+                "option-data": [],
+
+                // Shared network specific (default) preferred lifetime.
+                "preferred-lifetime": 2000,
+
+                // Shared network specific min preferred lifetime.
+                "min-preferred-lifetime": 1500,
+
+                // Shared network specific ma xpreferred lifetime.
+                "max-preferred-lifetime": 2500,
+
+                // Boolean flag indicating if the server can respond to
+                // a Solicit message including a Rapid Commit option with
+                // the Reply message (See DHCPv6 rapid commit).
+                "rapid-commit": false,
+
+                // List of IPv6 relay addresses for which this shared
+                // network is selected.
+                "relay": {
+                    "ip-addresses": []
+                },
+
+                // Shared network level rebind timer.
+                "rebind-timer": 41,
+
+                // Shared network level renew timer.
+                "renew-timer": 31,
+
+                // Shared network level compute T1 and T2 timers.
+                "calculate-tee-times": true,
+
+                // T1 = valid lifetime * .5.
+                "t1-percent": .5,
+
+                // T2 = valid lifetime * .75.
+                "t2-percent": .75,
+
+                // Cache threshold = valid lifetime * .25.
+                "cache-threshold": .25,
+
+                // Cache maximum: when the client last transmission time
+                // is close enough the lease is not renewed and current
+                // lease is returned as it was "cached".
+                "cache-max-age": 10,
+
+                // Enumeration specifying server's mode of operation when it
+                // fetches host reservations.
+                // "reservation-mode": "all",
+                // It is replaced by the "reservations-global",
+                // "reservations-in-subnet" and "reservations-out-of-pool"
+                // parameters.
+
+                // Specify if server should lookup global reservations.
+                "reservations-global": false,
+
+                // Specify if server should lookup in-subnet reservations.
+                "reservations-in-subnet": true,
+
+                // Specify if server can assume that all reserved addresses
+                // are out-of-pool.
+                // Ignored when reservations-in-subnet is false.
+                // If specified, it is inherited by "subnet6" levels.
+                "reservations-out-of-pool": false,
+
+                // List of client classes which must be evaluated when this shared
+                // network is selected for client assignments.
+                "require-client-classes": [ "late" ],
+
+                // Turn off storage of extended information (e.g. relay agent
+                // information) with each lease for this shared-network.
+                "store-extended-info": false,
+
+                // List of IPv6 subnets belonging to this shared network.
+                "subnet6": [
+                    {
+                        // Restricts this subnet to allow only clients that belong
+                        // to the particular client class. If an empty string is
+                        // provided, no restriction is applied.
+                        "client-class": "",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-generated-prefix": "myhost",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-override-client-update": false,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-override-no-update": false,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-qualifying-suffix": "",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-replace-client-name": "never",
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-send-updates": true,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-update-on-renew": true,
+
+                        // Subnet level value. See description at the global level.
+                        "ddns-use-conflict-resolution": true,
+
+                        // Subnet level value. See description at the global level.
+                        "hostname-char-replacement": "x",
+
+                        // Subnet level value. See description at the global level.
+                        "hostname-char-set": "[^A-Za-z0-9.-]",
+
+                        // Subnet unique identifier.
+                        "id": 1,
+
+                        // Specifies that this subnet is selected for the requests
+                        // received on the particular interface.
+                        "interface": "eth0",
+
+                        // Specifies the content of the interface-id option used
+                        // by relays to identify the interface on the relay to
+                        // which the response is sent.
+                        "interface-id": "",
+
+                        // Turn on storage of extended information (e.g. relay agent
+                        // information) with each lease for this subnet.
+                        "store-extended-info": true,
+
+                        // Subnet level list of DHCP options.
+                        "option-data": [
+                            {
+                                // Boolean flag indicating if the particular option
+                                // should be always sent or sent only when requested.
+                                "always-send": false,
+
+                                // Option code.
+                                "code": 7,
+
+                                // Boolean flag indicating if the option value specified
+                                // in "data" is a string of hexadecimal values or human
+                                // readable CSV value.
+                                "csv-format": false,
+
+                                // Option data to be included in the option payload.
+                                "data": "0xf0",
+
+                                // Option name.
+                                "name": "preference",
+
+                                // Option space. The default value "dhcp6" designates the
+                                // top level option space.
+                                "space": "dhcp6"
+                            }
+                        ],
+
+                        // List of pools from which delegated prefixes are assigned to the
+                        // clients.
+                        "pd-pools": [
+                            {
+                                // Restricts this prefix pool to be used only for the client
+                                // requests belonging to a particular client class.
+                                "client-class": "phones_server1",
+
+                                // Length of prefixes delegated to clients.
+                                "delegated-len": 64,
+
+                                // Excluded prefix (address) from client assignments.
+                                "excluded-prefix": "2001:db8:1::",
+
+                                // Excluded prefix (length) from client assignments.
+                                "excluded-prefix-len": 72,
+
+                                // Prefix pool level list of DHCP options.
+                                "option-data": [],
+
+                                // Prefix range (address) used for client assignments.
+                                "prefix": "2001:db8:1::",
+
+                                // Prefix range (length) used for client assignments.
+                                "prefix-len": 48,
+
+                                // List of client classes which must be evaluated
+                                // when this prefix pool is selected for client assignments.
+                                "require-client-classes": []
+                            }
+                        ],
+
+                        "pools": [
+                            {
+                                // Restricts this pool to be only used for the client
+                                // requests belonging to a particular client class.
+                                "client-class": "phones_server1",
+
+                                // Pool level list of DHCP options.
+                                "option-data": [],
+
+                                // Address range used for client assignments.
+                                "pool": "2001:db8:0:1::/64",
+
+                                // List of client classes which must be evaluated when this pool
+                                // is selected for client assignments.
+                                "require-client-classes": [ "late" ]
+                            },
+                            {
+                                // Restricts this pool to be only used for the client
+                                // requests belonging to a particular client class.
+                                "client-class": "phones_server2",
+
+                                // Pool level list of DHCP options.
+                                "option-data": [],
+
+                                // Address range used for client assignments.
+                                "pool": "2001:db8:0:3::/64",
+
+                                // List of client classes which must be evaluated when this pool
+                                // is selected for client assignments.
+                                "require-client-classes": []
+                            }
+                        ],
+
+                        // Subnet specific (default) preferred lifetime.
+                        "preferred-lifetime": 2000,
+
+                        // Subnet specific min preferred lifetime.
+                        "min-preferred-lifetime": 1500,
+
+                        // Subnet specific max referred lifetime.
+                        "max-preferred-lifetime": 2500,
+
+                        // Boolean flag indicating if the server can respond to
+                        // a Solicit message including a Rapid Commit option with
+                        // the Reply message (See DHCPv6 rapid commit).
+                        "rapid-commit": false,
+
+                        // Subnet level rebind timer.
+                        "rebind-timer": 40,
+
+                        // List of IPv4 relay addresses for which this subnet
+                        // is selected.
+                        "relay": {
+                            "ip-addresses": [
+                                "2001:db8:0:f::1"
+                            ]
+                        },
+
+                        // Subnet level renew timer.
+                        "renew-timer": 30,
+
+                        // Enumeration specifying server's mode of operation when it
+                        // fetches host reservations.
+                        // "reservation-mode": "all",
+                        // It is replaced by the "reservations-global",
+                        // "reservations-in-subnet" and
+                        // "reservations-out-of-pool" parameters.
+
+                        // Specify if server should lookup global reservations.
+                        "reservations-global": false,
+
+                        // Specify if server should lookup in-subnet reservations.
+                        "reservations-in-subnet": true,
+
+                        // Specify if server can assume that all reserved
+                        // addresses are out-of-pool.
+                        // Ignored when reservations-in-subnet is false.
+                        "reservations-out-of-pool": false,
+
+                        // Subnet level compute T1 and T2 timers.
+                        "calculate-tee-times": true,
+
+                        // T1 = valid lifetime * .5.
+                        "t1-percent": .5,
+
+                        // T2 = valid lifetime * .75.
+                        "t2-percent": .75,
+
+                        // Cache threshold = valid lifetime * .25.
+                        "cache-threshold": .25,
+
+                        // Subnet level cache maximum.
+                        "cache-max-age": 10,
+
+                        // List of static IPv6 reservations assigned to the clients belonging
+                        // to this subnet. For detailed example see reservations.json.
+                        "reservations": [
+                            {
+                                // Identifier used for client matching. Supported values are
+                                // "duid", "hw-address" and "flex-id".
+                                "duid": "01:02:03:04:05:06:07:08:09:0A",
+
+                                // List of reserved IPv6 addresses.
+                                "ip-addresses": [ "2001:db8:1:cafe::1" ],
+
+                                // List of reserved IPv6 prefixes.
+                                "prefixes": [ "2001:db8:2:abcd::/64" ],
+
+                                // Reserved hostname.
+                                "hostname": "foo.example.com",
+
+                                // Reservation specific option data.
+                                "option-data": [
+                                    {
+                                        // Option name.
+                                        "name": "vendor-opts",
+
+                                        // Option value.
+                                        "data": "4491"
+                                    }
+                                ]
+                            }
+                        ],
+
+                        // List of client classes which must be evaluated when this subnet
+                        // is selected for client assignments.
+                        "require-client-classes": [ "late" ],
+
+                        // Subnet prefix.
+                        "subnet": "2001:db8::/32",
+
+                        // Subnet level (default) valid lifetime.
+                        "valid-lifetime": 6000,
+
+                        // Subnet level min valid lifetime.
+                        "min-valid-lifetime": 4000,
+
+                        // Subnet level max valid lifetime.
+                        "max-valid-lifetime": 8000
+                    }
+                ],
+
+                // Shared network level (default) valid lifetime.
+                "valid-lifetime": 6001,
+
+                // Shared network level min valid lifetime.
+                "min-valid-lifetime": 4001,
+
+                // Shared network level max valid lifetime.
+                "max-valid-lifetime": 8001
+            }
+        ],
+
+        // List of IPv6 subnets which don't belong to any shared network.
+        "subnet6": [],
+
+        // Global (default) valid lifetime value.
+        "valid-lifetime": 6000,
+
+        // Global min valid lifetime value.
+        "min-valid-lifetime": 4000,
+
+        // Global max valid lifetime value.
+        "max-valid-lifetime": 8000,
+
+        // Reservations (examples are in other files).
+        "reservations": [],
+
+        // Configuration control (currently not used, i.e. this syntax
+        // is already defined but corresponding feature is not implemented).
+        "config-control": {
+            // Only configuration databases entry is defined.
+            "config-databases": [
+                {
+                    // Name of the database to connect to.
+                    "name": "config",
+
+                    // Type of the database, e.g. "mysql", "postgresql".
+                    "type": "mysql"
+                }
+            ],
+            // Intervals between attempts to fetch configuration updates
+            // via the configuration backends used.
+            "config-fetch-wait-time": 30
+        },
+
+        // Server tag.
+        "server-tag": "my DHCPv6 server",
+
+        // DHCP queue control parameters.
+        "dhcp-queue-control": {
+            // Enable queue is mandatory.
+            "enable-queue": true,
+
+            // Queue type was mandatory.
+            "queue-type": "kea-ring6",
+
+            // Capacity is optional.
+            "capacity": 64
+        },
+
+        // Fetches host reservations.
+        // "reservation-mode": "all",
+        // It is replaced by the "reservations-global",
+        // "reservations-in-subnet" and "reservations-out-of-pool" parameters.
+
+        // Specify if server should lookup global reservations.
+        "reservations-global": false,
+
+        // Specify if server should lookup in-subnet reservations.
+        "reservations-in-subnet": true,
+
+        // Specify if server can assume that all reserved addresses
+        // are out-of-pool.
+        // Ignored when reservations-in-subnet is false.
+        // If specified, it is inherited by "shared-networks" and
+        // "subnet6" levels.
+        "reservations-out-of-pool": false,
+
+        // Data directory.
+        "data-directory": "/tmp",
+
+        // Global compute T1 and T2 timers.
+        "calculate-tee-times": true,
+
+        // T1 = valid lifetime * .5.
+        "t1-percent": .5,
+
+        // T2 = valid lifetime * .75.
+        "t2-percent": .75,
+
+        // Cache threshold = valid lifetime * .25.
+        "cache-threshold": .25,
+
+        // Global cache maximum.
+        "cache-max-age": 10,
+
+        // String of zero or more characters with which to replace each
+        // invalid character in the Client FQDN. The default
+        // value is an empty string which will cause invalid characters
+        // to be omitted rather than replaced.
+        "hostname-char-replacement": "x",
+
+        // Regular expression describing the invalid character set in
+        // the Client FQDN.
+        "hostname-char-set": "[^A-Za-z0-9.-]",
+
+        // List of loggers used by the servers using this configuration file.
+        "loggers": [
+            {
+                // Debug level, a value between 0..99. The greater the value
+                // the more detailed debug log.
+                "debuglevel": 99,
+
+                // Name of the logger.
+                "name": "kea-dhcp6",
+
+                // Configures how the log should be output.
+                "output_options": [
+                    {
+                        // Determines whether the log should flushed to a file.
+                        "flush": true,
+
+                        // Specifies maximum filesize before the file is being rotated.
+                        "maxsize": 10240000,
+
+                        // Specifies the maximum number of rotated files being kept.
+                        "maxver": 1,
+
+                        // Specifies logging destination.
+                        "output": "stdout",
+
+                        // Specifies log entry content
+                        "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p [%c/%i] %m\n"
+                    }
+                ],
+
+                // Specifies logging severity, i.e. "ERROR", "WARN", "INFO", "DEBUG".
+                "severity": "INFO"
+            }
+        ],
+
+        // Look at advanced example for the use of user-contexts.
+        "user-context": { }
+    }
+}
diff --git a/doc/examples/kea6/all-options.json b/doc/examples/kea6/all-options.json
new file mode 100644
index 0000000..477800d
--- /dev/null
+++ b/doc/examples/kea6/all-options.json
@@ -0,0 +1,2076 @@
+// This example configuration file for DHCPv6 server in Kea contains:
+//
+// - data for all the standard options
+// - custom option definitions at global level along with some associated
+// option data
+// - custom option data with standardized option spaces other than "dhcp6"
+// - custom option spaces
+// - option embedding examples
+// - DOCSIS3 option data
+//
+// The reader is strongly encouraged to take a look at the option formats
+// documented in the Kea ARM:
+// https://kea.readthedocs.io/en/latest/arm/dhcp6-srv.html?highlight=option%20definitions#dhcp6-std-options-list
+//
+// Other options require special logic which is not yet implemented. They are
+// marked with:
+// "Note: special logic not implemented"
+
+{
+  "Dhcp6": {
+    /*                Data for all standard option definitions                */
+    // Option data defined globally
+    "option-data": [
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPTION_PREFERENCE       |          option-len           |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |  pref-value   |
+      +-+-+-+-+-+-+-+-+
+
+      option-code   OPTION_PREFERENCE (7).
+
+      option-len    1.
+
+      pref-value    The preference value for the server in this message.
+      */
+      // Type: uint8
+      {
+        "code": 7,
+        "data": "0xf0",
+        "name": "preference"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |          OPTION_UNICAST       |        option-len             |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                       server-address                          |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code     OPTION_UNICAST (12).
+
+      option-len      16.
+
+      server-address  The IP address to which the client should send
+                      messages delivered using unicast.
+      */
+      // Type: IPv6 address
+      {
+        "code": 12,
+        "data": "2001:db8::2",
+        "name": "unicast"
+      },
+
+      /*
+      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_VENDOR_OPTS       |           option-len          |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                       enterprise-number                       |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                                                               .
+      .                          option-data                          .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code          OPTION_VENDOR_OPTS (17)
+
+      option-len           4 + length of option-data field
+
+      enterprise-number    The vendor's registered Enterprise Number as
+                           registered with IANA [6].
+
+      option-data          An opaque object of option-len octets,
+                           interpreted by vendor-specific code on the
+                           clients and servers
+      */
+      // Type: uint32
+      // The vendor options are not standardized and are specific to each
+      // vendor. The vendors are identified with the enterprise number,
+      // sometimes also called vendor-id or enterprise-id. For example,
+      // CableLabs that specified DOCSIS options, use 4491. Some vendors
+      // have their own mechanisms. For example, DOCSIS vendor sub-option 1
+      // is an equivalent of ORO for normal DHCPv6 options. Usually there
+      // are several vendor sub-options defined within. See the ARM section:
+      // https://kea.readthedocs.io/en/latest/arm/dhcp6-srv.html#dhcpv6-vendor-specific-options
+
+      {
+        "code": 17,
+        "data": "4294967295",
+        "name": "vendor-opts"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     OPTION_RECONF_ACCEPT      |               0               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code   OPTION_RECONF_ACCEPT (20).
+
+      option-len    0.
+      */
+      // Type: empty
+      {
+        "code": 20,
+        "name": "reconf-accept"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_SIP_SERVER_D      |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                 SIP Server Domain Name List                   |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      SIP Server Domain Name List: The domain names of the SIP outbound
+      proxy servers for the client to use.  The domain names are encoded
+      as specified in Section 8 ("Representation and use of domain
+      names") of the DHCPv6 specification [1].
+      */
+      // Type: array of {FQDN}
+      {
+        "code": 21,
+        "data": "sip1.server.net, sip2.server.net",
+        "name": "sip-server-dns"
+      },
+
+      /*
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_SIP_SERVER_A      |           option-len          |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                   SIP server (IP address)                     |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                   SIP server (IP address)                     |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_SIP_SERVER_A (22)
+
+      option-length: Length of the 'options' field in octets; must be a
+      multiple of 16.
+
+      SIP server: IPv6 address of a SIP server for the client to use.
+                  The servers are listed in the order of preference for
+                  use by the client.
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 22,
+        "data": "2001:db8::3, 2001:db8::4",
+        "name": "sip-server-addr"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_DNS_SERVERS       |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |            DNS-recursive-name-server (IPv6 address)           |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |            DNS-recursive-name-server (IPv6 address)           |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:               OPTION_DNS_SERVERS (23)
+
+      option-len:                Length of the list of DNS recursive name
+                                 servers in octets; must be a multiple of
+                                 16
+
+      DNS-recursive-name-server: IPv6 address of DNS recursive name server
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 23,
+        "data": "2001:db8::5, 2001:db8::6",
+        "name": "dns-servers"
+      },
+
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_DOMAIN_LIST       |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                          searchlist                           |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:  OPTION_DOMAIN_LIST (24)
+
+      option-len:   Length of the 'searchlist' field in octets
+
+      searchlist:   The specification of the list of domain names in the
+                    Domain Search List
+      */
+      // Type: array of {FQDN}
+      {
+        "code": 24,
+        "data": "example.com, example.org",
+        "name": "domain-search"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_NIS_SERVERS       |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                   NIS server (IPv6 address)                   |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                   NIS server (IPv6 address)                   |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:  OPTION_NIS_SERVERS (27)
+
+      option-len:   Length of the 'NIS server' fields in octets; It must be
+                    a multiple of 16
+
+      NIS server:   IPv6 address of NIS server
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 27,
+        "data": "2001:db8::7, 2001:db8::8",
+        "name": "nis-servers"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_NISP_SERVERS      |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                   NIS+ server (IPv6 address)                  |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                   NIS+ server (IPv6 address)                  |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_NISP_SERVERS (28)
+
+      option-len:  Length of the 'NIS+ server' fields in octets; It must be
+                   a multiple of 16
+
+      NIS+ server: IPv6 address of NIS+ server
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 28,
+        "data": "2001:db8::9, 2001:db8::10",
+        "name": "nisp-servers"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |    OPTION_NIS_DOMAIN_NAME     |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                       nis-domain-name                         |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:      OPTION_NIS_DOMAIN_NAME (29)
+
+      option-len:       Length of the 'nis-domain-name' field in octets
+
+      nis-domain-name:  NIS Domain name for client
+      */
+      // Type: array of {FQDN}
+      {
+        "code": 29,
+        "data": "nis1.example.org, nis2.example.org",
+        "name": "nis-domain-name"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |    OPTION_NISP_DOMAIN_NAME    |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                       nisp-domain-name                        |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:      OPTION_NISP_DOMAIN_NAME (30)
+
+      option-len:       Length of the 'nisp-domain-name' field in octets
+
+      nisp-domain-name: NIS+ Domain name for client
+      */
+      // Type: array of {FQDN}
+      {
+        "code": 30,
+        "data": "nisp1.example.org, nisp2.example.org",
+        "name": "nisp-domain-name"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_SNTP_SERVERS       |        option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                  SNTP server (IPv6 address)                   |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                  SNTP server (IPv6 address)                   |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_SNTP_SERVERS (31)
+
+      option-len:  Length of the 'SNTP server' fields, in octets;
+                   it must be a multiple of 16
+
+      SNTP server: IPv6 address of SNTP server
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 31,
+        "data": "2001:db8::11, 2001:db8::12",
+        "name": "sntp-servers"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |OPTION_INFORMATION_REFRESH_TIME|         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                   information-refresh-time                    |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code                OPTION_INFORMATION_REFRESH_TIME (32).
+
+      option-len                 4.
+
+      information-refresh-time   Time duration relative to the current
+                                 time, expressed in units of seconds.  A
+                                 4-octet field containing an unsigned
+                                 integer.
+      */
+      // Type: uint32
+      {
+        "code": 32,
+        "data": "3600",
+        "name": "information-refresh-time"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_BCMCS_SERVER_D    |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |          BCMCS Control Server Domain Name List                |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_BCMCS_SERVER_D (33).
+
+      option-length: Length of the 'BCMCS Control Server Domain Name List'
+      field in octets; variable.
+
+      BCMCS Control Server Domain Name List: Identical format as in Section
+      4.1 (except the Code and Len fields).
+      */
+      // Type: array of {FQDN}
+      {
+        "code": 33,
+        "data": "bcmcs1.example.org, bcmcs2.example.org",
+        "name": "bcmcs-server-dns"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_BCMCS_SERVER_A    |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |    BCMCS Control server-1 address (IPv6 address)              |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |    BCMCS Control server-2 address (IPv6 address)              |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_BCMCS_SERVER_A (34).
+
+      option-length: Length of the 'BCMCS Control Server IPv6 address'
+      field in octets; variable.
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 34,
+        "data": "2001:db8::13, 2001:db8::14",
+        "name": "bcmcs-server-addr"
+      },
+
+      // Option code 35 is unassigned.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_GEOCONF_CIVIC     |           option-len          |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      what     |        country code           |               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+               .
+      .                     civic address elements                    .
+      .                              ...                              .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:  OPTION_GEOCONF_CIVIC (36)
+
+      option-len:  Length of the Countrycode, 'what' and civic address
+         elements in octets.
+
+      what:  The 'what' element describes to which location the DHCP entry
+         refers.  Currently, three options are defined: the location of the
+         DHCP server (a value of 0), the location of the network element
+         believed to be closest to the client (a value of 1), or the
+         location of the client (a value of 2).  Option (2) SHOULD be used,
+         but may not be known.  Options (0) and (1) SHOULD NOT be used
+         unless it is known that the DHCP client is in close physical
+         proximity to the server or network element.
+
+      country code:  The two-letter ISO 3166 country code in capital ASCII
+         letters, e.g., DE or US.  (Civic addresses always contain country
+         designations, suggesting the use of a fixed-format field to save
+         space.)
+
+      civic address elements:  Zero or more elements comprising the civic
+         and/or postal address, with the format described below
+         (Section 3.3).
+      */
+      // Type: uint8, uint16, array of {binary}
+      {
+        "code": 36,
+        // 0x5553 is "US" in UTF-8
+        "data": "0, 0x5553, 15 9D, A3 FF",
+        "name": "geoconf-civic"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPTION_REMOTE_ID        |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                       enterprise-number                       |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                                                               .
+      .                           remote-id                           .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code        OPTION_REMOTE_ID (37)
+
+      option-len         4 + the length, in octets, of the remote-id
+                         field.  The minimum option-len is 5 octets.
+
+      enterprise-number  The vendor's registered Enterprise Number as
+                         registered with IANA [5].
+
+      remote-id          The opaque value for the remote-id.
+      */
+      // Type: uint32, binary
+      {
+        "code": 37,
+        "data": "4294967295, 1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE",
+        "name": "remote-id"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |          OPTION_FQDN          |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |   flags       |                                               |
+      +-+-+-+-+-+-+-+-+                                               |
+      .                                                               .
+      .                          domain-name                          .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code      OPTION_CLIENT_FQDN (39)
+
+      option-len       1 + length of domain name
+
+      flags            flag bits used between client and server to
+                       negotiate who performs which updates
+
+      domain-name      the partial or fully qualified domain name
+                       (with length option-len - 1)
+      */
+      // Type: uint8, FQDN
+      {
+        "code": 39,
+        "data": "224, client.example.org",
+        "name": "client-fqdn"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       option-code             |       option-length           |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      +                                                               +
+      |                                                               |
+      +                         PAA IPv6 Address                      +
+      |                                                               |
+      +                                                               +
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                          ....                                 |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:        OPTION_PANA_AGENT (40).
+
+      option-length:      Length of the 'options' field in octets;
+                          MUST be a multiple of sixteen (16).
+
+      PAA IPv6 Address:   IPv6 address of a PAA for the client to use.
+                          The PAAs are listed in the order of preference
+                          for use by the client.
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 40,
+        "data": "2001:db8::15, 2001:db8::16",
+        "name": "pana-agent"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |  OPTION_NEW_POSIX_TIMEZONE    |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                      TZ POSIX String                          |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_NEW_POSIX_TIMEZONE(41)
+
+      option-length: the number of octets of the TZ POSIX String Index
+      described below.
+      */
+      // Type: string
+      {
+        "code": 41,
+        // String options that have a comma in their values need to have
+        // it escaped (i.e. each comma is preceded by two backslashes).
+        // That's because commas are reserved for separating fields in
+        // compound options. At the same time, we need to be conformant
+        // with JSON spec, that does not allow "\,". Therefore the
+        // slightly uncommon double backslashes notation is needed.
+        // The value sent over the wire is:
+        // EST5EDT4,M3.2.0/02:00,M11.1.0/02:00
+        "data": "EST5EDT4\\,M3.2.0/02:00\\,M11.1.0/02:00",
+        "name": "new-posix-timezone"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |  OPTION_NEW_TZDB_TIMEZONE    |          option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                          TZ Name                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_NEW_TZDB_TIMEZONE(42)
+
+      option-length: the number of octets of the TZ Database String Index
+      described below.
+      */
+      // Type: string
+      {
+        "code": 42,
+        "data": "Europe/Zurich",
+        "name": "new-tzdb-timezone"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |           OPTION_ERO          |           option-len          |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |    requested-option-code-1    |    requested-option-code-2    |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code              OPTION_ERO (43).
+      option-len               2 * number of requested options.
+      requested-option-code-n  The option code for an option requested by
+                               the relay agent.
+      */
+      // Type: array of {uint16}
+      {
+        "code": 43,
+        "data": "16, 32, 42",
+        "name": "ero"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |        OPTION_LQ_QUERY        |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |   query-type  |                                               |
+      +-+-+-+-+-+-+-+-+                                               |
+      |                                                               |
+      |                         link-address                          |
+      |                                                               |
+      |               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |               |                                               .
+      +-+-+-+-+-+-+-+-+                                               .
+      .                         query-options                         .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code      OPTION_LQ_QUERY (44)
+
+      option-len       17 + length of query-options field.
+
+      link-address     A global address that will be used by the
+                       server to identify the link to which the
+                       query applies, or 0::0 if unspecified.
+
+      query-type       The query requested (see below).
+
+      query-options    The options related to the query.
+      */
+      // Note: special logic not implemented
+      // Type: uint8, IPv6 address
+      {
+        "code": 44,
+        "data": "1, 2001:db8::17",
+        "name": "lq-query"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPTION_CLIENT_DATA      |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                                                               .
+      .                        client-options                         .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code      OPTION_CLIENT_DATA (45)
+
+      option-len       Length, in octets, of the encapsulated client-
+                       options field.
+
+      client-options   The options associated with this client.
+      */
+      // Note: special logic not implemented
+      // Type: empty
+      {
+        "code": 45,
+        "name": "client-data"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |        OPTION_CLT_TIME        |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                 client-last-transaction-time                  |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code      OPTION_CLT_TIME (46)
+
+      option-len       4
+
+      client-last-transaction-time
+                       The number of seconds since the server last
+                       communicated with the client (on that link).
+      */
+      // Note: special logic not implemented
+      // Type: uint32
+      {
+        "code": 46,
+        "data": "600",
+        "name": "clt-time"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     OPTION_LQ_RELAY_DATA      |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                  peer-address (IPv6 address)                  |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                       DHCP-relay-message                      |
+      .                                                               .
+      .                                                               .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code      OPTION_LQ_RELAY_DATA (47)
+
+      option-len       16 + length of DHCP-relay-message.
+
+      peer-address     The address of the relay agent from which
+                       the relayed message was received by the
+                       server.
+
+      DHCP-relay-message
+                       The last complete relayed message, excluding
+                       the client's message OPTION_RELAY_MSG,
+                       received by the server.
+      */
+      // Note: special logic not implemented
+      // Type: IPv6 address, binary
+      {
+        "code": 47,
+        "data": "2001:db8::18, 1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE",
+        "name": "lq-relay-data"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     OPTION_LQ_CLIENT_LINK     |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                  link-address (IPv6 address)                  |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                  link-address (IPv6 address)                  |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code      OPTION_LQ_CLIENT_LINK (48)
+
+      option-len       Length of the list of links in octets;
+                       must be a multiple of 16.
+
+      link-address     A global address used by the server to
+                       identify the link on which the client is
+                       located.
+      */
+      // Note: special logic not implemented
+      // Type: array of {IPv6 address}
+      {
+        "code": 48,
+        "data": "2001:db8::19, 2001:db8::20",
+        "name": "lq-client-link"
+      },
+
+      // Option codes 49-50 are not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_V6_LOST           |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                LoST Server Domain Name                        |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_V6_LOST (51)
+
+      option-length: Length of the 'LoST Server Domain Name' field
+           in octets; variable.
+
+      LoST Server Domain Name: The domain name of the LoST
+           server for the client to use.
+      */
+      // Type: FQDN
+      {
+        "code": 51,
+        "data": "lost.example.org",
+        "name": "v6-lost"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       option-code             |       option-length           |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      +                                                               +
+      |                                                               |
+      +                          AC IPv6 Address                      +
+      |                                                               |
+      +                                                               +
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                          ....                                 |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:   OPTION_CAPWAP_AC_V6 (52)
+
+      option-length:   Length of the 'options' field in octets; MUST be a
+         multiple of sixteen (16).
+
+      AC IPv6 Address:  IPv6 address of a CAPWAP AC that the WTP may use.
+         The ACs are listed in the order of preference for use by the WTP.
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 52,
+        "data": "2001:db8::21, 2001:db8::22",
+        "name": "capwap-ac-v6"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPTION_RELAY_ID         |          option-len           |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                                                               .
+      .                              DUID                             .
+      .                        (variable length)                      .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code   OPTION_RELAY_ID.
+
+      option-len    Length of DUID in octets.
+
+      DUID          The DUID for the relay agent.
+      */
+      // Type: binary
+      {
+        "code": 53,
+        "data": "1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE",
+        "name": "relay-id"
+      },
+
+      // Option codes 54-56 are not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |    OPTION_V6_ACCESS_DOMAIN    |           Length              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                  Access Network Domain Name                   .
+      .                              ...                              .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:  OPTION_V6_ACCESS_DOMAIN (57).
+
+      option-length:  The length of the entire access network domain name
+         option in octets.
+
+      option-value:  The domain name associated with the access network,
+         encoded as described in Section 3.1.
+      */
+      // Type: FQDN
+      {
+        "code": 57,
+        "data": "v6-access.example.org",
+        "name": "v6-access-domain"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     OPTION_SIP_UA_CS_LIST     |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                          searchlist                           |
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code OPTION_SIP_UA_CS_LIST (58)
+
+      option-len  Length of the 'searchlist' field in octets
+
+      searchlist  The specification of the list of domain names in the SIP
+                  User Agent Configuration Service Domains
+      */
+      // Type: array of {FQDN}
+      {
+        "code": 58,
+        "data": "sip-ua1.example.org, sip-ua1.example.org",
+        "name": "sip-ua-cs-list"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPT_BOOTFILE_URL        |            option-len         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      .                  boot-file-url (variable length)              .
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code       OPT_BOOTFILE_URL (59).
+
+      option-len        Length of the boot-file-url in octets.
+
+      boot-file-url     This string is the URL for the boot file.  It MUST
+                        comply with STD 66 [RFC3986].  The string is not
+                        NUL-terminated.
+      */
+      // Type: string
+      {
+        "code": 59,
+        "data": "https://boot.example.org/pxe/os.img",
+        "name": "bootfile-url"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPT_BOOTFILE_PARAM      |            option-len         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      | param-len 1                   |                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+           parameter 1         .
+      .                                        (variable length)      |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                                                               .
+      .                       <multiple Parameters>                   .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      | param-len n                   |                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+           parameter n         .
+      .                                        (variable length)      |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code       OPT_BOOTFILE_PARAM (60).
+
+      option-len        Length of the Boot File Parameters option in octets
+                        (not including the size of the option-code and
+                        option-len fields).
+
+      param-len 1...n   This is a 16-bit integer that specifies the length
+                        of the following parameter in octets (not including
+                        the parameter-length field).
+
+      parameter 1...n   These UTF-8 strings are parameters needed for
+                        booting, e.g., kernel parameters.  The strings are
+                        not NUL-terminated.
+      */
+      // Type: array of {tuple}
+      {
+        "code": 60,
+        "data": "root=/dev/sda2, quiet, splash",
+        "name": "bootfile-param"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |    OPTION_CLIENT_ARCH_TYPE    |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                                                               .
+      .             architecture-types (variable length)              .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code         OPTION_CLIENT_ARCH_TYPE (61).
+
+      option-len          Length of the "architecture-types" field in
+                          octets.  It MUST be an even number greater than
+                          zero.  See Section 2.1 of [RFC4578] for details.
+
+      architecture-types  A list of one or more architecture types, as
+                          specified in Section 2.1 of [RFC4578].  Each
+                          architecture type identifier in this list is a
+                          16-bit value that describes the pre-boot runtime
+                          environment of the client machine.  A list of
+                          valid values is maintained by the IANA (see
+                          Section 6).
+      */
+      // Type: array of {uint16}
+      {
+        "code": 61,
+        "data": "1, 3, 5, 7",
+        "name": "client-arch-type"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |           OPTION_NII          |          option-len           |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     Type      |     Major     |      Minor      |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code       OPTION_NII (62).
+
+      option-len        3
+
+      Type              As specified in Section 2.2 of [RFC4578].
+
+      Major             As specified in Section 2.2 of [RFC4578].
+
+      Minor             As specified in Section 2.2 of [RFC4578].
+      */
+      // Type: uint8, uint8, array of {uint8}
+      {
+        "code": 62,
+        "data": "1, 2, 11, 13",
+        "name": "nii"
+      },
+
+      // Option code 63 is not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-------------------------------+-------------------------------+
+      |    OPTION_AFTR_NAME: 64       |          option-len           |
+      +-------------------------------+-------------------------------+
+      |                                                               |
+      |                  tunnel-endpoint-name (FQDN)                  |
+      |                                                               |
+      +---------------------------------------------------------------+
+
+      option-len: Length of the tunnel-endpoint-name field in
+                  octets.
+
+      tunnel-endpoint-name: A fully qualified domain name of the AFTR
+                            tunnel endpoint
+      */
+      // Type: FQDN
+      {
+        "code": 64,
+        "data": "aftr.example.org",
+        "name": "aftr-name"
+      },
+
+      /*
+      0                   1                   2                   3
+      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      | OPTION_ERP_LOCAL_DOMAIN_NAME|         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      | erp-local-domain-name...
+      +-+-+-+-+-+-+-+-+-+-+-+-+-
+
+      option code
+         OPTION_ERP_LOCAL_DOMAIN_NAME (65)
+
+      option-length
+         Length of the erp-local-domain-name field, in octets
+
+      erp-local-domain-name
+         This field contains the name of the local ERP domain and MUST be
+         encoded as specified in Section 8 of RFC 3315 [RFC3315].  Note
+         that this encoding does enable the use of internationalized domain
+         names, but only as a set of A-labels [RFC5890].
+      */
+      // Type: FQDN
+      {
+        "code": 65,
+        "data": "erp-local.example.org",
+        "name": "erp-local-domain-name"
+      },
+
+      /*
+      0                   1                   2                   3
+      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |         OPTION_RSOO         |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |         options...
+      +-+-+-+-+-+-+-+-+-+-+-+
+
+      OPTION_RSOO
+
+         Relay-Supplied Options code (66).
+
+      option-length
+
+         Length of the RSOO.
+
+      options
+
+         One or more DHCPv6 options.
+      */
+      // Type: empty
+      {
+        "code": 66,
+        "name": "rsoo"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPTION_PD_EXCLUDE       |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |  prefix-len   | IPv6 subnet ID (1 to 16 octets)               ~
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+                              Prefix Exclude Option
+
+      o  option-code: OPTION_PD_EXCLUDE (67).
+
+      o  option-len: 1 + length of IPv6 subnet ID in octets.  A valid
+         option-len is between 2 and 17.
+
+      o  prefix-len: The length of the excluded prefix in bits.  The
+         prefix-len MUST be between 'OPTION_IAPREFIX prefix-length'+1 and
+         128.
+
+      o  IPv6 subnet ID: A variable-length IPv6 subnet ID up to 128 bits.
+      */
+      // Type: binary
+      {
+        "code": 67,
+        "data": "2001:db8:1:1::/64",
+        "name": "pd-exclude"
+      },
+
+      // Option codes 68-73 are not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |    OPTION_RDNSS_SELECTION     |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |            DNS-recursive-name-server (IPv6 address)           |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      | Reserved  |prf|                                               |
+      +-+-+-+-+-+-+-+-+          Domains and networks                 |
+      |                          (variable length)                    |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:  OPTION_RDNSS_SELECTION (74)
+
+      option-len:  Length of the option in octets
+
+      DNS-recursive-name-server:  An IPv6 address of RDNSS
+
+      Reserved:  Field reserved for the future.  MUST be set to zero and
+                 MUST be ignored on receipt.
+
+      prf:  RDNSS preference:
+
+            01 High
+            00 Medium
+            11 Low
+            10 Reserved
+
+            Reserved preference value (10) MUST NOT be sent.  On receipt,
+            the Reserved value MUST be treated as Medium preference (00).
+      */
+      // Type: IPv6 address, uint8, array of {FQDN}
+      {
+        "code": 74,
+        "data": "2001:db8::23, 01, example.com, example.org",
+        "name": "rdnss-selection"
+      },
+
+      // Option codes 75-78 are not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      | OPTION_CLIENT_LINKLAYER_ADDR  |           option-length       |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |   link-layer type (16 bits)   |                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               |
+      |               link-layer address (variable length)            |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:        OPTION_CLIENT_LINKLAYER_ADDR (79)
+      option-length:      2 + length of link-layer address
+      link-layer type:    Client link-layer address type.  The link-layer
+                          type MUST be a valid hardware type assigned
+                          by the IANA, as described in [RFC0826]
+      link-layer address: Client link-layer address
+      */
+      // Type: binary
+      {
+        "code": 79,
+        "data": "1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE",
+        "name": "client-linklayer-addr"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |       OPTION_LINK_ADDRESS     |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      |                  link-address (IPv6 address)                  |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code: OPTION_LINK_ADDRESS (80)
+
+      option-len: 16 (octets)
+
+      link-address: An IPv6 address used by the server to identify the
+      link on which the client is located.
+      */
+      // Type: IPv6 address
+      {
+        "code": 80,
+        "data": "2001:db8::24",
+        "name": "link-address"
+      },
+
+      // Option code 81 is not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_SOL_MAX_RT        |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                       SOL_MAX_RT value                        |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code          OPTION_SOL_MAX_RT (82).
+
+      option-len           4.
+
+      SOL_MAX_RT value     Overriding value for SOL_MAX_RT in seconds;
+                           MUST be in this range: 60 <= "value" <= 86400
+                           (1 day).  A 4-octet field containing an
+                           unsigned integer.
+      */
+      // Type: uint32
+      {
+        "code": 82,
+        "data": "420",
+        "name": "solmax-rt"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_INF_MAX_RT        |         option-len            |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                       INF_MAX_RT value                        |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+                    Figure 39: INF_MAX_RT Option Format
+
+      option-code          OPTION_INF_MAX_RT (83).
+
+      option-len           4.
+
+      INF_MAX_RT value     Overriding value for INF_MAX_RT in seconds;
+                           MUST be in this range: 60 <= "value" <= 86400
+                           (1 day).  A 4-octet field containing an
+                           unsigned integer.
+      */
+      // Type: uint32
+      {
+        "code": 83,
+        "data": "2220",
+        "name": "inf-max-rt"
+      },
+
+      // Option codes 84-86 are not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |           option-code         |           option-len          |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      .                        IPv6 Address(es)                       .
+      .                                                               .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      option-code:  OPTION_DHCP4_O_DHCP6_SERVER (88).
+
+      option-len:  Length of the IPv6 address(es) carried by the option,
+         i.e., multiple of 16 octets.  Minimal length of this option is 0.
+
+      IPv6 Address:  Zero or more IPv6 addresses of the DHCP 4o6 server(s).
+      */
+      // Type: array of {IPv6 address}
+      {
+        "code": 88,
+        "data": "2001:db8::25, 2001:db8::26",
+        "name": "dhcp4o6-server-addr"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |        OPTION_S46_RULE        |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     flags     |     ea-len    |  prefix4-len  | ipv4-prefix   |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                  (continued)                  |  prefix6-len  |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                           ipv6-prefix                         |
+      |                       (variable length)                       |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      .                        S46_RULE-options                       .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      o  option-code: OPTION_S46_RULE (89)
+
+      o  option-length: length of the option, excluding option-code and
+         option-length fields, including length of all encapsulated
+         options; expressed in octets.
+
+      o  flags: 8 bits long; carries flags applicable to the rule.  The
+         meanings of the specific bits are explained in Figure 2.
+
+      o  ea-len: 8 bits long; specifies the Embedded Address (EA) bit
+         length.  Allowed values range from 0 to 48.
+
+      o  prefix4-len: 8 bits long; expresses the prefix length of the
+         Rule IPv4 prefix specified in the ipv4-prefix field.  Allowed
+         values range from 0 to 32.
+
+      o  ipv4-prefix: a fixed-length 32-bit field that specifies the IPv4
+         prefix for the S46 rule.  The bits in the prefix after prefix4-len
+         number of bits are reserved and MUST be initialized to zero by the
+         sender and ignored by the receiver.
+
+      o  prefix6-len: 8 bits long; expresses the length of the
+         Rule IPv6 prefix specified in the ipv6-prefix field.  Allowed
+         values range from 0 to 128.
+
+      o  ipv6-prefix: a variable-length field that specifies the IPv6
+         domain prefix for the S46 rule.  The field is padded on the right
+         with zero bits up to the nearest octet boundary when prefix6-len
+         is not evenly divisible by 8.
+
+      o  S46_RULE-options: a variable-length field that may contain zero or
+         more options that specify additional parameters for this S46 rule.
+         This document specifies one such option: OPTION_S46_PORTPARAMS.
+      */
+      // Type: uint8, uint8, IPv4 address, IPv6 prefix
+      {
+        "code": 89,
+        "data": "1, 0, 24, 192.0.2.0, 2001:db8:1::/64",
+        "name": "s46-rule",
+        "space": "s46-cont-mape-options"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |         OPTION_S46_BR         |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                      br-ipv6-address                          |
+      |                                                               |
+      |                                                               |
+      |                                                               |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      o  option-code: OPTION_S46_BR (90)
+
+      o  option-length: 16
+
+      o  br-ipv6-address: a fixed-length field of 16 octets that specifies
+         the IPv6 address for the S46 BR.
+      */
+      // Type: IPv6 address
+      {
+        "code": 90,
+        "data": "2001:db8::27",
+        "name": "s46-br",
+        "space": "s46-cont-mape-options"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |        OPTION_S46_DMR         |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |dmr-prefix6-len|            dmr-ipv6-prefix                    |
+      +-+-+-+-+-+-+-+-+           (variable length)                   |
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      o  option-code: OPTION_S46_DMR (91)
+
+      o  option-length: 1 + length of dmr-ipv6-prefix specified in octets.
+
+      o  dmr-prefix6-len: 8 bits long; expresses the bitmask length of the
+         IPv6 prefix specified in the dmr-ipv6-prefix field.  Allowed
+         values range from 0 to 128.
+
+      o  dmr-ipv6-prefix: a variable-length field specifying the IPv6
+         prefix or address for the BR.  This field is right-padded with
+         zeros to the nearest octet boundary when dmr-prefix6-len is not
+         divisible by 8.
+      */
+      // Type: IPv6 prefix
+      {
+        "code": 91,
+        "data": "2001:db8:cafe::/64",
+        "name": "s46-dmr",
+        "space": "s46-cont-mapt-options"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_S46_V4V6BIND      |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                         ipv4-address                          |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |bindprefix6-len|             bind-ipv6-prefix                  |
+      +-+-+-+-+-+-+-+-+             (variable length)                 |
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      .                      S46_V4V6BIND-options                     .
+      .                                                               .
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      o  option-code: OPTION_S46_V4V6BIND (92)
+
+      o  option-length: length of the option, excluding option-code and
+         option-length fields, including length of all encapsulated
+         options; expressed in octets.
+
+      o  ipv4-address: a fixed-length field of 4 octets specifying an IPv4
+         address.
+
+      o  bindprefix6-len: 8 bits long; expresses the bitmask length of the
+         IPv6 prefix specified in the bind-ipv6-prefix field.  Allowed
+         values range from 0 to 128.
+
+      o  bind-ipv6-prefix: a variable-length field specifying the IPv6
+         prefix or address for the S46 CE.  This field is right-padded with
+         zeros to the nearest octet boundary when bindprefix6-len is not
+         divisible by 8.
+
+      o  S46_V4V6BIND-options: a variable-length field that may contain
+         zero or more options that specify additional parameters.  This
+         document specifies one such option: OPTION_S46_PORTPARAMS.
+      */
+      // Type: IPv4 address, IPv6 prefix
+      {
+        "code": 92,
+        "data": "192.0.2.78, 2001:db8:1:cafe::/64",
+        "name": "s46-v4v6bind",
+        "space": "s46-cont-lw-options"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     OPTION_S46_PORTPARAMS     |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |   offset      |    PSID-len   |              PSID             |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      o  option-code: OPTION_S46_PORTPARAMS (93)
+
+      o  option-length: 4
+
+      o  offset: Port Set Identifier (PSID) offset.  8 bits long; specifies
+         the numeric value for the S46 algorithm's excluded port range/
+         offset bits (a-bits), as per Section 5.1 of [RFC7597].  Allowed
+         values are between 0 and 15.  Default values for this field are
+         specific to the softwire mechanism being implemented and are
+         defined in the relevant specification document.
+
+      o  PSID-len: 8 bits long; specifies the number of significant bits in
+         the PSID field (also known as 'k').  When set to 0, the PSID field
+         is to be ignored.  After the first 'a' bits, there are k bits in
+         the port number representing the value of the PSID.  Consequently,
+         the address-sharing ratio would be 2^k.
+
+      o  PSID: 16 bits long.  The PSID value algorithmically identifies a
+         set of ports assigned to a CE.  The first k bits on the left of
+         this field contain the PSID binary value.  The remaining (16 - k)
+         bits on the right are padding zeros.
+      */
+      // Type: uint8, PSID
+      {
+        "code": 93,
+        "data": "2, 3/4",
+        "name": "s46-portparams",
+        "space": "s46-rule-options"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |        OPTION_S46_CONT_MAPE   |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      .            encapsulated-options (variable length)             .
+      .                                                               .
+      +---------------------------------------------------------------+
+
+      o  option-code: OPTION_S46_CONT_MAPE (94)
+
+      o  option-length: length of encapsulated options, expressed in
+         octets.
+
+      o  encapsulated-options: options associated with this Softwire46
+         MAP-E domain.
+      */
+      // Type: empty
+      {
+        "code": 94,
+        "name": "s46-cont-mape",
+        "space": "dhcp6"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |     OPTION_S46_CONT_MAPT      |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      .            encapsulated-options (variable length)             .
+      .                                                               .
+      +---------------------------------------------------------------+
+
+      o  option-code: OPTION_S46_CONT_MAPT (95)
+
+      o  option-length: length of encapsulated options, expressed in
+         octets.
+
+      o  encapsulated-options: options associated with this Softwire46
+         MAP-T domain.
+      */
+      // Type: empty
+      {
+        "code": 95,
+        "name": "s46-cont-mapt",
+        "space": "dhcp6"
+      },
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      OPTION_S46_CONT_LW       |         option-length         |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                                                               |
+      +            encapsulated-options (variable length)             .
+      .                                                               .
+      +---------------------------------------------------------------+
+
+      o  option-code: OPTION_S46_CONT_LW (96)
+
+      o  option-length: length of encapsulated options, expressed in
+         octets.
+
+      o  encapsulated-options: options associated with this Softwire46
+         Lightweight 4over6 domain.
+      */
+      // Type: empty
+      {
+        "code": 96,
+        "name": "s46-cont-lw",
+        "space": "dhcp6"
+      },
+
+      // Option codes 97-102 are not defined in Kea.
+
+      /*
+       0                   1                   2                   3
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |          option-code          |          option-len           |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      .                      URI (variable length)                    .
+      |                              ...                              |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+      o  option-code: The Captive-Portal DHCPv6 option (103) (two octets).
+
+      o  option-len: The length, in octets of the URI.
+
+      o  URI: The contact URI for the captive portal that the user should
+         connect to (encoded following the rules in [RFC3986]).
+      */
+      // Type: string
+      {
+        "code": 103,
+        "data": "https://example.org/captive-portal",
+        "name": "v6-captive-portal"
+      },
+
+      // Option codes 104-111 are not defined in Kea.
+      // Option code 112 is unassigned.
+      // Option codes 113-134 are not defined in Kea.
+
+      // Option codes 136-142 are unassigned.
+
+      /*
+       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |      Option Code              |         Length                |
+      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+      |                         IP Address                            |
+      .                                                               .
+      +---------------------------------------------------------------+
+
+      Option Code
+         OPTION-IPv6_Address-ANDSF (143)
+
+      Length
+         Length (in bytes) of the option excluding the 'Option Code' and
+         the 'Length' fields; 'Length' field is set to 16N, where N is the
+         number of IPv6 addresses carried in the option
+
+      IP Address
+         IPv6 address(es) of ANDSF server(s)
+      */
+      // Type: IPv6 address
+      {
+        "code": 143,
+        "data": "2001:db8::28",
+        "name": "ipv6-address-andsf"
+      },
+
+      // Option codes 144-65535 are unassigned.
+
+      /*                         Custom option data                           */
+      // See "option-def" below for the definitions.
+      {
+        "code": 111,
+        "data": "88, 96, 64",
+        "name": "s46-priority"
+      },
+      {
+        "code": 1,
+        "name": "my-empty-option",
+        "space": "my-fancy-space"
+      },
+      {
+        "code": 222,
+        "data": "2001:db8::29, 2001:db8::/64, 3/4, 1, example.org, string",
+        "name": "my-lengthy-option",
+        "space": "my-fancy-space"
+      },
+      {
+        "code": 65432,
+        "data": "127, 32767, 2147483647, 255, 65535, 4294967295, 192.0.2.79, 2001:db8::30, 2001:db8::/64, 3/4, 1, example.org, string",
+        "name": "my-fancy-option",
+        "space": "my-fancy-space"
+      },
+      {
+        "code": 12321,
+        "name": "my-encapsulating-option",
+        "space": "my-encapsulating-space"
+      }
+    ],
+
+    /*                       Custom option definitions                        */
+    // For kea-dhcp6, custom option definitions are always global. Even when
+    // data for said options is then configured at subnet level.
+    "option-def": [
+      // Inside the default space. Codes need to not overlap with other
+      // standard/custom option definitions.
+      // An option from an actual RFC (8026) not implemented amongst the
+      // standard definitions. The option is structured as an array of 16-bit
+      // integers so "array" is set to true and "type" to "uint16".
+      {
+        "array": true,
+        "code": 111,
+        "encapsulate": "",
+        "name": "s46-priority",
+        "record-types": "",
+        "space": "dhcp6",
+        "type": "uint16"
+      },
+
+      // New option space allows for a new set of option codes.
+      // An empty option requires no "data" in "option-data". It's
+      // presence should be sufficient to trigger custom behavior.
+      {
+        "array": false,
+        "code": 1,
+        "encapsulate": "",
+        "name": "my-empty-option",
+        "record-types": "",
+        "space": "my-fancy-space",
+        "type": "empty"
+      },
+
+      // A custom type has "type" set to "record" and all data types (which need
+      // to be more than 1, otherwise you're better off using the type directly)
+      // are specified in "record-types". If "string" is part of them, it needs
+      // to be last.
+      {
+        "array": false,
+        "code": 222,
+        "encapsulate": "",
+        "name": "my-lengthy-option",
+        "record-types": "ipv6-address, ipv6-prefix, psid, tuple, fqdn, string",
+        "space": "my-fancy-space",
+        "type": "record"
+      },
+
+      // Contains arrays of all types except strings since an array of strings
+      // is not a valid option definition.
+      {
+        "array": true,
+        "code": 65432,
+        "encapsulate": "",
+        "name": "my-fancy-option",
+        "record-types": "int8, int16, int32, uint8, uint16, uint32, ipv4-address, ipv6-address, ipv6-prefix, psid, tuple, fqdn",
+        "space": "my-fancy-space",
+        "type": "record"
+      },
+
+      // A single encapsulating space can be used. An option containing any
+      // option from said space will now be unpacked successfully by Kea.
+      {
+        "array": false,
+        "code": 12321,
+        "encapsulate": "my-fancy-space",
+        "name": "my-encapsulating-option",
+        "record-types": "",
+        "space": "my-encapsulating-space",
+        "type": "empty"
+      }
+    ],
+
+    "subnet6": [
+      /*                         DOCSIS3 option data                          */
+      // Headers are as defined in CL-SP-CANN-DHCP-Reg-I16-200715.
+      // "space" is required to be explicitly defined as "docsis3-v6"
+      {
+        "option-data": [
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                          device-type                          |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                              ...                              |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option-code   CL_OPTION_DEVICE_TYPE (2)
+
+          option-len    length of device-type field in bytes.
+
+          device-type   The device type as NVT ASCII text MUST NOT be null terminated.
+             "ECM" for embedded Cable Modem (as specified by DOCSIS 1.0, 1.1, 2.0, 3.0
+             or 3.1 Base Specifications)
+             "EPS" for CableHome embedded Portal Services Element
+             "EMTA" for PacketCable embedded Multimedia Terminal Adapter
+             "EDVA" for PacketCable embedded Digital Voice Adapter
+             "ESTB" for an embedded Set-Top Box
+             "EROUTER" for an embedded DOCSIS Router
+             "SROUTER" for a Standalone Router
+          */
+          // Type: string
+          {
+            "code": 2,
+            "data": "ECM",
+            "name": "device-type",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               .
+          .                          vendor-name                          .
+          .                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:         CL_OPTION_VENDOR_NAME(10)
+
+          option length:       n (for string of length n)
+
+          vendor-name:         The vendor name string NVT ASCII text MUST NOT be
+                               null terminated.
+          */
+          // Type: string
+          {
+            "code": 10,
+            "data": "CableLabs",
+            "name": "vendor-type",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               |
+          |                         TFTP-server-1                         |
+          |                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               |
+          |                         TFTP-server-2                         |
+          |                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          .                                                               .
+          .                                                               .
+          .                                                               .
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               |
+          |                         TFTP-server-n                         |
+          |                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:         CL_OPTION_TFTP_SERVERS(32)
+
+          option length:       16*n (for n servers in the option) in bytes
+
+          TFTP-server:         The IPv6 address of a TFTP server
+          */
+          // Type: array of {IPv6 address}
+          {
+            "code": 32,
+            "data": "2001:db8::31",
+            "name": "tftp-servers",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               .
+          .                    configuration-file-name                    .
+          .                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:         CL_OPTION_CONFIG_FILE_NAME(33)
+
+          option length:       n (for file name of length n)
+
+          configuration-file-name: The name of the configuration file for the client
+          */
+          // Type: string
+          {
+            "code": 33,
+            "data": "cm/012345678.cfg",
+            "name": "config-file",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               .
+          .                          vendor-name                          .
+          .                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:           CL_OPTION_VENDOR_NAME(10)
+
+          option length:         n (for string of length n)
+
+          vendor-name:           The vendor name string NVT ASCII text MUST NOT be
+                                 null terminated.
+          */
+          // Type: array of {IPv6 address}
+          {
+            "code": 34,
+            "data": "2001:db8::32",
+            "name": "syslog-servers",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               .
+          .                          vendor-name                          .
+          .                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:           CL_OPTION_VENDOR_NAME(10)
+
+          option length:         n (for string of length n)
+
+          vendor-name:           The vendor name string NVT ASCII text MUST NOT be
+                                 null terminated.
+          */
+          // Type: binary
+          {
+            "code": 36,
+            "data": "1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE",
+            "name": "device-id",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               .
+          .                          vendor-name                          .
+          .                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:           CL_OPTION_VENDOR_NAME(10)
+
+          option length:         n (for string of length n)
+
+          vendor-name:           The vendor name string NVT ASCII text MUST NOT be
+                                 null terminated.
+          */
+          // Type: int32
+          {
+            "code": 37,
+            "data": "2001:db8::33",
+            "name": "time-servers",
+            "space": "docsis3-v6"
+          },
+
+          /*
+           0                   1                   2                   3
+           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |          option-code          |          option-len           |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+          |                                                               .
+          .                          vendor-name                          .
+          .                                                               |
+          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+
+          option code:           CL_OPTION_VENDOR_NAME(10)
+
+          option length:         n (for string of length n)
+
+          vendor-name:           The vendor name string NVT ASCII text MUST NOT be
+                                 null terminated.
+          */
+          // Type: int32
+          {
+            "code": 38,
+            "data": "-25200",
+            "name": "time-offset",
+            "space": "docsis3-v6"
+          }
+        ],
+        "subnet": "2001:db8:d0c5:15::/64"
+      }
+    ]
+  }
+}
diff --git a/doc/examples/kea6/backends.json b/doc/examples/kea6/backends.json
new file mode 100644
index 0000000..7e16244
--- /dev/null
+++ b/doc/examples/kea6/backends.json
@@ -0,0 +1,106 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// It is a basic scenario with one IPv6 subnet configured. It demonstrates
+// how to configure Kea to use various backends to store leases:
+// - memfile
+// - MySQL
+// - PostgreSQL
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify lease type. Exactly one lease-database section
+// should be present. Make sure you uncomment only one.
+
+// 1. memfile backend. Leases information will be stored in flat CSV file.
+// This is the easiest backend to use as it does not require any extra
+// dependencies or services running.
+  "lease-database": {
+      "type": "memfile",
+      "persist": true,
+      "lfc-interval": 3600
+  },
+
+// 2. MySQL backend. Leases will be stored in MySQL database. Make sure it
+// is up, running and properly initialized. See kea-admin documentation
+// for details on how to initialize the database. The only strictly required
+// parameters are type and name. If other parameters are not specified,
+// Kea will assume the database is available on localhost, that user and
+// password is not necessary to connect and that timeout is 5 seconds.
+// Kea must be compiled with --with-mysql option to use this backend.
+//  "lease-database": {
+//      "type": "mysql",
+//      "name": "keatest",
+//      "host": "localhost",
+//      "port": 3306,
+//      "user": "keatest",
+//      "password": "secret1",
+//      "reconnect-wait-time": 3000, // expressed in ms
+//      "max-reconnect-tries": 3,
+//      "on-fail": "stop-retry-exit",
+//      "connect-timeout": 3
+//  },
+
+// 3. PostgreSQL backend. Leases will be stored in PostgreSQL database. Make
+// sure it is up, running and properly initialized. See kea-admin documentation
+// for details on how to initialize the database. The only strictly required
+// parameters are type and name. If other parameters are not specified,
+// Kea will assume the database is available on localhost, that user and
+// password is not necessary to connect and that timeout is 5 seconds.
+// Kea must be compiled with --with-pgsql option to use this backend.
+//  "lease-database": {
+//      "type": "postgresql",
+//      "name": "keatest",
+//      "host": "localhost",
+//      "port": 5432,
+//      "user": "keatest",
+//      "password": "secret1",
+//      "reconnect-wait-time": 3000, // expressed in ms
+//      "max-reconnect-tries": 3,
+//      "on-fail": "stop-retry-exit",
+//      "connect-timeout": 3
+//  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/classify.json b/doc/examples/kea6/classify.json
new file mode 100644
index 0000000..a5fc2e9
--- /dev/null
+++ b/doc/examples/kea6/classify.json
@@ -0,0 +1,110 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// The purpose of this example is to showcase how clients can be classified.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// Let's use the simplest backend: memfile and use some reasonable values
+// for timers. They are of no concern for the classification demonstration.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+
+// This list defines several classes that incoming packets can be assigned to.
+// One packet can belong to zero or more classes.
+  "client-classes": [
+
+// The first class attempts to match all packets coming in on eth0 interface.
+  {
+      "name": "lab",
+      "test": "pkt.iface == 'eth0'",
+      "option-data": [{
+          "name": "dns-servers",
+          "data": "2001:db8::1"
+      }]
+  },
+
+// Let's classify all incoming RENEW (message type 5) to a separate
+// class.
+  {
+      "name": "renews",
+      "test": "pkt6.msgtype == 5"
+  },
+
+// Let's pick cable modems. In this simple example we'll assume the device
+// is a cable modem if it sends a vendor option with enterprise-id equal
+// to 4491.
+  {
+      "name": "cable-modems",
+      "test": "vendor.enterprise == 4491"
+  }
+
+  ],
+
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+        "pools": [ { "pool": "2001:db8:1::/80" } ],
+        "subnet": "2001:db8:1::/64",
+        "client-class": "cable-modems",
+        "interface": "eth0"
+    },
+
+    // The following subnet contains a class reservation for a client using
+    // DUID 01:02:03:04:05:0A:0B:0C:0D:0E. This client will always be assigned
+    // to this class.
+    {
+        "pools": [ { "pool": "2001:db8:2::/80" } ],
+        "subnet": "2001:db8:2::/64",
+        "reservations": [
+        {
+            "duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
+            "client-classes": [ "cable-modems" ]
+        } ],
+        "interface": "eth0"
+    },
+
+    // The following subnet contains a pool with a class constraint: only
+    // clients which belong to the class are allowed to use this pool.
+    {
+        "pools": [
+           {
+               "pool": "2001:db8:4::/80",
+               "client-class": "cable-modems"
+           } ],
+         "subnet": "2001:db8:4::/64",
+         "interface": "eth1"
+    }
+
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/classify2.json b/doc/examples/kea6/classify2.json
new file mode 100644
index 0000000..474c393
--- /dev/null
+++ b/doc/examples/kea6/classify2.json
@@ -0,0 +1,146 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// The purpose of this example is to showcase how clients can be classified.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// Let's use the simplest backend: memfile and use some reasonable values
+// for timers. They are of no concern for the classification demonstration.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+
+// This list defines several classes that incoming packets can be assigned to.
+// One packet can belong to zero or more classes.
+  "client-classes": [
+
+// This class is required by the second subnet and is evaluated only
+// if it is required. The test expression returns true.
+// Note it is not possible to depend on cable-modems class because it
+// is not yet defined.
+  {
+      "name": "second_subnet",
+      "only-if-required": true,
+      "test": "member('ALL')",
+      "option-data": [{
+          "name": "dns-servers",
+          "data": "2001:db8::1"
+      }]
+  },
+
+// Let's classify all incoming RENEW (message type 5) to a separate
+// class.
+  {
+      "name": "renews",
+      "test": "pkt6.msgtype == 5"
+  },
+
+// Let's pick cable modems. In this simple example we'll assume the device
+// is a cable modem if it sends a vendor option with enterprise-id equal
+// to 4491.
+  {
+      "name": "cable-modems",
+      "test": "vendor.enterprise == 4491"
+  },
+
+// Both a cable modem (by evaluation or host reservation) and has a host
+// reservation.
+  {
+      "name": "cable-modem-hosts",
+      "test": "member('cable-modems') and member('KNOWN')"
+  }
+
+  ],
+
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+        "pools": [ { "pool": "2001:db8:1::/80" } ],
+        "subnet": "2001:db8:1::/64",
+        "client-class": "cable-modems",
+        "interface": "eth0"
+    },
+// The following subnet contains a class reservation for a client using
+// DUID 01:02:03:04:05:0A:0B:0C:0D:0E. This client will always be assigned
+// to this class.
+    {
+        "pools": [ { "pool": "2001:db8:2::/80" } ],
+        "subnet": "2001:db8:2::/64",
+        "reservations": [
+        {
+            "duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
+            "client-classes": [ "cable-modems" ]
+        } ],
+        "interface": "eth0",
+        "require-client-classes": [ "second_subnet" ]
+    },
+// The following subnet contains a pool with a class constraint: only
+// clients which belong to the class are allowed to use this pool.
+    {
+        "pools": [
+           {
+               "pool": "2001:db8:4::/80",
+               "client-class": "cable-modems"
+           } ],
+         "subnet": "2001:db8:4::/64",
+         "interface": "eth1"
+    },
+// This subnet is divided in two pools for unknown and known
+// (i.e. which have a reservation) clients. The built-in KNOWN and
+// UNKNOWN classes are set or not at host reservation lookup (KNOWN if
+// this returns something, UNKNOWN if this finds nothing) and client
+// classes depending on it are evaluated.
+// This happens after subnet selection and before address allocation
+// from pools.
+    {
+        "pools": [
+            {
+               "pool": "2001:db8:8::/64",
+               "client-class": "UNKNOWN"
+            },
+            {
+               "pool": "2001:db8:9::/64",
+               "client-class": "KNOWN"
+           }
+        ],
+        "subnet": "2001:db8:8::/46",
+        "reservations": [
+            {  "hw-address": "00:00:00:11:22:33", "hostname": "h1" },
+            {  "hw-address": "00:00:00:44:55:66", "hostname": "h4" },
+            {  "hw-address": "00:00:00:77:88:99", "hostname": "h7" },
+            {  "hw-address": "00:00:00:aa:bb:cc", "hostname": "ha" }
+        ]
+    }
+
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/comments.json b/doc/examples/kea6/comments.json
new file mode 100644
index 0000000..88cdd41
--- /dev/null
+++ b/doc/examples/kea6/comments.json
@@ -0,0 +1,123 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// It uses embedded (i.e., which will be included in configuration objects
+// and not stripped by at lexical analysis) comments.
+
+{ "Dhcp6":
+
+{
+   // Global scope
+   "comment": "A DHCPv6 server",
+
+   // In interface config
+   "interfaces-config": {
+       "comment": "Use wildcard",
+       "interfaces": [ "*" ] },
+
+   // In option definitions
+   "option-def": [ {
+       "comment": "An option definition",
+       "name": "foo",
+       "code": 100,
+       "type": "ipv6-address",
+       "space": "isc"
+    } ],
+
+   // In option data
+   "option-data": [ {
+       "comment": "Set option value",
+       "name": "subscriber-id",
+       "data": "ABCDEF0105",
+       "csv-format": false
+    } ],
+
+   // In client classes
+   "client-classes": [
+       {
+          "comment": "match all",
+          "name": "all",
+          "test": "'' == ''"
+       },
+       // Of course comments are optional
+       {
+          "name": "none"
+       },
+       // A comment and a user-context can be specified
+       {
+          "comment": "a comment",
+          "name": "both",
+          "user-context": {
+              "version": 1
+          }
+       }
+   ],
+
+   // In control socket (more for the agent)
+   "control-socket": {
+       "socket-type": "unix",
+       "socket-name": "/tmp/kea6-ctrl-socket",
+       "user-context": { "comment": "Indirect comment" }
+   },
+
+   // In shared networks
+   "shared-networks": [ {
+       "comment": "A shared network",
+       "name": "foo",
+
+       // In subnets
+       "subnet6": [
+         {
+           "comment": "A subnet",
+           "subnet": "2001:db1::/64",
+           "id": 100,
+
+           // In pools
+           "pools": [
+             {
+                "comment": "A pool",
+                "pool": "2001:db1::/64"
+             }
+           ],
+
+           // In prefix pools
+           "pd-pools": [
+             {
+                "comment": "A prefix pool",
+                "prefix": "2001:db2::",
+                "prefix-len": 48,
+                "delegated-len": 64
+             }
+           ],
+
+           // In host reservations
+           "reservations": [
+             {
+                "comment": "A host reservation",
+                "hw-address": "AA:BB:CC:DD:EE:FF",
+                "hostname": "foo.example.com",
+
+                // Again in an option data
+                "option-data": [ {
+                    "comment": "An option in a reservation",
+                    "name": "domain-search",
+                    "data": "example.com"
+                } ]
+             }
+           ]
+         }
+       ]
+    } ],
+
+   // In dhcp ddns
+   "dhcp-ddns": {
+       "comment": "No dynamic DNS",
+       "enable-updates": false
+   },
+
+   // In loggers
+   "loggers": [ {
+       "comment": "A logger",
+       "name": "kea-dhcp6"
+   } ]
+}
+
+}
diff --git a/doc/examples/kea6/config-backend.json b/doc/examples/kea6/config-backend.json
new file mode 100644
index 0000000..eca306d
--- /dev/null
+++ b/doc/examples/kea6/config-backend.json
@@ -0,0 +1,92 @@
+// This is an example configuration file for the DHCPv4 server in Kea.
+// It demonstrates how to enable Kea Configuration Backend using MySQL.
+// It requires that libdhcp_mysql_cb.so library is available and
+// optionally libdhcp_cb_cmds.so hooks library.
+
+{ "Dhcp6":
+
+{
+    // Set the server tag for the configuration backend. This instance will
+    // be named server2. Every configuration element that is applicable to
+    // either "all" or "server2" will be used by this instance.
+    "server-tag": "server2",
+
+    // Kea is told to listen on eth0 interface only.
+    "interfaces-config": {
+        "interfaces": [ "eth0" ]
+    },
+
+    // Use memfile lease database backend.
+    "lease-database": {
+        "type": "memfile",
+        "lfc-interval": 3600
+    },
+
+    // This parameter controls how the server accesses the configuration
+    // database. Currently only one database type is available - "mysql".
+    // It requires that libdhcp_mysql_cb.so hooks library is loaded.
+    "config-control": {
+        // A list of database backends to connect to. Currently, it is limited
+        // to a single backend.
+        "config-databases": [
+            {
+                "type": "mysql",
+                "reconnect-wait-time": 3000, // expressed in ms
+                "max-reconnect-tries": 3,
+                "name": "kea",
+                "user": "kea",
+                "password": "kea",
+                "host": "localhost",
+                "port": 3306
+            }
+        ],
+        // Controls how often the server polls the database for the
+        // configuration updates. The setting below implies that it
+        // will take up to approx. 20 seconds for the server to
+        // discover and fetch configuration changes.
+        "config-fetch-wait-time": 20
+    },
+
+    // This defines a control socket. If defined, Kea will open a UNIX socket
+    // and will listen for incoming commands. See section 17 of the Kea ARM for
+    // details.
+    "control-socket": {
+        "socket-type": "unix",
+        "socket-name": "/tmp/kea6-ctrl-socket"
+    },
+
+    // Hooks libraries that enable configuration backend are loaded.
+    "hooks-libraries": [
+        // The libdhcp_mysql_cb.so is required to use MySQL Configuration
+        // Backend.
+        {
+            "library": "/usr/local/lib/kea/hooks/libdhcp_mysql_cb.so"
+        }
+        // The libdhcp_cb_cmds.so is optional. It allows for managing the
+        // configuration in the database. If this library is not loaded,
+        // the configuration can be managed directly using available
+        // tools that work directly with the MySQL database.
+        //,{
+            // "library": "/usr/local/lib/kea/hooks/libdhcp_cb_cmds.so"
+        //}
+    ],
+
+    // The following configures logging. It assumes that messages with at
+    // least informational level (info, warn, error and fatal) should be
+    // logged to stdout. Alternatively, you can specify stderr here, a filename
+    // or 'syslog', which will store output messages via syslog.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/dhcpv4-over-dhcpv6.json b/doc/examples/kea6/dhcpv4-over-dhcpv6.json
new file mode 100644
index 0000000..68d5675
--- /dev/null
+++ b/doc/examples/kea6/dhcpv4-over-dhcpv6.json
@@ -0,0 +1,57 @@
+// This is an example configuration file for the DHCPv6 server of
+// DHCPv4-over-DHCPv6 tests in Kea.
+
+{
+
+// DHCPv6 conf
+"Dhcp6":
+{
+  "interfaces-config": {
+// Enable unicast
+    "interfaces": [ "eth0/2001:db8:1::1" ]
+  },
+
+  "lease-database": {
+    "type": "memfile",
+    "name": "leases6"
+  },
+
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+  "subnet6": [
+   {   "subnet": "2001:db8:1:1::/64",
+       "interface": "eth0",
+       "pools": [ { "pool": "2001:db8:1:1::1:0/112" } ] }
+   ],
+
+// This enables DHCPv4-over-DHCPv6 support
+  "dhcp4o6-port": 6767,
+
+// Required by DHCPv4-over-DHCPv6 clients
+  "option-data": [
+   {  "name": "dhcp4o6-server-addr",
+      "code": 88,
+      "space": "dhcp6",
+      "csv-format": true,
+// Put the server address here
+      "data": "2001:db8:1:1::1" }
+   ],
+
+   "loggers": [
+    {
+      "name": "kea-dhcp6",
+      "output_options": [
+          {
+            "output": "/tmp/kea-dhcp6.log"
+          }
+      ],
+      "severity": "DEBUG",
+      "debuglevel": 0
+    }
+  ]
+}
+
+}
diff --git a/doc/examples/kea6/duid.json b/doc/examples/kea6/duid.json
new file mode 100644
index 0000000..0c00c74
--- /dev/null
+++ b/doc/examples/kea6/duid.json
@@ -0,0 +1,79 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It demonstrates how to configure Kea to use DUID-LLT with some
+// values specified explicitly.
+
+{ "Dhcp6":
+
+{
+
+// Configure server identifier (DUID-LLT). The hexadecimal value of the
+// identifier will be used as link layer address component of the DUID.
+// The link layer type will be ethernet. The value of time is set to 0
+// which indicates that the server must generate this value, i.e. use
+// current time. Note that it is easy to move from this configuration
+// to DUID-EN or DUID-LL. It would require changing the "type" value
+// to "EN" or "LL" respectively. The "identifier" would hold a
+// DUID-EN variable length identifier or DUID-LL link layer address.
+// The values of "time" and "htype" would be ignored for DUID-EN.
+// If one wanted to use a non-default enterprise-id for DUID-EN, the
+// "enterprise-id" parameter would need to be added. Note that only
+// a "type" parameter is mandatory while specifying "server-id" map.
+  "server-id": {
+    "type": "LLT",
+    "identifier": "12C4D5AF870C",
+    "time": 0,
+    "htype": 1
+  },
+
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at least
+// informational level (info, warn, error) will will be logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/global-reservations.json b/doc/examples/kea6/global-reservations.json
new file mode 100644
index 0000000..872a0e2
--- /dev/null
+++ b/doc/examples/kea6/global-reservations.json
@@ -0,0 +1,172 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// It demonstrates how global host reservations can be configured.
+// The global reservations are not associated with any subnet. They
+// are assigned regardless of the subnet to which the DHCP client belongs.
+// Global reservations are assigned to the DHCP clients using the
+// same host identifier types as subnet specific reservations. This file
+// contains multiple examples of host reservations using different
+// identifier types, e.g. DUID, MAC address etc.
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+
+// This is pretty basic stuff, it has nothing to do with reservations.
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// Kea supports three types of identifiers in DHCPv6: hw-address (hardware/MAC
+// address of the client), duid (DUID inserted by the client) and flex-id
+// (flexible identifier available when flex_id hook library is loaded) When told
+// to do so, Kea can check for each of these identifier types, but it takes a
+// costly database lookup to do so. It is therefore useful from a performance
+// perspective to use only the reservation types that are actually used in a
+// given network.
+  "host-reservation-identifiers": [ "duid", "hw-address", "flex-id" ],
+
+// This directive tells Kea that reservations are global. Note that this
+// can also be specified at shared network and/or subnet level.
+// "reservation-mode": "global",
+// It is replaced by the "reservations-global", "reservations-in-subnet" and
+// "reservations-out-of-pool" parameters.
+
+// Specify if server should lookup global reservations.
+  "reservations-global": true,
+
+// Specify if server should lookup in-subnet reservations.
+  "reservations-in-subnet": false,
+
+// Specify if server can assume that all reserved addresses
+// are out-of-pool.
+// Ignored when reservations-in-subnet is false.
+// If specified, it is inherited by "shared-networks" and "subnet6" levels.
+  "reservations-out-of-pool": false,
+
+// Define several global host reservations.
+  "reservations": [
+
+// This is a simple host reservation. The host with DUID matching
+// the specified value will get an address of 2001:db8:1::100.
+// Note it is not recommended but still allowed to reverse addresses at
+// the global scope: as it breaks the link between the reservation and
+// the subnet it can lead to a client localized in another subnet than
+// its address belongs to.
+      {
+          "duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
+          "ip-addresses": [ "2001:db8:1::100" ]
+      },
+
+// This is similar to the previous one, but this time the reservation
+// is done based on hardware/MAC address. The server will do its best to
+// extract the hardware/MAC address from received packets (see
+// 'mac-sources' directive for details). This particular reservation
+// also specifies two extra options to be available for this client. If
+// there are options with the same code specified in a global, subnet or
+// class scope, the values defined at host level take precedence for
+// this particular DHCP client.
+      {
+          "hw-address": "00:01:02:03:04:05",
+          "ip-addresses": [ "2001:db8:1::101" ],
+          "option-data": [
+              {
+                  "name": "dns-servers",
+                  "data": "3000:1::234"
+              },
+              {
+                  "name": "nis-servers",
+                  "data": "3000:1::234"
+              }
+          ],
+          "client-classes": [ "special_snowflake", "office" ]
+      },
+
+// This is a bit more advanced reservation. The client with the specified
+// DUID will get a reserved address, a reserved prefix and a hostname.
+// At least one of the three must be specified in a reservation.
+// Finally, this reservation features vendor specific options for CableLabs,
+// which happen to use enterprise-id 4491. Those particular values will
+// be returned only to the client that has a DUID matching this reservation.
+      {
+          "duid": "01:02:03:04:05:06:07:08:09:0A",
+          "ip-addresses": [ "2001:db8:1:cafe::1" ],
+          "prefixes": [ "2001:db8:2:abcd::/64" ],
+          "hostname": "foo.example.com",
+          "option-data": [
+              {
+                  "name": "vendor-opts",
+                  "data": "4491"
+              },
+              {
+                  "name": "tftp-servers",
+                  "space": "vendor-4491",
+                  "data": "3000:1::234"
+              }
+          ]
+      },
+
+// This reservation is using flexible identifier. Instead of relying
+// on specific field, sysadmin can define an expression similar to what
+// is used for client classification,
+// e.g. substring(relay[0].option[17],0,6). Then, based on the value of
+// that expression for incoming packet, the reservation is matched.
+// Expression can be specified either as hex or plain text using single
+// quotes.
+// Note: flexible identifier requires flex_id hook library to be
+// loaded to work.
+      {
+          "flex-id": "'somevalue'",
+          "ip-addresses": [ "2001:db8:1:cafe::2" ]
+      }
+  ],
+
+// The following list defines subnets. Subnet, pools and interface definitions
+// are the same as in the regular scenario.
+    "subnet6": [
+        {
+            "subnet": "2001:db8::/47",
+
+            "pools": [ { "pool": "2001:db8::/64" } ],
+
+            "pd-pools": [
+                {
+                    "prefix": "2001:db8:1:8000::",
+                    "prefix-len": 56,
+                    "delegated-len": 64
+                }
+            ],
+            "interface": "eth0"
+        }
+    ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/ha-hot-standby.json b/doc/examples/kea6/ha-hot-standby.json
new file mode 100644
index 0000000..a0752d5
--- /dev/null
+++ b/doc/examples/kea6/ha-hot-standby.json
@@ -0,0 +1,150 @@
+// This is an example configuration of the Kea DHCPv6 server. It uses High
+// Availability hooks library and Lease Commands hooks library to enable
+// High Availability function for the DHCP server. Note that almost exactly
+// the same configuration must be used on the second server (partner).
+// The only difference is that "this-server-name" must be set to "server1"
+// on this other server. Also, the interface configuration depends on the
+// network settings of the particular machine.
+//
+// The servers using this configuration work in hot standby mode..
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+    "interfaces-config": {
+        "interfaces": [ "eth0" ]
+    },
+
+    // Control socket is required for communication between the Control
+    // Agent and the DHCP server. High Availability requires Control Agent
+    // to be running because lease updates are sent over the RESTful
+    // API between the HA peers.
+    "control-socket": {
+        "socket-type": "unix",
+        "socket-name": "/tmp/kea6-ctrl-socket"
+    },
+
+    // Use Memfile lease database backend to store leases in a CSV file.
+    // Depending on how Kea was compiled, it may also support SQL databases
+    // (MySQL and/or PostgreSQL). Those database backends require more
+    // parameters, like name, host and possibly user and password.
+    // There are dedicated examples for each backend. See Section 7.2.2 "Lease
+    // Storage" for details.
+    "lease-database": {
+        // Memfile is the simplest and easiest backend to use. It's a in-memory
+        "type": "memfile"
+    },
+
+    // HA requires two hooks libraries to be loaded: libdhcp_lease_cmds.so and
+    // libdhcp_ha.so. The former handles incoming lease updates from the HA peers.
+    // The latter implements high availability feature for Kea.
+    "hooks-libraries": [
+        {
+            "library": "/opt/lib/kea/hooks/libdhcp_lease_cmds.so",
+            "parameters": { }
+        },
+        {
+            // The HA hooks library should be loaded.
+            "library": "/opt/lib/kea/hooks/libdhcp_ha.so",
+            "parameters": {
+                // High Availability configuration is specified for the HA hook library.
+                // Each server should have the same HA configuration, except for the
+                // "this-server-name" parameter.
+                "high-availability": [ {
+                    // This parameter points to this server instance. The respective
+                    // HA peers must have this parameter set to their own names.
+                    "this-server-name": "server2",
+                    // The HA mode is set to hot-standby. This server will receive lease
+                    // updates from the primary. The primary will be responding to all
+                    // DHCP queries.
+                    "mode": "hot-standby",
+                    // Heartbeat is to be sent every 10 seconds if no other control
+                    // commands are transmitted.
+                    "heartbeat-delay": 10000,
+                    // Maximum time for partner's response to a heartbeat, after which
+                    // failure detection is started. This is specified in milliseconds.
+                    "max-response-delay": 60000,
+                    // The following parameters control how the server detects the
+                    // partner's failure. The ACK delay sets the threshold for the
+                    // 'secs' field of the received discovers. This is specified in
+                    // milliseconds.
+                    "max-ack-delay": 5000,
+                    // This specifies the number of clients which send messages to
+                    // the partner but appear to not receive any response.
+                    "max-unacked-clients": 5,
+                    "peers": [
+                         // This is the configuration of our HA peer.
+                         {
+                             "name": "server1",
+                             // Specifies the URL on which the partner's control
+                             // channel can be reached. The Control Agent is required
+                             // to run on the partner's machine with "http-host" and
+                             // "http-port" values set to the corresponding values.
+                             "url": "http://192.168.56.33:8000/",
+                             // Th partner is primary. Our is standby.
+                             "role": "primary"
+                         },
+                         // This is the configuration of this server instance.
+                         {
+                             "name": "server2",
+                             // This specifies the URL of our server instance. The
+                             // Control Agent must run along with our DHCPv6 server
+                             // instance and the "http-host" and "http-port" must be
+                             // set to the corresponding values.
+                             "url": "http://192.168.56.66:8000/",
+                             // Out server is standby. The partner is primary.
+                             "role": "standby"
+                         }
+                     ]
+                 } ]
+            }
+        }
+    ],
+
+    // The following list defines subnets. Each subnet consists of at
+    // least subnet and pool entries.
+    "subnet6": [
+        {
+             "subnet": "2001:db8:1::/64",
+
+             "pools": [
+                {
+                    "pool": "2001:db8:1::100 - 2001:db8:1::250"
+                }
+             ],
+
+             "interface": "eth0"
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout. Alternatively, you can specify stderr here, a filename
+// or 'syslog', which will store output messages via syslog.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        },
+        {
+            // This section specifies configuration of the HA hooks library specific
+            // logger.
+            "name": "kea-dhcp4.ha-hooks",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "severity": "INFO",
+            "debuglevel": 99
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/hooks.json b/doc/examples/kea6/hooks.json
new file mode 100644
index 0000000..60fc898
--- /dev/null
+++ b/doc/examples/kea6/hooks.json
@@ -0,0 +1,57 @@
+// This is an example configuration file for the DHCPv6 server in Kea
+// illustrating the configuration of hooks libraries.  It uses a basic scenario
+// of one IPv6 subnet configured with the default values for all parameters.
+
+{"Dhcp6":
+
+{
+// Kea is told to listen on the eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// Set up the storage for leases.
+  "lease-database": {
+    "type": "memfile"
+  },
+
+// Set values to mandatory timers
+  "renew-timer": 900,
+  "rebind-timer": 1200,
+  "preferred-lifetime": 1800,
+  "valid-lifetime": 2700,
+
+// Define a single subnet.
+  "subnet6": [
+    {
+      "pools": [
+        {
+          "pool": "2001:db8:1::/80",
+          "user-context": { "charging": true }
+        } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// Set up the hooks libraries.  For this example, we assume that two libraries
+// are loaded, called "security" and "charging".  Note that order is important:
+// "security" is specified first so if both libraries supply a hook function
+// for a given hook, the function in "security" will be called before that in
+// "charging".
+
+  "hooks-libraries": [
+     {
+        "library": "/opt/lib/security.so"
+     },
+     {
+        "library": "/opt/lib/charging.so",
+        "parameters": {
+             "path": "/var/lib/kea",
+             "base-name": "kea-forensic6"
+        }
+     }
+  ]
+}
+
+}
diff --git a/doc/examples/kea6/iPXE.json b/doc/examples/kea6/iPXE.json
new file mode 100644
index 0000000..601ad6f
--- /dev/null
+++ b/doc/examples/kea6/iPXE.json
@@ -0,0 +1,67 @@
+// This is an example configuration for iPXE boot in Kea6.
+
+{
+   "Dhcp6": {
+   // Mandatory part of the config that list interfaces on which
+   // Kea will listen for incoming traffic.
+      "interfaces-config": {
+         "interfaces": [ "eth0" ]
+      },
+
+// Two classes are migrated form ISC-DHCP example:
+// if exists dhcp6.client-arch-type and
+//    option dhcp6.client-arch-type = 00:07 {
+//    option dhcp6.bootfile-url "http://[2001:db8::1]/ipxe.efi";
+// } else if exists dhcp6.user-class and
+//          substring(option dhcp6.user-class, 2, 4) = "iPXE" {
+//    option dhcp6.bootfile-url "http://[2001:db8::1]/ubuntu.cfg";
+// }
+//
+// In example shown below incoming packet will receive value
+// http://[2001:db8::1]/ubuntu.cfg if incoming packet will include user
+// class option with "iPXE" in it and value http://[2001:db8::1]/ipxe.efi
+// if option client architecture type will be 7.
+// If incoming packet will include both of those options with matching
+// values it will be assigned to class "a-ipxe" because it was first
+// matching class. If you want to change that order names of the classes
+// have to have different alphabetical order. In Kea 1.3.0 (and previous
+// versions) alphabetical order is used in classification. Note this
+// should change in next versions, for instance to keep the definition
+// order.
+      "client-classes": [
+         {
+            "name": "a-ipxe",
+            // user-class option (code 15) is a tuple array
+            // so we need to skip the length (tuple first element)
+            "test": "substring(option[15].hex, 2, 4) == 'iPXE'",
+            "option-data": [
+               {
+                  "space": "dhcp6",
+                  "name": "bootfile-url",
+                  "code": 59,
+                  "data": "http://[2001:db8::1]/ubuntu.cfg"
+               }
+            ]
+         },
+         {
+            "name": "b-efi",
+            // please consider to add a not a-ipxe here to enforce
+            // the "else"?
+            "test": "option[61].hex == 0x0007",
+            "option-data": [
+               {
+                  "space": "dhcp6",
+                  "name": "bootfile-url",
+                  "code": 59,
+                  "data": "http://[2001:db8::1]/ipxe.efi"
+               }
+            ]
+         }
+      ],
+      "subnet6": [
+         {
+            "subnet": "2001:db8::/64"
+         }
+      ]
+   }
+}
diff --git a/doc/examples/kea6/leases-expiration.json b/doc/examples/kea6/leases-expiration.json
new file mode 100644
index 0000000..5a3eeb4
--- /dev/null
+++ b/doc/examples/kea6/leases-expiration.json
@@ -0,0 +1,81 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It provides parameters controlling processing of expired leases,
+// a.k.a. leases reclamation.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+// Note, we're setting the maximum number of row read errors to 100,
+// (defaults to 0, meaning unlimited).
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600,
+      "max-row-errors": 100
+  },
+
+// The following parameters control processing expired leases. Expired leases
+// will be reclaimed periodically according to the "reclaim-timer-wait-time"
+// parameter. Reclaimed leases will be held in the database for 1800s to
+// facilitate lease affinity. After this period the leases will be removed.
+// The frequency of removal is controlled by the
+// "flush-reclaimed-timer-wait-time" parameter. The lease reclamation
+// routine will process at most 500 leases or will last for at most
+// 100ms, during a single run. If there are still some unreclaimed
+// leases after 10 attempts, a warning message is issued.
+  "expired-leases-processing": {
+    "reclaim-timer-wait-time": 5,
+    "hold-reclaimed-time": 1800,
+    "flush-reclaimed-timer-wait-time": 10,
+    "max-reclaim-leases": 500,
+    "max-reclaim-time": 100,
+    "unwarned-reclaim-cycles": 10
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/multiple-options.json b/doc/examples/kea6/multiple-options.json
new file mode 100644
index 0000000..b6d8be8
--- /dev/null
+++ b/doc/examples/kea6/multiple-options.json
@@ -0,0 +1,183 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It demonstrates simple configuration of the options for a subnet.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+    "type": "memfile"
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// Defining a subnet. There are some DHCP options returned to the
+// clients connected to this subnet. The first option is identified
+// by the name. The second option is identified by the code.
+// There are two address pools defined within this subnet. Pool
+// specific value for option 12 is defined for the pool:
+// 2001:db8:1::1 - 2001:db8:1::100. Clients obtaining an address
+// from this pool will be assigned option 12 with a value of
+// 3001:cafe::21. Clients belonging to this subnet but obtaining
+// addresses from the other pool, or the clients obtaining
+// stateless configuration will be assigned subnet specific value
+// of option 12, i.e. 2001:db8:1:0:ff00::1.
+// For DHCPv6 subnets can have prefix delegation pools too so
+// a pd-pools with an option-data is defined too.
+  "subnet6": [
+    {
+        // This is how option values are defined for this particular subnet.
+        "option-data": [
+            // When specifying options, you typically need to specify
+            // one of (name or code) and data. The full option specification
+            // covers name, code, space, csv-format and data.
+            // space defaults to "dhcp6" which is usually correct, unless you
+            // use encapsulate options. csv-format defaults to "true", so
+            // this is also correct, unless you want to specify the whole
+            // option value as long hex string. For example, to specify
+            // domain-name-servers you could do this:
+            // {
+            //     "name": "dns-servers",
+            //     "code": 23,
+            //     "csv-format": true,
+            //     "space": "dhcp6",
+            //     "data": "2001:db8:2::45, 2001:db8:2::100"
+            // }
+            // but it's a lot of writing, so it's easier to do this instead:
+            {
+                "name": "dns-servers",
+                "data": "2001:db8:2::45, 2001:db8:2::100"
+            },
+
+            // Typically people prefer to refer to options by their
+            // names, so they don't need to remember the code
+            // names. However, some people like to use numerical
+            // values. For example, DHCPv6 can optionally use server
+            // unicast communication, if extra option is present. Option
+            // "unicast" uses option code 12, so you can reference to it
+            // either by "name": "unicast" or "code": 12.
+            {
+                "code": 12,
+                "data": "2001:db8:1:0:ff00::1"
+            },
+
+            // Options can also be specified using hexadecimal format.
+            // This should be avoided if possible, because Kea ability to
+            // validate correctness is limited when using hex values.
+            {
+                "name": "sntp-servers",
+                "csv-format": false,
+                "data": "20010db8000000000000000000000001"
+            },
+
+            // String options that have a comma in their values need to have
+            // it escaped (i.e. each comma is preceded by two backslashes).
+            // That's because commas are reserved for separating fields in
+            // compound options. At the same time, we need to be conformant
+            // with JSON spec, that does not allow "\,". Therefore the
+            // slightly uncommon double backslashes notation is needed.
+
+            // Legal JSON escapes are \ followed by "\/bfnrt character
+            // or \u followed by 4 hexa-decimal numbers (currently Kea
+            // supports only \u0000 to \u00ff code points).
+            // CSV processing translates '\\' into '\' and '\,' into ','
+            // only so for instance '\x' is translated into '\x'. But
+            // as it works on a JSON string value each of these '\'
+            // characters must be doubled on JSON input.
+            {
+                "name": "new-posix-timezone",
+                "data": "EST5EDT4\\,M3.2.0/02:00\\,M11.1.0/02:00"
+            },
+
+            // Options that take integer values can either be specified in
+            // dec or hex format. Hex format could be either plain (e.g. abcd)
+            // or prefixed with 0x (e.g. 0xabcd).
+            {
+                "name": "preference",
+                "data": "0xf0"
+            },
+
+            // A few options are encoded in (length, string) tuples
+            // which can be defined using only strings as the CSV
+            // processing computes lengths.
+            {
+                "name": "bootfile-param",
+                "data": "root=/dev/sda2, quiet, splash"
+            },
+
+            // At a few exceptions options are added to response only when
+            // the client requests them. The always-send flag should be used
+            // to enforce a particular option.
+            {
+                "name": "pana-agent",
+                "data": "2001:db8:2::123",
+                "always-send": true
+            }
+      ],
+      "pools": [
+        {
+            "pool": "2001:db8:1::1 - 2001:db8:1::100",
+            "option-data": [
+              {
+                  "code": 12,
+                  "data": "3001:cafe::21"
+              }
+            ]
+        },
+        {
+            "pool": "2001:db8:1::500 - 2001:db8:1::1000"
+        }
+      ],
+      "pd-pools": [
+        {
+             "prefix": "2001:2b8:2::",
+             "prefix-len": 56,
+             "delegated-len": 64,
+             "option-data": [
+               {
+                   "code": 12,
+                   "data": "3001:cafe::12"
+               }
+             ]
+         }
+      ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/mysql-reservations.json b/doc/examples/kea6/mysql-reservations.json
new file mode 100644
index 0000000..769c111
--- /dev/null
+++ b/doc/examples/kea6/mysql-reservations.json
@@ -0,0 +1,101 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// It contains configuration of the MySQL host database backend, used
+// to retrieve reserved addresses, host names, DHCPv4 message fields
+// and DHCP options from MySQL database.
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+
+// This is pretty basic stuff, it has nothing to do with reservations.
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// Kea supports two types of identifiers in DHCPv6: hw-address
+// (hardware/MAC address of the client) and duid (DUID inserted by the
+// client). When told to do so, Kea can check for each of these
+// identifier types, but it takes a costly database lookup to do so. It
+// is therefore useful from a performance perspective to use only the
+// reservation types that are actually used in a given network.
+    "host-reservation-identifiers": [ "duid", "hw-address" ],
+
+// Specify connection to the database holding host reservations. The type
+// specifies that the MySQL database is used. user and password are the
+// credentials used to connect to the database. host and name specify
+// location of the host where the database instance is running, and the
+// name of the database to use. The server processing a packet will first
+// check if there are any reservations specified for this client in the
+// reservations list, within the subnet (configuration file). If there are
+// no reservations there, the server will try to retrieve reservations
+// from this database.
+  "hosts-database": {
+    "type": "mysql",
+    "reconnect-wait-time": 3000, // expressed in ms
+    "max-reconnect-tries": 3,
+    "name": "keatest",
+    "user": "keatest",
+    "password": "keatest",
+    "host": "localhost",
+    "port": 3306,
+    "readonly": true,
+    "trust-anchor": "my-ca",
+    "cert-file": "my-cert",
+    "key-file": "my-key",
+    "cipher-list": "AES"
+  },
+
+// Define a subnet with a pool of dynamic addresses and a pool of dynamic
+// prefixes. Addresses and prefixes from those pools will be assigned to
+// clients which don't have reservations in the database. Subnet identifier
+// is equal to 1. If this subnet is selected for the client, this subnet
+// id will be used to search for the reservations within the database.
+  "subnet6": [
+    {
+      "subnet": "2001:db8:1::/48",
+
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+
+      "pd-pools": [
+          {
+              "prefix": "2001:db8:1:8000::",
+              "prefix-len": 56,
+              "delegated-len": 64
+          }
+      ],
+      "interface": "eth0",
+      "id": 1
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/pgsql-reservations.json b/doc/examples/kea6/pgsql-reservations.json
new file mode 100644
index 0000000..c7e204c
--- /dev/null
+++ b/doc/examples/kea6/pgsql-reservations.json
@@ -0,0 +1,98 @@
+// This is an example configuration file for the DHCPv6 server in Kea.
+// It contains configuration of the PostgreSQL host database backend, used
+// to retrieve reserved addresses, host names, DHCPv4 message fields
+// and DHCP options from PostgreSQL database.
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+    "type": "memfile"
+  },
+
+// This is pretty basic stuff, it has nothing to do with reservations.
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// Kea supports two types of identifiers in DHCPv6: hw-address
+// (hardware/MAC address of the client) and duid (DUID inserted by the
+// client). When told to do so, Kea can check for each of these
+// identifier types, but it takes a costly database lookup to do so. It
+// is therefore useful from a performance perspective to use only the
+// reservation types that are actually used in a given network.
+    "host-reservation-identifiers": [ "duid", "hw-address" ],
+
+// Specify connection to the database holding host reservations. The type
+// specifies that the PostgreSQL database is used. user and password are the
+// credentials used to connect to the database. host and name specify
+// location of the host where the database instance is running, and the
+// name of the database to use. The server processing a packet will first
+// check if there are any reservations specified for this client in the
+// reservations list, within the subnet (configuration file). If there are
+// no reservations there, the server will try to retrieve reservations
+// from this database.
+// The database specification can go into one hosts-database entry for
+// backward compatibility or be listed in hosts-databases list.
+  "hosts-databases": [
+    {
+       "type": "postgresql",
+       "reconnect-wait-time": 3000, // expressed in ms
+       "max-reconnect-tries": 3,
+       "name": "keatest",
+       "user": "keatest",
+       "password": "keatest",
+       "host": "localhost"
+    }
+  ],
+
+// Define a subnet with a pool of dynamic addresses and a pool of dynamic
+// prefixes. Addresses and prefixes from those pools will be assigned to
+// clients which don't have reservations in the database. Subnet identifier
+// is equal to 1. If this subnet is selected for the client, this subnet
+// id will be used to search for the reservations within the database.
+  "subnet6": [
+    {
+      "subnet": "2001:db8:1::/48",
+
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+
+      "pd-pools": [
+          {
+              "prefix": "2001:db8:1:8000::",
+              "prefix-len": 56,
+              "delegated-len": 64
+          }
+      ],
+      "interface": "eth0",
+      "id": 1
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/reservations.json b/doc/examples/kea6/reservations.json
new file mode 100644
index 0000000..f18ba62
--- /dev/null
+++ b/doc/examples/kea6/reservations.json
@@ -0,0 +1,169 @@
+// This is an example configuration file for DHCPv6 server in Kea
+// that showcases how to do host reservations. It is
+// assumed that one subnet (2001:db8:1::/64) is available directly
+// over eth0 interface. A number of hosts have various combinations
+// of addresses and prefixes reserved for them.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+
+// This is pretty basic stuff, it has nothing to do with reservations.
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// Kea supports three types of identifiers in DHCPv6: hw-address (hardware/MAC
+// address of the client), duid (DUID inserted by the client) and flex-id
+// (flexible identifier available when flex_id hook library is loaded) When told
+// to do so, Kea can check for each of these identifier types, but it takes a
+// costly database lookup to do so. It is therefore useful from a performance
+// perspective to use only the reservation types that are actually used in a
+// given network.
+    "host-reservation-identifiers": [ "duid", "hw-address", "flex-id" ],
+
+// The following list defines subnets. Subnet, pools and interface definitions
+// are the same as in the regular scenario, without host reservations.
+// least subnet and pool entries.
+  "subnet6": [
+    {
+        "subnet": "2001:db8:1::/48",
+
+        // This directive tells Kea that reservations may be made both in-pool
+        // and out-of-pool. For improved performance, you may move all reservations
+        // out of the dynamic pool and change reservation-mode to "out-of-pool".
+        // Kea will then be able to skip querying for host reservations when
+        // assigning leases from dynamic pool.
+        // "reservation-mode": "all",
+        // It is replaced by the "reservations-global", "reservations-in-subnet"
+        // and "reservations-out-of-pool" parameters.
+
+        // Specify if server should lookup global reservations.
+        "reservations-global": false,
+
+        // Specify if server should lookup in-subnet reservations.
+        "reservations-in-subnet": true,
+
+        // Specify if server can assume that all reserved addresses
+        // are out-of-pool.
+        // Ignored when reservations-in-subnet is false.
+        // If specified, it is inherited by "shared-networks" and
+        // "subnet6" levels.
+        "reservations-out-of-pool": false,
+
+        "pools": [ { "pool": "2001:db8:1::/120" } ],
+
+        "pd-pools": [
+          {
+              "prefix": "2001:db8:1:8000::",
+              "prefix-len": 56,
+              "delegated-len": 64
+          }
+        ],
+        "interface": "eth0",
+
+// Host reservations. Define several reservations, note that
+// they are all within the range of the pool of the dynamically
+// allocated address. The server will exclude the addresses from this
+// pool and only assign them to the client which has a reservation for
+// them.
+       "reservations": [
+// This is a simple host reservation. The host with DUID matching
+// the specified value will get an address of 2001:db8:1::100.
+          {
+              "duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
+              "ip-addresses": [ "2001:db8:1::100" ]
+          },
+// This is similar to the previous one, but this time the reservation
+// is done based on hardware/MAC address. The server will do its best to
+// extract the hardware/MAC address from received packets (see
+// 'mac-sources' directive for details). This particular reservation
+// also specifies two extra options to be available for this client. If
+// there are options with the same code specified in a global, subnet or
+// class scope, the values defined at host level take precedence.
+          {
+              "hw-address": "00:01:02:03:04:05",
+              "ip-addresses": [ "2001:db8:1::101" ],
+              "option-data": [
+              {
+                  "name": "dns-servers",
+                  "data": "3000:1::234"
+              },
+              {
+                  "name": "nis-servers",
+                  "data": "3000:1::234"
+              } ],
+              "client-classes": [ "special_snowflake", "office" ]
+          },
+// This is a bit more advanced reservation. The client with the specified
+// DUID will get a reserved address, a reserved prefix and a hostname.
+// This reservation is for an address that it not within the dynamic pool.
+// Finally, this reservation features vendor specific options for CableLabs,
+// which happen to use enterprise-id 4491. Those particular values will
+// be returned only to the client that has a DUID matching this reservation.
+          {
+              "duid": "01:02:03:04:05:06:07:08:09:0A",
+              "ip-addresses": [ "2001:db8:1:cafe::1" ],
+              "prefixes": [ "2001:db8:2:abcd::/64" ],
+              "hostname": "foo.example.com",
+              "option-data": [ {
+                  "name": "vendor-opts",
+                  "data": "4491"
+              },
+              {
+                  "name": "tftp-servers",
+                  "space": "vendor-4491",
+                  "data": "3000:1::234"
+              } ]
+
+          },
+// This reservation is using flexible identifier. Instead of relying
+// on specific field, sysadmin can define an expression similar to what
+// is used for client classification,
+// e.g. substring(relay[0].option[17],0,6). Then, based on the value of
+// that expression for incoming packet, the reservation is matched.
+// Expression can be specified either as hex or plain text using single
+// quotes.
+// Note: flexible identifier requires flex_id hook library to be
+//loaded to work.
+         {
+             "flex-id": "'somevalue'",
+             "ip-addresses": [ "2001:db8:1:cafe::2" ]
+         }
+
+      ]
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/several-subnets.json b/doc/examples/kea6/several-subnets.json
new file mode 100644
index 0000000..78bb066
--- /dev/null
+++ b/doc/examples/kea6/several-subnets.json
@@ -0,0 +1,61 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It's a basic scenario with four IPv6 subnets configured. In each
+// subnet, there's a smaller pool of dynamic addresses.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+    "type": "memfile"
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+  {    "pools": [ { "pool": "2001:db8:1::/80" } ],
+       "subnet": "2001:db8:1::/64"  },
+  {    "pools": [ { "pool": "2001:db8:2::/80" } ],
+       "subnet": "2001:db8:2::/64"  },
+  {    "pools": [ { "pool": "2001:db8:3::/80" } ],
+       "subnet": "2001:db8:3::/64"  },
+  {    "pools": [ { "pool": "2001:db8:4::/80" } ],
+       "subnet": "2001:db8:4::/64"  } ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+  "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/shared-network.json b/doc/examples/kea6/shared-network.json
new file mode 100644
index 0000000..5666e01
--- /dev/null
+++ b/doc/examples/kea6/shared-network.json
@@ -0,0 +1,150 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It demonstrates an advanced feature called shared network. Typically, for
+// each physical link there is one IPv6 subnet that the server is expected
+// to manage. However, in some cases there is a need to configure more subnets
+// in the same physical location. This may sound odd, as IPv6 is not expected
+// to run out of addresses. However, due to vast address space some deployments
+// experiment with various addressing schemes and later find out that the
+// initial proposal was not best and way to migrate to something else.
+{
+    "Dhcp6": {
+        // Kea is told to listen on eth0 interface only.
+        "interfaces-config": {
+            "interfaces": [ "eth0" ]
+        },
+
+        // You also need to tell where to store lease information.
+        // memfile is the backend that is easiest to set up.
+        "lease-database": {
+            "type": "memfile",
+            "lfc-interval": 3600
+        },
+
+        // It is likely that in your network you'll have a mix of regular,
+        // "plain" subnets and shared networks. It is perfectly valid to mix
+        // them in the same config file.
+        //
+        // This is regular subnet. It's not part of any shared-network.
+        "subnet6": [
+            {
+                "pools": [ { "pool": "2001:db8:2::/80" } ],
+                "subnet": "2001:db8:2::/64",
+                "interface": "eth0"
+            }
+        ],
+
+        // Hhe shared networks definition starts here. shared-networks can
+        // contain a list of shared networks. There are many parameters
+        // that can be specified here, so this example may be overwhelming
+        // at first, but the only mandatory parameter for each shared
+        // network is name. It must be unique. Typically, each shared
+        // network also needs to have at least two subnets to be functional,
+        // but if you really want to, you can define a degraded shared
+        // network that has 1 or even 0 subnets. This may come in handy
+        // when migrating between regular subnets and shared networks
+        // or when debugging a problem. It is not recommended to use
+        // 1 subnet per shared network, as there is extra processing
+        // overhead for shared networks.
+        "shared-networks": [
+        {
+            "interface": "eth1",
+
+            // Similar to regular subnets, it is forbidden to define both
+            // interface and interface-id at the same time. That's because
+            // interface parameter expresses physical network interface
+            // for links available locally and interface-id identifies
+            // values inserted by relays, which are only used for
+            // remote traffic. A shared network cannot be both direct
+            // and relayed.
+            //"interface-id": "content of the option",
+
+            // Other parameters defined here will be inherited by the
+            // subnets.
+            "name": "frog",
+            "option-data": [ ],
+            "preferred-lifetime": 200,
+            "rapid-commit": true,
+            "rebind-timer": 150,
+            "relay": {
+                "ip-address": "2001:db8::1"
+            },
+            "renew-timer": 100,
+
+            // "reservation-mode": "all",
+            // It is replaced by the "reservations-global",
+            // "reservations-in-subnet" and "reservations-out-of-pool"
+            // parameters.
+
+            // Specify if server should lookup global reservations.
+            "reservations-global": false,
+
+            // Specify if server should lookup in-subnet reservations.
+            "reservations-in-subnet": true,
+
+            // Specify if server can assume that all reserved addresses
+            // are out-of-pool.
+            // Ignored when reservations-in-subnet is false.
+            // If specified, it is inherited by "subnet6" levels.
+            "reservations-out-of-pool": false,
+
+            // List of subnets belonging to this particular shared-network
+            // start here.
+            "subnet6": [
+
+                // This is the first subnet.
+                {
+                    "preferred-lifetime": 30,
+                    "rapid-commit": false,
+                    "rebind-timer": 20,
+                    // It is possible to override some values here.
+                    "relay": {
+                        "ip-address": "2001:db8:1::123"
+                    },
+                    "renew-timer": 10,
+                    // "reservation-mode": "all",
+                    // It is replaced by the "reservations-global",
+                    // "reservations-in-subnet" and "reservations-out-of-pool"
+                    // parameters.
+                    // Specify if server should lookup global reservations.
+                    "reservations-global": false,
+                    // Specify if server should lookup in-subnet reservations.
+                    "reservations-in-subnet": true,
+                    // Specify if server can assume that all reserved addresses
+                    // are out-of-pool.
+                    // Ignored when reservations-in-subnet is false.
+                    "reservations-out-of-pool": false,
+                    "subnet": "2001:db8:1::/64",
+                    "pools": [ { "pool": "2001:db8:1:0:abcd::/80" } ],
+                    "valid-lifetime": 40
+                },
+
+                // This is the second subnet.
+                {
+                    "preferred-lifetime": 30,
+                    "pools": [ { "pool": "3000:db8::/64" } ],
+                    "rapid-commit": false,
+                    "rebind-timer": 20,
+                    "relay": {
+                        "ip-address": "3000::1"
+                    },
+                    "renew-timer": 10,
+                    // "reservation-mode": "all",
+                    // It is replaced by the "reservations-global",
+                    // "reservations-in-subnet" and "reservations-out-of-pool"
+                    // parameters.
+                    // Specify if server should lookup global reservations.
+                    "reservations-global": false,
+                    // Specify if server should lookup in-subnet reservations.
+                    "reservations-in-subnet": true,
+                    // Specify if server can assume that all reserved addresses
+                    // are out-of-pool.
+                    // Ignored when reservations-in-subnet is false.
+                    "reservations-out-of-pool": false,
+                    "subnet": "3000::/16",
+                    "valid-lifetime": 40
+                }
+            ],
+            "valid-lifetime": 300
+        } ]
+    }
+}
diff --git a/doc/examples/kea6/simple.json b/doc/examples/kea6/simple.json
new file mode 100644
index 0000000..acd3499
--- /dev/null
+++ b/doc/examples/kea6/simple.json
@@ -0,0 +1,62 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It's a basic scenario with one IPv6 subnet configured. It is
+// assumed that one subnet (2001:db8:1::/64 is available directly
+// over eth0 interface.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout. Alternatively, you can specify stderr here, a filename
+// or 'syslog', which will store output messages via syslog.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/softwire46.json b/doc/examples/kea6/softwire46.json
new file mode 100644
index 0000000..85d1d0c
--- /dev/null
+++ b/doc/examples/kea6/softwire46.json
@@ -0,0 +1,89 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It demonstrates how user can specify values for Softwire options
+// defined in RFC 7598 for Lightweight 4over6 architecture.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// Let's use a Memfile backend to store leases.
+  "lease-database": {
+    "type": "memfile"
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0",
+// Include MAP-E Container option for hosts connected to this subnet.
+      "option-data": [
+        {
+            "name": "s46-cont-mape"
+        }
+      ],
+// Send host specific softwire options.
+      "reservations": [
+        {
+            "duid": "01:02:03:04:05:06:07:08:09:0A",
+            "option-data": [
+// These two options will be included in the MAP-E Container
+              {
+                "space": "s46-cont-mape-options",
+                "name": "s46-rule",
+                "data": "1, 0, 24, 192.0.2.0, 2001:db8:1::/64"
+              },
+              {
+                "space": "s46-cont-mape-options",
+                "name": "s46-br",
+                "data": "2001:db8:cafe::1"
+              },
+// This option will be included in the S46 Rule option. It includes
+// PSID/PSID length value in a user friendly form. The PSID length
+// specifies the number of bits on which PSID is coded. The PSID
+// value 3 is a 4th value that is coded on these 4 bits: "0011b".
+              {
+                "space": "s46-rule-options",
+                "name": "s46-portparams",
+                "data": "0, 3/4"
+              }
+            ]
+        }
+      ]
+    }
+  ],
+
+// The following configures logging. Kea will log all debug messages
+// to /var/log/kea-debug.log file.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "/var/log/kea-debug.log"
+                }
+            ],
+            "debuglevel": 99,
+            "severity": "DEBUG"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/stateless.json b/doc/examples/kea6/stateless.json
new file mode 100644
index 0000000..bbe1a84
--- /dev/null
+++ b/doc/examples/kea6/stateless.json
@@ -0,0 +1,29 @@
+// A very simply stateless configuration that provides information about DNS
+// servers to all clients, regardless of their point of attachment.
+//
+// It is also possible to specify options on a per subnet basis
+// in the same way as in stateful mode.
+//
+
+{
+"Dhcp6": {
+    "interfaces-config": {
+        "interfaces": [ "eth0" ]
+    },
+
+// This is the list of options that will be granted to all clients that ask.
+    "option-data": [ {
+        "name": "dns-servers",
+        "data": "2001:db8::1, 2001:db8::2"
+    } ],
+
+// Kea 0.9.1 requires lease-database to be specified, even it is not used.
+// In stateless mode, only options are granted, not addresses or
+// prefixes, so there will be no leases (unless stateless and stateful
+// mode is used together).
+    "lease-database": {
+        "type": "memfile",
+        "lfc-interval": 3600
+    }
+}
+}
diff --git a/doc/examples/kea6/tee-times.json b/doc/examples/kea6/tee-times.json
new file mode 100644
index 0000000..e6a21af
--- /dev/null
+++ b/doc/examples/kea6/tee-times.json
@@ -0,0 +1,70 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It's a basic scenario with three IPv6 subnets use different
+// methods for determining T1 and T2 values.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+    "type": "memfile"
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively.  By default calculate-tee-times
+// is true with values of .5 and .8 for t1-percent and t2-percent
+// respectively.  Since some of our subnets will use calculated values and
+// we must NOT specify global values for renew-timer and rebind-timer.
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+  {
+        //  This subnet use default calculation
+        "subnet": "2001:db8:1::/64",
+        "pools": [ { "pool": "2001:db8:1::/80" } ]
+  },
+  {
+        // This subnet will use explicit values. Explicit
+        // values override calculation.
+       "subnet": "2001:db8:2::/64",
+       "pools": [ { "pool": "2001:db8:2::/80" } ],
+       "renew-timer":  1000,
+       "rebind-timer": 2000
+  },
+  {
+        // This subnet will use custom percents
+       "subnet": "2001:db8:3::/64",
+       "pools": [ { "pool": "2001:db8:3::/80" } ],
+       "t1-percent": .45,
+       "t2-percent": .7
+  }],
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}
diff --git a/doc/examples/kea6/with-ddns.json b/doc/examples/kea6/with-ddns.json
new file mode 100644
index 0000000..04efb7d
--- /dev/null
+++ b/doc/examples/kea6/with-ddns.json
@@ -0,0 +1,87 @@
+// This is an example configuration file for DHCPv6 server in Kea.
+// It's a basic scenario with one IPv6 subnet configured. It is
+// assumed that one subnet (2001:db8:1::/64 is available directly
+// over eth0 interface.
+
+{ "Dhcp6":
+
+{
+// Kea is told to listen on eth0 interface only.
+  "interfaces-config": {
+    "interfaces": [ "eth0" ]
+  },
+
+// We need to specify the database used to store leases. As of
+// June 2022, three database backends are supported: MySQL,
+// PostgreSQL and the in-memory database, Memfile.
+// We'll use memfile  because it doesn't require any prior set up.
+  "lease-database": {
+      "type": "memfile",
+      "lfc-interval": 3600
+  },
+
+// Addresses will be assigned with preferred and valid lifetimes
+// being 3000 and 4000, respectively. Client is told to start
+// renewing after 1000 seconds. If the server does not respond
+// after 2000 seconds since the lease was granted, client is supposed
+// to start REBIND procedure (emergency renewal that allows switching
+// to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+// The following list defines subnets. Each subnet consists of at
+// least subnet and pool entries.
+  "subnet6": [
+    {
+      "pools": [ { "pool": "2001:db8:1::/80" } ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ],
+
+// Enable connectivity with kea-dhcp-ddns
+// (Required for dynamic DNS updates)
+  "dhcp-ddns" : {
+        "enable-updates" : true,
+        "server-ip" : "3001::1",
+        "server-port" : 3432,
+        "sender-ip" : "3001::2",
+        "sender-port" : 3433,
+        "max-queue-size" : 2048,
+        "ncr-protocol" : "UDP",
+        "ncr-format" : "JSON"
+  },
+
+
+// Enable DDNS updates and configure DDNS update behavior
+  "ddns-send-updates" : true,
+  "ddns-override-no-update" : true,
+  "ddns-override-client-update" : true,
+  "ddns-replace-client-name" : "when-present",
+  "ddns-generated-prefix" : "test.prefix",
+  "ddns-qualifying-suffix" : "test.suffix.",
+  "ddns-update-on-renew" : false,
+  "ddns-use-conflict-resolution" : true,
+  "hostname-char-set": "[^A-Za-z0-9.-]",
+  "hostname-char-replacement": "x",
+
+// The following configures logging. It assumes that messages with at
+// least informational level (info, warn, error and fatal) should be
+// logged to stdout.
+    "loggers": [
+        {
+            "name": "kea-dhcp6",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "debuglevel": 0,
+            "severity": "INFO"
+        }
+    ]
+}
+
+}