dns

Documentation

Index

• Variables
• func CheckUncleanShutdown(wgIface string) error
• type DefaultServer
  • func NewDefaultServer(ctx context.Context, wgInterface WGIface, customAddress string, ...) (*DefaultServer, error)
  • func NewDefaultServerIos(ctx context.Context, wgInterface WGIface, iosDnsManager IosDnsManager, ...) *DefaultServer
  • func NewDefaultServerPermanentUpstream(ctx context.Context, wgInterface WGIface, hostsDnsList []string, ...) *DefaultServer
  • func (s *DefaultServer) DnsIP() string
  • func (s *DefaultServer) Initialize() (err error)
  • func (s *DefaultServer) OnUpdatedHostDNSServer(hostsDnsList []string)
  • func (s *DefaultServer) ProbeAvailability()
  • func (s *DefaultServer) SearchDomains() []string
  • func (s *DefaultServer) Stop()
  • func (s *DefaultServer) UpdateDNSServer(serial uint64, update nbdns.Config) error
• type DomainConfig
• type HostDNSConfig
• type IosDnsManager
• type MockServer
  • func (m *MockServer) DnsIP() string
  • func (m *MockServer) Initialize() error
  • func (m *MockServer) OnUpdatedHostDNSServer(strings []string)
  • func (m *MockServer) ProbeAvailability()
  • func (m *MockServer) SearchDomains() []string
  • func (m *MockServer) Stop()
  • func (m *MockServer) UpdateDNSServer(serial uint64, update nbdns.Config) error
• type ReadyListener
• type Server
  • func GetServerDns() (Server, error)
• type UpstreamResolver
• type WGIface

Variables

var ErrUnknownOsManagerType = errors.New("unknown os manager type")

Functions

func CheckUncleanShutdown

func CheckUncleanShutdown(wgIface string) error

Types

type DefaultServer

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

DefaultServer dns server object

func NewDefaultServer

func NewDefaultServer(
	ctx context.Context,
	wgInterface WGIface,
	customAddress string,
	statusRecorder *peer.Status,
) (*DefaultServer, error)

NewDefaultServer returns a new dns server

func NewDefaultServerIos

func NewDefaultServerIos(
	ctx context.Context,
	wgInterface WGIface,
	iosDnsManager IosDnsManager,
	statusRecorder *peer.Status,
) *DefaultServer

NewDefaultServerIos returns a new dns server. It optimized for ios

func NewDefaultServerPermanentUpstream

func NewDefaultServerPermanentUpstream(
	ctx context.Context,
	wgInterface WGIface,
	hostsDnsList []string,
	config nbdns.Config,
	listener listener.NetworkChangeListener,
	statusRecorder *peer.Status,
) *DefaultServer

NewDefaultServerPermanentUpstream returns a new dns server. It optimized for mobile systems

func (*DefaultServer) DnsIP

func (s *DefaultServer) DnsIP() string

DnsIP returns the DNS resolver server IP address

When kernel space interface used it return real DNS server listener IP address For bind interface, fake DNS resolver address returned (second last IP address from Nebird network)

func (*DefaultServer) Initialize

func (s *DefaultServer) Initialize() (err error)

Initialize instantiate host manager and the dns service

func (*DefaultServer) OnUpdatedHostDNSServer

func (s *DefaultServer) OnUpdatedHostDNSServer(hostsDnsList []string)

OnUpdatedHostDNSServer update the DNS servers addresses for root zones It will be applied if the mgm server do not enforce DNS settings for root zone

func (*DefaultServer) ProbeAvailability

func (s *DefaultServer) ProbeAvailability()

ProbeAvailability tests each upstream group's servers for availability and deactivates the group if no server responds

func (*DefaultServer) SearchDomains

func (s *DefaultServer) SearchDomains() []string

func (*DefaultServer) Stop

func (s *DefaultServer) Stop()

Stop stops the server

func (*DefaultServer) UpdateDNSServer

func (s *DefaultServer) UpdateDNSServer(serial uint64, update nbdns.Config) error

UpdateDNSServer processes an update received from the management service

type DomainConfig

type DomainConfig struct {
	Disabled  bool   `json:"disabled"`
	Domain    string `json:"domain"`
	MatchOnly bool   `json:"matchOnly"`
}

type HostDNSConfig

type HostDNSConfig struct {
	Domains    []DomainConfig `json:"domains"`
	RouteAll   bool           `json:"routeAll"`
	ServerIP   string         `json:"serverIP"`
	ServerPort int            `json:"serverPort"`
}

type IosDnsManager

type IosDnsManager interface {
	ApplyDns(string)
}

IosDnsManager is a dns manager interface for iOS

type MockServer

type MockServer struct {
	InitializeFunc      func() error
	StopFunc            func()
	UpdateDNSServerFunc func(serial uint64, update nbdns.Config) error
}

MockServer is the mock instance of a dns server

func (*MockServer) DnsIP

func (m *MockServer) DnsIP() string

func (*MockServer) Initialize

func (m *MockServer) Initialize() error

Initialize mock implementation of Initialize from Server interface

func (*MockServer) OnUpdatedHostDNSServer

func (m *MockServer) OnUpdatedHostDNSServer(strings []string)

func (*MockServer) ProbeAvailability

func (m *MockServer) ProbeAvailability()

ProbeAvailability mocks implementation of ProbeAvailability from the Server interface

func (*MockServer) SearchDomains

func (m *MockServer) SearchDomains() []string

func (*MockServer) Stop

func (m *MockServer) Stop()

Stop mock implementation of Stop from Server interface

func (*MockServer) UpdateDNSServer

func (m *MockServer) UpdateDNSServer(serial uint64, update nbdns.Config) error

UpdateDNSServer mock implementation of UpdateDNSServer from Server interface

type ReadyListener

type ReadyListener interface {
	OnReady()
}

ReadyListener is a notification mechanism what indicate the server is ready to handle host dns address changes

type Server

type Server interface {
	Initialize() error
	Stop()
	DnsIP() string
	UpdateDNSServer(serial uint64, update nbdns.Config) error
	OnUpdatedHostDNSServer(strings []string)
	SearchDomains() []string
	ProbeAvailability()
}

Server is a dns server interface

func GetServerDns

func GetServerDns() (Server, error)

GetServerDns export the DNS server instance in static way. It used by the Mobile client

type UpstreamResolver

type UpstreamResolver interface {
	// contains filtered or unexported methods
}

type WGIface

type WGIface interface {
	Name() string
	Address() iface.WGAddress
	IsUserspaceBind() bool
	GetFilter() iface.PacketFilter
	GetDevice() *iface.DeviceWrapper
	GetStats(peerKey string) (iface.WGStats, error)
}

WGIface defines subset methods of interface required for manager