AdGuardHome/internal/dhcpd
Ainar Garipov d4a4bda645 Pull request 1897: nextapi-write-conf
Squashed commit of the following:

commit 72f25ffe73d6b8216b01e590fba66fb5f6944113
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Wed Jun 28 21:29:04 2023 +0300

    next: add conf writing, validation
2023-06-29 14:34:06 +03:00
..
README.md Pull request: dhcpd imp code 2023-05-26 12:50:03 +03:00
bitset.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
bitset_test.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
broadcast_bsd.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
broadcast_bsd_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
broadcast_others.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
broadcast_others_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
config.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
conn_bsd.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
conn_bsd_internal_test.go Pull request 1856: fix-dhcpd-tags 2023-05-26 12:31:55 +03:00
conn_linux.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
conn_linux_internal_test.go Pull request 1856: fix-dhcpd-tags 2023-05-26 12:31:55 +03:00
db.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
dhcpd.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
dhcpd_unix_test.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
http_unix.go Pull request: dhcpd imp code 2023-05-26 12:50:03 +03:00
http_unix_test.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
http_windows.go Pull request: imp-json-resp 2022-10-04 14:35:10 +03:00
http_windows_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
iprange.go Pull request 1771: AG-20352-dhcpd-lease-netip-addr 2023-03-23 16:52:01 +03:00
iprange_test.go Pull request: use testutil 2021-10-22 11:58:18 +03:00
migrate.go Pull request 1897: nextapi-write-conf 2023-06-29 14:34:06 +03:00
migrate_internal_test.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
options_unix.go Pull request: 5281-dhcp-mtu-opt 2023-03-07 15:49:47 +03:00
options_unix_test.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
routeradv.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
routeradv_test.go Pull request: dhcpd: do not assume mac addrs of 6 bytes 2021-03-31 12:36:57 +03:00
v4_unix.go Pull request: dhcpd imp code 2023-05-26 12:50:03 +03:00
v4_unix_test.go Pull request: dhcpd imp code 2023-05-26 12:50:03 +03:00
v6_unix.go Pull request: dhcpd imp code 2023-05-26 12:50:03 +03:00
v6_unix_test.go Pull request 1845: AG-21324-update-dhcp 2023-05-17 15:16:02 +03:00
v46_windows.go Pull request 1755: imp-home-gocyclo 2023-03-01 13:27:24 +03:00

README.md

Testing DHCP Server

Contents:

Test setup with Virtual Box

Prerequisites

To set up a test environment for DHCP server you will need:

  • Linux AG Home host machine (Virtual).
  • Virtual Box.
  • Virtual machine (guest OS doesn't matter).

Configure Virtual Box

  1. Install Virtual Box and run the following command to create a Host-Only network:

    $ VBoxManage hostonlyif create
    

    You can check its status by ip a command.

    You can also set up Host-Only network using Virtual Box menu:

    File -> Host Network Manager...
    
  2. Create your virtual machine and set up its network:

    VM Settings -> Network -> Host-only Adapter
    
  3. Start your VM, install an OS. Configure your network interface to use DHCP and the OS should ask for a IP address from our DHCP server.

  4. To see the current IP addresses on client OS you can use ip a command on Linux or ipconfig on Windows.

  5. To force the client OS to request an IP from DHCP server again, you can use dhclient on Linux or ipconfig /release on Windows.

Configure server

  1. Edit server configuration file AdGuardHome.yaml, for example:

    dhcp:
         enabled: true
         interface_name: vboxnet0
         local_domain_name: lan
         dhcpv4:
           gateway_ip: 192.168.56.1
           subnet_mask: 255.255.255.0
           range_start: 192.168.56.2
           range_end: 192.168.56.2
           lease_duration: 86400
           icmp_timeout_msec: 1000
           options: []
         dhcpv6:
           range_start: 2001::1
           lease_duration: 86400
           ra_slaac_only: false
           ra_allow_slaac: false
    
  2. Start the server

    ./AdGuardHome -v
    

    There should be a message in log which shows that DHCP server is ready:

    [info] DHCP: listening on 0.0.0.0:67
    

Quick test with DHCPTest utility

Prerequisites

Quick test

The DHCP server could be tested for DISCOVER-OFFER packets with in interactive mode.