libvirt

README

libvirt-go

(Start of work on) Go bindings for libvirt (0.9.8 at this time).

Make sure to have libvirt-dev package (or the development files otherwise somewhere in your include path)

Documentation

• api documentation for the bindings
• api documentation for libvirt

Contributing

Please fork and write tests

Documentation

Index

• Constants
• func GetLastError() string
• type VirConnection
  • func NewVirConnection(uri string) (VirConnection, error)
  • func (c *VirConnection) CloseConnection() (int, error)
  • func (c *VirConnection) DomainDefineXML(xmlConfig string) (VirDomain, error)
  • func (c *VirConnection) DomainDefineXMLFromFile(xmlFile string) (VirDomain, error)
  • func (c *VirConnection) GetCapabilities() (string, error)
  • func (c *VirConnection) GetHostname() (string, error)
  • func (c *VirConnection) GetNodeInfo() (VirNodeInfo, error)
  • func (c *VirConnection) ListDefinedDomains() ([]string, error)
  • func (c *VirConnection) ListDomains() ([]uint32, error)
  • func (c *VirConnection) LookupDomainById(id uint32) (VirDomain, error)
  • func (c *VirConnection) LookupDomainByName(id string) (VirDomain, error)
  • func (c *VirConnection) UnrefAndCloseConnection() error
• type VirDomain
  • func (d *VirDomain) Create() error
  • func (d *VirDomain) CreateSnapshotXML(xml string, flags uint32) (VirDomainSnapshot, error)
  • func (d *VirDomain) Destroy() error
  • func (d *VirDomain) GetAutostart() (bool, error)
  • func (d *VirDomain) GetInfo() (VirDomainInfo, error)
  • func (d *VirDomain) GetName() (string, error)
  • func (d *VirDomain) GetState() ([]int, error)
  • func (d *VirDomain) GetUUID() ([]byte, error)
  • func (d *VirDomain) GetUUIDString() (string, error)
  • func (d *VirDomain) GetXMLDesc(flags uint32) (string, error)
  • func (d *VirDomain) IsActive() (bool, error)
  • func (d *VirDomain) Save(destFile string) error
  • func (d *VirDomain) SaveFlags(destFile string, destXml string, flags uint32) error
  • func (d *VirDomain) SetAutostart(autostart bool) error
• type VirDomainInfo
  • func (i *VirDomainInfo) GetCpuTime() uint64
  • func (i *VirDomainInfo) GetMaxMem() uint64
  • func (i *VirDomainInfo) GetMemory() uint64
  • func (i *VirDomainInfo) GetNrVirtCpu() uint16
  • func (i *VirDomainInfo) GetState() uint8
• type VirDomainSnapshot
• type VirNodeInfo
  • func (ni *VirNodeInfo) GetCPUs() uint32
  • func (ni *VirNodeInfo) GetCores() uint32
  • func (ni *VirNodeInfo) GetMemoryKB() uint64
  • func (ni *VirNodeInfo) GetMhz() uint32
  • func (ni *VirNodeInfo) GetModel() string
  • func (ni *VirNodeInfo) GetNodes() uint32
  • func (ni *VirNodeInfo) GetSockets() uint32
  • func (ni *VirNodeInfo) GetThreads() uint32

Constants

const (
	VIR_DOMAIN_RUNNING = C.VIR_DOMAIN_RUNNING
	VIR_DOMAIN_SHUTOFF = C.VIR_DOMAIN_SHUTOFF
)

Functions

func GetLastError

func GetLastError() string

Types

type VirConnection

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

func NewVirConnection

func NewVirConnection(uri string) (VirConnection, error)

func (*VirConnection) CloseConnection

func (c *VirConnection) CloseConnection() (int, error)

func (*VirConnection) DomainDefineXML

func (c *VirConnection) DomainDefineXML(xmlConfig string) (VirDomain, error)

func (*VirConnection) DomainDefineXMLFromFile

