libvirt

package module
v2.13.0+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 14, 2016 License: MIT Imports: 9 Imported by: 1

README

libvirt-go Build Status GoDoc

Go bindings for libvirt.

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

Version Support

The minimum supported version of libvirt is 1.2.2. Due to the API/ABI compatibility promise of libvirt, more recent versions of libvirt should work too.

Some features require a more recent version of libvirt. They are disabled by default. If you want to enable them, build using one of those additional tags (you need to use only the most recent one you are interested in):

  • 1.2.14

For example:

go build -tags libvirt.1.2.14
OS Compatibility Matrix

To quickly see what version of libvirt your OS can easily support (may be outdated). Obviously, nothing below 1.2.2 is usable with these bindings.

OS Release libvirt Version
FC19 1.2.9 from libvirt.org/sources
Debian 8 1.2.9 from jessie
Debian 7 1.2.9 from wheezy-backports
Ubuntu 14.04 1.2.2 from trusty
Ubuntu 16.04 1.3.1 from xenial
RHEL 7 1.2.17
RHEL 6 0.10.x
RHEL 5 0.8.x
0.9.x Support

Previously there was support for libvirt 0.9.8 and below, however this is no longer being updated. These releases were tagged v1.x at gopkg.in/alexzorin/libvirt-go.v1 (docs).

Documentation

Contributing

Please fork and write tests.

Integration tests are available where functionality isn't provided by the test driver, see integration_test.go.

A Vagrantfile is included to run the integration tests:

  • cd ./vagrant
  • vagrant up to provision the virtual machine
  • vagrant ssh to login to the virtual machine

Once inside, sudo su - and go test -tags integration libvirt.

Documentation

Index

Constants

View Source
const (
	VIR_DOMAIN_NOSTATE     = C.VIR_DOMAIN_NOSTATE
	VIR_DOMAIN_RUNNING     = C.VIR_DOMAIN_RUNNING
	VIR_DOMAIN_BLOCKED     = C.VIR_DOMAIN_BLOCKED
	VIR_DOMAIN_PAUSED      = C.VIR_DOMAIN_PAUSED
	VIR_DOMAIN_SHUTDOWN    = C.VIR_DOMAIN_SHUTDOWN
	VIR_DOMAIN_CRASHED     = C.VIR_DOMAIN_CRASHED
	VIR_DOMAIN_PMSUSPENDED = C.VIR_DOMAIN_PMSUSPENDED
	VIR_DOMAIN_SHUTOFF     = C.VIR_DOMAIN_SHUTOFF
)

virDomainState

View Source
const (
	VIR_CONNECT_CLOSE_REASON_ERROR     = C.VIR_CONNECT_CLOSE_REASON_ERROR
	VIR_CONNECT_CLOSE_REASON_EOF       = C.VIR_CONNECT_CLOSE_REASON_EOF
	VIR_CONNECT_CLOSE_REASON_KEEPALIVE = C.VIR_CONNECT_CLOSE_REASON_KEEPALIVE
	VIR_CONNECT_CLOSE_REASON_CLIENT    = C.VIR_CONNECT_CLOSE_REASON_CLIENT
)

virConnectCloseReason

View Source
const (
	VIR_CONNECT_LIST_DOMAINS_ACTIVE         = C.VIR_CONNECT_LIST_DOMAINS_ACTIVE
	VIR_CONNECT_LIST_DOMAINS_INACTIVE       = C.VIR_CONNECT_LIST_DOMAINS_INACTIVE
	VIR_CONNECT_LIST_DOMAINS_PERSISTENT     = C.VIR_CONNECT_LIST_DOMAINS_PERSISTENT
	VIR_CONNECT_LIST_DOMAINS_TRANSIENT      = C.VIR_CONNECT_LIST_DOMAINS_TRANSIENT
	VIR_CONNECT_LIST_DOMAINS_RUNNING        = C.VIR_CONNECT_LIST_DOMAINS_RUNNING
	VIR_CONNECT_LIST_DOMAINS_PAUSED         = C.VIR_CONNECT_LIST_DOMAINS_PAUSED
	VIR_CONNECT_LIST_DOMAINS_SHUTOFF        = C.VIR_CONNECT_LIST_DOMAINS_SHUTOFF
	VIR_CONNECT_LIST_DOMAINS_OTHER          = C.VIR_CONNECT_LIST_DOMAINS_OTHER
	VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE    = C.VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE
	VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE = C.VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE
	VIR_CONNECT_LIST_DOMAINS_AUTOSTART      = C.VIR_CONNECT_LIST_DOMAINS_AUTOSTART
	VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART   = C.VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART
	VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT   = C.VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT
	VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT    = C.VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT
)

virConnectListAllDomainsFlags

View Source
const (
	VIR_DOMAIN_METADATA_DESCRIPTION = C.VIR_DOMAIN_METADATA_DESCRIPTION
	VIR_DOMAIN_METADATA_TITLE       = C.VIR_DOMAIN_METADATA_TITLE
	VIR_DOMAIN_METADATA_ELEMENT     = C.VIR_DOMAIN_METADATA_ELEMENT
)

virDomainMetadataType

View Source
const (
	VIR_DOMAIN_VCPU_CONFIG  = C.VIR_DOMAIN_VCPU_CONFIG
	VIR_DOMAIN_VCPU_CURRENT = C.VIR_DOMAIN_VCPU_CURRENT
	VIR_DOMAIN_VCPU_LIVE    = C.VIR_DOMAIN_VCPU_LIVE
	VIR_DOMAIN_VCPU_MAXIMUM = C.VIR_DOMAIN_VCPU_MAXIMUM
	VIR_DOMAIN_VCPU_GUEST   = C.VIR_DOMAIN_VCPU_GUEST
)

virDomainVcpuFlags

View Source
const (
	VIR_DOMAIN_AFFECT_CONFIG  = C.VIR_DOMAIN_AFFECT_CONFIG
	VIR_DOMAIN_AFFECT_CURRENT = C.VIR_DOMAIN_AFFECT_CURRENT
	VIR_DOMAIN_AFFECT_LIVE    = C.VIR_DOMAIN_AFFECT_LIVE
)

virDomainModificationImpact

View Source
const (
	VIR_DOMAIN_MEM_CONFIG  = C.VIR_DOMAIN_AFFECT_CONFIG
	VIR_DOMAIN_MEM_CURRENT = C.VIR_DOMAIN_AFFECT_CURRENT
	VIR_DOMAIN_MEM_LIVE    = C.VIR_DOMAIN_AFFECT_LIVE
	VIR_DOMAIN_MEM_MAXIMUM = C.VIR_DOMAIN_MEM_MAXIMUM
)

virDomainMemoryModFlags

View Source
const (
	VIR_STORAGE_POOL_INACTIVE     = C.VIR_STORAGE_POOL_INACTIVE     // Not running
	VIR_STORAGE_POOL_BUILDING     = C.VIR_STORAGE_POOL_BUILDING     // Initializing pool,not available
	VIR_STORAGE_POOL_RUNNING      = C.VIR_STORAGE_POOL_RUNNING      // Running normally
	VIR_STORAGE_POOL_DEGRADED     = C.VIR_STORAGE_POOL_DEGRADED     // Running degraded
	VIR_STORAGE_POOL_INACCESSIBLE = C.VIR_STORAGE_POOL_INACCESSIBLE // Running,but not accessible
)

virStoragePoolState

View Source
const (
	VIR_STORAGE_POOL_BUILD_NEW          = C.VIR_STORAGE_POOL_BUILD_NEW          // Regular build from scratch
	VIR_STORAGE_POOL_BUILD_REPAIR       = C.VIR_STORAGE_POOL_BUILD_REPAIR       // Repair / reinitialize
	VIR_STORAGE_POOL_BUILD_RESIZE       = C.VIR_STORAGE_POOL_BUILD_RESIZE       // Extend existing pool
	VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = C.VIR_STORAGE_POOL_BUILD_NO_OVERWRITE // Do not overwrite existing pool
	VIR_STORAGE_POOL_BUILD_OVERWRITE    = C.VIR_STORAGE_POOL_BUILD_OVERWRITE    // Overwrite data
)

virStoragePoolBuildFlags

View Source
const (
	VIR_DOMAIN_DESTROY_DEFAULT  = C.VIR_DOMAIN_DESTROY_DEFAULT
	VIR_DOMAIN_DESTROY_GRACEFUL = C.VIR_DOMAIN_DESTROY_GRACEFUL
)

virDomainDestroyFlags

View Source
const (
	VIR_DOMAIN_SHUTDOWN_DEFAULT        = C.VIR_DOMAIN_SHUTDOWN_DEFAULT
	VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN = C.VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN
	VIR_DOMAIN_SHUTDOWN_GUEST_AGENT    = C.VIR_DOMAIN_SHUTDOWN_GUEST_AGENT
	VIR_DOMAIN_SHUTDOWN_INITCTL        = C.VIR_DOMAIN_SHUTDOWN_INITCTL
	VIR_DOMAIN_SHUTDOWN_SIGNAL         = C.VIR_DOMAIN_SHUTDOWN_SIGNAL
)

virDomainShutdownFlags

View Source
const (
	VIR_DOMAIN_UNDEFINE_MANAGED_SAVE       = C.VIR_DOMAIN_UNDEFINE_MANAGED_SAVE       // Also remove any managed save
	VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATA = C.VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATA // If last use of domain, then also remove any snapshot metadata
	VIR_DOMAIN_UNDEFINE_NVRAM              = C.VIR_DOMAIN_UNDEFINE_NVRAM              // Also remove any nvram file
)

virDomainUndefineFlags

View Source
const (
	VIR_DOMAIN_DEVICE_MODIFY_CONFIG  = C.VIR_DOMAIN_AFFECT_CONFIG
	VIR_DOMAIN_DEVICE_MODIFY_CURRENT = C.VIR_DOMAIN_AFFECT_CURRENT
	VIR_DOMAIN_DEVICE_MODIFY_LIVE    = C.VIR_DOMAIN_AFFECT_LIVE
	VIR_DOMAIN_DEVICE_MODIFY_FORCE   = C.VIR_DOMAIN_DEVICE_MODIFY_FORCE
)

virDomainAttachDeviceFlags

View Source
const (
	VIR_STORAGE_VOL_DELETE_NORMAL = C.VIR_STORAGE_VOL_DELETE_NORMAL // Delete metadata only (fast)
	VIR_STORAGE_VOL_DELETE_ZEROED = C.VIR_STORAGE_VOL_DELETE_ZEROED // Clear all data to zeros (slow)
)

virStorageVolDeleteFlags

