kvmrun

package

Go to main page

Versions in this module

v1

v1.4.2

Nov 6, 2024

v1.4.1

Oct 15, 2024

Changes in this version

+ var CloudInitDrivers = DevDrivers

+ func NewCloudInitDriveBackend(p string) (backend.DiskBackend, error)

type CloudInitDrive

+ Backend backend.DiskBackend

+ Driver string

+ Media string

+ func NewCloudInitDrive(media string) (*CloudInitDrive, error)

+ func (d *CloudInitDrive) IsLocal() bool

+ func (d *CloudInitDrive) QdevID() string

type Instance

+ RemoveCloudInitConf func() error

+ SetCloudInitDriver func(string) error

+ SetCloudInitMedia func(string) error

type InstanceConf

+ func (c *InstanceConf) RemoveCloudInitConf() error

+ func (c *InstanceConf) SetCloudInitDriver(s string) error

+ func (c *InstanceConf) SetCloudInitMedia(s string) error

type InstanceQemu

+ func (r *InstanceQemu) RemoveCloudInitConf() error

+ func (r *InstanceQemu) SetCloudInitDriver(s string) error

+ func (r *InstanceQemu) SetCloudInitMedia(media string) error

v1.3.4

Jul 15, 2024

v1.3.3

Jun 15, 2024

v1.3.2

May 27, 2024

v1.3.1

May 27, 2024

Changes in this version

+ func NewFirmwareBackend(p string) (backend.DiskBackend, error)

+ type FirmwareBackend struct

+ func (b *FirmwareBackend) BaseName() string

+ func (b *FirmwareBackend) QdevID() string

+ type HostPCI struct

+ Addr string

+ BackendAddr *pci.Address

+ Multifunction bool

+ PrimaryGPU bool

+ func NewHostPCI(hexaddr string) (*HostPCI, error)

+ type HostPCIPool []HostPCI

+ func (p *HostPCIPool) Append(d *HostPCI)

+ func (p *HostPCIPool) Remove(hexaddr string) error

+ func (p *HostPCIPool) RemoveN(idx int) error

+ func (p HostPCIPool) Exists(hexaddr string) bool

+ func (p HostPCIPool) Get(hexaddr string) *HostPCI

type Instance

+ AppendHostPCI func(HostPCI) error

+ GetFirmwareFlash func() *Disk

+ GetHostPCIDevices func() HostPCIPool

+ GetQemuVersion func() QemuVersion

+ RemoveHostPCI func(string) error

+ SetFirmwareFlash func(string) error

+ SetHostPCIMultifunctionOption func(string, bool) error

+ SetHostPCIPrimaryGPUOption func(string, bool) error

+ SetNetIfaceQueues func(string, int) error

type InstanceConf

+ func (c *InstanceConf) AppendHostPCI(d HostPCI) error

+ func (c *InstanceConf) RemoveHostPCI(hexaddr string) error

+ func (c *InstanceConf) SetFirmwareFlash(p string) error

+ func (c *InstanceConf) SetHostPCIMultifunctionOption(hexaddr string, enabled bool) error

+ func (c *InstanceConf) SetHostPCIPrimaryGPUOption(hexaddr string, enabled bool) error

+ func (c *InstanceConf) SetNetIfaceQueues(ifname string, queues int) error

type InstanceProperties

+ HostPCIDevices HostPCIPool

+ func (p InstanceProperties) GetFirmwareFlash() *Disk

+ func (p InstanceProperties) GetHostPCIDevices() HostPCIPool

+ func (p InstanceProperties) GetQemuVersion() QemuVersion

type InstanceQemu

+ func (r *InstanceQemu) AppendHostPCI(_ HostPCI) error

+ func (r *InstanceQemu) RemoveHostPCI(_ string) error

+ func (r *InstanceQemu) SetHostPCIMultifunctionOption(_ string, _ bool) error

+ func (r *InstanceQemu) SetHostPCIPrimaryGPUOption(_ string, _ bool) error

