mirror of
https://github.com/coredns/coredns.git
synced 2025-11-02 10:13:14 -05:00
50 lines
1.7 KiB
Go
50 lines
1.7 KiB
Go
package plugin
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/coredns/coredns/plugin/etcd/msg"
|
|
"github.com/coredns/coredns/request"
|
|
|
|
"github.com/miekg/dns"
|
|
)
|
|
|
|
// ServiceBackend defines a (dynamic) backend that returns a slice of service definitions.
|
|
type ServiceBackend interface {
|
|
// Services communicates with the backend to retrieve the service definitions. Exact indicates
|
|
// on exact match should be returned.
|
|
Services(state request.Request, exact bool, opt Options) ([]msg.Service, error)
|
|
|
|
// Reverse communicates with the backend to retrieve service definition based on a IP address
|
|
// instead of a name. I.e. a reverse DNS lookup.
|
|
Reverse(state request.Request, exact bool, opt Options) ([]msg.Service, error)
|
|
|
|
// Lookup is used to find records else where.
|
|
Lookup(state request.Request, name string, typ uint16) (*dns.Msg, error)
|
|
|
|
// Returns _all_ services that matches a certain name.
|
|
// Note: it does not implement a specific service.
|
|
Records(state request.Request, exact bool) ([]msg.Service, error)
|
|
|
|
// IsNameError return true if err indicated a record not found condition
|
|
IsNameError(err error) bool
|
|
|
|
Transferer
|
|
}
|
|
|
|
// Transferer defines an interface for backends that provide AXFR of all records.
|
|
type Transferer interface {
|
|
// Serial returns a SOA serial number to construct a SOA record.
|
|
Serial(state request.Request) uint32
|
|
|
|
// MinTTL returns the minimum TTL to be used in the SOA record.
|
|
MinTTL(state request.Request) uint32
|
|
|
|
// Transfer handles a zone transfer it writes to the client just
|
|
// like any other handler.
|
|
Transfer(ctx context.Context, state request.Request) (int, error)
|
|
}
|
|
|
|
// Options are extra options that can be specified for a lookup.
|
|
type Options struct{}
|