virt

README

virt

Name

virt - returns the address of domains running using libvirt (referenced by name.virt)

Description

This plugin connects to libvirtd and will attempt to lookup the domain for any query with the .virt TLD (or other specified), and then return the addresses that have been leased to that domain.

Note: In order to add a new plugin, an additional step of make gen is needed. Therefore, to build the coredns with demo plugin the following should be used:

docker run -it --rm -v $PWD:/v -w /v golang:1.16 sh -c 'make gen && make'

Syntax

virt [tld] [libvirt socket path] [libvirt connect URI] [Should disconnect]

Defaults:

• tld: virt - The domain to return libvirt domains as a subdomain of
• libvirt socket path: /run/libvirt/libvirt-sock-ro - The path to the libvirt unix control socket
• libvirt connect URI: qemu:///system - The URI for libvirts emulation agent
• Should disconnect: no - Whether to disconnect after every query, or leave connection open

Also See

See the manual.

Documentation

Index

• type VirtMachine
  • func (p VirtMachine) Name() string
  • func (p VirtMachine) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

Types

type VirtMachine

type VirtMachine struct {
	Next             plugin.Handler
	TLD              string
	ConnectURI       libvirt.ConnectURI
	LibVirt          *libvirt.Libvirt
	ConnectMutex     *sync.Mutex
	ShouldDisconnect bool
}

func (VirtMachine) Name

func (p VirtMachine) Name() string

Name implements the Handler interface.

func (VirtMachine) ServeDNS

func (p VirtMachine) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the plugin.Handler interface.