hostdevice

Documentation

Index

• func CreateMDEVHostDevices(hostDevicesData []HostDeviceMetaData, mdevAddrPool AddressPooler) ([]api.HostDevice, error)
• func CreatePCIHostDevices(hostDevicesData []HostDeviceMetaData, pciAddrPool AddressPooler) ([]api.HostDevice, error)
• type AddressPool
  • func NewAddressPool(resourcePrefix string, resources []string) *AddressPool
  • func (p *AddressPool) Pop(resource string) (string, error)
• type AddressPooler
• type BestEffortAddressPool
  • func NewBestEffortAddressPool(pool AddressPooler) *BestEffortAddressPool
  • func (p *BestEffortAddressPool) Pop(resource string) (string, error)
• type HostDeviceMetaData

Functions

func CreateMDEVHostDevices

func CreateMDEVHostDevices(hostDevicesData []HostDeviceMetaData, mdevAddrPool AddressPooler) ([]api.HostDevice, error)

func CreatePCIHostDevices

func CreatePCIHostDevices(hostDevicesData []HostDeviceMetaData, pciAddrPool AddressPooler) ([]api.HostDevice, error)

Types

type AddressPool

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

func NewAddressPool

func NewAddressPool(resourcePrefix string, resources []string) *AddressPool

NewAddressPool creates an address pool based on the provided list of resources and the environment variables that correspond to it.

func (*AddressPool) Pop

func (p *AddressPool) Pop(resource string) (string, error)

Pop gets the next address available to a particular resource. The function makes sure that the allocated address is not allocated to next callers, whether they request an address for the same resource or another resource (covering cases of addresses that are share by multiple resources).

type AddressPooler

type AddressPooler interface {
	Pop(key string) (value string, err error)
}

type BestEffortAddressPool

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

func NewBestEffortAddressPool

func NewBestEffortAddressPool(pool AddressPooler) *BestEffortAddressPool

NewBestEffortAddressPool creates a pool that wraps a provided pool and allows `Pop` calls to always succeed (even when a resource is missing).

func (*BestEffortAddressPool) Pop

func (p *BestEffortAddressPool) Pop(resource string) (string, error)

type HostDeviceMetaData

type HostDeviceMetaData struct {
	AliasPrefix  string
	Name         string
	ResourceName string

	// DecorateHook is a function pointer that may be used to mutate the domain host-device
	// with additional specific parameters. E.g. guest PCI address.
	DecorateHook func(hostDevice *api.HostDevice) error
}