]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#882] Added lease[46]-get-page api doc
authorFrancis Dupont <fdupont@isc.org>
Mon, 30 Mar 2020 16:50:37 +0000 (18:50 +0200)
committerFrancis Dupont <fdupont@isc.org>
Tue, 7 Apr 2020 13:24:54 +0000 (13:24 +0000)
doc/sphinx/api-files.txt
doc/sphinx/api/cmds-list
doc/sphinx/api/lease4-get-page.json [new file with mode: 0644]
doc/sphinx/api/lease6-get-page.json [new file with mode: 0644]
doc/sphinx/arm/hooks-ha.rst
doc/sphinx/arm/hooks-lease-cmds.rst

index 162290108905d6e950aaf226a1e4c73e534a0f8d..77225b34b5a8dcbc65e2ab8de1427a863cf63eeb 100644 (file)
@@ -33,6 +33,7 @@ api/lease4-get-all.json
 api/lease4-get-by-client-id.json
 api/lease4-get-by-hostname.json
 api/lease4-get-by-hw-address.json
+api/lease4-get-page.json
 api/lease4-get.json
 api/lease4-update.json
 api/lease4-wipe.json
@@ -43,6 +44,7 @@ api/lease6-del.json
 api/lease6-get-all.json
 api/lease6-get-by-duid.json
 api/lease6-get-by-hostname.json
+api/lease6-get-page.json
 api/lease6-get.json
 api/lease6-update.json
 api/lease6-wipe.json
index 476a92fc0bba187bd16c2eb6c12a07f1bf46b8e3..34d0623b2273f68c4b7b00a74c2677994c4a00c6 100644 (file)
@@ -30,6 +30,7 @@ lease4-add
 lease4-del
 lease4-get
 lease4-get-all
+lease4-get-page
 lease4-update
 lease4-wipe
 lease6-add
@@ -37,6 +38,7 @@ lease6-bulk-apply
 lease6-del
 lease6-get
 lease6-get-all
+lease6-get-page
 lease6-update
 lease6-wipe
 lease4-resend-ddns
diff --git a/doc/sphinx/api/lease4-get-page.json b/doc/sphinx/api/lease4-get-page.json
new file mode 100644 (file)
index 0000000..960c87d
--- /dev/null
@@ -0,0 +1,24 @@
+{
+    "avail": "1.5.0",
+    "brief": [
+        "This command retrieves all IPv4 leases by page."
+    ],
+    "cmd-comment": [
+        "The from address and the page size limit are mandatory."
+    ],
+    "cmd-syntax": [
+        "{",
+        "    \"command\": \"lease4-get-page\",",
+        "    \"arguments\": {",
+        "        \"limit\": <integer>,",
+        "        \"from\": <IPv4 address or start>",
+        "    }",
+        "}"
+    ],
+    "description": "See <xref linkend=\"command-lease4-get-page\"/>",
+    "hook": "lease_cmds",
+    "name": "lease4-get-page",
+    "support": [
+        "kea-dhcp4"
+    ]
+}
diff --git a/doc/sphinx/api/lease6-get-page.json b/doc/sphinx/api/lease6-get-page.json
new file mode 100644 (file)
index 0000000..0e6c1c9
--- /dev/null
@@ -0,0 +1,23 @@
+{
+    "avail": "1.5.0",
+    "brief": [
+        "This command retrieves all IPv6 leases by page."
+    ],
+    "cmd-comment": [
+        "The from address and the page size limit are mandatory."
+    ],
+    "cmd-syntax": [
+        "{",
+        "    \"command\": \"lease6-get-page\",",
+        "    \"arguments\": {",
+        "        \"limit\": <integer>,",
+        "        \"from\": <IPv6 address or start>",
+        "    }",
+        "}"
+    ],
+    "hook": "lease_cmds",
+    "name": "lease6-get-page",
+    "support": [
+        "kea-dhcp6"
+    ]
+}
index c9f191ad5cb7313f6c7ec15938291063cb6c0d37..e874a1da0adea3790b0f98556a6a90eaa4e18702 100644 (file)
@@ -814,7 +814,8 @@ Controlling Lease-Page Size Limit
 
 An HA-enabled server initiates synchronization of the lease database
 after downtime or upon receiving the ``ha-sync`` command. The server
-uses commands described in :ref:`lease-get-page-cmds` to fetch
+uses commands described in :ref:`command-lease4-get-page` and
+:ref:`command-lease6-get-page` to fetch
 leases from its partner server (lease queries). The size of the results
 page (the maximum number of leases to be returned in a single response
 to one of these commands) can be controlled via configuration of the HA hooks
index ded3ec4bc663c70e0899b4469b699fa78765e628..f801e2b9b59f5c5b57f6e0ba08c275253251967b 100644 (file)
@@ -588,7 +588,9 @@ following format:
    restriction on the number of leases returned as a result of this
    command.
 
-.. _lease-get-page-cmds:
+.. _command-lease4-get-page:
+
+.. _command-lease6-get-page:
 
 The lease4-get-page, lease6-get-page Commands
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~