+ func (r *InstanceQemu) SetNetIfaceQueues(_ string, _ int) error

+ func (r InstanceQemu) GetQemuVersion() QemuVersion

+ func (r InstanceQemu) SetFirmwareFlash(_ string) error

type NetIface

+ Queues int

type QemuFirmware

+ Flash string

v1.2.1

Jun 18, 2023

v1.2.0

Jun 17, 2023

v1.1.0

Oct 11, 2022

Changes in this version

type Instance

+ GetFirmwareImage func() string

+ RemoveFirmwareConf func() error

+ SetFirmwareImage func(string) error

type InstanceConf

+ func (c *InstanceConf) RemoveFirmwareConf() error

+ func (c *InstanceConf) SetFirmwareImage(p string) error

type InstanceProperties

+ Firmware QemuFirmware

+ func (p InstanceProperties) GetFirmwareImage() string

type InstanceQemu

+ func (r *InstanceQemu) RemoveFirmwareConf() error

+ func (r InstanceQemu) SetFirmwareImage(_ string) error

+ type QemuFirmware struct

+ Image string

v1.0.2

Jun 21, 2022

Changes in this version

+ const CGROOTPATH

+ const CHROOTDIR

+ const CONFDIR

+ const FIRST_INCOMING_PORT

+ const FIRST_NBD_PORT

+ const FIRST_WS_PORT

+ const KERNELSDIR

+ const LOGDIR

+ const MODULESDIR

+ const QMPMONDIR

+ const VMNETINIT

+ var CdromDrivers = DevDrivers

+ var DiskDrivers = DevDrivers

+ var ErrIncorrectContextID = errors.New("incorrect context ID (allowed range is from 3 to 0xffffffff - 1)")

+ var ErrNotImplemented = errors.New("not implemented")

+ var ErrTimedOut = errors.New("timeout error")

+ var NetDrivers = DevDrivers

+ var Version = KvmrunVersion

+ func AddTapInterface(ifname string, uid int) error

+ func DelTapInterface(ifname string) error

+ func GenHwAddr() (string, error)

+ func GetCommandLine(vmi Instance, features *CommandLineFeatures) ([]string, error)

+ func IsAlreadyConnectedError(err error) bool

+ func IsNotConnectedError(err error) bool

+ func IsNotRunningError(err error) bool

+ func NewCdromBackend(p string) (backend.DiskBackend, error)

+ func NewDiskBackend(p string) (backend.DiskBackend, error)

+ func ParseSCSIAddr(s string) (string, string, string)

+ func SetInterfaceUp(ifname string) error

+ type AlreadyConnectedError struct

+ Object string

+ Source string

+ func (e *AlreadyConnectedError) Error() string

+ type CDPool []Cdrom

+ func (p *CDPool) Append(d *Cdrom)

+ func (p *CDPool) Insert(d *Cdrom, idx int) error

+ func (p *CDPool) Remove(name string) error

+ func (p *CDPool) RemoveN(idx int) error

+ func (p CDPool) Exists(name string) bool

+ func (p CDPool) Get(name string) *Cdrom

+ type Cdrom struct

+ Addr string

+ Backend backend.DiskBackend

+ Bootindex uint

+ Driver string

+ Media string

+ Name string

+ ReadOnly bool

+ func NewCdrom(name, media string) (*Cdrom, error)

+ func (d Cdrom) IsLocal() bool

+ func (d Cdrom) QdevID() string

+ type CloudInitDrive struct

+ Path string

+ type CommandLineFeatures struct

+ IncomingHost string

+ NoReboot bool

+ VNCHost string

+ type DevDriver struct

+ HotPluggable bool

+ Name string

+ type DevDrivers []DevDriver

+ func (d DevDrivers) Exists(name string) bool

+ func (d DevDrivers) HotPluggable(name string) bool

+ type Disk struct

+ Addr string

+ Backend backend.DiskBackend

+ Bootindex uint

+ Driver string