View Source
const (
	VIR_STORAGE_VOL_RESIZE_ALLOCATE = C.VIR_STORAGE_VOL_RESIZE_ALLOCATE // force allocation of new size
	VIR_STORAGE_VOL_RESIZE_DELTA    = C.VIR_STORAGE_VOL_RESIZE_DELTA    // size is relative to current
	VIR_STORAGE_VOL_RESIZE_SHRINK   = C.VIR_STORAGE_VOL_RESIZE_SHRINK   // allow decrease in capacity
)

virStorageVolResizeFlags

View Source
const (
	VIR_STORAGE_VOL_FILE    = C.VIR_STORAGE_VOL_FILE    // Regular file based volumes
	VIR_STORAGE_VOL_BLOCK   = C.VIR_STORAGE_VOL_BLOCK   // Block based volumes
	VIR_STORAGE_VOL_DIR     = C.VIR_STORAGE_VOL_DIR     // Directory-passthrough based volume
	VIR_STORAGE_VOL_NETWORK = C.VIR_STORAGE_VOL_NETWORK //Network volumes like RBD (RADOS Block Device)
	VIR_STORAGE_VOL_NETDIR  = C.VIR_STORAGE_VOL_NETDIR  // Network accessible directory that can contain other network volumes
)

virStorageVolType

View Source
const (
	VIR_STORAGE_VOL_WIPE_ALG_ZERO       = C.VIR_STORAGE_VOL_WIPE_ALG_ZERO       // 1-pass, all zeroes
	VIR_STORAGE_VOL_WIPE_ALG_NNSA       = C.VIR_STORAGE_VOL_WIPE_ALG_NNSA       // 4-pass NNSA Policy Letter NAP-14.1-C (XVI-8)
	VIR_STORAGE_VOL_WIPE_ALG_DOD        = C.VIR_STORAGE_VOL_WIPE_ALG_DOD        // 4-pass DoD 5220.22-M section 8-306 procedure
	VIR_STORAGE_VOL_WIPE_ALG_BSI        = C.VIR_STORAGE_VOL_WIPE_ALG_BSI        // 9-pass method recommended by the German Center of Security in Information Technologies
	VIR_STORAGE_VOL_WIPE_ALG_GUTMANN    = C.VIR_STORAGE_VOL_WIPE_ALG_GUTMANN    // The canonical 35-pass sequence
	VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER   = C.VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER   // 7-pass method described by Bruce Schneier in "Applied Cryptography" (1996)
	VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7  = C.VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7  // 7-pass random
	VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = C.VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 // 33-pass random
	VIR_STORAGE_VOL_WIPE_ALG_RANDOM     = C.VIR_STORAGE_VOL_WIPE_ALG_RANDOM     // 1-pass random
)

virStorageVolWipeAlgorithm

View Source
const (
	VIR_SECRET_USAGE_TYPE_NONE   = C.VIR_SECRET_USAGE_TYPE_NONE
	VIR_SECRET_USAGE_TYPE_VOLUME = C.VIR_SECRET_USAGE_TYPE_VOLUME
	VIR_SECRET_USAGE_TYPE_CEPH   = C.VIR_SECRET_USAGE_TYPE_CEPH
	VIR_SECRET_USAGE_TYPE_ISCSI  = C.VIR_SECRET_USAGE_TYPE_ISCSI
)

virSecretUsageType

View Source
const (
	VIR_CONNECT_LIST_NETWORKS_INACTIVE     = C.VIR_CONNECT_LIST_NETWORKS_INACTIVE
	VIR_CONNECT_LIST_NETWORKS_ACTIVE       = C.VIR_CONNECT_LIST_NETWORKS_ACTIVE
	VIR_CONNECT_LIST_NETWORKS_PERSISTENT   = C.VIR_CONNECT_LIST_NETWORKS_PERSISTENT
	VIR_CONNECT_LIST_NETWORKS_TRANSIENT    = C.VIR_CONNECT_LIST_NETWORKS_TRANSIENT
	VIR_CONNECT_LIST_NETWORKS_AUTOSTART    = C.VIR_CONNECT_LIST_NETWORKS_AUTOSTART
	VIR_CONNECT_LIST_NETWORKS_NO_AUTOSTART = C.VIR_CONNECT_LIST_NETWORKS_NO_AUTOSTART
)

virConnectListAllNetworksFlags

View Source
const (
	VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE     = C.VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE
	VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE       = C.VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE
	VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT   = C.VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT
	VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT    = C.VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT
	VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART    = C.VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART
	VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART = C.VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART
	VIR_CONNECT_LIST_STORAGE_POOLS_DIR          = C.VIR_CONNECT_LIST_STORAGE_POOLS_DIR
	VIR_CONNECT_LIST_STORAGE_POOLS_FS           = C.VIR_CONNECT_LIST_STORAGE_POOLS_FS
	VIR_CONNECT_LIST_STORAGE_POOLS_NETFS        = C.VIR_CONNECT_LIST_STORAGE_POOLS_NETFS
	VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL      = C.VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL
	VIR_CONNECT_LIST_STORAGE_POOLS_DISK         = C.VIR_CONNECT_LIST_STORAGE_POOLS_DISK
	VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI        = C.VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI
	VIR_CONNECT_LIST_STORAGE_POOLS_SCSI         = C.VIR_CONNECT_LIST_STORAGE_POOLS_SCSI
	VIR_CONNECT_LIST_STORAGE_POOLS_MPATH        = C.VIR_CONNECT_LIST_STORAGE_POOLS_MPATH
	VIR_CONNECT_LIST_STORAGE_POOLS_RBD          = C.VIR_CONNECT_LIST_STORAGE_POOLS_RBD
	VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG     = C.VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG
	VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER      = C.VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER
)

virConnectListAllStoragePoolsFlags

View Source
const (
	VIR_KEYCODE_SET_LINUX  = C.VIR_KEYCODE_SET_LINUX
	VIR_KEYCODE_SET_XT     = C.VIR_KEYCODE_SET_XT
	VIR_KEYCODE_SET_ATSET1 = C.VIR_KEYCODE_SET_ATSET1
	VIR_KEYCODE_SET_ATSET2 = C.VIR_KEYCODE_SET_ATSET2
	VIR_KEYCODE_SET_ATSET3 = C.VIR_KEYCODE_SET_ATSET3
	VIR_KEYCODE_SET_OSX    = C.VIR_KEYCODE_SET_OSX
	VIR_KEYCODE_SET_XT_KBD = C.VIR_KEYCODE_SET_XT_KBD
	VIR_KEYCODE_SET_USB    = C.VIR_KEYCODE_SET_USB
	VIR_KEYCODE_SET_WIN32  = C.VIR_KEYCODE_SET_WIN32
	VIR_KEYCODE_SET_RFB    = C.VIR_KEYCODE_SET_RFB
)

virKeycodeSet

View Source
const (
	VIR_DOMAIN_NONE               = C.VIR_DOMAIN_NONE
	VIR_DOMAIN_START_PAUSED       = C.VIR_DOMAIN_START_PAUSED
	VIR_DOMAIN_START_AUTODESTROY  = C.VIR_DOMAIN_START_AUTODESTROY
	VIR_DOMAIN_START_BYPASS_CACHE = C.VIR_DOMAIN_START_BYPASS_CACHE
	VIR_DOMAIN_START_FORCE_BOOT   = C.VIR_DOMAIN_START_FORCE_BOOT
)

virDomainCreateFlags

View Source
const (
	// event parameter in the callback is of type DomainLifecycleEvent
	VIR_DOMAIN_EVENT_ID_LIFECYCLE = C.VIR_DOMAIN_EVENT_ID_LIFECYCLE

	// event parameter in the callback is nil
	VIR_DOMAIN_EVENT_ID_REBOOT = C.VIR_DOMAIN_EVENT_ID_REBOOT

	// event parameter in the callback is of type DomainRTCChangeEvent
	VIR_DOMAIN_EVENT_ID_RTC_CHANGE = C.VIR_DOMAIN_EVENT_ID_RTC_CHANGE

	// event parameter in the callback is of type DomainWatchdogEvent
	VIR_DOMAIN_EVENT_ID_WATCHDOG = C.VIR_DOMAIN_EVENT_ID_WATCHDOG

	// event parameter in the callback is of type DomainIOErrorEvent
	VIR_DOMAIN_EVENT_ID_IO_ERROR = C.VIR_DOMAIN_EVENT_ID_IO_ERROR

	// event parameter in the callback is of type DomainGraphicsEvent
	VIR_DOMAIN_EVENT_ID_GRAPHICS = C.VIR_DOMAIN_EVENT_ID_GRAPHICS

	// virConnectDomainEventIOErrorReasonCallback
	VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON = C.VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON

	// event parameter in the callback is nil
	VIR_DOMAIN_EVENT_ID_CONTROL_ERROR = C.VIR_DOMAIN_EVENT_ID_CONTROL_ERROR

	// event parameter in the callback is of type DomainBlockJobEvent
	VIR_DOMAIN_EVENT_ID_BLOCK_JOB = C.VIR_DOMAIN_EVENT_ID_BLOCK_JOB

	// event parameter in the callback is of type DomainDiskChangeEvent
	VIR_DOMAIN_EVENT_ID_DISK_CHANGE = C.VIR_DOMAIN_EVENT_ID_DISK_CHANGE

	// event parameter in the callback is of type DomainTrayChangeEvent
	VIR_DOMAIN_EVENT_ID_TRAY_CHANGE = C.VIR_DOMAIN_EVENT_ID_TRAY_CHANGE

	// event parameter in the callback is of type DomainReasonEvent
	VIR_DOMAIN_EVENT_ID_PMWAKEUP = C.VIR_DOMAIN_EVENT_ID_PMWAKEUP

	// event parameter in the callback is of type DomainReasonEvent
	VIR_DOMAIN_EVENT_ID_PMSUSPEND = C.VIR_DOMAIN_EVENT_ID_PMSUSPEND

	// event parameter in the callback is of type DomainBalloonChangeEvent
	VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE = C.VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE

	// event parameter in the callback is of type DomainReasonEvent
	VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK = C.VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK

	// event parameter in the callback is of type DomainDeviceRemovedEvent
	VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED = C.VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED
)

virDomainEventID

View Source
const (
	VIR_DOMAIN_EVENT_DEFINED     = C.VIR_DOMAIN_EVENT_DEFINED
	VIR_DOMAIN_EVENT_UNDEFINED   = C.VIR_DOMAIN_EVENT_UNDEFINED
	VIR_DOMAIN_EVENT_STARTED     = C.VIR_DOMAIN_EVENT_STARTED
	VIR_DOMAIN_EVENT_SUSPENDED   = C.VIR_DOMAIN_EVENT_SUSPENDED
	VIR_DOMAIN_EVENT_RESUMED     = C.VIR_DOMAIN_EVENT_RESUMED
	VIR_DOMAIN_EVENT_STOPPED     = C.VIR_DOMAIN_EVENT_STOPPED
	VIR_DOMAIN_EVENT_SHUTDOWN    = C.VIR_DOMAIN_EVENT_SHUTDOWN
	VIR_DOMAIN_EVENT_PMSUSPENDED = C.VIR_DOMAIN_EVENT_PMSUSPENDED
	VIR_DOMAIN_EVENT_CRASHED     = C.VIR_DOMAIN_EVENT_CRASHED
)

