AdGuardHome/internal/dhcpd
Stanislav Chzhen d338451faf Pull request 2145: 5992-stats-qlog-custom-dir
Updates #5992.

Squashed commit of the following:

commit 39d3df705ef68672ec9406d81e00daf52a3b3c70
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Mon Feb 12 15:25:22 2024 +0300

    all: fix typo

commit 21e03e4d5a7624a68add53734a127652053845a2
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Mon Feb 12 15:22:35 2024 +0300

    all: upd docs

commit 11180061619f4352774d4bc8c85b481ae28f0d0b
Merge: ac5fd8dc8 7f8370744
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Mon Feb 12 14:57:35 2024 +0300

    Merge branch 'master' into 5992-stats-qlog-custom-dir

commit ac5fd8dc82c9c6e88a182cd6e6aed07bf3548639
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Wed Feb 7 14:55:51 2024 +0300

    all: upd chlog

commit fe00652e158db65e0e735a19cf88aa999ece3e62
Merge: 21ad1ecf7 56b98080f
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Wed Feb 7 14:53:24 2024 +0300

    Merge branch 'master' into 5992-stats-qlog-custom-dir

commit 21ad1ecf7b30c3c8f45d54210d7297966126b0f7
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Wed Feb 7 14:52:12 2024 +0300

    home: imp docs

commit 739b158de77e673ef80efdaa523044939ea879d5
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Mon Feb 5 20:15:50 2024 +0300

    home: add stats qlog custom dir
2024-02-12 18:45:51 +03:00
..
README.md Pull request 1974: 6133-upd-quic-go 2023-08-23 20:10:54 +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 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +03:00
conn_bsd.go Pull request 1962: upd-code-deps 2023-08-15 15:09:08 +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 1962: upd-code-deps 2023-08-15 15:09:08 +03:00
conn_linux_internal_test.go Pull request 1856: fix-dhcpd-tags 2023-05-26 12:31:55 +03:00
conn_unix.go Pull request 1962: upd-code-deps 2023-08-15 15:09:08 +03:00
db.go Pull request 2147: all: upd deps, go, scripts 2024-02-08 20:39:18 +03:00
dhcpd.go Pull request 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +03:00
dhcpd_unix_test.go Pull request 2147: all: upd deps, go, scripts 2024-02-08 20:39:18 +03:00
http_unix.go Pull request 2145: 5992-stats-qlog-custom-dir 2024-02-12 18:45:51 +03:00
http_unix_internal_test.go Pull request 2019: 1700-update-static-lease 2023-10-05 13:54:21 +03:00
http_windows.go Pull request 2019: 1700-update-static-lease 2023-10-05 13:54:21 +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 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +03:00
migrate_internal_test.go Pull request 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +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 2147: all: upd deps, go, scripts 2024-02-08 20:39:18 +03:00
v4_unix_test.go Pull request 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +03:00
v6_unix.go Pull request 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +03:00
v6_unix_test.go Pull request 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +03:00
v46_windows.go Pull request 2070: 4923 gopacket DHCP vol.4 2023-11-16 14:14:40 +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.