config

Documentation

Index

• Constants
• type Device
  • func (device Device) Clone() Device
  • func (device Device) Validate(rules map[string]func(value string) error) error
• type DeviceNamed
• type Devices
  • func ApplyDeviceInitialValues(devices Devices, profiles []api.Profile) Devices
  • func NewDevices(nativeSet map[string]map[string]string) Devices
  • func (list Devices) Clone() Devices
  • func (list Devices) CloneNative() map[string]map[string]string
  • func (list Devices) Contains(k string, d Device) bool
  • func (list Devices) Reversed() DevicesSortable
  • func (list Devices) Sorted() DevicesSortable
  • func (list Devices) Update(newlist Devices, updateFields func(Device, Device) []string) (Devices, Devices, Devices, []string)
• type DevicesSortable
  • func (devices DevicesSortable) Len() int
  • func (devices DevicesSortable) Less(i, j int) bool
  • func (devices DevicesSortable) Swap(i, j int)
• type DiskLimits
• type MountEntryItem
• type NICConfig
• type ProxyAddress
• type RootFSEntryItem
• type RunConfig
• type RunConfigItem
• type USBDeviceItem

Constants

const DefaultVMBlockFilesystemSize = "500MiB"

DefaultVMBlockFilesystemSize is the size of a VM root device block volume's associated filesystem volume.

const MountOwnerShiftDynamic = "dynamic"

MountOwnerShiftDynamic use shifted mounts for dynamic owner shifting.

const MountOwnerShiftNone = ""

MountOwnerShiftNone do not use owner shifting.

const MountOwnerShiftStatic = "static"

MountOwnerShiftStatic statically modify ownership.

const NICConfigDir = "nics"

NICConfigDir shared constant used to indicate where NIC config is stored.

Types

type Device

type Device map[string]string

Device represents an instance device.

func (Device) Clone

func (device Device) Clone() Device

Clone returns a copy of the Device.

func (Device) Validate

func (device Device) Validate(rules map[string]func(value string) error) error

Validate accepts a map of field/validation functions to run against the device's config.

type DeviceNamed

type DeviceNamed struct {
	Name   string
	Config Device
}

DeviceNamed contains the name of a device and its config.

type Devices

type Devices map[string]Device

Devices represents a set of instance devices.

func ApplyDeviceInitialValues

func ApplyDeviceInitialValues(devices Devices, profiles []api.Profile) Devices

ApplyDeviceInitialValues applies a profile initial values to root disk devices.

func NewDevices

func NewDevices(nativeSet map[string]map[string]string) Devices

NewDevices creates a new Devices set from a native map[string]map[string]string set.

func (Devices) Clone

func (list Devices) Clone() Devices

Clone returns a copy of the Devices set.

func (Devices) CloneNative

func (list Devices) CloneNative() map[string]map[string]string

CloneNative returns a copy of the Devices set as a native map[string]map[string]string type.

func (Devices) Contains

func (list Devices) Contains(k string, d Device) bool

Contains checks if a given device exists in the set and if it's identical to that provided.

func (Devices) Reversed

func (list Devices) Reversed() DevicesSortable

Reversed returns the name of all devices in the set, sorted reversed.

func (Devices) Sorted

func (list Devices) Sorted() DevicesSortable

Sorted returns the name of all devices in the set, sorted properly.

func (Devices) Update

func (list Devices) Update(newlist Devices, updateFields func(Device, Device) []string) (Devices, Devices, Devices, []string)

Update returns the difference between two device sets (removed, added, updated devices) and a list of all changed keys across all devices. Accepts a function to return which keys can be live updated, which prevents them being removed and re-added if the device supports live updates of certain keys.

type DevicesSortable

type DevicesSortable []DeviceNamed

DevicesSortable is a sortable slice of device names and config.

func (DevicesSortable) Len

func (devices DevicesSortable) Len() int

func (DevicesSortable) Less

func (devices DevicesSortable) Less(i, j int) bool

func (DevicesSortable) Swap

func (devices DevicesSortable) Swap(i, j int)

type DiskLimits

type DiskLimits struct {
	ReadBytes  int64
	ReadIOps   int64
	WriteBytes int64
	WriteIOps  int64
}

DiskLimits represents a set of I/O disk limits.

type MountEntryItem

type MountEntryItem struct {
	DevName    string      // The internal name for the device.
	DevPath    string      // Describes the block special device or remote filesystem to be mounted.
	TargetPath string      // Describes the mount point (target) for the filesystem.
	FSType     string      // Describes the type of the filesystem.
	Opts       []string    // Describes the mount options associated with the filesystem.
	Freq       int         // Used by dump(8) to determine which filesystems need to be dumped. Defaults to zero (don't dump) if not present.
	PassNo     int         // Used by fsck(8) to determine the order in which filesystem checks are done at boot time. Defaults to zero (don't fsck) if not present.
	OwnerShift string      // Ownership shifting mode, use constants MountOwnerShiftNone, MountOwnerShiftStatic or MountOwnerShiftDynamic.
	Limits     *DiskLimits // Disk limits.
	Size       int64       // Expected disk size in bytes.
}

MountEntryItem represents a single mount entry item.

type NICConfig

type NICConfig struct {
	DeviceName string `json:"device_name"`
	NICName    string `json:"nic_name"`
	MACAddress string `json:"mac_address"`
	MTU        uint32 `json:"mtu"`
}

NICConfig contains network interface configuration to be passed into a VM and applied by the agent.

type ProxyAddress

type ProxyAddress struct {
	ConnType string
	Abstract bool
	Address  string
	Ports    []uint64
}

ProxyAddress represents a proxy address configuration.

type RootFSEntryItem

type RootFSEntryItem struct {
	Path string   // Describes the root file system source.
	Opts []string // Describes the mount options associated with the filesystem.
}

RootFSEntryItem represents the root filesystem options for an Instance.

type RunConfig

type RunConfig struct {
	RootFS           RootFSEntryItem  // RootFS to setup.
	NetworkInterface []RunConfigItem  // Network interface configuration settings.
	CGroups          []RunConfigItem  // Cgroup rules to setup.
	Mounts           []MountEntryItem // Mounts to setup/remove.
	Uevents          [][]string       // Uevents to inject.
	PostHooks        []func() error   // Functions to be run after device attach/detach.
	GPUDevice        []RunConfigItem  // GPU device configuration settings.
	USBDevice        []USBDeviceItem  // USB device configuration settings.
	TPMDevice        []RunConfigItem  // TPM device configuration settings.
	PCIDevice        []RunConfigItem  // PCI device configuration settings.
	Revert           revert.Hook      // Revert setup of device on post-setup error.
}

RunConfig represents run-time config used for device setup/cleanup.

type RunConfigItem

type RunConfigItem struct {
	Key   string
	Value string
}

RunConfigItem represents a single config item.

type USBDeviceItem

type USBDeviceItem struct {
	DeviceName     string
	HostDevicePath string
}

USBDeviceItem represents a single USB device matched from a USB device specification.