virDomainEventType

View Source
const (
	// No action, watchdog ignored
	VIR_DOMAIN_EVENT_WATCHDOG_NONE = C.VIR_DOMAIN_EVENT_WATCHDOG_NONE

	// Guest CPUs are paused
	VIR_DOMAIN_EVENT_WATCHDOG_PAUSE = C.VIR_DOMAIN_EVENT_WATCHDOG_PAUSE

	// Guest CPUs are reset
	VIR_DOMAIN_EVENT_WATCHDOG_RESET = C.VIR_DOMAIN_EVENT_WATCHDOG_RESET

	// Guest is forcibly powered off
	VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF = C.VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF

	// Guest is requested to gracefully shutdown
	VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWN = C.VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWN

	// No action, a debug message logged
	VIR_DOMAIN_EVENT_WATCHDOG_DEBUG = C.VIR_DOMAIN_EVENT_WATCHDOG_DEBUG
)

virDomainEventWatchdogAction: The action that is to be taken due to the watchdog device firing

View Source
const (
	// No action, IO error ignored
	VIR_DOMAIN_EVENT_IO_ERROR_NONE = C.VIR_DOMAIN_EVENT_IO_ERROR_NONE

	// Guest CPUs are paused
	VIR_DOMAIN_EVENT_IO_ERROR_PAUSE = C.VIR_DOMAIN_EVENT_IO_ERROR_PAUSE

	// IO error reported to guest OS
	VIR_DOMAIN_EVENT_IO_ERROR_REPORT = C.VIR_DOMAIN_EVENT_IO_ERROR_REPORT
)

virDomainEventIOErrorAction The action that is to be taken due to an IO error occurring

View Source
const (
	// Initial socket connection established
	VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = C.VIR_DOMAIN_EVENT_GRAPHICS_CONNECT

	// Authentication & setup completed
	VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE = C.VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE

	// Final socket disconnection
	VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECT = C.VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECT
)

virDomainEventGraphicsPhase The phase of the graphics client connection

View Source
const (
	// IPv4 address
	VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4 = C.VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4

	// IPv6 address
	VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6 = C.VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6

	// UNIX socket path
	VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX = C.VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX
)

virDomainEventGraphicsAddressType

View Source
const (
	// Placeholder
	VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWN = C.VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWN

	// Block Pull (virDomainBlockPull, or virDomainBlockRebase without
	// flags), job ends on completion
	VIR_DOMAIN_BLOCK_JOB_TYPE_PULL = C.VIR_DOMAIN_BLOCK_JOB_TYPE_PULL

	// Block Copy (virDomainBlockCopy, or virDomainBlockRebase with
	// flags), job exists as long as mirroring is active
	VIR_DOMAIN_BLOCK_JOB_TYPE_COPY = C.VIR_DOMAIN_BLOCK_JOB_TYPE_COPY

	// Block Commit (virDomainBlockCommit without flags), job ends on
	// completion
	VIR_DOMAIN_BLOCK_JOB_TYPE_COMMIT = C.VIR_DOMAIN_BLOCK_JOB_TYPE_COMMIT
)

virDomainBlockJobType

View Source
const (
	VIR_DOMAIN_BLOCK_JOB_COMPLETED = C.VIR_DOMAIN_BLOCK_JOB_COMPLETED
	VIR_DOMAIN_BLOCK_JOB_FAILED    = C.VIR_DOMAIN_BLOCK_JOB_FAILED
	VIR_DOMAIN_BLOCK_JOB_CANCELED  = C.VIR_DOMAIN_BLOCK_JOB_CANCELED
	VIR_DOMAIN_BLOCK_JOB_READY     = C.VIR_DOMAIN_BLOCK_JOB_READY
)

virConnectDomainEventBlockJobStatus

View Source
const (
	// OldSrcPath is set
	VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START = C.VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START
	VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START   = C.VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START
)

virConnectDomainEventDiskChangeReason

View Source
const (
	VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN  = C.VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN
	VIR_DOMAIN_EVENT_TRAY_CHANGE_CLOSE = C.VIR_DOMAIN_EVENT_TRAY_CHANGE_CLOSE
)

virConnectDomainEventTrayChangeReason

View Source
const (
	VIR_DOMAIN_RUNNING_UNKNOWN            = C.VIR_DOMAIN_RUNNING_UNKNOWN
	VIR_DOMAIN_RUNNING_BOOTED             = C.VIR_DOMAIN_RUNNING_BOOTED             /* normal startup from boot */
	VIR_DOMAIN_RUNNING_MIGRATED           = C.VIR_DOMAIN_RUNNING_MIGRATED           /* migrated from another host */
	VIR_DOMAIN_RUNNING_RESTORED           = C.VIR_DOMAIN_RUNNING_RESTORED           /* restored from a state file */
	VIR_DOMAIN_RUNNING_FROM_SNAPSHOT      = C.VIR_DOMAIN_RUNNING_FROM_SNAPSHOT      /* restored from snapshot */
	VIR_DOMAIN_RUNNING_UNPAUSED           = C.VIR_DOMAIN_RUNNING_UNPAUSED           /* returned from paused state */
	VIR_DOMAIN_RUNNING_MIGRATION_CANCELED = C.VIR_DOMAIN_RUNNING_MIGRATION_CANCELED /* returned from migration */
	VIR_DOMAIN_RUNNING_SAVE_CANCELED      = C.VIR_DOMAIN_RUNNING_SAVE_CANCELED      /* returned from failed save process */
	VIR_DOMAIN_RUNNING_WAKEUP             = C.VIR_DOMAIN_RUNNING_WAKEUP             /* returned from pmsuspended due to wakeup event */
	VIR_DOMAIN_RUNNING_CRASHED            = C.VIR_DOMAIN_RUNNING_CRASHED            /* resumed from crashed */
)

virDomainRunningReason

View Source
const (
	VIR_DOMAIN_PAUSED_UNKNOWN       = C.VIR_DOMAIN_PAUSED_UNKNOWN       /* the reason is unknown */
	VIR_DOMAIN_PAUSED_USER          = C.VIR_DOMAIN_PAUSED_USER          /* paused on user request */
	VIR_DOMAIN_PAUSED_MIGRATION     = C.VIR_DOMAIN_PAUSED_MIGRATION     /* paused for offline migration */
	VIR_DOMAIN_PAUSED_SAVE          = C.VIR_DOMAIN_PAUSED_SAVE          /* paused for save */
	VIR_DOMAIN_PAUSED_DUMP          = C.VIR_DOMAIN_PAUSED_DUMP          /* paused for offline core dump */
	VIR_DOMAIN_PAUSED_IOERROR       = C.VIR_DOMAIN_PAUSED_IOERROR       /* paused due to a disk I/O error */
	VIR_DOMAIN_PAUSED_WATCHDOG      = C.VIR_DOMAIN_PAUSED_WATCHDOG      /* paused due to a watchdog event */
	VIR_DOMAIN_PAUSED_FROM_SNAPSHOT = C.VIR_DOMAIN_PAUSED_FROM_SNAPSHOT /* paused after restoring from snapshot */
	VIR_DOMAIN_PAUSED_SHUTTING_DOWN = C.VIR_DOMAIN_PAUSED_SHUTTING_DOWN /* paused during shutdown process */
	VIR_DOMAIN_PAUSED_SNAPSHOT      = C.VIR_DOMAIN_PAUSED_SNAPSHOT      /* paused while creating a snapshot */
	VIR_DOMAIN_PAUSED_CRASHED       = C.VIR_DOMAIN_PAUSED_CRASHED       /* paused due to a guest crash */
)

virDomainPausedReason

View Source
const (
	VIR_DOMAIN_XML_SECURE     = C.VIR_DOMAIN_XML_SECURE     /* dump security sensitive information too */
	VIR_DOMAIN_XML_INACTIVE   = C.VIR_DOMAIN_XML_INACTIVE   /* dump inactive domain information */
	VIR_DOMAIN_XML_UPDATE_CPU = C.VIR_DOMAIN_XML_UPDATE_CPU /* update guest CPU requirements according to host CPU */
	VIR_DOMAIN_XML_MIGRATABLE = C.VIR_DOMAIN_XML_MIGRATABLE /* dump XML suitable for migration */
)

virDomainXMLFlags

View Source
const (
	VIR_DOMAIN_QEMU_MONITOR_COMMAND_DEFAULT = 0
	VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP     = (1 << 0)
)