+ HasBitmap bool

+ IopsRd int

+ IopsWr int

+ Path string

+ QemuVirtualSize uint64

+ func NewDisk(p string) (*Disk, error)

+ func (d Disk) BaseName() string

+ func (d Disk) IsAvailable() (bool, error)

+ func (d Disk) IsLocal() bool

+ func (d Disk) QdevID() string

+ type DiskPool []Disk

+ func (p *DiskPool) Append(d *Disk)

+ func (p *DiskPool) Insert(d *Disk, idx int) error

+ func (p *DiskPool) Remove(dpath string) error

+ func (p *DiskPool) RemoveN(idx int) error

+ func (p DiskPool) Exists(dpath string) bool

+ func (p DiskPool) Get(dpath string) *Disk

+ type ExtKernel struct

+ Cmdline string

+ Image string

+ Initrd string

+ Modiso string

+ type IncomingConf struct

+ type InputDevice struct

+ Type string

+ type InputPool []InputDevice

+ func (p *InputPool) Append(d *InputDevice)

+ func (p *InputPool) Remove(t string) error

+ func (p *InputPool) RemoveN(idx int) error

+ func (p InputPool) Exists(t string) bool

+ func (p InputPool) Get(t string) *InputDevice

+ type Instance interface

+ AppendCdrom func(Cdrom) error

+ AppendDisk func(Disk) error

+ AppendInputDevice func(InputDevice) error

+ AppendNetIface func(NetIface) error

+ AppendProxy func(Proxy) error

+ AppendVSockDevice func(uint32) error

+ ChangeCdromMedia func(string, string) error

+ GetActualCPUs func() int

+ GetActualMem func() int

+ GetCPUModel func() string

+ GetCPUQuota func() int

+ GetCPUSockets func() int

+ GetCdromMedia func(string) (string, error)

+ GetCdroms func() CDPool

+ GetCloudInitDrive func() string

+ GetDisks func() DiskPool

+ GetInputDevices func() InputPool

+ GetKernelCmdline func() string

+ GetKernelImage func() string

+ GetKernelInitrd func() string

+ GetKernelModiso func() string

+ GetMachineType func() *QemuMachine

+ GetNetIfaces func() NetifPool

+ GetProxyServers func() ProxyPool

+ GetTotalCPUs func() int

+ GetTotalMem func() int

+ GetVSockDevice func() *VirtioVSock

+ InsertCdrom func(Cdrom, int) error

+ InsertDisk func(Disk, int) error

+ IsIncoming func() bool

+ Name func() string

+ Pid func() int

+ RemoveCdrom func(string) error

+ RemoveDisk func(string) error

+ RemoveDiskBitmap func(string) error

+ RemoveInputDevice func(string) error

+ RemoveKernelConf func() error

+ RemoveNetIface func(string) error

+ RemoveProxy func(string) error

+ RemoveVSockDevice func() error

+ ResizeQemuBlockdev func(string) error

+ Save func() error

+ SetActualCPUs func(int) error

+ SetActualMem func(int) error

+ SetCPUModel func(string) error

+ SetCPUQuota func(int) error

+ SetCPUSockets func(int) error

+ SetCloudInitDrive func(string) error

+ SetDiskReadIops func(string, int) error

+ SetDiskWriteIops func(string, int) error

+ SetKernelCmdline func(string) error

+ SetKernelImage func(string) error

+ SetKernelInitrd func(string) error

+ SetKernelModiso func(string) error

+ SetMachineType func(string) error

+ SetNetIfaceDownScript func(string, string) error

+ SetNetIfaceLinkDown func(string) error

+ SetNetIfaceLinkUp func(string) error

+ SetNetIfaceUpScript func(string, string) error

+ SetTotalCPUs func(int) error

+ SetTotalMem func(int) error

+ SetVNCPassword func(string) error

+ Status func() (InstanceState, error)

+ Uid func() int

+ func GetIncomingConf(vmname string) (Instance, error)

