dns

README

package dns

This package provides an installer and an implementation of a DNS server that can serve requests for a given list of tlds.

If you configure the server to work with test then any DNS lookup that ends with .test will resolve to localhost. Eg. example.test.

Credits

The majority of the code for this package was extracted from https://github.com/puma/puma-dev.

Documentation

Overview

Example

package main

import (
	"fmt"
	"log"

	"github.com/moomerman/zap/dns"
)

func main() {

	port := 9253
	domains := []string{"test", "dev"}

	if err := dns.ConfigureResolver(domains, port, "example"); err != nil {
		log.Println(err)
		panic("couldn't configure resolver")
	}

	var dns dns.Responder
	dns.Address = fmt.Sprintf("127.0.0.1:%d", port)
	log.Println("* DNSServer", dns.Address)

	dns.Serve(domains)
}

Index

• Constants
• func ConfigureResolver(domains []string, port int, name string) error
• type Responder
  • func (d *Responder) Serve()
  • func (d *Responder) Stop()

Examples

• Package

Constants

const DefaultAddress = ":9253"

DefaultAddress is the default address for the DNS server

Functions

func ConfigureResolver

func ConfigureResolver(domains []string, port int, name string) error

ConfigureResolver configures the system to resolve the domains

Types

type Responder

type Responder struct {
	Address string
	Domains []string
	// contains filtered or unexported fields
}

Responder holds the configuration for the DNS server

func (*Responder) Serve

func (d *Responder) Serve()

Serve starts the DNS server

func (*Responder) Stop

func (d *Responder) Stop()

Stop stops the DNS servers