* QMP has two different kinds of ways to talk to QEMU. One is legacy (HMP, * or 'human' monitor protocol. The default is QMP, which is all-JSON. * * QMP json commands are of the format: * {"execute" : "query-cpus"} * * whereas the same command in 'HMP' would be: * 'info cpus'

View Source
const (
	VIR_DOMAIN_EVENT_DEFINED_ADDED   = C.VIR_DOMAIN_EVENT_DEFINED_ADDED
	VIR_DOMAIN_EVENT_DEFINED_UPDATED = C.VIR_DOMAIN_EVENT_DEFINED_UPDATED
)

virDomainEventDefinedDetailType

View Source
const (
	VIR_DOMAIN_EVENT_STARTED_BOOTED        = C.VIR_DOMAIN_EVENT_STARTED_BOOTED
	VIR_DOMAIN_EVENT_STARTED_MIGRATED      = C.VIR_DOMAIN_EVENT_STARTED_MIGRATED
	VIR_DOMAIN_EVENT_STARTED_RESTORED      = C.VIR_DOMAIN_EVENT_STARTED_RESTORED
	VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOT = C.VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOT
	VIR_DOMAIN_EVENT_STARTED_WAKEUP        = C.VIR_DOMAIN_EVENT_STARTED_WAKEUP
)

virDomainEventStartedDetailType

View Source
const (
	VIR_DOMAIN_EVENT_SUSPENDED_PAUSED        = C.VIR_DOMAIN_EVENT_SUSPENDED_PAUSED
	VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED      = C.VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED
	VIR_DOMAIN_EVENT_SUSPENDED_IOERROR       = C.VIR_DOMAIN_EVENT_SUSPENDED_IOERROR
	VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG      = C.VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG
	VIR_DOMAIN_EVENT_SUSPENDED_RESTORED      = C.VIR_DOMAIN_EVENT_SUSPENDED_RESTORED
	VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT = C.VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT
	VIR_DOMAIN_EVENT_SUSPENDED_API_ERROR     = C.VIR_DOMAIN_EVENT_SUSPENDED_API_ERROR
)

virDomainEventSuspendedDetailType

View Source
const (
	VIR_DOMAIN_EVENT_RESUMED_UNPAUSED      = C.VIR_DOMAIN_EVENT_RESUMED_UNPAUSED
	VIR_DOMAIN_EVENT_RESUMED_MIGRATED      = C.VIR_DOMAIN_EVENT_RESUMED_MIGRATED
	VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT = C.VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT
)

virDomainEventResumedDetailType

View Source
const (
	VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN      = C.VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN
	VIR_DOMAIN_EVENT_STOPPED_DESTROYED     = C.VIR_DOMAIN_EVENT_STOPPED_DESTROYED
	VIR_DOMAIN_EVENT_STOPPED_CRASHED       = C.VIR_DOMAIN_EVENT_STOPPED_CRASHED
	VIR_DOMAIN_EVENT_STOPPED_MIGRATED      = C.VIR_DOMAIN_EVENT_STOPPED_MIGRATED
	VIR_DOMAIN_EVENT_STOPPED_SAVED         = C.VIR_DOMAIN_EVENT_STOPPED_SAVED
	VIR_DOMAIN_EVENT_STOPPED_FAILED        = C.VIR_DOMAIN_EVENT_STOPPED_FAILED
	VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT = C.VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT
)

virDomainEventStoppedDetailType

View Source
const (
	VIR_DOMAIN_MEMORY_STAT_LAST           = C.VIR_DOMAIN_MEMORY_STAT_NR
	VIR_DOMAIN_MEMORY_STAT_SWAP_IN        = C.VIR_DOMAIN_MEMORY_STAT_SWAP_IN
	VIR_DOMAIN_MEMORY_STAT_SWAP_OUT       = C.VIR_DOMAIN_MEMORY_STAT_SWAP_OUT
	VIR_DOMAIN_MEMORY_STAT_MAJOR_FAULT    = C.VIR_DOMAIN_MEMORY_STAT_MAJOR_FAULT
	VIR_DOMAIN_MEMORY_STAT_MINOR_FAULT    = C.VIR_DOMAIN_MEMORY_STAT_MINOR_FAULT
	VIR_DOMAIN_MEMORY_STAT_UNUSED         = C.VIR_DOMAIN_MEMORY_STAT_UNUSED
	VIR_DOMAIN_MEMORY_STAT_AVAILABLE      = C.VIR_DOMAIN_MEMORY_STAT_AVAILABLE
	VIR_DOMAIN_MEMORY_STAT_ACTUAL_BALLOON = C.VIR_DOMAIN_MEMORY_STAT_ACTUAL_BALLOON
	VIR_DOMAIN_MEMORY_STAT_RSS            = C.VIR_DOMAIN_MEMORY_STAT_RSS
	VIR_DOMAIN_MEMORY_STAT_NR             = C.VIR_DOMAIN_MEMORY_STAT_NR
)

virDomainMemoryStatTags

View Source
const (
	VIR_DOMAIN_CPU_STATS_CPUTIME    = C.VIR_DOMAIN_CPU_STATS_CPUTIME
	VIR_DOMAIN_CPU_STATS_SYSTEMTIME = C.VIR_DOMAIN_CPU_STATS_SYSTEMTIME
	VIR_DOMAIN_CPU_STATS_USERTIME   = C.VIR_DOMAIN_CPU_STATS_USERTIME
	VIR_DOMAIN_CPU_STATS_VCPUTIME   = C.VIR_DOMAIN_CPU_STATS_VCPUTIME
)

virDomainCPUStatsTags

View Source
const (
	VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE = 0
	VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENT = 1
)

virDomainInterfaceAddressesSource

View Source
const (
	VIR_IP_ADDR_TYPE_IPV4 = 0
	VIR_IP_ADDR_TYPE_IPV6 = 1
)

virIPAddrType

View Source
const (
	VIR_ERR_NONE    = C.VIR_ERR_NONE
	VIR_ERR_WARNING = C.VIR_ERR_WARNING
	VIR_ERR_ERROR   = C.VIR_ERR_ERROR
)

virErrorLevel

View Source
const (
	VIR_ERR_OK = C.VIR_ERR_OK

	// internal error
	VIR_ERR_INTERNAL_ERROR = C.VIR_ERR_INTERNAL_ERROR

	// memory allocation failure
	VIR_ERR_NO_MEMORY = C.VIR_ERR_NO_MEMORY

	// no support for this function
	VIR_ERR_NO_SUPPORT = C.VIR_ERR_NO_SUPPORT

	// could not resolve hostname
	VIR_ERR_UNKNOWN_HOST = C.VIR_ERR_UNKNOWN_HOST

	// can't connect to hypervisor
	VIR_ERR_NO_CONNECT = C.VIR_ERR_NO_CONNECT

	// invalid connection object
	VIR_ERR_INVALID_CONN = C.VIR_ERR_INVALID_CONN

	// invalid domain object
	VIR_ERR_INVALID_DOMAIN = C.VIR_ERR_INVALID_DOMAIN

	// invalid function argument
	VIR_ERR_INVALID_ARG = C.VIR_ERR_INVALID_ARG

	// a command to hypervisor failed
	VIR_ERR_OPERATION_FAILED = C.VIR_ERR_OPERATION_FAILED

	// a HTTP GET command to failed
	VIR_ERR_GET_FAILED = C.VIR_ERR_GET_FAILED

	// a HTTP POST command to failed
	VIR_ERR_POST_FAILED = C.VIR_ERR_POST_FAILED

	// unexpected HTTP error code
	VIR_ERR_HTTP_ERROR = C.VIR_ERR_HTTP_ERROR

	// failure to serialize an S-Expr
	VIR_ERR_SEXPR_SERIAL = C.VIR_ERR_SEXPR_SERIAL

	// could not open Xen hypervisor control
	VIR_ERR_NO_XEN = C.VIR_ERR_NO_XEN

	// failure doing an hypervisor call
	VIR_ERR_XEN_CALL = C.VIR_ERR_XEN_CALL

	// unknown OS type
	VIR_ERR_OS_TYPE = C.VIR_ERR_OS_TYPE

	// missing kernel information
	VIR_ERR_NO_KERNEL = C.VIR_ERR_NO_KERNEL

	// missing root device information
	VIR_ERR_NO_ROOT = C.VIR_ERR_NO_ROOT

	// missing source device information
	VIR_ERR_NO_SOURCE = C.VIR_ERR_NO_SOURCE

	// missing target device information
	VIR_ERR_NO_TARGET = C.VIR_ERR_NO_TARGET

	// missing domain name information
	VIR_ERR_NO_NAME = C.VIR_ERR_NO_NAME

	// missing domain OS information
	VIR_ERR_NO_OS = C.VIR_ERR_NO_OS

	// missing domain devices information
	VIR_ERR_NO_DEVICE = C.VIR_ERR_NO_DEVICE

	// could not open Xen Store control
	VIR_ERR_NO_XENSTORE = C.VIR_ERR_NO_XENSTORE

	// too many drivers registered
	VIR_ERR_DRIVER_FULL = C.VIR_ERR_DRIVER_FULL

	// not supported by the drivers (DEPRECATED)
	VIR_ERR_CALL_FAILED = C.VIR_ERR_CALL_FAILED

	// an XML description is not well formed or broken
	VIR_ERR_XML_ERROR = C.VIR_ERR_XML_ERROR

	// the domain already exist
	VIR_ERR_DOM_EXIST = C.VIR_ERR_DOM_EXIST

	// operation forbidden on read-only connections
	VIR_ERR_OPERATION_DENIED = C.VIR_ERR_OPERATION_DENIED

	// failed to open a conf file
	VIR_ERR_OPEN_FAILED = C.VIR_ERR_OPEN_FAILED

	// failed to read a conf file
	VIR_ERR_READ_FAILED = C.VIR_ERR_READ_FAILED

	// failed to parse a conf file
	VIR_ERR_PARSE_FAILED = C.VIR_ERR_PARSE_FAILED

	// failed to parse the syntax of a conf file
	VIR_ERR_CONF_SYNTAX = C.VIR_ERR_CONF_SYNTAX

	// failed to write a conf file
	VIR_ERR_WRITE_FAILED = C.VIR_ERR_WRITE_FAILED

	// detail of an XML error
	VIR_ERR_XML_DETAIL = C.VIR_ERR_XML_DETAIL

	// invalid network object
	VIR_ERR_INVALID_NETWORK = C.VIR_ERR_INVALID_NETWORK

	// the network already exist
	VIR_ERR_NETWORK_EXIST = C.VIR_ERR_NETWORK_EXIST

	// general system call failure
	VIR_ERR_SYSTEM_ERROR = C.VIR_ERR_SYSTEM_ERROR

	// some sort of RPC error
	VIR_ERR_RPC = C.VIR_ERR_RPC

	// error from a GNUTLS call
	VIR_ERR_GNUTLS_ERROR = C.VIR_ERR_GNUTLS_ERROR

	// failed to start network
	VIR_WAR_NO_NETWORK = C.VIR_WAR_NO_NETWORK

	// domain not found or unexpectedly disappeared
	VIR_ERR_NO_DOMAIN = C.VIR_ERR_NO_DOMAIN

	// network not found
	VIR_ERR_NO_NETWORK = C.VIR_ERR_NO_NETWORK

	// invalid MAC address
	VIR_ERR_INVALID_MAC = C.VIR_ERR_INVALID_MAC

	// authentication failed
	VIR_ERR_AUTH_FAILED = C.VIR_ERR_AUTH_FAILED

	// invalid storage pool object
	VIR_ERR_INVALID_STORAGE_POOL = C.VIR_ERR_INVALID_STORAGE_POOL

	// invalid storage vol object
	VIR_ERR_INVALID_STORAGE_VOL = C.VIR_ERR_INVALID_STORAGE_VOL

	// failed to start storage
	VIR_WAR_NO_STORAGE = C.VIR_WAR_NO_STORAGE

	// storage pool not found
	VIR_ERR_NO_STORAGE_POOL = C.VIR_ERR_NO_STORAGE_POOL

	// storage volume not found
	VIR_ERR_NO_STORAGE_VOL = C.VIR_ERR_NO_STORAGE_VOL

	// failed to start node driver
	VIR_WAR_NO_NODE = C.VIR_WAR_NO_NODE

	// invalid node device object
	VIR_ERR_INVALID_NODE_DEVICE = C.VIR_ERR_INVALID_NODE_DEVICE

	// node device not found
	VIR_ERR_NO_NODE_DEVICE = C.VIR_ERR_NO_NODE_DEVICE

	// security model not found
	VIR_ERR_NO_SECURITY_MODEL = C.VIR_ERR_NO_SECURITY_MODEL

	// operation is not applicable at this time
	VIR_ERR_OPERATION_INVALID = C.VIR_ERR_OPERATION_INVALID

	// failed to start interface driver
	VIR_WAR_NO_INTERFACE = C.VIR_WAR_NO_INTERFACE

	// interface driver not running
	VIR_ERR_NO_INTERFACE = C.VIR_ERR_NO_INTERFACE

	// invalid interface object
	VIR_ERR_INVALID_INTERFACE = C.VIR_ERR_INVALID_INTERFACE

	// more than one matching interface found
	VIR_ERR_MULTIPLE_INTERFACES = C.VIR_ERR_MULTIPLE_INTERFACES

	// failed to start nwfilter driver
	VIR_WAR_NO_NWFILTER = C.VIR_WAR_NO_NWFILTER

	// invalid nwfilter object
	VIR_ERR_INVALID_NWFILTER = C.VIR_ERR_INVALID_NWFILTER

	// nw filter pool not found
	VIR_ERR_NO_NWFILTER = C.VIR_ERR_NO_NWFILTER

	// nw filter pool not found
	VIR_ERR_BUILD_FIREWALL = C.VIR_ERR_BUILD_FIREWALL

	// failed to start secret storage
	VIR_WAR_NO_SECRET = C.VIR_WAR_NO_SECRET

	// invalid secret
	VIR_ERR_INVALID_SECRET = C.VIR_ERR_INVALID_SECRET

	// secret not found
	VIR_ERR_NO_SECRET = C.VIR_ERR_NO_SECRET

	// unsupported configuration construct
	VIR_ERR_CONFIG_UNSUPPORTED = C.VIR_ERR_CONFIG_UNSUPPORTED

	// timeout occurred during operation
	VIR_ERR_OPERATION_TIMEOUT = C.VIR_ERR_OPERATION_TIMEOUT

	// a migration worked, but making the VM persist on the dest host failed
	VIR_ERR_MIGRATE_PERSIST_FAILED = C.VIR_ERR_MIGRATE_PERSIST_FAILED

	// a synchronous hook script failed
	VIR_ERR_HOOK_SCRIPT_FAILED = C.VIR_ERR_HOOK_SCRIPT_FAILED

	// invalid domain snapshot
	VIR_ERR_INVALID_DOMAIN_SNAPSHOT = C.VIR_ERR_INVALID_DOMAIN_SNAPSHOT

	// domain snapshot not found
	VIR_ERR_NO_DOMAIN_SNAPSHOT = C.VIR_ERR_NO_DOMAIN_SNAPSHOT

	// stream pointer not valid
	VIR_ERR_INVALID_STREAM = C.VIR_ERR_INVALID_STREAM

	// valid API use but unsupported by the given driver
	VIR_ERR_ARGUMENT_UNSUPPORTED = C.VIR_ERR_ARGUMENT_UNSUPPORTED

	// storage pool probe failed
	VIR_ERR_STORAGE_PROBE_FAILED = C.VIR_ERR_STORAGE_PROBE_FAILED

	// storage pool already built
	VIR_ERR_STORAGE_POOL_BUILT = C.VIR_ERR_STORAGE_POOL_BUILT

	// force was not requested for a risky domain snapshot revert
	VIR_ERR_SNAPSHOT_REVERT_RISKY = C.VIR_ERR_SNAPSHOT_REVERT_RISKY

	// operation on a domain was canceled/aborted by user
	VIR_ERR_OPERATION_ABORTED = C.VIR_ERR_OPERATION_ABORTED

	// authentication cancelled
	VIR_ERR_AUTH_CANCELLED = C.VIR_ERR_AUTH_CANCELLED

	// The metadata is not present
	VIR_ERR_NO_DOMAIN_METADATA = C.VIR_ERR_NO_DOMAIN_METADATA

	// Migration is not safe
	VIR_ERR_MIGRATE_UNSAFE = C.VIR_ERR_MIGRATE_UNSAFE

	// integer overflow
	VIR_ERR_OVERFLOW = C.VIR_ERR_OVERFLOW

	// action prevented by block copy job
	VIR_ERR_BLOCK_COPY_ACTIVE = C.VIR_ERR_BLOCK_COPY_ACTIVE

	// The requested operation is not supported
	VIR_ERR_OPERATION_UNSUPPORTED = C.VIR_ERR_OPERATION_UNSUPPORTED

	// error in ssh transport driver
	VIR_ERR_SSH = C.VIR_ERR_SSH

	// guest agent is unresponsive, not running or not usable
	VIR_ERR_AGENT_UNRESPONSIVE = C.VIR_ERR_AGENT_UNRESPONSIVE

	// resource is already in use
	VIR_ERR_RESOURCE_BUSY = C.VIR_ERR_RESOURCE_BUSY

	// operation on the object/resource was denied
	VIR_ERR_ACCESS_DENIED = C.VIR_ERR_ACCESS_DENIED

	// error from a dbus service
	VIR_ERR_DBUS_SERVICE = C.VIR_ERR_DBUS_SERVICE

	// the storage vol already exists
	VIR_ERR_STORAGE_VOL_EXIST = C.VIR_ERR_STORAGE_VOL_EXIST
)

virErrorNumber

View Source
const (
	VIR_FROM_NONE = C.VIR_FROM_NONE

	// Error at Xen hypervisor layer
	VIR_FROM_XEN = C.VIR_FROM_XEN

	// Error at connection with xend daemon
	VIR_FROM_XEND = C.VIR_FROM_XEND

	// Error at connection with xen store
	VIR_FROM_XENSTORE = C.VIR_FROM_XENSTORE

	// Error in the S-Expression code
	VIR_FROM_SEXPR = C.VIR_FROM_SEXPR

	// Error in the XML code
	VIR_FROM_XML = C.VIR_FROM_XML

	// Error when operating on a domain
	VIR_FROM_DOM = C.VIR_FROM_DOM

	// Error in the XML-RPC code
	VIR_FROM_RPC = C.VIR_FROM_RPC

	// Error in the proxy code; unused since 0.8.6
	VIR_FROM_PROXY = C.VIR_FROM_PROXY

	// Error in the configuration file handling
	VIR_FROM_CONF = C.VIR_FROM_CONF

	// Error at the QEMU daemon
	VIR_FROM_QEMU = C.VIR_FROM_QEMU

	// Error when operating on a network
	VIR_FROM_NET = C.VIR_FROM_NET

	// Error from test driver
	VIR_FROM_TEST = C.VIR_FROM_TEST

	// Error from remote driver
	VIR_FROM_REMOTE = C.VIR_FROM_REMOTE

	// Error from OpenVZ driver
	VIR_FROM_OPENVZ = C.VIR_FROM_OPENVZ

	// Error at Xen XM layer
	VIR_FROM_XENXM = C.VIR_FROM_XENXM

	// Error in the Linux Stats code
	VIR_FROM_STATS_LINUX = C.VIR_FROM_STATS_LINUX

	// Error from Linux Container driver
	VIR_FROM_LXC = C.VIR_FROM_LXC

	// Error from storage driver
	VIR_FROM_STORAGE = C.VIR_FROM_STORAGE

	// Error from network config
	VIR_FROM_NETWORK = C.VIR_FROM_NETWORK

	// Error from domain config
	VIR_FROM_DOMAIN = C.VIR_FROM_DOMAIN

	// Error at the UML driver
	VIR_FROM_UML = C.VIR_FROM_UML

	// Error from node device monitor
	VIR_FROM_NODEDEV = C.VIR_FROM_NODEDEV

	// Error from xen inotify layer
	VIR_FROM_XEN_INOTIFY = C.VIR_FROM_XEN_INOTIFY

	// Error from security framework
	VIR_FROM_SECURITY = C.VIR_FROM_SECURITY

	// Error from VirtualBox driver
	VIR_FROM_VBOX = C.VIR_FROM_VBOX

	// Error when operating on an interface
	VIR_FROM_INTERFACE = C.VIR_FROM_INTERFACE

	// The OpenNebula driver no longer exists. Retained for ABI/API compat only
	VIR_FROM_ONE = C.VIR_FROM_ONE

	// Error from ESX driver
	VIR_FROM_ESX = C.VIR_FROM_ESX

	// Error from IBM power hypervisor
	VIR_FROM_PHYP = C.VIR_FROM_PHYP

	// Error from secret storage
	VIR_FROM_SECRET = C.VIR_FROM_SECRET

	// Error from CPU driver
	VIR_FROM_CPU = C.VIR_FROM_CPU

	// Error from XenAPI
	VIR_FROM_XENAPI = C.VIR_FROM_XENAPI

	// Error from network filter driver
	VIR_FROM_NWFILTER = C.VIR_FROM_NWFILTER

	// Error from Synchronous hooks
	VIR_FROM_HOOK = C.VIR_FROM_HOOK

	// Error from domain snapshot
	VIR_FROM_DOMAIN_SNAPSHOT = C.VIR_FROM_DOMAIN_SNAPSHOT

	// Error from auditing subsystem
	VIR_FROM_AUDIT = C.VIR_FROM_AUDIT

	// Error from sysinfo/SMBIOS
	VIR_FROM_SYSINFO = C.VIR_FROM_SYSINFO

	// Error from I/O streams
	VIR_FROM_STREAMS = C.VIR_FROM_STREAMS

	// Error from VMware driver
	VIR_FROM_VMWARE = C.VIR_FROM_VMWARE

	// Error from event loop impl
	VIR_FROM_EVENT = C.VIR_FROM_EVENT

	// Error from libxenlight driver
	VIR_FROM_LIBXL = C.VIR_FROM_LIBXL

	// Error from lock manager
	VIR_FROM_LOCKING = C.VIR_FROM_LOCKING

	// Error from Hyper-V driver
	VIR_FROM_HYPERV = C.VIR_FROM_HYPERV

	// Error from capabilities
	VIR_FROM_CAPABILITIES = C.VIR_FROM_CAPABILITIES

	// Error from URI handling
	VIR_FROM_URI = C.VIR_FROM_URI

	// Error from auth handling
	VIR_FROM_AUTH = C.VIR_FROM_AUTH

	// Error from DBus
	VIR_FROM_DBUS = C.VIR_FROM_DBUS

	// Error from Parallels
	VIR_FROM_PARALLELS = C.VIR_FROM_PARALLELS

	// Error from Device
	VIR_FROM_DEVICE = C.VIR_FROM_DEVICE

	// Error from libssh2 connection transport
	VIR_FROM_SSH = C.VIR_FROM_SSH

	// Error from lockspace
	VIR_FROM_LOCKSPACE = C.VIR_FROM_LOCKSPACE

	// Error from initctl device communication
	VIR_FROM_INITCTL = C.VIR_FROM_INITCTL

	// Error from identity code
	VIR_FROM_IDENTITY = C.VIR_FROM_IDENTITY

	// Error from cgroups
	VIR_FROM_CGROUP = C.VIR_FROM_CGROUP

	// Error from access control manager
	VIR_FROM_ACCESS = C.VIR_FROM_ACCESS

	// Error from systemd code
	VIR_FROM_SYSTEMD = C.VIR_FROM_SYSTEMD

	// Error from bhyve driver
	VIR_FROM_BHYVE = C.VIR_FROM_BHYVE

	// Error from crypto code
	VIR_FROM_CRYPTO = C.VIR_FROM_CRYPTO

	// Error from firewall
	VIR_FROM_FIREWALL = C.VIR_FROM_FIREWALL
)

virErrorDomain

View Source
const (
	VIR_DOMAIN_EVENT_SHUTDOWN_FINISHED = C.VIR_DOMAIN_EVENT_SHUTDOWN_FINISHED
)

virDomainEventShutdownDetailType

View Source
const (
	VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = C.VIR_DOMAIN_EVENT_UNDEFINED_REMOVED
)

virDomainEventUndefinedDetailType

View Source
const VIR_DOMAIN_MEMORY_PARAM_UNLIMITED = C.VIR_DOMAIN_MEMORY_PARAM_UNLIMITED
View Source
const (
	VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA = C.VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA
)

virStorageVolCreateFlags

View Source
const (
	VIR_STREAM_NONBLOCK = C.VIR_STREAM_NONBLOCK
)

virStreamFlags

Variables

View Source
var ErrNoError = VirError{
	Code:    VIR_ERR_OK,
	Domain:  VIR_FROM_NONE,
	Message: "",
	Level:   VIR_ERR_NONE,
}

Functions

func EventRegisterDefaultImpl

func EventRegisterDefaultImpl() int

func EventRunDefaultImpl

func EventRunDefaultImpl() int

func GetVersion

func GetVersion() (uint32, error)

func SetErrorFunc

func SetErrorFunc(cb ErrorCallback, opaque func())

Types

type CloseCallback

type CloseCallback func(conn VirConnection, reason int, opaque func())

type DomainBalloonChangeEvent

type DomainBalloonChangeEvent struct {
	Actual uint64
}

func (DomainBalloonChangeEvent) String

func (e DomainBalloonChangeEvent) String() string

type DomainBlockJobEvent

type DomainBlockJobEvent struct {
	Disk   string
	Type   int
	Status int
}

func (DomainBlockJobEvent) String

func (e DomainBlockJobEvent) String() string

type DomainDeviceRemovedEvent

type DomainDeviceRemovedEvent struct {
	DevAlias string
}

func (DomainDeviceRemovedEvent) String

func (e DomainDeviceRemovedEvent) String() string

type DomainDiskChangeEvent

type DomainDiskChangeEvent struct {
	OldSrcPath string
	NewSrcPath string
	DevAlias   string
	Reason     int
}

func (DomainDiskChangeEvent) String

func (e DomainDiskChangeEvent) String() string

type DomainEventCallback

type DomainEventCallback func(c *VirConnection, d *VirDomain,
	event interface{}, f func()) int

DomainEventCallback is the signature of functions that can be registered as a domain event callback. The event parameter should be casted to the more specific event structure (eg. DomainLifecycleEvent). The return code is ignored.

type DomainEventGraphicsAddress

type DomainEventGraphicsAddress struct {
	Family  int
	Node    string
	Service string
}

type DomainEventGraphicsSubjectIdentity

type DomainEventGraphicsSubjectIdentity struct {
	Type string
	Name string
}

type DomainGraphicsEvent

type DomainGraphicsEvent struct {
	Phase      int
	Local      DomainEventGraphicsAddress
	Remote     DomainEventGraphicsAddress
	AuthScheme string
	Subject    []DomainEventGraphicsSubjectIdentity
}

func (DomainGraphicsEvent) String

func (e DomainGraphicsEvent) String() string

type DomainIOErrorEvent

type DomainIOErrorEvent struct {
	SrcPath  string
	DevAlias string
	Action   int
}

func (DomainIOErrorEvent) String

func (e DomainIOErrorEvent) String() string

type DomainIOErrorReasonEvent

type DomainIOErrorReasonEvent struct {
	DomainIOErrorEvent
	Reason string
}

func (DomainIOErrorReasonEvent) String

func (e DomainIOErrorReasonEvent) String() string

type DomainLifecycleEvent

type DomainLifecycleEvent struct {
	Event  int
	Detail int
}

func (DomainLifecycleEvent) String

func (e DomainLifecycleEvent) String() string

type DomainRTCChangeEvent

type DomainRTCChangeEvent struct {
	Utcoffset int64
}

func (DomainRTCChangeEvent) String

func (e DomainRTCChangeEvent) String() string

type DomainReasonEvent

type DomainReasonEvent struct {
	Reason int
}

type DomainTrayChangeEvent

type DomainTrayChangeEvent struct {
	DevAlias string
	Reason   int
}

func (DomainTrayChangeEvent) String

func (e DomainTrayChangeEvent) String() string

type DomainWatchdogEvent

type DomainWatchdogEvent struct {
	Action int
}

func (DomainWatchdogEvent) String

func (e DomainWatchdogEvent) String() string

type ErrorCallback

type ErrorCallback func(error VirError, opaque func())

Callback handling for errors

type VirConnection

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

func NewVirConnection

func NewVirConnection(uri string) (VirConnection, error)

func NewVirConnectionReadOnly added in v1.6.0

func NewVirConnectionReadOnly(uri string) (VirConnection, error)

func NewVirConnectionWithAuth

func NewVirConnectionWithAuth(uri string, username string, password string) (VirConnection, error)

func (*VirConnection) CloseConnection

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

func (*VirConnection) DomainCreateXML added in v1.10.0

func (c *VirConnection) DomainCreateXML(xmlConfig string, flags uint32) (VirDomain, error)

func (*VirConnection) DomainCreateXMLFromFile added in v1.10.0

func (c *VirConnection) DomainCreateXMLFromFile(xmlFile string, flags uint32) (VirDomain, 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) DomainEventDeregister

func (c *VirConnection) DomainEventDeregister(callbackId int) int

func (*VirConnection) DomainEventRegister

func (c *VirConnection) DomainEventRegister(dom VirDomain,
	eventId int,
	callback *DomainEventCallback,
	opaque func()) int

func (*VirConnection) GetCapabilities

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

func (*VirConnection) GetHostname

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

func (*VirConnection) GetLibVersion added in v1.10.0

func (c *VirConnection) GetLibVersion() (uint32, error)

func (*VirConnection) GetMaxVcpus added in v1.6.0

func (c *VirConnection) GetMaxVcpus(typeAttr string) (int, error)

func (*VirConnection) GetNodeInfo

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

func (*VirConnection) GetSysinfo added in v1.5.0

func (c *VirConnection) GetSysinfo(flags uint) (string, error)

func (*VirConnection) GetType added in v1.3.0

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

func (*VirConnection) GetURI added in v1.5.0

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

func (*VirConnection) InterfaceDefineXML added in v1.7.0

func (c *VirConnection) InterfaceDefineXML(xmlConfig string, flags uint32) (VirInterface, error)

func (*VirConnection) InterfaceDefineXMLFromFile added in v1.7.0

func (c *VirConnection) InterfaceDefineXMLFromFile(xmlFile string) (VirInterface, error)

func (*VirConnection) IsAlive added in v1.3.0

func (c *VirConnection) IsAlive() (bool, error)

func (*VirConnection) IsEncrypted added in v1.3.0

func (c *VirConnection) IsEncrypted() (bool, error)

func (*VirConnection) IsSecure added in v1.3.0

func (c *VirConnection) IsSecure() (bool, error)

func (*VirConnection) ListAllDomains

func (c *VirConnection) ListAllDomains(flags uint32) ([]VirDomain, error)

func (*VirConnection) ListAllInterfaces

func (c *VirConnection) ListAllInterfaces(flags uint32) ([]VirInterface, error)

func (*VirConnection) ListAllNWFilters

func (c *VirConnection) ListAllNWFilters(flags uint32) ([]VirNWFilter, error)

func (*VirConnection) ListAllNetworks

func (c *VirConnection) ListAllNetworks(flags uint32) ([]VirNetwork, error)

func (*VirConnection) ListAllStoragePools

func (c *VirConnection) ListAllStoragePools(flags uint32) ([]VirStoragePool, error)

func (*VirConnection) ListDefinedDomains

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

func (*VirConnection) ListDefinedInterfaces added in v1.3.0

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

func (*VirConnection) ListDefinedNetworks added in v1.3.0

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

func (*VirConnection) ListDefinedStoragePools added in v1.3.0

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

func (*VirConnection) ListDomains

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

func (*VirConnection) ListInterfaces added in v1.5.0

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

func (*VirConnection) ListNetworks added in v1.5.0

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

func (*VirConnection) ListStoragePools added in v1.5.0

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

func (*VirConnection) LookupByUUIDString

func (c *VirConnection) LookupByUUIDString(uuid string) (VirDomain, 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) LookupInterfaceByMACString added in v1.7.0

func (c *VirConnection) LookupInterfaceByMACString(mac string) (VirInterface, error)

func (*VirConnection) LookupInterfaceByName added in v1.7.0

func (c *VirConnection) LookupInterfaceByName(name string) (VirInterface, error)

func (*VirConnection) LookupNWFilterByName added in v1.7.0

func (c *VirConnection) LookupNWFilterByName(name string) (VirNWFilter, error)

func (*VirConnection) LookupNWFilterByUUIDString added in v1.7.0

func (c *VirConnection) LookupNWFilterByUUIDString(uuid string) (VirNWFilter, error)

func (*VirConnection) LookupNetworkByName added in v1.3.0

func (c *VirConnection) LookupNetworkByName(name string) (VirNetwork, error)

func (*VirConnection) LookupNetworkByUUIDString

func (c *VirConnection) LookupNetworkByUUIDString(uuid string) (VirNetwork, error)

func (*VirConnection) LookupSecretByUUIDString added in v1.8.0

func (c *VirConnection) LookupSecretByUUIDString(uuid string) (VirSecret, error)

func (*VirConnection) LookupSecretByUsage added in v1.8.0

func (c *VirConnection) LookupSecretByUsage(usageType int, usageID string) (VirSecret, error)

func (*VirConnection) LookupStoragePoolByName added in v1.7.0

func (c *VirConnection) LookupStoragePoolByName(name string) (VirStoragePool, error)

func (*VirConnection) LookupStoragePoolByUUIDString added in v1.7.0

func (c *VirConnection) LookupStoragePoolByUUIDString(uuid string) (VirStoragePool, error)

func (*VirConnection) LookupStorageVolByKey added in v1.8.0

func (c *VirConnection) LookupStorageVolByKey(key string) (VirStorageVol, error)

func (*VirConnection) LookupStorageVolByPath added in v1.8.0

func (c *VirConnection) LookupStorageVolByPath(path string) (VirStorageVol, error)

func (*VirConnection) NWFilterDefineXML added in v1.7.0

func (c *VirConnection) NWFilterDefineXML(xmlConfig string) (VirNWFilter, error)

func (*VirConnection) NWFilterDefineXMLFromFile added in v1.7.0

func (c *VirConnection) NWFilterDefineXMLFromFile(xmlFile string) (VirNWFilter, error)

func (*VirConnection) NetworkCreateXML

func (c *VirConnection) NetworkCreateXML(xmlConfig string) (VirNetwork, error)

func (*VirConnection) NetworkDefineXML added in v1.3.0

func (c *VirConnection) NetworkDefineXML(xmlConfig string) (VirNetwork, error)

func (*VirConnection) NetworkDefineXMLFromFile added in v1.3.0

func (c *VirConnection) NetworkDefineXMLFromFile(xmlFile string) (VirNetwork, error)

func (*VirConnection) NumOfDefinedInterfaces added in v1.3.0

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

func (*VirConnection) NumOfDefinedNetworks added in v1.3.0

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

func (*VirConnection) NumOfDefinedStoragePools added in v1.3.0

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

func (*VirConnection) NumOfDomains added in v1.3.0

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

func (*VirConnection) NumOfInterfaces added in v1.3.0

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

func (*VirConnection) NumOfNWFilters added in v1.3.0

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

func (*VirConnection) NumOfNetworks added in v1.3.0

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

func (*VirConnection) NumOfSecrets added in v1.6.0

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

func (*VirConnection) RegisterCloseCallback

func (c *VirConnection) RegisterCloseCallback(cb CloseCallback, opaque func()) error

Register a close callback for the given destination. Only one callback per connection is allowed. Setting a callback will remove the previous one.

func (VirConnection) Restore added in v1.2.0

func (conn VirConnection) Restore(srcFile string) error

func (VirConnection) RestoreFlags added in v1.2.0

func (conn VirConnection) RestoreFlags(srcFile, xmlConf string, flags uint32) error

func (*VirConnection) SecretDefineXML added in v1.8.0

func (c *VirConnection) SecretDefineXML(xmlConfig string, flags uint32) (VirSecret, error)

func (*VirConnection) SecretDefineXMLFromFile added in v1.8.0

func (c *VirConnection) SecretDefineXMLFromFile(xmlFile string) (VirSecret, error)

func (*VirConnection) SecretSetValue

func (c *VirConnection) SecretSetValue(uuid, value string) error

func (*VirConnection) SetErrorFunc

func (c *VirConnection) SetErrorFunc(cb ErrorCallback, opaque func())

func (*VirConnection) SetKeepAlive

func (c *VirConnection) SetKeepAlive(interval int, count uint) error

func (*VirConnection) StoragePoolDefineXML added in v1.7.0

func (c *VirConnection) StoragePoolDefineXML(xmlConfig string, flags uint32) (VirStoragePool, error)

func (*VirConnection) StoragePoolDefineXMLFromFile added in v1.7.0

func (c *VirConnection) StoragePoolDefineXMLFromFile(xmlFile string) (VirStoragePool, error)

func (*VirConnection) UnregisterCloseCallback

func (c *VirConnection) UnregisterCloseCallback() error

func (*VirConnection) UnsetErrorFunc

func (c *VirConnection) UnsetErrorFunc()

type VirDomain

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

func (*VirDomain) AbortJob added in v1.7.0

func (d *VirDomain) AbortJob() error

func (*VirDomain) AttachDevice added in v1.7.0

func (d *VirDomain) AttachDevice(xml string) error

func (*VirDomain) AttachDeviceFlags added in v1.7.0

func (d *VirDomain) AttachDeviceFlags(xml string, flags uint) error

func (*VirDomain) BlockStats

func (d *VirDomain) BlockStats(path string) (VirDomainBlockStats, error)

func (*VirDomain) BlockStatsFlags added in v1.9.0

func (d *VirDomain) BlockStatsFlags(disk string, params *VirTypedParameters, nParams int, flags uint32) (int, error)

func (*VirDomain) Create

func (d *VirDomain) Create() error

func (*VirDomain) CreateSnapshotXML

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

func (*VirDomain) CreateWithFlags

func (d *VirDomain) CreateWithFlags(flags uint) error

func (*VirDomain) Destroy

func (d *VirDomain) Destroy() error

func (*VirDomain) DestroyFlags added in v1.7.0

func (d *VirDomain) DestroyFlags(flags uint) error

func (*VirDomain) DetachDevice added in v1.7.0

func (d *VirDomain) DetachDevice(xml string) error

func (*VirDomain) DetachDeviceFlags added in v1.7.0

func (d *VirDomain) DetachDeviceFlags(xml string, flags uint) error

func (*VirDomain) Free added in v1.7.0

func (d *VirDomain) Free() error

func (*VirDomain) GetAutostart

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

func (*VirDomain) GetBlockInfo added in v1.10.0

func (d *VirDomain) GetBlockInfo(disk string, flag uint) (VirDomainBlockInfo, error)

func (*VirDomain) GetCPUStats added in v1.8.0

func (d *VirDomain) GetCPUStats(params *VirTypedParameters, nParams int, startCpu int, nCpus uint32, flags uint32) (int, error)

func (*VirDomain) GetID

func (d *VirDomain) GetID() (uint, error)

func (*VirDomain) GetInfo

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

func (*VirDomain) GetInterfaceParameters added in v1.8.0

func (d *VirDomain) GetInterfaceParameters(device string, params *VirTypedParameters, nParams *int, flags uint32) (int, error)

Warning: No test written for this function

func (*VirDomain) GetMetadata

func (d *VirDomain) GetMetadata(tipus int, uri string, flags uint32) (string, 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) GetVcpus

func (d *VirDomain) GetVcpus(maxInfo int32) ([]VirVcpuInfo, error)

func (*VirDomain) GetVcpusCpuMap

func (d *VirDomain) GetVcpusCpuMap(maxInfo int, maxCPUs uint32) ([]VirVcpuInfo, error)

func (*VirDomain) GetVcpusFlags

func (d *VirDomain) GetVcpusFlags(flags uint32) (int32, error)

func (*VirDomain) GetXMLDesc

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

func (*VirDomain) InterfaceStats

func (d *VirDomain) InterfaceStats(path string) (VirDomainInterfaceStats, error)

func (*VirDomain) IsActive

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

func (*VirDomain) IsPersistent

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

func (*VirDomain) MemoryStats

func (d *VirDomain) MemoryStats(nrStats uint32, flags uint32) ([]VirDomainMemoryStat, error)

func (*VirDomain) PinVcpu

func (d *VirDomain) PinVcpu(vcpu uint, cpuMap []uint32, maxCPUs uint32) error

func (*VirDomain) PinVcpuFlags

func (d *VirDomain) PinVcpuFlags(vcpu uint, cpuMap []uint32, flags uint, maxCPUs uint32) error

func (*VirDomain) QemuMonitorCommand

func (d *VirDomain) QemuMonitorCommand(flags uint32, command string) (string, error)

func (*VirDomain) Reboot added in v1.1.0

func (d *VirDomain) Reboot(flags uint) error

func (*VirDomain) Resume added in v1.7.0

func (d *VirDomain) Resume() 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) Screenshot added in v1.9.0