+ func GetInstanceConf(vmname string) (Instance, error)

+ func GetInstanceQemu(vmname string, mon *qmp.Monitor) (Instance, error)

+ func GetStartupConf(vmname string) (Instance, error)

+ func NewIncomingConf(vmname string) Instance

+ func NewInstanceConf(vmname string) Instance

+ type InstanceConf struct

+ func (c *InstanceConf) AppendCdrom(d Cdrom) error

+ func (c *InstanceConf) AppendDisk(d Disk) error

+ func (c *InstanceConf) AppendInputDevice(d InputDevice) error

+ func (c *InstanceConf) AppendNetIface(iface NetIface) error

+ func (c *InstanceConf) AppendProxy(proxy Proxy) error

+ func (c *InstanceConf) AppendVSockDevice(cid uint32) error

+ func (c *InstanceConf) ChangeCdromMedia(name, media string) error

+ func (c *InstanceConf) InsertCdrom(d Cdrom, idx int) error

+ func (c *InstanceConf) InsertDisk(d Disk, idx int) error

+ func (c *InstanceConf) RemoveCdrom(name string) error

+ func (c *InstanceConf) RemoveDisk(dpath string) error

+ func (c *InstanceConf) RemoveInputDevice(t string) error

+ func (c *InstanceConf) RemoveKernelConf() error

+ func (c *InstanceConf) RemoveNetIface(ifname string) error

+ func (c *InstanceConf) RemoveProxy(fullpath string) error

+ func (c *InstanceConf) RemoveVSockDevice() error

+ func (c *InstanceConf) SetActualCPUs(n int) error

+ func (c *InstanceConf) SetActualMem(s int) error

+ func (c *InstanceConf) SetCPUModel(model string) error

+ func (c *InstanceConf) SetCPUQuota(quota int) error

+ func (c *InstanceConf) SetCPUSockets(n int) error

+ func (c *InstanceConf) SetCloudInitDrive(s string) error

+ func (c *InstanceConf) SetDiskReadIops(dpath string, iops int) error

+ func (c *InstanceConf) SetDiskWriteIops(dpath string, iops int) error

+ func (c *InstanceConf) SetKernelCmdline(s string) error

+ func (c *InstanceConf) SetKernelImage(s string) error

+ func (c *InstanceConf) SetKernelInitrd(s string) error

+ func (c *InstanceConf) SetKernelModiso(s string) error

+ func (c *InstanceConf) SetMachineType(t string) error

+ func (c *InstanceConf) SetNetIfaceDownScript(ifname, scriptPath string) error

+ func (c *InstanceConf) SetNetIfaceLinkDown(ifname string) error

+ func (c *InstanceConf) SetNetIfaceLinkUp(ifname string) error

+ func (c *InstanceConf) SetNetIfaceUpScript(ifname, scriptPath string) error

+ func (c *InstanceConf) SetTotalCPUs(n int) error

+ func (c *InstanceConf) SetTotalMem(s int) error

+ func (c InstanceConf) IsIncoming() bool

+ func (c InstanceConf) Pid() int

+ func (c InstanceConf) RemoveDiskBitmap(dpath string) error

+ func (c InstanceConf) ResizeQemuBlockdev(_ string) error

+ func (c InstanceConf) Save() error

+ func (c InstanceConf) SaveStartupConfig() error

+ func (c InstanceConf) SetVNCPassword(s string) error

+ func (c InstanceConf) Status() (InstanceState, error)

+ type InstanceProperties struct

+ CIDrive CloudInitDrive

+ CPU Processor

+ Cdroms CDPool

+ Disks DiskPool

+ Inputs InputPool

+ Kernel ExtKernel

+ MachineType string

+ Mem Memory

+ NetIfaces NetifPool

+ Proxy ProxyPool

+ VSockDevice *VirtioVSock

+ func (p InstanceProperties) GetActualCPUs() int

+ func (p InstanceProperties) GetActualMem() int

