AdGuardHome/internal/dhcpd
Eugene Burkov 0d44822c43 Pull request: 2639 use testify require vol.3
Merge in DNS/adguard-home from 2639-testify-require-3 to master

Updates #2639.

Squashed commit of the following:

commit 83d7afcbb7e5393db5a0242f3eaca063710d36b7
Merge: ef154b6d e83b919d
Author: Eugene Burkov <e.burkov@adguard.com>
Date:   Fri Feb 12 13:07:58 2021 +0300

    Merge branch 'master' into 2639-testify-require-3

commit ef154b6d3c89f975ce28369372757a1205baa655
Merge: 5b46073a 2eb21ef4
Author: Eugene Burkov <e.burkov@adguard.com>
Date:   Fri Feb 12 12:40:43 2021 +0300

    Merge branch 'master' into 2639-testify-require-3

commit 5b46073a09badef44c86a5f48c6bb874c8df2674
Merge: 7dd7b6e0 890f0322
Author: Eugene Burkov <e.burkov@adguard.com>
Date:   Wed Feb 10 21:20:51 2021 +0300

    Merge branch 'master' into 2639-testify-require-3

commit 7dd7b6e00ead2bf507af541c801a9ac770106440
Author: Eugene Burkov <e.burkov@adguard.com>
Date:   Wed Feb 10 21:19:36 2021 +0300

    dhcpd: fix comment

commit 9e74adbcf21dad58409c3dfc8e08b6470bfedc22
Author: Eugene Burkov <e.burkov@adguard.com>
Date:   Wed Feb 10 15:13:40 2021 +0300

    all: imp tests drastically
2021-02-12 13:27:44 +03:00
..
nclient4 Pull request: 2574 external tests vol.3 2021-02-04 20:35:13 +03:00
checkother_windows.go Pull request: all: fix lint and naming issues vol. 2 2020-12-07 15:38:05 +03:00
checkother.go Pull request: all: fix lint and naming issues vol. 2 2020-12-07 15:38:05 +03:00
db.go Pull request: dhcpd: fix interface ipv6 check 2020-11-25 14:26:26 +03:00
dhcpd_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
dhcpd.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
dhcphttp_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
dhcphttp.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
helpers.go Pull request: 2508 ip conversion vol.1 2021-01-13 16:56:05 +03:00
nullbool_test.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
nullbool.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
os_windows.go Pull request: * all: move internal Go packages to internal/ 2020-10-30 13:32:02 +03:00
README.md Pull request: * all: move internal Go packages to internal/ 2020-10-30 13:32:02 +03:00
routeradv_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
routeradv.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
server.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
v4_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
v4.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
v6_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
v6.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
v46_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
v46_windows.go Pull request: all: fix lint and naming issues vol. 2 2020-12-07 15:38:05 +03:00
v46.go Pull request: dhcpd: wait for interfaces' ip addresses to appear 2020-11-27 14:39:43 +03:00

DHCP server

Contents:

Test setup with Virtual Box

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

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

Configure client

  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 address 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
       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
    

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

     [info] DHCP: listening on 0.0.0.0:67