* A callback function to be registered, and called when a domain event occurs
*
* Returns 0 (the return value is currently ignored)
+ *
+ * Since: v0.5.0
*/
typedef int (*virConnectDomainEventCallback)(virConnectPtr conn,
virDomainPtr dom,
* have a customization with extra parameters, often with @opaque being
* passed in a different parameter position; use VIR_DOMAIN_EVENT_CALLBACK()
* when registering an appropriate handler.
+ *
+ * Since: v0.8.0
*/
typedef void (*virConnectDomainEventGenericCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_RTC_CHANGE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.8.0
*/
typedef void (*virConnectDomainEventRTCChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_WATCHDOG with virConnectDomainEventRegisterAny()
*
+ * Since: v0.8.0
*/
typedef void (*virConnectDomainEventWatchdogCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_IO_ERROR with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.8.0
*/
typedef void (*virConnectDomainEventIOErrorCallback)(virConnectPtr conn,
virDomainPtr dom,
* Otherwise, @reason will be "", although future strings may be added
* if determination of other error types becomes possible.
*
+ * Since: v0.8.1
*/
typedef void (*virConnectDomainEventIOErrorReasonCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_GRAPHICS with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.8.0
*/
typedef void (*virConnectDomainEventGraphicsCallback)(virConnectPtr conn,
virDomainPtr dom,
* was registered using the newer type of VIR_DOMAIN_EVENT_ID_BLOCK_JOB_2,
* then @disk will contain the device target shorthand (the <target
* dev='...'/> sub-element, such as "vda").
+ *
+ * Since: v0.9.4
*/
typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DISK_CHANGE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.9.7
*/
typedef void (*virConnectDomainEventDiskChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_TRAY_CHANGE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.9.11
*/
typedef void (*virConnectDomainEventTrayChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_PMWAKEUP with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.9.11
*/
typedef void (*virConnectDomainEventPMWakeupCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_PMSUSPEND with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.9.11
*/
typedef void (*virConnectDomainEventPMSuspendCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v0.10.0
*/
typedef void (*virConnectDomainEventBalloonChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK with virConnectDomainEventRegisterAny()
+ *
+ * Since: v1.0.0
*/
typedef void (*virConnectDomainEventPMSuspendDiskCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED with virConnectDomainEventRegisterAny()
+ *
+ * Since: v1.1.1
*/
typedef void (*virConnectDomainEventDeviceRemovedCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DEVICE_ADDED with virConnectDomainEventRegisterAny()
+ *
+ * Since: v1.2.15
*/
typedef void (*virConnectDomainEventDeviceAddedCallback)(virConnectPtr conn,
virDomainPtr dom,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED with
* virConnectDomainEventRegisterAny().
+ *
+ * Since: v1.3.4
*/
typedef void (*virConnectDomainEventDeviceRemovalFailedCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_METADATA_CHANGE with virConnectDomainEventRegisterAny().
+ *
+ * Since: v3.0.0
*/
typedef void (*virConnectDomainEventMetadataChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION with
* virConnectDomainEventRegisterAny().
+ *
+ * Since: v1.3.2
*/
typedef void (*virConnectDomainEventMigrationIterationCallback)(virConnectPtr conn,
virDomainPtr dom,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_JOB_COMPLETED with
* virConnectDomainEventRegisterAny().
+ *
+ * Since: v1.3.3
*/
typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_TUNABLE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v1.2.9
*/
typedef void (*virConnectDomainEventTunableCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v1.2.11
*/
typedef void (*virConnectDomainEventAgentLifecycleCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD with virConnectDomainEventRegisterAny()
+ *
+ * Since: v3.2.0
*/
typedef void (*virConnectDomainEventBlockThresholdCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_MEMORY_FAILURE with virConnectDomainEventRegisterAny()
+ *
+ * Since: v6.9.0
*/
typedef void (*virConnectDomainEventMemoryFailureCallback)(virConnectPtr conn,
virDomainPtr dom,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGE with
* virConnectDomainEventRegisterAny().
+ *
+ * Since: v7.9.0
*/
typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
*
* Callback for receiving file handle events. The callback will
* be invoked once for each event which is pending.
+ *
+ * Since: v0.5.0
*/
typedef void (*virEventHandleCallback)(int watch, int fd, int events, void *opaque);
*
* Returns -1 if the file handle cannot be registered, otherwise a handle
* watch number to be used for updating and unregistering for events
+ *
+ * Since: v0.5.0
*/
typedef int (*virEventAddHandleFunc)(int fd, int event,
virEventHandleCallback cb,
*
* Part of the EventImpl, this user-provided callback is notified when
* events to listen on change
+ *
+ * Since: v0.5.0
*/
typedef void (*virEventUpdateHandleFunc)(int watch, int event);
* function call, when it is safe to release the user data.
*
* Returns -1 if the file handle was not registered, 0 upon success
+ *
+ * Since: v0.5.0
*/
typedef int (*virEventRemoveHandleFunc)(int watch);
* @opaque: user data registered with handle
*
* callback for receiving timer events
+ *
+ * Since: v0.5.0
*/
typedef void (*virEventTimeoutCallback)(int timer, void *opaque);
* this purpose.
*
* Returns a timer value
+ *
+ * Since: v0.5.0
*/
typedef int (*virEventAddTimeoutFunc)(int timeout,
virEventTimeoutCallback cb,
*
* Part of the EventImpl, this user-defined callback updates an
* event timeout.
+ *
+ * Since: v0.5.0
*/
typedef void (*virEventUpdateTimeoutFunc)(int timer, int timeout);
* function call, when it is safe to release the user data.
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v0.5.0
*/
typedef int (*virEventRemoveTimeoutFunc)(int timer);
* If an interaction cannot be filled, fill in NULL and 0.
*
* Returns 0 if all interactions were filled, or -1 upon error
+ *
+ * Since: v0.4.1
*/
typedef int (*virConnectAuthCallbackPtr)(virConnectCredentialPtr cred,
unsigned int ncred,
*
* A callback function to be registered, and called when the connection
* is closed.
+ *
+ * Since: v0.10.0
*/
typedef void (*virConnectCloseFunc)(virConnectPtr conn,
int reason,
*
* The callback signature to use when registering for an event of type
* VIR_NETWORK_EVENT_ID_LIFECYCLE with virConnectNetworkEventRegisterAny()
+ *
+ * Since: v1.2.1
*/
typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn,
virNetworkPtr net,
* have a customization with extra parameters, often with @opaque being
* passed in a different parameter position; use VIR_NETWORK_EVENT_CALLBACK()
* when registering an appropriate handler.
+ *
+ * Since: v1.2.1
*/
typedef void (*virConnectNetworkEventGenericCallback)(virConnectPtr conn,
virNetworkPtr net,
* have a customization with extra parameters, often with @opaque being
* passed in a different parameter position; use
* VIR_NODE_DEVICE_EVENT_CALLBACK() when registering an appropriate handler.
+ *
+ * Since: v2.2.0
*/
typedef void (*virConnectNodeDeviceEventGenericCallback)(virConnectPtr conn,
virNodeDevicePtr dev,
* The callback signature to use when registering for an event of type
* VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE with
* virConnectNodeDeviceEventRegisterAny()
+ *
+ * Since: v2.2.0
*/
typedef void (*virConnectNodeDeviceEventLifecycleCallback)(virConnectPtr conn,
virNodeDevicePtr dev,
* have a customization with extra parameters, often with @opaque being
* passed in a different parameter position; use
* VIR_SECRET_EVENT_CALLBACK() when registering an appropriate handler.
+ *
+ * Since: v3.0.0
*/
typedef void (*virConnectSecretEventGenericCallback)(virConnectPtr conn,
virSecretPtr secret,
* The callback signature to use when registering for an event of type
* VIR_SECRET_EVENT_ID_LIFECYCLE with
* virConnectSecretEventRegisterAny()
+ *
+ * Since: v3.0.0
*/
typedef void (*virConnectSecretEventLifecycleCallback)(virConnectPtr conn,
virSecretPtr secret,
* have a customization with extra parameters, often with @opaque being
* passed in a different parameter position; use
* VIR_STORAGE_POOL_EVENT_CALLBACK() when registering an appropriate handler.
+ *
+ * Since: v2.0.0
*/
typedef void (*virConnectStoragePoolEventGenericCallback)(virConnectPtr conn,
virStoragePoolPtr pool,
* The callback signature to use when registering for an event of type
* VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE with
* virConnectStoragePoolEventRegisterAny()
+ *
+ * Since: v2.0.0
*/
typedef void (*virConnectStoragePoolEventLifecycleCallback)(virConnectPtr conn,
virStoragePoolPtr pool,
*
* Returns the number of bytes filled, 0 upon end
* of file, or -1 upon error
+ *
+ * Since: v0.7.2
*/
typedef int (*virStreamSourceFunc)(virStreamPtr st,
char *data,
*
* Returns 0 on success,
* -1 upon error
+ *
+ * Since: v3.4.0
*/
typedef int (*virStreamSourceHoleFunc)(virStreamPtr st,
int *inData,
*
* Returns 0 on success,
* -1 upon error.
+ *
+ * Since: v3.4.0
*/
typedef int (*virStreamSourceSkipFunc)(virStreamPtr st,
long long length,
*
* Returns the number of bytes consumed or -1 upon
* error
+ *
+ * Since: v0.7.2
*/
typedef int (*virStreamSinkFunc)(virStreamPtr st,
const char *data,
*
* Returns 0 on success,
* -1 upon error
+ *
+ * Since: v3.4.0
*/
typedef int (*virStreamSinkHoleFunc)(virStreamPtr st,
long long length,
*
* Callback for receiving stream events. The callback will
* be invoked once for each event which is pending.
+ *
+ * Since: v0.7.2
*/
typedef void (*virStreamEventCallback)(virStreamPtr stream, int events, void *opaque);
* @error: the error being raised.
*
* Signature of a function to use when there is an error raised by the library.
+ *
+ * Since: v0.1.0
*/
typedef void (*virErrorFunc) (void *userData, virErrorPtr error);
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* as its lifetime will be the same as the checkpoint object.
+ *
+ * Since: v5.6.0
*/
const char *
virDomainCheckpointGetName(virDomainCheckpointPtr checkpoint)
* call.
*
* Returns the domain or NULL.
+ *
+ * Since: v5.6.0
*/
virDomainPtr
virDomainCheckpointGetDomain(virDomainCheckpointPtr checkpoint)
* call.
*
* Returns the connection or NULL.
+ *
+ * Since: v5.6.0
*/
virConnectPtr
virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint)
*
* Returns an (opaque) new virDomainCheckpointPtr on success or NULL
* on failure.
+ *
+ * Since: v5.6.0
*/
virDomainCheckpointPtr
virDomainCheckpointCreateXML(virDomainPtr domain,
*
* Returns a 0 terminated UTF-8 encoded XML instance or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v5.6.0
*/
char *
virDomainCheckpointGetXMLDesc(virDomainCheckpointPtr checkpoint,
* included in the return count, to make iteration easier. The caller is
* responsible for calling virDomainCheckpointFree() on each array element,
* then calling free() on @checkpoints.
+ *
+ * Since: v5.6.0
*/
int
virDomainListAllCheckpoints(virDomainPtr domain,
* in the return count, to make iteration easier. The caller is responsible
* for calling virDomainCheckpointFree() on each array element, then calling
* free() on @children.
+ *
+ * Since: v5.6.0
*/
int
virDomainCheckpointListAllChildren(virDomainCheckpointPtr checkpoint,
* Returns a domain checkpoint object or NULL in case of failure. If the
* domain checkpoint cannot be found, then the VIR_ERR_NO_DOMAIN_CHECKPOINT
* error is raised.
+ *
+ * Since: v5.6.0
*/
virDomainCheckpointPtr
virDomainCheckpointLookupByName(virDomainPtr domain,
* Returns a domain checkpoint object or NULL in case of failure. If the
* given checkpoint is a root (no parent), then the VIR_ERR_NO_DOMAIN_CHECKPOINT
* error is raised.
+ *
+ * Since: v5.6.0
*/
virDomainCheckpointPtr
virDomainCheckpointGetParent(virDomainCheckpointPtr checkpoint,
* silently ignored.
*
* Returns 0 on success, -1 on error.
+ *
+ * Since: v5.6.0
*/
int
virDomainCheckpointDelete(virDomainCheckpointPtr checkpoint,
* increment the reference count.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v5.6.0
*/
int
virDomainCheckpointRef(virDomainCheckpointPtr checkpoint)
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v5.6.0
*/
int
virDomainCheckpointFree(virDomainCheckpointPtr checkpoint)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* as its lifetime will be the same as the snapshot object.
+ *
+ * Since: v0.9.5
*/
const char *
virDomainSnapshotGetName(virDomainSnapshotPtr snapshot)
* call.
*
* Returns the domain or NULL.
+ *
+ * Since: v0.9.5
*/
virDomainPtr
virDomainSnapshotGetDomain(virDomainSnapshotPtr snapshot)
* call.
*
* Returns the connection or NULL.
+ *
+ * Since: v0.9.5
*/
virConnectPtr
virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot)
*
* Returns an (opaque) new virDomainSnapshotPtr on success or NULL on
* failure.
+ *
+ * Since: v0.8.0
*/
virDomainSnapshotPtr
virDomainSnapshotCreateXML(virDomainPtr domain,
*
* Returns a 0 terminated UTF-8 encoded XML instance or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v0.8.0
*/
char *
virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr snapshot,
* virDomainListAllSnapshots().
*
* Returns the number of domain snapshots found or -1 in case of error.
+ *
+ * Since: v0.8.0
*/
int
virDomainSnapshotNum(virDomainPtr domain, unsigned int flags)
*
* Returns the number of domain snapshots found or -1 in case of error.
* The caller is responsible to call free() for each member of the array.
+ *
+ * Since: v0.8.0
*/
int
virDomainSnapshotListNames(virDomainPtr domain, char **names, int nameslen,
* in the return count, to make iteration easier. The caller is responsible
* for calling virDomainSnapshotFree() on each array element, then calling
* free() on @snaps.
+ *
+ * Since: v0.9.13
*/
int
virDomainListAllSnapshots(virDomainPtr domain, virDomainSnapshotPtr **snaps,
* virDomainSnapshotListAllChildren().
*
* Returns the number of domain snapshots found or -1 in case of error.
+ *
+ * Since: v0.9.7
*/
int
virDomainSnapshotNumChildren(virDomainSnapshotPtr snapshot, unsigned int flags)
*
* Returns the number of domain snapshots found or -1 in case of error.
* The caller is responsible to call free() for each member of the array.
+ *
+ * Since: v0.9.7
*/
int
virDomainSnapshotListChildrenNames(virDomainSnapshotPtr snapshot,
* in the return count, to make iteration easier. The caller is responsible
* for calling virDomainSnapshotFree() on each array element, then calling
* free() on @snaps.
+ *
+ * Since: v0.9.13
*/
int
virDomainSnapshotListAllChildren(virDomainSnapshotPtr snapshot,
* Returns a domain snapshot object or NULL in case of failure. If the
* domain snapshot cannot be found, then the VIR_ERR_NO_DOMAIN_SNAPSHOT
* error is raised.
+ *
+ * Since: v0.8.0
*/
virDomainSnapshotPtr
virDomainSnapshotLookupByName(virDomainPtr domain,
* Determine if the domain has a current snapshot.
*
* Returns 1 if such snapshot exists, 0 if it doesn't, -1 on error.
+ *
+ * Since: v0.8.0
*/
int
virDomainHasCurrentSnapshot(virDomainPtr domain, unsigned int flags)
* Returns a domain snapshot object or NULL in case of failure. If the
* current domain snapshot cannot be found, then the VIR_ERR_NO_DOMAIN_SNAPSHOT
* error is raised.
+ *
+ * Since: v0.8.0
*/
virDomainSnapshotPtr
virDomainSnapshotCurrent(virDomainPtr domain,
* Returns a domain snapshot object or NULL in case of failure. If the
* given snapshot is a root (no parent), then the VIR_ERR_NO_DOMAIN_SNAPSHOT
* error is raised.
+ *
+ * Since: v0.9.7
*/
virDomainSnapshotPtr
virDomainSnapshotGetParent(virDomainSnapshotPtr snapshot,
* also virDomainHasCurrentSnapshot().
*
* Returns 1 if current, 0 if not current, or -1 on error.
+ *
+ * Since: v0.9.13
*/
int
virDomainSnapshotIsCurrent(virDomainSnapshotPtr snapshot,
*
* Returns 1 if the snapshot has metadata, 0 if the snapshot exists without
* help from libvirt, or -1 on error.
+ *
+ * Since: v0.9.13
*/
int
virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot,
* NVRAM from the pristine template.
*
* Returns 0 if the creation is successful, -1 on error.
+ *
+ * Since: v0.8.0
*/
int
virDomainRevertToSnapshot(virDomainSnapshotPtr snapshot,
*
* Returns 0 if the selected snapshot(s) were successfully deleted,
* -1 on error.
+ *
+ * Since: v0.8.0
*/
int
virDomainSnapshotDelete(virDomainSnapshotPtr snapshot,
* increment the reference count.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.13
*/
int
virDomainSnapshotRef(virDomainSnapshotPtr snapshot)
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.8.0
*/
int
virDomainSnapshotFree(virDomainSnapshotPtr snapshot)
* call to virConnectNumOfDomains() and this call; you are only guaranteed
* that all currently active domains were listed if the return is less
* than @maxids.
+ *
+ * Since: v0.0.3
*/
int
virConnectListDomains(virConnectPtr conn, int *ids, int maxids)
* Provides the number of active domains.
*
* Returns the number of domain found or -1 in case of error
+ *
+ * Since: v0.0.3
*/
int
virConnectNumOfDomains(virConnectPtr conn)
* call.
*
* Returns the virConnectPtr or NULL in case of failure.
+ *
+ * Since: v0.3.0
*/
virConnectPtr
virDomainGetConnect(virDomainPtr dom)
* domain object is no longer needed.
*
* Returns a new domain object or NULL in case of failure
+ *
+ * Since: v0.5.0
*/
virDomainPtr
virDomainCreateXML(virConnectPtr conn, const char *xmlDesc,
* domain object is no longer needed.
*
* Returns a new domain object or NULL in case of failure
+ *
+ * Since: v1.1.1
*/
virDomainPtr
virDomainCreateXMLWithFiles(virConnectPtr conn, const char *xmlDesc,
* This existing name will be left indefinitely for API compatibility.
*
* Returns a new domain object or NULL in case of failure
+ *
+ * Since: v0.0.3
*/
virDomainPtr
virDomainCreateLinux(virConnectPtr conn, const char *xmlDesc,
*
* Returns a new domain object or NULL in case of failure. If the
* domain cannot be found, then VIR_ERR_NO_DOMAIN error is raised.
+ *
+ * Since: v0.0.3
*/
virDomainPtr
virDomainLookupByID(virConnectPtr conn, int id)
*
* Returns a new domain object or NULL in case of failure. If the
* domain cannot be found, then VIR_ERR_NO_DOMAIN error is raised.
+ *
+ * Since: v0.0.5
*/
virDomainPtr
virDomainLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
*
* Returns a new domain object or NULL in case of failure. If the
* domain cannot be found, then VIR_ERR_NO_DOMAIN error is raised.
+ *
+ * Since: v0.1.1
*/
virDomainPtr
virDomainLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
*
* Returns a new domain object or NULL in case of failure. If the
* domain cannot be found, then VIR_ERR_NO_DOMAIN error is raised.
+ *
+ * Since: v0.0.3
*/
virDomainPtr
virDomainLookupByName(virConnectPtr conn, const char *name)
* be deleted when the domain quits.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainDestroy(virDomainPtr domain)
*
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.4
*/
int
virDomainDestroyFlags(virDomainPtr domain,
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainFree(virDomainPtr domain)
* the reference count.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.6.0
*/
int
virDomainRef(virDomainPtr domain)
* special state like VIR_DOMAIN_PMSUSPENDED.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainSuspend(virDomainPtr domain)
* special state like VIR_DOMAIN_PMSUSPENDED.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainResume(virDomainPtr domain)
*
* Returns: 0 on success,
* -1 on failure.
+ *
+ * Since: v0.9.10
*/
int
virDomainPMSuspendForDuration(virDomainPtr dom,
*
* Returns: 0 on success,
* -1 on failure.
+ *
+ * Since: v0.9.11
*/
int
virDomainPMWakeup(virDomainPtr dom,
* and virDomainSaveImageDefineXML().
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainSave(virDomainPtr domain, const char *to)
* to stop the block job first.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.4
*/
int
virDomainSaveFlags(virDomainPtr domain, const char *to,
* See virDomainRestoreFlags() for more control.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainRestore(virConnectPtr conn, const char *from)
* pristine template.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.4
*/
int
virDomainRestoreFlags(virConnectPtr conn, const char *from, const char *dxml,
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case of
* error. The caller must free() the returned value.
+ *
+ * Since: v0.9.4
*/
char *
virDomainSaveImageGetXMLDesc(virConnectPtr conn, const char *file,
* exclusive.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.4
*/
int
virDomainSaveImageDefineXML(virConnectPtr conn, const char *file,
* For more control over the output format, see virDomainCoreDumpWithFormat().
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.1.9
*/
int
virDomainCoreDump(virDomainPtr domain, const char *to, unsigned int flags)
* pressure on file system cache, but also risks slowing saves to NFS.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v1.2.3
*/
int
virDomainCoreDumpWithFormat(virDomainPtr domain, const char *to,
*
* Returns a string representing the mime-type of the image format, or
* NULL upon error. The caller must free() the returned value.
+ *
+ * Since: v0.9.2
*/
char *
virDomainScreenshot(virDomainPtr domain,
* be deleted when the domain quits.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainShutdown(virDomainPtr domain)
* must have <channel> configured.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.10
*/
int
virDomainShutdownFlags(virDomainPtr domain, unsigned int flags)
* to a plain shutdown on the destination.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.1.0
*/
int
virDomainReboot(virDomainPtr domain, unsigned int flags)
* guest OS shutdown.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.7
*/
int
virDomainReset(virDomainPtr domain, unsigned int flags)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* its lifetime will be the same as the domain object.
+ *
+ * Since: v0.0.3
*/
const char *
virDomainGetName(virDomainPtr domain)
* Get the UUID for a domain
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.0.5
*/
int
virDomainGetUUID(virDomainPtr domain, unsigned char *uuid)
* UUID see RFC4122.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.1.1
*/
int
virDomainGetUUIDString(virDomainPtr domain, char *buf)
* Get the hypervisor ID number for the domain
*
* Returns the domain ID number or (unsigned int) -1 in case of error
+ *
+ * Since: v0.0.3
*/
unsigned int
virDomainGetID(virDomainPtr domain)
*
* Returns the new string or NULL in case of error, the string must be
* freed by the caller.
+ *
+ * Since: v0.0.3
*/
char *
virDomainGetOSType(virDomainPtr domain)
*
* Returns the memory size in kibibytes (blocks of 1024 bytes), or 0 in
* case of error.
+ *
+ * Since: v0.0.3
*/
unsigned long
virDomainGetMaxMemory(virDomainPtr domain)
* virDomainSetMemoryFlags().
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainSetMaxMemory(virDomainPtr domain, unsigned long memory)
* virDomainSetMemoryFlags().
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.1.1
*/
int
virDomainSetMemory(virDomainPtr domain, unsigned long memory)
* Not all hypervisors can support all flag combinations.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.9.0
*/
int
virDomainSetMemoryFlags(virDomainPtr domain, unsigned long memory,
* Not all hypervisors can support all flag combinations.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v1.1.1
*/
int
virDomainSetMemoryStatsPeriod(virDomainPtr domain, int period,
* VIR_DOMAIN_MEMORY_PARAM_UNLIMITED.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.8.5
*/
int
virDomainSetMemoryParameters(virDomainPtr domain,
* expects the caller to allocate the @params.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.8.5
*/
int
virDomainGetMemoryParameters(virDomainPtr domain,
* Changing persistent configuration does not pose such limitations.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.9
*/
int
virDomainSetNumaParameters(virDomainPtr domain,
* expects the caller to allocate the @params.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.9
*/
int
virDomainGetNumaParameters(virDomainPtr domain,
* This function may require privileged access to the hypervisor.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.0
*/
int
virDomainSetBlkioParameters(virDomainPtr domain,
* expects the caller to allocate the @params.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.0
*/
int
virDomainGetBlkioParameters(virDomainPtr domain,
* can be extracted.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.0.3
*/
int
virDomainGetInfo(virDomainPtr domain, virDomainInfoPtr info)
* which led to the state.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.2
*/
int
virDomainGetState(virDomainPtr domain,
* Extract details about current state of control interface to a domain.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.3
*/
int
virDomainGetControlInfo(virDomainPtr domain,
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v0.0.3
*/
char *
virDomainGetXMLDesc(virDomainPtr domain, unsigned int flags)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v0.6.4
*/
char *
virConnectDomainXMLFromNative(virConnectPtr conn,
*
* Returns a 0 terminated UTF-8 encoded native config datafile, or
* NULL in case of error. The caller must free() the returned value.
+ *
+ * Since: v0.6.4
*/
char *
virConnectDomainXMLToNative(virConnectPtr conn,
* Returns the new domain object if the migration was successful,
* or NULL in case of error. Note that the new domain object
* exists in the scope of the destination connection (dconn).
+ *
+ * Since: v0.3.2
*/
virDomainPtr
virDomainMigrate(virDomainPtr domain,
* Returns the new domain object if the migration was successful,
* or NULL in case of error. Note that the new domain object
* exists in the scope of the destination connection (dconn).
+ *
+ * Since: v0.9.2
*/
virDomainPtr
virDomainMigrate2(virDomainPtr domain,
* Returns the new domain object if the migration was successful,
* or NULL in case of error. Note that the new domain object
* exists in the scope of the destination connection (dconn).
+ *
+ * Since: v1.1.0
*/
virDomainPtr
virDomainMigrate3(virDomainPtr domain,
* corresponds to VIR_MIGRATE_PARAM_URI of virDomainMigrateToURI3.
*
* Returns 0 if the migration succeeded, -1 upon error.
+ *
+ * Since: v0.7.2
*/
int
virDomainMigrateToURI(virDomainPtr domain,
* virDomainMigrateToURI3.
*
* Returns 0 if the migration succeeded, -1 upon error.
+ *
+ * Since: v0.9.2
*/
int
virDomainMigrateToURI2(virDomainPtr domain,
* different types of hypervisor.
*
* Returns 0 if the migration succeeded, -1 upon error.
+ *
+ * Since: v1.1.0
*/
int
virDomainMigrateToURI3(virDomainPtr domain,
* Get the scheduler type and the number of scheduler parameters.
*
* Returns NULL in case of error. The caller must free the returned string.
+ *
+ * Since: v0.2.3
*/
char *
virDomainGetSchedulerType(virDomainPtr domain, int *nparams)
* virDomainGetSchedulerParametersFlags().
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.2.3
*/
int
virDomainGetSchedulerParameters(virDomainPtr domain,
* }
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.2
*/
int
virDomainGetSchedulerParametersFlags(virDomainPtr domain,
* virDomainSetSchedulerParametersFlags.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.2.3
*/
int
virDomainSetSchedulerParameters(virDomainPtr domain,
* flags are supported.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.2
*/
int
virDomainSetSchedulerParametersFlags(virDomainPtr domain,
* that particular statistic.
*
* Returns: 0 in case of success or -1 in case of failure.
+ *
+ * Since: v0.3.2
*/
int
virDomainBlockStats(virDomainPtr dom, const char *disk,
* again. See virDomainGetMemoryParameters() for more details.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.5
*/
int
virDomainBlockStatsFlags(virDomainPtr dom,
* The returned stats are from domain's point of view.
*
* Returns: 0 in case of success or -1 in case of failure.
+ *
+ * Since: v0.3.2
*/
int
virDomainInterfaceStats(virDomainPtr dom, const char *device,
* This function may require privileged access to the hypervisor.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.9
*/
int
virDomainSetInterfaceParameters(virDomainPtr domain,
* expects the caller to allocate the @params.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.9
*/
int
virDomainGetInterfaceParameters(virDomainPtr domain,
* The number of failed huge page allocations from inside the domain
*
* Returns: The number of stats provided or -1 in case of failure.
+ *
+ * Since: v0.7.5
*/
int
virDomainMemoryStats(virDomainPtr dom, virDomainMemoryStatPtr stats,
* Now large requests up to 16M byte are supported.
*
* Returns: 0 in case of success or -1 in case of failure.
+ *
+ * Since: v0.4.3
*/
int
virDomainBlockPeek(virDomainPtr dom,
* hypervisor.
*
* Returns: 0 in case of success or -1 in case of failure.
+ *
+ * Since: v0.9.8
*/
int
virDomainBlockResize(virDomainPtr dom,
* Now large requests up to 16M byte are supported.
*
* Returns: 0 in case of success or -1 in case of failure.
+ *
+ * Since: v0.4.3
*/
int
virDomainMemoryPeek(virDomainPtr dom,
* ...
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.8.1
*/
int
virDomainGetBlockInfo(virDomainPtr domain, const char *disk,
* domain object is no longer needed.
*
* Returns NULL in case of error, a pointer to the domain otherwise
+ *
+ * Since: v0.1.1
*/
virDomainPtr
virDomainDefineXML(virConnectPtr conn, const char *xml)
* domain object is no longer needed.
*
* Returns NULL in case of error, a pointer to the domain otherwise
+ *
+ * Since: v1.2.12
*/
virDomainPtr
virDomainDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags)
* will fail. See virDomainUndefineFlags() for more control.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.1.1
*/
int
virDomainUndefine(virDomainPtr domain)
* VIR_DOMAIN_UNDEFINE_NVRAM is specified to remove the nvram file.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.9.4
*/
int
virDomainUndefineFlags(virDomainPtr domain,
* Provides the number of defined but inactive domains.
*
* Returns the number of domain found or -1 in case of error
+ *
+ * Since: v0.1.5
*/
int
virConnectNumOfDefinedDomains(virConnectPtr conn)
* a call to virConnectNumOfDefinedDomains() and this call; you are only
* guaranteed that all currently defined domains were listed if the return
* is less than @maxids. The client must call free() on each returned name.
+ *
+ * Since: v0.1.1
*/
int
virConnectListDefinedDomains(virConnectPtr conn, char **const names,
* extra allocated element set to NULL but not included in the return count, to
* make iteration easier. The caller is responsible for calling virDomainFree()
* on each array element, then calling free() on @domains.
+ *
+ * Since: v0.9.13
*/
int
virConnectListAllDomains(virConnectPtr conn,
* control, see virDomainCreateWithFlags().
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.1.1
*/
int
virDomainCreate(virDomainPtr domain)
* pristine template.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.8.2
*/
int
virDomainCreateWithFlags(virDomainPtr domain, unsigned int flags)
* pristine template.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v1.1.1
*/
int
virDomainCreateWithFiles(virDomainPtr domain, unsigned int nfiles,
* machine boots.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.2.1
*/
int
virDomainGetAutostart(virDomainPtr domain,
* when the host machine boots.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.2.1
*/
int
virDomainSetAutostart(virDomainPtr domain,
* Send NMI to the guest
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.9.2
*/
int
virDomainInjectNMI(virDomainPtr domain, unsigned int flags)
* Send key(s) to the guest.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.9.3
*/
int
virDomainSendKey(virDomainPtr domain,
* the container/guest.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v1.0.1
*/
int
virDomainSendProcessSignal(virDomainPtr domain,
* use virDomainSetVcpusFlags().
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.1.4
*/
int
virDomainSetVcpus(virDomainPtr domain, unsigned int nvcpus)
* Not all hypervisors can support all flag combinations.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.8.5
*/
int
virDomainSetVcpusFlags(virDomainPtr domain, unsigned int nvcpus,
* on live domains. Guest agent may be needed for this flag to be available.
*
* Returns the number of vCPUs in case of success, -1 in case of failure.
+ *
+ * Since: v0.8.5
*/
int
virDomainGetVcpusFlags(virDomainPtr domain, unsigned int flags)
* so can only be called on an active domain.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.1.4
*/
int
virDomainPinVcpu(virDomainPtr domain, unsigned int vcpu,
*
* Returns 0 in case of success, -1 in case of failure.
*
+ * Since: v0.9.3
*/
int
virDomainPinVcpuFlags(virDomainPtr domain, unsigned int vcpu,
*
* Returns the number of virtual CPUs in case of success,
* -1 in case of failure.
+ *
+ * Since: v0.9.3
*/
int
virDomainGetVcpuPinInfo(virDomainPtr domain, int ncpumaps,
*
* Returns 0 in case of success, -1 in case of failure.
*
+ * Since: v0.10.0
*/
int
virDomainPinEmulator(virDomainPtr domain, unsigned char *cpumap,
* Returns 1 in case of success,
* 0 in case of no emulator threads are pined to pcpus,
* -1 in case of failure.
+ *
+ * Since: v0.10.0
*/
int
virDomainGetEmulatorPinInfo(virDomainPtr domain, unsigned char *cpumap,
* an inactive domain.
*
* Returns the number of info filled in case of success, -1 in case of failure.
+ *
+ * Since: v0.1.4
*/
int
virDomainGetVcpus(virDomainPtr domain, virVcpuInfoPtr info, int maxinfo,
* guest was booted with. For more details, see virDomainGetVcpusFlags().
*
* Returns the maximum of virtual CPU or -1 in case of error.
+ *
+ * Since: v0.2.1
*/
int
virDomainGetMaxVcpus(virDomainPtr domain)
* On success, the array of information is stored into @info. The caller is
* responsible for calling virDomainIOThreadInfoFree() on each array element,
* then calling free() on @info. On error, @info is set to NULL.
+ *
+ * Since: v1.2.14
*/
int
virDomainGetIOThreadInfo(virDomainPtr dom,
* @info: pointer to a virDomainIOThreadInfo object
*
* Frees the memory used by @info.
+ *
+ * Since: v1.2.14
*/
void
virDomainIOThreadInfoFree(virDomainIOThreadInfoPtr info)
* See also virDomainGetIOThreadInfo for querying this information.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v1.2.14
*/
int
virDomainPinIOThread(virDomainPtr domain,
* just live or both live and persistent state is changed.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v1.2.15
*/
int
virDomainAddIOThread(virDomainPtr domain,
* just live or both live and persistent state is changed.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v1.2.15
*/
int
virDomainDelIOThread(virDomainPtr domain,
* This function requires privileged access to the hypervisor.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v4.10.0
*/
int
virDomainSetIOThreadParams(virDomainPtr domain,
* string if the domain is not running under a security model.
*
* Returns 0 in case of success, -1 in case of failure
+ *
+ * Since: v0.6.1
*/
int
virDomainGetSecurityLabel(virDomainPtr domain, virSecurityLabelPtr seclabel)
* string if the domain is not running under a security model.
*
* Returns number of elements in @seclabels on success, -1 in case of failure.
+ *
+ * Since: v0.10.0
*/
int
virDomainGetSecurityLabelList(virDomainPtr domain,
* or both will be modified.
*
* Returns 0 on success, -1 in case of failure.
+ *
+ * Since: v0.9.10
*/
int
virDomainSetMetadata(virDomainPtr domain,
*
* Returns the metadata string on success (caller must free),
* or NULL in case of failure.
+ *
+ * Since: v0.9.10
*/
char *
virDomainGetMetadata(virDomainPtr domain,
* persistent domain definition.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.1.9
*/
int
virDomainAttachDevice(virDomainPtr domain, const char *xml)
* persistent domain definition.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.7.7
*/
int
virDomainAttachDeviceFlags(virDomainPtr domain,
* See virDomainDetachDeviceFlags() for more details.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.1.9
*/
int
virDomainDetachDevice(virDomainPtr domain, const char *xml)
* may lead to unexpected results.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.7.7
*/
int
virDomainDetachDeviceFlags(virDomainPtr domain,
* domain XML with only the disk path changed.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.8.0
*/
int
virDomainUpdateDeviceFlags(virDomainPtr domain,
* device removal.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v4.4.0
*/
int
virDomainDetachDeviceAlias(virDomainPtr domain,
* Returns 0 on success, -1 on failure. Older versions of some hypervisors
* sometimes returned a positive number on success, but without any reliable
* semantics on what that number represents.
+ *
+ * Since: v0.5.0
*/
int
virConnectDomainEventRegister(virConnectPtr conn,
* Returns 0 on success, -1 on failure. Older versions of some hypervisors
* sometimes returned a positive number on success, but without any reliable
* semantics on what that number represents.
+ *
+ * Since: v0.5.0
*/
int
virConnectDomainEventDeregister(virConnectPtr conn,
* Determine if the domain is currently running
*
* Returns 1 if running, 0 if inactive, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virDomainIsActive(virDomainPtr dom)
* which means it will still exist after shutting down
*
* Returns 1 if persistent, 0 if transient, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virDomainIsPersistent(virDomainPtr dom)
* advised to change these after the rename was successful.
*
* Returns 0 if successfully renamed, -1 on error
+ *
+ * Since: v1.2.19
*/
int
virDomainRename(virDomainPtr dom,
* Determine if the domain has been updated.
*
* Returns 1 if updated, 0 if not, -1 on error
+ *
+ * Since: v0.8.6
*/
int
virDomainIsUpdated(virDomainPtr dom)
* to virDomainGetJobStats().
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.7.7
*/
int
virDomainGetJobInfo(virDomainPtr domain, virDomainJobInfoPtr info)
* source host in case of a migration job).
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v1.0.3
*/
int
virDomainGetJobStats(virDomainPtr domain,
* for more details).
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.7.7
*/
int
virDomainAbortJob(virDomainPtr domain)
* being live-migrated as a reaction to migration progress.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v0.8.0
*/
int
virDomainMigrateSetMaxDowntime(virDomainPtr domain,
* at the end of live migration.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v3.7.0
*/
int
virDomainMigrateGetMaxDowntime(virDomainPtr domain,
* transferred memory pages during live migration.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v1.0.3
*/
int
virDomainMigrateGetCompressionCache(virDomainPtr domain,
* virDomainGetJobStats.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v1.0.3
*/
int
virDomainMigrateSetCompressionCache(virDomainPtr domain,
* phase of the migration.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v0.9.0
*/
int
virDomainMigrateSetMaxSpeed(virDomainPtr domain,
* migration.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v0.9.5
*/
int
virDomainMigrateGetMaxSpeed(virDomainPtr domain,
* migration and there's no domain to run virDomainGetJobStats on).
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v1.3.3
*/
int
virDomainMigrateStartPostCopy(virDomainPtr domain,
* be passed to the virConnectDomainEventDeregisterAny() method.
*
* Returns a callback identifier on success, -1 on failure.
+ *
+ * Since: v0.8.0
*/
int
virConnectDomainEventRegisterAny(virConnectPtr conn,
*
* Returns 0 on success, -1 on failure. Older versions of some hypervisors
* sometimes returned a positive number on success, but without any reliable
- * semantics on what that number represents. */
+ * semantics on what that number represents.
+ *
+ * Since: v0.8.0
+ */
int
virConnectDomainEventDeregisterAny(virConnectPtr conn,
int callbackID)
* flags are mutually exclusive.
*
* Returns 0 in case of success or -1 in case of failure
+ *
+ * Since: v0.8.0
*/
int
virDomainManagedSave(virDomainPtr dom, unsigned int flags)
*
* Returns 0 if no image is present, 1 if an image is present, and
* -1 in case of error
+ *
+ * Since: v0.8.0
*/
int
virDomainHasManagedSaveImage(virDomainPtr dom, unsigned int flags)
* Remove any managed save image for this domain.
*
* Returns 0 in case of success, and -1 in case of error
+ *
+ * Since: v0.8.0
*/
int
virDomainManagedSaveRemove(virDomainPtr dom, unsigned int flags)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case of
* error. The caller must free() the returned value.
+ *
+ * Since: v3.7.0
*/
char *
virDomainManagedSaveGetXMLDesc(virDomainPtr domain, unsigned int flags)
* exclusive.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v3.7.0
*/
int
virDomainManagedSaveDefineXML(virDomainPtr domain, const char *dxml,
* versions, it is up to the client to ensure mutual exclusion.
*
* Returns 0 if the console was opened, -1 on error
+ *
+ * Since: v0.8.6
*/
int
virDomainOpenConsole(virDomainPtr dom,
* other client prior to opening this channel.
*
* Returns 0 if the channel was opened, -1 on error
+ *
+ * Since: v1.0.2
*/
int
virDomainOpenChannel(virDomainPtr dom,
* Linux perf events are performance analyzing tool in Linux.
*
* Returns -1 in case of failure, 0 in case of success.
+ *
+ * Since: v1.3.3
*/
int virDomainGetPerfEvents(virDomainPtr domain,
virTypedParameterPtr *params,
* Linux perf events are performance analyzing tool in Linux.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v1.3.3
*/
int virDomainSetPerfEvents(virDomainPtr domain,
virTypedParameterPtr params,
* beginning of the first phase.
*
* Returns -1 in case of failure, 0 when successful.
+ *
+ * Since: v0.9.4
*/
int
virDomainBlockJobAbort(virDomainPtr dom, const char *disk,
* space required for the backup.
*
* Returns -1 in case of failure, 0 when nothing found, 1 when info was found.
+ *
+ * Since: v0.9.4
*/
int
virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk,
* elements within //domain/devices/disk.
*
* Returns -1 in case of failure, 0 when successful.
+ *
+ * Since: v0.9.4
*/
int
virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk,
* This is shorthand for virDomainBlockRebase() with a NULL base.
*
* Returns 0 if the operation has started, -1 on failure.
+ *
+ * Since: v0.9.4
*/
int
virDomainBlockPull(virDomainPtr dom, const char *disk,
* to the source format or probed from the reused file.
*
* Returns 0 if the operation has started, -1 on failure.
+ *
+ * Since: v0.9.10
*/
int
virDomainBlockRebase(virDomainPtr dom, const char *disk,
* is not a local file, and the possibility of additional tuning parameters.
*
* Returns 0 if the operation has started, -1 on failure.
+ *
+ * Since: v1.2.8
*/
int
virDomainBlockCopy(virDomainPtr dom, const char *disk,
* virDomainGetBlockJobInfo().
*
* Returns 0 if the operation has started, -1 on failure.
+ *
+ * Since: v0.10.2
*/
int
virDomainBlockCommit(virDomainPtr dom, const char *disk,
* to use this method over a TCP connection will always fail
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v0.9.7
*/
int
virDomainOpenGraphics(virDomainPtr dom,
* to use this method over a TCP connection will always fail.
*
* Returns an fd on success, -1 on failure
+ *
+ * Since: v1.2.8
*/
int
virDomainOpenGraphicsFD(virDomainPtr dom,
* within //domain/devices/disk.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.8
*/
int
virDomainSetBlockIoTune(virDomainPtr dom,
* unless @nparams is 0 on input.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.8
*/
int
virDomainGetBlockIoTune(virDomainPtr dom,
* skipped elements if @nparams is too large, and tail elements if
* @ncpus is too large). The caller is responsible for freeing any
* returned string parameters.
+ *
+ * Since: v0.9.10
*/
int
virDomainGetCPUStats(virDomainPtr domain,
*
* Returns number of disks with errors filled in the @errors array or -1 on
* error.
+ *
+ * Since: v0.9.10
*/
int
virDomainGetDiskErrors(virDomainPtr dom,
*
* Returns the hostname which must be freed by the caller, or
* NULL if there was an error.
+ *
+ * Since: v0.10.0
*/
char *
virDomainGetHostname(virDomainPtr domain, unsigned int flags)
* If @minimum is not zero, the command may fail.
*
* Returns 0 on success, -1 otherwise.
+ *
+ * Since: v1.0.1
*/
int
virDomainFSTrim(virDomainPtr dom,
* support mountpoints argument), @mountpoints may need to be NULL.
*
* Returns the number of frozen filesystems on success, -1 otherwise.
+ *
+ * Since: v1.2.5
*/
int
virDomainFSFreeze(virDomainPtr dom,
* In some drivers (e.g. QEMU driver), @mountpoints may need to be NULL.
*
* Returns the number of thawed filesystems on success, -1 otherwise.
+ *
+ * Since: v1.2.5
*/
int
virDomainFSThaw(virDomainPtr dom,
* be configured and running in order to run this API.
*
* Returns 0 on success, -1 otherwise.
+ *
+ * Since: v1.2.5
*/
int
virDomainGetTime(virDomainPtr dom,
* be configured and running in order to be able to run this API.
*
* Returns 0 on success, -1 otherwise.
+ *
+ * Since: v1.2.5
*/
int
virDomainSetTime(virDomainPtr dom,
* be configured and running in order to be able to run this API.
*
* Returns 0 on success, -1 otherwise.
+ *
+ * Since: v1.2.16
*/
int
virDomainSetUserPassword(virDomainPtr dom,
*
* Returns NULL in case of error or an XML string
* defining the capabilities.
+ *
+ * Since: v1.2.7
*/
char *
virConnectGetDomainCapabilities(virConnectPtr conn,
* Returns the count of returned statistics structures on success, -1 on error.
* The requested data are returned in the @retStats parameter. The returned
* array should be freed by the caller. See virDomainStatsRecordListFree.
+ *
+ * Since: v1.2.8
*/
int
virConnectGetAllDomainStats(virConnectPtr conn,
* array should be freed by the caller. See virDomainStatsRecordListFree.
* Note that the count of returned stats may be less than the domain count
* provided via @doms.
+ *
+ * Since: v1.2.8
*/
int
virDomainListGetStats(virDomainPtr *doms,
*
* Convenience function to free a list of domain stats returned by
* virDomainListGetStats and virConnectGetAllDomainStats.
+ *
+ * Since: v1.2.8
*/
void
virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats)
* On success, the array of the information is stored into @info. The caller is
* responsible for calling virDomainFSInfoFree() on each array element, then
* calling free() on @info. On error, @info is set to NULL.
+ *
+ * Since: v1.2.11
*/
int
virDomainGetFSInfo(virDomainPtr dom,
* @info: pointer to a FSInfo object
*
* Frees all the memory occupied by @info.
+ *
+ * Since: v1.2.11
*/
void
virDomainFSInfoFree(virDomainFSInfoPtr info)
* free(ifaces);
*
* Returns the number of interfaces on success, -1 in case of error.
+ *
+ * Since: v1.2.14
*/
int
virDomainInterfaceAddresses(virDomainPtr dom,
* Free the interface object. The data structure is
* freed and should not be used thereafter. If @iface
* is NULL, then this method has no effect.
+ *
+ * Since: v1.2.14
*/
void
virDomainInterfaceFree(virDomainInterfacePtr iface)
* virTypedParamsFree to free memory returned in @params.
*
* Returns 0 on success, -1 on error.
+ *
+ * Since: v2.0.0
*/
int
virDomainGetGuestVcpus(virDomainPtr domain,
* low-level features a S3 sleep.
*
* Returns 0 on success, -1 on error.
+ *
+ * Since: v2.0.0
*/
int
virDomainSetGuestVcpus(virDomainPtr domain,
* Note that OSes and hypervisors may require vCPU 0 to stay online.
*
* Returns 0 on success, -1 on error.
+ *
+ * Since: v3.1.0
*/
int
virDomainSetVcpu(virDomainPtr domain,
* virTypedParamsFree to free memory returned in @params.
*
* Returns 0 on success, -1 on error.
+ *
+ * Since: v5.7.0
*/
int virDomainGetGuestInfo(virDomainPtr domain,
unsigned int types,
* tools to grow it without the need for polling of the data.
*
* Returns 0 if the operation has started, -1 on failure.
+ *
+ * Since: v3.2.0
*/
int
virDomainSetBlockThreshold(virDomainPtr domain,
* any action for running domain.
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v3.9.0
*/
int virDomainSetLifecycleAction(virDomainPtr domain,
unsigned int type,
* return the launch measurement.
*
* Returns -1 in case of failure, 0 in case of success.
+ *
+ * Since: v4.5.0
*/
int virDomainGetLaunchSecurityInfo(virDomainPtr domain,
virTypedParameterPtr *params,
* launch security parameters.
*
* Returns -1 in case of failure, 0 in case of success.
+ *
+ * Since: v8.0.0
*/
int virDomainSetLaunchSecurityState(virDomainPtr domain,
virTypedParameterPtr params,
* positive value: wait for @timeout seconds
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v5.10.0
*/
int
virDomainAgentSetResponseTimeout(virDomainPtr domain,
* formats if checkpoints are not involved.
*
* Returns 0 on success or -1 on failure.
+ *
+ * Since: v6.0.0
*/
int
virDomainBackupBegin(virDomainPtr domain,
*
* Returns a NUL-terminated UTF-8 encoded XML instance or NULL in
* case of error. The caller must free() the returned value.
+ *
+ * Since: v6.0.0
*/
char *
virDomainBackupGetXMLDesc(virDomainPtr domain,
*
* Returns: number of keys stored in @keys,
* -1 otherwise.
+ *
+ * Since: v6.10.0
*/
int
virDomainAuthorizedSSHKeysGet(virDomainPtr domain,
*
* Returns: 0 on success,
* -1 otherwise.
+ *
+ * Since: v6.10.0
*/
int
virDomainAuthorizedSSHKeysSet(virDomainPtr domain,
*
* Returns: number of messages stored in @msgs,
* -1 otherwise.
+ *
+ * Since: v7.1.0
*/
int
virDomainGetMessages(virDomainPtr domain,
* virConnectGetAllDomainStats.
*
* Returns 0 in case of success, -1 otherwise.
+ *
+ * Since: v7.2.0
*/
int
virDomainStartDirtyRateCalc(virDomainPtr domain,
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure
+ *
+ * Since: v0.6.0
*/
int
virConnectRef(virConnectPtr conn)
* on a connection if the application is not trustworthy.
*
* Returns: 0 if the identity change was accepted, -1 on error
+ *
+ * Since: v5.8.0
*/
int
virConnectSetIdentity(virConnectPtr conn,
* hypervisor, use virConnectGetCapabilities().
*
* Returns NULL in case of error, a static zero terminated string otherwise.
+ *
+ * Since: v0.0.3
*/
const char *
virConnectGetType(virConnectPtr conn)
* Returns -1 in case of error, 0 otherwise. if the version can't be
* extracted by lack of capacities returns 0 and @hvVer is 0, otherwise
* @hvVer value is major * 1,000,000 + minor * 1,000 + release
+ *
+ * Since: v0.0.3
*/
int
virConnectGetVersion(virConnectPtr conn, unsigned long *hvVer)
*
* Returns -1 in case of failure, 0 otherwise, and values for @libVer have
* the format major * 1,000,000 + minor * 1,000 + release.
+ *
+ * Since: v0.7.3
*/
int
virConnectGetLibVersion(virConnectPtr conn, unsigned long *libVer)
*
* Returns the hostname which must be freed by the caller, or
* NULL if there was an error.
+ *
+ * Since: v0.3.0
*/
char *
virConnectGetHostname(virConnectPtr conn)
*
* Returns the URI string which must be freed by the caller, or
* NULL if there was an error.
+ *
+ * Since: v0.3.0
*/
char *
virConnectGetURI(virConnectPtr conn)
*
* Returns the XML string which must be freed by the caller, or
* NULL if there was an error.
+ *
+ * Since: v0.8.8
*/
char *
virConnectGetSysinfo(virConnectPtr conn, unsigned int flags)
* for "<vcpu max='...'>" in its output instead.
*
* Returns the maximum of virtual CPU or -1 in case of error.
+ *
+ * Since: v0.2.1
*/
int
virConnectGetMaxVcpus(virConnectPtr conn,
* in a more accurate representation.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.1.0
*/
int
virNodeGetInfo(virConnectPtr conn, virNodeInfoPtr info)
* Returns NULL in case of error, or an XML string
* defining the capabilities.
* The client must free the returned string after use.
+ *
+ * Since: v0.2.1
*/
char *
virConnectGetCapabilities(virConnectPtr conn)
* represents all CPUs on the server.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.3
*/
int
virNodeGetCPUStats(virConnectPtr conn,
* The cached memory usage.(KB)
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v0.9.3
*/
int
virNodeGetMemoryStats(virConnectPtr conn,
* function the returned value is in bytes. Divide by 1024 as necessary.
*
* Returns the available free memory in bytes or 0 in case of error
+ *
+ * Since: v0.3.3
*/
unsigned long long
virNodeGetFreeMemory(virConnectPtr conn)
* Returns 0 on success (i.e., the node will be suspended after a short
* delay), -1 on failure (the operation is not supported, or an attempted
* suspend is already underway).
+ *
+ * Since: v0.9.8
*/
int
virNodeSuspendForDuration(virConnectPtr conn,
* example.
*
* Returns 0 in case of success, and -1 in case of failure.
+ *
+ * Since: v0.10.2
*/
int
virNodeGetMemoryParameters(virConnectPtr conn,
* This function may require privileged access to the hypervisor.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.10.2
*/
int
virNodeSetMemoryParameters(virConnectPtr conn,
* string if the driver has not activated a security model.
*
* Returns 0 in case of success, -1 in case of failure
+ *
+ * Since: v0.6.1
*/
int
virNodeGetSecurityModel(virConnectPtr conn, virSecurityModelPtr secmodel)
* whichever is smaller.
*
* Returns the number of entries filled in freeMems, or -1 in case of error.
+ *
+ * Since: v0.3.3
*/
int
virNodeGetCellsFreeMemory(virConnectPtr conn, unsigned long long *freeMems,
* Determine if the connection to the hypervisor is encrypted
*
* Returns 1 if encrypted, 0 if not encrypted, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virConnectIsEncrypted(virConnectPtr conn)
* to eavesdropping (eg a UNIX domain socket, or pipe)
*
* Returns 1 if secure, 0 if not secure, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virConnectIsSecure(virConnectPtr conn)
* (instead of VIR_CPU_COMPARE_INCOMPATIBLE) and the error will use the
* VIR_ERR_CPU_INCOMPATIBLE code with a message providing more details about
* the incompatibility.
+ *
+ * Since: v0.7.5
*/
int
virConnectCompareCPU(virConnectPtr conn,
* VIR_CPU_COMPARE_INCOMPATIBLE) and the error will use the
* VIR_ERR_CPU_INCOMPATIBLE code with a message providing more details about
* the incompatibility.
+ *
+ * Since: v4.4.0
*/
int
virConnectCompareHypervisorCPU(virConnectPtr conn,
*
* Returns -1 on error, number of elements in @models on success (0 means
* libvirt accepts any CPU model).
+ *
+ * Since: v1.1.3
*/
int
virConnectGetCPUModelNames(virConnectPtr conn, const char *arch, char ***models,
* CPU will not include features that block migration.
*
* Returns XML description of the computed CPU (caller frees) or NULL on error.
+ *
+ * Since: v0.7.7
*/
char *
virConnectBaselineCPU(virConnectPtr conn,
* CPU will not include features that block migration.
*
* Returns XML description of the computed CPU (caller frees) or NULL on error.
+ *
+ * Since: v4.4.0
*/
char *
virConnectBaselineHypervisorCPU(virConnectPtr conn,
*
* Returns -1 on error, 0 on success, 1 when remote party doesn't support
* keepalive messages.
+ *
+ * Since: v0.9.8
*/
int
virConnectSetKeepAlive(virConnectPtr conn,
* over a channel (TCP or UNIX socket) which is not closed.
*
* Returns 1 if alive, 0 if dead, -1 on error
+ *
+ * Since: v0.9.8
*/
int
virConnectIsAlive(virConnectPtr conn)
* context.
*
* Returns 0 on success, -1 on error
+ *
+ * Since: v0.10.0
*/
int
virConnectRegisterCloseCallback(virConnectPtr conn,
* registration, it will be invoked
*
* Returns 0 on success, -1 on error
+ *
+ * Since: v0.10.0
*/
int
virConnectUnregisterCloseCallback(virConnectPtr conn,
*
* Returns number of CPUs present on the host node,
* or -1 if there was an error.
+ *
+ * Since: v1.0.0
*/
int
virNodeGetCPUMap(virConnectPtr conn,
* Page size=1073741824 count=0 bytes=0
*
* Returns: the number of entries filled in @counts or -1 in case of error.
+ *
+ * Since: v1.2.6
*/
int
virNodeGetFreePages(virConnectPtr conn,
*
* Returns: the number of nodes successfully adjusted or -1 in
* case of an error.
+ *
+ * Since: v1.2.9
*/
int
virNodeAllocPages(virConnectPtr conn,
* responsible for freeing @params.
*
* Returns 0 in case of success, and -1 in case of failure.
+ *
+ * Since: v4.5.0
*/
int
virNodeGetSEVInfo(virConnectPtr conn,
* call.
*
* Returns the virConnectPtr or NULL in case of failure.
+ *
+ * Since: v0.6.4
*/
virConnectPtr
virInterfaceGetConnect(virInterfacePtr iface)
* extra allocated element set to NULL but not included in the return count,
* to make iteration easier. The caller is responsible for calling
* virStorageInterfaceFree() on each array element, then calling free() on @ifaces.
+ *
+ * Since: v0.10.2
*/
int
virConnectListAllInterfaces(virConnectPtr conn,
* Provides the number of active interfaces on the physical host.
*
* Returns the number of active interfaces found or -1 in case of error
+ *
+ * Since: v0.6.4
*/
int
virConnectNumOfInterfaces(virConnectPtr conn)
* to virConnectNumOfInterfaces() and this call; you are only guaranteed that
* all currently active interfaces were listed if the return is less than
* @maxnames. The client must call free() on each returned name.
+ *
+ * Since: v0.6.4
*/
int
virConnectListInterfaces(virConnectPtr conn, char **const names, int maxnames)
* Provides the number of defined (inactive) interfaces on the physical host.
*
* Returns the number of defined interface found or -1 in case of error
+ *
+ * Since: v0.7.0
*/
int
virConnectNumOfDefinedInterfaces(virConnectPtr conn)
* a call to virConnectNumOfDefinedInterfaces() and this call; you are only
* guaranteed that all currently defined interfaces were listed if the return
* is less than @maxnames. The client must call free() on each returned name.
+ *
+ * Since: v0.7.0
*/
int
virConnectListDefinedInterfaces(virConnectPtr conn,
*
* Returns a new interface object or NULL in case of failure. If the
* interface cannot be found, then VIR_ERR_NO_INTERFACE error is raised.
+ *
+ * Since: v0.6.4
*/
virInterfacePtr
virInterfaceLookupByName(virConnectPtr conn, const char *name)
*
* Returns a new interface object or NULL in case of failure. If the
* interface cannot be found, then VIR_ERR_NO_INTERFACE error is raised.
+ *
+ * Since: v0.6.4
*/
virInterfacePtr
virInterfaceLookupByMACString(virConnectPtr conn, const char *macstr)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* its lifetime will be the same as the interface object.
+ *
+ * Since: v0.6.4
*/
const char *
virInterfaceGetName(virInterfacePtr iface)
* Returns a pointer to the MAC address (in null-terminated ASCII
* format) or NULL, the string need not be deallocated its lifetime
* will be the same as the interface object.
+ *
+ * Since: v0.6.4
*/
const char *
virInterfaceGetMACString(virInterfacePtr iface)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v0.6.4
*/
char *
virInterfaceGetXMLDesc(virInterfacePtr iface, unsigned int flags)
* interface object is no longer needed.
*
* Returns NULL in case of error, a pointer to the interface otherwise
+ *
+ * Since: v0.6.4
*/
virInterfacePtr
virInterfaceDefineXML(virConnectPtr conn, const char *xml, unsigned int flags)
* during the next reboot of the system running libvirtd.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.6.4
*/
int
virInterfaceUndefine(virInterfacePtr iface)
* undefined) if virInterfaceChangeRollback() is called.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.6.4
*/
int
virInterfaceCreate(virInterfacePtr iface, unsigned int flags)
* interface definition will also bring the interface back up.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.6.4
*/
int
virInterfaceDestroy(virInterfacePtr iface, unsigned int flags)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.4
*/
int
virInterfaceRef(virInterfacePtr iface)
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.6.4
*/
int
virInterfaceFree(virInterfacePtr iface)
* VIR_ERR_INVALID_OPERATION will be logged.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.2
*/
int
virInterfaceChangeBegin(virConnectPtr conn, unsigned int flags)
* will be logged.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.2
*/
int
virInterfaceChangeCommit(virConnectPtr conn, unsigned int flags)
* will be logged.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.9.2
*/
int
virInterfaceChangeRollback(virConnectPtr conn, unsigned int flags)
* Determine if the interface is currently running
*
* Returns 1 if running, 0 if inactive, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virInterfaceIsActive(virInterfacePtr iface)
* call.
*
* Returns the virConnectPtr or NULL in case of failure.
+ *
+ * Since: v0.3.0
*/
virConnectPtr
virNetworkGetConnect(virNetworkPtr net)
* extra allocated element set to NULL but not included in the return count,
* to make iteration easier. The caller is responsible for calling
* virNetworkFree() on each array element, then calling free() on @nets.
+ *
+ * Since: v0.10.2
*/
int
virConnectListAllNetworks(virConnectPtr conn,
* Provides the number of active networks.
*
* Returns the number of network found or -1 in case of error
+ *
+ * Since: v0.2.0
*/
int
virConnectNumOfNetworks(virConnectPtr conn)
* to virConnectNumOfNetworks() and this call; you are only guaranteed that
* all currently active networks were listed if the return is less than
* @maxnames. The client must call free() on each returned name.
+ *
+ * Since: v0.2.0
*/
int
virConnectListNetworks(virConnectPtr conn, char **const names, int maxnames)
* Provides the number of inactive networks.
*
* Returns the number of networks found or -1 in case of error
+ *
+ * Since: v0.2.0
*/
int
virConnectNumOfDefinedNetworks(virConnectPtr conn)
* a call to virConnectNumOfDefinedNetworks() and this call; you are only
* guaranteed that all currently defined networks were listed if the return
* is less than @maxnames. The client must call free() on each returned name.
+ *
+ * Since: v0.2.0
*/
int
virConnectListDefinedNetworks(virConnectPtr conn, char **const names,
*
* Returns a new network object or NULL in case of failure. If the
* network cannot be found, then VIR_ERR_NO_NETWORK error is raised.
+ *
+ * Since: v0.2.0
*/
virNetworkPtr
virNetworkLookupByName(virConnectPtr conn, const char *name)
*
* Returns a new network object or NULL in case of failure. If the
* network cannot be found, then VIR_ERR_NO_NETWORK error is raised.
+ *
+ * Since: v0.2.0
*/
virNetworkPtr
virNetworkLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
*
* Returns a new network object or NULL in case of failure. If the
* network cannot be found, then VIR_ERR_NO_NETWORK error is raised.
+ *
+ * Since: v0.2.0
*/
virNetworkPtr
virNetworkLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
* network object is no longer needed.
*
* Returns a new network object or NULL in case of failure
+ *
+ * Since: v0.2.0
*/
virNetworkPtr
virNetworkCreateXML(virConnectPtr conn, const char *xmlDesc)
* network object is no longer needed.
*
* Returns a new network object or NULL in case of failure
+ *
+ * Since: v7.8.0
*/
virNetworkPtr
virNetworkCreateXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags)
* network object is no longer needed.
*
* Returns NULL in case of error, a pointer to the network otherwise
+ *
+ * Since: v0.2.0
*/
virNetworkPtr
virNetworkDefineXML(virConnectPtr conn, const char *xml)
* network object is no longer needed.
*
* Returns NULL in case of error, a pointer to the network otherwise
+ *
+ * Since: v7.7.0
*/
virNetworkPtr
virNetworkDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags)
* Undefine a network but does not stop it if it is running
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.2.0
*/
int
virNetworkUndefine(virNetworkPtr network)
* running state, its persistent configuration, or both.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.10.2
*/
int
virNetworkUpdate(virNetworkPtr network,
* moves from the defined to the running networks pools.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.2.0
*/
int
virNetworkCreate(virNetworkPtr network)
* This function may require privileged access
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.2.0
*/
int
virNetworkDestroy(virNetworkPtr network)
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.2.0
*/
int
virNetworkFree(virNetworkPtr network)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.0
*/
int
virNetworkRef(virNetworkPtr network)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* its lifetime will be the same as the network object.
+ *
+ * Since: v0.2.0
*/
const char *
virNetworkGetName(virNetworkPtr network)
* Get the UUID for a network
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.2.0
*/
int
virNetworkGetUUID(virNetworkPtr network, unsigned char *uuid)
* UUID see RFC4122.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.2.0
*/
int
virNetworkGetUUIDString(virNetworkPtr network, char *buf)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v0.2.0
*/
char *
virNetworkGetXMLDesc(virNetworkPtr network, unsigned int flags)
*
* Returns a 0 terminated interface name, or NULL in case of
* error. The caller must free() the returned value.
+ *
+ * Since: v0.2.0
*/
char *
virNetworkGetBridgeName(virNetworkPtr network)
* machine boots.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.2.1
*/
int
virNetworkGetAutostart(virNetworkPtr network,
* when the host machine boots.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.2.1
*/
int
virNetworkSetAutostart(virNetworkPtr network,
* Determine if the network is currently running
*
* Returns 1 if running, 0 if inactive, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virNetworkIsActive(virNetworkPtr net)
* which means it will still exist after shutting down
*
* Returns 1 if persistent, 0 if transient, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virNetworkIsPersistent(virNetworkPtr net)
* be passed to the virConnectNetworkEventDeregisterAny() method.
*
* Returns a callback identifier on success, -1 on failure.
+ *
+ * Since: v1.2.1
*/
int
virConnectNetworkEventRegisterAny(virConnectPtr conn,
* value obtained from a previous virConnectNetworkEventRegisterAny() method.
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v1.2.1
*/
int
virConnectNetworkEventDeregisterAny(virConnectPtr conn,
* Returns the number of leases found or -1 and sets @leases to NULL in
* case of error.
*
+ * Since: v1.2.6
*/
int
virNetworkGetDHCPLeases(virNetworkPtr network,
* @lease: pointer to a leases object
*
* Frees all the memory occupied by @lease.
+ *
+ * Since: v1.2.6
*/
void
virNetworkDHCPLeaseFree(virNetworkDHCPLeasePtr lease)
*
* Returns a new network port object or NULL in case of failure. If the
* network port cannot be found, then VIR_ERR_NO_NETWORK_PORT error is raised.
+ *
+ * Since: v5.5.0
*/
virNetworkPortPtr
virNetworkPortLookupByUUID(virNetworkPtr net,
*
* Returns a new network port object or NULL in case of failure. If the
* network port cannot be found, then VIR_ERR_NO_NETWORK_PORT error is raised.
+ *
+ * Since: v5.5.0
*/
virNetworkPortPtr
virNetworkPortLookupByUUIDString(virNetworkPtr net,
* includes bandwidth parameters.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortSetParameters(virNetworkPortPtr port,
* on success.
*
* Returns -1 in case of error, 0 in case of success.
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortGetParameters(virNetworkPortPtr port,
* network port object is no longer needed.
*
* Returns a new network port object or NULL in case of failure
+ *
+ * Since: v5.5.0
*/
virNetworkPortPtr
virNetworkPortCreateXML(virNetworkPtr net,
* call.
*
* Returns the virNetworkPtr or NULL in case of failure.
+ *
+ * Since: v5.5.0
*/
virNetworkPtr
virNetworkPortGetNetwork(virNetworkPortPtr port)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case of error.
* the caller must free() the returned value.
+ *
+ * Since: v5.5.0
*/
char *
virNetworkPortGetXMLDesc(virNetworkPortPtr port,
* Get the UUID for a network port
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortGetUUID(virNetworkPortPtr port,
* UUID see RFC4122.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortGetUUIDString(virNetworkPortPtr port,
* port.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortDelete(virNetworkPortPtr port,
* in the return count, to make iteration easier. The caller is responsible
* for calling virNetworkPortFree() on each array element, then calling
* free() on @ports.
+ *
+ * Since: v5.5.0
*/
int
virNetworkListAllPorts(virNetworkPtr network,
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortFree(virNetworkPortPtr port)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v5.5.0
*/
int
virNetworkPortRef(virNetworkPortPtr port)
* will be restricted to devices with the specified capability
*
* Returns the number of node devices or -1 in case of error
+ *
+ * Since: v0.5.0
*/
int
virNodeNumOfDevices(virConnectPtr conn, const char *cap, unsigned int flags)
* count, to make iteration easier. The caller is responsible for calling
* virNodeDeviceFree() on each array element, then calling free() on
* @devices.
+ *
+ * Since: v0.10.2
*/
int
virConnectListAllNodeDevices(virConnectPtr conn,
* will be restricted to devices with the specified capability
*
* Returns the number of node devices found or -1 in case of error
+ *
+ * Since: v0.5.0
*/
int
virNodeListDevices(virConnectPtr conn,
* node device object is no longer needed.
*
* Returns a virNodeDevicePtr if found, NULL otherwise.
+ *
+ * Since: v0.5.0
*/
virNodeDevicePtr
virNodeDeviceLookupByName(virConnectPtr conn, const char *name)
* node device object is no longer needed.
*
* Returns a virNodeDevicePtr if found, NULL otherwise.
+ *
+ * Since: v1.0.3
*/
virNodeDevicePtr
virNodeDeviceLookupSCSIHostByWWN(virConnectPtr conn,
* the device.
*
* Returns the XML document, or NULL on error
+ *
+ * Since: v0.5.0
*/
char *
virNodeDeviceGetXMLDesc(virNodeDevicePtr dev, unsigned int flags)
* Just return the device name
*
* Returns the device name or NULL in case of error
+ *
+ * Since: v0.5.0
*/
const char *
virNodeDeviceGetName(virNodeDevicePtr dev)
*
* Returns the name of the device's parent, or NULL if an
* error occurred or when the device has no parent.
+ *
+ * Since: v0.5.0
*/
const char *
virNodeDeviceGetParent(virNodeDevicePtr dev)
*
* Returns the number of capabilities supported by the device or -1
* in case of error.
+ *
+ * Since: v0.5.0
*/
int
virNodeDeviceNumOfCaps(virNodeDevicePtr dev)
*
* Returns the number of capability names listed in @names or -1
* in case of error.
+ *
+ * Since: v0.5.0
*/
int
virNodeDeviceListCaps(virNodeDevicePtr dev,
* this was the last reference.
*
* Returns the 0 for success, -1 for error.
+ *
+ * Since: v0.5.0
*/
int
virNodeDeviceFree(virNodeDevicePtr dev)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.0
*/
int
virNodeDeviceRef(virNodeDevicePtr dev)
* API should be used instead.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.1
*/
int
virNodeDeviceDettach(virNodeDevicePtr dev)
* to the node using the virNodeDeviceReAttach() method.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v1.0.5
*/
int
virNodeDeviceDetachFlags(virNodeDevicePtr dev,
* If the device is currently in use by a guest, this method may fail.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.1
*/
int
virNodeDeviceReAttach(virNodeDevicePtr dev)
* this function may fail.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.1
*/
int
virNodeDeviceReset(virNodeDevicePtr dev)
* node device object is no longer needed.
*
* Returns a node device object if successful, NULL in case of failure
+ *
+ * Since: v0.6.3
*/
virNodeDevicePtr
virNodeDeviceCreateXML(virConnectPtr conn,
* may require privileged access.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.6.3
*/
int
virNodeDeviceDestroy(virNodeDevicePtr dev)
* node device object is no longer needed.
*
* Returns a node device object if successful, NULL in case of failure
+ *
+ * Since: v7.3.0
*/
virNodeDevicePtr
virNodeDeviceDefineXML(virConnectPtr conn,
* operating system. This function may require privileged access.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v7.3.0
*/
int
virNodeDeviceUndefine(virNodeDevicePtr dev,
* Start a defined node device:
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v7.3.0
*/
int
virNodeDeviceCreate(virNodeDevicePtr dev,
* be passed to the virConnectNodeDeviceEventDeregisterAny() method.
*
* Returns a callback identifier on success, -1 on failure.
+ *
+ * Since: v2.2.0
*/
int
virConnectNodeDeviceEventRegisterAny(virConnectPtr conn,
* value obtained from a previous virConnectNodeDeviceEventRegisterAny() method.
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v2.2.0
*/
int
virConnectNodeDeviceEventDeregisterAny(virConnectPtr conn,
* boots or the parent device becomes available.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v7.8.0
*/
int
virNodeDeviceSetAutostart(virNodeDevicePtr dev,
* becomes available.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v7.8.0
*/
int
virNodeDeviceGetAutostart(virNodeDevicePtr dev,
* which means it will still exist after shutting down
*
* Returns 1 if persistent, 0 if transient, -1 on error
+ *
+ * Since: v7.8.0
*/
int
virNodeDeviceIsPersistent(virNodeDevicePtr dev)
* Determine if the node device is currently active
*
* Returns 1 if active, 0 if inactive, -1 on error
+ *
+ * Since: v7.8.0
*/
int virNodeDeviceIsActive(virNodeDevicePtr dev)
{
* Provides the number of nwfilters.
*
* Returns the number of nwfilters found or -1 in case of error
+ *
+ * Since: v0.8.0
*/
int
virConnectNumOfNWFilters(virConnectPtr conn)
* have an extra allocated element set to NULL but not included in the return count,
* to make iteration easier. The caller is responsible for calling
* virNWFilterFree() on each array element, then calling free() on @filters.
+ *
+ * Since: v0.10.2
*/
int
virConnectListAllNWFilters(virConnectPtr conn,
* virConnectListAllNWFilters().
*
* Returns the number of network filters found or -1 in case of error
+ *
+ * Since: v0.8.0
*/
int
virConnectListNWFilters(virConnectPtr conn, char **const names, int maxnames)
*
* Returns a new nwfilter object or NULL in case of failure. If the
* network filter cannot be found, then VIR_ERR_NO_NWFILTER error is raised.
+ *
+ * Since: v0.8.0
*/
virNWFilterPtr
virNWFilterLookupByName(virConnectPtr conn, const char *name)
*
* Returns a new nwfilter object or NULL in case of failure. If the
* nwfdilter cannot be found, then VIR_ERR_NO_NWFILTER error is raised.
+ *
+ * Since: v0.8.0
*/
virNWFilterPtr
virNWFilterLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
*
* Returns a new nwfilter object or NULL in case of failure. If the
* nwfilter cannot be found, then VIR_ERR_NO_NWFILTER error is raised.
+ *
+ * Since: v0.8.0
*/
virNWFilterPtr
virNWFilterLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.8.0
*/
int
virNWFilterFree(virNWFilterPtr nwfilter)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* its lifetime will be the same as the nwfilter object.
+ *
+ * Since: v0.8.0
*/
const char *
virNWFilterGetName(virNWFilterPtr nwfilter)
* Get the UUID for a network filter
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.8.0
*/
int
virNWFilterGetUUID(virNWFilterPtr nwfilter, unsigned char *uuid)
* UUID see RFC4122.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.8.0
*/
int
virNWFilterGetUUIDString(virNWFilterPtr nwfilter, char *buf)
* nwfilter object is no longer needed.
*
* Returns a new nwfilter object or NULL in case of failure
+ *
+ * Since: v0.8.0
*/
virNWFilterPtr
virNWFilterDefineXML(virConnectPtr conn, const char *xmlDesc)
* nwfilter object is no longer needed.
*
* Returns a new nwfilter object or NULL in case of failure
+ *
+ * Since: v7.7.0
*/
virNWFilterPtr
virNWFilterDefineXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags)
* associated virNWFilterPtr object.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v0.8.0
*/
int
virNWFilterUndefine(virNWFilterPtr nwfilter)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v0.8.0
*/
char *
virNWFilterGetXMLDesc(virNWFilterPtr nwfilter, unsigned int flags)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.8.0
*/
int
virNWFilterRef(virNWFilterPtr nwfilter)
* have an extra allocated element set to NULL but not included in the return count,
* to make iteration easier. The caller is responsible for calling
* virNWFilterFree() on each array element, then calling free() on @filters.
+ *
+ * Since: v4.5.0
*/
int
virConnectListAllNWFilterBindings(virConnectPtr conn,
* Returns a new binding object or NULL in case of failure. If the
* network filter cannot be found, then VIR_ERR_NO_NWFILTER_BINDING
* error is raised.
+ *
+ * Since: v4.5.0
*/
virNWFilterBindingPtr
virNWFilterBindingLookupByPortDev(virConnectPtr conn, const char *portdev)
* The data structure is freed and should not be used thereafter.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v4.5.0
*/
int
virNWFilterBindingFree(virNWFilterBindingPtr binding)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* its lifetime will be the same as the binding object.
+ *
+ * Since: v4.5.0
*/
const char *
virNWFilterBindingGetPortDev(virNWFilterBindingPtr binding)
*
* Returns a pointer to the name or NULL, the string need not be deallocated
* its lifetime will be the same as the binding object.
+ *
+ * Since: v4.5.0
*/
const char *
virNWFilterBindingGetFilterName(virNWFilterBindingPtr binding)
* binding object is no longer needed.
*
* Returns a new binding object or NULL in case of failure
+ *
+ * Since: v4.5.0
*/
virNWFilterBindingPtr
virNWFilterBindingCreateXML(virConnectPtr conn, const char *xml, unsigned int flags)
* would be accomplished by using virNWFilterBindingCreateXML.
*
* Returns 0 in case of success and -1 in case of failure.
+ *
+ * Since: v4.5.0
*/
int
virNWFilterBindingDelete(virNWFilterBindingPtr binding)
*
* Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case
* of error. The caller must free() the returned value.
+ *
+ * Since: v4.5.0
*/
char *
virNWFilterBindingGetXMLDesc(virNWFilterBindingPtr binding, unsigned int flags)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v4.5.0
*/
int
virNWFilterBindingRef(virNWFilterBindingPtr binding)
* counter on the connection is not increased by this call.
*
* Returns the virConnectPtr or NULL in case of failure.
+ *
+ * Since: v0.7.1
*/
virConnectPtr
virSecretGetConnect(virSecretPtr secret)
* Fetch number of currently defined secrets.
*
* Returns the number currently defined secrets.
+ *
+ * Since: v0.7.1
*/
int
virConnectNumOfSecrets(virConnectPtr conn)
* have an extra allocated element set to NULL but not included in the return count,
* to make iteration easier. The caller is responsible for calling
* virSecretFree() on each array element, then calling free() on @secrets.
+ *
+ * Since: v0.10.2
*/
int
virConnectListAllSecrets(virConnectPtr conn,
* virConnectListAllSecrets().
*
* Returns the number of UUIDs provided in the array, or -1 on failure.
+ *
+ * Since: v0.7.1
*/
int
virConnectListSecrets(virConnectPtr conn, char **uuids, int maxuuids)
*
* Returns a new secret object or NULL in case of failure. If the
* secret cannot be found, then VIR_ERR_NO_SECRET error is raised.
+ *
+ * Since: v0.7.1
*/
virSecretPtr
virSecretLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
*
* Returns a new secret object or NULL in case of failure. If the
* secret cannot be found, then VIR_ERR_NO_SECRET error is raised.
+ *
+ * Since: v0.7.1
*/
virSecretPtr
virSecretLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
*
* Returns a new secret object or NULL in case of failure. If the
* secret cannot be found, then VIR_ERR_NO_SECRET error is raised.
+ *
+ * Since: v0.7.1
*/
virSecretPtr
virSecretLookupByUsage(virConnectPtr conn,
* secret object is no longer needed.
*
* Returns a secret on success, NULL on failure.
+ *
+ * Since: v0.7.1
*/
virSecretPtr
virSecretDefineXML(virConnectPtr conn, const char *xml, unsigned int flags)
*
* Returns 0 on success with the uuid buffer being filled, or
* -1 upon failure.
+ *
+ * Since: v0.7.1
*/
int
virSecretGetUUID(virSecretPtr secret, unsigned char *uuid)
* UUID see RFC4122.
*
* Returns -1 in case of error, 0 in case of success
+ *
+ * Since: v0.7.1
*/
int
virSecretGetUUIDString(virSecretPtr secret, char *buf)
*
* Returns a positive integer identifying the type of object,
* or -1 upon error.
+ *
+ * Since: v0.7.1
*/
int
virSecretGetUsageType(virSecretPtr secret)
*
* Returns a string identifying the object using the secret,
* or NULL upon error
+ *
+ * Since: v0.7.1
*/
const char *
virSecretGetUsageID(virSecretPtr secret)
*
* Returns the XML document on success, NULL on failure. The caller must
* free() the XML.
+ *
+ * Since: v0.7.1
*/
char *
virSecretGetXMLDesc(virSecretPtr secret, unsigned int flags)
* Sets the value of a secret.
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v0.7.1
*/
int
virSecretSetValue(virSecretPtr secret, const unsigned char *value,
*
* Returns the secret value on success, NULL on failure. The caller must
* free() the secret value.
+ *
+ * Since: v0.7.1
*/
unsigned char *
virSecretGetValue(virSecretPtr secret, size_t *value_size, unsigned int flags)
* virSecretPtr object.
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v0.7.1
*/
int
virSecretUndefine(virSecretPtr secret)
* increment the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.7.1
*/
int
virSecretRef(virSecretPtr secret)
* Release the secret handle. The underlying secret continues to exist.
*
* Returns 0 on success, or -1 on error
+ *
+ * Since: v0.7.1
*/
int
virSecretFree(virSecretPtr secret)
* be passed to the virConnectSecretEventDeregisterAny() method.
*
* Returns a callback identifier on success, -1 on failure.
+ *
+ * Since: v3.0.0
*/
int
virConnectSecretEventRegisterAny(virConnectPtr conn,
* value obtained from a previous virConnectSecretEventRegisterAny() method.
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v3.0.0
*/
int
virConnectSecretEventDeregisterAny(virConnectPtr conn,
* call.
*
* Returns the virConnectPtr or NULL in case of failure.
+ *
+ * Since: v0.4.1
*/
virConnectPtr
virStoragePoolGetConnect(virStoragePoolPtr pool)
* in the return count, to make iteration easier. The caller is responsible
* for calling virStoragePoolFree() on each array element, then calling
* free() on @pools.
+ *
+ * Since: v0.10.2
*/
int
virConnectListAllStoragePools(virConnectPtr conn,
* Provides the number of active storage pools
*
* Returns the number of pools found, or -1 on error
+ *
+ * Since: v0.4.1
*/
int
virConnectNumOfStoragePools(virConnectPtr conn)
* virConnectNumOfStoragePools() and this call; you are only guaranteed
* that all currently active pools were listed if the return is less than
* @maxnames. The client must call free() on each returned name.
+ *
+ * Since: v0.4.1
*/
int
virConnectListStoragePools(virConnectPtr conn,
* Provides the number of inactive storage pools
*
* Returns the number of pools found, or -1 on error
+ *
+ * Since: v0.4.1
*/
int
virConnectNumOfDefinedStoragePools(virConnectPtr conn)
* a call to virConnectNumOfDefinedStoragePools() and this call; you are only
* guaranteed that all currently defined pools were listed if the return
* is less than @maxnames. The client must call free() on each returned name.
+ *
+ * Since: v0.4.1
*/
int
virConnectListDefinedStoragePools(virConnectPtr conn,
* Returns an xml document consisting of a SourceList element
* containing a source document appropriate to the given pool
* type for each discovered source.
+ *
+ * Since: v0.4.5
*/
char *
virConnectFindStoragePoolSources(virConnectPtr conn,
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
+ *
+ * Since: v0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByName(virConnectPtr conn,
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
+ *
+ * Since: v0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByUUID(virConnectPtr conn,
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
+ *
+ * Since: v0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByUUIDString(virConnectPtr conn,
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
+ *
+ * Since: v0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByVolume(virStorageVolPtr vol)
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
+ *
+ * Since: v4.1.0
*/
virStoragePoolPtr
virStoragePoolLookupByTargetPath(virConnectPtr conn,
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if creation failed
+ *
+ * Since: v0.4.1
*/
virStoragePoolPtr
virStoragePoolCreateXML(virConnectPtr conn,
* storage pool object is no longer needed.
*
* Returns a virStoragePoolPtr object, or NULL if creation failed
+ *
+ * Since: v0.4.1
*/
virStoragePoolPtr
virStoragePoolDefineXML(virConnectPtr conn,
* Build the underlying storage pool
*
* Returns 0 on success, or -1 upon failure
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolBuild(virStoragePoolPtr pool,
* Undefine an inactive storage pool
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolUndefine(virStoragePoolPtr pool)
* Starts an inactive storage pool
*
* Returns 0 on success, or -1 if it could not be started
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolCreate(virStoragePoolPtr pool,
* the associated virStoragePoolPtr object.
*
* Returns 0 on success, or -1 if it could not be destroyed
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolDestroy(virStoragePoolPtr pool)
* itself is not free'd.
*
* Returns 0 on success, or -1 if it could not be obliterate
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolDelete(virStoragePoolPtr pool,
* it. Does not change the state of the pool on the host.
*
* Returns 0 on success, or -1 if it could not be free'd.
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolFree(virStoragePoolPtr pool)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.0
*/
int
virStoragePoolRef(virStoragePoolPtr pool)
* new devices at the OS layer
*
* Returns 0 if the volume list was refreshed, -1 on failure
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolRefresh(virStoragePoolPtr pool,
* Fetch the locally unique name of the storage pool
*
* Returns the name of the pool, or NULL on error
+ *
+ * Since: v0.4.1
*/
const char*
virStoragePoolGetName(virStoragePoolPtr pool)
* Fetch the globally unique ID of the storage pool
*
* Returns 0 on success, or -1 on error;
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolGetUUID(virStoragePoolPtr pool,
* Fetch the globally unique ID of the storage pool as a string
*
* Returns 0 on success, or -1 on error;
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolGetUUIDString(virStoragePoolPtr pool,
* such as free space / usage summary
*
* Returns 0 on success, or -1 on failure.
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolGetInfo(virStoragePoolPtr pool,
* into the virStoragePoolCreateXML method.
*
* Returns a XML document (caller frees), or NULL on error
+ *
+ * Since: v0.4.1
*/
char *
virStoragePoolGetXMLDesc(virStoragePoolPtr pool,
* whether the pool is automatically started at boot time
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolGetAutostart(virStoragePoolPtr pool,
* when the host machine boots.
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolSetAutostart(virStoragePoolPtr pool,
* in the return count, to make iteration easier. The caller is responsible
* for calling virStorageVolFree() on each array element, then calling
* free() on @vols.
+ *
+ * Since: v0.10.2
*/
int
virStoragePoolListAllVolumes(virStoragePoolPtr pool,
* Fetch the number of storage volumes within a pool
*
* Returns the number of storage pools, or -1 on failure
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolNumOfVolumes(virStoragePoolPtr pool)
* virStoragePoolListAllVolumes().
*
* Returns the number of names fetched, or -1 on error
+ *
+ * Since: v0.4.1
*/
int
virStoragePoolListVolumes(virStoragePoolPtr pool,
* call.
*
* Returns the virConnectPtr or NULL in case of failure.
+ *
+ * Since: v0.4.1
*/
virConnectPtr
virStorageVolGetConnect(virStorageVolPtr vol)
* storage volume object is no longer needed.
*
* Returns a storage volume, or NULL if not found / error
+ *
+ * Since: v0.4.1
*/
virStorageVolPtr
virStorageVolLookupByName(virStoragePoolPtr pool,
* storage volume object is no longer needed.
*
* Returns a storage volume, or NULL if not found / error
+ *
+ * Since: v0.4.1
*/
virStorageVolPtr
virStorageVolLookupByKey(virConnectPtr conn,
* storage volume object is no longer needed.
*
* Returns a storage volume, or NULL if not found / error
+ *
+ * Since: v0.4.1
*/
virStorageVolPtr
virStorageVolLookupByPath(virConnectPtr conn,
* within the scope of a pool
*
* Returns the volume name, or NULL on error
+ *
+ * Since: v0.4.1
*/
const char*
virStorageVolGetName(virStorageVolPtr vol)
* key no matter what host it is accessed from
*
* Returns the volume key, or NULL on error
+ *
+ * Since: v0.4.1
*/
const char*
virStorageVolGetKey(virStorageVolPtr vol)
* storage volume object is no longer needed.
*
* Returns the storage volume, or NULL on error
+ *
+ * Since: v0.4.1
*/
virStorageVolPtr
virStorageVolCreateXML(virStoragePoolPtr pool,
* storage volume object is no longer needed.
*
* Returns the storage volume, or NULL on error
+ *
+ * Since: v0.6.4
*/
virStorageVolPtr
virStorageVolCreateXMLFrom(virStoragePoolPtr pool,
* another active stream is writing to the storage volume.
*
* Returns 0, or -1 upon error.
+ *
+ * Since: v0.9.0
*/
int
virStorageVolDownload(virStorageVolPtr vol,
* capacity, and allocation.
*
* Returns 0, or -1 upon error.
+ *
+ * Since: v0.9.0
*/
int
virStorageVolUpload(virStorageVolPtr vol,
* Delete the storage volume from the pool
*
* Returns 0 on success, or -1 on error
+ *
+ * Since: v0.4.1
*/
int
virStorageVolDelete(virStorageVolPtr vol,
* network file systems are known to be problematic.
*
* Returns 0 on success, or -1 on error
+ *
+ * Since: v0.8.0
*/
int
virStorageVolWipe(virStorageVolPtr vol,
* problematic.
*
* Returns 0 on success, or -1 on error.
+ *
+ * Since: v0.9.10
*/
int
virStorageVolWipePattern(virStorageVolPtr vol,
* storage volume continues to exist.
*
* Returns 0 on success, or -1 on error
+ *
+ * Since: v0.4.1
*/
int
virStorageVolFree(virStorageVolPtr vol)
* the reference count.
*
* Returns 0 in case of success, -1 in case of failure.
+ *
+ * Since: v0.6.0
*/
int
virStorageVolRef(virStorageVolPtr vol)
* volume such as its current allocation
*
* Returns 0 on success, or -1 on failure
+ *
+ * Since: v0.4.1
*/
int
virStorageVolGetInfo(virStorageVolPtr vol,
* as is the case with qcow2 files.
*
* Returns 0 on success, or -1 on failure
+ *
+ * Since: v3.0.0
*/
int
virStorageVolGetInfoFlags(virStorageVolPtr vol,
* the storage volume
*
* Returns the XML document, or NULL on error
+ *
+ * Since: v0.4.1
*/
char *
virStorageVolGetXMLDesc(virStorageVolPtr vol,
*
* Returns the storage volume path, or NULL on error. The
* caller must free() the returned path after use.
+ *
+ * Since: v0.4.1
*/
char *
virStorageVolGetPath(virStorageVolPtr vol)
* than the current size.
*
* Returns 0 on success, or -1 on error.
+ *
+ * Since: v0.9.10
*/
int
virStorageVolResize(virStorageVolPtr vol,
* Determine if the storage pool is currently running
*
* Returns 1 if running, 0 if inactive, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virStoragePoolIsActive(virStoragePoolPtr pool)
* which means it will still exist after shutting down
*
* Returns 1 if persistent, 0 if transient, -1 on error
+ *
+ * Since: v0.7.3
*/
int
virStoragePoolIsPersistent(virStoragePoolPtr pool)
* be passed to the virConnectStoragePoolEventDeregisterAny() method.
*
* Returns a callback identifier on success, -1 on failure.
+ *
+ * Since: v2.0.0
*/
int
virConnectStoragePoolEventRegisterAny(virConnectPtr conn,
* value obtained from a previous virConnectStoragePoolEventRegisterAny() method.
*
* Returns 0 on success, -1 on failure
+ *
+ * Since: v2.0.0
*/
int
virConnectStoragePoolEventDeregisterAny(virConnectPtr conn,
* are supported along with the file/disk formats for each pool.
*
* Returns NULL in case of error or an XML string defining the capabilities.
+ *
+ * Since: v5.2.0
*/
char *
virConnectGetStoragePoolCapabilities(virConnectPtr conn,
* VIR_STREAM_NONBLOCK for flags, otherwise pass 0.
*
* Returns the new stream, or NULL upon error
+ *
+ * Since: v0.7.2
*/
virStreamPtr
virStreamNew(virConnectPtr conn,
* the caller no longer needs the reference to this object.
*
* Returns 0 in case of success, -1 in case of failure
+ *
+ * Since: v0.7.2
*/
int
virStreamRef(virStreamPtr stream)
*
* Returns -2 if the outgoing transmit buffers are full &
* the stream is marked as non-blocking.
+ *
+ * Since: v0.7.2
*/
int
virStreamSend(virStreamPtr stream,
*
* Returns -2 if there is no data pending to be read & the
* stream is marked as non-blocking.
+ *
+ * Since: v0.7.2
*/
int
virStreamRecv(virStreamPtr stream,
*
* Returns -3 if there is a hole in stream and caller requested
* to stop at a hole.
+ *
+ * Since: v3.4.0
*/
int
virStreamRecvFlags(virStreamPtr stream,
*
* Returns 0 on success,
* -1 error
+ *
+ * Since: v3.4.0
*/
int
virStreamSendHole(virStreamPtr stream,
*
* Returns 0 on success,
* -1 on error or when there's currently no hole in the stream
+ *
+ * Since: v3.4.0
*/
int
virStreamRecvHole(virStreamPtr stream,
* Returns -1 upon any error, with virStreamAbort() already
* having been called, so the caller need only call
* virStreamFree().
+ *
+ * Since: v0.7.2
*/
int
virStreamSendAll(virStreamPtr stream,
* Returns -1 upon any error, with virStreamAbort() already
* having been called, so the caller need only call
* virStreamFree().
+ *
+ * Since: v3.4.0
*/
int virStreamSparseSendAll(virStreamPtr stream,
virStreamSourceFunc handler,
* Returns -1 upon any error, with virStreamAbort() already
* having been called, so the caller need only call
* virStreamFree()
+ *
+ * Since: v0.7.2
*/
int
virStreamRecvAll(virStreamPtr stream,
*
* Returns -1 upon any error, with virStreamAbort() already
* having been called, so the caller need only call virStreamFree().
+ *
+ * Since: v3.4.0
*/
int
virStreamSparseRecvAll(virStreamPtr stream,
* to integrate into an event loop
*
* Returns 0 on success, -1 upon error
+ *
+ * Since: v0.7.2
*/
int
virStreamEventAddCallback(virStreamPtr stream,
* is guaranteed to succeed if a callback is already registered
*
* Returns 0 on success, -1 if no callback is registered
+ *
+ * Since: v0.7.2
*/
int
virStreamEventUpdateCallback(virStreamPtr stream,
* Remove an event callback from the stream
*
* Returns 0 on success, -1 on error
+ *
+ * Since: v0.7.2
*/
int
virStreamEventRemoveCallback(virStreamPtr stream)
* beforehand.
*
* Returns 0 on success, -1 upon error
+ *
+ * Since: v0.7.2
*/
int
virStreamFinish(virStreamPtr stream)
* beforehand.
*
* Returns 0 on success, -1 upon error
+ *
+ * Since: v0.7.2
*/
int
virStreamAbort(virStreamPtr stream)
* the virStreamAbort function should be called first.
*
* Returns 0 upon success, or -1 on error
+ *
+ * Since: v0.7.2
*/
int
virStreamFree(virStreamPtr stream)
* connection attempt.
*
* Returns 0 in case of success, -1 in case of error
+ *
+ * Since: v0.1.0
*/
int
virInitialize(void)
*
* Returns -1 in case of failure, 0 otherwise, and values for @libVer and
* @typeVer have the format major * 1,000,000 + minor * 1,000 + release.
+ *
+ * Since: v0.0.3
*/
int
virGetVersion(unsigned long *libVer, const char *type G_GNUC_UNUSED,
* is no longer needed.
*
* Returns a pointer to the hypervisor connection or NULL in case of error
+ *
+ * Since: v0.0.3
*/
virConnectPtr
virConnectOpen(const char *name)
* URIs are documented at https://libvirt.org/uri.html
*
* Returns a pointer to the hypervisor connection or NULL in case of error
+ *
+ * Since: v0.0.3
*/
virConnectPtr
virConnectOpenReadOnly(const char *name)
* URIs are documented at https://libvirt.org/uri.html
*
* Returns a pointer to the hypervisor connection or NULL in case of error
+ *
+ * Since: v0.4.0
*/
virConnectPtr
virConnectOpenAuth(const char *name,
* value if some other object still has a temporary reference to the
* connection, but the application should not try to further use a
* connection after the virConnectClose that matches the initial open.
+ *
+ * Since: v0.0.3
*/
int
virConnectClose(virConnectPtr conn)
* threads can safely access this concurrently.
*
* Returns a pointer to the last error or NULL if none occurred.
+ *
+ * Since: v0.1.0
*/
virErrorPtr
virGetLastError(void)
* Get the most recent error code (enum virErrorNumber).
*
* Returns the most recent error code, or VIR_ERR_OK if none is set.
+ *
+ * Since: v4.5.0
*/
int
virGetLastErrorCode(void)
*
* Returns a numerical value of the most recent error's origin, or VIR_FROM_NONE
* if none is set.
+ *
+ * Since: v4.5.0
*/
int
virGetLastErrorDomain(void)
*
* Returns the most recent error message string in this
* thread, or a generic message if none is set
+ *
+ * Since: v1.0.6
*/
const char *
virGetLastErrorMessage(void)
* One will need to free the result with virResetError()
*
* Returns error code or -1 in case of parameter error.
+ *
+ * Since: v0.1.0
*/
int
virCopyLastError(virErrorPtr to)
* Returns a pointer to the copied error or NULL if allocation failed.
* It is the caller's responsibility to free the error with
* virFreeError().
+ *
+ * Since: v0.6.1
*/
virErrorPtr
virSaveLastError(void)
* @err: pointer to the virError to clean up
*
* Reset the error being pointed to
+ *
+ * Since: v0.1.0
*/
void
virResetError(virErrorPtr err)
* @err: error to free
*
* Resets and frees the given error.
+ *
+ * Since: v0.6.1
*/
void
virFreeError(virErrorPtr err)
* The error object is kept in thread local storage, so separate
* threads can safely access this concurrently, only resetting
* their own error object.
+ *
+ * Since: v0.1.0
*/
void
virResetLastError(void)
* remains for backwards compatibility.
*
* Returns a pointer to the last error or NULL if none occurred.
+ *
+ * Since: v0.1.0
*/
virErrorPtr
virConnGetLastError(virConnectPtr conn)
*
* Returns 0 if no error was found and the error code otherwise and -1 in case
* of parameter error.
+ *
+ * Since: v0.1.0
*/
int
virConnCopyLastError(virConnectPtr conn, virErrorPtr to)
* threads can safely access this concurrently.
*
* Reset the last error caught on that connection
+ *
+ * Since: v0.1.0
*/
void
virConnResetLastError(virConnectPtr conn)
* Set a library global error handling function, if @handler is NULL,
* it will reset to default printing on stderr. The error raised there
* are those for which no handler at the connection level could caught.
+ *
+ * Since: v0.1.0
*/
void
virSetErrorFunc(void *userData, virErrorFunc handler)
* Set a connection error handling function, if @handler is NULL
* it will reset to default which is to pass error back to the global
* library handler.
+ *
+ * Since: v0.1.0
*/
void
virConnSetErrorFunc(virConnectPtr conn, void *userData,
* @err: pointer to the error.
*
* Default routine reporting an error to stderr.
+ *
+ * Since: v0.1.0
*/
void
virDefaultErrorFunc(virErrorPtr err)
*
* Returns -1 if the file handle cannot be registered, otherwise a handle
* watch number to be used for updating and unregistering for events.
+ *
+ * Since: v0.9.3
*/
int
virEventAddHandle(int fd,
* virEventRegisterImpl() or virEventRegisterDefaultImpl().
*
* Will not fail if fd exists.
+ *
+ * Since: v0.9.3
*/
void
virEventUpdateHandle(int watch, int events)
* virEventRegisterImpl() or virEventRegisterDefaultImpl().
*
* Returns -1 if the file handle was not registered, 0 upon success.
+ *
+ * Since: v0.9.3
*/
int
virEventRemoveHandle(int watch)
*
* Returns -1 if the timer cannot be registered, a positive
* integer timer id upon success.
+ *
+ * Since: v0.9.3
*/
int
virEventAddTimeout(int timeout,
* to zero will cause it to fire on every event loop iteration.
*
* Will not fail if timer exists.
+ *
+ * Since: v0.9.3
*/
void
virEventUpdateTimeout(int timer, int timeout)
* virEventRegisterImpl() or virEventRegisterDefaultImpl().
*
* Returns -1 if the timer was not registered, 0 upon success.
+ *
+ * Since: v0.9.3
*/
int
virEventRemoveTimeout(int timer)
* virConnectClose on all open connections, so it is not safe
* to stop running the event loop immediately after closing
* the connection.
+ *
+ * Since: v0.5.0
*/
void virEventRegisterImpl(virEventAddHandleFunc addHandle,
virEventUpdateHandleFunc updateHandle,
* virEventAddHandle() or virConnectDomainEventRegisterAny().
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v0.9.0
*/
int virEventRegisterDefaultImpl(void)
{
* }
*
* Returns 0 on success, -1 on failure.
+ *
+ * Since: v0.9.0
*/
int virEventRunDefaultImpl(void)
{
projects / libvirt.git / commitdiff