fastdialer

Documentation

Overview

fastdialer is a dialer package containing a dns/tls cache layer

Index

• Constants
• Variables
• func HandleHostLine(raw string) (ip string, hosts []string)
• func HandleResolverLine(raw string) (ip string)
• func HasComment(raw string) bool
• func IsComment(raw string) bool
• type CacheType
• type Dialer
  • func NewDialer(options Options) (*Dialer, error)
  • func (d *Dialer) Close()
  • func (d *Dialer) Dial(ctx context.Context, network, address string) (conn net.Conn, err error)
  • func (d *Dialer) DialTLS(ctx context.Context, network, address string) (conn net.Conn, err error)
  • func (d *Dialer) DialTLSWithConfig(ctx context.Context, network, address string, config *tls.Config) (conn net.Conn, err error)
  • func (d *Dialer) GetDNSData(hostname string) (*retryabledns.DNSData, error)
  • func (d *Dialer) GetDNSDataFromCache(hostname string) (*retryabledns.DNSData, error)
  • func (d *Dialer) GetDialedIP(hostname string) string
  • func (d *Dialer) GetTLSData(hostname string) (*cryptoutil.TLSData, error)
• type DiskDBType
• type NoAddressAllowedError
  • func (m *NoAddressAllowedError) Error() string
• type NoAddressFoundError
  • func (m *NoAddressFoundError) Error() string
• type Options

Constants

const HostsFilePath = "/etc/hosts"

HostsFilePath in unix file os

const ResolverFilePath = "/etc/resolv.conf"

ResolverFilePath in unix file os

Variables

var DefaultOptions = Options{
	BaseResolvers:   DefaultResolvers,
	MaxRetries:      5,
	HostsFile:       true,
	ResolversFile:   true,
	CacheType:       Disk,
	DialerTimeout:   10 * time.Second,
	DialerKeepAlive: 10 * time.Second,
}

DefaultOptions of the cache

var DefaultResolvers = []string{
	"1.1.1.1:53",
	"1.0.0.1:53",
	"8.8.8.8:53",
	"8.8.4.4:53",
}

DefaultResolvers trusted

Functions

func HandleHostLine

func HandleHostLine(raw string) (ip string, hosts []string)

HandleHostLine a hosts file line

func HandleResolverLine

func HandleResolverLine(raw string) (ip string)

HandleLine a resolver file line

func HasComment

func HasComment(raw string) bool

HasComment check if the line has a comment

func IsComment

func IsComment(raw string) bool

IsComment check if the file is a comment

Types

type CacheType

type CacheType uint8

const (
	Memory CacheType = iota
	Disk
	Hybrid
)

type Dialer

type Dialer struct {
	// contains filtered or unexported fields
}

Dialer structure containing data information

func NewDialer

func NewDialer(options Options) (*Dialer, error)

NewDialer instance

func (*Dialer) Close

func (d *Dialer) Close()

Close instance and cleanups

func (*Dialer) Dial

func (d *Dialer) Dial(ctx context.Context, network, address string) (conn net.Conn, err error)

Dial function compatible with net/http

func (*Dialer) DialTLS

func (d *Dialer) DialTLS(ctx context.Context, network, address string) (conn net.Conn, err error)

DialTLS with encrypted connection

func (*Dialer) DialTLSWithConfig

func (d *Dialer) DialTLSWithConfig(ctx context.Context, network, address string, config *tls.Config) (conn net.Conn, err error)

DialTLS with encrypted connection

func (*Dialer) GetDNSData

func (d *Dialer) GetDNSData(hostname string) (*retryabledns.DNSData, error)

GetDNSData for the given hostname

func (*Dialer) GetDNSDataFromCache

func (d *Dialer) GetDNSDataFromCache(hostname string) (*retryabledns.DNSData, error)

GetDNSDataFromCache cached by the resolver

func (*Dialer) GetDialedIP

func (d *Dialer) GetDialedIP(hostname string) string

GetDialedIP returns the ip dialed by the HTTP client

func (*Dialer) GetTLSData

func (d *Dialer) GetTLSData(hostname string) (*cryptoutil.TLSData, error)

GetTLSData returns the tls data for a hostname

type DiskDBType

type DiskDBType uint8

const (
	LevelDB DiskDBType = iota
	Pogreb
)

type NoAddressAllowedError

type NoAddressAllowedError struct{}

func (*NoAddressAllowedError) Error

func (m *NoAddressAllowedError) Error() string

type NoAddressFoundError

type NoAddressFoundError struct{}

func (*NoAddressFoundError) Error

func (m *NoAddressFoundError) Error() string

type Options

type Options struct {
	BaseResolvers       []string
	MaxRetries          int
	HostsFile           bool
	ResolversFile       bool
	EnableFallback      bool
	Allow               []string
	Deny                []string
	CacheType           CacheType
	CacheMemoryMaxItems int // used by Memory cache type
	DiskDbType          DiskDBType
	WithDialerHistory   bool
	WithCleanup         bool
	WithTLSData         bool
	DialerTimeout       time.Duration
	DialerKeepAlive     time.Duration
	Dialer              *net.Dialer
}