func (d *VirDomain) Screenshot(stream *VirStream, screen, flags uint) (string, error)

func (*VirDomain) SendKey added in v1.9.0

func (d *VirDomain) SendKey(codeset, holdtime uint, keycodes []uint, flags uint) error

func (*VirDomain) SetAutostart

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

func (*VirDomain) SetMaxMemory added in v1.7.0

func (d *VirDomain) SetMaxMemory(memory uint) error

func (*VirDomain) SetMemory added in v1.7.0

func (d *VirDomain) SetMemory(memory uint64) error

func (*VirDomain) SetMemoryFlags added in v1.7.0

func (d *VirDomain) SetMemoryFlags(memory uint64, flags uint32) error

func (*VirDomain) SetMemoryStatsPeriod

func (d *VirDomain) SetMemoryStatsPeriod(period int, flags uint) error

func (*VirDomain) SetMetadata

func (d *VirDomain) SetMetadata(metaDataType int, metaDataCont, uriKey, uri string, flags uint32) error

func (*VirDomain) SetVcpus added in v1.7.0

func (d *VirDomain) SetVcpus(vcpu uint) error

func (*VirDomain) SetVcpusFlags added in v1.7.0

func (d *VirDomain) SetVcpusFlags(vcpu uint, flags uint) error

func (*VirDomain) Shutdown added in v1.1.0

