allocator

Documentation

Index

• type Allocator
  • func New() *Allocator
  • func (a *Allocator) Allocate(service string) (net.IP, error)
  • func (a *Allocator) AllocateFromPool(service, pool string) (net.IP, error)
  • func (a *Allocator) Assign(service string, ip net.IP) error
  • func (a *Allocator) IP(service string) net.IP
  • func (a *Allocator) Pool(service string) string
  • func (a *Allocator) SetPools(pools map[string]*config.Pool) error
  • func (a *Allocator) Unassign(service string) bool

Types

type Allocator

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

An Allocator tracks IP address pools and allocates addresses from them.

func New

func New() *Allocator

New returns an Allocator managing no pools.

func (*Allocator) Allocate

func (a *Allocator) Allocate(service string) (net.IP, error)

Allocate assigns any available and assignable IP to service.

func (*Allocator) AllocateFromPool

func (a *Allocator) AllocateFromPool(service, pool string) (net.IP, error)

AllocateFromPool assigns an available IP from pool to service.

func (*Allocator) Assign

func (a *Allocator) Assign(service string, ip net.IP) error

Assign marks service as the owner of ip, if that address is available.

func (*Allocator) IP

func (a *Allocator) IP(service string) net.IP

IP returns the IP address allocated to service, or nil if none are allocated.

func (*Allocator) Pool

func (a *Allocator) Pool(service string) string

Pool returns the pool from which service's IP was allocated. If service has no IP allocated, "" is returned.

func (*Allocator) SetPools

func (a *Allocator) SetPools(pools map[string]*config.Pool) error

SetPools updates the set of address pools that the allocator owns.

func (*Allocator) Unassign

func (a *Allocator) Unassign(service string) bool

Unassign frees the IP associated with service, if any.