+ func (p InstanceProperties) GetCPUModel() string

+ func (p InstanceProperties) GetCPUQuota() int

+ func (p InstanceProperties) GetCPUSockets() int

+ func (p InstanceProperties) GetCdromMedia(name string) (string, error)

+ func (p InstanceProperties) GetCdroms() CDPool

+ func (p InstanceProperties) GetCloudInitDrive() string

+ func (p InstanceProperties) GetDisks() DiskPool

+ func (p InstanceProperties) GetInputDevices() InputPool

+ func (p InstanceProperties) GetKernelCmdline() string

+ func (p InstanceProperties) GetKernelImage() string

+ func (p InstanceProperties) GetKernelInitrd() string

+ func (p InstanceProperties) GetKernelModiso() string

+ func (p InstanceProperties) GetMachineType() *QemuMachine

+ func (p InstanceProperties) GetNetIfaces() NetifPool

+ func (p InstanceProperties) GetProxyServers() ProxyPool

+ func (p InstanceProperties) GetTotalCPUs() int

+ func (p InstanceProperties) GetTotalMem() int

+ func (p InstanceProperties) GetVSockDevice() *VirtioVSock

+ func (p InstanceProperties) Name() string

+ func (p InstanceProperties) Uid() int

+ type InstanceQemu struct

+ func (r *InstanceQemu) AppendCdrom(_ Cdrom) error

+ func (r *InstanceQemu) AppendDisk(_ Disk) error

+ func (r *InstanceQemu) AppendInputDevice(_ InputDevice) error

+ func (r *InstanceQemu) AppendNetIface(_ NetIface) error

+ func (r *InstanceQemu) AppendProxy(proxy Proxy) error

+ func (r *InstanceQemu) AppendVSockDevice(cid uint32) error

+ func (r *InstanceQemu) ChangeCdromMedia(name, media string) error

+ func (r *InstanceQemu) InsertCdrom(_ Cdrom, _ int) error

+ func (r *InstanceQemu) InsertDisk(_ Disk, _ int) error

+ func (r *InstanceQemu) RemoveCdrom(_ string) error

+ func (r *InstanceQemu) RemoveDisk(_ string) error

+ func (r *InstanceQemu) RemoveDiskBitmap(dpath string) error

+ func (r *InstanceQemu) RemoveInputDevice(_ string) error

+ func (r *InstanceQemu) RemoveKernelConf() error

+ func (r *InstanceQemu) RemoveNetIface(_ string) error

+ func (r *InstanceQemu) RemoveProxy(fullpath string) error

+ func (r *InstanceQemu) RemoveVSockDevice() error

+ func (r *InstanceQemu) SetActualCPUs(n int) error

+ func (r *InstanceQemu) SetActualMem(s int) error

+ func (r *InstanceQemu) SetCPUModel(model string) error

+ func (r *InstanceQemu) SetCPUQuota(quota int) error

+ func (r *InstanceQemu) SetCPUSockets(n int) error

+ func (r *InstanceQemu) SetCloudInitDrive(s string) error

+ func (r *InstanceQemu) SetDiskReadIops(dpath string, iops int) error

+ func (r *InstanceQemu) SetDiskWriteIops(dpath string, iops int) error

+ func (r *InstanceQemu) SetKernelCmdline(s string) error

+ func (r *InstanceQemu) SetKernelImage(s string) error

+ func (r *InstanceQemu) SetKernelInitrd(s string) error

+ func (r *InstanceQemu) SetKernelModiso(s string) error

+ func (r *InstanceQemu) SetNetIfaceDownScript(_, _ string) error

+ func (r *InstanceQemu) SetNetIfaceLinkDown(ifname string) error

+ func (r *InstanceQemu) SetNetIfaceLinkUp(ifname string) error

+ func (r *InstanceQemu) SetNetIfaceUpScript(_, _ string) error

+ func (r *InstanceQemu) SetTotalCPUs(n int) error

+ func (r *InstanceQemu) SetTotalMem(_ int) error