func (d *VirDomain) Shutdown() error

func (*VirDomain) ShutdownFlags added in v1.7.0

func (d *VirDomain) ShutdownFlags(flags uint) error

func (*VirDomain) Suspend added in v1.7.0

func (d *VirDomain) Suspend() error

func (*VirDomain) Undefine added in v1.3.0

func (d *VirDomain) Undefine() error

func (*VirDomain) UndefineFlags

func (d *VirDomain) UndefineFlags(flags uint) error

func (*VirDomain) UpdateDeviceFlags

func (d *VirDomain) UpdateDeviceFlags(xml string, flags uint) error

type VirDomainBlockInfo added in v1.10.0

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

func (*VirDomainBlockInfo) Allocation added in v1.10.0

func (b *VirDomainBlockInfo) Allocation() uint64

func (*VirDomainBlockInfo) Capacity added in v1.10.0

func (b *VirDomainBlockInfo) Capacity() uint64

func (*VirDomainBlockInfo) Physical added in v1.10.0

func (b *VirDomainBlockInfo) Physical() uint64

type VirDomainBlockStats

type VirDomainBlockStats struct {
	RdReq   int64
	WrReq   int64
	RdBytes int64
	WrBytes int64
}

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 VirDomainInterfaceStats

type VirDomainInterfaceStats struct {
	RxBytes   int64
	RxPackets int64
	RxErrs    int64
	RxDrop    int64
	TxBytes   int64
	TxPackets int64
	TxErrs    int64
	TxDrop    int64
}