func (c *VirConnection) DomainDefineXMLFromFile(xmlFile string) (VirDomain, error)

func (*VirConnection) GetCapabilities

func (c *VirConnection) GetCapabilities() (string, error)

func (*VirConnection) GetHostname

func (c *VirConnection) GetHostname() (string, error)

func (*VirConnection) GetNodeInfo

func (c *VirConnection) GetNodeInfo() (VirNodeInfo, error)

func (*VirConnection) ListDefinedDomains

func (c *VirConnection) ListDefinedDomains() ([]string, error)

func (*VirConnection) ListDomains

func (c *VirConnection) ListDomains() ([]uint32, error)

func (*VirConnection) LookupDomainById

func (c *VirConnection) LookupDomainById(id uint32) (VirDomain, error)

func (*VirConnection) LookupDomainByName

func (c *VirConnection) LookupDomainByName(id string) (VirDomain, error)

func (*VirConnection) UnrefAndCloseConnection

func (c *VirConnection) UnrefAndCloseConnection() error

type VirDomain

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

func (*VirDomain) Create

func (d *VirDomain) Create() error

func (*VirDomain) CreateSnapshotXML

func (d *VirDomain) CreateSnapshotXML(xml string, flags uint32) (VirDomainSnapshot, error)

func (*VirDomain) Destroy

func (d *VirDomain) Destroy() error

func (*VirDomain) GetAutostart

func (d *VirDomain) GetAutostart() (bool, error)

func (*VirDomain) GetInfo

func (d *VirDomain) GetInfo() (VirDomainInfo, error)

func (*VirDomain) GetName

func (d *VirDomain) GetName() (string, error)

func (*VirDomain) GetState

func (d *VirDomain) GetState() ([]int, error)

func (*VirDomain) GetUUID

func (d *VirDomain) GetUUID() ([]byte, error)

func (*VirDomain) GetUUIDString

func (d *VirDomain) GetUUIDString() (string, error)

func (*VirDomain) GetXMLDesc

func (d *VirDomain) GetXMLDesc(flags uint32) (string, error)

func (*VirDomain) IsActive

func (d *VirDomain) IsActive() (bool, error)

func (*VirDomain) Save

func (d *VirDomain) Save(destFile string) error

func (*VirDomain) SaveFlags

func (d *VirDomain) SaveFlags(destFile string, destXml string, flags uint32) error

func (*VirDomain) SetAutostart

func (d *VirDomain) SetAutostart(autostart bool) error

type VirDomainInfo

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

func (*VirDomainInfo) GetCpuTime

func (i *VirDomainInfo) GetCpuTime() uint64

func (*VirDomainInfo) GetMaxMem

func (i *VirDomainInfo) GetMaxMem() uint64

func (*VirDomainInfo) GetMemory

func (i *VirDomainInfo) GetMemory() uint64

func (*VirDomainInfo) GetNrVirtCpu

func (i *VirDomainInfo) GetNrVirtCpu() uint16

func (*VirDomainInfo) GetState

func (i *VirDomainInfo) GetState() uint8

type VirDomainSnapshot

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

type VirNodeInfo

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

func (*VirNodeInfo) GetCPUs

func (ni *VirNodeInfo) GetCPUs() uint32

func (*VirNodeInfo) GetCores

func (ni *VirNodeInfo) GetCores() uint32

func (*VirNodeInfo) GetMemoryKB

func (ni *VirNodeInfo) GetMemoryKB() uint64

func (*VirNodeInfo) GetMhz

func (ni *VirNodeInfo) GetMhz() uint32

func (*VirNodeInfo) GetModel

func (ni *VirNodeInfo) GetModel() string

func (*VirNodeInfo) GetNodes

func (ni *VirNodeInfo) GetNodes() uint32

func (*VirNodeInfo) GetSockets

func (ni *VirNodeInfo) GetSockets() uint32

func (*VirNodeInfo) GetThreads

func (ni *VirNodeInfo) GetThreads() uint32