PERFDHCP(8) Kea PERFDHCP(8) (NAME) perfdhcp - DHCP (SYNOPSIS) perfdhcp [-1] [-4 | -6] [-A encapsulation-level] [-b base] [-B] [-c] [-C separator] [-d drop-time] [-D max-drop] [-e lease-type] [-E time-offset] [-f renew-rate] [-F release-rate] [-g thread-mode] [-h] [-i] [-I ip-offset] [-J remote-address-list-file] [-l local-address|interface] [-L local-port] [-M mac-list-file] [-n num-request] [-N remote-port] [-O random-offset] [-o code,hexstring] [--or encapsulation-level:code,hexstring] [-p test-period] [-P preload] [-r rate] [-R num-clients] [-s seed] [-S srvid-offset] [--scenario name] [-t report] [-T template-file] [-u] [-v] [-W exit-wait-time] [-w script_name] [-x diagnostic-selector] [-X xid-offset] [server] (DESCRIPTION) perfdhcp (benchmarking) DHCP . DHCP . IPv4 IPv6 (dropped) . . ( basic) (DORA DHCPv4 SARR DHCPv6) . (DO SA) . perfdhcp RENEW RELEASE DHCPv6 DHCPv6 . perfdhcp . (avalanche) --scenario avalanche . Discovery Solicit -R ( exponential back-off) . . . DHCP . (avalanche effect) . -p avalanche . perfdhcp -r . : perfdhcp . (TEMPLATES) perfdhcp (template files) . ORO DHCPv6 Client FQDN DNS . ( DDNS) . . DHCPv6: o perfdhcp Solicit Request . o Solicit perfdhcp Request . o Solicit Request . ( DHCPDISCOVER DHCPREQUEST DHCPv4 .) DHCP ASCII IP/UDP . . 12B4 12 B4 1 2 B 4 . . -E time-offset DHCPv6 Elapsed Time . perfdhcp . perfdhcp . ( HW DHCPv4) . -O random-offset . ( ) ( ) . . ( ) . . : (random-offset - 1). . perfdhcp -J v4 v6 (relay) . (shared networks) Kea . DHCPv4 Kea KEA_TEST_SEND_RESPONSES_TO_SOURCE Kea . Solicit Request ( DHCPv6) DHCPDISCOVER DHCPREQUEST ( DHCPv4). Renew DHCPRELEASE . (OPTIONS) -1 server-id . -4 DHCPv4 . -6 . -6 DHCPv6 . -4 . -b basetype=value MAC DUID . basetype "mac" "duid" . ( "ether" MAC .) -b . MAC (:) (::) : mac=00:0c:01:02:03:04. DUID . : duid=0101010101010101010110111F14. -d drop-time . . . -e lease-type (lease) . : address-only (v4 v6) . prefix-only IPv6 . address-and-prefix IPv6 . -e prefix-only -e address-and-prefix -4 . -F release-rate DHCPRELEASE DHCPv4 Release DHCPv6 . ( -r rate) . ( -f rate) . -f renew-rate DHCPREQUEST DHCPv4 Renew DHCPv6 . ( -r rate) . ( -F rate) . -g thread-mode (thread-mode) single multi . . . . -h . -i : -4 DISCOVER-OFFER -6 Solicit-Advertise. -i : -1 -d -D -E -S -I -F. -O -T -X . -J remote-address-list-file . perfdhcp . DHCPv4 KEA_TEST_SEND_RESPONSES_TO_SOURCE=ENABLE perfdhcp . -l local-addr|interface DHCPv4 / . . DHCPv6 . -L local-port . . () perfdhcp . -M mac-list-file MAC ( ) . MAC . DHCPv6 MAC DUID-LL . -b . -N remote-port . . () perfdhcp . -o code,hexstring perfdhcp ( ) . code hexstring . perfdhcp . . ( ) "docsis" -o 60,646f63736973 . -o . (-4 -6) -o . -P preload (preload) . () . -r rate DORA/SARR ( -i DO/SA) . . . -R num-clients . () . . -s seed (seed) perfdhcp . . . --scenario name basic () avalanche . -T template-file . ( "" ). -u . . -v Kea . -V Kea . -W exit-wait-time perfdhcp . . ( ). -w script_name / perfdhcp . "start" "stop" perfdhcp . -x diagnostic-selector . . : a . e . i . l . s (server ID) . t . T . -Y seconds perfdhcp . secs DHCPv4 Elapsed Time DHCPv6 . -y . -y seconds perfdhcp . secs DHCPv4 Elapsed Time DHCPv6 . -Y . DHCPV4 (DHCPV4-ONLY OPTIONS) DHCPv4 ( -4 ). -B (broadcast) . DHCPV6 (DHCPV6-ONLY OPTIONS) DHCPv6 ( -6 ). -c (rapid-commit) ( Solicit-Advertise ). -A encapsulation-level . (relay agent) . . --or encapsulation-level:code,hexstring perfdhcp ( ) DHCPv6 . -o : code hexstring . perfdhcp . encapsulation-level: . ( ) --or 38,31323334 --or 1:38,31323334 . --or -A . (TEMPLATE-RELATED OPTIONS) -T perfdhcp . ( "" ). -E time-offset secs ( DHCPv4) Elapsed Time ( DHCPv6) ( Request) . . -I ip-offset IP ( DHCPv4) requested-ip IA_NA ( DHCPv6) (Request) . -O random-offset . . -T . -S srvid-offset server-id (Request) . (-T) . -X xid-offset (xid) . (-T) . (OPTIONS CONTROLLING A TEST) -D max-drop "max-drop" . -D 1 . "max-drop" . "max-drop" % . . -n num-requests "num-request" . . -p test-period "test-period" -d . -n . -t interval ( ) . -C separator separator . -t -t . (ARGUMENTS) server IP . DHCPv6 all All_DHCP_Relay_Agents_and_Servers ( FF02::1:2) servers All_DHCP_Servers ( FF05::1:3) . -l all . (ERRORS) perfdhcp : tooshort . orphans ( ). locallimit . (EXIT STATUS) perfdhcp : 0 . 1 . 2 . 3 . (USAGE EXAMPLES) DHCPv4 DHCPv4 (-R 100) (-r 10) / (-xi) (-t 2) IP 192.0.2.1 : sudo perfdhcp -xi -t 2 -r 10 -R 100 192.0.2.1 DHCPv6 . DHCPv6 (link-local) ( eth0) . all All_DHCP_Relay_Agents_and_Servers ( FF02::1:2) . servers All_DHCP_Servers ( FF05::1:3) . all . sudo perfdhcp -6 -xi -t 1 -r 1 -R 10 -l eth0 all DHCPv4 DHCPv6 . DHCPv4 secs DHCPv6 Elapsed Time . . (HA) Kea secs Elapsed Time HA . -y -Y secs Elapsed Time . sudo perfdhcp -xi -t 1 -r 1 -y 10 -Y 3 192.0.2.1 sudo perfdhcp -6 -xi -t 1 -r 1 -y 10 -Y 3 2001:db8::1 (DOCUMENTATION) Kea Kea Kea . Kea Kea Kea . (.txt, .html, .pdf) Kea . Kea . Kea Kea . Kea . (MAILING LISTS AND SUPPORT) Kea . kea-users ( kea-users lists.isc.org) Kea kea-dev ( kea-dev lists.isc.org) Kea . . . ISC Kea . . (HISTORY) perfdhcp John DuBois Francis Dupont Marcin Siodelski ISC . Kea 1.0.0 perfdhcp . (SEE ALSO) kea-dhcp4(8), kea-dhcp6(8), kea-dhcp-ddns(8), kea-admin(8), kea-netconf(8), keactrl(8), kea-lfc(8), Kea. (AUTHOR) Internet Systems Consortium (COPYRIGHT) 2019-2026, Internet Systems Consortium 3.2.0 July 9, 2026 PERFDHCP(8)