type VirDomainMemoryStat

type VirDomainMemoryStat struct {
	Tag int32
	Val uint64
}

type VirDomainSnapshot

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

func (*VirDomainSnapshot) Delete

func (s *VirDomainSnapshot) Delete(flags uint32) error

func (*VirDomainSnapshot) Free added in v1.7.0

func (s *VirDomainSnapshot) Free() error

func (*VirDomainSnapshot) RevertToSnapshot

func (s *VirDomainSnapshot) RevertToSnapshot(flags uint32) error

type VirError

type VirError struct {
	Code    int
	Domain  int
	Message string
	Level   int
}

func GetLastError

func GetLastError() VirError

func (VirError) Error

func (err VirError) Error() string

type VirInterface added in v1.7.0

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

func (*VirInterface) Create added in v1.7.0

func (n *VirInterface) Create(flags uint32) error

func (*VirInterface) Destroy added in v1.7.0

func (n *VirInterface) Destroy(flags uint32) error

func (*VirInterface) Free added in v1.7.0

func (n *VirInterface) Free() error

func (*VirInterface) GetMACString added in v1.7.0

func (n *VirInterface) GetMACString() (string, error)

func (*VirInterface) GetName added in v1.7.0

func (n *VirInterface) GetName() (string, error)

func (*VirInterface) GetXMLDesc added in v1.7.0

