summaryrefslogtreecommitdiff
path: root/docs/configuration/service
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2021-09-19 11:23:49 +0200
committerChristian Poessinger <christian@poessinger.com>2021-09-19 11:23:49 +0200
commit7dca0ecce5ad199083afd99e9ac0cd1dffa2921f (patch)
tree3d6d55e4a283051efdf39103a14ac9d7bd859043 /docs/configuration/service
parentda8e41c20f6a30647272ba37a9c550565a90d84e (diff)
downloadvyos-documentation-7dca0ecce5ad199083afd99e9ac0cd1dffa2921f.tar.gz
vyos-documentation-7dca0ecce5ad199083afd99e9ac0cd1dffa2921f.zip
dhcp: T3841: add ping-check option
Diffstat (limited to 'docs/configuration/service')
-rw-r--r--docs/configuration/service/dhcp-server.rst31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/configuration/service/dhcp-server.rst b/docs/configuration/service/dhcp-server.rst
index db1ad8f2..c3fcd698 100644
--- a/docs/configuration/service/dhcp-server.rst
+++ b/docs/configuration/service/dhcp-server.rst
@@ -39,6 +39,21 @@ Configuration
Multiple DNS servers can be defined.
+.. cfgcmd:: set service dhcp-server shared-network-name <name> ping-check
+
+ When the DHCP server is considering dynamically allocating an IP address to a
+ client, it first sends an ICMP Echo request (a ping) to the address being
+ assigned. It waits for a second, and if no ICMP Echo response has been heard,
+ it assigns the address.
+
+ If a response is heard, the lease is abandoned, and the server does not
+ respond to the client. The lease will remain abandoned for a minimum of
+ abandon-lease-time seconds (defaults to 24 hours).
+
+ If a there are no free addressses but there are abandoned IP addresses, the
+ DHCP server will attempt to reclaim an abandoned IP address regardless of the
+ value of abandon-lease-time.
+
Individual Client Subnet
-------------------------
@@ -105,6 +120,22 @@ Individual Client Subnet
request where no full FQDN is passed. This option can be given multiple times
if you need multiple search domains (DHCP Option 119).
+.. cfgcmd:: set service dhcp-server shared-network-name <name> subnet <subnet>
+ ping-check
+
+ When the DHCP server is considering dynamically allocating an IP address to a
+ client, it first sends an ICMP Echo request (a ping) to the address being
+ assigned. It waits for a second, and if no ICMP Echo response has been heard,
+ it assigns the address.
+
+ If a response is heard, the lease is abandoned, and the server does not
+ respond to the client. The lease will remain abandoned for a minimum of
+ abandon-lease-time seconds (defaults to 24 hours).
+
+ If a there are no free addressses but there are abandoned IP addresses, the
+ DHCP server will attempt to reclaim an abandoned IP address regardless of the
+ value of abandon-lease-time.
+
Failover
--------