dns

Documentation

Overview

Example (Client)

package main

import (
	"fmt"

	dnstrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns"

	"github.com/miekg/dns"
)

func main() {
	m := new(dns.Msg)
	m.SetQuestion("miek.nl.", dns.TypeMX)
	// calling dnstrace.Exchange will call dns.Exchange but trace the request
	reply, err := dnstrace.Exchange(m, "127.0.0.1:53")
	fmt.Println(reply, err)
}

Example (Server)

package main

import (
	dnstrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns"

	"github.com/miekg/dns"
)

func main() {
	mux := dns.NewServeMux()
	mux.HandleFunc(".", func(w dns.ResponseWriter, r *dns.Msg) {
		m := new(dns.Msg)
		m.SetReply(r)
		w.WriteMsg(m)
	})
	// calling dnstrace.ListenAndServe will call dns.ListenAndServe but all
	// requests will be traced
	dnstrace.ListenAndServe(":dns", "udp", mux)
}

Index

• func Exchange(m *dns.Msg, addr string) (r *dns.Msg, err error)
• func ExchangeConn(c net.Conn, m *dns.Msg) (r *dns.Msg, err error)
• func ExchangeContext(ctx context.Context, m *dns.Msg, addr string) (r *dns.Msg, err error)
• func ListenAndServe(addr string, network string, handler dns.Handler) error
• func ListenAndServeTLS(addr, certFile, keyFile string, handler dns.Handler) error
• type Client
• type Handler
  • func WrapHandler(handler dns.Handler) *Handler

Examples

• Package (Client)
• Package (Server)

Functions

func Exchange

func Exchange(m *dns.Msg, addr string) (r *dns.Msg, err error)

Exchange calls dns.Exchange and traces the request.

func ExchangeConn

func ExchangeConn(c net.Conn, m *dns.Msg) (r *dns.Msg, err error)

ExchangeConn calls dns.ExchangeConn and traces the request.

func ExchangeContext

func ExchangeContext(ctx context.Context, m *dns.Msg, addr string) (r *dns.Msg, err error)

ExchangeContext calls dns.ExchangeContext and traces the request.

func ListenAndServe

func ListenAndServe(addr string, network string, handler dns.Handler) error

ListenAndServe calls dns.ListenAndServe with a wrapped Handler.

func ListenAndServeTLS

func ListenAndServeTLS(addr, certFile, keyFile string, handler dns.Handler) error

ListenAndServeTLS calls dns.ListenAndServeTLS with a wrapped Handler.

Types

type Client

type Client = v2.Client

A Client wraps a DNS Client so that requests are traced.

type Handler

type Handler = v2.Handler

A Handler wraps a DNS Handler so that requests are traced.

func WrapHandler

func WrapHandler(handler dns.Handler) *Handler

WrapHandler creates a new, wrapped DNS handler.