{
    "access": "read",
    "avail": "1.7.1",
    "brief": [
        "This command retrieves all IPv4 leases with the specified hardware address."
    ],
    "cmd-syntax": [
        "{",
        "    \"command\": \"lease4-get-by-hw-address\",",
        "    \"arguments\": {",
        "        \"hw-address\": \"00:0c:01:02:03:04\"",
        "    }",
        "}"
    ],
    "description": "See <xref linkend=\"command-lease4-get-by-hw-address\"/>",
    "hook": "lease_cmds",
    "name": "lease4-get-by-hw-address",
    "resp-comment": [
        "Result 0 is returned when at least one lease is found, 1 when parameters are malformed or missing,",
        "3 is returned if no leases are found."
    ],
    "resp-syntax": [
        "  {",
        "    \"arguments\": {",
        "      \"leases\": [",
        "        {",
        "          \"client-id\": \"01:00:0c:01:02:03:04\",",
        "          \"cltt\": 1600432232,",
        "          \"fqdn-fwd\": false,",
        "          \"fqdn-rev\": false,",
        "          \"hostname\": \"myhost.example.com.\",",
        "          \"hw-address\": \"00:0c:01:02:03:04\",",
        "          \"ip-address\": \"192.168.1.150\",",
        "          \"state\": 0,",
        "          \"subnet-id\": 1,",
        "          \"valid-lft\": 4000",
        "        }",
        "      ]",
        "    },",
        "    \"result\": 0,",
        "    \"text\": \"1 IPv4 lease(s) found.\"",
        "  }"
    ],

    "support": [
        "kea-dhcp4"
    ]
}