# list of api files that are used to generate api.rst
api_files1=$(shell cat api-files.txt)
api_files=$(foreach af,$(api_files1), $(srcdir)/$(af))
+api_files+=$(srcdir)/api/remote-option4-network-del.json
+api_files+=$(srcdir)/api/remote-option4-network-set.json
+api_files+=$(srcdir)/api/remote-option4-pool-del.json
+api_files+=$(srcdir)/api/remote-option4-pool-set.json
+api_files+=$(srcdir)/api/remote-option4-subnet-del.json
+api_files+=$(srcdir)/api/remote-option4-subnet-set.json
+api_files+=$(srcdir)/api/remote-option6-network-del.json
+api_files+=$(srcdir)/api/remote-option6-network-set.json
+api_files+=$(srcdir)/api/remote-option6-pd-pool-del.json
+api_files+=$(srcdir)/api/remote-option6-pd-pool-set.json
+api_files+=$(srcdir)/api/remote-option6-pool-del.json
+api_files+=$(srcdir)/api/remote-option6-pool-set.json
+api_files+=$(srcdir)/api/remote-option6-subnet-del.json
+api_files+=$(srcdir)/api/remote-option6-subnet-set.json
EXTRA_DIST += mes-files.txt
EXTRA_DIST += api-files.txt
remote-option6-global-get
remote-option6-global-get-all
remote-option6-global-set
+remote-option4-network-del
+remote-option4-network-set
+remote-option4-pool-del
+remote-option4-pool-set
+remote-option4-subnet-del
+remote-option4-subnet-set
+remote-option6-network-del
+remote-option6-network-set
+remote-option6-pd-pool-del
+remote-option6-pd-pool-set
+remote-option6-pool-del
+remote-option6-pool-set
+remote-option6-subnet-del
+remote-option6-subnet-set
remote-server4-del
remote-server4-get
remote-server4-get-all
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv4 shared network option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly one name of the shared network and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option4-network-del\",",
+ " \"arguments\": {",
+ " \"shared-networks\": [",
+ " {",
+ " \"name\": <shared network name>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option4-network-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv4 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv4 shared network option in the configuration database."
+ ],
+ "cmd-comment": [
+ "The provided lists must contain exactly one name of the shared network and one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option4-network-set\",",
+ " \"arguments\": {",
+ " \"arguments\": {",
+ " \"shared-networks\": [",
+ " {",
+ " \"name\": <shared network name>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <shared network option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option4-network-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv4 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv4 address pool option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly address pool specification and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option4-pool-del\",",
+ " \"arguments\": {",
+ " \"pools\": [",
+ " {",
+ " \"pool\": <pool range or prefix>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option4-pool-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv4 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv4 address pool option in the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly address pool specification and exactly one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option4-pool-set\",",
+ " \"arguments\": {",
+ " \"pools\": [",
+ " {",
+ " \"pool\": <pool range or prefix>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <address pool option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option4-pool-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv4 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv4 subnet option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly one ID of the subnet and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option4-subnet-del\",",
+ " \"arguments\": {",
+ " \"subnets\": [",
+ " {",
+ " \"id\": <subnet identifier>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option4-subnet-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv4 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv4 subnet option in the configuration database."
+ ],
+ "cmd-comment": [
+ "The provided lists must contain exactly one ID of the subnet and one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option4-subnet-set\",",
+ " \"arguments\": {",
+ " \"subnets\": [",
+ " {",
+ " \"id\": <subnet identifier>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <subnet option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option4-subnet-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv4 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp4"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv6 shared network option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly one name of the shared network and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-network-del\",",
+ " \"arguments\": {",
+ " \"shared-networks\": [",
+ " {",
+ " \"name\": <shared network name>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-network-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv6 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv6 shared network option in the configuration database."
+ ],
+ "cmd-comment": [
+ "The provided lists must contain exactly one name of the shared network and one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-network-set\",",
+ " \"arguments\": {",
+ " \"arguments\": {",
+ " \"shared-networks\": [",
+ " {",
+ " \"name\": <shared network name>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <shared network option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-network-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv6 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv6 prefix delegation pool option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly prefix delegation pool specification and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-pd-pool-del\",",
+ " \"arguments\": {",
+ " \"pd-pools\": [",
+ " {",
+ " \"prefix\": <pool prefix (address part)>",
+ " \"prefix-len\": <pool prefix (length part)>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-pd-pool-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv6 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv6 prefix delegation pool option in the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly prefix delegation pool specification and exactly one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-pd-pool-set\",",
+ " \"arguments\": {",
+ " \"pd-pools\": [",
+ " {",
+ " \"prefix\": <pool prefix (address part)>",
+ " \"prefix-len\": <pool prefix (length part)>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <prefix delegation pool option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-pd-pool-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv6 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv6 address pool option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly address pool specification and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-pool-del\",",
+ " \"arguments\": {",
+ " \"pools\": [",
+ " {",
+ " \"pool\": <pool range or prefix>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-pool-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv6 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv6 address pool option in the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly address pool specification and exactly one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-pool-set\",",
+ " \"arguments\": {",
+ " \"pools\": [",
+ " {",
+ " \"pool\": <pool range or prefix>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <address pool option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-pool-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv6 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command deletes a DHCPv6 subnet option from the configuration database."
+ ],
+ "cmd-comment": [
+ "This command includes two lists with exactly one ID of the subnet and exactly one option specification, comprising an option name and code. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-subnet-del\",",
+ " \"arguments\": {",
+ " \"subnets\": [",
+ " {",
+ " \"id\": <subnet identifier>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-subnet-del",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"1 DHCPv6 option(s) deleted.\",",
+ " \"arguments\": {",
+ " \"count\": 1",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
--- /dev/null
+{
+ "avail": "1.6.0",
+ "brief": [
+ "This command creates or replaces a DHCPv6 subnet option in the configuration database."
+ ],
+ "cmd-comment": [
+ "The provided lists must contain exactly one ID of the subnet and one option specification. Specifying an empty list, a value of ``null``, or a server tag will result in an error."
+ ],
+ "cmd-syntax": [
+ "{",
+ " \"command\": \"remote-option6-subnet-set\",",
+ " \"arguments\": {",
+ " \"subnets\": [",
+ " {",
+ " \"id\": <subnet identifier>",
+ " }",
+ " ],",
+ " \"options\": [",
+ " {",
+ " <subnet option specification>",
+ " }",
+ " ],",
+ " \"remote\": {",
+ " <specification of the database to connect to>",
+ " }",
+ " }",
+ "}"
+ ],
+ "hook": "cb_cmds",
+ "name": "remote-option6-subnet-set",
+ "resp-syntax": [
+ "{",
+ " \"result\": 0,",
+ " \"text\": \"DHCPv6 option successfully set.\",",
+ " \"arguments\": {",
+ " \"options\": [",
+ " {",
+ " \"code\": <option code>,",
+ " \"space\": <option space>",
+ " }",
+ " ]",
+ " }",
+ "}"
+ ],
+ "support": [
+ "kea-dhcp6"
+ ]
+}
specified for the updated subnet instance. Any unspecified parameter
will be marked as unspecified in the database, even if its value was
present prior to sending the command.
+
+The Embedded Option Commands
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+These commands are used to create, replace or delete an option embedded
+in an IPv4 or IPv6 shared network, subnet, address pool, or IPv6 prefix
+delegation pool.
+
+.. _command-remote-option4-network-del:
+.. _command-remote-option4-network-set:
+.. _command-remote-option4-pool-del:
+.. _command-remote-option4-pool-set:
+.. _command-remote-option4-subnet-del:
+.. _command-remote-option4-subnet-set:
+.. _command-remote-option6-network-del:
+.. _command-remote-option6-network-set:
+.. _command-remote-option6-pd-pool-del:
+.. _command-remote-option6-pd-pool-set:
+.. _command-remote-option6-pool-del:
+.. _command-remote-option6-pool-set:
+.. _command-remote-option6-subnet-del:
+.. _command-remote-option6-subnet-set:
+