func (n *VirInterface) GetXMLDesc(flags uint32) (string, error)

func (*VirInterface) IsActive added in v1.7.0

func (n *VirInterface) IsActive() (bool, error)

func (*VirInterface) Undefine added in v1.7.0

func (n *VirInterface) Undefine() error

type VirNWFilter added in v1.7.0

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

func (*VirNWFilter) Free added in v1.7.0

func (f *VirNWFilter) Free() error

func (*VirNWFilter) GetName added in v1.7.0

func (f *VirNWFilter) GetName() (string, error)

func (*VirNWFilter) GetUUID added in v1.7.0

func (f *VirNWFilter) GetUUID() ([]byte, error)

func (*VirNWFilter) GetUUIDString added in v1.7.0

func (f *VirNWFilter) GetUUIDString() (string, error)

func (*VirNWFilter) GetXMLDesc added in v1.7.0

func (f *VirNWFilter) GetXMLDesc(flags uint32) (string, error)

func (*VirNWFilter) Undefine added in v1.7.0

func (f *VirNWFilter) Undefine() error

type VirNetwork added in v1.3.0

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

func (*VirNetwork) Create added in v1.3.0

func (n *VirNetwork) Create() error

func (*VirNetwork) Destroy added in v1.3.0

func (n *VirNetwork) Destroy() error

func (*VirNetwork) Free added in v1.7.0

func (n *VirNetwork) Free() error

func (*VirNetwork) GetAutostart added in v1.3.0

func (n *VirNetwork) GetAutostart() (bool, error)

func (*VirNetwork) GetBridgeName added in v1.3.0

func (n *VirNetwork) GetBridgeName() (string, error)

func (*VirNetwork) GetName added in v1.3.0

func (n *VirNetwork) GetName() (string, error)

func (*VirNetwork) GetUUID added in v1.3.0

func (n *VirNetwork) GetUUID() ([]byte, error)

func (*VirNetwork) GetUUIDString added in v1.3.0

func (n *VirNetwork) GetUUIDString() (string, error)

func (*VirNetwork) GetXMLDesc added in v1.3.0

func (n *VirNetwork) GetXMLDesc(flags uint32) (string, error)

func (*VirNetwork) IsActive added in v1.3.0

func (n *VirNetwork) IsActive() (bool, error)

func (*VirNetwork) IsPersistent added in v1.3.0

func (n *VirNetwork) IsPersistent() (bool, error)

func (*VirNetwork) SetAutostart added in v1.3.0

func (n *VirNetwork) SetAutostart(autostart bool) error

func (*VirNetwork) Undefine added in v1.3.0

func (n *VirNetwork) Undefine() error

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) GetMaxCPUs

func (ni *VirNodeInfo) GetMaxCPUs() uint32

libvirt.h: VIR_NODEINFO_MAXCPUS

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

type VirSecret added in v1.8.0

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

func (*VirSecret) Free added in v1.8.0

func (s *VirSecret) Free() error

func (*VirSecret) GetUUID added in v1.8.0

func (s *VirSecret) GetUUID() ([]byte, error)

func (*VirSecret) GetUUIDString added in v1.8.0

func (s *VirSecret) GetUUIDString() (string, error)

func (*VirSecret) GetUsageID added in v1.8.0

func (s *VirSecret) GetUsageID() (string, error)

func (*VirSecret) GetUsageType added in v1.8.0

func (s *VirSecret) GetUsageType() (int, error)

func (*VirSecret) GetXMLDesc added in v1.8.0

func (s *VirSecret) GetXMLDesc(flags uint32) (string, error)

func (*VirSecret) Undefine added in v1.8.0

func (s *VirSecret) Undefine() error

type VirStoragePool added in v1.7.0

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

func (*VirStoragePool) Build added in v1.7.0

func (p *VirStoragePool) Build(flags uint32) error

func (*VirStoragePool) Create added in v1.7.0

func (p *VirStoragePool) Create(flags uint32) error

func (*VirStoragePool) Delete added in v1.7.0

func (p *VirStoragePool) Delete(flags uint32) error

func (*VirStoragePool) Destroy added in v1.7.0

func (p *VirStoragePool) Destroy() error

func (*VirStoragePool) Free added in v1.7.0

func (p *VirStoragePool) Free() error

func (*VirStoragePool) GetAutostart added in v1.7.0

func (p *VirStoragePool) GetAutostart() (bool, error)

func (*VirStoragePool) GetInfo added in v1.7.0

func (p *VirStoragePool) GetInfo() (VirStoragePoolInfo, error)

func (*VirStoragePool) GetName added in v1.7.0

func (p *VirStoragePool) GetName() (string, error)

func (*VirStoragePool) GetUUID added in v1.7.0

func (p *VirStoragePool) GetUUID() ([]byte, error)

func (*VirStoragePool) GetUUIDString added in v1.7.0

func (p *VirStoragePool) GetUUIDString() (string, error)

func (*VirStoragePool) GetXMLDesc added in v1.7.0

func (p *VirStoragePool) GetXMLDesc(flags uint32) (string, error)

func (*VirStoragePool) IsActive added in v1.7.0

func (p *VirStoragePool) IsActive() (bool, error)

func (*VirStoragePool) LookupStorageVolByName added in v1.8.0

func (p *VirStoragePool) LookupStorageVolByName(name string) (VirStorageVol, error)

func (*VirStoragePool) Refresh added in v1.7.0

func (p *VirStoragePool) Refresh(flags uint32) error

func (*VirStoragePool) SetAutostart added in v1.7.0

func (p *VirStoragePool) SetAutostart(autostart bool) error

func (*VirStoragePool) StorageVolCreateXML added in v1.8.0

func (p *VirStoragePool) StorageVolCreateXML(xmlConfig string, flags uint32) (VirStorageVol, error)

func (*VirStoragePool) StorageVolCreateXMLFrom

func (p *VirStoragePool) StorageVolCreateXMLFrom(xmlConfig string, clonevol VirStorageVol, flags uint32) (VirStorageVol, error)

func (*VirStoragePool) StorageVolCreateXMLFromFile added in v1.8.0

func (p *VirStoragePool) StorageVolCreateXMLFromFile(xmlFile string, flags uint32) (VirStorageVol, error)

func (*VirStoragePool) Undefine added in v1.7.0

func (p *VirStoragePool) Undefine() error

type VirStoragePoolInfo added in v1.7.0

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

func (*VirStoragePoolInfo) GetAllocationInBytes added in v1.7.0

func (i *VirStoragePoolInfo) GetAllocationInBytes() uint64

func (*VirStoragePoolInfo) GetAvailableInBytes added in v1.7.0

func (i *VirStoragePoolInfo) GetAvailableInBytes() uint64

func (*VirStoragePoolInfo) GetCapacityInBytes added in v1.7.0

func (i *VirStoragePoolInfo) GetCapacityInBytes() uint64

func (*VirStoragePoolInfo) GetState added in v1.7.0

func (i *VirStoragePoolInfo) GetState() uint8

type VirStorageVol added in v1.8.0

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

func (*VirStorageVol) Delete added in v1.8.0

func (v *VirStorageVol) Delete(flags uint32) error

func (*VirStorageVol) Download

func (v *VirStorageVol) Download(stream *VirStream, offset, length uint64, flags uint32) error

func (*VirStorageVol) Free added in v1.8.0

func (v *VirStorageVol) Free() error

func (*VirStorageVol) GetInfo added in v1.8.0

func (v *VirStorageVol) GetInfo() (VirStorageVolInfo, error)

func (*VirStorageVol) GetKey added in v1.8.0

func (v *VirStorageVol) GetKey() (string, error)

func (*VirStorageVol) GetName added in v1.8.0

func (v *VirStorageVol) GetName() (string, error)

func (*VirStorageVol) GetPath added in v1.8.0

func (v *VirStorageVol) GetPath() (string, error)

func (*VirStorageVol) GetXMLDesc added in v1.8.0

func (v *VirStorageVol) GetXMLDesc(flags uint32) (string, error)

func (*VirStorageVol) LookupPoolByVolume

func (v *VirStorageVol) LookupPoolByVolume() (VirStoragePool, error)

func (*VirStorageVol) Resize added in v1.8.0

func (v *VirStorageVol) Resize(capacity uint64, flags uint32) error

func (*VirStorageVol) Upload

func (v *VirStorageVol) Upload(stream *VirStream, offset, length uint64, flags uint32) error

func (*VirStorageVol) Wipe added in v1.8.0

func (v *VirStorageVol) Wipe(flags uint32) error

func (*VirStorageVol) WipePattern added in v1.8.0

func (v *VirStorageVol) WipePattern(algorithm uint32, flags uint32) error

type VirStorageVolInfo added in v1.8.0

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

func (*VirStorageVolInfo) GetAllocationInBytes added in v1.8.0

func (i *VirStorageVolInfo) GetAllocationInBytes() uint64

func (*VirStorageVolInfo) GetCapacityInBytes added in v1.8.0

func (i *VirStorageVolInfo) GetCapacityInBytes() uint64

func (*VirStorageVolInfo) GetType added in v1.8.0

func (i *VirStorageVolInfo) GetType() int

type VirStream added in v1.9.0

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

func NewVirStream added in v1.9.0

func NewVirStream(c *VirConnection, flags uint) (*VirStream, error)

func (*VirStream) Abort added in v1.9.0

func (v *VirStream) Abort() error

func (*VirStream) Close added in v1.9.0

func (v *VirStream) Close() error

func (*VirStream) Free added in v1.9.0

func (v *VirStream) Free() error

func (*VirStream) Read added in v1.9.0

func (v *VirStream) Read(p []byte) (int, error)

func (*VirStream) Write added in v1.9.0

func (v *VirStream) Write(p []byte) (int, error)

type VirTypedParameter added in v1.8.0

type VirTypedParameter struct {
	Name  string
	Value interface{}
}

type VirTypedParameters added in v1.8.0

type VirTypedParameters []VirTypedParameter

type VirVcpuInfo

type VirVcpuInfo struct {
	Number  uint32
	State   int32
	CpuTime uint64
	Cpu     int32
	CpuMap  []uint32
}

Notes

Bugs

  • The returned value of DomainEventCallback is ignored and should be removed from the signature.

  • The returned value of DomainEventRegister, DomainEventDeregister, EventRegisterDefaultImpl and EventRunDefaultImpl should be an error instead of an int, for coherence with other functions.

Jump to

Keyboard shortcuts

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