AdGuardHome/internal/dhcpd
Eugene Burkov 20531de760 Pull request: Pull request: 4884 Update golibs
Merge in DNS/adguard-home from 4884-upd-golibs to master

Updates #4884.

Squashed commit of the following:

commit 4d076021c2e500a75d0b3662643c0c26fd53f6c3
Merge: d780ad00 91dee098
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Feb 21 16:47:08 2023 +0300

    Merge branch 'master' into 4884-upd-golibs

commit d780ad008b8925a1f499d70f827b79be597c60b5
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Feb 21 14:17:11 2023 +0300

    dnsforward: imp tests

commit ff9963da35d0220af461cdec66a38134f85ec956
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Feb 21 13:50:05 2023 +0300

    all: log changes

commit 5703f7a52a364c2d075ed2d862a38587c2650cae
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Feb 21 13:36:43 2023 +0300

    all: upd golibs and fix breaking changes
2023-02-21 16:52:33 +03:00
..
README.md Pull request: * all: move internal Go packages to internal/ 2020-10-30 13:32:02 +03:00
bitset.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +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: 4944-dhcp-creation 2022-11-25 18:21:25 +03:00
conn_unix.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
conn_unix_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
db.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
dhcpd.go Pull request: 4944-dhcp-creation 2022-11-25 18:21:25 +03:00
dhcpd_unix_test.go Pull request: imp-tests 2022-10-27 16:11:36 +03:00
http_unix.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +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: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
iprange_test.go Pull request: use testutil 2021-10-22 11:58:18 +03:00
options_unix.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
options_unix_test.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
os_windows.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
routeradv.go Pull request: upd-fmt 2022-08-31 18:57:02 +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: Pull request: 4884 Update golibs 2023-02-21 16:52:33 +03:00
v4_unix_test.go Pull request: Pull request: 4884 Update golibs 2023-02-21 16:52:33 +03:00
v6_unix.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
v6_unix_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
v46_windows.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00

README.md

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