+ func (r InstanceQemu) IsIncoming() bool

+ func (r InstanceQemu) Pid() int

+ func (r InstanceQemu) ResizeQemuBlockdev(dpath string) error

+ func (r InstanceQemu) Save() error

+ func (r InstanceQemu) SetMachineType(t string) error

+ func (r InstanceQemu) SetVNCPassword(s string) error

+ func (r InstanceQemu) Status() (InstanceState, error)

+ type InstanceQemu_i440fx struct

+ func (r *InstanceQemu_i440fx) AppendCdrom(d Cdrom) error

+ func (r *InstanceQemu_i440fx) AppendDisk(d Disk) error

+ func (r *InstanceQemu_i440fx) AppendNetIface(iface NetIface) error

+ func (r *InstanceQemu_i440fx) RemoveCdrom(name string) error

+ func (r *InstanceQemu_i440fx) RemoveDisk(dpath string) error

+ func (r *InstanceQemu_i440fx) RemoveNetIface(ifname string) error

+ type InstanceState uint16

+ const StateCrashed

+ const StateInactive

+ const StateIncoming

+ const StateMigrated

+ const StateMigrating

+ const StateNoState

+ const StatePaused

+ const StateRunning

+ const StateShutdown

+ const StateStarting

+ type KvmrunVersion struct

+ Major int

+ Micro int

+ Minor int

+ func (v KvmrunVersion) String() string

+ func (v KvmrunVersion) ToInt() int

+ type Machine struct

+ C Instance

+ Name string

+ R Instance

+ func GetMachine(vmname string, mon *qmp.Monitor) (*Machine, error)

+ type Memory struct

+ Actual int

+ Total int

+ type NetIface struct

+ Addr string

+ Bootindex int

+ Driver string

+ HwAddr string

+ Ifdown string

+ Ifname string

+ Ifup string

+ func (iface *NetIface) QdevID() string

+ type NetifPool []NetIface

+ func (p *NetifPool) Append(iface *NetIface)

+ func (p *NetifPool) Insert(iface *NetIface, idx int) error

+ func (p *NetifPool) Remove(ifname string) error

+ func (p *NetifPool) RemoveN(idx int) error

+ func (p NetifPool) Exists(ifname string) bool

+ func (p NetifPool) Get(ifname string) *NetIface

+ type NotConnectedError struct

+ Object string

+ Source string

+ func (e *NotConnectedError) Error() string

+ type NotFoundError struct

+ Name string

+ func (e *NotFoundError) Error() string

+ type NotRunningError struct

+ Name string

+ func (e *NotRunningError) Error() string

+ type Processor struct

+ Actual int

+ Model string

+ Quota int

+ Sockets int

+ Total int

+ type Proxy struct

+ Command string

+ Envs map[string]string

+ Path string

+ type ProxyPool []Proxy

+ func (p *ProxyPool) Append(proxy *Proxy)

+ func (p *ProxyPool) Insert(proxy *Proxy, idx int) error

+ func (p *ProxyPool) Remove(fullpath string) error

+ func (p *ProxyPool) RemoveN(idx int) error

+ func (p ProxyPool) Exists(fullpath string) bool

+ func (p ProxyPool) Get(fullpath string) *Proxy

+ type QemuChipset int32

+ const QEMU_CHIPSET_I440FX

+ const QEMU_CHIPSET_MICROVM

+ const QEMU_CHIPSET_Q35

+ const QEMU_CHIPSET_UNKNOWN

+ type QemuMachine struct

+ Chipset QemuChipset

+ func (m *QemuMachine) String() string

+ type QemuVersion int

+ func (v QemuVersion) String() string

+ type SCSIBusInfo struct

+ Addr string

+ Type string

+ type StartupConf struct

+ func (c StartupConf) Save() error

+ type VirtioVSock struct

+ Addr string

+ Auto bool

+ ContextID uint32

v1.0.1

Jun 20, 2022

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL