[PATCH 1/2] docstring: remove 'v' from since metadata
Victor Toso
victortoso at redhat.com
Wed May 4 11:11:23 UTC 2022
Since: v1.2.3 -> Since: 1.2.3
Signed-off-by: Victor Toso <victortoso at redhat.com>
---
include/libvirt/libvirt-admin.h | 64 +-
include/libvirt/libvirt-common.h.in | 46 +-
include/libvirt/libvirt-domain-checkpoint.h | 40 +-
include/libvirt/libvirt-domain-snapshot.h | 74 +-
include/libvirt/libvirt-domain.h | 1862 +++++++++----------
include/libvirt/libvirt-event.h | 26 +-
include/libvirt/libvirt-host.h | 200 +-
include/libvirt/libvirt-interface.h | 18 +-
include/libvirt/libvirt-network.h | 142 +-
include/libvirt/libvirt-nodedev.h | 82 +-
include/libvirt/libvirt-nwfilter.h | 16 +-
include/libvirt/libvirt-qemu.h | 26 +-
include/libvirt/libvirt-secret.h | 56 +-
include/libvirt/libvirt-storage.h | 220 +--
include/libvirt/libvirt-stream.h | 30 +-
include/libvirt/virterror.h | 418 ++---
src/admin/libvirt-admin.c | 62 +-
src/libvirt-domain-checkpoint.c | 24 +-
src/libvirt-domain-snapshot.c | 42 +-
src/libvirt-domain.c | 370 ++--
src/libvirt-host.c | 68 +-
src/libvirt-interface.c | 42 +-
src/libvirt-lxc.c | 8 +-
src/libvirt-network.c | 90 +-
src/libvirt-nodedev.c | 54 +-
src/libvirt-nwfilter.c | 48 +-
src/libvirt-qemu.c | 12 +-
src/libvirt-secret.c | 40 +-
src/libvirt-storage.c | 114 +-
src/libvirt-stream.c | 34 +-
src/libvirt.c | 12 +-
src/util/virerror.c | 30 +-
src/util/virevent.c | 18 +-
src/util/virtypedparam-public.c | 38 +-
34 files changed, 2213 insertions(+), 2213 deletions(-)
diff --git a/include/libvirt/libvirt-admin.h b/include/libvirt/libvirt-admin.h
index 989348ee7b..8533658932 100644
--- a/include/libvirt/libvirt-admin.h
+++ b/include/libvirt/libvirt-admin.h
@@ -38,7 +38,7 @@ extern "C" {
* a virAdmConnect is a private structure representing a connection to
* libvirt daemon.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef struct _virAdmConnect virAdmConnect;
@@ -48,7 +48,7 @@ typedef struct _virAdmConnect virAdmConnect;
* a virAdmServer is a private structure and client-side representation of
* a remote server object
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef struct _virAdmServer virAdmServer;
@@ -58,7 +58,7 @@ typedef struct _virAdmServer virAdmServer;
* a virAdmClient is a private structure and client-side representation of
* a remote server's client object (as server sees clients connected to it)
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef struct _virAdmClient virAdmClient;
@@ -69,7 +69,7 @@ typedef struct _virAdmClient virAdmClient;
* this is the type used to reference a connection to the daemon
* in the API.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef virAdmConnect *virAdmConnectPtr;
@@ -80,7 +80,7 @@ typedef virAdmConnect *virAdmConnectPtr;
* this is the type used to reference client-side representation of a
* remote server object throughout all the APIs.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef virAdmServer *virAdmServerPtr;
@@ -91,7 +91,7 @@ typedef virAdmServer *virAdmServerPtr;
* this is the type used to reference client-side representation of a
* client object throughout all the APIs.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef virAdmClient *virAdmClientPtr;
@@ -121,7 +121,7 @@ int virAdmConnectGetLibVersion(virAdmConnectPtr conn,
*
* A callback to be registered, in case a connection was closed.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef void (*virAdmConnectCloseFunc)(virAdmConnectPtr conn,
int reason,
@@ -147,7 +147,7 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn,
* Macro for the threadpool minWorkers limit: represents the bottom limit to
* number of active workers in threadpool, as VIR_TYPED_PARAM_UINT.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_THREADPOOL_WORKERS_MIN "minWorkers"
@@ -159,7 +159,7 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn,
* The value of this limit has to be greater than VIR_THREADPOOL_WORKERS_MIN
* at all times.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_THREADPOOL_WORKERS_MAX "maxWorkers"
@@ -169,7 +169,7 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn,
* Macro for the threadpool nPrioWorkers attribute: represents the current number
* of active priority workers in threadpool, as VIR_TYPED_PARAM_UINT.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_THREADPOOL_WORKERS_PRIORITY "prioWorkers"
@@ -182,7 +182,7 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_THREADPOOL_WORKERS_FREE "freeWorkers"
@@ -195,7 +195,7 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_THREADPOOL_WORKERS_CURRENT "nWorkers"
@@ -208,7 +208,7 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_THREADPOOL_JOB_QUEUE_DEPTH "jobQueueDepth"
@@ -233,15 +233,15 @@ int virAdmClientFree(virAdmClientPtr client);
/**
* virClientTransport:
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef enum {
- VIR_CLIENT_TRANS_UNIX = 0, /* connection via UNIX socket (Since: v2.0.0) */
- VIR_CLIENT_TRANS_TCP, /* connection via unencrypted TCP socket (Since: v2.0.0) */
- VIR_CLIENT_TRANS_TLS, /* connection via encrypted TCP socket (Since: v2.0.0) */
+ VIR_CLIENT_TRANS_UNIX = 0, /* connection via UNIX socket (Since: 2.0.0) */
+ VIR_CLIENT_TRANS_TCP, /* connection via unencrypted TCP socket (Since: 2.0.0) */
+ VIR_CLIENT_TRANS_TLS, /* connection via encrypted TCP socket (Since: 2.0.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_CLIENT_TRANS_LAST /* (Since: v2.0.0) */
+ VIR_CLIENT_TRANS_LAST /* (Since: 2.0.0) */
# endif
} virClientTransport;
@@ -265,7 +265,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_READONLY "readonly"
@@ -278,7 +278,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_SOCKET_ADDR "sock_addr"
@@ -291,7 +291,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_SASL_USER_NAME "sasl_user_name"
@@ -305,7 +305,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_X509_DISTINGUISHED_NAME "tls_x509_dname"
@@ -319,7 +319,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_UNIX_USER_ID "unix_user_id"
@@ -333,7 +333,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_UNIX_USER_NAME "unix_user_name"
@@ -347,7 +347,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_UNIX_GROUP_ID "unix_group_id"
@@ -361,7 +361,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_UNIX_GROUP_NAME "unix_group_name"
@@ -375,7 +375,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_UNIX_PROCESS_ID "unix_process_id"
@@ -389,7 +389,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_CLIENT_INFO_SELINUX_CONTEXT "selinux_context"
@@ -408,7 +408,7 @@ int virAdmClientClose(virAdmClientPtr client, unsigned int flags);
* Macro for per-server nclients_max limit: represents the upper limit to
* number of clients connected to the server, as uint.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_SERVER_CLIENTS_MAX "nclients_max"
@@ -421,7 +421,7 @@ int virAdmClientClose(virAdmClientPtr client, unsigned int flags);
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_SERVER_CLIENTS_CURRENT "nclients"
@@ -432,7 +432,7 @@ int virAdmClientClose(virAdmClientPtr client, unsigned int flags);
* to number of clients connected to the server, but not authenticated yet,
* as VIR_TYPED_PARAM_UINT.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_SERVER_CLIENTS_UNAUTH_MAX "nclients_unauth_max"
@@ -446,7 +446,7 @@ int virAdmClientClose(virAdmClientPtr client, unsigned int flags);
* NOTE: This attribute is read-only and any attempt to set it will be denied
* by daemon
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_SERVER_CLIENTS_UNAUTH_CURRENT "nclients_unauth"
diff --git a/include/libvirt/libvirt-common.h.in b/include/libvirt/libvirt-common.h.in
index 78751cea7c..ccdbb2a100 100644
--- a/include/libvirt/libvirt-common.h.in
+++ b/include/libvirt/libvirt-common.h.in
@@ -71,7 +71,7 @@ extern "C" {
* Macro providing the version of the library as
* version * 1,000,000 + minor * 1000 + micro
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
# define LIBVIR_VERSION_NUMBER @LIBVIRT_VERSION_NUMBER@
@@ -88,7 +88,7 @@ extern "C" {
* // some code that only works in 1.1.3 and newer
* #endif
*
- * Since: v1.2.0
+ * Since: 1.2.0
*/
# define LIBVIR_CHECK_VERSION(major, minor, micro) \
((major) * 1000000 + (minor) * 1000 + (micro) <= LIBVIR_VERSION_NUMBER)
@@ -108,23 +108,23 @@ extern "C" {
* abide by this requirement may lead to application deadlocks
* or crashes.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef void (*virFreeCallback)(void *opaque);
/**
* virConnectCloseReason:
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
typedef enum {
- VIR_CONNECT_CLOSE_REASON_ERROR = 0, /* Misc I/O error (Since: v0.10.0) */
- VIR_CONNECT_CLOSE_REASON_EOF = 1, /* End-of-file from server (Since: v0.10.0) */
- VIR_CONNECT_CLOSE_REASON_KEEPALIVE = 2, /* Keepalive timer triggered (Since: v0.10.0) */
- VIR_CONNECT_CLOSE_REASON_CLIENT = 3, /* Client requested it (Since: v0.10.0) */
+ VIR_CONNECT_CLOSE_REASON_ERROR = 0, /* Misc I/O error (Since: 0.10.0) */
+ VIR_CONNECT_CLOSE_REASON_EOF = 1, /* End-of-file from server (Since: 0.10.0) */
+ VIR_CONNECT_CLOSE_REASON_KEEPALIVE = 2, /* Keepalive timer triggered (Since: 0.10.0) */
+ VIR_CONNECT_CLOSE_REASON_CLIENT = 3, /* Client requested it (Since: 0.10.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_CONNECT_CLOSE_REASON_LAST /* (Since: v0.10.0) */
+ VIR_CONNECT_CLOSE_REASON_LAST /* (Since: 0.10.0) */
# endif
} virConnectCloseReason;
@@ -133,19 +133,19 @@ typedef enum {
*
* Express the type of a virTypedParameter
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_TYPED_PARAM_INT = 1, /* integer case (Since: v0.9.2) */
- VIR_TYPED_PARAM_UINT = 2, /* unsigned integer case (Since: v0.9.2) */
- VIR_TYPED_PARAM_LLONG = 3, /* long long case (Since: v0.9.2) */
- VIR_TYPED_PARAM_ULLONG = 4, /* unsigned long long case (Since: v0.9.2) */
- VIR_TYPED_PARAM_DOUBLE = 5, /* double case (Since: v0.9.2) */
- VIR_TYPED_PARAM_BOOLEAN = 6, /* boolean(character) case (Since: v0.9.2) */
- VIR_TYPED_PARAM_STRING = 7, /* string case (Since: v0.9.8) */
+ VIR_TYPED_PARAM_INT = 1, /* integer case (Since: 0.9.2) */
+ VIR_TYPED_PARAM_UINT = 2, /* unsigned integer case (Since: 0.9.2) */
+ VIR_TYPED_PARAM_LLONG = 3, /* long long case (Since: 0.9.2) */
+ VIR_TYPED_PARAM_ULLONG = 4, /* unsigned long long case (Since: 0.9.2) */
+ VIR_TYPED_PARAM_DOUBLE = 5, /* double case (Since: 0.9.2) */
+ VIR_TYPED_PARAM_BOOLEAN = 6, /* boolean(character) case (Since: 0.9.2) */
+ VIR_TYPED_PARAM_STRING = 7, /* string case (Since: 0.9.8) */
# ifdef VIR_ENUM_SENTINELS
- VIR_TYPED_PARAM_LAST /* (Since: v0.9.10) */
+ VIR_TYPED_PARAM_LAST /* (Since: 0.9.10) */
# endif
} virTypedParameterType;
@@ -156,7 +156,7 @@ typedef enum {
*
* These enums should not conflict with those of virDomainModificationImpact.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
typedef enum {
/* 1 << 0 is reserved for virDomainModificationImpact */
@@ -172,7 +172,7 @@ typedef enum {
* setting the flag can be used to reject servers that cannot
* return typed strings, even if no strings would be returned.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
VIR_TYPED_PARAM_STRING_OKAY = 1 << 2,
@@ -183,7 +183,7 @@ typedef enum {
*
* Macro providing the field length of virTypedParameter name
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
# define VIR_TYPED_PARAM_FIELD_LENGTH 80
@@ -196,7 +196,7 @@ typedef enum {
* virMemoryParameter are aliases of this type, for use when
* targeting libvirt earlier than 0.9.2.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef struct _virTypedParameter virTypedParameter;
@@ -219,7 +219,7 @@ struct _virTypedParameter {
*
* a pointer to a virTypedParameter structure.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef virTypedParameter *virTypedParameterPtr;
diff --git a/include/libvirt/libvirt-domain-checkpoint.h b/include/libvirt/libvirt-domain-checkpoint.h
index 5476325503..c2f946b805 100644
--- a/include/libvirt/libvirt-domain-checkpoint.h
+++ b/include/libvirt/libvirt-domain-checkpoint.h
@@ -35,7 +35,7 @@
* domain disks have been altered since a point in time, but by itself does
* not allow reverting back to that point in time.
*
- * Since: v5.2.0
+ * Since: 5.2.0
*/
typedef struct _virDomainCheckpoint virDomainCheckpoint;
@@ -46,7 +46,7 @@ typedef struct _virDomainCheckpoint virDomainCheckpoint;
* private structure, and is the type used to reference a domain
* checkpoint in the API.
*
- * Since: v5.2.0
+ * Since: 5.2.0
*/
typedef virDomainCheckpoint *virDomainCheckpointPtr;
@@ -57,17 +57,17 @@ virConnectPtr virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint);
/**
* virDomainCheckpointCreateFlags:
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
typedef enum {
VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE = (1 << 0), /* Restore or alter
- metadata (Since: v5.6.0) */
+ metadata (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_CREATE_QUIESCE = (1 << 1), /* use guest agent to
quiesce all mounted
file systems within
- the domain (Since: v5.6.0) */
+ the domain (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE_VALIDATE = (1 << 2), /* validate disk data state
- when redefining a checkpoint (Since: v6.10.0) */
+ when redefining a checkpoint (Since: 6.10.0) */
} virDomainCheckpointCreateFlags;
/* Create a checkpoint using the current VM state. */
@@ -77,14 +77,14 @@ virDomainCheckpointPtr virDomainCheckpointCreateXML(virDomainPtr domain,
/**
* virDomainCheckpointXMLFlags:
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
typedef enum {
- VIR_DOMAIN_CHECKPOINT_XML_SECURE = (1 << 0), /* Include sensitive data (Since: v5.6.0) */
+ VIR_DOMAIN_CHECKPOINT_XML_SECURE = (1 << 0), /* Include sensitive data (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_XML_NO_DOMAIN = (1 << 1), /* Suppress <domain>
- subelement (Since: v5.6.0) */
+ subelement (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_XML_SIZE = (1 << 2), /* Include dynamic
- per-<disk> size (Since: v5.6.0) */
+ per-<disk> size (Since: 5.6.0) */
} virDomainCheckpointXMLFlags;
/* Dump the XML of a checkpoint */
@@ -101,23 +101,23 @@ char *virDomainCheckpointGetXMLDesc(virDomainCheckpointPtr checkpoint,
* recursive. Remaining bits come in groups; if all bits from a group
* are 0, then that group is not used to filter results.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
typedef enum {
VIR_DOMAIN_CHECKPOINT_LIST_ROOTS = (1 << 0), /* Filter by checkpoints
with no parents, when
- listing a domain (Since: v5.6.0) */
+ listing a domain (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_LIST_DESCENDANTS = (1 << 0), /* List all descendants,
not just children, when
- listing a checkpoint (Since: v5.6.0) */
+ listing a checkpoint (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_LIST_TOPOLOGICAL = (1 << 1), /* Ensure parents occur
before children in
- the resulting list (Since: v5.6.0) */
+ the resulting list (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_LIST_LEAVES = (1 << 2), /* Filter by checkpoints
- with no children (Since: v5.6.0) */
+ with no children (Since: 5.6.0) */
VIR_DOMAIN_CHECKPOINT_LIST_NO_LEAVES = (1 << 3), /* Filter by checkpoints
- that have children (Since: v5.6.0) */
+ that have children (Since: 5.6.0) */
} virDomainCheckpointListFlags;
/* Get all checkpoint objects for this domain */
@@ -144,12 +144,12 @@ virDomainCheckpointPtr virDomainCheckpointGetParent(virDomainCheckpointPtr check
*
* Delete a checkpoint
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
typedef enum {
- VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN = (1 << 0), /* Also delete children (Since: v5.6.0) */
- VIR_DOMAIN_CHECKPOINT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata (Since: v5.6.0) */
- VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children (Since: v5.6.0) */
+ VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN = (1 << 0), /* Also delete children (Since: 5.6.0) */
+ VIR_DOMAIN_CHECKPOINT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata (Since: 5.6.0) */
+ VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children (Since: 5.6.0) */
} virDomainCheckpointDeleteFlags;
int virDomainCheckpointDelete(virDomainCheckpointPtr checkpoint,
diff --git a/include/libvirt/libvirt-domain-snapshot.h b/include/libvirt/libvirt-domain-snapshot.h
index fc7aaba747..a11cd3f823 100644
--- a/include/libvirt/libvirt-domain-snapshot.h
+++ b/include/libvirt/libvirt-domain-snapshot.h
@@ -35,7 +35,7 @@
* time, with the intent that the guest can be reverted back to that
* state at a later time.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef struct _virDomainSnapshot virDomainSnapshot;
@@ -45,7 +45,7 @@ typedef struct _virDomainSnapshot virDomainSnapshot;
* A virDomainSnapshotPtr is pointer to a virDomainSnapshot private structure,
* and is the type used to reference a domain snapshot in the API.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef virDomainSnapshot *virDomainSnapshotPtr;
@@ -56,32 +56,32 @@ virConnectPtr virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot);
/**
* virDomainSnapshotCreateFlags:
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
typedef enum {
VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE = (1 << 0), /* Restore or alter
- metadata (Since: v0.9.5) */
+ metadata (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_CREATE_CURRENT = (1 << 1), /* With redefine, make
- snapshot current (Since: v0.9.5) */
+ snapshot current (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_CREATE_NO_METADATA = (1 << 2), /* Make snapshot without
- remembering it (Since: v0.9.5) */
+ remembering it (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_CREATE_HALT = (1 << 3), /* Stop running guest
- after snapshot (Since: v0.9.5) */
+ after snapshot (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_CREATE_DISK_ONLY = (1 << 4), /* disk snapshot, not
- full system (Since: v0.9.5) */
+ full system (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_CREATE_REUSE_EXT = (1 << 5), /* reuse any existing
- external files (Since: v0.9.10) */
+ external files (Since: 0.9.10) */
VIR_DOMAIN_SNAPSHOT_CREATE_QUIESCE = (1 << 6), /* use guest agent to
quiesce all mounted
file systems within
- the domain (Since: v0.9.10) */
+ the domain (Since: 0.9.10) */
VIR_DOMAIN_SNAPSHOT_CREATE_ATOMIC = (1 << 7), /* atomically avoid
- partial changes (Since: v0.9.11) */
+ partial changes (Since: 0.9.11) */
VIR_DOMAIN_SNAPSHOT_CREATE_LIVE = (1 << 8), /* create the snapshot
while the guest is
- running (Since: v1.0.1) */
+ running (Since: 1.0.1) */
VIR_DOMAIN_SNAPSHOT_CREATE_VALIDATE = (1 << 9), /* validate the XML
- against the schema (Since: v5.6.0) */
+ against the schema (Since: 5.6.0) */
} virDomainSnapshotCreateFlags;
/* Take a snapshot of the current VM state */
@@ -91,10 +91,10 @@ virDomainSnapshotPtr virDomainSnapshotCreateXML(virDomainPtr domain,
/**
* virDomainSnapshotXMLFlags:
*
- * Since: v5.1.0
+ * Since: 5.1.0
*/
typedef enum {
- VIR_DOMAIN_SNAPSHOT_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: v5.1.0) */
+ VIR_DOMAIN_SNAPSHOT_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: 5.1.0) */
} virDomainSnapshotXMLFlags;
/* Dump the XML of a snapshot */
@@ -113,48 +113,48 @@ char *virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr snapshot,
* recursive. Remaining bits come in groups; if all bits from a group are
* 0, then that group is not used to filter results.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
typedef enum {
VIR_DOMAIN_SNAPSHOT_LIST_ROOTS = (1 << 0), /* Filter by snapshots
with no parents, when
- listing a domain (Since: v0.9.5) */
+ listing a domain (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_LIST_DESCENDANTS = (1 << 0), /* List all descendants,
not just children, when
- listing a snapshot (Since: v0.9.7) */
+ listing a snapshot (Since: 0.9.7) */
VIR_DOMAIN_SNAPSHOT_LIST_LEAVES = (1 << 2), /* Filter by snapshots
- with no children (Since: v0.9.7) */
+ with no children (Since: 0.9.7) */
VIR_DOMAIN_SNAPSHOT_LIST_NO_LEAVES = (1 << 3), /* Filter by snapshots
- that have children (Since: v0.9.13) */
+ that have children (Since: 0.9.13) */
VIR_DOMAIN_SNAPSHOT_LIST_METADATA = (1 << 1), /* Filter by snapshots
- which have metadata (Since: v0.9.5) */
+ which have metadata (Since: 0.9.5) */
VIR_DOMAIN_SNAPSHOT_LIST_NO_METADATA = (1 << 4), /* Filter by snapshots
- with no metadata (Since: v0.9.13) */
+ with no metadata (Since: 0.9.13) */
VIR_DOMAIN_SNAPSHOT_LIST_INACTIVE = (1 << 5), /* Filter by snapshots
taken while guest was
- shut off (Since: v1.0.1) */
+ shut off (Since: 1.0.1) */
VIR_DOMAIN_SNAPSHOT_LIST_ACTIVE = (1 << 6), /* Filter by snapshots
taken while guest was
active, and with
- memory state (Since: v1.0.1) */
+ memory state (Since: 1.0.1) */
VIR_DOMAIN_SNAPSHOT_LIST_DISK_ONLY = (1 << 7), /* Filter by snapshots
taken while guest was
active, but without
- memory state (Since: v1.0.1) */
+ memory state (Since: 1.0.1) */
VIR_DOMAIN_SNAPSHOT_LIST_INTERNAL = (1 << 8), /* Filter by snapshots
stored internal to
- disk images (Since: v1.0.1) */
+ disk images (Since: 1.0.1) */
VIR_DOMAIN_SNAPSHOT_LIST_EXTERNAL = (1 << 9), /* Filter by snapshots
that use files external
- to disk images (Since: v1.0.1) */
+ to disk images (Since: 1.0.1) */
VIR_DOMAIN_SNAPSHOT_LIST_TOPOLOGICAL = (1 << 10), /* Ensure parents occur
before children in
- the resulting list (Since: v5.2.0) */
+ the resulting list (Since: 5.2.0) */
} virDomainSnapshotListFlags;
/* Return the number of snapshots for this domain */
@@ -211,13 +211,13 @@ int virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot,
/**
* virDomainSnapshotRevertFlags:
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
typedef enum {
- VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING = 1 << 0, /* Run after revert (Since: v0.9.5) */
- VIR_DOMAIN_SNAPSHOT_REVERT_PAUSED = 1 << 1, /* Pause after revert (Since: v0.9.5) */
- VIR_DOMAIN_SNAPSHOT_REVERT_FORCE = 1 << 2, /* Allow risky reverts (Since: v0.9.7) */
- VIR_DOMAIN_SNAPSHOT_REVERT_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template (Since: v8.1.0) */
+ VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING = 1 << 0, /* Run after revert (Since: 0.9.5) */
+ VIR_DOMAIN_SNAPSHOT_REVERT_PAUSED = 1 << 1, /* Pause after revert (Since: 0.9.5) */
+ VIR_DOMAIN_SNAPSHOT_REVERT_FORCE = 1 << 2, /* Allow risky reverts (Since: 0.9.7) */
+ VIR_DOMAIN_SNAPSHOT_REVERT_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template (Since: 8.1.0) */
} virDomainSnapshotRevertFlags;
/* Revert the domain to a point-in-time snapshot. The
@@ -232,12 +232,12 @@ int virDomainRevertToSnapshot(virDomainSnapshotPtr snapshot,
*
* Delete a snapshot
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef enum {
- VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN = (1 << 0), /* Also delete children (Since: v0.8.0) */
- VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata (Since: v0.9.5) */
- VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children (Since: v0.9.5) */
+ VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN = (1 << 0), /* Also delete children (Since: 0.8.0) */
+ VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata (Since: 0.9.5) */
+ VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children (Since: 0.9.5) */
} virDomainSnapshotDeleteFlags;
int virDomainSnapshotDelete(virDomainSnapshotPtr snapshot,
diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index 9386f5189c..2edef9c4e1 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -33,7 +33,7 @@
*
* a virDomain is a private structure representing a domain.
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef struct _virDomain virDomain;
@@ -43,7 +43,7 @@ typedef struct _virDomain virDomain;
* a virDomainPtr is pointer to a virDomain private structure, this is the
* type used to reference a domain in the API.
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef virDomain *virDomainPtr;
@@ -52,18 +52,18 @@ typedef virDomain *virDomainPtr;
*
* A domain may be in different states at a given point in time
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef enum {
- VIR_DOMAIN_NOSTATE = 0, /* no state (Since: v0.0.1) */
- VIR_DOMAIN_RUNNING = 1, /* the domain is running (Since: v0.0.1) */
- VIR_DOMAIN_BLOCKED = 2, /* the domain is blocked on resource (Since: v0.0.1) */
- VIR_DOMAIN_PAUSED = 3, /* the domain is paused by user (Since: v0.0.1) */
- VIR_DOMAIN_SHUTDOWN= 4, /* the domain is being shut down (Since: v0.0.1) */
- VIR_DOMAIN_SHUTOFF = 5, /* the domain is shut off (Since: v0.0.1) */
- VIR_DOMAIN_CRASHED = 6, /* the domain is crashed (Since: v0.0.2) */
+ VIR_DOMAIN_NOSTATE = 0, /* no state (Since: 0.0.1) */
+ VIR_DOMAIN_RUNNING = 1, /* the domain is running (Since: 0.0.1) */
+ VIR_DOMAIN_BLOCKED = 2, /* the domain is blocked on resource (Since: 0.0.1) */
+ VIR_DOMAIN_PAUSED = 3, /* the domain is paused by user (Since: 0.0.1) */
+ VIR_DOMAIN_SHUTDOWN= 4, /* the domain is being shut down (Since: 0.0.1) */
+ VIR_DOMAIN_SHUTOFF = 5, /* the domain is shut off (Since: 0.0.1) */
+ VIR_DOMAIN_CRASHED = 6, /* the domain is crashed (Since: 0.0.2) */
VIR_DOMAIN_PMSUSPENDED = 7, /* the domain is suspended by guest
- power management (Since: v0.9.11) */
+ power management (Since: 0.9.11) */
# ifdef VIR_ENUM_SENTINELS
VIR_DOMAIN_LAST
@@ -72,7 +72,7 @@ typedef enum {
* added to the libvirt API. It reflects the last state supported
* by this version of the libvirt API.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# endif
} virDomainState;
@@ -80,152 +80,152 @@ typedef enum {
/**
* virDomainNostateReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_NOSTATE_UNKNOWN = 0, /* (Since: v0.9.2) */
+ VIR_DOMAIN_NOSTATE_UNKNOWN = 0, /* (Since: 0.9.2) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_NOSTATE_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_NOSTATE_LAST /* (Since: 0.9.10) */
# endif
} virDomainNostateReason;
/**
* virDomainRunningReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_RUNNING_UNKNOWN = 0, /* (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_BOOTED = 1, /* normal startup from boot (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_MIGRATED = 2, /* migrated from another host (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_RESTORED = 3, /* restored from a state file (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_FROM_SNAPSHOT = 4, /* restored from snapshot (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_UNPAUSED = 5, /* returned from paused state (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_MIGRATION_CANCELED = 6, /* returned from migration (Since: v0.9.2) */
- VIR_DOMAIN_RUNNING_SAVE_CANCELED = 7, /* returned from failed save process (Since: v0.9.2) */
+ VIR_DOMAIN_RUNNING_UNKNOWN = 0, /* (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_BOOTED = 1, /* normal startup from boot (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_MIGRATED = 2, /* migrated from another host (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_RESTORED = 3, /* restored from a state file (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_FROM_SNAPSHOT = 4, /* restored from snapshot (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_UNPAUSED = 5, /* returned from paused state (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_MIGRATION_CANCELED = 6, /* returned from migration (Since: 0.9.2) */
+ VIR_DOMAIN_RUNNING_SAVE_CANCELED = 7, /* returned from failed save process (Since: 0.9.2) */
VIR_DOMAIN_RUNNING_WAKEUP = 8, /* returned from pmsuspended due to
- wakeup event (Since: v0.9.11) */
- VIR_DOMAIN_RUNNING_CRASHED = 9, /* resumed from crashed (Since: v1.1.1) */
- VIR_DOMAIN_RUNNING_POSTCOPY = 10, /* running in post-copy migration mode (Since: v1.3.3) */
+ wakeup event (Since: 0.9.11) */
+ VIR_DOMAIN_RUNNING_CRASHED = 9, /* resumed from crashed (Since: 1.1.1) */
+ VIR_DOMAIN_RUNNING_POSTCOPY = 10, /* running in post-copy migration mode (Since: 1.3.3) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_RUNNING_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_RUNNING_LAST /* (Since: 0.9.10) */
# endif
} virDomainRunningReason;
/**
* virDomainBlockedReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_BLOCKED_UNKNOWN = 0, /* the reason is unknown (Since: v0.9.2) */
+ VIR_DOMAIN_BLOCKED_UNKNOWN = 0, /* the reason is unknown (Since: 0.9.2) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_BLOCKED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_BLOCKED_LAST /* (Since: 0.9.10) */
# endif
} virDomainBlockedReason;
/**
* virDomainPausedReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_PAUSED_UNKNOWN = 0, /* the reason is unknown (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_USER = 1, /* paused on user request (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_MIGRATION = 2, /* paused for offline migration (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_SAVE = 3, /* paused for save (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_DUMP = 4, /* paused for offline core dump (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_IOERROR = 5, /* paused due to a disk I/O error (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_WATCHDOG = 6, /* paused due to a watchdog event (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_FROM_SNAPSHOT = 7, /* paused after restoring from snapshot (Since: v0.9.2) */
- VIR_DOMAIN_PAUSED_SHUTTING_DOWN = 8, /* paused during shutdown process (Since: v0.9.5) */
- VIR_DOMAIN_PAUSED_SNAPSHOT = 9, /* paused while creating a snapshot (Since: v1.0.1) */
- VIR_DOMAIN_PAUSED_CRASHED = 10, /* paused due to a guest crash (Since: v1.1.1) */
- VIR_DOMAIN_PAUSED_STARTING_UP = 11, /* the domain is being started (Since: v1.2.14) */
- VIR_DOMAIN_PAUSED_POSTCOPY = 12, /* paused for post-copy migration (Since: v1.3.3) */
- VIR_DOMAIN_PAUSED_POSTCOPY_FAILED = 13, /* paused after failed post-copy (Since: v1.3.3) */
+ VIR_DOMAIN_PAUSED_UNKNOWN = 0, /* the reason is unknown (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_USER = 1, /* paused on user request (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_MIGRATION = 2, /* paused for offline migration (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_SAVE = 3, /* paused for save (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_DUMP = 4, /* paused for offline core dump (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_IOERROR = 5, /* paused due to a disk I/O error (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_WATCHDOG = 6, /* paused due to a watchdog event (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_FROM_SNAPSHOT = 7, /* paused after restoring from snapshot (Since: 0.9.2) */
+ VIR_DOMAIN_PAUSED_SHUTTING_DOWN = 8, /* paused during shutdown process (Since: 0.9.5) */
+ VIR_DOMAIN_PAUSED_SNAPSHOT = 9, /* paused while creating a snapshot (Since: 1.0.1) */
+ VIR_DOMAIN_PAUSED_CRASHED = 10, /* paused due to a guest crash (Since: 1.1.1) */
+ VIR_DOMAIN_PAUSED_STARTING_UP = 11, /* the domain is being started (Since: 1.2.14) */
+ VIR_DOMAIN_PAUSED_POSTCOPY = 12, /* paused for post-copy migration (Since: 1.3.3) */
+ VIR_DOMAIN_PAUSED_POSTCOPY_FAILED = 13, /* paused after failed post-copy (Since: 1.3.3) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_PAUSED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_PAUSED_LAST /* (Since: 0.9.10) */
# endif
} virDomainPausedReason;
/**
* virDomainShutdownReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_SHUTDOWN_UNKNOWN = 0, /* the reason is unknown (Since: v0.9.2) */
- VIR_DOMAIN_SHUTDOWN_USER = 1, /* shutting down on user request (Since: v0.9.2) */
+ VIR_DOMAIN_SHUTDOWN_UNKNOWN = 0, /* the reason is unknown (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTDOWN_USER = 1, /* shutting down on user request (Since: 0.9.2) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_SHUTDOWN_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_SHUTDOWN_LAST /* (Since: 0.9.10) */
# endif
} virDomainShutdownReason;
/**
* virDomainShutoffReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_SHUTOFF_UNKNOWN = 0, /* the reason is unknown (Since: v0.9.2) */
- VIR_DOMAIN_SHUTOFF_SHUTDOWN = 1, /* normal shutdown (Since: v0.9.2) */
- VIR_DOMAIN_SHUTOFF_DESTROYED = 2, /* forced poweroff (Since: v0.9.2) */
- VIR_DOMAIN_SHUTOFF_CRASHED = 3, /* domain crashed (Since: v0.9.2) */
- VIR_DOMAIN_SHUTOFF_MIGRATED = 4, /* migrated to another host (Since: v0.9.2) */
- VIR_DOMAIN_SHUTOFF_SAVED = 5, /* saved to a file (Since: v0.9.2) */
- VIR_DOMAIN_SHUTOFF_FAILED = 6, /* domain failed to start (Since: v0.9.2) */
+ VIR_DOMAIN_SHUTOFF_UNKNOWN = 0, /* the reason is unknown (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTOFF_SHUTDOWN = 1, /* normal shutdown (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTOFF_DESTROYED = 2, /* forced poweroff (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTOFF_CRASHED = 3, /* domain crashed (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTOFF_MIGRATED = 4, /* migrated to another host (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTOFF_SAVED = 5, /* saved to a file (Since: 0.9.2) */
+ VIR_DOMAIN_SHUTOFF_FAILED = 6, /* domain failed to start (Since: 0.9.2) */
VIR_DOMAIN_SHUTOFF_FROM_SNAPSHOT = 7, /* restored from a snapshot which was
- * taken while domain was shutoff (Since: v0.9.2) */
+ * taken while domain was shutoff (Since: 0.9.2) */
VIR_DOMAIN_SHUTOFF_DAEMON = 8, /* daemon decides to kill domain
- during reconnection processing (Since: v4.10.0) */
+ during reconnection processing (Since: 4.10.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_SHUTOFF_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_SHUTOFF_LAST /* (Since: 0.9.10) */
# endif
} virDomainShutoffReason;
/**
* virDomainCrashedReason:
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_CRASHED_UNKNOWN = 0, /* crashed for unknown reason (Since: v0.9.2) */
- VIR_DOMAIN_CRASHED_PANICKED = 1, /* domain panicked (Since: v1.1.1) */
+ VIR_DOMAIN_CRASHED_UNKNOWN = 0, /* crashed for unknown reason (Since: 0.9.2) */
+ VIR_DOMAIN_CRASHED_PANICKED = 1, /* domain panicked (Since: 1.1.1) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_CRASHED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_CRASHED_LAST /* (Since: 0.9.10) */
# endif
} virDomainCrashedReason;
/**
* virDomainPMSuspendedReason:
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef enum {
- VIR_DOMAIN_PMSUSPENDED_UNKNOWN = 0, /* (Since: v0.9.11) */
+ VIR_DOMAIN_PMSUSPENDED_UNKNOWN = 0, /* (Since: 0.9.11) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_PMSUSPENDED_LAST /* (Since: v0.9.11) */
+ VIR_DOMAIN_PMSUSPENDED_LAST /* (Since: 0.9.11) */
# endif
} virDomainPMSuspendedReason;
/**
* virDomainPMSuspendedDiskReason:
*
- * Since: v1.0.0
+ * Since: 1.0.0
*/
typedef enum {
- VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWN = 0, /* (Since: v1.0.0) */
+ VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWN = 0, /* (Since: 1.0.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_PMSUSPENDED_DISK_LAST /* (Since: v1.0.0) */
+ VIR_DOMAIN_PMSUSPENDED_DISK_LAST /* (Since: 1.0.0) */
# endif
} virDomainPMSuspendedDiskReason;
@@ -234,20 +234,20 @@ typedef enum {
*
* Current state of a control interface to the domain.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef enum {
- VIR_DOMAIN_CONTROL_OK = 0, /* operational, ready to accept commands (Since: v0.9.3) */
+ VIR_DOMAIN_CONTROL_OK = 0, /* operational, ready to accept commands (Since: 0.9.3) */
VIR_DOMAIN_CONTROL_JOB = 1, /* background job is running (can be
monitored by virDomainGetJobInfo); only
- limited set of commands may be allowed (Since: v0.9.3) */
- VIR_DOMAIN_CONTROL_OCCUPIED = 2, /* occupied by a running command (Since: v0.9.3) */
+ limited set of commands may be allowed (Since: 0.9.3) */
+ VIR_DOMAIN_CONTROL_OCCUPIED = 2, /* occupied by a running command (Since: 0.9.3) */
VIR_DOMAIN_CONTROL_ERROR = 3, /* unusable, domain cannot be fully
operated, possible reason is provided
- in the details field (Since: v0.9.3) */
+ in the details field (Since: 0.9.3) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_CONTROL_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_CONTROL_LAST /* (Since: 0.9.10) */
# endif
} virDomainControlState;
@@ -256,20 +256,20 @@ typedef enum {
*
* Reason for the error state.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef enum {
VIR_DOMAIN_CONTROL_ERROR_REASON_NONE = 0, /* server didn't provide a
- reason (Since: v1.2.14) */
+ reason (Since: 1.2.14) */
VIR_DOMAIN_CONTROL_ERROR_REASON_UNKNOWN = 1, /* unknown reason for the
- error (Since: v1.2.14) */
+ error (Since: 1.2.14) */
VIR_DOMAIN_CONTROL_ERROR_REASON_MONITOR = 2, /* monitor connection is
- broken (Since: v1.2.14) */
+ broken (Since: 1.2.14) */
VIR_DOMAIN_CONTROL_ERROR_REASON_INTERNAL = 3, /* error caused due to
- internal failure in libvirt (Since: v1.2.14)
+ internal failure in libvirt (Since: 1.2.14)
*/
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_CONTROL_ERROR_REASON_LAST /* (Since: v1.2.14) */
+ VIR_DOMAIN_CONTROL_ERROR_REASON_LAST /* (Since: 1.2.14) */
# endif
} virDomainControlErrorReason;
@@ -279,7 +279,7 @@ typedef enum {
* Structure filled in by virDomainGetControlInfo and providing details about
* current state of control interface to a domain.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef struct _virDomainControlInfo virDomainControlInfo;
struct _virDomainControlInfo {
@@ -296,7 +296,7 @@ struct _virDomainControlInfo {
*
* Pointer to virDomainControlInfo structure.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef virDomainControlInfo *virDomainControlInfoPtr;
@@ -318,12 +318,12 @@ typedef virDomainControlInfo *virDomainControlInfoPtr;
*
* These enums should not conflict with those of virTypedParameterFlags.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
typedef enum {
- VIR_DOMAIN_AFFECT_CURRENT = 0, /* Affect current domain state. (Since: v0.9.2) */
- VIR_DOMAIN_AFFECT_LIVE = 1 << 0, /* Affect running domain state. (Since: v0.9.2) */
- VIR_DOMAIN_AFFECT_CONFIG = 1 << 1, /* Affect persistent domain state. (Since: v0.9.2) */
+ VIR_DOMAIN_AFFECT_CURRENT = 0, /* Affect current domain state. (Since: 0.9.2) */
+ VIR_DOMAIN_AFFECT_LIVE = 1 << 0, /* Affect running domain state. (Since: 0.9.2) */
+ VIR_DOMAIN_AFFECT_CONFIG = 1 << 1, /* Affect persistent domain state. (Since: 0.9.2) */
/* 1 << 2 is reserved for virTypedParameterFlags */
} virDomainModificationImpact;
@@ -333,7 +333,7 @@ typedef enum {
* a virDomainInfo is a structure filled by virDomainGetInfo() and extracting
* runtime information for a given active Domain
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef struct _virDomainInfo virDomainInfo;
@@ -350,7 +350,7 @@ struct _virDomainInfo {
*
* a virDomainInfoPtr is a pointer to a virDomainInfo structure.
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef virDomainInfo *virDomainInfoPtr;
@@ -360,16 +360,16 @@ typedef virDomainInfo *virDomainInfoPtr;
* Flags OR'ed together to provide specific behaviour when creating a
* Domain.
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef enum {
- VIR_DOMAIN_NONE = 0, /* Default behavior (Since: v0.0.1) */
- VIR_DOMAIN_START_PAUSED = 1 << 0, /* Launch guest in paused state (Since: v0.8.2) */
- VIR_DOMAIN_START_AUTODESTROY = 1 << 1, /* Automatically kill guest when virConnectPtr is closed (Since: v0.9.3) */
- VIR_DOMAIN_START_BYPASS_CACHE = 1 << 2, /* Avoid file system cache pollution (Since: v0.9.4) */
- VIR_DOMAIN_START_FORCE_BOOT = 1 << 3, /* Boot, discarding any managed save (Since: v0.9.5) */
- VIR_DOMAIN_START_VALIDATE = 1 << 4, /* Validate the XML document against schema (Since: v1.2.12) */
- VIR_DOMAIN_START_RESET_NVRAM = 1 << 5, /* Re-initialize NVRAM from template (Since: v8.1.0) */
+ VIR_DOMAIN_NONE = 0, /* Default behavior (Since: 0.0.1) */
+ VIR_DOMAIN_START_PAUSED = 1 << 0, /* Launch guest in paused state (Since: 0.8.2) */
+ VIR_DOMAIN_START_AUTODESTROY = 1 << 1, /* Automatically kill guest when virConnectPtr is closed (Since: 0.9.3) */
+ VIR_DOMAIN_START_BYPASS_CACHE = 1 << 2, /* Avoid file system cache pollution (Since: 0.9.4) */
+ VIR_DOMAIN_START_FORCE_BOOT = 1 << 3, /* Boot, discarding any managed save (Since: 0.9.5) */
+ VIR_DOMAIN_START_VALIDATE = 1 << 4, /* Validate the XML document against schema (Since: 1.2.12) */
+ VIR_DOMAIN_START_RESET_NVRAM = 1 << 5, /* Re-initialize NVRAM from template (Since: 8.1.0) */
} virDomainCreateFlags;
@@ -381,7 +381,7 @@ typedef enum {
* Macro represents proportional weight of the scheduler used on the
* host cpu, when using the posix scheduler, as a ullong.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_CPU_SHARES "cpu_shares"
@@ -391,7 +391,7 @@ typedef enum {
* Macro represents the enforcement period for a quota, in microseconds,
* for whole domain, when using the posix scheduler, as a ullong.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
# define VIR_DOMAIN_SCHEDULER_GLOBAL_PERIOD "global_period"
@@ -401,7 +401,7 @@ typedef enum {
* Macro represents the maximum bandwidth to be used within a period for
* whole domain, when using the posix scheduler, as an llong.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
# define VIR_DOMAIN_SCHEDULER_GLOBAL_QUOTA "global_quota"
@@ -411,7 +411,7 @@ typedef enum {
* Macro represents the enforcement period for a quota, in microseconds,
* for vcpus only, when using the posix scheduler, as a ullong.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_VCPU_PERIOD "vcpu_period"
@@ -421,7 +421,7 @@ typedef enum {
* Macro represents the maximum bandwidth to be used within a period for
* vcpus only, when using the posix scheduler, as an llong.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_VCPU_QUOTA "vcpu_quota"
@@ -432,7 +432,7 @@ typedef enum {
* when using the posix scheduler, for all emulator activity not tied to
* vcpus, as a ullong.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
# define VIR_DOMAIN_SCHEDULER_EMULATOR_PERIOD "emulator_period"
@@ -443,7 +443,7 @@ typedef enum {
* all emulator activity not tied to vcpus, when using the posix scheduler,
* as an llong.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
# define VIR_DOMAIN_SCHEDULER_EMULATOR_QUOTA "emulator_quota"
@@ -453,7 +453,7 @@ typedef enum {
* Macro represents the enforcement period for a quota, in microseconds,
* for IOThreads only, when using the posix scheduler, as a ullong.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
# define VIR_DOMAIN_SCHEDULER_IOTHREAD_PERIOD "iothread_period"
@@ -463,7 +463,7 @@ typedef enum {
* Macro represents the maximum bandwidth to be used within a period for
* IOThreads only, when using the posix scheduler, as an llong.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
# define VIR_DOMAIN_SCHEDULER_IOTHREAD_QUOTA "iothread_quota"
@@ -473,7 +473,7 @@ typedef enum {
* Macro represents the relative weight, when using the credit
* scheduler, as a uint.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_WEIGHT "weight"
@@ -483,7 +483,7 @@ typedef enum {
* Macro represents the maximum scheduler cap, when using the credit
* scheduler, as a uint.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_CAP "cap"
@@ -493,7 +493,7 @@ typedef enum {
* Macro represents the scheduler reservation value, when using the
* allocation scheduler, as an llong.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_RESERVATION "reservation"
@@ -503,7 +503,7 @@ typedef enum {
* Macro represents the scheduler limit value, when using the
* allocation scheduler, as an llong.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_LIMIT "limit"
@@ -513,7 +513,7 @@ typedef enum {
* Macro represents the scheduler shares value, when using the
* allocation scheduler, as an int.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# define VIR_DOMAIN_SCHEDULER_SHARES "shares"
@@ -549,7 +549,7 @@ int virDomainSetSchedulerParametersFlags (virDomainPtr domain,
*
* NB. Here 'long long' means 64 bit integer.
*
- * Since: v0.3.3
+ * Since: 0.3.3
*/
typedef struct _virDomainBlockStats virDomainBlockStatsStruct;
@@ -566,7 +566,7 @@ struct _virDomainBlockStats {
*
* A pointer to a virDomainBlockStats structure
*
- * Since: v0.3.2
+ * Since: 0.3.2
*/
typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
@@ -577,7 +577,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro providing the field length of parameter names when using
* virDomainBlockStatsFlags().
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
@@ -587,7 +587,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total number of read bytes of the
* block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_READ_BYTES "rd_bytes"
@@ -597,7 +597,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total read requests of the
* block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_READ_REQ "rd_operations"
@@ -607,7 +607,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total time spend on cache reads in
* nano-seconds of the block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_READ_TOTAL_TIMES "rd_total_times"
@@ -617,7 +617,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total number of write bytes of the
* block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_WRITE_BYTES "wr_bytes"
@@ -627,7 +627,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total write requests of the
* block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_WRITE_REQ "wr_operations"
@@ -637,7 +637,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total time spend on cache writes in
* nano-seconds of the block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_WRITE_TOTAL_TIMES "wr_total_times"
@@ -647,7 +647,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total flush requests of the
* block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_FLUSH_REQ "flush_operations"
@@ -657,7 +657,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
* Macro represents the total time spend on cache flushing in
* nano-seconds of the block device, as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_FLUSH_TOTAL_TIMES "flush_total_times"
@@ -666,7 +666,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
*
* In Xen this returns the mysterious 'oo_req', as an llong.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_DOMAIN_BLOCK_STATS_ERRS "errs"
@@ -680,7 +680,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr;
*
* NB. Here 'long long' means 64 bit integer.
*
- * Since: v0.3.3
+ * Since: 0.3.3
*/
typedef struct _virDomainInterfaceStats virDomainInterfaceStatsStruct;
@@ -700,7 +700,7 @@ struct _virDomainInterfaceStats {
*
* A pointer to a virDomainInterfaceStats structure
*
- * Since: v0.3.2
+ * Since: 0.3.2
*/
typedef virDomainInterfaceStatsStruct *virDomainInterfaceStatsPtr;
@@ -709,12 +709,12 @@ typedef virDomainInterfaceStatsStruct *virDomainInterfaceStatsPtr;
*
* Memory Statistics Tags:
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
typedef enum {
- /* The total amount of data read from swap space (in kB). (Since: v0.7.5) */
+ /* The total amount of data read from swap space (in kB). (Since: 0.7.5) */
VIR_DOMAIN_MEMORY_STAT_SWAP_IN = 0,
- /* The total amount of memory written out to swap space (in kB). (Since: v0.7.5) */
+ /* The total amount of memory written out to swap space (in kB). (Since: 0.7.5) */
VIR_DOMAIN_MEMORY_STAT_SWAP_OUT = 1,
/*
@@ -723,12 +723,12 @@ typedef enum {
* required, it is considered a major fault. If not, it is a minor fault.
* These are expressed as the number of faults that have occurred.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
VIR_DOMAIN_MEMORY_STAT_MAJOR_FAULT = 2,
/*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
VIR_DOMAIN_MEMORY_STAT_MINOR_FAULT = 3,
@@ -737,7 +737,7 @@ typedef enum {
* is available but used for reclaimable caches should NOT be reported as
* free. This value is expressed in kB.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
VIR_DOMAIN_MEMORY_STAT_UNUSED = 4,
@@ -747,21 +747,21 @@ typedef enum {
* balloon driver is in use or if the guest OS does not initialize all
* assigned pages. This value is expressed in kB.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
VIR_DOMAIN_MEMORY_STAT_AVAILABLE = 5,
/*
* Current balloon value (in KB).
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
VIR_DOMAIN_MEMORY_STAT_ACTUAL_BALLOON = 6,
/* Resident Set Size of the process running the domain. This value
* is in kB
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
VIR_DOMAIN_MEMORY_STAT_RSS = 7,
@@ -769,14 +769,14 @@ typedef enum {
* How much the balloon can be inflated without pushing the guest system
* to swap, corresponds to 'Available' in /proc/meminfo
*
- * Since: v2.1.0
+ * Since: 2.1.0
*/
VIR_DOMAIN_MEMORY_STAT_USABLE = 8,
/*
* Timestamp of the last update of statistics, in seconds.
*
- * Since: v2.1.0
+ * Since: 2.1.0
*/
VIR_DOMAIN_MEMORY_STAT_LAST_UPDATE = 9,
@@ -785,7 +785,7 @@ typedef enum {
* additional I/O (in kB). Typically these pages are used for caching files
* from disk.
*
- * Since: v4.6.0
+ * Since: 4.6.0
*/
VIR_DOMAIN_MEMORY_STAT_DISK_CACHES = 10,
@@ -793,7 +793,7 @@ typedef enum {
* The number of successful huge page allocations from inside the domain via
* virtio balloon.
*
- * Since: v5.4.0
+ * Since: 5.4.0
*/
VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGALLOC = 11,
@@ -801,7 +801,7 @@ typedef enum {
* The number of failed huge page allocations from inside the domain via
* virtio balloon.
*
- * Since: v5.4.0
+ * Since: 5.4.0
*/
VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGFAIL = 12,
@@ -809,19 +809,19 @@ typedef enum {
* The number of statistics supported by this version of the interface.
* To add new statistics, add them to the enum and increase this value.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
VIR_DOMAIN_MEMORY_STAT_NR = 13,
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_MEMORY_STAT_LAST = VIR_DOMAIN_MEMORY_STAT_NR /* (Since: v0.9.10) */
+ VIR_DOMAIN_MEMORY_STAT_LAST = VIR_DOMAIN_MEMORY_STAT_NR /* (Since: 0.9.10) */
# endif
} virDomainMemoryStatTags;
/**
* virDomainMemoryStatStruct:
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
typedef struct _virDomainMemoryStat virDomainMemoryStatStruct;
@@ -833,7 +833,7 @@ struct _virDomainMemoryStat {
/**
* virDomainMemoryStatPtr:
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
typedef virDomainMemoryStatStruct *virDomainMemoryStatPtr;
@@ -843,14 +843,14 @@ typedef virDomainMemoryStatStruct *virDomainMemoryStatPtr;
*
* Domain core dump flags.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
typedef enum {
- VIR_DUMP_CRASH = (1 << 0), /* crash after dump (Since: v0.7.5) */
- VIR_DUMP_LIVE = (1 << 1), /* live dump (Since: v0.7.5) */
- VIR_DUMP_BYPASS_CACHE = (1 << 2), /* avoid file system cache pollution (Since: v0.9.4) */
- VIR_DUMP_RESET = (1 << 3), /* reset domain after dump finishes (Since: v0.9.7) */
- VIR_DUMP_MEMORY_ONLY = (1 << 4), /* use dump-guest-memory (Since: v0.9.13) */
+ VIR_DUMP_CRASH = (1 << 0), /* crash after dump (Since: 0.7.5) */
+ VIR_DUMP_LIVE = (1 << 1), /* live dump (Since: 0.7.5) */
+ VIR_DUMP_BYPASS_CACHE = (1 << 2), /* avoid file system cache pollution (Since: 0.9.4) */
+ VIR_DUMP_RESET = (1 << 3), /* reset domain after dump finishes (Since: 0.9.7) */
+ VIR_DUMP_MEMORY_ONLY = (1 << 4), /* use dump-guest-memory (Since: 0.9.13) */
} virDomainCoreDumpFlags;
/**
@@ -858,17 +858,17 @@ typedef enum {
*
* Values for specifying different formats of domain core dumps.
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
typedef enum {
- VIR_DOMAIN_CORE_DUMP_FORMAT_RAW, /* dump guest memory in raw format (Since: v1.2.3) */
+ VIR_DOMAIN_CORE_DUMP_FORMAT_RAW, /* dump guest memory in raw format (Since: 1.2.3) */
VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_ZLIB, /* kdump-compressed format, with
- * zlib compression (Since: v1.2.3) */
+ * zlib compression (Since: 1.2.3) */
VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_LZO, /* kdump-compressed format, with
- * lzo compression (Since: v1.2.3) */
+ * lzo compression (Since: 1.2.3) */
VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_SNAPPY, /* kdump-compressed format, with
- * snappy compression (Since: v1.2.3) */
- VIR_DOMAIN_CORE_DUMP_FORMAT_WIN_DMP, /* Windows full crashdump format (Since: v7.4.0) */
+ * snappy compression (Since: 1.2.3) */
+ VIR_DOMAIN_CORE_DUMP_FORMAT_WIN_DMP, /* Windows full crashdump format (Since: 7.4.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_DOMAIN_CORE_DUMP_FORMAT_LAST
/*
@@ -876,7 +876,7 @@ typedef enum {
* added to the libvirt API. It reflects the last format supported
* by this version of the libvirt API.
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
# endif
} virDomainCoreDumpFormat;
@@ -886,7 +886,7 @@ typedef enum {
*
* Domain migration flags.
*
- * Since: v0.3.2
+ * Since: 0.3.2
*/
typedef enum {
/* Do not pause the domain during migration. The domain's memory will
@@ -895,7 +895,7 @@ typedef enum {
* faster then it can be transferred. The domain can be manually paused
* anytime during migration using virDomainSuspend.
*
- * Since: v0.3.2
+ * Since: 0.3.2
*/
VIR_MIGRATE_LIVE = (1 << 0),
@@ -905,7 +905,7 @@ typedef enum {
* libvirtd controls the migration by calling the destination daemon
* directly.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
VIR_MIGRATE_PEER2PEER = (1 << 1),
@@ -917,7 +917,7 @@ typedef enum {
* Note the less-common spelling that we're stuck with:
* VIR_MIGRATE_TUNNELLED should be VIR_MIGRATE_TUNNELED.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
VIR_MIGRATE_TUNNELLED = (1 << 2),
@@ -926,14 +926,14 @@ typedef enum {
* VIR_MIGRATE_UNDEFINE_SOURCE is not used, it will end up persistent on
* both hosts.
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
VIR_MIGRATE_PERSIST_DEST = (1 << 3),
/* Undefine the domain on the source host once migration successfully
* finishes.
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
VIR_MIGRATE_UNDEFINE_SOURCE = (1 << 4),
@@ -941,7 +941,7 @@ typedef enum {
* the virDomainPtr returned by the migration API) has to be called
* explicitly to resume domain's virtual CPUs.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
VIR_MIGRATE_PAUSED = (1 << 5),
@@ -952,7 +952,7 @@ typedef enum {
*
* This flag and VIR_MIGRATE_NON_SHARED_INC are mutually exclusive.
*
- * Since: v0.8.2
+ * Since: 0.8.2
*/
VIR_MIGRATE_NON_SHARED_DISK = (1 << 6),
@@ -964,7 +964,7 @@ typedef enum {
*
* This flag and VIR_MIGRATE_NON_SHARED_DISK are mutually exclusive.
*
- * Since: v0.8.2
+ * Since: 0.8.2
*/
VIR_MIGRATE_NON_SHARED_INC = (1 << 7),
@@ -973,7 +973,7 @@ typedef enum {
* Explicitly setting this flag will cause migration to fail if either the
* source or the destination does not support it.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
VIR_MIGRATE_CHANGE_PROTECTION = (1 << 8),
@@ -985,7 +985,7 @@ typedef enum {
* is unsafe unless the disk images are stored on coherent clustered
* filesystem, such as GFS2 or GPFS.
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
VIR_MIGRATE_UNSAFE = (1 << 9),
@@ -996,7 +996,7 @@ typedef enum {
* Offline migration may not copy disk storage or any other file based
* storage (such as UEFI variables).
*
- * Since: v1.0.1
+ * Since: 1.0.1
*/
VIR_MIGRATE_OFFLINE = (1 << 10),
@@ -1005,14 +1005,14 @@ typedef enum {
* if this parameter is omitted. Individual compression methods can be
* tuned via their specific VIR_MIGRATE_PARAM_COMPRESSION_* parameters.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
VIR_MIGRATE_COMPRESSED = (1 << 11),
/* Cancel migration if a soft error (such as I/O error) happens during
* migration.
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
VIR_MIGRATE_ABORT_ON_ERROR = (1 << 12),
@@ -1022,7 +1022,7 @@ typedef enum {
* memory to the destination host. VIR_MIGRATE_PARAM_AUTO_CONVERGE_*
* parameters can be used to tune the algorithm.
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
VIR_MIGRATE_AUTO_CONVERGE = (1 << 13),
@@ -1041,7 +1041,7 @@ typedef enum {
* domain and the host itself since the host's kernel may run out of
* memory.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
VIR_MIGRATE_RDMA_PIN_ALL = (1 << 14),
@@ -1050,7 +1050,7 @@ typedef enum {
* virDomainMigrateStartPostCopy needs to be called to switch it into the
* post-copy mode. See virDomainMigrateStartPostCopy for more details.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
VIR_MIGRATE_POSTCOPY = (1 << 15),
@@ -1059,7 +1059,7 @@ typedef enum {
* perform the migration. If incorrectly configured on either source or
* destination, the migration will fail.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
VIR_MIGRATE_TLS = (1 << 16),
@@ -1067,7 +1067,7 @@ typedef enum {
* connections. See VIR_MIGRATE_PARAM_PARALLEL_* parameters for
* configuring the parallel migration.
*
- * Since: v5.2.0
+ * Since: 5.2.0
*/
VIR_MIGRATE_PARALLEL = (1 << 17),
@@ -1079,7 +1079,7 @@ typedef enum {
* Requires one of VIR_MIGRATE_NON_SHARED_DISK, VIR_MIGRATE_NON_SHARED_INC
* to be present as well.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
VIR_MIGRATE_NON_SHARED_SYNCHRONOUS_WRITES = (1 << 18),
@@ -1099,7 +1099,7 @@ typedef enum {
*
* This field may not be used when VIR_MIGRATE_TUNNELLED flag is set.
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
# define VIR_MIGRATE_PARAM_URI "migrate_uri"
@@ -1111,7 +1111,7 @@ typedef enum {
* the domain name the same. This field is only allowed to be used with
* hypervisors that support domain renaming during migration.
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
# define VIR_MIGRATE_PARAM_DEST_NAME "destination_name"
@@ -1132,7 +1132,7 @@ typedef enum {
* field with hypervisors that do not support changing domain configuration
* during migration will result in a failure.
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
# define VIR_MIGRATE_PARAM_DEST_XML "destination_xml"
@@ -1149,7 +1149,7 @@ typedef enum {
* Using this field with hypervisors that do not support changing domain
* configuration during migration will result in a failure.
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
# define VIR_MIGRATE_PARAM_PERSIST_XML "persistent_xml"
@@ -1161,7 +1161,7 @@ typedef enum {
* libvirt will choose a suitable default. Some hypervisors do not support this
* feature and will return an error if this field is used and is not 0.
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
# define VIR_MIGRATE_PARAM_BANDWIDTH "bandwidth"
@@ -1172,7 +1172,7 @@ typedef enum {
* be used for post-copy phase of a migration as VIR_TYPED_PARAM_ULLONG. If set
* to 0 or omitted, post-copy migration speed will not be limited.
*
- * Since: v5.1.0
+ * Since: 5.1.0
*/
# define VIR_MIGRATE_PARAM_BANDWIDTH_POSTCOPY "bandwidth.postcopy"
@@ -1195,7 +1195,7 @@ typedef enum {
*
* spice://target.host.com:1234/?tlsPort=4567
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
# define VIR_MIGRATE_PARAM_GRAPHICS_URI "graphics_uri"
@@ -1208,7 +1208,7 @@ typedef enum {
* destination). Some hypervisors do not support this feature and will return
* an error if this field is used.
*
- * Since: v1.1.4
+ * Since: 1.1.4
*/
# define VIR_MIGRATE_PARAM_LISTEN_ADDRESS "listen_address"
@@ -1219,7 +1219,7 @@ typedef enum {
* the block devices to be migrated. At the moment this is only supported
* by the QEMU driver but not for the tunnelled migration.
*
- * Since: v1.2.17
+ * Since: 1.2.17
*/
# define VIR_MIGRATE_PARAM_MIGRATE_DISKS "migrate_disks"
@@ -1231,7 +1231,7 @@ typedef enum {
* omitted, libvirt will choose a suitable default. At the moment this is only
* supported by the QEMU driver.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
# define VIR_MIGRATE_PARAM_DISKS_PORT "disks_port"
@@ -1246,7 +1246,7 @@ typedef enum {
* management application makes sure that socket created with this name on the
* destination will be reachable from the source under the same exact path.
*
- * Since: v6.8.0
+ * Since: 6.8.0
*/
# define VIR_MIGRATE_PARAM_DISKS_URI "disks_uri"
@@ -1258,7 +1258,7 @@ typedef enum {
* The parameter may be specified multiple times if more than one method
* should be used.
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
# define VIR_MIGRATE_PARAM_COMPRESSION "compression"
@@ -1269,7 +1269,7 @@ typedef enum {
* compression as VIR_TYPED_PARAM_INT. Accepted values are in range 0-9.
* 0 is no compression, 1 is maximum speed and 9 is maximum compression.
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
# define VIR_MIGRATE_PARAM_COMPRESSION_MT_LEVEL "compression.mt.level"
@@ -1279,7 +1279,7 @@ typedef enum {
* virDomainMigrate* params field: the number of compression threads for
* multithread compression as VIR_TYPED_PARAM_INT.
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
# define VIR_MIGRATE_PARAM_COMPRESSION_MT_THREADS "compression.mt.threads"
@@ -1289,7 +1289,7 @@ typedef enum {
* virDomainMigrate* params field: the number of decompression threads for
* multithread compression as VIR_TYPED_PARAM_INT.
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
# define VIR_MIGRATE_PARAM_COMPRESSION_MT_DTHREADS "compression.mt.dthreads"
@@ -1299,7 +1299,7 @@ typedef enum {
* virDomainMigrate* params field: the size of page cache for xbzrle
* compression as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
# define VIR_MIGRATE_PARAM_COMPRESSION_XBZRLE_CACHE "compression.xbzrle.cache"
@@ -1310,7 +1310,7 @@ typedef enum {
* throttled to when auto-convergence decides migration is not converging.
* As VIR_TYPED_PARAM_INT.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIAL "auto_converge.initial"
@@ -1322,7 +1322,7 @@ typedef enum {
* the current rate is not enough to ensure convergence of the migration.
* As VIR_TYPED_PARAM_INT.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_MIGRATE_PARAM_AUTO_CONVERGE_INCREMENT "auto_converge.increment"
@@ -1332,7 +1332,7 @@ typedef enum {
* virDomainMigrate* params field: number of connections used during parallel
* migration. As VIR_TYPED_PARAM_INT.
*
- * Since: v5.2.0
+ * Since: 5.2.0
*/
# define VIR_MIGRATE_PARAM_PARALLEL_CONNECTIONS "parallel.connections"
@@ -1348,7 +1348,7 @@ typedef enum {
* this parameter can be used to pass this expected hostname when starting
* the migration.
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
# define VIR_MIGRATE_PARAM_TLS_DESTINATION "tls.destination"
@@ -1403,10 +1403,10 @@ int virDomainMigrateSetCompressionCache(virDomainPtr domain,
*
* Domain migration speed flags.
*
- * Since: v5.1.0
+ * Since: 5.1.0
*/
typedef enum {
- /* Set or get maximum speed of post-copy migration. (Since: v5.1.0) */
+ /* Set or get maximum speed of post-copy migration. (Since: 5.1.0) */
VIR_DOMAIN_MIGRATE_MAX_SPEED_POSTCOPY = (1 << 0),
} virDomainMigrateMaxSpeedFlags;
@@ -1470,15 +1470,15 @@ virDomainPtr virDomainLookupByUUIDString (virConnectPtr conn,
/**
* virDomainShutdownFlagValues:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_DOMAIN_SHUTDOWN_DEFAULT = 0, /* hypervisor choice (Since: v0.9.10) */
- VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: v0.9.10) */
- VIR_DOMAIN_SHUTDOWN_GUEST_AGENT = (1 << 1), /* Use guest agent (Since: v0.9.10) */
- VIR_DOMAIN_SHUTDOWN_INITCTL = (1 << 2), /* Use initctl (Since: v1.0.1) */
- VIR_DOMAIN_SHUTDOWN_SIGNAL = (1 << 3), /* Send a signal (Since: v1.0.1) */
- VIR_DOMAIN_SHUTDOWN_PARAVIRT = (1 << 4), /* Use paravirt guest control (Since: v1.2.5) */
+ VIR_DOMAIN_SHUTDOWN_DEFAULT = 0, /* hypervisor choice (Since: 0.9.10) */
+ VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: 0.9.10) */
+ VIR_DOMAIN_SHUTDOWN_GUEST_AGENT = (1 << 1), /* Use guest agent (Since: 0.9.10) */
+ VIR_DOMAIN_SHUTDOWN_INITCTL = (1 << 2), /* Use initctl (Since: 1.0.1) */
+ VIR_DOMAIN_SHUTDOWN_SIGNAL = (1 << 3), /* Send a signal (Since: 1.0.1) */
+ VIR_DOMAIN_SHUTDOWN_PARAVIRT = (1 << 4), /* Use paravirt guest control (Since: 1.2.5) */
} virDomainShutdownFlagValues;
int virDomainShutdown (virDomainPtr domain);
@@ -1488,15 +1488,15 @@ int virDomainShutdownFlags (virDomainPtr domain,
/**
* virDomainRebootFlagValues:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_DOMAIN_REBOOT_DEFAULT = 0, /* hypervisor choice (Since: v0.9.10) */
- VIR_DOMAIN_REBOOT_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: v0.9.10) */
- VIR_DOMAIN_REBOOT_GUEST_AGENT = (1 << 1), /* Use guest agent (Since: v0.9.10) */
- VIR_DOMAIN_REBOOT_INITCTL = (1 << 2), /* Use initctl (Since: v1.0.1) */
- VIR_DOMAIN_REBOOT_SIGNAL = (1 << 3), /* Send a signal (Since: v1.0.1) */
- VIR_DOMAIN_REBOOT_PARAVIRT = (1 << 4), /* Use paravirt guest control (Since: v1.2.5) */
+ VIR_DOMAIN_REBOOT_DEFAULT = 0, /* hypervisor choice (Since: 0.9.10) */
+ VIR_DOMAIN_REBOOT_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: 0.9.10) */
+ VIR_DOMAIN_REBOOT_GUEST_AGENT = (1 << 1), /* Use guest agent (Since: 0.9.10) */
+ VIR_DOMAIN_REBOOT_INITCTL = (1 << 2), /* Use initctl (Since: 1.0.1) */
+ VIR_DOMAIN_REBOOT_SIGNAL = (1 << 3), /* Send a signal (Since: 1.0.1) */
+ VIR_DOMAIN_REBOOT_PARAVIRT = (1 << 4), /* Use paravirt guest control (Since: 1.2.5) */
} virDomainRebootFlagValues;
int virDomainReboot (virDomainPtr domain,
@@ -1512,12 +1512,12 @@ int virDomainDestroy (virDomainPtr domain);
* Flags used to provide specific behaviour to the
* virDomainDestroyFlags() function
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef enum {
- VIR_DOMAIN_DESTROY_DEFAULT = 0, /* Default behavior - could lead to data loss!! (Since: v0.9.10) */
- VIR_DOMAIN_DESTROY_GRACEFUL = 1 << 0, /* only SIGTERM, no SIGKILL (Since: v0.9.10) */
- VIR_DOMAIN_DESTROY_REMOVE_LOGS = 1 << 1, /* remove VM logs on destroy (Since: v8.3.0) */
+ VIR_DOMAIN_DESTROY_DEFAULT = 0, /* Default behavior - could lead to data loss!! (Since: 0.9.10) */
+ VIR_DOMAIN_DESTROY_GRACEFUL = 1 << 0, /* only SIGTERM, no SIGKILL (Since: 0.9.10) */
+ VIR_DOMAIN_DESTROY_REMOVE_LOGS = 1 << 1, /* remove VM logs on destroy (Since: 8.3.0) */
} virDomainDestroyFlagsValues;
int virDomainDestroyFlags (virDomainPtr domain,
@@ -1547,13 +1547,13 @@ int virDomainPMWakeup (virDomainPtr domain,
* virDomainRestoreFlags(), and virDomainSaveImageDefineXML(). Not all
* flags apply to all these functions.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef enum {
- VIR_DOMAIN_SAVE_BYPASS_CACHE = 1 << 0, /* Avoid file system cache pollution (Since: v0.9.4) */
- VIR_DOMAIN_SAVE_RUNNING = 1 << 1, /* Favor running over paused (Since: v0.9.5) */
- VIR_DOMAIN_SAVE_PAUSED = 1 << 2, /* Favor paused over running (Since: v0.9.5) */
- VIR_DOMAIN_SAVE_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template (Since: v8.1.0) */
+ VIR_DOMAIN_SAVE_BYPASS_CACHE = 1 << 0, /* Avoid file system cache pollution (Since: 0.9.4) */
+ VIR_DOMAIN_SAVE_RUNNING = 1 << 1, /* Favor running over paused (Since: 0.9.5) */
+ VIR_DOMAIN_SAVE_PAUSED = 1 << 2, /* Favor paused over running (Since: 0.9.5) */
+ VIR_DOMAIN_SAVE_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template (Since: 8.1.0) */
} virDomainSaveRestoreFlags;
int virDomainSave (virDomainPtr domain,
@@ -1633,7 +1633,7 @@ int virDomainGetState (virDomainPtr domain,
* cpu usage (sum of both vcpu and hypervisor usage) in nanoseconds,
* as a ullong
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
# define VIR_DOMAIN_CPU_STATS_CPUTIME "cpu_time"
@@ -1641,7 +1641,7 @@ int virDomainGetState (virDomainPtr domain,
* VIR_DOMAIN_CPU_STATS_USERTIME:
* cpu time charged to user instructions in nanoseconds, as a ullong
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
# define VIR_DOMAIN_CPU_STATS_USERTIME "user_time"
@@ -1649,7 +1649,7 @@ int virDomainGetState (virDomainPtr domain,
* VIR_DOMAIN_CPU_STATS_SYSTEMTIME:
* cpu time charged to system instructions in nanoseconds, as a ullong
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
# define VIR_DOMAIN_CPU_STATS_SYSTEMTIME "system_time"
@@ -1658,7 +1658,7 @@ int virDomainGetState (virDomainPtr domain,
* vcpu usage in nanoseconds (cpu_time excluding hypervisor time),
* as a ullong
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
# define VIR_DOMAIN_CPU_STATS_VCPUTIME "vcpu_time"
@@ -1688,7 +1688,7 @@ char * virDomainGetSchedulerType(virDomainPtr domain,
* Macro for the Blkio tunable weight: it represents the io weight
* the guest can use, as a uint.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
# define VIR_DOMAIN_BLKIO_WEIGHT "weight"
@@ -1699,7 +1699,7 @@ char * virDomainGetSchedulerType(virDomainPtr domain,
* per-device weight, as a string. The string is parsed as a
* series of /path/to/device,weight elements, separated by ','.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLKIO_DEVICE_WEIGHT "device_weight"
@@ -1711,7 +1711,7 @@ char * virDomainGetSchedulerType(virDomainPtr domain,
* string is parsed as a series of /path/to/device, read_iops elements,
* separated by ','.
*
- * Since: v1.2.2
+ * Since: 1.2.2
*/
# define VIR_DOMAIN_BLKIO_DEVICE_READ_IOPS "device_read_iops_sec"
@@ -1724,7 +1724,7 @@ char * virDomainGetSchedulerType(virDomainPtr domain,
* string is parsed as a series of /path/to/device, write_iops elements,
* separated by ','.
*
- * Since: v1.2.2
+ * Since: 1.2.2
*/
# define VIR_DOMAIN_BLKIO_DEVICE_WRITE_IOPS "device_write_iops_sec"
@@ -1737,7 +1737,7 @@ char * virDomainGetSchedulerType(virDomainPtr domain,
* string is parsed as a series of /path/to/device, read_bps elements,
* separated by ','.
*
- * Since: v1.2.2
+ * Since: 1.2.2
*/
# define VIR_DOMAIN_BLKIO_DEVICE_READ_BPS "device_read_bytes_sec"
@@ -1750,7 +1750,7 @@ char * virDomainGetSchedulerType(virDomainPtr domain,
* string is parsed as a series of /path/to/device, write_bps elements,
* separated by ','.
*
- * Since: v1.2.2
+ * Since: 1.2.2
*/
# define VIR_DOMAIN_BLKIO_DEVICE_WRITE_BPS "device_write_bytes_sec"
@@ -1770,7 +1770,7 @@ int virDomainGetBlkioParameters(virDomainPtr domain,
*
* Macro providing the virMemoryParameter value that indicates "unlimited"
*
- * Since: v0.8.8
+ * Since: 0.8.8
*/
# define VIR_DOMAIN_MEMORY_PARAM_UNLIMITED 9007199254740991LL /* = INT64_MAX >> 10 */
@@ -1780,7 +1780,7 @@ int virDomainGetBlkioParameters(virDomainPtr domain,
* Macro for the memory tunable hard_limit: it represents the maximum memory
* the guest can use, as a ullong.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
# define VIR_DOMAIN_MEMORY_HARD_LIMIT "hard_limit"
@@ -1790,7 +1790,7 @@ int virDomainGetBlkioParameters(virDomainPtr domain,
* Macro for the memory tunable soft_limit: it represents the memory upper
* limit enforced during memory contention, as a ullong.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
# define VIR_DOMAIN_MEMORY_SOFT_LIMIT "soft_limit"
@@ -1800,7 +1800,7 @@ int virDomainGetBlkioParameters(virDomainPtr domain,
* Macro for the memory tunable min_guarantee: it represents the minimum
* memory guaranteed to be reserved for the guest, as a ullong.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
# define VIR_DOMAIN_MEMORY_MIN_GUARANTEE "min_guarantee"
@@ -1811,7 +1811,7 @@ int virDomainGetBlkioParameters(virDomainPtr domain,
* plus memory the guest can use, as a ullong. This limit has to be more than
* VIR_DOMAIN_MEMORY_HARD_LIMIT.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
# define VIR_DOMAIN_MEMORY_SWAP_HARD_LIMIT "swap_hard_limit"
@@ -1828,14 +1828,14 @@ int virDomainGetMemoryParameters(virDomainPtr domain,
*
* Memory size modification flags.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
typedef enum {
- VIR_DOMAIN_MEM_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: v0.9.1) */
- VIR_DOMAIN_MEM_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: v0.9.0) */
- VIR_DOMAIN_MEM_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: v0.9.0) */
+ VIR_DOMAIN_MEM_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: 0.9.1) */
+ VIR_DOMAIN_MEM_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: 0.9.0) */
+ VIR_DOMAIN_MEM_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: 0.9.0) */
- VIR_DOMAIN_MEM_MAXIMUM = (1 << 2), /* affect Max rather than current (Since: v0.9.1) */
+ VIR_DOMAIN_MEM_MAXIMUM = (1 << 2), /* affect Max rather than current (Since: 0.9.1) */
} virDomainMemoryModFlags;
@@ -1846,16 +1846,16 @@ typedef enum {
* Representation of the various modes in the <numatune> element of
* a domain.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
typedef enum {
- VIR_DOMAIN_NUMATUNE_MEM_STRICT = 0, /* (Since: v0.9.9) */
- VIR_DOMAIN_NUMATUNE_MEM_PREFERRED = 1, /* (Since: v0.9.9) */
- VIR_DOMAIN_NUMATUNE_MEM_INTERLEAVE = 2, /* (Since: v0.9.9) */
- VIR_DOMAIN_NUMATUNE_MEM_RESTRICTIVE = 3, /* (Since: v7.3.0) */
+ VIR_DOMAIN_NUMATUNE_MEM_STRICT = 0, /* (Since: 0.9.9) */
+ VIR_DOMAIN_NUMATUNE_MEM_PREFERRED = 1, /* (Since: 0.9.9) */
+ VIR_DOMAIN_NUMATUNE_MEM_INTERLEAVE = 2, /* (Since: 0.9.9) */
+ VIR_DOMAIN_NUMATUNE_MEM_RESTRICTIVE = 3, /* (Since: 7.3.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_NUMATUNE_MEM_LAST /* This constant is subject to change (Since: v0.9.9) */
+ VIR_DOMAIN_NUMATUNE_MEM_LAST /* This constant is subject to change (Since: 0.9.9) */
# endif
} virDomainNumatuneMemMode;
@@ -1865,7 +1865,7 @@ typedef enum {
* Macro for typed parameter name that lists the numa nodeset of a
* domain, as a string.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_NUMA_NODESET "numa_nodeset"
@@ -1875,7 +1875,7 @@ typedef enum {
* Macro for typed parameter name that lists the numa mode of a domain,
* as an int containing a virDomainNumatuneMemMode value.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_NUMA_MODE "numa_mode"
@@ -1913,11 +1913,11 @@ int virDomainGetSecurityLabel (virDomainPtr domain,
/**
* virDomainGetHostnameFlags:
*
- * Since: v6.1.0
+ * Since: 6.1.0
*/
typedef enum {
- VIR_DOMAIN_GET_HOSTNAME_LEASE = (1 << 0), /* Parse DHCP lease file (Since: v6.1.0) */
- VIR_DOMAIN_GET_HOSTNAME_AGENT = (1 << 1), /* Query qemu guest agent (Since: v6.1.0) */
+ VIR_DOMAIN_GET_HOSTNAME_LEASE = (1 << 0), /* Parse DHCP lease file (Since: 6.1.0) */
+ VIR_DOMAIN_GET_HOSTNAME_AGENT = (1 << 1), /* Query qemu guest agent (Since: 6.1.0) */
} virDomainGetHostnameFlags;
char * virDomainGetHostname (virDomainPtr domain,
@@ -1928,15 +1928,15 @@ int virDomainGetSecurityLabelList (virDomainPtr domain,
/**
* virDomainMetadataType:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_DOMAIN_METADATA_DESCRIPTION = 0, /* Operate on <description> (Since: v0.9.10) */
- VIR_DOMAIN_METADATA_TITLE = 1, /* Operate on <title> (Since: v0.9.10) */
- VIR_DOMAIN_METADATA_ELEMENT = 2, /* Operate on <metadata> (Since: v0.9.10) */
+ VIR_DOMAIN_METADATA_DESCRIPTION = 0, /* Operate on <description> (Since: 0.9.10) */
+ VIR_DOMAIN_METADATA_TITLE = 1, /* Operate on <title> (Since: 0.9.10) */
+ VIR_DOMAIN_METADATA_ELEMENT = 2, /* Operate on <metadata> (Since: 0.9.10) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_METADATA_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_METADATA_LAST /* (Since: 0.9.10) */
# endif
} virDomainMetadataType;
@@ -1963,22 +1963,22 @@ virDomainGetMetadata(virDomainPtr domain,
*
* Flags available for virDomainGetXMLDesc
*
- * Since: v0.3.3
+ * Since: 0.3.3
*/
typedef enum {
- VIR_DOMAIN_XML_SECURE = (1 << 0), /* dump security sensitive information too (Since: v0.3.3) */
- VIR_DOMAIN_XML_INACTIVE = (1 << 1), /* dump inactive domain information (Since: v0.3.3) */
- VIR_DOMAIN_XML_UPDATE_CPU = (1 << 2), /* update guest CPU requirements according to host CPU (Since: v0.8.0) */
- VIR_DOMAIN_XML_MIGRATABLE = (1 << 3), /* dump XML suitable for migration (Since: v1.0.0) */
+ VIR_DOMAIN_XML_SECURE = (1 << 0), /* dump security sensitive information too (Since: 0.3.3) */
+ VIR_DOMAIN_XML_INACTIVE = (1 << 1), /* dump inactive domain information (Since: 0.3.3) */
+ VIR_DOMAIN_XML_UPDATE_CPU = (1 << 2), /* update guest CPU requirements according to host CPU (Since: 0.8.0) */
+ VIR_DOMAIN_XML_MIGRATABLE = (1 << 3), /* dump XML suitable for migration (Since: 1.0.0) */
} virDomainXMLFlags;
/**
* virDomainSaveImageXMLFlags:
*
- * Since: v5.1.0
+ * Since: 5.1.0
*/
typedef enum {
- VIR_DOMAIN_SAVE_IMAGE_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: v5.1.0) */
+ VIR_DOMAIN_SAVE_IMAGE_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: 5.1.0) */
} virDomainSaveImageXMLFlags;
char * virDomainGetXMLDesc (virDomainPtr domain,
@@ -2015,7 +2015,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the inbound average of NIC bandwidth, as a uint.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_BANDWIDTH_IN_AVERAGE "inbound.average"
@@ -2024,7 +2024,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the inbound peak of NIC bandwidth, as a uint.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_BANDWIDTH_IN_PEAK "inbound.peak"
@@ -2033,7 +2033,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the inbound burst of NIC bandwidth, as a uint.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_BANDWIDTH_IN_BURST "inbound.burst"
@@ -2042,7 +2042,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the inbound floor of NIC bandwidth, as a uint.
*
- * Since: v1.2.19
+ * Since: 1.2.19
*/
# define VIR_DOMAIN_BANDWIDTH_IN_FLOOR "inbound.floor"
@@ -2051,7 +2051,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the outbound average of NIC bandwidth, as a uint.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_BANDWIDTH_OUT_AVERAGE "outbound.average"
@@ -2060,7 +2060,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the outbound peak of NIC bandwidth, as a uint.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_BANDWIDTH_OUT_PEAK "outbound.peak"
@@ -2069,7 +2069,7 @@ int virDomainInterfaceStats (virDomainPtr dom,
*
* Macro represents the outbound burst of NIC bandwidth, as a uint.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
# define VIR_DOMAIN_BANDWIDTH_OUT_BURST "outbound.burst"
@@ -2096,10 +2096,10 @@ int virDomainBlockPeek (virDomainPtr dom,
*
* Flags available for virDomainBlockResize().
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef enum {
- VIR_DOMAIN_BLOCK_RESIZE_BYTES = 1 << 0, /* size in bytes instead of KiB (Since: v0.9.11) */
+ VIR_DOMAIN_BLOCK_RESIZE_BYTES = 1 << 0, /* size in bytes instead of KiB (Since: 0.9.11) */
} virDomainBlockResizeFlags;
int virDomainBlockResize (virDomainPtr dom,
@@ -2131,14 +2131,14 @@ int virDomainBlockResize (virDomainPtr dom,
* * allocation: highest qcow extent written for an active domain
* * physical: size of the block device container
*
- * Since: v0.8.1
+ * Since: 0.8.1
*/
typedef struct _virDomainBlockInfo virDomainBlockInfo;
/**
* virDomainBlockInfoPtr:
*
- * Since: v0.8.1
+ * Since: 0.8.1
*/
typedef virDomainBlockInfo *virDomainBlockInfoPtr;
struct _virDomainBlockInfo {
@@ -2171,11 +2171,11 @@ int virDomainMemoryStats (virDomainPtr dom,
*
* Memory peeking flags.
*
- * Since: v0.4.4
+ * Since: 0.4.4
*/
typedef enum {
- VIR_MEMORY_VIRTUAL = 1 << 0, /* addresses are virtual addresses (Since: v0.4.4) */
- VIR_MEMORY_PHYSICAL = 1 << 1, /* addresses are physical addresses (Since: v0.7.0) */
+ VIR_MEMORY_VIRTUAL = 1 << 0, /* addresses are virtual addresses (Since: 0.4.4) */
+ VIR_MEMORY_PHYSICAL = 1 << 1, /* addresses are physical addresses (Since: 0.7.0) */
} virDomainMemoryFlags;
int virDomainMemoryPeek (virDomainPtr dom,
@@ -2187,10 +2187,10 @@ int virDomainMemoryPeek (virDomainPtr dom,
/**
* virDomainDefineFlags:
*
- * Since: v1.2.12
+ * Since: 1.2.12
*/
typedef enum {
- VIR_DOMAIN_DEFINE_VALIDATE = (1 << 0), /* Validate the XML document against schema (Since: v1.2.12) */
+ VIR_DOMAIN_DEFINE_VALIDATE = (1 << 0), /* Validate the XML document against schema (Since: 1.2.12) */
} virDomainDefineFlags;
/*
@@ -2207,20 +2207,20 @@ int virDomainUndefine (virDomainPtr domain);
/**
* virDomainUndefineFlagsValues:
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef enum {
VIR_DOMAIN_UNDEFINE_MANAGED_SAVE = (1 << 0), /* Also remove any
- managed save (Since: v0.9.4) */
+ managed save (Since: 0.9.4) */
VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATA = (1 << 1), /* If last use of domain,
then also remove any
- snapshot metadata (Since: v0.9.5) */
+ snapshot metadata (Since: 0.9.5) */
VIR_DOMAIN_UNDEFINE_NVRAM = (1 << 2), /* Also remove any
- nvram file (Since: v1.2.9) */
- VIR_DOMAIN_UNDEFINE_KEEP_NVRAM = (1 << 3), /* Keep nvram file (Since: v2.3.0) */
+ nvram file (Since: 1.2.9) */
+ VIR_DOMAIN_UNDEFINE_KEEP_NVRAM = (1 << 3), /* Keep nvram file (Since: 2.3.0) */
VIR_DOMAIN_UNDEFINE_CHECKPOINTS_METADATA = (1 << 4), /* If last use of domain,
then also remove any
- checkpoint metadata (Since: v5.6.0) */
+ checkpoint metadata (Since: 5.6.0) */
} virDomainUndefineFlagsValues;
@@ -2237,31 +2237,31 @@ int virConnectListDefinedDomains (virConnectPtr conn,
* Note that these flags come in groups; if all bits from a group are 0,
* then that group is not used to filter results.
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
typedef enum {
- VIR_CONNECT_LIST_DOMAINS_ACTIVE = 1 << 0, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_INACTIVE = 1 << 1, /* (Since: v0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_ACTIVE = 1 << 0, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_INACTIVE = 1 << 1, /* (Since: 0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_PERSISTENT = 1 << 2, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_TRANSIENT = 1 << 3, /* (Since: v0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_PERSISTENT = 1 << 2, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_TRANSIENT = 1 << 3, /* (Since: 0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_RUNNING = 1 << 4, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_PAUSED = 1 << 5, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_SHUTOFF = 1 << 6, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_OTHER = 1 << 7, /* (Since: v0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_RUNNING = 1 << 4, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_PAUSED = 1 << 5, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_SHUTOFF = 1 << 6, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_OTHER = 1 << 7, /* (Since: 0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE = 1 << 8, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE = 1 << 9, /* (Since: v0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE = 1 << 8, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE = 1 << 9, /* (Since: 0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_AUTOSTART = 1 << 10, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART = 1 << 11, /* (Since: v0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_AUTOSTART = 1 << 10, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART = 1 << 11, /* (Since: 0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT = 1 << 12, /* (Since: v0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT = 1 << 13, /* (Since: v0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT = 1 << 12, /* (Since: 0.9.13) */
+ VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT = 1 << 13, /* (Since: 0.9.13) */
- VIR_CONNECT_LIST_DOMAINS_HAS_CHECKPOINT = 1 << 14, /* (Since: v5.6.0) */
- VIR_CONNECT_LIST_DOMAINS_NO_CHECKPOINT = 1 << 15, /* (Since: v5.6.0) */
+ VIR_CONNECT_LIST_DOMAINS_HAS_CHECKPOINT = 1 << 14, /* (Since: 5.6.0) */
+ VIR_CONNECT_LIST_DOMAINS_NO_CHECKPOINT = 1 << 15, /* (Since: 5.6.0) */
} virConnectListAllDomainsFlags;
int virConnectListAllDomains (virConnectPtr conn,
@@ -2286,32 +2286,32 @@ int virDomainSetAutostart (virDomainPtr domain,
*
* structure for information about a virtual CPU in a domain.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
typedef enum {
- VIR_VCPU_OFFLINE = 0, /* the virtual CPU is offline (Since: v0.1.4) */
- VIR_VCPU_RUNNING = 1, /* the virtual CPU is running (Since: v0.1.4) */
- VIR_VCPU_BLOCKED = 2, /* the virtual CPU is blocked on resource (Since: v0.1.4) */
+ VIR_VCPU_OFFLINE = 0, /* the virtual CPU is offline (Since: 0.1.4) */
+ VIR_VCPU_RUNNING = 1, /* the virtual CPU is running (Since: 0.1.4) */
+ VIR_VCPU_BLOCKED = 2, /* the virtual CPU is blocked on resource (Since: 0.1.4) */
# ifdef VIR_ENUM_SENTINELS
- VIR_VCPU_LAST /* (Since: v0.9.10) */
+ VIR_VCPU_LAST /* (Since: 0.9.10) */
# endif
} virVcpuState;
/**
* virVcpuHostCpuState:
*
- * Since: v6.10.0
+ * Since: 6.10.0
*/
typedef enum {
- VIR_VCPU_INFO_CPU_OFFLINE = -1, /* the vCPU is offline (Since: v6.10.0) */
- VIR_VCPU_INFO_CPU_UNAVAILABLE = -2, /* the hypervisor does not expose real CPU information (Since: v6.10.0) */
+ VIR_VCPU_INFO_CPU_OFFLINE = -1, /* the vCPU is offline (Since: 6.10.0) */
+ VIR_VCPU_INFO_CPU_UNAVAILABLE = -2, /* the hypervisor does not expose real CPU information (Since: 6.10.0) */
} virVcpuHostCpuState;
/**
* virVcpuInfo:
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
typedef struct _virVcpuInfo virVcpuInfo;
struct _virVcpuInfo {
@@ -2324,7 +2324,7 @@ struct _virVcpuInfo {
/**
* virVcpuInfoPtr:
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
typedef virVcpuInfo *virVcpuInfoPtr;
@@ -2333,16 +2333,16 @@ typedef virVcpuInfo *virVcpuInfoPtr;
*
* Flags for controlling virtual CPU hot-plugging.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
typedef enum {
- VIR_DOMAIN_VCPU_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: v0.9.4) */
- VIR_DOMAIN_VCPU_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: v0.8.5) */
- VIR_DOMAIN_VCPU_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: v0.8.5) */
+ VIR_DOMAIN_VCPU_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: 0.9.4) */
+ VIR_DOMAIN_VCPU_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: 0.8.5) */
+ VIR_DOMAIN_VCPU_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: 0.8.5) */
- VIR_DOMAIN_VCPU_MAXIMUM = (1 << 2), /* Max rather than current count (Since: v0.8.5) */
- VIR_DOMAIN_VCPU_GUEST = (1 << 3), /* Modify state of the cpu in the guest (Since: v1.1.0) */
- VIR_DOMAIN_VCPU_HOTPLUGGABLE = (1 << 4), /* Make vcpus added hot(un)pluggable (Since: v2.4.0) */
+ VIR_DOMAIN_VCPU_MAXIMUM = (1 << 2), /* Max rather than current count (Since: 0.8.5) */
+ VIR_DOMAIN_VCPU_GUEST = (1 << 3), /* Modify state of the cpu in the guest (Since: 1.1.0) */
+ VIR_DOMAIN_VCPU_HOTPLUGGABLE = (1 << 4), /* Make vcpus added hot(un)pluggable (Since: 2.4.0) */
} virDomainVcpuFlags;
int virDomainSetVcpus (virDomainPtr domain,
@@ -2384,7 +2384,7 @@ int virDomainGetEmulatorPinInfo (virDomainPtr domain,
*
* The data structure for information about all IOThreads in a domain
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef struct _virDomainIOThreadInfo virDomainIOThreadInfo;
@@ -2392,7 +2392,7 @@ typedef struct _virDomainIOThreadInfo virDomainIOThreadInfo;
/**
* virDomainIOThreadInfoPtr:
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef virDomainIOThreadInfo *virDomainIOThreadInfoPtr;
struct _virDomainIOThreadInfo {
@@ -2433,7 +2433,7 @@ int virDomainDelIOThread(virDomainPtr domain,
* small will not provide enough cycles for the guest to process data.
* The polling interval is not available for statistical purposes.
*
- * Since: v4.10.0
+ * Since: 4.10.0
*/
# define VIR_DOMAIN_IOTHREAD_POLL_MAX_NS "poll_max_ns"
@@ -2445,7 +2445,7 @@ int virDomainDelIOThread(virDomainPtr domain,
* of 0 (zero) allows the hypervisor to choose its own value. The algorithm
* to use for adjustment is hypervisor specific.
*
- * Since: v4.10.0
+ * Since: 4.10.0
*/
# define VIR_DOMAIN_IOTHREAD_POLL_GROW "poll_grow"
@@ -2458,7 +2458,7 @@ int virDomainDelIOThread(virDomainPtr domain,
* choose its own value. The algorithm to use for adjustment is hypervisor
* specific.
*
- * Since: v4.10.0
+ * Since: 4.10.0
*/
# define VIR_DOMAIN_IOTHREAD_POLL_SHRINK "poll_shrink"
@@ -2477,7 +2477,7 @@ int virDomainSetIOThreadParams(virDomainPtr domain,
* This macro is to be used in conjunction with virDomainPinVcpu() API.
* It sets the bit (CPU usable) of the related cpu in cpumap.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_USE_CPU(cpumap, cpu) ((cpumap)[(cpu) / 8] |= (1 << ((cpu) % 8)))
@@ -2489,7 +2489,7 @@ int virDomainSetIOThreadParams(virDomainPtr domain,
* This macro is to be used in conjunction with virDomainPinVcpu() API.
* It resets the bit (CPU not usable) of the related cpu in cpumap.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_UNUSE_CPU(cpumap, cpu) ((cpumap)[(cpu) / 8] &= ~(1 << ((cpu) % 8)))
@@ -2501,7 +2501,7 @@ int virDomainSetIOThreadParams(virDomainPtr domain,
* This macro can be used in conjunction with virNodeGetCPUMap() API.
* It returns non-zero if the bit of the related CPU is set.
*
- * Since: v1.0.0
+ * Since: 1.0.0
*/
# define VIR_CPU_USED(cpumap, cpu) ((cpumap)[(cpu) / 8] & (1 << ((cpu) % 8)))
@@ -2513,7 +2513,7 @@ int virDomainSetIOThreadParams(virDomainPtr domain,
* It returns the length (in bytes) required to store the complete
* CPU map between a single virtual & all physical CPUs of a domain.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_CPU_MAPLEN(cpu) (((cpu) + 7) / 8)
@@ -2535,7 +2535,7 @@ int virDomainGetVcpus (virDomainPtr domain,
* VIR_CPU_USABLE macro returns a non-zero value (true) if the cpu
* is usable by the vcpu, and 0 otherwise.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_CPU_USABLE(cpumaps, maplen, vcpu, cpu) \
VIR_CPU_USED(VIR_GET_CPUMAP(cpumaps, maplen, vcpu), cpu)
@@ -2554,7 +2554,7 @@ int virDomainGetVcpus (virDomainPtr domain,
* the specified vcpu from cpumaps array and copies it into cpumap to be used
* later by virDomainPinVcpu() API.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_COPY_CPUMAP(cpumaps, maplen, vcpu, cpumap) \
memcpy(cpumap, VIR_GET_CPUMAP(cpumaps, maplen, vcpu), maplen)
@@ -2570,7 +2570,7 @@ int virDomainGetVcpus (virDomainPtr domain,
* virDomainPinVcpu() APIs. VIR_GET_CPUMAP macro returns a pointer to the
* cpumap of the specified vcpu from cpumaps array.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_GET_CPUMAP(cpumaps, maplen, vcpu) (&((cpumaps)[(vcpu) * (maplen)]))
@@ -2578,14 +2578,14 @@ int virDomainGetVcpus (virDomainPtr domain,
/**
* virDomainDeviceModifyFlags:
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
typedef enum {
- VIR_DOMAIN_DEVICE_MODIFY_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: v0.7.7) */
- VIR_DOMAIN_DEVICE_MODIFY_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: v0.7.7) */
- VIR_DOMAIN_DEVICE_MODIFY_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: v0.7.7) */
+ VIR_DOMAIN_DEVICE_MODIFY_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: 0.7.7) */
+ VIR_DOMAIN_DEVICE_MODIFY_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: 0.7.7) */
+ VIR_DOMAIN_DEVICE_MODIFY_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: 0.7.7) */
- VIR_DOMAIN_DEVICE_MODIFY_FORCE = (1 << 2), /* Forcibly modify device (ex. force eject a cdrom) (Since: v0.8.6) */
+ VIR_DOMAIN_DEVICE_MODIFY_FORCE = (1 << 2), /* Forcibly modify device (ex. force eject a cdrom) (Since: 0.8.6) */
} virDomainDeviceModifyFlags;
int virDomainAttachDevice(virDomainPtr domain, const char *xml);
@@ -2604,14 +2604,14 @@ int virDomainDetachDeviceAlias(virDomainPtr domain,
/**
* virDomainStatsRecord:
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
typedef struct _virDomainStatsRecord virDomainStatsRecord;
/**
* virDomainStatsRecordPtr:
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
typedef virDomainStatsRecord *virDomainStatsRecordPtr;
struct _virDomainStatsRecord {
@@ -2623,42 +2623,42 @@ struct _virDomainStatsRecord {
/**
* virDomainStatsTypes:
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
typedef enum {
- VIR_DOMAIN_STATS_STATE = (1 << 0), /* return domain state (Since: v1.2.8) */
- VIR_DOMAIN_STATS_CPU_TOTAL = (1 << 1), /* return domain CPU info (Since: v1.2.9) */
- VIR_DOMAIN_STATS_BALLOON = (1 << 2), /* return domain balloon info (Since: v1.2.9) */
- VIR_DOMAIN_STATS_VCPU = (1 << 3), /* return domain virtual CPU info (Since: v1.2.9) */
- VIR_DOMAIN_STATS_INTERFACE = (1 << 4), /* return domain interfaces info (Since: v1.2.9) */
- VIR_DOMAIN_STATS_BLOCK = (1 << 5), /* return domain block info (Since: v1.2.9) */
- VIR_DOMAIN_STATS_PERF = (1 << 6), /* return domain perf event info (Since: v1.3.3) */
- VIR_DOMAIN_STATS_IOTHREAD = (1 << 7), /* return iothread poll info (Since: v4.10.0) */
- VIR_DOMAIN_STATS_MEMORY = (1 << 8), /* return domain memory info (Since: v6.0.0) */
- VIR_DOMAIN_STATS_DIRTYRATE = (1 << 9), /* return domain dirty rate info (Since: v7.2.0) */
+ VIR_DOMAIN_STATS_STATE = (1 << 0), /* return domain state (Since: 1.2.8) */
+ VIR_DOMAIN_STATS_CPU_TOTAL = (1 << 1), /* return domain CPU info (Since: 1.2.9) */
+ VIR_DOMAIN_STATS_BALLOON = (1 << 2), /* return domain balloon info (Since: 1.2.9) */
+ VIR_DOMAIN_STATS_VCPU = (1 << 3), /* return domain virtual CPU info (Since: 1.2.9) */
+ VIR_DOMAIN_STATS_INTERFACE = (1 << 4), /* return domain interfaces info (Since: 1.2.9) */
+ VIR_DOMAIN_STATS_BLOCK = (1 << 5), /* return domain block info (Since: 1.2.9) */
+ VIR_DOMAIN_STATS_PERF = (1 << 6), /* return domain perf event info (Since: 1.3.3) */
+ VIR_DOMAIN_STATS_IOTHREAD = (1 << 7), /* return iothread poll info (Since: 4.10.0) */
+ VIR_DOMAIN_STATS_MEMORY = (1 << 8), /* return domain memory info (Since: 6.0.0) */
+ VIR_DOMAIN_STATS_DIRTYRATE = (1 << 9), /* return domain dirty rate info (Since: 7.2.0) */
} virDomainStatsTypes;
/**
* virConnectGetAllDomainStatsFlags:
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
typedef enum {
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE = VIR_CONNECT_LIST_DOMAINS_ACTIVE, /* (Since: v1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE = VIR_CONNECT_LIST_DOMAINS_INACTIVE, /* (Since: v1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE = VIR_CONNECT_LIST_DOMAINS_ACTIVE, /* (Since: 1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE = VIR_CONNECT_LIST_DOMAINS_INACTIVE, /* (Since: 1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT = VIR_CONNECT_LIST_DOMAINS_PERSISTENT, /* (Since: v1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT = VIR_CONNECT_LIST_DOMAINS_TRANSIENT, /* (Since: v1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT = VIR_CONNECT_LIST_DOMAINS_PERSISTENT, /* (Since: 1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT = VIR_CONNECT_LIST_DOMAINS_TRANSIENT, /* (Since: 1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING = VIR_CONNECT_LIST_DOMAINS_RUNNING, /* (Since: v1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED = VIR_CONNECT_LIST_DOMAINS_PAUSED, /* (Since: v1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF = VIR_CONNECT_LIST_DOMAINS_SHUTOFF, /* (Since: v1.2.8) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER = VIR_CONNECT_LIST_DOMAINS_OTHER, /* (Since: v1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING = VIR_CONNECT_LIST_DOMAINS_RUNNING, /* (Since: 1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED = VIR_CONNECT_LIST_DOMAINS_PAUSED, /* (Since: 1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF = VIR_CONNECT_LIST_DOMAINS_SHUTOFF, /* (Since: 1.2.8) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER = VIR_CONNECT_LIST_DOMAINS_OTHER, /* (Since: 1.2.8) */
VIR_CONNECT_GET_ALL_DOMAINS_STATS_NOWAIT = 1 << 29, /* report statistics that can be obtained
- immediately without any blocking (Since: v4.5.0) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING = 1 << 30, /* include backing chain for block stats (Since: v1.2.12) */
- VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS = 1U << 31, /* enforce requested stats (Since: v1.2.8) */
+ immediately without any blocking (Since: 4.5.0) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING = 1 << 30, /* include backing chain for block stats (Since: 1.2.12) */
+ VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS = 1U << 31, /* enforce requested stats (Since: 1.2.8) */
} virConnectGetAllDomainStatsFlags;
int virConnectGetAllDomainStats(virConnectPtr conn,
@@ -2685,7 +2685,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* applications running on the platform. It corresponds to the
* "perf.cmt" field in the *Stats APIs.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
# define VIR_PERF_PARAM_CMT "cmt"
@@ -2697,7 +2697,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* from one level of cache to another. It corresponds to the
* "perf.mbmt" field in the *Stats APIs.
*
- * Since: v1.3.5
+ * Since: 1.3.5
*/
# define VIR_PERF_PARAM_MBMT "mbmt"
@@ -2709,7 +2709,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* through the memory controller on the socket. It corresponds to
* the "perf.mbml" field in the *Stats APIs.
*
- * Since: v1.3.5
+ * Since: 1.3.5
*/
# define VIR_PERF_PARAM_MBML "mbml"
@@ -2721,7 +2721,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* applications running on the platform. It corresponds to the
* "perf.cache_misses" field in the *Stats APIs.
*
- * Since: v2.3.0
+ * Since: 2.3.0
*/
# define VIR_PERF_PARAM_CACHE_MISSES "cache_misses"
@@ -2733,7 +2733,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* by applications running on the platform. It corresponds to the
* "perf.cache_references" field in the *Stats APIs.
*
- * Since: v2.3.0
+ * Since: 2.3.0
*/
# define VIR_PERF_PARAM_CACHE_REFERENCES "cache_references"
@@ -2745,7 +2745,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* by applications running on the platform. It corresponds to the
* "perf.instructions" field in the *Stats APIs.
*
- * Since: v2.3.0
+ * Since: 2.3.0
*/
# define VIR_PERF_PARAM_INSTRUCTIONS "instructions"
@@ -2757,7 +2757,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* how many cpu cycles one instruction needs.
* It corresponds to the "perf.cpu_cycles" field in the *Stats APIs.
*
- * Since: v2.3.0
+ * Since: 2.3.0
*/
# define VIR_PERF_PARAM_CPU_CYCLES "cpu_cycles"
@@ -2769,7 +2769,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* by applications running on the platform. It corresponds to the
* "perf.branch_instructions" field in the *Stats APIs.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_PERF_PARAM_BRANCH_INSTRUCTIONS "branch_instructions"
@@ -2781,7 +2781,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* by applications running on the platform. It corresponds to the
* "perf.branch_misses" field in the *Stats APIs.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_PERF_PARAM_BRANCH_MISSES "branch_misses"
@@ -2793,7 +2793,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* by applications running on the platform. It corresponds to the
* "perf.bus_cycles" field in the *Stats APIs.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_PERF_PARAM_BUS_CYCLES "bus_cycles"
@@ -2806,7 +2806,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* running on the platform. It corresponds to the
* "perf.stalled_cycles_frontend" field in the *Stats APIs.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_PERF_PARAM_STALLED_CYCLES_FRONTEND "stalled_cycles_frontend"
@@ -2819,7 +2819,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* running on the platform. It corresponds to the
* "perf.stalled_cycles_backend" field in the *Stats APIs.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_PERF_PARAM_STALLED_CYCLES_BACKEND "stalled_cycles_backend"
@@ -2832,7 +2832,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* running on the platform. It corresponds to the
* "perf.ref_cpu_cycles" field in the *Stats APIs.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_PERF_PARAM_REF_CPU_CYCLES "ref_cpu_cycles"
@@ -2845,7 +2845,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* corresponds to the "perf.cpu_clock" field in the *Stats
* APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_CPU_CLOCK "cpu_clock"
@@ -2858,7 +2858,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* corresponds to the "perf.task_clock" field in the *Stats
* APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_TASK_CLOCK "task_clock"
@@ -2870,7 +2870,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* faults by applications running on the platform. It corresponds
* to the "perf.page_faults" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_PAGE_FAULTS "page_faults"
@@ -2882,7 +2882,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* switches by applications running on the platform. It corresponds
* to the "perf.context_switches" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_CONTEXT_SWITCHES "context_switches"
@@ -2894,7 +2894,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* migrations by applications running on the platform. It corresponds
* to the "perf.cpu_migrations" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_CPU_MIGRATIONS "cpu_migrations"
@@ -2906,7 +2906,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* faults by applications running on the platform. It corresponds
* to the "perf.page_faults_min" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_PAGE_FAULTS_MIN "page_faults_min"
@@ -2918,7 +2918,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* faults by applications running on the platform. It corresponds
* to the "perf.page_faults_maj" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_PAGE_FAULTS_MAJ "page_faults_maj"
@@ -2930,7 +2930,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* faults by applications running on the platform. It corresponds
* to the "perf.alignment_faults" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_ALIGNMENT_FAULTS "alignment_faults"
@@ -2942,7 +2942,7 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* faults by applications running on the platform. It corresponds
* to the "perf.emulation_faults" field in the *Stats APIs.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
# define VIR_PERF_PARAM_EMULATION_FAULTS "emulation_faults"
@@ -2964,48 +2964,48 @@ int virDomainSetPerfEvents(virDomainPtr dom,
*
* Describes various possible block jobs.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef enum {
- /* Placeholder (Since: v0.9.4) */
+ /* Placeholder (Since: 0.9.4) */
VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWN = 0,
/* Block Pull (virDomainBlockPull, or virDomainBlockRebase without
* flags), job ends on completion
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
VIR_DOMAIN_BLOCK_JOB_TYPE_PULL = 1,
/* Block Copy (virDomainBlockCopy, or virDomainBlockRebase with
* flags), job exists as long as mirroring is active
*
- * Since: v0.9.12
+ * Since: 0.9.12
*/
VIR_DOMAIN_BLOCK_JOB_TYPE_COPY = 2,
/* Block Commit (virDomainBlockCommit without flags), job ends on
* completion
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
VIR_DOMAIN_BLOCK_JOB_TYPE_COMMIT = 3,
/* Active Block Commit (virDomainBlockCommit with flags), job
* exists as long as sync is active
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
VIR_DOMAIN_BLOCK_JOB_TYPE_ACTIVE_COMMIT = 4,
/* Backup (virDomainBackupBegin)
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
VIR_DOMAIN_BLOCK_JOB_TYPE_BACKUP = 5,
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_BLOCK_JOB_TYPE_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_BLOCK_JOB_TYPE_LAST /* (Since: 0.9.10) */
# endif
} virDomainBlockJobType;
@@ -3016,11 +3016,11 @@ typedef enum {
* VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT: Pivot to new file when ending a copy or
* active commit job
*
- * Since: v0.9.12
+ * Since: 0.9.12
*/
typedef enum {
- VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC = 1 << 0, /* (Since: v0.9.12) */
- VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT = 1 << 1, /* (Since: v0.9.12) */
+ VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC = 1 << 0, /* (Since: 0.9.12) */
+ VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT = 1 << 1, /* (Since: 0.9.12) */
} virDomainBlockJobAbortFlags;
int virDomainBlockJobAbort(virDomainPtr dom, const char *disk,
@@ -3031,11 +3031,11 @@ int virDomainBlockJobAbort(virDomainPtr dom, const char *disk,
*
* Flags for use with virDomainGetBlockJobInfo
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
typedef enum {
VIR_DOMAIN_BLOCK_JOB_INFO_BANDWIDTH_BYTES = 1 << 0, /* bandwidth in bytes/s
- instead of MiB/s (Since: v1.2.9) */
+ instead of MiB/s (Since: 1.2.9) */
} virDomainBlockJobInfoFlags;
/**
@@ -3043,14 +3043,14 @@ typedef enum {
*
* An iterator for monitoring block job operations
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef unsigned long long virDomainBlockJobCursor;
/**
* virDomainBlockJobInfo:
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef struct _virDomainBlockJobInfo virDomainBlockJobInfo;
struct _virDomainBlockJobInfo {
@@ -3070,7 +3070,7 @@ struct _virDomainBlockJobInfo {
/**
* virDomainBlockJobInfoPtr:
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef virDomainBlockJobInfo *virDomainBlockJobInfoPtr;
@@ -3083,11 +3083,11 @@ int virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk,
*
* Flags for use with virDomainBlockJobSetSpeed
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
typedef enum {
VIR_DOMAIN_BLOCK_JOB_SPEED_BANDWIDTH_BYTES = 1 << 0, /* bandwidth in bytes/s
- instead of MiB/s (Since: v1.2.9) */
+ instead of MiB/s (Since: 1.2.9) */
} virDomainBlockJobSetSpeedFlags;
int virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk,
@@ -3099,11 +3099,11 @@ int virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk,
* Flags for use with virDomainBlockPull (values chosen to be a subset of the
* flags for virDomainBlockRebase)
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
typedef enum {
VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTES = 1 << 6, /* bandwidth in bytes/s
- instead of MiB/s (Since: v1.2.9) */
+ instead of MiB/s (Since: 1.2.9) */
} virDomainBlockPullFlags;
int virDomainBlockPull(virDomainPtr dom, const char *disk,
@@ -3114,22 +3114,22 @@ int virDomainBlockPull(virDomainPtr dom, const char *disk,
*
* Flags available for virDomainBlockRebase().
*
- * Since: v0.9.12
+ * Since: 0.9.12
*/
typedef enum {
VIR_DOMAIN_BLOCK_REBASE_SHALLOW = 1 << 0, /* Limit copy to top of source
- backing chain (Since: v0.9.12) */
+ backing chain (Since: 0.9.12) */
VIR_DOMAIN_BLOCK_REBASE_REUSE_EXT = 1 << 1, /* Reuse existing external
- file for a copy (Since: v0.9.12) */
- VIR_DOMAIN_BLOCK_REBASE_COPY_RAW = 1 << 2, /* Make destination file raw (Since: v0.9.12) */
- VIR_DOMAIN_BLOCK_REBASE_COPY = 1 << 3, /* Start a copy job (Since: v0.9.12) */
+ file for a copy (Since: 0.9.12) */
+ VIR_DOMAIN_BLOCK_REBASE_COPY_RAW = 1 << 2, /* Make destination file raw (Since: 0.9.12) */
+ VIR_DOMAIN_BLOCK_REBASE_COPY = 1 << 3, /* Start a copy job (Since: 0.9.12) */
VIR_DOMAIN_BLOCK_REBASE_RELATIVE = 1 << 4, /* Keep backing chain
referenced using relative
- names (Since: v1.2.7) */
+ names (Since: 1.2.7) */
VIR_DOMAIN_BLOCK_REBASE_COPY_DEV = 1 << 5, /* Treat destination as block
- device instead of file (Since: v1.2.9) */
+ device instead of file (Since: 1.2.9) */
VIR_DOMAIN_BLOCK_REBASE_BANDWIDTH_BYTES = 1 << 6, /* bandwidth in bytes/s
- instead of MiB/s (Since: v1.2.9) */
+ instead of MiB/s (Since: 1.2.9) */
} virDomainBlockRebaseFlags;
int virDomainBlockRebase(virDomainPtr dom, const char *disk,
@@ -3141,22 +3141,22 @@ int virDomainBlockRebase(virDomainPtr dom, const char *disk,
*
* Flags available for virDomainBlockCopy().
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
typedef enum {
- /* Limit copy to top of source backing chain (Since: v1.2.8) */
+ /* Limit copy to top of source backing chain (Since: 1.2.8) */
VIR_DOMAIN_BLOCK_COPY_SHALLOW = 1 << 0,
- /* Reuse existing external file for a copy (Since: v1.2.8) */
+ /* Reuse existing external file for a copy (Since: 1.2.8) */
VIR_DOMAIN_BLOCK_COPY_REUSE_EXT = 1 << 1,
- /* Don't force usage of recoverable job for the copy operation (Since: v3.5.0) */
+ /* Don't force usage of recoverable job for the copy operation (Since: 3.5.0) */
VIR_DOMAIN_BLOCK_COPY_TRANSIENT_JOB = 1 << 2,
/* Force the copy job to synchronously propagate guest writes into
* the destination image, so that the copy is guaranteed to converge
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
VIR_DOMAIN_BLOCK_COPY_SYNCHRONOUS_WRITES = 1 << 3,
} virDomainBlockCopyFlags;
@@ -3178,7 +3178,7 @@ typedef enum {
* virDomainBlockJobSetSpeed(). The actual speed can be determined
* with virDomainGetBlockJobInfo().
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
# define VIR_DOMAIN_BLOCK_COPY_BANDWIDTH "bandwidth"
@@ -3191,7 +3191,7 @@ typedef enum {
* range. Specifying 0 is the same as omitting this parameter, to
* request the hypervisor default.
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
# define VIR_DOMAIN_BLOCK_COPY_GRANULARITY "granularity"
@@ -3202,7 +3202,7 @@ typedef enum {
* as an unsigned long long. Specifying 0 is the same as omitting this
* parameter, to request the hypervisor default.
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
# define VIR_DOMAIN_BLOCK_COPY_BUF_SIZE "buf-size"
@@ -3217,21 +3217,21 @@ int virDomainBlockCopy(virDomainPtr dom, const char *disk,
*
* Flags available for virDomainBlockCommit().
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
VIR_DOMAIN_BLOCK_COMMIT_SHALLOW = 1 << 0, /* NULL base means next backing
- file, not whole chain (Since: v0.10.2) */
+ file, not whole chain (Since: 0.10.2) */
VIR_DOMAIN_BLOCK_COMMIT_DELETE = 1 << 1, /* Delete any files that are now
invalid after their contents
- have been committed (Since: v0.10.2) */
+ have been committed (Since: 0.10.2) */
VIR_DOMAIN_BLOCK_COMMIT_ACTIVE = 1 << 2, /* Allow a two-phase commit when
- top is the active layer (Since: v1.2.6) */
+ top is the active layer (Since: 1.2.6) */
VIR_DOMAIN_BLOCK_COMMIT_RELATIVE = 1 << 3, /* keep the backing chain
referenced using relative
- names (Since: v1.2.7) */
+ names (Since: 1.2.7) */
VIR_DOMAIN_BLOCK_COMMIT_BANDWIDTH_BYTES = 1 << 4, /* bandwidth in bytes/s
- instead of MiB/s (Since: v1.2.9) */
+ instead of MiB/s (Since: 1.2.9) */
} virDomainBlockCommitFlags;
int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
@@ -3247,7 +3247,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the total
* bytes per second permitted through a block device, as a ullong.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC "total_bytes_sec"
@@ -3257,7 +3257,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the read
* bytes per second permitted through a block device, as a ullong.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC "read_bytes_sec"
@@ -3267,7 +3267,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the write
* bytes per second permitted through a block device, as a ullong.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC "write_bytes_sec"
@@ -3277,7 +3277,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the total
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC "total_iops_sec"
@@ -3287,7 +3287,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the read
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC "read_iops_sec"
@@ -3296,7 +3296,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the write
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC "write_iops_sec"
@@ -3306,7 +3306,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the maximum total
* bytes per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX "total_bytes_sec_max"
@@ -3316,7 +3316,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the maximum read
* bytes per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX "read_bytes_sec_max"
@@ -3326,7 +3326,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the maximum write
* bytes per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX "write_bytes_sec_max"
@@ -3336,7 +3336,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the maximum
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX "total_iops_sec_max"
@@ -3346,7 +3346,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the maximum read
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX "read_iops_sec_max"
@@ -3355,7 +3355,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the maximum write
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX "write_iops_sec_max"
@@ -3365,7 +3365,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the duration in
* seconds for the burst allowed by total_bytes_sec_max, as a ullong.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX_LENGTH "total_bytes_sec_max_length"
@@ -3375,7 +3375,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the duration in
* seconds for the burst allowed by read_bytes_sec_max, as a ullong.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX_LENGTH "read_bytes_sec_max_length"
@@ -3385,7 +3385,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the duration in
* seconds for the burst allowed by write_bytes_sec_max, as a ullong.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX_LENGTH "write_bytes_sec_max_length"
@@ -3395,7 +3395,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the duration in
* seconds for the burst allowed by total_iops_sec_max, as a ullong.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX_LENGTH "total_iops_sec_max_length"
@@ -3405,7 +3405,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the duration in
* seconds for the burst allowed by read_iops_sec_max, as a ullong.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX_LENGTH "read_iops_sec_max_length"
@@ -3415,7 +3415,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the duration in
* seconds for the burst allowed by write_iops_sec_max, as a ullong.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX_LENGTH "write_iops_sec_max_length"
@@ -3424,7 +3424,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents the size
* I/O operations per second permitted through a block device, as a ullong.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_SIZE_IOPS_SEC "size_iops_sec"
@@ -3433,7 +3433,7 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base,
* Macro for the BlockIoTune tunable weight: it represents a group name to
* allow sharing of I/O throttling quota between multiple drives, as a string.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_DOMAIN_BLOCK_IOTUNE_GROUP_NAME "group_name"
@@ -3455,29 +3455,29 @@ virDomainGetBlockIoTune(virDomainPtr dom,
*
* Disk I/O error.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_DOMAIN_DISK_ERROR_NONE = 0, /* no error (Since: v0.9.10) */
- VIR_DOMAIN_DISK_ERROR_UNSPEC = 1, /* unspecified I/O error (Since: v0.9.10) */
- VIR_DOMAIN_DISK_ERROR_NO_SPACE = 2, /* no space left on the device (Since: v0.9.10) */
+ VIR_DOMAIN_DISK_ERROR_NONE = 0, /* no error (Since: 0.9.10) */
+ VIR_DOMAIN_DISK_ERROR_UNSPEC = 1, /* unspecified I/O error (Since: 0.9.10) */
+ VIR_DOMAIN_DISK_ERROR_NO_SPACE = 2, /* no space left on the device (Since: 0.9.10) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_DISK_ERROR_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_DISK_ERROR_LAST /* (Since: 0.9.10) */
# endif
} virDomainDiskErrorCode;
/**
* virDomainDiskError:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef struct _virDomainDiskError virDomainDiskError;
/**
* virDomainDiskErrorPtr:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef virDomainDiskError *virDomainDiskErrorPtr;
@@ -3498,19 +3498,19 @@ int virDomainGetDiskErrors(virDomainPtr dom,
*
* Enum to specify which keycode mapping is in use for virDomainSendKey().
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef enum {
- VIR_KEYCODE_SET_LINUX = 0, /* (Since: v0.9.3) */
- VIR_KEYCODE_SET_XT = 1, /* (Since: v0.9.3) */
- VIR_KEYCODE_SET_ATSET1 = 2, /* (Since: v0.9.3) */
- VIR_KEYCODE_SET_ATSET2 = 3, /* (Since: v0.9.3) */
- VIR_KEYCODE_SET_ATSET3 = 4, /* (Since: v0.9.3) */
- VIR_KEYCODE_SET_OSX = 5, /* (Since: v0.9.4) */
- VIR_KEYCODE_SET_XT_KBD = 6, /* (Since: v0.9.4) */
- VIR_KEYCODE_SET_USB = 7, /* (Since: v0.9.4) */
- VIR_KEYCODE_SET_WIN32 = 8, /* (Since: v0.9.4) */
- VIR_KEYCODE_SET_QNUM = 9, /* (Since: v4.2.0) */
+ VIR_KEYCODE_SET_LINUX = 0, /* (Since: 0.9.3) */
+ VIR_KEYCODE_SET_XT = 1, /* (Since: 0.9.3) */
+ VIR_KEYCODE_SET_ATSET1 = 2, /* (Since: 0.9.3) */
+ VIR_KEYCODE_SET_ATSET2 = 3, /* (Since: 0.9.3) */
+ VIR_KEYCODE_SET_ATSET3 = 4, /* (Since: 0.9.3) */
+ VIR_KEYCODE_SET_OSX = 5, /* (Since: 0.9.4) */
+ VIR_KEYCODE_SET_XT_KBD = 6, /* (Since: 0.9.4) */
+ VIR_KEYCODE_SET_USB = 7, /* (Since: 0.9.4) */
+ VIR_KEYCODE_SET_WIN32 = 8, /* (Since: 0.9.4) */
+ VIR_KEYCODE_SET_QNUM = 9, /* (Since: 4.2.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_KEYCODE_SET_LAST
@@ -3519,7 +3519,7 @@ typedef enum {
* added to the libvirt API. It reflects the last keycode set supported
* by this version of the libvirt API.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
# endif
} virKeycodeSet;
@@ -3529,7 +3529,7 @@ typedef enum {
*
* Compatibility alias for VIR_KEYCODE_SET_QNUM, which replaced it since 4.2.0.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
# define VIR_KEYCODE_SET_RFB VIR_KEYCODE_SET_QNUM
@@ -3538,7 +3538,7 @@ typedef enum {
*
* Maximum number of keycodes that can be sent in one virDomainSendKey() call.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_DOMAIN_SEND_KEY_MAX_KEYS 16
@@ -3561,83 +3561,83 @@ int virDomainSendKey(virDomainPtr domain,
* this enum might be extended with new signals which have no
* mapping in Linux.
*
- * Since: v1.0.1
+ * Since: 1.0.1
*/
typedef enum {
- VIR_DOMAIN_PROCESS_SIGNAL_NOP = 0, /* No constant in POSIX/Linux (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_HUP = 1, /* SIGHUP (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_INT = 2, /* SIGINT (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_QUIT = 3, /* SIGQUIT (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_ILL = 4, /* SIGILL (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_TRAP = 5, /* SIGTRAP (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_ABRT = 6, /* SIGABRT (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_BUS = 7, /* SIGBUS (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_FPE = 8, /* SIGFPE (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_KILL = 9, /* SIGKILL (Since: v1.0.1) */
-
- VIR_DOMAIN_PROCESS_SIGNAL_USR1 = 10, /* SIGUSR1 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_SEGV = 11, /* SIGSEGV (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_USR2 = 12, /* SIGUSR2 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_PIPE = 13, /* SIGPIPE (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_ALRM = 14, /* SIGALRM (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_TERM = 15, /* SIGTERM (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_STKFLT = 16, /* Not in POSIX (SIGSTKFLT on Linux (Since: v1.0.1) )*/
- VIR_DOMAIN_PROCESS_SIGNAL_CHLD = 17, /* SIGCHLD (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_CONT = 18, /* SIGCONT (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_STOP = 19, /* SIGSTOP (Since: v1.0.1) */
-
- VIR_DOMAIN_PROCESS_SIGNAL_TSTP = 20, /* SIGTSTP (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_TTIN = 21, /* SIGTTIN (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_TTOU = 22, /* SIGTTOU (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_URG = 23, /* SIGURG (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_XCPU = 24, /* SIGXCPU (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_XFSZ = 25, /* SIGXFSZ (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_VTALRM = 26, /* SIGVTALRM (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_PROF = 27, /* SIGPROF (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_WINCH = 28, /* Not in POSIX (SIGWINCH on Linux) (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_POLL = 29, /* SIGPOLL (also known as SIGIO on Linux) (Since: v1.0.1) */
-
- VIR_DOMAIN_PROCESS_SIGNAL_PWR = 30, /* Not in POSIX (SIGPWR on Linux) (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_SYS = 31, /* SIGSYS (also known as SIGUNUSED on Linux) (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT0 = 32, /* SIGRTMIN (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT1 = 33, /* SIGRTMIN + 1 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT2 = 34, /* SIGRTMIN + 2 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT3 = 35, /* SIGRTMIN + 3 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT4 = 36, /* SIGRTMIN + 4 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT5 = 37, /* SIGRTMIN + 5 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT6 = 38, /* SIGRTMIN + 6 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT7 = 39, /* SIGRTMIN + 7 (Since: v1.0.1) */
-
- VIR_DOMAIN_PROCESS_SIGNAL_RT8 = 40, /* SIGRTMIN + 8 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT9 = 41, /* SIGRTMIN + 9 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT10 = 42, /* SIGRTMIN + 10 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT11 = 43, /* SIGRTMIN + 11 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT12 = 44, /* SIGRTMIN + 12 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT13 = 45, /* SIGRTMIN + 13 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT14 = 46, /* SIGRTMIN + 14 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT15 = 47, /* SIGRTMIN + 15 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT16 = 48, /* SIGRTMIN + 16 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT17 = 49, /* SIGRTMIN + 17 (Since: v1.0.1) */
-
- VIR_DOMAIN_PROCESS_SIGNAL_RT18 = 50, /* SIGRTMIN + 18 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT19 = 51, /* SIGRTMIN + 19 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT20 = 52, /* SIGRTMIN + 20 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT21 = 53, /* SIGRTMIN + 21 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT22 = 54, /* SIGRTMIN + 22 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT23 = 55, /* SIGRTMIN + 23 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT24 = 56, /* SIGRTMIN + 24 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT25 = 57, /* SIGRTMIN + 25 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT26 = 58, /* SIGRTMIN + 26 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT27 = 59, /* SIGRTMIN + 27 (Since: v1.0.1) */
-
- VIR_DOMAIN_PROCESS_SIGNAL_RT28 = 60, /* SIGRTMIN + 28 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT29 = 61, /* SIGRTMIN + 29 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT30 = 62, /* SIGRTMIN + 30 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT31 = 63, /* SIGRTMIN + 31 (Since: v1.0.1) */
- VIR_DOMAIN_PROCESS_SIGNAL_RT32 = 64, /* SIGRTMIN + 32 / SIGRTMAX (Since: v1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_NOP = 0, /* No constant in POSIX/Linux (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_HUP = 1, /* SIGHUP (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_INT = 2, /* SIGINT (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_QUIT = 3, /* SIGQUIT (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_ILL = 4, /* SIGILL (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_TRAP = 5, /* SIGTRAP (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_ABRT = 6, /* SIGABRT (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_BUS = 7, /* SIGBUS (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_FPE = 8, /* SIGFPE (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_KILL = 9, /* SIGKILL (Since: 1.0.1) */
+
+ VIR_DOMAIN_PROCESS_SIGNAL_USR1 = 10, /* SIGUSR1 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_SEGV = 11, /* SIGSEGV (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_USR2 = 12, /* SIGUSR2 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_PIPE = 13, /* SIGPIPE (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_ALRM = 14, /* SIGALRM (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_TERM = 15, /* SIGTERM (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_STKFLT = 16, /* Not in POSIX (SIGSTKFLT on Linux (Since: 1.0.1) )*/
+ VIR_DOMAIN_PROCESS_SIGNAL_CHLD = 17, /* SIGCHLD (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_CONT = 18, /* SIGCONT (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_STOP = 19, /* SIGSTOP (Since: 1.0.1) */
+
+ VIR_DOMAIN_PROCESS_SIGNAL_TSTP = 20, /* SIGTSTP (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_TTIN = 21, /* SIGTTIN (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_TTOU = 22, /* SIGTTOU (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_URG = 23, /* SIGURG (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_XCPU = 24, /* SIGXCPU (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_XFSZ = 25, /* SIGXFSZ (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_VTALRM = 26, /* SIGVTALRM (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_PROF = 27, /* SIGPROF (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_WINCH = 28, /* Not in POSIX (SIGWINCH on Linux) (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_POLL = 29, /* SIGPOLL (also known as SIGIO on Linux) (Since: 1.0.1) */
+
+ VIR_DOMAIN_PROCESS_SIGNAL_PWR = 30, /* Not in POSIX (SIGPWR on Linux) (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_SYS = 31, /* SIGSYS (also known as SIGUNUSED on Linux) (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT0 = 32, /* SIGRTMIN (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT1 = 33, /* SIGRTMIN + 1 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT2 = 34, /* SIGRTMIN + 2 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT3 = 35, /* SIGRTMIN + 3 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT4 = 36, /* SIGRTMIN + 4 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT5 = 37, /* SIGRTMIN + 5 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT6 = 38, /* SIGRTMIN + 6 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT7 = 39, /* SIGRTMIN + 7 (Since: 1.0.1) */
+
+ VIR_DOMAIN_PROCESS_SIGNAL_RT8 = 40, /* SIGRTMIN + 8 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT9 = 41, /* SIGRTMIN + 9 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT10 = 42, /* SIGRTMIN + 10 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT11 = 43, /* SIGRTMIN + 11 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT12 = 44, /* SIGRTMIN + 12 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT13 = 45, /* SIGRTMIN + 13 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT14 = 46, /* SIGRTMIN + 14 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT15 = 47, /* SIGRTMIN + 15 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT16 = 48, /* SIGRTMIN + 16 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT17 = 49, /* SIGRTMIN + 17 (Since: 1.0.1) */
+
+ VIR_DOMAIN_PROCESS_SIGNAL_RT18 = 50, /* SIGRTMIN + 18 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT19 = 51, /* SIGRTMIN + 19 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT20 = 52, /* SIGRTMIN + 20 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT21 = 53, /* SIGRTMIN + 21 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT22 = 54, /* SIGRTMIN + 22 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT23 = 55, /* SIGRTMIN + 23 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT24 = 56, /* SIGRTMIN + 24 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT25 = 57, /* SIGRTMIN + 25 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT26 = 58, /* SIGRTMIN + 26 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT27 = 59, /* SIGRTMIN + 27 (Since: 1.0.1) */
+
+ VIR_DOMAIN_PROCESS_SIGNAL_RT28 = 60, /* SIGRTMIN + 28 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT29 = 61, /* SIGRTMIN + 29 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT30 = 62, /* SIGRTMIN + 30 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT31 = 63, /* SIGRTMIN + 31 (Since: 1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_RT32 = 64, /* SIGRTMIN + 32 / SIGRTMAX (Since: 1.0.1) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_PROCESS_SIGNAL_LAST /* (Since: v1.0.1) */
+ VIR_DOMAIN_PROCESS_SIGNAL_LAST /* (Since: 1.0.1) */
# endif
} virDomainProcessSignal;
@@ -3663,21 +3663,21 @@ virDomainPtr virDomainCreateLinux (virConnectPtr conn,
*
* a virDomainEventType is emitted during domain lifecycle events
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_DEFINED = 0, /* (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_UNDEFINED = 1, /* (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STARTED = 2, /* (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_SUSPENDED = 3, /* (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_RESUMED = 4, /* (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED = 5, /* (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_SHUTDOWN = 6, /* (Since: v0.9.8) */
- VIR_DOMAIN_EVENT_PMSUSPENDED = 7, /* (Since: v0.10.2) */
- VIR_DOMAIN_EVENT_CRASHED = 8, /* (Since: v1.1.1) */
+ VIR_DOMAIN_EVENT_DEFINED = 0, /* (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_UNDEFINED = 1, /* (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STARTED = 2, /* (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_SUSPENDED = 3, /* (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_RESUMED = 4, /* (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED = 5, /* (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_SHUTDOWN = 6, /* (Since: 0.9.8) */
+ VIR_DOMAIN_EVENT_PMSUSPENDED = 7, /* (Since: 0.10.2) */
+ VIR_DOMAIN_EVENT_CRASHED = 8, /* (Since: 1.1.1) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventType;
@@ -3686,16 +3686,16 @@ typedef enum {
*
* Details on the cause of a 'defined' lifecycle event
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_DEFINED_ADDED = 0, /* Newly created config file (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_DEFINED_UPDATED = 1, /* Changed config file (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_DEFINED_RENAMED = 2, /* Domain was renamed (Since: v1.2.19) */
- VIR_DOMAIN_EVENT_DEFINED_FROM_SNAPSHOT = 3, /* Config was restored from a snapshot (Since: v1.3.3) */
+ VIR_DOMAIN_EVENT_DEFINED_ADDED = 0, /* Newly created config file (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_DEFINED_UPDATED = 1, /* Changed config file (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_DEFINED_RENAMED = 2, /* Domain was renamed (Since: 1.2.19) */
+ VIR_DOMAIN_EVENT_DEFINED_FROM_SNAPSHOT = 3, /* Config was restored from a snapshot (Since: 1.3.3) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_DEFINED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_DEFINED_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventDefinedDetailType;
@@ -3704,14 +3704,14 @@ typedef enum {
*
* Details on the cause of an 'undefined' lifecycle event
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = 0, /* Deleted the config file (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_UNDEFINED_RENAMED = 1, /* Domain was renamed (Since: v1.2.19) */
+ VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = 0, /* Deleted the config file (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_UNDEFINED_RENAMED = 1, /* Domain was renamed (Since: 1.2.19) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_UNDEFINED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_UNDEFINED_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventUndefinedDetailType;
@@ -3720,17 +3720,17 @@ typedef enum {
*
* Details on the cause of a 'started' lifecycle event
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_STARTED_BOOTED = 0, /* Normal startup from boot (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STARTED_MIGRATED = 1, /* Incoming migration from another host (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STARTED_RESTORED = 2, /* Restored from a state file (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOT = 3, /* Restored from snapshot (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_STARTED_WAKEUP = 4, /* Started due to wakeup event (Since: v0.9.11) */
+ VIR_DOMAIN_EVENT_STARTED_BOOTED = 0, /* Normal startup from boot (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STARTED_MIGRATED = 1, /* Incoming migration from another host (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STARTED_RESTORED = 2, /* Restored from a state file (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOT = 3, /* Restored from snapshot (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_STARTED_WAKEUP = 4, /* Started due to wakeup event (Since: 0.9.11) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_STARTED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_STARTED_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventStartedDetailType;
@@ -3739,21 +3739,21 @@ typedef enum {
*
* Details on the cause of a 'suspended' lifecycle event
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_SUSPENDED_PAUSED = 0, /* Normal suspend due to admin pause (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED = 1, /* Suspended for offline migration (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_SUSPENDED_IOERROR = 2, /* Suspended due to a disk I/O error (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG = 3, /* Suspended due to a watchdog firing (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_SUSPENDED_RESTORED = 4, /* Restored from paused state file (Since: v0.9.5) */
- VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT = 5, /* Restored from paused snapshot (Since: v0.9.5) */
- VIR_DOMAIN_EVENT_SUSPENDED_API_ERROR = 6, /* suspended after failure during libvirt API call (Since: v1.0.1) */
- VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY = 7, /* suspended for post-copy migration (Since: v1.3.3) */
- VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY_FAILED = 8, /* suspended after failed post-copy (Since: v1.3.3) */
+ VIR_DOMAIN_EVENT_SUSPENDED_PAUSED = 0, /* Normal suspend due to admin pause (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED = 1, /* Suspended for offline migration (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_SUSPENDED_IOERROR = 2, /* Suspended due to a disk I/O error (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG = 3, /* Suspended due to a watchdog firing (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_SUSPENDED_RESTORED = 4, /* Restored from paused state file (Since: 0.9.5) */
+ VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT = 5, /* Restored from paused snapshot (Since: 0.9.5) */
+ VIR_DOMAIN_EVENT_SUSPENDED_API_ERROR = 6, /* suspended after failure during libvirt API call (Since: 1.0.1) */
+ VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY = 7, /* suspended for post-copy migration (Since: 1.3.3) */
+ VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY_FAILED = 8, /* suspended after failed post-copy (Since: 1.3.3) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_SUSPENDED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_SUSPENDED_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventSuspendedDetailType;
@@ -3762,17 +3762,17 @@ typedef enum {
*
* Details on the cause of a 'resumed' lifecycle event
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_RESUMED_UNPAUSED = 0, /* Normal resume due to admin unpause (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_RESUMED_MIGRATED = 1, /* Resumed for completion of migration (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT = 2, /* Resumed from snapshot (Since: v0.9.5) */
+ VIR_DOMAIN_EVENT_RESUMED_UNPAUSED = 0, /* Normal resume due to admin unpause (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_RESUMED_MIGRATED = 1, /* Resumed for completion of migration (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT = 2, /* Resumed from snapshot (Since: 0.9.5) */
VIR_DOMAIN_EVENT_RESUMED_POSTCOPY = 3, /* Resumed, but migration is still
- running in post-copy mode (Since: v1.3.3) */
+ running in post-copy mode (Since: 1.3.3) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_RESUMED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_RESUMED_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventResumedDetailType;
@@ -3781,19 +3781,19 @@ typedef enum {
*
* Details on the cause of a 'stopped' lifecycle event
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN = 0, /* Normal shutdown (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED_DESTROYED = 1, /* Forced poweroff from host (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED_CRASHED = 2, /* Guest crashed (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED_MIGRATED = 3, /* Migrated off to another host (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED_SAVED = 4, /* Saved to a state file (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED_FAILED = 5, /* Host emulator/mgmt failed (Since: v0.5.0) */
- VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT = 6, /* offline snapshot loaded (Since: v0.8.0) */
+ VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN = 0, /* Normal shutdown (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED_DESTROYED = 1, /* Forced poweroff from host (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED_CRASHED = 2, /* Guest crashed (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED_MIGRATED = 3, /* Migrated off to another host (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED_SAVED = 4, /* Saved to a state file (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED_FAILED = 5, /* Host emulator/mgmt failed (Since: 0.5.0) */
+ VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT = 6, /* offline snapshot loaded (Since: 0.8.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_STOPPED_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_STOPPED_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventStoppedDetailType;
@@ -3803,25 +3803,25 @@ typedef enum {
*
* Details on the cause of a 'shutdown' lifecycle event
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
typedef enum {
- /* Guest finished shutdown sequence (Since: v0.9.8) */
+ /* Guest finished shutdown sequence (Since: 0.9.8) */
VIR_DOMAIN_EVENT_SHUTDOWN_FINISHED = 0,
/* Domain finished shutting down after request from the guest itself
- * (e.g. hardware-specific action) (Since: v3.4.0) */
+ * (e.g. hardware-specific action) (Since: 3.4.0) */
VIR_DOMAIN_EVENT_SHUTDOWN_GUEST = 1,
/* Domain finished shutting down after request from the host (e.g. killed by
* a signal)
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
VIR_DOMAIN_EVENT_SHUTDOWN_HOST = 2,
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_SHUTDOWN_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_SHUTDOWN_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventShutdownDetailType;
@@ -3830,14 +3830,14 @@ typedef enum {
*
* Details on the cause of a 'pmsuspended' lifecycle event
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY = 0, /* Guest was PM suspended to memory (Since: v0.10.2) */
- VIR_DOMAIN_EVENT_PMSUSPENDED_DISK = 1, /* Guest was PM suspended to disk (Since: v1.0.0) */
+ VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY = 0, /* Guest was PM suspended to memory (Since: 0.10.2) */
+ VIR_DOMAIN_EVENT_PMSUSPENDED_DISK = 1, /* Guest was PM suspended to disk (Since: 1.0.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_PMSUSPENDED_LAST /* (Since: v0.10.2) */
+ VIR_DOMAIN_EVENT_PMSUSPENDED_LAST /* (Since: 0.10.2) */
# endif
} virDomainEventPMSuspendedDetailType;
@@ -3846,14 +3846,14 @@ typedef enum {
*
* Details on the cause of a 'crashed' lifecycle event
*
- * Since: v1.1.1
+ * Since: 1.1.1
*/
typedef enum {
- VIR_DOMAIN_EVENT_CRASHED_PANICKED = 0, /* Guest was panicked (Since: v1.1.1) */
- VIR_DOMAIN_EVENT_CRASHED_CRASHLOADED = 1, /* Guest was crashloaded (Since: v6.1.0) */
+ VIR_DOMAIN_EVENT_CRASHED_PANICKED = 0, /* Guest was panicked (Since: 1.1.1) */
+ VIR_DOMAIN_EVENT_CRASHED_CRASHLOADED = 1, /* Guest was crashloaded (Since: 6.1.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_CRASHED_LAST /* (Since: v1.1.1) */
+ VIR_DOMAIN_EVENT_CRASHED_LAST /* (Since: 1.1.1) */
# endif
} virDomainEventCrashedDetailType;
@@ -3862,17 +3862,17 @@ typedef enum {
*
* Recipient of a memory failure event.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
typedef enum {
- /* memory failure at hypersivor memory address space (Since: v6.9.0) */
+ /* memory failure at hypersivor memory address space (Since: 6.9.0) */
VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_HYPERVISOR = 0,
- /* memory failure at guest memory address space (Since: v6.9.0) */
+ /* memory failure at guest memory address space (Since: 6.9.0) */
VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_GUEST = 1,
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_LAST /* (Since: v6.9.0) */
+ VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_LAST /* (Since: 6.9.0) */
# endif
} virDomainMemoryFailureRecipientType;
@@ -3882,13 +3882,13 @@ typedef enum {
*
* Action of a memory failure event.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
typedef enum {
/* the memory failure could be ignored. This will only be the case for
* action-optional failures.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_IGNORE = 0,
@@ -3896,26 +3896,26 @@ typedef enum {
* mechanism, and hypervisor could inject the MCE into the guest
* successfully.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_INJECT = 1,
/* the failure is unrecoverable. This occurs for action-required failures
* if the recipient is the hypervisor; hypervisor will exit.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_FATAL = 2,
/* the failure is unrecoverable but confined to the guest. This occurs if
* the recipient is a guest which is not ready to handle memory failures.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_RESET = 3,
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_LAST /* (Since: v6.9.0) */
+ VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_LAST /* (Since: 6.9.0) */
# endif
} virDomainMemoryFailureActionType;
@@ -3923,17 +3923,17 @@ typedef enum {
/**
* virDomainMemoryFailureFlags:
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
typedef enum {
/* whether a memory failure event is action-required or action-optional
- * (e.g. a failure during memory scrub). (Since: v6.9.0) */
+ * (e.g. a failure during memory scrub). (Since: 6.9.0) */
VIR_DOMAIN_MEMORY_FAILURE_ACTION_REQUIRED = (1 << 0),
/* whether the failure occurred while the previous failure was still in
* progress.
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
VIR_DOMAIN_MEMORY_FAILURE_RECURSIVE = (1 << 1),
} virDomainMemoryFailureFlags;
@@ -3951,7 +3951,7 @@ typedef enum {
*
* Returns 0 (the return value is currently ignored)
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef int (*virConnectDomainEventCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -3975,32 +3975,32 @@ int virDomainIsUpdated(virDomainPtr dom);
/**
* virDomainJobType:
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
typedef enum {
- VIR_DOMAIN_JOB_NONE = 0, /* No job is active (Since: v0.7.7) */
- VIR_DOMAIN_JOB_BOUNDED = 1, /* Job with a finite completion time (Since: v0.7.7) */
- VIR_DOMAIN_JOB_UNBOUNDED = 2, /* Job without a finite completion time (Since: v0.7.7) */
- VIR_DOMAIN_JOB_COMPLETED = 3, /* Job has finished, but isn't cleaned up (Since: v0.7.7) */
- VIR_DOMAIN_JOB_FAILED = 4, /* Job hit error, but isn't cleaned up (Since: v0.7.7) */
- VIR_DOMAIN_JOB_CANCELLED = 5, /* Job was aborted, but isn't cleaned up (Since: v0.7.7) */
+ VIR_DOMAIN_JOB_NONE = 0, /* No job is active (Since: 0.7.7) */
+ VIR_DOMAIN_JOB_BOUNDED = 1, /* Job with a finite completion time (Since: 0.7.7) */
+ VIR_DOMAIN_JOB_UNBOUNDED = 2, /* Job without a finite completion time (Since: 0.7.7) */
+ VIR_DOMAIN_JOB_COMPLETED = 3, /* Job has finished, but isn't cleaned up (Since: 0.7.7) */
+ VIR_DOMAIN_JOB_FAILED = 4, /* Job hit error, but isn't cleaned up (Since: 0.7.7) */
+ VIR_DOMAIN_JOB_CANCELLED = 5, /* Job was aborted, but isn't cleaned up (Since: 0.7.7) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_JOB_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_JOB_LAST /* (Since: 0.9.10) */
# endif
} virDomainJobType;
/**
* virDomainJobInfo:
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
typedef struct _virDomainJobInfo virDomainJobInfo;
/**
* virDomainJobInfoPtr:
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
typedef virDomainJobInfo *virDomainJobInfoPtr;
struct _virDomainJobInfo {
@@ -4043,13 +4043,13 @@ struct _virDomainJobInfo {
* Flags OR'ed together to provide specific behavior when querying domain
* job statistics.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
typedef enum {
VIR_DOMAIN_JOB_STATS_COMPLETED = 1 << 0, /* return stats of a recently
- * completed job (Since: v1.2.9) */
+ * completed job (Since: 1.2.9) */
VIR_DOMAIN_JOB_STATS_KEEP_COMPLETED = 1 << 1, /* don't remove completed
- stats when reading them (Since: v6.0.0) */
+ stats when reading them (Since: 6.0.0) */
} virDomainGetJobStatsFlags;
int virDomainGetJobInfo(virDomainPtr dom,
@@ -4064,22 +4064,22 @@ int virDomainAbortJob(virDomainPtr dom);
/**
* virDomainJobOperation:
*
- * Since: v3.3.0
+ * Since: 3.3.0
*/
typedef enum {
- VIR_DOMAIN_JOB_OPERATION_UNKNOWN = 0, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_START = 1, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_SAVE = 2, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_RESTORE = 3, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_MIGRATION_IN = 4, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_MIGRATION_OUT = 5, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_SNAPSHOT = 6, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_SNAPSHOT_REVERT = 7, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_DUMP = 8, /* (Since: v3.3.0) */
- VIR_DOMAIN_JOB_OPERATION_BACKUP = 9, /* (Since: v6.0.0) */
+ VIR_DOMAIN_JOB_OPERATION_UNKNOWN = 0, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_START = 1, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_SAVE = 2, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_RESTORE = 3, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_MIGRATION_IN = 4, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_MIGRATION_OUT = 5, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_SNAPSHOT = 6, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_SNAPSHOT_REVERT = 7, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_DUMP = 8, /* (Since: 3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_BACKUP = 9, /* (Since: 6.0.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_JOB_OPERATION_LAST /* (Since: v3.3.0) */
+ VIR_DOMAIN_JOB_OPERATION_LAST /* (Since: 3.3.0) */
# endif
} virDomainJobOperation;
@@ -4090,7 +4090,7 @@ typedef enum {
* VIR_TYPED_PARAM_INT. The values correspond to the items in
* virDomainJobOperation enum.
*
- * Since: v3.3.0
+ * Since: 3.3.0
*/
# define VIR_DOMAIN_JOB_OPERATION "operation"
@@ -4102,7 +4102,7 @@ typedef enum {
*
* This field corresponds to timeElapsed field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_TIME_ELAPSED "time_elapsed"
@@ -4114,7 +4114,7 @@ typedef enum {
* flow from the source host to the destination host,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.15
+ * Since: 1.2.15
*/
# define VIR_DOMAIN_JOB_TIME_ELAPSED_NET "time_elapsed_net"
@@ -4126,7 +4126,7 @@ typedef enum {
*
* This field corresponds to timeRemaining field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_TIME_REMAINING "time_remaining"
@@ -4138,7 +4138,7 @@ typedef enum {
* between the time guest CPUs were paused and the time they were resumed
* is reported for completed migration.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DOWNTIME "downtime"
@@ -4149,7 +4149,7 @@ typedef enum {
* the time required to transfer control flow from the source host to the
* destination host, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.15
+ * Since: 1.2.15
*/
# define VIR_DOMAIN_JOB_DOWNTIME_NET "downtime_net"
@@ -4160,7 +4160,7 @@ typedef enum {
* the migration in the 'setup' phase before the iterations begin, as
* VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_JOB_SETUP_TIME "setup_time"
@@ -4177,7 +4177,7 @@ typedef enum {
*
* This field corresponds to dataTotal field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DATA_TOTAL "data_total"
@@ -4189,7 +4189,7 @@ typedef enum {
*
* This field corresponds to dataProcessed field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DATA_PROCESSED "data_processed"
@@ -4201,7 +4201,7 @@ typedef enum {
*
* This field corresponds to dataRemaining field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DATA_REMAINING "data_remaining"
@@ -4213,7 +4213,7 @@ typedef enum {
*
* This field corresponds to memTotal field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_MEMORY_TOTAL "memory_total"
@@ -4225,7 +4225,7 @@ typedef enum {
*
* This field corresponds to memProcessed field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_MEMORY_PROCESSED "memory_processed"
@@ -4237,7 +4237,7 @@ typedef enum {
*
* This field corresponds to memRemaining field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_MEMORY_REMAINING "memory_remaining"
@@ -4251,7 +4251,7 @@ typedef enum {
* The most common example of such pages are zero pages, i.e., pages filled
* with zero bytes.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_MEMORY_CONSTANT "memory_constant"
@@ -4263,7 +4263,7 @@ typedef enum {
* byte and which could not be compressed) transferred since the beginning
* of the migration job, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_MEMORY_NORMAL "memory_normal"
@@ -4275,7 +4275,7 @@ typedef enum {
*
* See VIR_DOMAIN_JOB_MEMORY_NORMAL for more details.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_MEMORY_NORMAL_BYTES "memory_normal_bytes"
@@ -4285,7 +4285,7 @@ typedef enum {
* virDomainGetJobStats field: network throughput used while migrating
* memory in Bytes per second, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_JOB_MEMORY_BPS "memory_bps"
@@ -4295,7 +4295,7 @@ typedef enum {
* per second, as VIR_TYPED_PARAM_ULLONG. This statistics makes sense only
* when live migration is running.
*
- * Since: v1.3.1
+ * Since: 1.3.1
*/
# define VIR_DOMAIN_JOB_MEMORY_DIRTY_RATE "memory_dirty_rate"
@@ -4308,7 +4308,7 @@ typedef enum {
* VIR_DOMAIN_JOB_MEMORY_DIRTY_RATE or VIR_DOMAIN_JOB_COMPRESSION_PAGES
* to bytes.
*
- * Since: v3.9.0
+ * Since: 3.9.0
*/
# define VIR_DOMAIN_JOB_MEMORY_PAGE_SIZE "memory_page_size"
@@ -4321,7 +4321,7 @@ typedef enum {
* every time a new iteration is started to transfer memory pages dirtied
* since the last iteration.
*
- * Since: v1.3.1
+ * Since: 1.3.1
*/
# define VIR_DOMAIN_JOB_MEMORY_ITERATION "memory_iteration"
@@ -4333,7 +4333,7 @@ typedef enum {
* This counter is incremented whenever the migrated domain tries to access
* a memory page which has not been transferred from the source host yet.
*
- * Since: v5.0.0
+ * Since: 5.0.0
*/
# define VIR_DOMAIN_JOB_MEMORY_POSTCOPY_REQS "memory_postcopy_requests"
@@ -4345,7 +4345,7 @@ typedef enum {
*
* This field corresponds to fileTotal field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DISK_TOTAL "disk_total"
@@ -4357,7 +4357,7 @@ typedef enum {
*
* This field corresponds to fileProcessed field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DISK_PROCESSED "disk_processed"
@@ -4369,7 +4369,7 @@ typedef enum {
*
* This field corresponds to fileRemaining field in virDomainJobInfo.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_DISK_REMAINING "disk_remaining"
@@ -4379,7 +4379,7 @@ typedef enum {
* virDomainGetJobStats field: network throughput used while migrating
* disks in Bytes per second, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_JOB_DISK_BPS "disk_bps"
@@ -4390,7 +4390,7 @@ typedef enum {
* compressing repeatedly transferred memory pages during live migration,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_COMPRESSION_CACHE "compression_cache"
@@ -4400,7 +4400,7 @@ typedef enum {
* virDomainGetJobStats field: number of compressed bytes transferred
* since the beginning of migration, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_COMPRESSION_BYTES "compression_bytes"
@@ -4410,7 +4410,7 @@ typedef enum {
* virDomainGetJobStats field: number of compressed pages transferred
* since the beginning of migration, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_COMPRESSION_PAGES "compression_pages"
@@ -4421,7 +4421,7 @@ typedef enum {
* were not found in compression cache and thus could not be compressed,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_COMPRESSION_CACHE_MISSES "compression_cache_misses"
@@ -4433,7 +4433,7 @@ typedef enum {
* the result of compression was larger than the original page as a whole,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
# define VIR_DOMAIN_JOB_COMPRESSION_OVERFLOW "compression_overflow"
@@ -4444,7 +4444,7 @@ typedef enum {
* to when auto-convergence decided migration was not converging, as
* VIR_TYPED_PARAM_INT.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_DOMAIN_JOB_AUTO_CONVERGE_THROTTLE "auto_converge_throttle"
@@ -4454,7 +4454,7 @@ typedef enum {
* virDomainGetJobStats field: Present only in statistics for a completed job.
* Successful completion of the job as VIR_TYPED_PARAM_BOOLEAN.
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
# define VIR_DOMAIN_JOB_SUCCESS "success"
@@ -4464,7 +4464,7 @@ typedef enum {
* virDomainGetJobStats field: Present only in statistics for a completed job.
* Optional error message for a failed job.
*
- * Since: v6.3.0
+ * Since: 6.3.0
*/
# define VIR_DOMAIN_JOB_ERRMSG "errmsg"
@@ -4474,7 +4474,7 @@ typedef enum {
* virDomainGetJobStats field: current usage of temporary disk space for the
* job in bytes as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
# define VIR_DOMAIN_JOB_DISK_TEMP_USED "disk_temp_used"
@@ -4483,7 +4483,7 @@ typedef enum {
* virDomainGetJobStats field: possible total temporary disk space for the
* job in bytes as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
# define VIR_DOMAIN_JOB_DISK_TEMP_TOTAL "disk_temp_total"
@@ -4499,7 +4499,7 @@ typedef enum {
* passed in a different parameter position; use VIR_DOMAIN_EVENT_CALLBACK()
* when registering an appropriate handler.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef void (*virConnectDomainEventGenericCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4515,7 +4515,7 @@ typedef void (*virConnectDomainEventGenericCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_RTC_CHANGE with virConnectDomainEventRegisterAny()
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef void (*virConnectDomainEventRTCChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4527,19 +4527,19 @@ typedef void (*virConnectDomainEventRTCChangeCallback)(virConnectPtr conn,
*
* The action that is to be taken due to the watchdog device firing
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_WATCHDOG_NONE = 0, /* No action, watchdog ignored (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_WATCHDOG_PAUSE, /* Guest CPUs are paused (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_WATCHDOG_RESET, /* Guest CPUs are reset (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF, /* Guest is forcibly powered off (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWN, /* Guest is requested to gracefully shutdown (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_WATCHDOG_DEBUG, /* No action, a debug message logged (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_WATCHDOG_INJECTNMI,/* Inject a non-maskable interrupt into guest (Since: v1.2.17) */
+ VIR_DOMAIN_EVENT_WATCHDOG_NONE = 0, /* No action, watchdog ignored (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_WATCHDOG_PAUSE, /* Guest CPUs are paused (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_WATCHDOG_RESET, /* Guest CPUs are reset (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF, /* Guest is forcibly powered off (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWN, /* Guest is requested to gracefully shutdown (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_WATCHDOG_DEBUG, /* No action, a debug message logged (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_WATCHDOG_INJECTNMI,/* Inject a non-maskable interrupt into guest (Since: 1.2.17) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_WATCHDOG_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_WATCHDOG_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventWatchdogAction;
@@ -4553,7 +4553,7 @@ typedef enum {
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_WATCHDOG with virConnectDomainEventRegisterAny()
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef void (*virConnectDomainEventWatchdogCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4565,15 +4565,15 @@ typedef void (*virConnectDomainEventWatchdogCallback)(virConnectPtr conn,
*
* The action that is to be taken due to an IO error occurring
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_IO_ERROR_NONE = 0, /* No action, IO error ignored (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_IO_ERROR_PAUSE, /* Guest CPUs are paused (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_IO_ERROR_REPORT, /* IO error reported to guest OS (Since: v0.8.0) */
+ VIR_DOMAIN_EVENT_IO_ERROR_NONE = 0, /* No action, IO error ignored (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_IO_ERROR_PAUSE, /* Guest CPUs are paused (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_IO_ERROR_REPORT, /* IO error reported to guest OS (Since: 0.8.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_IO_ERROR_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_IO_ERROR_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventIOErrorAction;
@@ -4590,7 +4590,7 @@ typedef enum {
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_IO_ERROR with virConnectDomainEventRegisterAny()
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef void (*virConnectDomainEventIOErrorCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4618,7 +4618,7 @@ typedef void (*virConnectDomainEventIOErrorCallback)(virConnectPtr conn,
* Otherwise, @reason will be "", although future strings may be added
* if determination of other error types becomes possible.
*
- * Since: v0.8.1
+ * Since: 0.8.1
*/
typedef void (*virConnectDomainEventIOErrorReasonCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4633,15 +4633,15 @@ typedef void (*virConnectDomainEventIOErrorReasonCallback)(virConnectPtr conn,
*
* The phase of the graphics client connection
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = 0, /* Initial socket connection established (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE, /* Authentication & setup completed (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECT, /* Final socket disconnection (Since: v0.8.0) */
+ VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = 0, /* Initial socket connection established (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE, /* Authentication & setup completed (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECT, /* Final socket disconnection (Since: 0.8.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_GRAPHICS_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_GRAPHICS_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventGraphicsPhase;
@@ -4650,15 +4650,15 @@ typedef enum {
*
* The type of address for the connection
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6, /* IPv6 address (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX, /* UNIX socket path (Since: v0.9.7) */
+ VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6, /* IPv6 address (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX, /* UNIX socket path (Since: 0.9.7) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_LAST /* (Since: 0.9.10) */
# endif
} virDomainEventGraphicsAddressType;
@@ -4668,7 +4668,7 @@ typedef enum {
*
* The data structure containing connection address details
*
- * Since: v1.0.0
+ * Since: 1.0.0
*/
struct _virDomainEventGraphicsAddress {
int family; /* Address family, virDomainEventGraphicsAddressType */
@@ -4679,14 +4679,14 @@ struct _virDomainEventGraphicsAddress {
/**
* virDomainEventGraphicsAddress:
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef struct _virDomainEventGraphicsAddress virDomainEventGraphicsAddress;
/**
* virDomainEventGraphicsAddressPtr:
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef virDomainEventGraphicsAddress *virDomainEventGraphicsAddressPtr;
@@ -4707,14 +4707,14 @@ struct _virDomainEventGraphicsSubjectIdentity {
/**
* virDomainEventGraphicsSubjectIdentity:
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef struct _virDomainEventGraphicsSubjectIdentity virDomainEventGraphicsSubjectIdentity;
/**
* virDomainEventGraphicsSubjectIdentityPtr:
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef virDomainEventGraphicsSubjectIdentity *virDomainEventGraphicsSubjectIdentityPtr;
@@ -4727,7 +4727,7 @@ typedef virDomainEventGraphicsSubjectIdentity *virDomainEventGraphicsSubjectIden
* A subject will have zero or more identities. The types of
* identity differ according to the authentication scheme
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
struct _virDomainEventGraphicsSubject {
int nidentity; /* Number of identities in array*/
@@ -4737,14 +4737,14 @@ struct _virDomainEventGraphicsSubject {
/**
* virDomainEventGraphicsSubject:
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef struct _virDomainEventGraphicsSubject virDomainEventGraphicsSubject;
/**
* virDomainEventGraphicsSubjectPtr:
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef virDomainEventGraphicsSubject *virDomainEventGraphicsSubjectPtr;
@@ -4763,7 +4763,7 @@ typedef virDomainEventGraphicsSubject *virDomainEventGraphicsSubjectPtr;
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_GRAPHICS with virConnectDomainEventRegisterAny()
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef void (*virConnectDomainEventGraphicsCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4780,16 +4780,16 @@ typedef void (*virConnectDomainEventGraphicsCallback)(virConnectPtr conn,
* Tracks status of a virDomainBlockPull(), virDomainBlockRebase(),
* virDomainBlockCopy(), or virDomainBlockCommit() operation
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef enum {
- VIR_DOMAIN_BLOCK_JOB_COMPLETED = 0, /* (Since: v0.9.4) */
- VIR_DOMAIN_BLOCK_JOB_FAILED = 1, /* (Since: v0.9.4) */
- VIR_DOMAIN_BLOCK_JOB_CANCELED = 2, /* (Since: v0.9.12) */
- VIR_DOMAIN_BLOCK_JOB_READY = 3, /* (Since: v1.0.0) */
+ VIR_DOMAIN_BLOCK_JOB_COMPLETED = 0, /* (Since: 0.9.4) */
+ VIR_DOMAIN_BLOCK_JOB_FAILED = 1, /* (Since: 0.9.4) */
+ VIR_DOMAIN_BLOCK_JOB_CANCELED = 2, /* (Since: 0.9.12) */
+ VIR_DOMAIN_BLOCK_JOB_READY = 3, /* (Since: 1.0.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_BLOCK_JOB_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_BLOCK_JOB_LAST /* (Since: 0.9.10) */
# endif
} virConnectDomainEventBlockJobStatus;
@@ -4817,7 +4817,7 @@ typedef enum {
* then @disk will contain the device target shorthand (the <target
* dev='...'/> sub-element, such as "vda").
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4831,25 +4831,25 @@ typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn,
*
* The reason describing why this callback is called
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
typedef enum {
/* Removable media changed to empty according to startup policy as source
* was missing. oldSrcPath is set, newSrcPath is NULL
*
- * Since: v0.9.7
+ * Since: 0.9.7
* */
VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START = 0,
/* Disk was dropped from domain as source file was missing.
* oldSrcPath is set, newSrcPath is NULL
*
- * Since: v1.1.2
+ * Since: 1.1.2
* */
VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START = 1,
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_DISK_CHANGE_LAST /* (Since: v0.9.10) */
+ VIR_DOMAIN_EVENT_DISK_CHANGE_LAST /* (Since: 0.9.10) */
# endif
} virConnectDomainEventDiskChangeReason;
@@ -4872,7 +4872,7 @@ typedef enum {
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DISK_CHANGE with virConnectDomainEventRegisterAny()
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
typedef void (*virConnectDomainEventDiskChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4887,14 +4887,14 @@ typedef void (*virConnectDomainEventDiskChangeCallback)(virConnectPtr conn,
*
* The reason describing why the callback was called
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef enum {
- VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN = 0, /* (Since: v0.9.11) */
- VIR_DOMAIN_EVENT_TRAY_CHANGE_CLOSE, /* (Since: v0.9.11) */
+ VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN = 0, /* (Since: 0.9.11) */
+ VIR_DOMAIN_EVENT_TRAY_CHANGE_CLOSE, /* (Since: 0.9.11) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_EVENT_TRAY_CHANGE_LAST /* (Since: v0.9.11) */
+ VIR_DOMAIN_EVENT_TRAY_CHANGE_LAST /* (Since: 0.9.11) */
# endif
} virDomainEventTrayChangeReason;
@@ -4911,7 +4911,7 @@ typedef enum {
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_TRAY_CHANGE with virConnectDomainEventRegisterAny()
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef void (*virConnectDomainEventTrayChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4932,7 +4932,7 @@ typedef void (*virConnectDomainEventTrayChangeCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_PMWAKEUP with virConnectDomainEventRegisterAny()
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef void (*virConnectDomainEventPMWakeupCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4952,7 +4952,7 @@ typedef void (*virConnectDomainEventPMWakeupCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_PMSUSPEND with virConnectDomainEventRegisterAny()
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef void (*virConnectDomainEventPMSuspendCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4970,7 +4970,7 @@ typedef void (*virConnectDomainEventPMSuspendCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE with virConnectDomainEventRegisterAny()
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
typedef void (*virConnectDomainEventBalloonChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -4990,7 +4990,7 @@ typedef void (*virConnectDomainEventBalloonChangeCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK with virConnectDomainEventRegisterAny()
*
- * Since: v1.0.0
+ * Since: 1.0.0
*/
typedef void (*virConnectDomainEventPMSuspendDiskCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5009,7 +5009,7 @@ typedef void (*virConnectDomainEventPMSuspendDiskCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED with virConnectDomainEventRegisterAny()
*
- * Since: v1.1.1
+ * Since: 1.1.1
*/
typedef void (*virConnectDomainEventDeviceRemovedCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5028,7 +5028,7 @@ typedef void (*virConnectDomainEventDeviceRemovedCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_DEVICE_ADDED with virConnectDomainEventRegisterAny()
*
- * Since: v1.2.15
+ * Since: 1.2.15
*/
typedef void (*virConnectDomainEventDeviceAddedCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5049,7 +5049,7 @@ typedef void (*virConnectDomainEventDeviceAddedCallback)(virConnectPtr conn,
* VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED with
* virConnectDomainEventRegisterAny().
*
- * Since: v1.3.4
+ * Since: 1.3.4
*/
typedef void (*virConnectDomainEventDeviceRemovalFailedCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5069,7 +5069,7 @@ typedef void (*virConnectDomainEventDeviceRemovalFailedCallback)(virConnectPtr c
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_METADATA_CHANGE with virConnectDomainEventRegisterAny().
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
typedef void (*virConnectDomainEventMetadataChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5094,7 +5094,7 @@ typedef void (*virConnectDomainEventMetadataChangeCallback)(virConnectPtr conn,
* VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION with
* virConnectDomainEventRegisterAny().
*
- * Since: v1.3.2
+ * Since: 1.3.2
*/
typedef void (*virConnectDomainEventMigrationIterationCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5120,7 +5120,7 @@ typedef void (*virConnectDomainEventMigrationIterationCallback)(virConnectPtr co
* VIR_DOMAIN_EVENT_ID_JOB_COMPLETED with
* virConnectDomainEventRegisterAny().
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5135,7 +5135,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* appended to the parameter name, for example "cputune.vcpupin1",
* as VIR_TYPED_PARAM_STRING.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_VCPUPIN "cputune.vcpupin%u"
@@ -5145,7 +5145,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents formatted pinning for emulator process,
* as VIR_TYPED_PARAM_STRING.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_EMULATORPIN "cputune.emulatorpin"
@@ -5156,7 +5156,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* appended to the parameter name, for example "cputune.iothreadpin1",
* as VIR_TYPED_PARAM_STRING.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
# define VIR_DOMAIN_TUNABLE_CPU_IOTHREADSPIN "cputune.iothreadpin%u"
@@ -5166,7 +5166,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents proportional weight of the scheduler used on the
* host cpu, when using the posix scheduler, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_CPU_SHARES "cputune.cpu_shares"
@@ -5176,7 +5176,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the enforcement period for a quota, in microseconds,
* for whole domain, when using the posix scheduler, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
# define VIR_DOMAIN_TUNABLE_CPU_GLOBAL_PERIOD "cputune.global_period"
@@ -5186,7 +5186,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the maximum bandwidth to be used within a period for
* whole domain, when using the posix scheduler, as VIR_TYPED_PARAM_LLONG.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
# define VIR_DOMAIN_TUNABLE_CPU_GLOBAL_QUOTA "cputune.global_quota"
@@ -5196,7 +5196,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the enforcement period for a quota, in microseconds,
* for vcpus only, when using the posix scheduler, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_VCPU_PERIOD "cputune.vcpu_period"
@@ -5206,7 +5206,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the maximum bandwidth to be used within a period for
* vcpus only, when using the posix scheduler, as VIR_TYPED_PARAM_LLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_VCPU_QUOTA "cputune.vcpu_quota"
@@ -5217,7 +5217,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* when using the posix scheduler, for all emulator activity not tied to
* vcpus, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_EMULATOR_PERIOD "cputune.emulator_period"
@@ -5228,7 +5228,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* all emulator activity not tied to vcpus, when using the posix scheduler,
* as an VIR_TYPED_PARAM_LLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_CPU_EMULATOR_QUOTA "cputune.emulator_quota"
@@ -5238,7 +5238,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the enforcement period for a quota, in microseconds, for
* iothreads only, when using the posix scheduler, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
# define VIR_DOMAIN_TUNABLE_CPU_IOTHREAD_PERIOD "cputune.iothread_period"
@@ -5248,7 +5248,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the maximum bandwidth to be used within a period for
* iothreads only, when using the posix scheduler, as VIR_TYPED_PARAM_LLONG.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
# define VIR_DOMAIN_TUNABLE_CPU_IOTHREAD_QUOTA "cputune.iothread_quota"
@@ -5258,7 +5258,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the name of guest disk for which the values are updated,
* as VIR_TYPED_PARAM_STRING.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_DISK "blkdeviotune.disk"
@@ -5268,7 +5268,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the total throughput limit in bytes per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC "blkdeviotune.total_bytes_sec"
@@ -5278,7 +5278,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the read throughput limit in bytes per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC "blkdeviotune.read_bytes_sec"
@@ -5288,7 +5288,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the write throughput limit in bytes per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC "blkdeviotune.write_bytes_sec"
@@ -5298,7 +5298,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the total I/O operations per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC "blkdeviotune.total_iops_sec"
@@ -5308,7 +5308,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the read I/O operations per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC "blkdeviotune.read_iops_sec"
@@ -5318,7 +5318,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the write I/O operations per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC "blkdeviotune.write_iops_sec"
@@ -5328,7 +5328,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the total throughput limit during bursts in
* maximum bytes per second, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC_MAX "blkdeviotune.total_bytes_sec_max"
@@ -5338,7 +5338,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the read throughput limit during bursts in
* maximum bytes per second, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC_MAX "blkdeviotune.read_bytes_sec_max"
@@ -5348,7 +5348,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the write throughput limit during bursts in
* maximum bytes per second, as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC_MAX "blkdeviotune.write_bytes_sec_max"
@@ -5358,7 +5358,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the total maximum I/O operations per second during bursts,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC_MAX "blkdeviotune.total_iops_sec_max"
@@ -5368,7 +5368,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the read maximum I/O operations per second during bursts,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC_MAX "blkdeviotune.read_iops_sec_max"
@@ -5378,7 +5378,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the write maximum I/O operations per second during bursts,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC_MAX "blkdeviotune.write_iops_sec_max"
@@ -5388,7 +5388,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the size maximum I/O operations per second,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_SIZE_IOPS_SEC "blkdeviotune.size_iops_sec"
@@ -5398,7 +5398,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* Macro represents the group name to be used,
* as VIR_TYPED_PARAM_STRING.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_GROUP_NAME "blkdeviotune.group_name"
@@ -5409,7 +5409,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* for the blkdeviotune.total_bytes_sec_max,
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC_MAX_LENGTH "blkdeviotune.total_bytes_sec_max_length"
@@ -5420,7 +5420,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* for the blkdeviotune.read_bytes_sec_max
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC_MAX_LENGTH "blkdeviotune.read_bytes_sec_max_length"
@@ -5431,7 +5431,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* for the blkdeviotune.write_bytes_sec_max
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC_MAX_LENGTH "blkdeviotune.write_bytes_sec_max_length"
@@ -5442,7 +5442,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* for the blkdeviotune.total_iops_sec_max
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC_MAX_LENGTH "blkdeviotune.total_iops_sec_max_length"
@@ -5453,7 +5453,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* for the blkdeviotune.read_iops_sec_max
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC_MAX_LENGTH "blkdeviotune.read_iops_sec_max_length"
@@ -5464,7 +5464,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* for the blkdeviotune.write_iops_sec_max
* as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v2.4.0
+ * Since: 2.4.0
*/
# define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC_MAX_LENGTH "blkdeviotune.write_iops_sec_max_length"
@@ -5487,7 +5487,7 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_TUNABLE with virConnectDomainEventRegisterAny()
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
typedef void (*virConnectDomainEventTunableCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5499,29 +5499,29 @@ typedef void (*virConnectDomainEventTunableCallback)(virConnectPtr conn,
/**
* virConnectDomainEventAgentLifecycleState:
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
typedef enum {
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_CONNECTED = 1, /* agent connected (Since: v1.2.11) */
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTED = 2, /* agent disconnected (Since: v1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_CONNECTED = 1, /* agent connected (Since: 1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTED = 2, /* agent disconnected (Since: 1.2.11) */
# ifdef VIR_ENUM_SENTINELS
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_LAST /* (Since: v1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_LAST /* (Since: 1.2.11) */
# endif
} virConnectDomainEventAgentLifecycleState;
/**
* virConnectDomainEventAgentLifecycleReason:
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
typedef enum {
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_UNKNOWN = 0, /* unknown state change reason (Since: v1.2.11) */
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_DOMAIN_STARTED = 1, /* state changed due to domain start (Since: v1.2.11) */
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_CHANNEL = 2, /* channel state changed (Since: v1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_UNKNOWN = 0, /* unknown state change reason (Since: 1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_DOMAIN_STARTED = 1, /* state changed due to domain start (Since: 1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_CHANNEL = 2, /* channel state changed (Since: 1.2.11) */
# ifdef VIR_ENUM_SENTINELS
- VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_LAST /* (Since: v1.2.11) */
+ VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_LAST /* (Since: 1.2.11) */
# endif
} virConnectDomainEventAgentLifecycleReason;
@@ -5539,7 +5539,7 @@ typedef enum {
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE with virConnectDomainEventRegisterAny()
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
typedef void (*virConnectDomainEventAgentLifecycleCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5570,7 +5570,7 @@ typedef void (*virConnectDomainEventAgentLifecycleCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD with virConnectDomainEventRegisterAny()
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
typedef void (*virConnectDomainEventBlockThresholdCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5597,7 +5597,7 @@ typedef void (*virConnectDomainEventBlockThresholdCallback)(virConnectPtr conn,
* The callback signature to use when registering for an event of type
* VIR_DOMAIN_EVENT_ID_MEMORY_FAILURE with virConnectDomainEventRegisterAny()
*
- * Since: v6.9.0
+ * Since: 6.9.0
*/
typedef void (*virConnectDomainEventMemoryFailureCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5623,7 +5623,7 @@ typedef void (*virConnectDomainEventMemoryFailureCallback)(virConnectPtr conn,
* VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGE with
* virConnectDomainEventRegisterAny().
*
- * Since: v7.9.0
+ * Since: 7.9.0
*/
typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -5638,7 +5638,7 @@ typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPt
* Used to cast the event specific callback into the generic one
* for use for virConnectDomainEventRegisterAny()
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
# define VIR_DOMAIN_EVENT_CALLBACK(cb) ((virConnectDomainEventGenericCallback)(cb))
@@ -5650,36 +5650,36 @@ typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPt
* virConnectDomainEventRegisterAny(). Each event id determines which
* signature of callback function will be used.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef enum {
- VIR_DOMAIN_EVENT_ID_LIFECYCLE = 0, /* virConnectDomainEventCallback (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_ID_REBOOT = 1, /* virConnectDomainEventGenericCallback (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_ID_RTC_CHANGE = 2, /* virConnectDomainEventRTCChangeCallback (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_ID_WATCHDOG = 3, /* virConnectDomainEventWatchdogCallback (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_ID_IO_ERROR = 4, /* virConnectDomainEventIOErrorCallback (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_ID_GRAPHICS = 5, /* virConnectDomainEventGraphicsCallback (Since: v0.8.0) */
- VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON = 6, /* virConnectDomainEventIOErrorReasonCallback (Since: v0.8.1) */
- VIR_DOMAIN_EVENT_ID_CONTROL_ERROR = 7, /* virConnectDomainEventGenericCallback (Since: v0.9.2) */
- VIR_DOMAIN_EVENT_ID_BLOCK_JOB = 8, /* virConnectDomainEventBlockJobCallback (Since: v0.9.4) */
- VIR_DOMAIN_EVENT_ID_DISK_CHANGE = 9, /* virConnectDomainEventDiskChangeCallback (Since: v0.9.7) */
- VIR_DOMAIN_EVENT_ID_TRAY_CHANGE = 10, /* virConnectDomainEventTrayChangeCallback (Since: v0.9.11) */
- VIR_DOMAIN_EVENT_ID_PMWAKEUP = 11, /* virConnectDomainEventPMWakeupCallback (Since: v0.9.11) */
- VIR_DOMAIN_EVENT_ID_PMSUSPEND = 12, /* virConnectDomainEventPMSuspendCallback (Since: v0.9.11) */
- VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE = 13, /* virConnectDomainEventBalloonChangeCallback (Since: v0.10.0) */
- VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK = 14, /* virConnectDomainEventPMSuspendDiskCallback (Since: v1.0.0) */
- VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED = 15, /* virConnectDomainEventDeviceRemovedCallback (Since: v1.1.1) */
- VIR_DOMAIN_EVENT_ID_BLOCK_JOB_2 = 16, /* virConnectDomainEventBlockJobCallback (Since: v1.2.6) */
- VIR_DOMAIN_EVENT_ID_TUNABLE = 17, /* virConnectDomainEventTunableCallback (Since: v1.2.9) */
- VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE = 18,/* virConnectDomainEventAgentLifecycleCallback (Since: v1.2.11) */
- VIR_DOMAIN_EVENT_ID_DEVICE_ADDED = 19, /* virConnectDomainEventDeviceAddedCallback (Since: v1.2.15) */
- VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION = 20, /* virConnectDomainEventMigrationIterationCallback (Since: v1.3.2) */
- VIR_DOMAIN_EVENT_ID_JOB_COMPLETED = 21, /* virConnectDomainEventJobCompletedCallback (Since: v1.3.3) */
- VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED = 22, /* virConnectDomainEventDeviceRemovalFailedCallback (Since: v1.3.4) */
- VIR_DOMAIN_EVENT_ID_METADATA_CHANGE = 23, /* virConnectDomainEventMetadataChangeCallback (Since: v3.0.0) */
- VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD = 24, /* virConnectDomainEventBlockThresholdCallback (Since: v3.2.0) */
- VIR_DOMAIN_EVENT_ID_MEMORY_FAILURE = 25, /* virConnectDomainEventMemoryFailureCallback (Since: v6.9.0) */
- VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGE = 26, /* virConnectDomainEventMemoryDeviceSizeChangeCallback (Since: v7.9.0) */
+ VIR_DOMAIN_EVENT_ID_LIFECYCLE = 0, /* virConnectDomainEventCallback (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_ID_REBOOT = 1, /* virConnectDomainEventGenericCallback (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_ID_RTC_CHANGE = 2, /* virConnectDomainEventRTCChangeCallback (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_ID_WATCHDOG = 3, /* virConnectDomainEventWatchdogCallback (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_ID_IO_ERROR = 4, /* virConnectDomainEventIOErrorCallback (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_ID_GRAPHICS = 5, /* virConnectDomainEventGraphicsCallback (Since: 0.8.0) */
+ VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON = 6, /* virConnectDomainEventIOErrorReasonCallback (Since: 0.8.1) */
+ VIR_DOMAIN_EVENT_ID_CONTROL_ERROR = 7, /* virConnectDomainEventGenericCallback (Since: 0.9.2) */
+ VIR_DOMAIN_EVENT_ID_BLOCK_JOB = 8, /* virConnectDomainEventBlockJobCallback (Since: 0.9.4) */
+ VIR_DOMAIN_EVENT_ID_DISK_CHANGE = 9, /* virConnectDomainEventDiskChangeCallback (Since: 0.9.7) */
+ VIR_DOMAIN_EVENT_ID_TRAY_CHANGE = 10, /* virConnectDomainEventTrayChangeCallback (Since: 0.9.11) */
+ VIR_DOMAIN_EVENT_ID_PMWAKEUP = 11, /* virConnectDomainEventPMWakeupCallback (Since: 0.9.11) */
+ VIR_DOMAIN_EVENT_ID_PMSUSPEND = 12, /* virConnectDomainEventPMSuspendCallback (Since: 0.9.11) */
+ VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE = 13, /* virConnectDomainEventBalloonChangeCallback (Since: 0.10.0) */
+ VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK = 14, /* virConnectDomainEventPMSuspendDiskCallback (Since: 1.0.0) */
+ VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED = 15, /* virConnectDomainEventDeviceRemovedCallback (Since: 1.1.1) */
+ VIR_DOMAIN_EVENT_ID_BLOCK_JOB_2 = 16, /* virConnectDomainEventBlockJobCallback (Since: 1.2.6) */
+ VIR_DOMAIN_EVENT_ID_TUNABLE = 17, /* virConnectDomainEventTunableCallback (Since: 1.2.9) */
+ VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE = 18,/* virConnectDomainEventAgentLifecycleCallback (Since: 1.2.11) */
+ VIR_DOMAIN_EVENT_ID_DEVICE_ADDED = 19, /* virConnectDomainEventDeviceAddedCallback (Since: 1.2.15) */
+ VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION = 20, /* virConnectDomainEventMigrationIterationCallback (Since: 1.3.2) */
+ VIR_DOMAIN_EVENT_ID_JOB_COMPLETED = 21, /* virConnectDomainEventJobCompletedCallback (Since: 1.3.3) */
+ VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED = 22, /* virConnectDomainEventDeviceRemovalFailedCallback (Since: 1.3.4) */
+ VIR_DOMAIN_EVENT_ID_METADATA_CHANGE = 23, /* virConnectDomainEventMetadataChangeCallback (Since: 3.0.0) */
+ VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD = 24, /* virConnectDomainEventBlockThresholdCallback (Since: 3.2.0) */
+ VIR_DOMAIN_EVENT_ID_MEMORY_FAILURE = 25, /* virConnectDomainEventMemoryFailureCallback (Since: 6.9.0) */
+ VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGE = 26, /* virConnectDomainEventMemoryDeviceSizeChangeCallback (Since: 7.9.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_DOMAIN_EVENT_ID_LAST
@@ -5688,7 +5688,7 @@ typedef enum {
* added to the libvirt API. It reflects the last event ID supported
* by this version of the libvirt API.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
# endif
} virDomainEventID;
@@ -5709,15 +5709,15 @@ int virConnectDomainEventDeregisterAny(virConnectPtr conn,
/**
* virDomainConsoleFlags:
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
typedef enum {
VIR_DOMAIN_CONSOLE_FORCE = (1 << 0), /* abort a (possibly) active console
connection to force a new
- connection (Since: v0.9.11) */
+ connection (Since: 0.9.11) */
VIR_DOMAIN_CONSOLE_SAFE = (1 << 1), /* check if the console driver supports
- safe console operations (Since: v0.9.11) */
+ safe console operations (Since: 0.9.11) */
} virDomainConsoleFlags;
int virDomainOpenConsole(virDomainPtr dom,
@@ -5728,12 +5728,12 @@ int virDomainOpenConsole(virDomainPtr dom,
/**
* virDomainChannelFlags:
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
typedef enum {
VIR_DOMAIN_CHANNEL_FORCE = (1 << 0), /* abort a (possibly) active channel
connection to force a new
- connection (Since: v1.0.2) */
+ connection (Since: 1.0.2) */
} virDomainChannelFlags;
int virDomainOpenChannel(virDomainPtr dom,
@@ -5744,10 +5744,10 @@ int virDomainOpenChannel(virDomainPtr dom,
/**
* virDomainOpenGraphicsFlags:
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
typedef enum {
- VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH = (1 << 0), /* (Since: v0.9.7) */
+ VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH = (1 << 0), /* (Since: 0.9.7) */
} virDomainOpenGraphicsFlags;
int virDomainOpenGraphics(virDomainPtr dom,
@@ -5781,14 +5781,14 @@ int virDomainFSThaw(virDomainPtr dom,
*
* The data structure containing mounted file systems within a guset
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
typedef struct _virDomainFSInfo virDomainFSInfo;
/**
* virDomainFSInfoPtr:
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
typedef virDomainFSInfo *virDomainFSInfoPtr;
@@ -5813,10 +5813,10 @@ int virDomainGetTime(virDomainPtr dom,
/**
* virDomainSetTimeFlags:
*
- * Since: v1.2.5
+ * Since: 1.2.5
*/
typedef enum {
- VIR_DOMAIN_TIME_SYNC = (1 << 0), /* Re-sync domain time from domain's RTC (Since: v1.2.5) */
+ VIR_DOMAIN_TIME_SYNC = (1 << 0), /* Re-sync domain time from domain's RTC (Since: 1.2.5) */
} virDomainSetTimeFlags;
int virDomainSetTime(virDomainPtr dom,
@@ -5830,15 +5830,15 @@ int virDomainSetTime(virDomainPtr dom,
* A scheduler parameter field type. Provided for backwards
* compatibility; virTypedParameterType is the preferred enum
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
typedef enum {
- VIR_DOMAIN_SCHED_FIELD_INT = VIR_TYPED_PARAM_INT, /* (Since: v0.2.3) */
- VIR_DOMAIN_SCHED_FIELD_UINT = VIR_TYPED_PARAM_UINT, /* (Since: v0.2.3) */
- VIR_DOMAIN_SCHED_FIELD_LLONG = VIR_TYPED_PARAM_LLONG, /* (Since: v0.2.3) */
- VIR_DOMAIN_SCHED_FIELD_ULLONG = VIR_TYPED_PARAM_ULLONG, /* (Since: v0.2.3) */
- VIR_DOMAIN_SCHED_FIELD_DOUBLE = VIR_TYPED_PARAM_DOUBLE, /* (Since: v0.2.3) */
- VIR_DOMAIN_SCHED_FIELD_BOOLEAN = VIR_TYPED_PARAM_BOOLEAN, /* (Since: v0.2.3) */
+ VIR_DOMAIN_SCHED_FIELD_INT = VIR_TYPED_PARAM_INT, /* (Since: 0.2.3) */
+ VIR_DOMAIN_SCHED_FIELD_UINT = VIR_TYPED_PARAM_UINT, /* (Since: 0.2.3) */
+ VIR_DOMAIN_SCHED_FIELD_LLONG = VIR_TYPED_PARAM_LLONG, /* (Since: 0.2.3) */
+ VIR_DOMAIN_SCHED_FIELD_ULLONG = VIR_TYPED_PARAM_ULLONG, /* (Since: 0.2.3) */
+ VIR_DOMAIN_SCHED_FIELD_DOUBLE = VIR_TYPED_PARAM_DOUBLE, /* (Since: 0.2.3) */
+ VIR_DOMAIN_SCHED_FIELD_BOOLEAN = VIR_TYPED_PARAM_BOOLEAN, /* (Since: 0.2.3) */
} virSchedParameterType;
/**
@@ -5848,14 +5848,14 @@ typedef enum {
* for backwards compatibility; VIR_TYPED_PARAM_FIELD_LENGTH is the
* preferred value
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
# define VIR_DOMAIN_SCHED_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
/**
* _virSchedParameter:
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
# define _virSchedParameter _virTypedParameter
@@ -5866,7 +5866,7 @@ typedef enum {
* Provided for backwards compatibility; virTypedParameter is the
* preferred alias.
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
typedef struct _virTypedParameter virSchedParameter;
@@ -5877,7 +5877,7 @@ typedef struct _virTypedParameter virSchedParameter;
* Provided for backwards compatibility; virTypedParameterPtr is the
* preferred alias since 0.9.2.
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
typedef virSchedParameter *virSchedParameterPtr;
@@ -5887,15 +5887,15 @@ typedef virSchedParameter *virSchedParameterPtr;
* A blkio parameter field type. Provided for backwards
* compatibility; virTypedParameterType is the preferred enum
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
typedef enum {
- VIR_DOMAIN_BLKIO_PARAM_INT = VIR_TYPED_PARAM_INT, /* (Since: v0.9.0) */
- VIR_DOMAIN_BLKIO_PARAM_UINT = VIR_TYPED_PARAM_UINT, /* (Since: v0.9.0) */
- VIR_DOMAIN_BLKIO_PARAM_LLONG = VIR_TYPED_PARAM_LLONG, /* (Since: v0.9.0) */
- VIR_DOMAIN_BLKIO_PARAM_ULLONG = VIR_TYPED_PARAM_ULLONG, /* (Since: v0.9.0) */
- VIR_DOMAIN_BLKIO_PARAM_DOUBLE = VIR_TYPED_PARAM_DOUBLE, /* (Since: v0.9.0) */
- VIR_DOMAIN_BLKIO_PARAM_BOOLEAN = VIR_TYPED_PARAM_BOOLEAN, /* (Since: v0.9.0) */
+ VIR_DOMAIN_BLKIO_PARAM_INT = VIR_TYPED_PARAM_INT, /* (Since: 0.9.0) */
+ VIR_DOMAIN_BLKIO_PARAM_UINT = VIR_TYPED_PARAM_UINT, /* (Since: 0.9.0) */
+ VIR_DOMAIN_BLKIO_PARAM_LLONG = VIR_TYPED_PARAM_LLONG, /* (Since: 0.9.0) */
+ VIR_DOMAIN_BLKIO_PARAM_ULLONG = VIR_TYPED_PARAM_ULLONG, /* (Since: 0.9.0) */
+ VIR_DOMAIN_BLKIO_PARAM_DOUBLE = VIR_TYPED_PARAM_DOUBLE, /* (Since: 0.9.0) */
+ VIR_DOMAIN_BLKIO_PARAM_BOOLEAN = VIR_TYPED_PARAM_BOOLEAN, /* (Since: 0.9.0) */
} virBlkioParameterType;
/**
@@ -5905,14 +5905,14 @@ typedef enum {
* for backwards compatibility; VIR_TYPED_PARAM_FIELD_LENGTH is the
* preferred value.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
# define VIR_DOMAIN_BLKIO_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
/**
* _virBlkioParameter:
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
# define _virBlkioParameter _virTypedParameter
@@ -5923,7 +5923,7 @@ typedef enum {
* Provided for backwards compatibility; virTypedParameter is the
* preferred alias.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
typedef struct _virTypedParameter virBlkioParameter;
@@ -5934,7 +5934,7 @@ typedef struct _virTypedParameter virBlkioParameter;
* Provided for backwards compatibility; virTypedParameterPtr is the
* preferred alias.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
typedef virBlkioParameter *virBlkioParameterPtr;
@@ -5944,15 +5944,15 @@ typedef virBlkioParameter *virBlkioParameterPtr;
* A memory parameter field type. Provided for backwards
* compatibility; virTypedParameterType is the preferred enum
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
typedef enum {
- VIR_DOMAIN_MEMORY_PARAM_INT = VIR_TYPED_PARAM_INT, /* (Since: v0.8.5) */
- VIR_DOMAIN_MEMORY_PARAM_UINT = VIR_TYPED_PARAM_UINT, /* (Since: v0.8.5) */
- VIR_DOMAIN_MEMORY_PARAM_LLONG = VIR_TYPED_PARAM_LLONG, /* (Since: v0.8.5) */
- VIR_DOMAIN_MEMORY_PARAM_ULLONG = VIR_TYPED_PARAM_ULLONG, /* (Since: v0.8.5) */
- VIR_DOMAIN_MEMORY_PARAM_DOUBLE = VIR_TYPED_PARAM_DOUBLE, /* (Since: v0.8.5) */
- VIR_DOMAIN_MEMORY_PARAM_BOOLEAN = VIR_TYPED_PARAM_BOOLEAN, /* (Since: v0.8.5) */
+ VIR_DOMAIN_MEMORY_PARAM_INT = VIR_TYPED_PARAM_INT, /* (Since: 0.8.5) */
+ VIR_DOMAIN_MEMORY_PARAM_UINT = VIR_TYPED_PARAM_UINT, /* (Since: 0.8.5) */
+ VIR_DOMAIN_MEMORY_PARAM_LLONG = VIR_TYPED_PARAM_LLONG, /* (Since: 0.8.5) */
+ VIR_DOMAIN_MEMORY_PARAM_ULLONG = VIR_TYPED_PARAM_ULLONG, /* (Since: 0.8.5) */
+ VIR_DOMAIN_MEMORY_PARAM_DOUBLE = VIR_TYPED_PARAM_DOUBLE, /* (Since: 0.8.5) */
+ VIR_DOMAIN_MEMORY_PARAM_BOOLEAN = VIR_TYPED_PARAM_BOOLEAN, /* (Since: 0.8.5) */
} virMemoryParameterType;
/**
@@ -5962,14 +5962,14 @@ typedef enum {
* for backwards compatibility; VIR_TYPED_PARAM_FIELD_LENGTH is the
* preferred value.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
# define VIR_DOMAIN_MEMORY_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
/**
* _virMemoryParameter:
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
# define _virMemoryParameter _virTypedParameter
@@ -5980,7 +5980,7 @@ typedef enum {
* Provided for backwards compatibility; virTypedParameter is the
* preferred alias.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
typedef struct _virTypedParameter virMemoryParameter;
@@ -5991,36 +5991,36 @@ typedef struct _virTypedParameter virMemoryParameter;
* Provided for backwards compatibility; virTypedParameterPtr is the
* preferred alias.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
typedef virMemoryParameter *virMemoryParameterPtr;
/**
* virDomainInterfaceAddressesSource:
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef enum {
- VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE = 0, /* Parse DHCP lease file (Since: v1.2.14) */
- VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENT = 1, /* Query qemu guest agent (Since: v1.2.14) */
- VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_ARP = 2, /* Query ARP tables (Since: v4.2.0) */
+ VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE = 0, /* Parse DHCP lease file (Since: 1.2.14) */
+ VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENT = 1, /* Query qemu guest agent (Since: 1.2.14) */
+ VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_ARP = 2, /* Query ARP tables (Since: 4.2.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LAST /* (Since: v1.2.14) */
+ VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LAST /* (Since: 1.2.14) */
# endif
} virDomainInterfaceAddressesSource;
/**
* virDomainIPAddress:
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef struct _virDomainInterfaceIPAddress virDomainIPAddress;
/**
* virDomainIPAddressPtr:
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef virDomainIPAddress *virDomainIPAddressPtr;
struct _virDomainInterfaceIPAddress {
@@ -6032,14 +6032,14 @@ struct _virDomainInterfaceIPAddress {
/**
* virDomainInterface:
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef struct _virDomainInterface virDomainInterface;
/**
* virDomainInterfacePtr:
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
typedef virDomainInterface *virDomainInterfacePtr;
struct _virDomainInterface {
@@ -6059,10 +6059,10 @@ void virDomainInterfaceFree(virDomainInterfacePtr iface);
/**
* virDomainSetUserPasswordFlags:
*
- * Since: v1.2.16
+ * Since: 1.2.16
*/
typedef enum {
- VIR_DOMAIN_PASSWORD_ENCRYPTED = 1 << 0, /* the password is already encrypted (Since: v1.2.16) */
+ VIR_DOMAIN_PASSWORD_ENCRYPTED = 1 << 0, /* the password is already encrypted (Since: 1.2.16) */
} virDomainSetUserPasswordFlags;
int virDomainSetUserPassword(virDomainPtr dom,
@@ -6097,33 +6097,33 @@ int virDomainSetBlockThreshold(virDomainPtr domain,
/**
* virDomainLifecycle:
*
- * Since: v3.9.0
+ * Since: 3.9.0
*/
typedef enum {
- VIR_DOMAIN_LIFECYCLE_POWEROFF = 0, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_REBOOT = 1, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_CRASH = 2, /* (Since: v3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_POWEROFF = 0, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_REBOOT = 1, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_CRASH = 2, /* (Since: 3.9.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_LIFECYCLE_LAST /* (Since: v3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_LAST /* (Since: 3.9.0) */
# endif
} virDomainLifecycle;
/**
* virDomainLifecycleAction:
*
- * Since: v3.9.0
+ * Since: 3.9.0
*/
typedef enum {
- VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY = 0, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_ACTION_RESTART = 1, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_ACTION_RESTART_RENAME = 2, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_ACTION_PRESERVE = 3, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_DESTROY = 4, /* (Since: v3.9.0) */
- VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_RESTART = 5, /* (Since: v3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY = 0, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_RESTART = 1, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_RESTART_RENAME = 2, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_PRESERVE = 3, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_DESTROY = 4, /* (Since: 3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_RESTART = 5, /* (Since: 3.9.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_LIFECYCLE_ACTION_LAST /* (Since: v3.9.0) */
+ VIR_DOMAIN_LIFECYCLE_ACTION_LAST /* (Since: 3.9.0) */
# endif
} virDomainLifecycleAction;
@@ -6142,7 +6142,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* Macro represents the launch measurement of the SEV guest,
* as VIR_TYPED_PARAM_STRING.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_MEASUREMENT "sev-measurement"
@@ -6153,7 +6153,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* Macro represents the API major version of the SEV host,
* as VIR_TYPED_PARAM_UINT.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MAJOR "sev-api-major"
@@ -6163,7 +6163,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* Macro represents the API minor version of the SEV guest,
* as VIR_TYPED_PARAM_UINT.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MINOR "sev-api-minor"
@@ -6173,7 +6173,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* Macro represents the build ID of the SEV host,
* as VIR_TYPED_PARAM_UINT.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_BUILD_ID "sev-build-id"
@@ -6183,7 +6183,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* Macro represents the policy of the SEV guest,
* as VIR_TYPED_PARAM_UINT.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_POLICY "sev-policy"
@@ -6196,7 +6196,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* section "6.6 LAUNCH_SECRET" in the SEV API specification for a detailed
* description of the secret header.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_HEADER "sev-secret-header"
@@ -6208,7 +6208,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* secret. The secret is created by the domain owner after the SEV launch
* measurement is retrieved and verified.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET "sev-secret"
@@ -6219,7 +6219,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
* where the secret will be set, as VIR_TYPED_PARAM_ULLONG. If not specified,
* the address will be determined by the hypervisor.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_SET_ADDRESS "sev-secret-set-address"
@@ -6236,16 +6236,16 @@ int virDomainSetLaunchSecurityState(virDomainPtr domain,
/**
* virDomainGuestInfoTypes:
*
- * Since: v5.7.0
+ * Since: 5.7.0
*/
typedef enum {
- VIR_DOMAIN_GUEST_INFO_USERS = (1 << 0), /* return active users (Since: v5.7.0) */
- VIR_DOMAIN_GUEST_INFO_OS = (1 << 1), /* return OS information (Since: v5.7.0) */
- VIR_DOMAIN_GUEST_INFO_TIMEZONE = (1 << 2), /* return timezone information (Since: v5.7.0) */
- VIR_DOMAIN_GUEST_INFO_HOSTNAME = (1 << 3), /* return hostname information (Since: v5.7.0) */
- VIR_DOMAIN_GUEST_INFO_FILESYSTEM = (1 << 4), /* return filesystem information (Since: v5.7.0) */
- VIR_DOMAIN_GUEST_INFO_DISKS = (1 << 5), /* return disks information (Since: v7.0.0) */
- VIR_DOMAIN_GUEST_INFO_INTERFACES = (1 << 6), /* return interfaces information (Since: v7.10.0) */
+ VIR_DOMAIN_GUEST_INFO_USERS = (1 << 0), /* return active users (Since: 5.7.0) */
+ VIR_DOMAIN_GUEST_INFO_OS = (1 << 1), /* return OS information (Since: 5.7.0) */
+ VIR_DOMAIN_GUEST_INFO_TIMEZONE = (1 << 2), /* return timezone information (Since: 5.7.0) */
+ VIR_DOMAIN_GUEST_INFO_HOSTNAME = (1 << 3), /* return hostname information (Since: 5.7.0) */
+ VIR_DOMAIN_GUEST_INFO_FILESYSTEM = (1 << 4), /* return filesystem information (Since: 5.7.0) */
+ VIR_DOMAIN_GUEST_INFO_DISKS = (1 << 5), /* return disks information (Since: 7.0.0) */
+ VIR_DOMAIN_GUEST_INFO_INTERFACES = (1 << 6), /* return interfaces information (Since: 7.10.0) */
} virDomainGuestInfoTypes;
int virDomainGetGuestInfo(virDomainPtr domain,
@@ -6257,12 +6257,12 @@ int virDomainGetGuestInfo(virDomainPtr domain,
/**
* virDomainAgentResponseTimeoutValues:
*
- * Since: v5.10.0
+ * Since: 5.10.0
*/
typedef enum {
- VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK = -2, /* (Since: v5.10.0) */
- VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT = -1, /* (Since: v5.10.0) */
- VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT = 0, /* (Since: v5.10.0) */
+ VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK = -2, /* (Since: 5.10.0) */
+ VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT = -1, /* (Since: 5.10.0) */
+ VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT = 0, /* (Since: 5.10.0) */
} virDomainAgentResponseTimeoutValues;
int virDomainAgentSetResponseTimeout(virDomainPtr domain,
@@ -6272,11 +6272,11 @@ int virDomainAgentSetResponseTimeout(virDomainPtr domain,
/**
* virDomainBackupBeginFlags:
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
typedef enum {
VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNAL = (1 << 0), /* reuse separately
- provided images (Since: v6.0.0) */
+ provided images (Since: 6.0.0) */
} virDomainBackupBeginFlags;
int virDomainBackupBegin(virDomainPtr domain,
@@ -6295,11 +6295,11 @@ int virDomainAuthorizedSSHKeysGet(virDomainPtr domain,
/**
* virDomainAuthorizedSSHKeysSetFlags:
*
- * Since: v6.10.0
+ * Since: 6.10.0
*/
typedef enum {
- VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_APPEND = (1 << 0), /* don't truncate file, just append (Since: v6.10.0) */
- VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_REMOVE = (1 << 1), /* remove keys, instead of adding them (Since: v6.10.0) */
+ VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_APPEND = (1 << 0), /* don't truncate file, just append (Since: 6.10.0) */
+ VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_REMOVE = (1 << 1), /* remove keys, instead of adding them (Since: 6.10.0) */
} virDomainAuthorizedSSHKeysSetFlags;
@@ -6312,11 +6312,11 @@ int virDomainAuthorizedSSHKeysSet(virDomainPtr domain,
/**
* virDomainMessageType:
*
- * Since: v7.1.0
+ * Since: 7.1.0
*/
typedef enum {
- VIR_DOMAIN_MESSAGE_DEPRECATION = (1 << 0), /* (Since: v7.1.0) */
- VIR_DOMAIN_MESSAGE_TAINTING = (1 << 1), /* (Since: v7.1.0) */
+ VIR_DOMAIN_MESSAGE_DEPRECATION = (1 << 0), /* (Since: 7.1.0) */
+ VIR_DOMAIN_MESSAGE_TAINTING = (1 << 1), /* (Since: 7.1.0) */
} virDomainMessageType;
int virDomainGetMessages(virDomainPtr domain,
@@ -6328,18 +6328,18 @@ int virDomainGetMessages(virDomainPtr domain,
*
* Details on the cause of a dirty rate calculation status.
*
- * Since: v7.2.0
+ * Since: 7.2.0
*/
typedef enum {
VIR_DOMAIN_DIRTYRATE_UNSTARTED = 0, /* the dirtyrate calculation has
- not been started (Since: v7.2.0) */
+ not been started (Since: 7.2.0) */
VIR_DOMAIN_DIRTYRATE_MEASURING = 1, /* the dirtyrate calculation is
- measuring (Since: v7.2.0) */
+ measuring (Since: 7.2.0) */
VIR_DOMAIN_DIRTYRATE_MEASURED = 2, /* the dirtyrate calculation is
- completed (Since: v7.2.0) */
+ completed (Since: 7.2.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_DOMAIN_DIRTYRATE_LAST /* (Since: v7.2.0) */
+ VIR_DOMAIN_DIRTYRATE_LAST /* (Since: 7.2.0) */
# endif
} virDomainDirtyRateStatus;
@@ -6350,12 +6350,12 @@ typedef enum {
* rate for a Domain
*
*
- * Since: v8.1.0
+ * Since: 8.1.0
*/
typedef enum {
- VIR_DOMAIN_DIRTYRATE_MODE_PAGE_SAMPLING = 0, /* default mode - page-sampling (Since: v8.1.0) */
- VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_BITMAP = 1 << 0, /* dirty-bitmap mode (Since: v8.1.0) */
- VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_RING = 1 << 1, /* dirty-ring mode (Since: v8.1.0) */
+ VIR_DOMAIN_DIRTYRATE_MODE_PAGE_SAMPLING = 0, /* default mode - page-sampling (Since: 8.1.0) */
+ VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_BITMAP = 1 << 0, /* dirty-bitmap mode (Since: 8.1.0) */
+ VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_RING = 1 << 1, /* dirty-ring mode (Since: 8.1.0) */
} virDomainDirtyRateCalcFlags;
int virDomainStartDirtyRateCalc(virDomainPtr domain,
diff --git a/include/libvirt/libvirt-event.h b/include/libvirt/libvirt-event.h
index cc517044c6..41e662a237 100644
--- a/include/libvirt/libvirt-event.h
+++ b/include/libvirt/libvirt-event.h
@@ -35,13 +35,13 @@
* to libvirt. A client app must translate to, and from POLL events when using
* this construct.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef enum {
- VIR_EVENT_HANDLE_READABLE = (1 << 0), /* (Since: v0.5.0) */
- VIR_EVENT_HANDLE_WRITABLE = (1 << 1), /* (Since: v0.5.0) */
- VIR_EVENT_HANDLE_ERROR = (1 << 2), /* (Since: v0.5.0) */
- VIR_EVENT_HANDLE_HANGUP = (1 << 3), /* (Since: v0.5.0) */
+ VIR_EVENT_HANDLE_READABLE = (1 << 0), /* (Since: 0.5.0) */
+ VIR_EVENT_HANDLE_WRITABLE = (1 << 1), /* (Since: 0.5.0) */
+ VIR_EVENT_HANDLE_ERROR = (1 << 2), /* (Since: 0.5.0) */
+ VIR_EVENT_HANDLE_HANGUP = (1 << 3), /* (Since: 0.5.0) */
} virEventHandleType;
/**
@@ -55,7 +55,7 @@ typedef enum {
* Callback for receiving file handle events. The callback will
* be invoked once for each event which is pending.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef void (*virEventHandleCallback)(int watch, int fd, int events, void *opaque);
@@ -84,7 +84,7 @@ typedef void (*virEventHandleCallback)(int watch, int fd, int events, void *opaq
* 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
+ * Since: 0.5.0
*/
typedef int (*virEventAddHandleFunc)(int fd, int event,
virEventHandleCallback cb,
@@ -99,7 +99,7 @@ typedef int (*virEventAddHandleFunc)(int fd, int event,
* Part of the EventImpl, this user-provided callback is notified when
* events to listen on change
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef void (*virEventUpdateHandleFunc)(int watch, int event);
@@ -116,7 +116,7 @@ typedef void (*virEventUpdateHandleFunc)(int watch, int event);
*
* Returns -1 if the file handle was not registered, 0 upon success
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef int (*virEventRemoveHandleFunc)(int watch);
@@ -128,7 +128,7 @@ typedef int (*virEventRemoveHandleFunc)(int watch);
*
* callback for receiving timer events
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef void (*virEventTimeoutCallback)(int timer, void *opaque);
@@ -148,7 +148,7 @@ typedef void (*virEventTimeoutCallback)(int timer, void *opaque);
*
* Returns a timer value
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef int (*virEventAddTimeoutFunc)(int timeout,
virEventTimeoutCallback cb,
@@ -163,7 +163,7 @@ typedef int (*virEventAddTimeoutFunc)(int timeout,
* Part of the EventImpl, this user-defined callback updates an
* event timeout.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef void (*virEventUpdateTimeoutFunc)(int timer, int timeout);
@@ -179,7 +179,7 @@ typedef void (*virEventUpdateTimeoutFunc)(int timer, int timeout);
*
* Returns 0 on success, -1 on failure
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef int (*virEventRemoveTimeoutFunc)(int timer);
diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h
index b5cf8a4a4a..e115f7b998 100644
--- a/include/libvirt/libvirt-host.h
+++ b/include/libvirt/libvirt-host.h
@@ -34,7 +34,7 @@
* a virConnect is a private structure representing a connection to
* the Hypervisor.
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef struct _virConnect virConnect;
@@ -44,7 +44,7 @@ typedef struct _virConnect virConnect;
* a virConnectPtr is pointer to a virConnect private structure, this is the
* type used to reference a connection to the Hypervisor in the API.
*
- * Since: v0.0.1
+ * Since: 0.0.1
*/
typedef virConnect *virConnectPtr;
@@ -54,15 +54,15 @@ typedef virConnect *virConnectPtr;
* Flags to indicate which system-wide sleep state the host must be
* transitioned to.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
typedef enum {
- VIR_NODE_SUSPEND_TARGET_MEM = 0, /* (Since: v0.9.8) */
- VIR_NODE_SUSPEND_TARGET_DISK = 1, /* (Since: v0.9.8) */
- VIR_NODE_SUSPEND_TARGET_HYBRID = 2, /* (Since: v0.9.8) */
+ VIR_NODE_SUSPEND_TARGET_MEM = 0, /* (Since: 0.9.8) */
+ VIR_NODE_SUSPEND_TARGET_DISK = 1, /* (Since: 0.9.8) */
+ VIR_NODE_SUSPEND_TARGET_HYBRID = 2, /* (Since: 0.9.8) */
# ifdef VIR_ENUM_SENTINELS
- VIR_NODE_SUSPEND_TARGET_LAST /* This constant is subject to change (Since: v0.9.8) */
+ VIR_NODE_SUSPEND_TARGET_LAST /* This constant is subject to change (Since: 0.9.8) */
# endif
} virNodeSuspendTarget;
@@ -71,7 +71,7 @@ typedef enum {
*
* a virStream is a private structure representing a data stream.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef struct _virStream virStream;
@@ -81,7 +81,7 @@ typedef struct _virStream virStream;
* a virStreamPtr is pointer to a virStream private structure, this is the
* type used to reference a data stream in the API.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef virStream *virStreamPtr;
@@ -91,7 +91,7 @@ typedef virStream *virStreamPtr;
* Macro providing the maximum length of the virSecurityLabel label string.
* Note that this value is based on that used by Labeled NFS.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
# define VIR_SECURITY_LABEL_BUFLEN (4096 + 1)
@@ -102,7 +102,7 @@ typedef virStream *virStreamPtr;
* providing the security label and associated attributes for the specified
* domain.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
typedef struct _virSecurityLabel virSecurityLabel;
@@ -116,7 +116,7 @@ struct _virSecurityLabel {
*
* a virSecurityLabelPtr is a pointer to a virSecurityLabel.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
typedef virSecurityLabel *virSecurityLabelPtr;
@@ -125,7 +125,7 @@ typedef virSecurityLabel *virSecurityLabelPtr;
*
* Macro providing the maximum length of the virSecurityModel model string.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
# define VIR_SECURITY_MODEL_BUFLEN (256 + 1)
@@ -134,7 +134,7 @@ typedef virSecurityLabel *virSecurityLabelPtr;
*
* Macro providing the maximum length of the virSecurityModel doi string.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
# define VIR_SECURITY_DOI_BUFLEN (256 + 1)
@@ -145,7 +145,7 @@ typedef virSecurityLabel *virSecurityLabelPtr;
* providing the per-hypervisor security model and DOI attributes for the
* specified domain.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
typedef struct _virSecurityModel virSecurityModel;
@@ -159,7 +159,7 @@ struct _virSecurityModel {
*
* a virSecurityModelPtr is a pointer to a virSecurityModel.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
typedef virSecurityModel *virSecurityModelPtr;
@@ -176,7 +176,7 @@ typedef virSecurityModel *virSecurityModelPtr;
* accurate relection of the system hardware. See the virNodeGetInfo()
* API documentation for further guidance.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef struct _virNodeInfo virNodeInfo;
@@ -202,7 +202,7 @@ struct _virNodeInfo {
*
* Macro providing the field length of virNodeCPUStats
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_CPU_STATS_FIELD_LENGTH 80
@@ -211,10 +211,10 @@ struct _virNodeInfo {
*
* Value for specifying request for the total CPU time/utilization
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
typedef enum {
- VIR_NODE_CPU_STATS_ALL_CPUS = -1, /* (Since: v0.9.3) */
+ VIR_NODE_CPU_STATS_ALL_CPUS = -1, /* (Since: 0.9.3) */
} virNodeGetCPUStatsAllCPUs;
/**
@@ -223,7 +223,7 @@ typedef enum {
* Macro for the cumulative CPU time which was spent by the kernel,
* since the node booting up (in nanoseconds).
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_CPU_STATS_KERNEL "kernel"
@@ -233,7 +233,7 @@ typedef enum {
* The cumulative CPU time which was spent by user processes,
* since the node booting up (in nanoseconds).
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_CPU_STATS_USER "user"
@@ -243,7 +243,7 @@ typedef enum {
* The cumulative idle CPU time,
* since the node booting up (in nanoseconds).
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_CPU_STATS_IDLE "idle"
@@ -253,7 +253,7 @@ typedef enum {
* The cumulative I/O wait CPU time,
* since the node booting up (in nanoseconds).
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_CPU_STATS_IOWAIT "iowait"
@@ -263,7 +263,7 @@ typedef enum {
* The cumulative interrupt CPU time,
* since the node booting up (in nanoseconds).
*
- * Since: v1.2.2
+ * Since: 1.2.2
*/
# define VIR_NODE_CPU_STATS_INTR "intr"
@@ -274,7 +274,7 @@ typedef enum {
* The usage value is in percent and 100% represents all CPUs of
* the node.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_CPU_STATS_UTILIZATION "utilization"
@@ -284,7 +284,7 @@ typedef enum {
* a virNodeCPUStats is a structure filled by virNodeGetCPUStats()
* providing information about the CPU stats of the node.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef struct _virNodeCPUStats virNodeCPUStats;
@@ -298,7 +298,7 @@ struct _virNodeCPUStats {
*
* Macro providing the field length of virNodeMemoryStats
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_MEMORY_STATS_FIELD_LENGTH 80
@@ -307,10 +307,10 @@ struct _virNodeCPUStats {
*
* Value for specifying request for the total memory of all cells.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
typedef enum {
- VIR_NODE_MEMORY_STATS_ALL_CELLS = -1, /* (Since: v0.9.3) */
+ VIR_NODE_MEMORY_STATS_ALL_CELLS = -1, /* (Since: 0.9.3) */
} virNodeGetMemoryStatsAllCells;
/**
@@ -319,7 +319,7 @@ typedef enum {
* Macro for the total memory of specified cell:
* it represents the maximum memory.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_MEMORY_STATS_TOTAL "total"
@@ -330,7 +330,7 @@ typedef enum {
* On Linux, it includes buffer and cached memory, in case of
* VIR_NODE_MEMORY_STATS_ALL_CELLS.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_MEMORY_STATS_FREE "free"
@@ -340,7 +340,7 @@ typedef enum {
* Macro for the buffer memory: On Linux, it is only returned in case of
* VIR_NODE_MEMORY_STATS_ALL_CELLS.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_MEMORY_STATS_BUFFERS "buffers"
@@ -350,7 +350,7 @@ typedef enum {
* Macro for the cached memory: On Linux, it is only returned in case of
* VIR_NODE_MEMORY_STATS_ALL_CELLS.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
# define VIR_NODE_MEMORY_STATS_CACHED "cached"
@@ -360,7 +360,7 @@ typedef enum {
* a virNodeMemoryStats is a structure filled by virNodeGetMemoryStats()
* providing information about the memory of the node.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef struct _virNodeMemoryStats virNodeMemoryStats;
@@ -375,7 +375,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many present pages
* to scan before the shared memory service goes to sleep.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_PAGES_TO_SCAN "shm_pages_to_scan"
@@ -385,7 +385,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many milliseconds
* the shared memory service should sleep before next scan.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_SLEEP_MILLISECS "shm_sleep_millisecs"
@@ -395,7 +395,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many the shared
* memory pages are being used.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_PAGES_SHARED "shm_pages_shared"
@@ -405,7 +405,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many sites are
* sharing the pages i.e. how much saved.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_PAGES_SHARING "shm_pages_sharing"
@@ -415,7 +415,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many pages unique
* but repeatedly checked for merging.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_PAGES_UNSHARED "shm_pages_unshared"
@@ -425,7 +425,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many pages changing
* too fast to be placed in a tree.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_PAGES_VOLATILE "shm_pages_volatile"
@@ -435,7 +435,7 @@ struct _virNodeMemoryStats {
* Macro for typed parameter that represents how many times all
* mergeable areas have been scanned.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
# define VIR_NODE_MEMORY_SHARED_FULL_SCANS "shm_full_scans"
@@ -449,7 +449,7 @@ struct _virNodeMemoryStats {
* pages from all nodes can be merged. Other values are reserved
* for future use.
*
- * Since: v1.0.0
+ * Since: 1.0.0
*/
# define VIR_NODE_MEMORY_SHARED_MERGE_ACROSS_NODES "shm_merge_across_nodes"
@@ -480,7 +480,7 @@ int virNodeGetCPUMap(virConnectPtr conn,
* This macro is to calculate the total number of CPUs supported
* but not necessary active in the host.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
# define VIR_NODEINFO_MAXCPUS(nodeinfo) ((nodeinfo).nodes*(nodeinfo).sockets*(nodeinfo).cores*(nodeinfo).threads)
@@ -489,7 +489,7 @@ int virNodeGetCPUMap(virConnectPtr conn,
*
* a virNodeInfoPtr is a pointer to a virNodeInfo structure.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef virNodeInfo *virNodeInfoPtr;
@@ -498,7 +498,7 @@ typedef virNodeInfo *virNodeInfoPtr;
*
* a virNodeCPUStatsPtr is a pointer to a virNodeCPUStats structure.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef virNodeCPUStats *virNodeCPUStatsPtr;
@@ -507,7 +507,7 @@ typedef virNodeCPUStats *virNodeCPUStatsPtr;
*
* a virNodeMemoryStatsPtr is a pointer to a virNodeMemoryStats structure.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
@@ -522,7 +522,7 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
*
* Macro represents the Platform Diffie-Hellman key, as VIR_TYPED_PARAMS_STRING.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
# define VIR_NODE_SEV_PDH "pdh"
@@ -533,7 +533,7 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
* endorsement key (PEK), owner certificate authority (OCD) and chip
* endorsement key (CEK), as VIR_TYPED_PARAMS_STRING.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
# define VIR_NODE_SEV_CERT_CHAIN "cert-chain"
@@ -542,7 +542,7 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
*
* Macro represents the CBit Position used by hypervisor when SEV is enabled.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
# define VIR_NODE_SEV_CBITPOS "cbitpos"
@@ -552,7 +552,7 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
* Macro represents the number of bits we lose in physical address space
* when SEV is enabled in the guest.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
# define VIR_NODE_SEV_REDUCED_PHYS_BITS "reduced-phys-bits"
@@ -562,7 +562,7 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
* Macro represents the number of SEV guests that can
* be run on the host, as a VIR_TYPED_PARAM_UINT.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_NODE_SEV_MAX_GUESTS "max-guests"
@@ -572,7 +572,7 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr;
* Macro represents the number of SEV-ES guests that can
* be run on the host, as a VIR_TYPED_PARAM_UINT.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
# define VIR_NODE_SEV_MAX_ES_GUESTS "max-es-guests"
@@ -586,31 +586,31 @@ int virNodeGetSEVInfo (virConnectPtr conn,
*
* Flags when opening a connection to a hypervisor
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_CONNECT_RO = (1 << 0), /* A readonly connection (Since: v0.4.1) */
- VIR_CONNECT_NO_ALIASES = (1 << 1), /* Don't try to resolve URI aliases (Since: v0.9.7) */
+ VIR_CONNECT_RO = (1 << 0), /* A readonly connection (Since: 0.4.1) */
+ VIR_CONNECT_NO_ALIASES = (1 << 1), /* Don't try to resolve URI aliases (Since: 0.9.7) */
} virConnectFlags;
/**
* virConnectCredentialType:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_CRED_USERNAME = 1, /* Identity to act as (Since: v0.4.1) */
- VIR_CRED_AUTHNAME = 2, /* Identify to authorize as (Since: v0.4.1) */
- VIR_CRED_LANGUAGE = 3, /* RFC 1766 languages, comma separated (Since: v0.4.1) */
- VIR_CRED_CNONCE = 4, /* client supplies a nonce (Since: v0.4.1) */
- VIR_CRED_PASSPHRASE = 5, /* Passphrase secret (Since: v0.4.1) */
- VIR_CRED_ECHOPROMPT = 6, /* Challenge response (Since: v0.4.1) */
- VIR_CRED_NOECHOPROMPT = 7, /* Challenge response (Since: v0.4.1) */
- VIR_CRED_REALM = 8, /* Authentication realm (Since: v0.4.1) */
- VIR_CRED_EXTERNAL = 9, /* Externally managed credential (Since: v0.4.1) */
+ VIR_CRED_USERNAME = 1, /* Identity to act as (Since: 0.4.1) */
+ VIR_CRED_AUTHNAME = 2, /* Identify to authorize as (Since: 0.4.1) */
+ VIR_CRED_LANGUAGE = 3, /* RFC 1766 languages, comma separated (Since: 0.4.1) */
+ VIR_CRED_CNONCE = 4, /* client supplies a nonce (Since: 0.4.1) */
+ VIR_CRED_PASSPHRASE = 5, /* Passphrase secret (Since: 0.4.1) */
+ VIR_CRED_ECHOPROMPT = 6, /* Challenge response (Since: 0.4.1) */
+ VIR_CRED_NOECHOPROMPT = 7, /* Challenge response (Since: 0.4.1) */
+ VIR_CRED_REALM = 8, /* Authentication realm (Since: 0.4.1) */
+ VIR_CRED_EXTERNAL = 9, /* Externally managed credential (Since: 0.4.1) */
# ifdef VIR_ENUM_SENTINELS
- VIR_CRED_LAST /* More may be added - expect the unexpected (Since: v0.9.10) */
+ VIR_CRED_LAST /* More may be added - expect the unexpected (Since: 0.9.10) */
# endif
} virConnectCredentialType;
@@ -626,14 +626,14 @@ struct _virConnectCredential {
/**
* virConnectCredential:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef struct _virConnectCredential virConnectCredential;
/**
* virConnectCredentialPtr:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef virConnectCredential *virConnectCredentialPtr;
@@ -651,7 +651,7 @@ typedef virConnectCredential *virConnectCredentialPtr;
*
* Returns 0 if all interactions were filled, or -1 upon error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef int (*virConnectAuthCallbackPtr)(virConnectCredentialPtr cred,
unsigned int ncred,
@@ -668,14 +668,14 @@ struct _virConnectAuth {
/**
* virConnectAuth:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef struct _virConnectAuth virConnectAuth;
/**
* virConnectAuthPtr:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef virConnectAuth *virConnectAuthPtr;
@@ -689,7 +689,7 @@ typedef virConnectAuth *virConnectAuthPtr;
* suitable for the application's needs an alternative implementation
* should be provided.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault;
@@ -699,7 +699,7 @@ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault;
* This macro provides the length of the buffer required
* for virDomainGetUUID()
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
# define VIR_UUID_BUFLEN (16)
@@ -709,7 +709,7 @@ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault;
* This macro provides the length of the buffer required
* for virDomainGetUUIDString()
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
# define VIR_UUID_STRING_BUFLEN (36+1)
@@ -736,7 +736,7 @@ int virConnectClose (virConnectPtr conn);
*
* The operating system user name as VIR_TYPED_PARAM_STRING.
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_USER_NAME "user-name"
@@ -745,7 +745,7 @@ int virConnectClose (virConnectPtr conn);
*
* The UNIX user ID as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_UNIX_USER_ID "unix-user-id"
@@ -754,7 +754,7 @@ int virConnectClose (virConnectPtr conn);
*
* The operating system group name as VIR_TYPED_PARAM_STRING.
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_GROUP_NAME "group-name"
@@ -763,7 +763,7 @@ int virConnectClose (virConnectPtr conn);
*
* The UNIX group ID as VIR_TYPED_PARAM_ULLONG.
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_UNIX_GROUP_ID "unix-group-id"
@@ -772,7 +772,7 @@ int virConnectClose (virConnectPtr conn);
*
* The operating system process ID as VIR_TYPED_PARAM_LLONG.
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_PROCESS_ID "process-id"
@@ -785,7 +785,7 @@ int virConnectClose (virConnectPtr conn);
* host operating system. On Linux this is usually clock
* ticks (as reported in /proc/$PID/stat field 22).
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_PROCESS_TIME "process-time"
@@ -794,7 +794,7 @@ int virConnectClose (virConnectPtr conn);
*
* The SASL authenticated username as VIR_TYPED_PARAM_STRING
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_SASL_USER_NAME "sasl-user-name"
@@ -803,7 +803,7 @@ int virConnectClose (virConnectPtr conn);
*
* The TLS x509 certificate distinguished named as VIR_TYPED_PARAM_STRING
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_X509_DISTINGUISHED_NAME "x509-distinguished-name"
@@ -812,7 +812,7 @@ int virConnectClose (virConnectPtr conn);
*
* The application's SELinux context as VIR_TYPED_PARAM_STRING.
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
# define VIR_CONNECT_IDENTITY_SELINUX_CONTEXT "selinux-context"
@@ -844,7 +844,7 @@ int virConnectSetKeepAlive(virConnectPtr conn,
* A callback function to be registered, and called when the connection
* is closed.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
typedef void (*virConnectCloseFunc)(virConnectPtr conn,
int reason,
@@ -910,29 +910,29 @@ int virConnectIsAlive(virConnectPtr conn);
/**
* virCPUCompareResult:
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
typedef enum {
- VIR_CPU_COMPARE_ERROR = -1, /* (Since: v0.7.5) */
- VIR_CPU_COMPARE_INCOMPATIBLE = 0, /* (Since: v0.7.5) */
- VIR_CPU_COMPARE_IDENTICAL = 1, /* (Since: v0.7.5) */
- VIR_CPU_COMPARE_SUPERSET = 2, /* (Since: v0.7.5) */
+ VIR_CPU_COMPARE_ERROR = -1, /* (Since: 0.7.5) */
+ VIR_CPU_COMPARE_INCOMPATIBLE = 0, /* (Since: 0.7.5) */
+ VIR_CPU_COMPARE_IDENTICAL = 1, /* (Since: 0.7.5) */
+ VIR_CPU_COMPARE_SUPERSET = 2, /* (Since: 0.7.5) */
# ifdef VIR_ENUM_SENTINELS
- VIR_CPU_COMPARE_LAST /* (Since: v0.9.10) */
+ VIR_CPU_COMPARE_LAST /* (Since: 0.9.10) */
# endif
} virCPUCompareResult;
/**
* virConnectCompareCPUFlags:
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
typedef enum {
VIR_CONNECT_COMPARE_CPU_FAIL_INCOMPATIBLE = (1 << 0), /* treat incompatible
- CPUs as failure (Since: v1.2.6) */
+ CPUs as failure (Since: 1.2.6) */
VIR_CONNECT_COMPARE_CPU_VALIDATE_XML = (1 << 1), /* validate the xml
- document (Since: v6.9.0) */
+ document (Since: 6.9.0) */
} virConnectCompareCPUFlags;
int virConnectCompareCPU(virConnectPtr conn,
@@ -956,11 +956,11 @@ int virConnectGetCPUModelNames(virConnectPtr conn,
*
* Flags when getting XML description of a computed CPU
*
- * Since: v1.1.2
+ * Since: 1.1.2
*/
typedef enum {
- VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES = (1 << 0), /* show all features (Since: v1.1.2) */
- VIR_CONNECT_BASELINE_CPU_MIGRATABLE = (1 << 1), /* filter out non-migratable features (Since: v1.2.14) */
+ VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES = (1 << 0), /* show all features (Since: 1.1.2) */
+ VIR_CONNECT_BASELINE_CPU_MIGRATABLE = (1 << 1), /* filter out non-migratable features (Since: 1.2.14) */
} virConnectBaselineCPUFlags;
char *virConnectBaselineCPU(virConnectPtr conn,
@@ -987,14 +987,14 @@ int virNodeGetFreePages(virConnectPtr conn,
/**
* virNodeAllocPagesFlags:
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
typedef enum {
VIR_NODE_ALLOC_PAGES_ADD = 0, /* Add @pageCounts to the pages pool. This
- can be used only to size up the pool. (Since: v1.2.9) */
+ can be used only to size up the pool. (Since: 1.2.9) */
VIR_NODE_ALLOC_PAGES_SET = (1 << 0), /* Don't add @pageCounts, instead set
passed number of pages. This can be
- used to free allocated pages. (Since: v1.2.9) */
+ used to free allocated pages. (Since: 1.2.9) */
} virNodeAllocPagesFlags;
int virNodeAllocPages(virConnectPtr conn,
diff --git a/include/libvirt/libvirt-interface.h b/include/libvirt/libvirt-interface.h
index 66ede43f43..fcbec115c5 100644
--- a/include/libvirt/libvirt-interface.h
+++ b/include/libvirt/libvirt-interface.h
@@ -32,7 +32,7 @@
*
* a virInterface is a private structure representing a virtual interface.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
typedef struct _virInterface virInterface;
@@ -42,7 +42,7 @@ typedef struct _virInterface virInterface;
* a virInterfacePtr is pointer to a virInterface private structure, this is the
* type used to reference a virtual interface in the API.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
typedef virInterface *virInterfacePtr;
@@ -62,11 +62,11 @@ int virConnectListDefinedInterfaces (virConnectPtr conn,
*
* Flags used to filter the returned interfaces.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_CONNECT_LIST_INTERFACES_INACTIVE = 1 << 0, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_INTERFACES_ACTIVE = 1 << 1, /* (Since: v0.10.2) */
+ VIR_CONNECT_LIST_INTERFACES_INACTIVE = 1 << 0, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_INTERFACES_ACTIVE = 1 << 1, /* (Since: 0.10.2) */
} virConnectListAllInterfacesFlags;
int virConnectListAllInterfaces (virConnectPtr conn,
@@ -84,19 +84,19 @@ const char* virInterfaceGetMACString (virInterfacePtr iface);
/**
* virInterfaceXMLFlags:
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
typedef enum {
- VIR_INTERFACE_XML_INACTIVE = 1 << 0 /* dump inactive interface information (Since: v0.7.3) */
+ VIR_INTERFACE_XML_INACTIVE = 1 << 0 /* dump inactive interface information (Since: 0.7.3) */
} virInterfaceXMLFlags;
/**
* virInterfaceDefineFlags:
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
typedef enum {
- VIR_INTERFACE_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */
+ VIR_INTERFACE_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.7.0) */
} virInterfaceDefineFlags;
char * virInterfaceGetXMLDesc (virInterfacePtr iface,
diff --git a/include/libvirt/libvirt-network.h b/include/libvirt/libvirt-network.h
index 0a9f0ecb0d..d3e3fdeecf 100644
--- a/include/libvirt/libvirt-network.h
+++ b/include/libvirt/libvirt-network.h
@@ -30,10 +30,10 @@
/**
* virNetworkXMLFlags:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_NETWORK_XML_INACTIVE = (1 << 0), /* dump inactive network information (Since: v0.9.10) */
+ VIR_NETWORK_XML_INACTIVE = (1 << 0), /* dump inactive network information (Since: 0.9.10) */
} virNetworkXMLFlags;
/**
@@ -41,7 +41,7 @@ typedef enum {
*
* a virNetwork is a private structure representing a virtual network.
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
typedef struct _virNetwork virNetwork;
@@ -51,7 +51,7 @@ typedef struct _virNetwork virNetwork;
* a virNetworkPtr is pointer to a virNetwork private structure, this is the
* type used to reference a virtual network in the API.
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
typedef virNetwork *virNetworkPtr;
@@ -61,7 +61,7 @@ typedef virNetwork *virNetworkPtr;
* a virNetworkPort is a private structure representing a virtual network
* port
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
typedef struct _virNetworkPort virNetworkPort;
@@ -71,7 +71,7 @@ typedef struct _virNetworkPort virNetworkPort;
* a virNetworkPortPtr is pointer to a virNetworkPort private structure,
* this is the type used to reference a virtual network port in the API.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
typedef virNetworkPort *virNetworkPortPtr;
@@ -101,17 +101,17 @@ int virConnectListDefinedNetworks (virConnectPtr conn,
* Flags used to filter the returned networks. Flags in each group
* are exclusive attributes of a network.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_CONNECT_LIST_NETWORKS_INACTIVE = 1 << 0, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_NETWORKS_ACTIVE = 1 << 1, /* (Since: v0.10.2) */
+ VIR_CONNECT_LIST_NETWORKS_INACTIVE = 1 << 0, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NETWORKS_ACTIVE = 1 << 1, /* (Since: 0.10.2) */
- VIR_CONNECT_LIST_NETWORKS_PERSISTENT = 1 << 2, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_NETWORKS_TRANSIENT = 1 << 3, /* (Since: v0.10.2) */
+ VIR_CONNECT_LIST_NETWORKS_PERSISTENT = 1 << 2, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NETWORKS_TRANSIENT = 1 << 3, /* (Since: 0.10.2) */
- VIR_CONNECT_LIST_NETWORKS_AUTOSTART = 1 << 4, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_NETWORKS_NO_AUTOSTART = 1 << 5, /* (Since: v0.10.2) */
+ VIR_CONNECT_LIST_NETWORKS_AUTOSTART = 1 << 4, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NETWORKS_NO_AUTOSTART = 1 << 5, /* (Since: 0.10.2) */
} virConnectListAllNetworksFlags;
int virConnectListAllNetworks (virConnectPtr conn,
@@ -130,10 +130,10 @@ virNetworkPtr virNetworkLookupByUUIDString (virConnectPtr conn,
/**
* virNetworkCreateFlags:
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
typedef enum {
- VIR_NETWORK_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.8.0) */
+ VIR_NETWORK_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.8.0) */
} virNetworkCreateFlags;
/*
@@ -147,10 +147,10 @@ virNetworkPtr virNetworkCreateXMLFlags(virConnectPtr conn,
/**
* virNetworkDefineFlags:
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
typedef enum {
- VIR_NETWORK_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */
+ VIR_NETWORK_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.7.0) */
} virNetworkDefineFlags;
/*
@@ -173,16 +173,16 @@ int virNetworkUndefine (virNetworkPtr network);
* describes which type of update to perform on a <network>
* definition.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_NETWORK_UPDATE_COMMAND_NONE = 0, /* (invalid (Since: v0.10.2) */
- VIR_NETWORK_UPDATE_COMMAND_MODIFY = 1, /* modify an existing element (Since: v0.10.2) */
- VIR_NETWORK_UPDATE_COMMAND_DELETE = 2, /* delete an existing element (Since: v0.10.2) */
- VIR_NETWORK_UPDATE_COMMAND_ADD_LAST = 3, /* add an element at end of list (Since: v0.10.2) */
- VIR_NETWORK_UPDATE_COMMAND_ADD_FIRST = 4, /* add an element at start of list (Since: v0.10.2) */
+ VIR_NETWORK_UPDATE_COMMAND_NONE = 0, /* (invalid (Since: 0.10.2) */
+ VIR_NETWORK_UPDATE_COMMAND_MODIFY = 1, /* modify an existing element (Since: 0.10.2) */
+ VIR_NETWORK_UPDATE_COMMAND_DELETE = 2, /* delete an existing element (Since: 0.10.2) */
+ VIR_NETWORK_UPDATE_COMMAND_ADD_LAST = 3, /* add an element at end of list (Since: 0.10.2) */
+ VIR_NETWORK_UPDATE_COMMAND_ADD_FIRST = 4, /* add an element at start of list (Since: 0.10.2) */
# ifdef VIR_ENUM_SENTINELS
- VIR_NETWORK_UPDATE_COMMAND_LAST /* (Since: v0.10.2) */
+ VIR_NETWORK_UPDATE_COMMAND_LAST /* (Since: 0.10.2) */
# endif
} virNetworkUpdateCommand;
@@ -192,24 +192,24 @@ typedef enum {
* describes which section of a <network> definition the provided
* xml should be applied to.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_NETWORK_SECTION_NONE = 0, /* (invalid (Since: v0.10.2) */
- VIR_NETWORK_SECTION_BRIDGE = 1, /* <bridge> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_DOMAIN = 2, /* <domain> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_IP = 3, /* <ip> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_IP_DHCP_HOST = 4, /* <ip>/<dhcp>/<host> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_IP_DHCP_RANGE = 5, /* <ip>/<dhcp>/<range> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_FORWARD = 6, /* <forward> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_FORWARD_INTERFACE = 7, /* <forward>/<interface> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_FORWARD_PF = 8, /* <forward>/<pf> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_PORTGROUP = 9, /* <portgroup> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_DNS_HOST = 10, /* <dns>/<host> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_DNS_TXT = 11, /* <dns>/<txt> (Since: v0.10.2) */
- VIR_NETWORK_SECTION_DNS_SRV = 12, /* <dns>/<srv> (Since: v0.10.2) */
+ VIR_NETWORK_SECTION_NONE = 0, /* (invalid (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_BRIDGE = 1, /* <bridge> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_DOMAIN = 2, /* <domain> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_IP = 3, /* <ip> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_IP_DHCP_HOST = 4, /* <ip>/<dhcp>/<host> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_IP_DHCP_RANGE = 5, /* <ip>/<dhcp>/<range> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_FORWARD = 6, /* <forward> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_FORWARD_INTERFACE = 7, /* <forward>/<interface> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_FORWARD_PF = 8, /* <forward>/<pf> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_PORTGROUP = 9, /* <portgroup> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_DNS_HOST = 10, /* <dns>/<host> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_DNS_TXT = 11, /* <dns>/<txt> (Since: 0.10.2) */
+ VIR_NETWORK_SECTION_DNS_SRV = 12, /* <dns>/<srv> (Since: 0.10.2) */
# ifdef VIR_ENUM_SENTINELS
- VIR_NETWORK_SECTION_LAST /* (Since: v0.10.2) */
+ VIR_NETWORK_SECTION_LAST /* (Since: 0.10.2) */
# endif
} virNetworkUpdateSection;
@@ -218,13 +218,13 @@ typedef enum {
*
* Flags to control options for virNetworkUpdate()
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
VIR_NETWORK_UPDATE_AFFECT_CURRENT = 0, /* affect live if network is active,
- config if it's not active (Since: v0.10.2) */
- VIR_NETWORK_UPDATE_AFFECT_LIVE = 1 << 0, /* affect live state of network only (Since: v0.10.2) */
- VIR_NETWORK_UPDATE_AFFECT_CONFIG = 1 << 1, /* affect persistent config only (Since: v0.10.2) */
+ config if it's not active (Since: 0.10.2) */
+ VIR_NETWORK_UPDATE_AFFECT_LIVE = 1 << 0, /* affect live state of network only (Since: 0.10.2) */
+ VIR_NETWORK_UPDATE_AFFECT_CONFIG = 1 << 1, /* affect persistent config only (Since: 0.10.2) */
} virNetworkUpdateFlags;
/*
@@ -274,16 +274,16 @@ int virNetworkIsPersistent(virNetworkPtr net);
*
* a virNetworkEventLifecycleType is emitted during network lifecycle events
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
typedef enum {
- VIR_NETWORK_EVENT_DEFINED = 0, /* (Since: v1.2.1) */
- VIR_NETWORK_EVENT_UNDEFINED = 1, /* (Since: v1.2.1) */
- VIR_NETWORK_EVENT_STARTED = 2, /* (Since: v1.2.1) */
- VIR_NETWORK_EVENT_STOPPED = 3, /* (Since: v1.2.1) */
+ VIR_NETWORK_EVENT_DEFINED = 0, /* (Since: 1.2.1) */
+ VIR_NETWORK_EVENT_UNDEFINED = 1, /* (Since: 1.2.1) */
+ VIR_NETWORK_EVENT_STARTED = 2, /* (Since: 1.2.1) */
+ VIR_NETWORK_EVENT_STOPPED = 3, /* (Since: 1.2.1) */
# ifdef VIR_ENUM_SENTINELS
- VIR_NETWORK_EVENT_LAST /* (Since: v1.2.1) */
+ VIR_NETWORK_EVENT_LAST /* (Since: 1.2.1) */
# endif
} virNetworkEventLifecycleType;
@@ -301,7 +301,7 @@ typedef enum {
* The callback signature to use when registering for an event of type
* VIR_NETWORK_EVENT_ID_LIFECYCLE with virConnectNetworkEventRegisterAny()
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn,
virNetworkPtr net,
@@ -315,7 +315,7 @@ typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn,
* Used to cast the event specific callback into the generic one
* for use for virConnectNetworkEventRegisterAny()
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
# define VIR_NETWORK_EVENT_CALLBACK(cb) ((virConnectNetworkEventGenericCallback)(cb))
@@ -326,10 +326,10 @@ typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn,
* virConnectNetworkEventRegisterAny(). Each event id determines which
* signature of callback function will be used.
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
typedef enum {
- VIR_NETWORK_EVENT_ID_LIFECYCLE = 0, /* virConnectNetworkEventLifecycleCallback (Since: v1.2.1) */
+ VIR_NETWORK_EVENT_ID_LIFECYCLE = 0, /* virConnectNetworkEventLifecycleCallback (Since: 1.2.1) */
# ifdef VIR_ENUM_SENTINELS
VIR_NETWORK_EVENT_ID_LAST
@@ -338,7 +338,7 @@ typedef enum {
* added to the libvirt API. It reflects the last event ID supported
* by this version of the libvirt API.
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
# endif
} virNetworkEventID;
@@ -346,28 +346,28 @@ typedef enum {
/**
* virIPAddrType:
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
typedef enum {
- VIR_IP_ADDR_TYPE_IPV4, /* (Since: v1.2.6) */
- VIR_IP_ADDR_TYPE_IPV6, /* (Since: v1.2.6) */
+ VIR_IP_ADDR_TYPE_IPV4, /* (Since: 1.2.6) */
+ VIR_IP_ADDR_TYPE_IPV6, /* (Since: 1.2.6) */
# ifdef VIR_ENUM_SENTINELS
- VIR_IP_ADDR_TYPE_LAST /* (Since: v1.2.6) */
+ VIR_IP_ADDR_TYPE_LAST /* (Since: 1.2.6) */
# endif
} virIPAddrType;
/**
* virNetworkDHCPLease:
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
typedef struct _virNetworkDHCPLease virNetworkDHCPLease;
/**
* virNetworkDHCPLeasePtr:
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
typedef virNetworkDHCPLease *virNetworkDHCPLeasePtr;
struct _virNetworkDHCPLease {
@@ -401,7 +401,7 @@ int virNetworkGetDHCPLeases(virNetworkPtr network,
* passed in a different parameter position; use VIR_NETWORK_EVENT_CALLBACK()
* when registering an appropriate handler.
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
typedef void (*virConnectNetworkEventGenericCallback)(virConnectPtr conn,
virNetworkPtr net,
@@ -430,11 +430,11 @@ virNetworkPortLookupByUUIDString(virNetworkPtr net,
/**
* virNetworkPortCreateFlags:
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
typedef enum {
- VIR_NETWORK_PORT_CREATE_RECLAIM = (1 << 0), /* reclaim existing used resources (Since: v5.5.0) */
- VIR_NETWORK_PORT_CREATE_VALIDATE = (1 << 1), /* Validate the XML document against schema (Since: v7.8.0) */
+ VIR_NETWORK_PORT_CREATE_RECLAIM = (1 << 0), /* reclaim existing used resources (Since: 5.5.0) */
+ VIR_NETWORK_PORT_CREATE_VALIDATE = (1 << 1), /* Validate the XML document against schema (Since: 7.8.0) */
} virNetworkPortCreateFlags;
virNetworkPortPtr
@@ -463,7 +463,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the inbound average of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_IN_AVERAGE "inbound.average"
@@ -472,7 +472,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the inbound peak of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_IN_PEAK "inbound.peak"
@@ -481,7 +481,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the inbound burst of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_IN_BURST "inbound.burst"
@@ -490,7 +490,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the inbound floor of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_IN_FLOOR "inbound.floor"
@@ -499,7 +499,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the outbound average of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_OUT_AVERAGE "outbound.average"
@@ -508,7 +508,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the outbound peak of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_OUT_PEAK "outbound.peak"
@@ -517,7 +517,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Macro represents the outbound burst of NIC bandwidth, as a uint.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
# define VIR_NETWORK_PORT_BANDWIDTH_OUT_BURST "outbound.burst"
diff --git a/include/libvirt/libvirt-nodedev.h b/include/libvirt/libvirt-nodedev.h
index 455bc2ce57..4fccd3f614 100644
--- a/include/libvirt/libvirt-nodedev.h
+++ b/include/libvirt/libvirt-nodedev.h
@@ -33,7 +33,7 @@
*
* A virNodeDevice contains a node (host) device details.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef struct _virNodeDevice virNodeDevice;
@@ -45,7 +45,7 @@ typedef struct _virNodeDevice virNodeDevice;
* to call virNodeDeviceFree when done using a virNodeDevicePtr obtained
* from any of the above functions to avoid leaking memory.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
typedef virNodeDevice *virNodeDevicePtr;
@@ -65,34 +65,34 @@ int virNodeListDevices (virConnectPtr conn,
* Flags used to filter either by capability or active state, the
* returned node devices.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM = 1 << 0, /* System capability (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEV = 1 << 1, /* PCI device (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_DEV = 1 << 2, /* USB device (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_INTERFACE = 1 << 3, /* USB interface (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_NET = 1 << 4, /* Network device (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_HOST = 1 << 5, /* SCSI Host Bus Adapter (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_TARGET = 1 << 6, /* SCSI Target (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI = 1 << 7, /* SCSI device (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_STORAGE = 1 << 8, /* Storage device (Since: v0.10.2) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_FC_HOST = 1 << 9, /* FC Host Bus Adapter (Since: v1.0.4) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPORTS = 1 << 10, /* Capable of vport (Since: v1.0.4) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_GENERIC = 1 << 11, /* Capable of scsi_generic (Since: v1.1.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_DRM = 1 << 12, /* DRM device (Since: v3.1.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV_TYPES = 1 << 13, /* Capable of mediated devices (Since: v3.4.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV = 1 << 14, /* Mediated device (Since: v3.4.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCW_DEV = 1 << 15, /* CCW device (Since: v3.4.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_CSS_DEV = 1 << 16, /* CSS device (Since: v6.8.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_VDPA = 1 << 17, /* vDPA device (Since: v6.9.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_CARD = 1 << 18, /* s390 AP Card device (Since: v7.0.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_QUEUE = 1 << 19, /* s390 AP Queue (Since: v7.0.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_MATRIX = 1 << 20, /* s390 AP Matrix (Since: v7.0.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPD = 1 << 21, /* Device with VPD (Since: v7.9.0) */
-
- VIR_CONNECT_LIST_NODE_DEVICES_INACTIVE = 1 << 30, /* Inactive devices (Since: v7.3.0) */
- VIR_CONNECT_LIST_NODE_DEVICES_ACTIVE = 1U << 31, /* Active devices (Since: v7.3.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM = 1 << 0, /* System capability (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEV = 1 << 1, /* PCI device (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_DEV = 1 << 2, /* USB device (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_INTERFACE = 1 << 3, /* USB interface (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_NET = 1 << 4, /* Network device (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_HOST = 1 << 5, /* SCSI Host Bus Adapter (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_TARGET = 1 << 6, /* SCSI Target (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI = 1 << 7, /* SCSI device (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_STORAGE = 1 << 8, /* Storage device (Since: 0.10.2) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_FC_HOST = 1 << 9, /* FC Host Bus Adapter (Since: 1.0.4) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPORTS = 1 << 10, /* Capable of vport (Since: 1.0.4) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_GENERIC = 1 << 11, /* Capable of scsi_generic (Since: 1.1.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_DRM = 1 << 12, /* DRM device (Since: 3.1.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV_TYPES = 1 << 13, /* Capable of mediated devices (Since: 3.4.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV = 1 << 14, /* Mediated device (Since: 3.4.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCW_DEV = 1 << 15, /* CCW device (Since: 3.4.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_CSS_DEV = 1 << 16, /* CSS device (Since: 6.8.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_VDPA = 1 << 17, /* vDPA device (Since: 6.9.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_CARD = 1 << 18, /* s390 AP Card device (Since: 7.0.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_QUEUE = 1 << 19, /* s390 AP Queue (Since: 7.0.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_MATRIX = 1 << 20, /* s390 AP Matrix (Since: 7.0.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPD = 1 << 21, /* Device with VPD (Since: 7.9.0) */
+
+ VIR_CONNECT_LIST_NODE_DEVICES_INACTIVE = 1 << 30, /* Inactive devices (Since: 7.3.0) */
+ VIR_CONNECT_LIST_NODE_DEVICES_ACTIVE = 1U << 31, /* Active devices (Since: 7.3.0) */
} virConnectListAllNodeDeviceFlags;
int virConnectListAllNodeDevices (virConnectPtr conn,
@@ -162,7 +162,7 @@ int virNodeDeviceIsActive(virNodeDevicePtr dev);
* Used to cast the event specific callback into the generic one
* for use for virConnectNodeDeviceEventRegisterAny()
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
# define VIR_NODE_DEVICE_EVENT_CALLBACK(cb)((virConnectNodeDeviceEventGenericCallback)(cb))
@@ -173,11 +173,11 @@ int virNodeDeviceIsActive(virNodeDevicePtr dev);
* virConnectNodeDeviceEventRegisterAny(). Each event id determines which
* signature of callback function will be used.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
typedef enum {
- VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE = 0, /* virConnectNodeDeviceEventLifecycleCallback (Since: v2.2.0) */
- VIR_NODE_DEVICE_EVENT_ID_UPDATE = 1, /* virConnectNodeDeviceEventGenericCallback (Since: v2.2.0) */
+ VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE = 0, /* virConnectNodeDeviceEventLifecycleCallback (Since: 2.2.0) */
+ VIR_NODE_DEVICE_EVENT_ID_UPDATE = 1, /* virConnectNodeDeviceEventGenericCallback (Since: 2.2.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_NODE_DEVICE_EVENT_ID_LAST
@@ -186,7 +186,7 @@ typedef enum {
* added to the libvirt API. It reflects the last event ID supported
* by this version of the libvirt API.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
# endif
} virNodeDeviceEventID;
@@ -203,7 +203,7 @@ typedef enum {
* passed in a different parameter position; use
* VIR_NODE_DEVICE_EVENT_CALLBACK() when registering an appropriate handler.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
typedef void (*virConnectNodeDeviceEventGenericCallback)(virConnectPtr conn,
virNodeDevicePtr dev,
@@ -226,16 +226,16 @@ int virConnectNodeDeviceEventDeregisterAny(virConnectPtr conn,
* a virNodeDeviceEventLifecycleType is emitted during node device
* lifecycle events
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
typedef enum {
- VIR_NODE_DEVICE_EVENT_CREATED = 0, /* (Since: v2.2.0) */
- VIR_NODE_DEVICE_EVENT_DELETED = 1, /* (Since: v2.2.0) */
- VIR_NODE_DEVICE_EVENT_DEFINED = 2, /* (Since: v7.3.0) */
- VIR_NODE_DEVICE_EVENT_UNDEFINED = 3, /* (Since: v7.3.0) */
+ VIR_NODE_DEVICE_EVENT_CREATED = 0, /* (Since: 2.2.0) */
+ VIR_NODE_DEVICE_EVENT_DELETED = 1, /* (Since: 2.2.0) */
+ VIR_NODE_DEVICE_EVENT_DEFINED = 2, /* (Since: 7.3.0) */
+ VIR_NODE_DEVICE_EVENT_UNDEFINED = 3, /* (Since: 7.3.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_NODE_DEVICE_EVENT_LAST /* (Since: v2.2.0) */
+ VIR_NODE_DEVICE_EVENT_LAST /* (Since: 2.2.0) */
# endif
} virNodeDeviceEventLifecycleType;
@@ -254,7 +254,7 @@ typedef enum {
* VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE with
* virConnectNodeDeviceEventRegisterAny()
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
typedef void (*virConnectNodeDeviceEventLifecycleCallback)(virConnectPtr conn,
virNodeDevicePtr dev,
diff --git a/include/libvirt/libvirt-nwfilter.h b/include/libvirt/libvirt-nwfilter.h
index 279cc3740e..33b842b464 100644
--- a/include/libvirt/libvirt-nwfilter.h
+++ b/include/libvirt/libvirt-nwfilter.h
@@ -32,7 +32,7 @@
*
* a virNWFilter is a private structure representing a network filter
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef struct _virNWFilter virNWFilter;
@@ -42,7 +42,7 @@ typedef struct _virNWFilter virNWFilter;
* a virNWFilterPtr is pointer to a virNWFilter private structure,
* this is the type used to reference a network filter in the API.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
typedef virNWFilter *virNWFilterPtr;
@@ -52,7 +52,7 @@ typedef virNWFilter *virNWFilterPtr;
* a virNWFilterBinding is a private structure representing a network
* filter binding to a port
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
typedef struct _virNWFilterBinding virNWFilterBinding;
@@ -63,7 +63,7 @@ typedef struct _virNWFilterBinding virNWFilterBinding;
* structure, this is the type used to reference a network filter
* port binding in the API.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
typedef virNWFilterBinding *virNWFilterBindingPtr;
@@ -90,10 +90,10 @@ virNWFilterPtr virNWFilterLookupByUUIDString (virConnectPtr conn,
/**
* virNWFilterDefineFlags:
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
typedef enum {
- VIR_NWFILTER_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */
+ VIR_NWFILTER_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.7.0) */
} virNWFilterDefineFlags;
/*
@@ -123,10 +123,10 @@ int virNWFilterFree (virNWFilterPtr nwfilter);
/**
* virNWFilterBindingCreateFlags:
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
typedef enum {
- VIR_NWFILTER_BINDING_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.8.0) */
+ VIR_NWFILTER_BINDING_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.8.0) */
} virNWFilterBindingCreateFlags;
const char* virNWFilterGetName (virNWFilterPtr nwfilter);
diff --git a/include/libvirt/libvirt-qemu.h b/include/libvirt/libvirt-qemu.h
index 7aff5a1c96..a26498ab89 100644
--- a/include/libvirt/libvirt-qemu.h
+++ b/include/libvirt/libvirt-qemu.h
@@ -33,11 +33,11 @@ extern "C" {
/**
* virDomainQemuMonitorCommandFlags:
*
- * Since: v0.8.8
+ * Since: 0.8.8
*/
typedef enum {
- VIR_DOMAIN_QEMU_MONITOR_COMMAND_DEFAULT = 0, /* (Since: v0.8.8) */
- VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP = (1 << 0), /* cmd is in HMP (Since: v0.8.8) */
+ VIR_DOMAIN_QEMU_MONITOR_COMMAND_DEFAULT = 0, /* (Since: 0.8.8) */
+ VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP = (1 << 0), /* cmd is in HMP (Since: 0.8.8) */
} virDomainQemuMonitorCommandFlags;
int virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd,
@@ -58,14 +58,14 @@ virDomainPtr virDomainQemuAttach(virConnectPtr domain,
/**
* virDomainQemuAgentCommandTimeoutValues:
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
typedef enum {
- VIR_DOMAIN_QEMU_AGENT_COMMAND_MIN = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK, /* (Since: v0.10.0) */
- VIR_DOMAIN_QEMU_AGENT_COMMAND_BLOCK = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK, /* (Since: v0.10.0) */
- VIR_DOMAIN_QEMU_AGENT_COMMAND_DEFAULT = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT, /* (Since: v0.10.0) */
- VIR_DOMAIN_QEMU_AGENT_COMMAND_NOWAIT = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT, /* (Since: v0.10.0) */
- VIR_DOMAIN_QEMU_AGENT_COMMAND_SHUTDOWN = 60, /* (Since: v1.2.15) */
+ VIR_DOMAIN_QEMU_AGENT_COMMAND_MIN = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK, /* (Since: 0.10.0) */
+ VIR_DOMAIN_QEMU_AGENT_COMMAND_BLOCK = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK, /* (Since: 0.10.0) */
+ VIR_DOMAIN_QEMU_AGENT_COMMAND_DEFAULT = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT, /* (Since: 0.10.0) */
+ VIR_DOMAIN_QEMU_AGENT_COMMAND_NOWAIT = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT, /* (Since: 0.10.0) */
+ VIR_DOMAIN_QEMU_AGENT_COMMAND_SHUTDOWN = 60, /* (Since: 1.2.15) */
} virDomainQemuAgentCommandTimeoutValues;
char *virDomainQemuAgentCommand(virDomainPtr domain, const char *cmd,
@@ -85,7 +85,7 @@ char *virDomainQemuAgentCommand(virDomainPtr domain, const char *cmd,
* The callback signature to use when registering for a qemu monitor
* event with virConnectDomainQemuMonitorEventRegister().
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn,
virDomainPtr dom,
@@ -99,13 +99,13 @@ typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn,
/**
* virConnectDomainQemuMonitorEventRegisterFlags:
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
typedef enum {
- /* Event filter is a regex rather than a literal string (Since: v1.2.3) */
+ /* Event filter is a regex rather than a literal string (Since: 1.2.3) */
VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_REGEX = (1 << 0),
- /* Event filter is case insensitive (Since: v1.2.3) */
+ /* Event filter is case insensitive (Since: 1.2.3) */
VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_NOCASE = (1 << 1),
} virConnectDomainQemuMonitorEventRegisterFlags;
diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-secret.h
index a71c3e7eba..761437d4ad 100644
--- a/include/libvirt/libvirt-secret.h
+++ b/include/libvirt/libvirt-secret.h
@@ -34,29 +34,29 @@
* A virSecret stores a secret value (e.g. a passphrase or encryption key)
* and associated metadata.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
typedef struct _virSecret virSecret;
/**
* virSecretPtr:
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
typedef virSecret *virSecretPtr;
/**
* virSecretUsageType:
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
typedef enum {
- VIR_SECRET_USAGE_TYPE_NONE = 0, /* (Since: v0.7.1) */
- VIR_SECRET_USAGE_TYPE_VOLUME = 1, /* (Since: v0.7.1) */
- VIR_SECRET_USAGE_TYPE_CEPH = 2, /* (Since: v0.9.7) */
- VIR_SECRET_USAGE_TYPE_ISCSI = 3, /* (Since: v1.0.4) */
- VIR_SECRET_USAGE_TYPE_TLS = 4, /* (Since: v2.3.0) */
- VIR_SECRET_USAGE_TYPE_VTPM = 5, /* (Since: v5.6.0) */
+ VIR_SECRET_USAGE_TYPE_NONE = 0, /* (Since: 0.7.1) */
+ VIR_SECRET_USAGE_TYPE_VOLUME = 1, /* (Since: 0.7.1) */
+ VIR_SECRET_USAGE_TYPE_CEPH = 2, /* (Since: 0.9.7) */
+ VIR_SECRET_USAGE_TYPE_ISCSI = 3, /* (Since: 1.0.4) */
+ VIR_SECRET_USAGE_TYPE_TLS = 4, /* (Since: 2.3.0) */
+ VIR_SECRET_USAGE_TYPE_VTPM = 5, /* (Since: 5.6.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_SECRET_USAGE_TYPE_LAST
@@ -65,7 +65,7 @@ typedef enum {
* added to the libvirt API. It reflects the last usage type supported
* by this version of the libvirt API.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
# endif
} virSecretUsageType;
@@ -82,17 +82,17 @@ int virConnectListSecrets (virConnectPtr conn,
* Flags used to filter the returned secrets. Flags in each group
* are exclusive attributes of a secret.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
VIR_CONNECT_LIST_SECRETS_EPHEMERAL = 1 << 0, /* kept in memory, never
- stored persistently (Since: v0.10.2) */
- VIR_CONNECT_LIST_SECRETS_NO_EPHEMERAL = 1 << 1, /* (Since: v0.10.2) */
+ stored persistently (Since: 0.10.2) */
+ VIR_CONNECT_LIST_SECRETS_NO_EPHEMERAL = 1 << 1, /* (Since: 0.10.2) */
VIR_CONNECT_LIST_SECRETS_PRIVATE = 1 << 2, /* not revealed to any caller
of libvirt, nor to any other
- node (Since: v0.10.2) */
- VIR_CONNECT_LIST_SECRETS_NO_PRIVATE = 1 << 3, /* (Since: v0.10.2) */
+ node (Since: 0.10.2) */
+ VIR_CONNECT_LIST_SECRETS_NO_PRIVATE = 1 << 3, /* (Since: 0.10.2) */
} virConnectListAllSecretsFlags;
int virConnectListAllSecrets(virConnectPtr conn,
@@ -108,10 +108,10 @@ virSecretPtr virSecretLookupByUsage(virConnectPtr conn,
/**
* virSecretDefineFlags:
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
typedef enum {
- VIR_SECRET_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */
+ VIR_SECRET_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.7.0) */
} virSecretDefineFlags;
virSecretPtr virSecretDefineXML (virConnectPtr conn,
@@ -142,7 +142,7 @@ int virSecretFree (virSecretPtr secret);
* Used to cast the event specific callback into the generic one
* for use for virConnectSecretEventRegisterAny()
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# define VIR_SECRET_EVENT_CALLBACK(cb)((virConnectSecretEventGenericCallback)(cb))
@@ -153,11 +153,11 @@ int virSecretFree (virSecretPtr secret);
* virConnectSecretEventRegisterAny(). Each event id determines which
* signature of callback function will be used.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
typedef enum {
- VIR_SECRET_EVENT_ID_LIFECYCLE = 0, /* virConnectSecretEventLifecycleCallback (Since: v3.0.0) */
- VIR_SECRET_EVENT_ID_VALUE_CHANGED = 1, /* virConnectSecretEventGenericCallback (Since: v3.0.0) */
+ VIR_SECRET_EVENT_ID_LIFECYCLE = 0, /* virConnectSecretEventLifecycleCallback (Since: 3.0.0) */
+ VIR_SECRET_EVENT_ID_VALUE_CHANGED = 1, /* virConnectSecretEventGenericCallback (Since: 3.0.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_SECRET_EVENT_ID_LAST
@@ -166,7 +166,7 @@ typedef enum {
* added to the libvirt API. It reflects the last event ID supported
* by this version of the libvirt API.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
# endif
} virSecretEventID;
@@ -183,7 +183,7 @@ typedef enum {
* passed in a different parameter position; use
* VIR_SECRET_EVENT_CALLBACK() when registering an appropriate handler.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
typedef void (*virConnectSecretEventGenericCallback)(virConnectPtr conn,
virSecretPtr secret,
@@ -206,14 +206,14 @@ int virConnectSecretEventDeregisterAny(virConnectPtr conn,
* a virSecretEventLifecycleType is emitted during secret
* lifecycle events
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
typedef enum {
- VIR_SECRET_EVENT_DEFINED = 0, /* (Since: v3.0.0) */
- VIR_SECRET_EVENT_UNDEFINED = 1, /* (Since: v3.0.0) */
+ VIR_SECRET_EVENT_DEFINED = 0, /* (Since: 3.0.0) */
+ VIR_SECRET_EVENT_UNDEFINED = 1, /* (Since: 3.0.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_SECRET_EVENT_LAST /* (Since: v3.0.0) */
+ VIR_SECRET_EVENT_LAST /* (Since: 3.0.0) */
# endif
} virSecretEventLifecycleType;
@@ -232,7 +232,7 @@ typedef enum {
* VIR_SECRET_EVENT_ID_LIFECYCLE with
* virConnectSecretEventRegisterAny()
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
typedef void (*virConnectSecretEventLifecycleCallback)(virConnectPtr conn,
virSecretPtr secret,
diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h
index 30e3dc25c5..af1c50b9f1 100644
--- a/include/libvirt/libvirt-storage.h
+++ b/include/libvirt/libvirt-storage.h
@@ -33,7 +33,7 @@
*
* a virStoragePool is a private structure representing a storage pool
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef struct _virStoragePool virStoragePool;
@@ -43,7 +43,7 @@ typedef struct _virStoragePool virStoragePool;
* a virStoragePoolPtr is pointer to a virStoragePool private structure, this is the
* type used to reference a storage pool in the API.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef virStoragePool *virStoragePoolPtr;
@@ -51,60 +51,60 @@ typedef virStoragePool *virStoragePoolPtr;
/**
* virStoragePoolState:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_STORAGE_POOL_INACTIVE = 0, /* Not running (Since: v0.4.1) */
- VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available (Since: v0.4.1) */
- VIR_STORAGE_POOL_RUNNING = 2, /* Running normally (Since: v0.4.1) */
- VIR_STORAGE_POOL_DEGRADED = 3, /* Running degraded (Since: v0.4.1) */
- VIR_STORAGE_POOL_INACCESSIBLE = 4, /* Running, but not accessible (Since: v0.8.2) */
+ VIR_STORAGE_POOL_INACTIVE = 0, /* Not running (Since: 0.4.1) */
+ VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available (Since: 0.4.1) */
+ VIR_STORAGE_POOL_RUNNING = 2, /* Running normally (Since: 0.4.1) */
+ VIR_STORAGE_POOL_DEGRADED = 3, /* Running degraded (Since: 0.4.1) */
+ VIR_STORAGE_POOL_INACCESSIBLE = 4, /* Running, but not accessible (Since: 0.8.2) */
# ifdef VIR_ENUM_SENTINELS
- VIR_STORAGE_POOL_STATE_LAST /* (Since: v0.9.10) */
+ VIR_STORAGE_POOL_STATE_LAST /* (Since: 0.9.10) */
# endif
} virStoragePoolState;
/**
* virStoragePoolBuildFlags:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_STORAGE_POOL_BUILD_NEW = 0, /* Regular build from scratch (Since: v0.4.1) */
- VIR_STORAGE_POOL_BUILD_REPAIR = (1 << 0), /* Repair / reinitialize (Since: v0.4.1) */
- VIR_STORAGE_POOL_BUILD_RESIZE = (1 << 1), /* Extend existing pool (Since: v0.4.1) */
- VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = (1 << 2), /* Do not overwrite existing pool (Since: v0.9.5) */
- VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data (Since: v0.9.5) */
+ VIR_STORAGE_POOL_BUILD_NEW = 0, /* Regular build from scratch (Since: 0.4.1) */
+ VIR_STORAGE_POOL_BUILD_REPAIR = (1 << 0), /* Repair / reinitialize (Since: 0.4.1) */
+ VIR_STORAGE_POOL_BUILD_RESIZE = (1 << 1), /* Extend existing pool (Since: 0.4.1) */
+ VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = (1 << 2), /* Do not overwrite existing pool (Since: 0.9.5) */
+ VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data (Since: 0.9.5) */
} virStoragePoolBuildFlags;
/**
* virStoragePoolDeleteFlags:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_STORAGE_POOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: v0.4.1) */
- VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: v0.4.1) */
+ VIR_STORAGE_POOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: 0.4.1) */
+ VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: 0.4.1) */
} virStoragePoolDeleteFlags;
/**
* virStoragePoolCreateFlags:
*
- * Since: v1.3.1
+ * Since: 1.3.1
*/
typedef enum {
- /* Create the pool but do not perform pool build (Since: v1.3.1) */
+ /* Create the pool but do not perform pool build (Since: 1.3.1) */
VIR_STORAGE_POOL_CREATE_NORMAL = 0,
- /* Create the pool and perform pool build without any flags (Since: v1.3.1) */
+ /* Create the pool and perform pool build without any flags (Since: 1.3.1) */
VIR_STORAGE_POOL_CREATE_WITH_BUILD = 1 << 0,
/* Create the pool and perform pool build using the
* VIR_STORAGE_POOL_BUILD_OVERWRITE flag. This is mutually
* exclusive to VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE
*
- * Since: v1.3.1
+ * Since: 1.3.1
*/
VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITE = 1 << 1,
@@ -112,7 +112,7 @@ typedef enum {
* VIR_STORAGE_POOL_BUILD_NO_OVERWRITE flag. This is mutually
* exclusive to VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITE
*
- * Since: v1.3.1
+ * Since: 1.3.1
*/
VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE = 1 << 2,
} virStoragePoolCreateFlags;
@@ -120,7 +120,7 @@ typedef enum {
/**
* virStoragePoolInfo:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef struct _virStoragePoolInfo virStoragePoolInfo;
@@ -134,7 +134,7 @@ struct _virStoragePoolInfo {
/**
* virStoragePoolInfoPtr:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef virStoragePoolInfo *virStoragePoolInfoPtr;
@@ -144,7 +144,7 @@ typedef virStoragePoolInfo *virStoragePoolInfoPtr;
*
* a virStorageVol is a private structure representing a storage volume
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef struct _virStorageVol virStorageVol;
@@ -154,7 +154,7 @@ typedef struct _virStorageVol virStorageVol;
* a virStorageVolPtr is pointer to a virStorageVol private structure, this is the
* type used to reference a storage volume in the API.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef virStorageVol *virStorageVolPtr;
@@ -162,59 +162,59 @@ typedef virStorageVol *virStorageVolPtr;
/**
* virStorageVolType:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes (Since: v0.4.1) */
- VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes (Since: v0.4.1) */
- VIR_STORAGE_VOL_DIR = 2, /* Directory-passthrough based volume (Since: v0.9.5) */
- VIR_STORAGE_VOL_NETWORK = 3, /* Network volumes like RBD (RADOS Block Device) (Since: v0.9.13) */
+ VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes (Since: 0.4.1) */
+ VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes (Since: 0.4.1) */
+ VIR_STORAGE_VOL_DIR = 2, /* Directory-passthrough based volume (Since: 0.9.5) */
+ VIR_STORAGE_VOL_NETWORK = 3, /* Network volumes like RBD (RADOS Block Device) (Since: 0.9.13) */
VIR_STORAGE_VOL_NETDIR = 4, /* Network accessible directory that can
- * contain other network volumes (Since: v1.2.0) */
- VIR_STORAGE_VOL_PLOOP = 5, /* Ploop based volumes (Since: v1.3.4) */
+ * contain other network volumes (Since: 1.2.0) */
+ VIR_STORAGE_VOL_PLOOP = 5, /* Ploop based volumes (Since: 1.3.4) */
# ifdef VIR_ENUM_SENTINELS
- VIR_STORAGE_VOL_LAST /* (Since: v0.9.10) */
+ VIR_STORAGE_VOL_LAST /* (Since: 0.9.10) */
# endif
} virStorageVolType;
/**
* virStorageVolDeleteFlags:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef enum {
- VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: v0.4.1) */
- VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: v0.4.1) */
- VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTS = 1 << 1, /* Force removal of volume, even if in use (Since: v1.2.21) */
+ VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: 0.4.1) */
+ VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: 0.4.1) */
+ VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTS = 1 << 1, /* Force removal of volume, even if in use (Since: 1.2.21) */
} virStorageVolDeleteFlags;
/**
* virStorageVolWipeAlgorithm:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes (Since: v0.9.10) */
+ VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes (Since: 0.9.10) */
VIR_STORAGE_VOL_WIPE_ALG_NNSA = 1, /* 4-pass NNSA Policy Letter
- NAP-14.1-C (XVI-8) (Since: v0.9.10) */
+ NAP-14.1-C (XVI-8) (Since: 0.9.10) */
VIR_STORAGE_VOL_WIPE_ALG_DOD = 2, /* 4-pass DoD 5220.22-M section
- 8-306 procedure (Since: v0.9.10) */
+ 8-306 procedure (Since: 0.9.10) */
VIR_STORAGE_VOL_WIPE_ALG_BSI = 3, /* 9-pass method recommended by the
German Center of Security in
- Information Technologies (Since: v0.9.10) */
- VIR_STORAGE_VOL_WIPE_ALG_GUTMANN = 4, /* The canonical 35-pass sequence (Since: v0.9.10) */
+ Information Technologies (Since: 0.9.10) */
+ VIR_STORAGE_VOL_WIPE_ALG_GUTMANN = 4, /* The canonical 35-pass sequence (Since: 0.9.10) */
VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER = 5, /* 7-pass method described by
Bruce Schneier in "Applied
- Cryptography" (1996) (Since: v0.9.10) */
- VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7 = 6, /* 7-pass random data (Since: v0.9.10) */
+ Cryptography" (1996) (Since: 0.9.10) */
+ VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7 = 6, /* 7-pass random data (Since: 0.9.10) */
- VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = 7, /* 33-pass random data (Since: v0.9.10) */
+ VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = 7, /* 33-pass random data (Since: 0.9.10) */
- VIR_STORAGE_VOL_WIPE_ALG_RANDOM = 8, /* 1-pass random data (Since: v0.9.10) */
+ VIR_STORAGE_VOL_WIPE_ALG_RANDOM = 8, /* 1-pass random data (Since: 0.9.10) */
VIR_STORAGE_VOL_WIPE_ALG_TRIM = 9, /* 1-pass, trim all data on the
- volume by using TRIM or DISCARD (Since: v1.3.2) */
+ volume by using TRIM or DISCARD (Since: 1.3.2) */
# ifdef VIR_ENUM_SENTINELS
VIR_STORAGE_VOL_WIPE_ALG_LAST
@@ -223,7 +223,7 @@ typedef enum {
* added to the libvirt API. It reflects the last algorithm supported
* by this version of the libvirt API.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
# endif
} virStorageVolWipeAlgorithm;
@@ -231,17 +231,17 @@ typedef enum {
/**
* virStorageVolInfoFlags:
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
typedef enum {
- VIR_STORAGE_VOL_USE_ALLOCATION = 0, /* (Since: v3.0.0) */
- VIR_STORAGE_VOL_GET_PHYSICAL = 1 << 0, /* Return the physical size in allocation (Since: v3.0.0) */
+ VIR_STORAGE_VOL_USE_ALLOCATION = 0, /* (Since: 3.0.0) */
+ VIR_STORAGE_VOL_GET_PHYSICAL = 1 << 0, /* Return the physical size in allocation (Since: 3.0.0) */
} virStorageVolInfoFlags;
/**
* virStorageVolInfo:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef struct _virStorageVolInfo virStorageVolInfo;
@@ -255,17 +255,17 @@ struct _virStorageVolInfo {
/**
* virStorageVolInfoPtr:
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
typedef virStorageVolInfo *virStorageVolInfoPtr;
/**
* virStorageXMLFlags:
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
typedef enum {
- VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information (Since: v0.9.13) */
+ VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information (Since: 0.9.13) */
} virStorageXMLFlags;
/*
@@ -300,32 +300,32 @@ int virConnectListDefinedStoragePools(virConnectPtr conn,
* Note that these flags come in groups; if all bits from a group are 0,
* then that group is not used to filter results.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
typedef enum {
- VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE = 1 << 0, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE = 1 << 1, /* (Since: v0.10.2) */
-
- VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT = 1 << 2, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT = 1 << 3, /* (Since: v0.10.2) */
-
- VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART = 1 << 4, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART = 1 << 5, /* (Since: v0.10.2) */
-
- VIR_CONNECT_LIST_STORAGE_POOLS_DIR = 1 << 6, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_FS = 1 << 7, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_NETFS = 1 << 8, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL = 1 << 9, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_DISK = 1 << 10, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI = 1 << 11, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_SCSI = 1 << 12, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_MPATH = 1 << 13, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_RBD = 1 << 14, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG = 1 << 15, /* (Since: v0.10.2) */
- VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER = 1 << 16, /* (Since: v1.2.1) */
- VIR_CONNECT_LIST_STORAGE_POOLS_ZFS = 1 << 17, /* (Since: v1.2.8) */
- VIR_CONNECT_LIST_STORAGE_POOLS_VSTORAGE = 1 << 18, /* (Since: v3.1.0) */
- VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI_DIRECT = 1 << 19, /* (Since: v5.6.0) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE = 1 << 0, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE = 1 << 1, /* (Since: 0.10.2) */
+
+ VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT = 1 << 2, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT = 1 << 3, /* (Since: 0.10.2) */
+
+ VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART = 1 << 4, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART = 1 << 5, /* (Since: 0.10.2) */
+
+ VIR_CONNECT_LIST_STORAGE_POOLS_DIR = 1 << 6, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_FS = 1 << 7, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_NETFS = 1 << 8, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL = 1 << 9, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_DISK = 1 << 10, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI = 1 << 11, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_SCSI = 1 << 12, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_MPATH = 1 << 13, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_RBD = 1 << 14, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG = 1 << 15, /* (Since: 0.10.2) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER = 1 << 16, /* (Since: 1.2.1) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_ZFS = 1 << 17, /* (Since: 1.2.8) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_VSTORAGE = 1 << 18, /* (Since: 3.1.0) */
+ VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI_DIRECT = 1 << 19, /* (Since: 5.6.0) */
} virConnectListAllStoragePoolsFlags;
int virConnectListAllStoragePools(virConnectPtr conn,
@@ -354,10 +354,10 @@ virStoragePoolPtr virStoragePoolLookupByTargetPath(virConnectPtr conn,
/**
* virStoragePoolDefineFlags:
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
typedef enum {
- VIR_STORAGE_POOL_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */
+ VIR_STORAGE_POOL_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: 7.7.0) */
} virStoragePoolDefineFlags;
/*
@@ -432,11 +432,11 @@ const char* virStorageVolGetKey (virStorageVolPtr vol);
/**
* virStorageVolCreateFlags:
*
- * Since: v1.0.1
+ * Since: 1.0.1
*/
typedef enum {
- VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA = 1 << 0, /* (Since: v1.0.1) */
- VIR_STORAGE_VOL_CREATE_REFLINK = 1 << 1, /* perform a btrfs lightweight copy (Since: v1.2.13) */
+ VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA = 1 << 0, /* (Since: 1.0.1) */
+ VIR_STORAGE_VOL_CREATE_REFLINK = 1 << 1, /* perform a btrfs lightweight copy (Since: 1.2.13) */
} virStorageVolCreateFlags;
virStorageVolPtr virStorageVolCreateXML (virStoragePoolPtr pool,
@@ -449,10 +449,10 @@ virStorageVolPtr virStorageVolCreateXMLFrom (virStoragePoolPtr pool,
/**
* virStorageVolDownloadFlags:
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
typedef enum {
- VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: v3.4.0) */
+ VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: 3.4.0) */
} virStorageVolDownloadFlags;
int virStorageVolDownload (virStorageVolPtr vol,
@@ -464,10 +464,10 @@ int virStorageVolDownload (virStorageVolPtr vol,
/**
* virStorageVolUploadFlags:
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
typedef enum {
- VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: v3.4.0) */
+ VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: 3.4.0) */
} virStorageVolUploadFlags;
int virStorageVolUpload (virStorageVolPtr vol,
@@ -498,12 +498,12 @@ char * virStorageVolGetPath (virStorageVolPtr vol);
/**
* virStorageVolResizeFlags:
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
typedef enum {
- VIR_STORAGE_VOL_RESIZE_ALLOCATE = 1 << 0, /* force allocation of new size (Since: v0.9.10) */
- VIR_STORAGE_VOL_RESIZE_DELTA = 1 << 1, /* size is relative to current (Since: v0.9.10) */
- VIR_STORAGE_VOL_RESIZE_SHRINK = 1 << 2, /* allow decrease in capacity (Since: v0.9.10) */
+ VIR_STORAGE_VOL_RESIZE_ALLOCATE = 1 << 0, /* force allocation of new size (Since: 0.9.10) */
+ VIR_STORAGE_VOL_RESIZE_DELTA = 1 << 1, /* size is relative to current (Since: 0.9.10) */
+ VIR_STORAGE_VOL_RESIZE_SHRINK = 1 << 2, /* allow decrease in capacity (Since: 0.9.10) */
} virStorageVolResizeFlags;
int virStorageVolResize (virStorageVolPtr vol,
@@ -519,7 +519,7 @@ int virStoragePoolIsPersistent(virStoragePoolPtr pool);
* Used to cast the event specific callback into the generic one
* for use for virConnectStoragePoolEventRegisterAny()
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# define VIR_STORAGE_POOL_EVENT_CALLBACK(cb)((virConnectStoragePoolEventGenericCallback)(cb))
@@ -530,11 +530,11 @@ int virStoragePoolIsPersistent(virStoragePoolPtr pool);
* virConnectStoragePoolEventRegisterAny(). Each event id determines which
* signature of callback function will be used.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef enum {
- VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE = 0, /* virConnectStoragePoolEventLifecycleCallback (Since: v2.0.0) */
- VIR_STORAGE_POOL_EVENT_ID_REFRESH = 1, /* virConnectStoragePoolEventGenericCallback (Since: v2.0.0) */
+ VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE = 0, /* virConnectStoragePoolEventLifecycleCallback (Since: 2.0.0) */
+ VIR_STORAGE_POOL_EVENT_ID_REFRESH = 1, /* virConnectStoragePoolEventGenericCallback (Since: 2.0.0) */
# ifdef VIR_ENUM_SENTINELS
VIR_STORAGE_POOL_EVENT_ID_LAST
@@ -543,7 +543,7 @@ typedef enum {
* added to the libvirt API. It reflects the last event ID supported
* by this version of the libvirt API.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
# endif
} virStoragePoolEventID;
@@ -560,7 +560,7 @@ typedef enum {
* passed in a different parameter position; use
* VIR_STORAGE_POOL_EVENT_CALLBACK() when registering an appropriate handler.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef void (*virConnectStoragePoolEventGenericCallback)(virConnectPtr conn,
virStoragePoolPtr pool,
@@ -583,18 +583,18 @@ int virConnectStoragePoolEventDeregisterAny(virConnectPtr conn,
* a virStoragePoolEventLifecycleType is emitted during storage pool
* lifecycle events
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef enum {
- VIR_STORAGE_POOL_EVENT_DEFINED = 0, /* (Since: v2.0.0) */
- VIR_STORAGE_POOL_EVENT_UNDEFINED = 1, /* (Since: v2.0.0) */
- VIR_STORAGE_POOL_EVENT_STARTED = 2, /* (Since: v2.0.0) */
- VIR_STORAGE_POOL_EVENT_STOPPED = 3, /* (Since: v2.0.0) */
- VIR_STORAGE_POOL_EVENT_CREATED = 4, /* (Since: v3.8.0) */
- VIR_STORAGE_POOL_EVENT_DELETED = 5, /* (Since: v3.8.0) */
+ VIR_STORAGE_POOL_EVENT_DEFINED = 0, /* (Since: 2.0.0) */
+ VIR_STORAGE_POOL_EVENT_UNDEFINED = 1, /* (Since: 2.0.0) */
+ VIR_STORAGE_POOL_EVENT_STARTED = 2, /* (Since: 2.0.0) */
+ VIR_STORAGE_POOL_EVENT_STOPPED = 3, /* (Since: 2.0.0) */
+ VIR_STORAGE_POOL_EVENT_CREATED = 4, /* (Since: 3.8.0) */
+ VIR_STORAGE_POOL_EVENT_DELETED = 5, /* (Since: 3.8.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_STORAGE_POOL_EVENT_LAST /* (Since: v2.0.0) */
+ VIR_STORAGE_POOL_EVENT_LAST /* (Since: 2.0.0) */
# endif
} virStoragePoolEventLifecycleType;
@@ -613,7 +613,7 @@ typedef enum {
* VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE with
* virConnectStoragePoolEventRegisterAny()
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
typedef void (*virConnectStoragePoolEventLifecycleCallback)(virConnectPtr conn,
virStoragePoolPtr pool,
diff --git a/include/libvirt/libvirt-stream.h b/include/libvirt/libvirt-stream.h
index 6b82711244..e3bdc8923a 100644
--- a/include/libvirt/libvirt-stream.h
+++ b/include/libvirt/libvirt-stream.h
@@ -31,10 +31,10 @@
/**
* virStreamFlags:
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef enum {
- VIR_STREAM_NONBLOCK = (1 << 0), /* (Since: v0.7.2) */
+ VIR_STREAM_NONBLOCK = (1 << 0), /* (Since: 0.7.2) */
} virStreamFlags;
virStreamPtr virStreamNew(virConnectPtr conn,
@@ -52,10 +52,10 @@ int virStreamRecv(virStreamPtr st,
/**
* virStreamRecvFlagsValues:
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
typedef enum {
- VIR_STREAM_RECV_STOP_AT_HOLE = (1 << 0), /* (Since: v3.4.0) */
+ VIR_STREAM_RECV_STOP_AT_HOLE = (1 << 0), /* (Since: 3.4.0) */
} virStreamRecvFlagsValues;
int virStreamRecvFlags(virStreamPtr st,
@@ -99,7 +99,7 @@ int virStreamRecvHole(virStreamPtr,
* Returns the number of bytes filled, 0 upon end
* of file, or -1 upon error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef int (*virStreamSourceFunc)(virStreamPtr st,
char *data,
@@ -139,7 +139,7 @@ int virStreamSendAll(virStreamPtr st,
* Returns 0 on success,
* -1 upon error
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
typedef int (*virStreamSourceHoleFunc)(virStreamPtr st,
int *inData,
@@ -167,7 +167,7 @@ typedef int (*virStreamSourceHoleFunc)(virStreamPtr st,
* Returns 0 on success,
* -1 upon error.
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
typedef int (*virStreamSourceSkipFunc)(virStreamPtr st,
long long length,
@@ -206,7 +206,7 @@ int virStreamSparseSendAll(virStreamPtr st,
* Returns the number of bytes consumed or -1 upon
* error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef int (*virStreamSinkFunc)(virStreamPtr st,
const char *data,
@@ -238,7 +238,7 @@ int virStreamRecvAll(virStreamPtr st,
* Returns 0 on success,
* -1 upon error
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
typedef int (*virStreamSinkHoleFunc)(virStreamPtr st,
long long length,
@@ -252,13 +252,13 @@ int virStreamSparseRecvAll(virStreamPtr stream,
/**
* virStreamEventType:
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef enum {
- VIR_STREAM_EVENT_READABLE = (1 << 0), /* (Since: v0.7.2) */
- VIR_STREAM_EVENT_WRITABLE = (1 << 1), /* (Since: v0.7.2) */
- VIR_STREAM_EVENT_ERROR = (1 << 2), /* (Since: v0.7.2) */
- VIR_STREAM_EVENT_HANGUP = (1 << 3), /* (Since: v0.7.2) */
+ VIR_STREAM_EVENT_READABLE = (1 << 0), /* (Since: 0.7.2) */
+ VIR_STREAM_EVENT_WRITABLE = (1 << 1), /* (Since: 0.7.2) */
+ VIR_STREAM_EVENT_ERROR = (1 << 2), /* (Since: 0.7.2) */
+ VIR_STREAM_EVENT_HANGUP = (1 << 3), /* (Since: 0.7.2) */
} virStreamEventType;
@@ -272,7 +272,7 @@ typedef enum {
* Callback for receiving stream events. The callback will
* be invoked once for each event which is pending.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
typedef void (*virStreamEventCallback)(virStreamPtr stream, int events, void *opaque);
diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h
index 4e6dfaa3f4..df13e4f11e 100644
--- a/include/libvirt/virterror.h
+++ b/include/libvirt/virterror.h
@@ -35,12 +35,12 @@ extern "C" {
*
* Indicates the level of an error
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef enum {
- VIR_ERR_NONE = 0, /* (Since: v0.1.0) */
- VIR_ERR_WARNING = 1, /* A simple warning (Since: v0.1.0) */
- VIR_ERR_ERROR = 2 /* An error (Since: v0.1.0) */
+ VIR_ERR_NONE = 0, /* (Since: 0.1.0) */
+ VIR_ERR_WARNING = 1, /* A simple warning (Since: 0.1.0) */
+ VIR_ERR_ERROR = 2 /* An error (Since: 0.1.0) */
} virErrorLevel;
/**
@@ -49,101 +49,101 @@ typedef enum {
* Indicates where an error may have come from. This should remain
* stable, with all additions placed at the end since libvirt 0.1.0.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef enum {
- VIR_FROM_NONE = 0, /* (Since: v0.1.0) */
- VIR_FROM_XEN = 1, /* Error at Xen hypervisor layer (Since: v0.1.0) */
- VIR_FROM_XEND = 2, /* Error at connection with xend daemon (Since: v0.1.0) */
- VIR_FROM_XENSTORE = 3, /* Error at connection with xen store (Since: v0.1.0) */
- VIR_FROM_SEXPR = 4, /* Error in the S-Expression code (Since: v0.1.0) */
-
- VIR_FROM_XML = 5, /* Error in the XML code (Since: v0.1.0) */
- VIR_FROM_DOM = 6, /* Error when operating on a domain (Since: v0.1.0) */
- VIR_FROM_RPC = 7, /* Error in the XML-RPC code (Since: v0.1.1) */
+ VIR_FROM_NONE = 0, /* (Since: 0.1.0) */
+ VIR_FROM_XEN = 1, /* Error at Xen hypervisor layer (Since: 0.1.0) */
+ VIR_FROM_XEND = 2, /* Error at connection with xend daemon (Since: 0.1.0) */
+ VIR_FROM_XENSTORE = 3, /* Error at connection with xen store (Since: 0.1.0) */
+ VIR_FROM_SEXPR = 4, /* Error in the S-Expression code (Since: 0.1.0) */
+
+ VIR_FROM_XML = 5, /* Error in the XML code (Since: 0.1.0) */
+ VIR_FROM_DOM = 6, /* Error when operating on a domain (Since: 0.1.0) */
+ VIR_FROM_RPC = 7, /* Error in the XML-RPC code (Since: 0.1.1) */
VIR_FROM_PROXY = 8, /* Error in the proxy code; unused since
- 0.8.6 (Since: v0.1.3) */
- VIR_FROM_CONF = 9, /* Error in the configuration file handling (Since: v0.1.6) */
-
- VIR_FROM_QEMU = 10, /* Error at the QEMU daemon (Since: v0.2.0) */
- VIR_FROM_NET = 11, /* Error when operating on a network (Since: v0.2.0) */
- VIR_FROM_TEST = 12, /* Error from test driver (Since: v0.2.3) */
- VIR_FROM_REMOTE = 13, /* Error from remote driver (Since: v0.2.3) */
- VIR_FROM_OPENVZ = 14, /* Error from OpenVZ driver (Since: v0.3.1) */
-
- VIR_FROM_XENXM = 15, /* Error at Xen XM layer (Since: v0.4.1) */
- VIR_FROM_STATS_LINUX = 16, /* Error in the Linux Stats code (Since: v0.4.1) */
- VIR_FROM_LXC = 17, /* Error from Linux Container driver (Since: v0.4.2) */
- VIR_FROM_STORAGE = 18, /* Error from storage driver (Since: v0.4.1) */
- VIR_FROM_NETWORK = 19, /* Error from network config (Since: v0.4.6) */
-
- VIR_FROM_DOMAIN = 20, /* Error from domain config (Since: v0.4.6) */
- VIR_FROM_UML = 21, /* Error at the UML driver; unused since 5.0.0 (Since: v0.5.0) */
- VIR_FROM_NODEDEV = 22, /* Error from node device monitor (Since: v0.5.0) */
- VIR_FROM_XEN_INOTIFY = 23, /* Error from xen inotify layer (Since: v0.5.0) */
- VIR_FROM_SECURITY = 24, /* Error from security framework (Since: v0.6.1) */
-
- VIR_FROM_VBOX = 25, /* Error from VirtualBox driver (Since: v0.6.3) */
- VIR_FROM_INTERFACE = 26, /* Error when operating on an interface (Since: v0.6.4) */
+ 0.8.6 (Since: 0.1.3) */
+ VIR_FROM_CONF = 9, /* Error in the configuration file handling (Since: 0.1.6) */
+
+ VIR_FROM_QEMU = 10, /* Error at the QEMU daemon (Since: 0.2.0) */
+ VIR_FROM_NET = 11, /* Error when operating on a network (Since: 0.2.0) */
+ VIR_FROM_TEST = 12, /* Error from test driver (Since: 0.2.3) */
+ VIR_FROM_REMOTE = 13, /* Error from remote driver (Since: 0.2.3) */
+ VIR_FROM_OPENVZ = 14, /* Error from OpenVZ driver (Since: 0.3.1) */
+
+ VIR_FROM_XENXM = 15, /* Error at Xen XM layer (Since: 0.4.1) */
+ VIR_FROM_STATS_LINUX = 16, /* Error in the Linux Stats code (Since: 0.4.1) */
+ VIR_FROM_LXC = 17, /* Error from Linux Container driver (Since: 0.4.2) */
+ VIR_FROM_STORAGE = 18, /* Error from storage driver (Since: 0.4.1) */
+ VIR_FROM_NETWORK = 19, /* Error from network config (Since: 0.4.6) */
+
+ VIR_FROM_DOMAIN = 20, /* Error from domain config (Since: 0.4.6) */
+ VIR_FROM_UML = 21, /* Error at the UML driver; unused since 5.0.0 (Since: 0.5.0) */
+ VIR_FROM_NODEDEV = 22, /* Error from node device monitor (Since: 0.5.0) */
+ VIR_FROM_XEN_INOTIFY = 23, /* Error from xen inotify layer (Since: 0.5.0) */
+ VIR_FROM_SECURITY = 24, /* Error from security framework (Since: 0.6.1) */
+
+ VIR_FROM_VBOX = 25, /* Error from VirtualBox driver (Since: 0.6.3) */
+ VIR_FROM_INTERFACE = 26, /* Error when operating on an interface (Since: 0.6.4) */
VIR_FROM_ONE = 27, /* The OpenNebula driver no longer exists.
- Retained for ABI/API compat only (Since: v0.6.4) */
- VIR_FROM_ESX = 28, /* Error from ESX driver (Since: v0.7.0) */
- VIR_FROM_PHYP = 29, /* Error from the phyp driver, unused since 6.0.0 (Since: v0.7.0) */
-
- VIR_FROM_SECRET = 30, /* Error from secret storage (Since: v0.7.1) */
- VIR_FROM_CPU = 31, /* Error from CPU driver (Since: v0.7.5) */
- VIR_FROM_XENAPI = 32, /* Error from XenAPI (Since: v0.8.0) */
- VIR_FROM_NWFILTER = 33, /* Error from network filter driver (Since: v0.8.0) */
- VIR_FROM_HOOK = 34, /* Error from Synchronous hooks (Since: v0.8.0) */
-
- VIR_FROM_DOMAIN_SNAPSHOT = 35,/* Error from domain snapshot (Since: v0.8.0) */
- VIR_FROM_AUDIT = 36, /* Error from auditing subsystem (Since: v0.8.5) */
- VIR_FROM_SYSINFO = 37, /* Error from sysinfo/SMBIOS (Since: v0.8.6) */
- VIR_FROM_STREAMS = 38, /* Error from I/O streams (Since: v0.8.6) */
- VIR_FROM_VMWARE = 39, /* Error from VMware driver (Since: v0.8.7) */
-
- VIR_FROM_EVENT = 40, /* Error from event loop impl (Since: v0.9.0) */
- VIR_FROM_LIBXL = 41, /* Error from libxenlight driver (Since: v0.9.0) */
- VIR_FROM_LOCKING = 42, /* Error from lock manager (Since: v0.9.2) */
- VIR_FROM_HYPERV = 43, /* Error from Hyper-V driver (Since: v0.9.5) */
- VIR_FROM_CAPABILITIES = 44, /* Error from capabilities (Since: v0.9.8) */
-
- VIR_FROM_URI = 45, /* Error from URI handling (Since: v0.9.11) */
- VIR_FROM_AUTH = 46, /* Error from auth handling (Since: v0.9.11) */
- VIR_FROM_DBUS = 47, /* Error from DBus (Since: v0.9.12) */
- VIR_FROM_PARALLELS = 48, /* Error from Parallels (Since: v0.10.0) */
- VIR_FROM_DEVICE = 49, /* Error from Device (Since: v0.10.0) */
-
- VIR_FROM_SSH = 50, /* Error from libssh2 connection transport (Since: v0.10.0) */
- VIR_FROM_LOCKSPACE = 51, /* Error from lockspace (Since: v1.0.0) */
- VIR_FROM_INITCTL = 52, /* Error from initctl device communication (Since: v1.0.1) */
- VIR_FROM_IDENTITY = 53, /* Error from identity code (Since: v1.0.4) */
- VIR_FROM_CGROUP = 54, /* Error from cgroups (Since: v1.0.5) */
-
- VIR_FROM_ACCESS = 55, /* Error from access control manager (Since: v1.1.0) */
- VIR_FROM_SYSTEMD = 56, /* Error from systemd code (Since: v1.1.1) */
- VIR_FROM_BHYVE = 57, /* Error from bhyve driver (Since: v1.2.2) */
- VIR_FROM_CRYPTO = 58, /* Error from crypto code (Since: v1.2.3) */
- VIR_FROM_FIREWALL = 59, /* Error from firewall (Since: v1.2.4) */
-
- VIR_FROM_POLKIT = 60, /* Error from polkit code (Since: v1.2.9) */
- VIR_FROM_THREAD = 61, /* Error from thread utils (Since: v1.2.14) */
- VIR_FROM_ADMIN = 62, /* Error from admin backend (Since: v1.2.17) */
- VIR_FROM_LOGGING = 63, /* Error from log manager (Since: v1.3.0) */
- VIR_FROM_XENXL = 64, /* Error from Xen xl config code (Since: v1.3.2) */
-
- VIR_FROM_PERF = 65, /* Error from perf (Since: v1.3.3) */
- VIR_FROM_LIBSSH = 66, /* Error from libssh connection transport (Since: v2.5.0) */
- VIR_FROM_RESCTRL = 67, /* Error from resource control (Since: v3.7.0) */
- VIR_FROM_FIREWALLD = 68, /* Error from firewalld (Since: v5.1.0) */
- VIR_FROM_DOMAIN_CHECKPOINT = 69, /* Error from domain checkpoint (Since: v5.2.0) */
-
- VIR_FROM_TPM = 70, /* Error from TPM (Since: v5.6.0) */
- VIR_FROM_BPF = 71, /* Error from BPF code (Since: v5.10.0) */
- VIR_FROM_CH = 72, /* Error from Cloud-Hypervisor driver (Since: v7.5.0) */
+ Retained for ABI/API compat only (Since: 0.6.4) */
+ VIR_FROM_ESX = 28, /* Error from ESX driver (Since: 0.7.0) */
+ VIR_FROM_PHYP = 29, /* Error from the phyp driver, unused since 6.0.0 (Since: 0.7.0) */
+
+ VIR_FROM_SECRET = 30, /* Error from secret storage (Since: 0.7.1) */
+ VIR_FROM_CPU = 31, /* Error from CPU driver (Since: 0.7.5) */
+ VIR_FROM_XENAPI = 32, /* Error from XenAPI (Since: 0.8.0) */
+ VIR_FROM_NWFILTER = 33, /* Error from network filter driver (Since: 0.8.0) */
+ VIR_FROM_HOOK = 34, /* Error from Synchronous hooks (Since: 0.8.0) */
+
+ VIR_FROM_DOMAIN_SNAPSHOT = 35,/* Error from domain snapshot (Since: 0.8.0) */
+ VIR_FROM_AUDIT = 36, /* Error from auditing subsystem (Since: 0.8.5) */
+ VIR_FROM_SYSINFO = 37, /* Error from sysinfo/SMBIOS (Since: 0.8.6) */
+ VIR_FROM_STREAMS = 38, /* Error from I/O streams (Since: 0.8.6) */
+ VIR_FROM_VMWARE = 39, /* Error from VMware driver (Since: 0.8.7) */
+
+ VIR_FROM_EVENT = 40, /* Error from event loop impl (Since: 0.9.0) */
+ VIR_FROM_LIBXL = 41, /* Error from libxenlight driver (Since: 0.9.0) */
+ VIR_FROM_LOCKING = 42, /* Error from lock manager (Since: 0.9.2) */
+ VIR_FROM_HYPERV = 43, /* Error from Hyper-V driver (Since: 0.9.5) */
+ VIR_FROM_CAPABILITIES = 44, /* Error from capabilities (Since: 0.9.8) */
+
+ VIR_FROM_URI = 45, /* Error from URI handling (Since: 0.9.11) */
+ VIR_FROM_AUTH = 46, /* Error from auth handling (Since: 0.9.11) */
+ VIR_FROM_DBUS = 47, /* Error from DBus (Since: 0.9.12) */
+ VIR_FROM_PARALLELS = 48, /* Error from Parallels (Since: 0.10.0) */
+ VIR_FROM_DEVICE = 49, /* Error from Device (Since: 0.10.0) */
+
+ VIR_FROM_SSH = 50, /* Error from libssh2 connection transport (Since: 0.10.0) */
+ VIR_FROM_LOCKSPACE = 51, /* Error from lockspace (Since: 1.0.0) */
+ VIR_FROM_INITCTL = 52, /* Error from initctl device communication (Since: 1.0.1) */
+ VIR_FROM_IDENTITY = 53, /* Error from identity code (Since: 1.0.4) */
+ VIR_FROM_CGROUP = 54, /* Error from cgroups (Since: 1.0.5) */
+
+ VIR_FROM_ACCESS = 55, /* Error from access control manager (Since: 1.1.0) */
+ VIR_FROM_SYSTEMD = 56, /* Error from systemd code (Since: 1.1.1) */
+ VIR_FROM_BHYVE = 57, /* Error from bhyve driver (Since: 1.2.2) */
+ VIR_FROM_CRYPTO = 58, /* Error from crypto code (Since: 1.2.3) */
+ VIR_FROM_FIREWALL = 59, /* Error from firewall (Since: 1.2.4) */
+
+ VIR_FROM_POLKIT = 60, /* Error from polkit code (Since: 1.2.9) */
+ VIR_FROM_THREAD = 61, /* Error from thread utils (Since: 1.2.14) */
+ VIR_FROM_ADMIN = 62, /* Error from admin backend (Since: 1.2.17) */
+ VIR_FROM_LOGGING = 63, /* Error from log manager (Since: 1.3.0) */
+ VIR_FROM_XENXL = 64, /* Error from Xen xl config code (Since: 1.3.2) */
+
+ VIR_FROM_PERF = 65, /* Error from perf (Since: 1.3.3) */
+ VIR_FROM_LIBSSH = 66, /* Error from libssh connection transport (Since: 2.5.0) */
+ VIR_FROM_RESCTRL = 67, /* Error from resource control (Since: 3.7.0) */
+ VIR_FROM_FIREWALLD = 68, /* Error from firewalld (Since: 5.1.0) */
+ VIR_FROM_DOMAIN_CHECKPOINT = 69, /* Error from domain checkpoint (Since: 5.2.0) */
+
+ VIR_FROM_TPM = 70, /* Error from TPM (Since: 5.6.0) */
+ VIR_FROM_BPF = 71, /* Error from BPF code (Since: 5.10.0) */
+ VIR_FROM_CH = 72, /* Error from Cloud-Hypervisor driver (Since: 7.5.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_ERR_DOMAIN_LAST /* (Since: v0.9.13) */
+ VIR_ERR_DOMAIN_LAST /* (Since: 0.9.13) */
# endif
} virErrorDomain;
@@ -157,14 +157,14 @@ typedef enum {
* Reference counts are not incremented so the underlying objects
* may be deleted without notice after the error has been delivered.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef struct _virError virError;
/**
* virErrorPtr:
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef virError *virErrorPtr;
struct _virError {
@@ -217,140 +217,140 @@ struct _virError {
* default:
* }
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef enum {
- VIR_ERR_OK = 0, /* (Since: v0.1.0) */
- VIR_ERR_INTERNAL_ERROR = 1, /* internal error (Since: v0.1.0) */
- VIR_ERR_NO_MEMORY = 2, /* memory allocation failure (Since: v0.1.0) */
- VIR_ERR_NO_SUPPORT = 3, /* no support for this function (Since: v0.1.0) */
- VIR_ERR_UNKNOWN_HOST = 4, /* could not resolve hostname (Since: v0.1.0) */
- VIR_ERR_NO_CONNECT = 5, /* can't connect to hypervisor (Since: v0.1.0) */
- VIR_ERR_INVALID_CONN = 6, /* invalid connection object (Since: v0.1.0) */
- VIR_ERR_INVALID_DOMAIN = 7, /* invalid domain object (Since: v0.1.0) */
- VIR_ERR_INVALID_ARG = 8, /* invalid function argument (Since: v0.1.0) */
- VIR_ERR_OPERATION_FAILED = 9, /* a command to hypervisor failed (Since: v0.1.0) */
- VIR_ERR_GET_FAILED = 10, /* a HTTP GET command to failed (Since: v0.1.0) */
- VIR_ERR_POST_FAILED = 11, /* a HTTP POST command to failed (Since: v0.1.0) */
- VIR_ERR_HTTP_ERROR = 12, /* unexpected HTTP error code (Since: v0.1.0) */
- VIR_ERR_SEXPR_SERIAL = 13, /* failure to serialize an S-Expr (Since: v0.1.0) */
+ VIR_ERR_OK = 0, /* (Since: 0.1.0) */
+ VIR_ERR_INTERNAL_ERROR = 1, /* internal error (Since: 0.1.0) */
+ VIR_ERR_NO_MEMORY = 2, /* memory allocation failure (Since: 0.1.0) */
+ VIR_ERR_NO_SUPPORT = 3, /* no support for this function (Since: 0.1.0) */
+ VIR_ERR_UNKNOWN_HOST = 4, /* could not resolve hostname (Since: 0.1.0) */
+ VIR_ERR_NO_CONNECT = 5, /* can't connect to hypervisor (Since: 0.1.0) */
+ VIR_ERR_INVALID_CONN = 6, /* invalid connection object (Since: 0.1.0) */
+ VIR_ERR_INVALID_DOMAIN = 7, /* invalid domain object (Since: 0.1.0) */
+ VIR_ERR_INVALID_ARG = 8, /* invalid function argument (Since: 0.1.0) */
+ VIR_ERR_OPERATION_FAILED = 9, /* a command to hypervisor failed (Since: 0.1.0) */
+ VIR_ERR_GET_FAILED = 10, /* a HTTP GET command to failed (Since: 0.1.0) */
+ VIR_ERR_POST_FAILED = 11, /* a HTTP POST command to failed (Since: 0.1.0) */
+ VIR_ERR_HTTP_ERROR = 12, /* unexpected HTTP error code (Since: 0.1.0) */
+ VIR_ERR_SEXPR_SERIAL = 13, /* failure to serialize an S-Expr (Since: 0.1.0) */
VIR_ERR_NO_XEN = 14, /* could not open Xen hypervisor
- control (Since: v0.1.0) */
- VIR_ERR_XEN_CALL = 15, /* failure doing an hypervisor call (Since: v0.1.0) */
- VIR_ERR_OS_TYPE = 16, /* unknown OS type (Since: v0.1.0) */
- VIR_ERR_NO_KERNEL = 17, /* missing kernel information (Since: v0.1.0) */
- VIR_ERR_NO_ROOT = 18, /* missing root device information (Since: v0.1.0) */
- VIR_ERR_NO_SOURCE = 19, /* missing source device information (Since: v0.1.0) */
- VIR_ERR_NO_TARGET = 20, /* missing target device information (Since: v0.1.0) */
- VIR_ERR_NO_NAME = 21, /* missing domain name information (Since: v0.1.0) */
- VIR_ERR_NO_OS = 22, /* missing domain OS information (Since: v0.1.0) */
- VIR_ERR_NO_DEVICE = 23, /* missing domain devices information (Since: v0.1.0) */
- VIR_ERR_NO_XENSTORE = 24, /* could not open Xen Store control (Since: v0.1.0) */
- VIR_ERR_DRIVER_FULL = 25, /* too many drivers registered (Since: v0.1.0) */
+ control (Since: 0.1.0) */
+ VIR_ERR_XEN_CALL = 15, /* failure doing an hypervisor call (Since: 0.1.0) */
+ VIR_ERR_OS_TYPE = 16, /* unknown OS type (Since: 0.1.0) */
+ VIR_ERR_NO_KERNEL = 17, /* missing kernel information (Since: 0.1.0) */
+ VIR_ERR_NO_ROOT = 18, /* missing root device information (Since: 0.1.0) */
+ VIR_ERR_NO_SOURCE = 19, /* missing source device information (Since: 0.1.0) */
+ VIR_ERR_NO_TARGET = 20, /* missing target device information (Since: 0.1.0) */
+ VIR_ERR_NO_NAME = 21, /* missing domain name information (Since: 0.1.0) */
+ VIR_ERR_NO_OS = 22, /* missing domain OS information (Since: 0.1.0) */
+ VIR_ERR_NO_DEVICE = 23, /* missing domain devices information (Since: 0.1.0) */
+ VIR_ERR_NO_XENSTORE = 24, /* could not open Xen Store control (Since: 0.1.0) */
+ VIR_ERR_DRIVER_FULL = 25, /* too many drivers registered (Since: 0.1.0) */
VIR_ERR_CALL_FAILED = 26, /* not supported by the drivers
- (DEPRECATED) (Since: v0.1.0) */
+ (DEPRECATED) (Since: 0.1.0) */
VIR_ERR_XML_ERROR = 27, /* an XML description is not well
- formed or broken (Since: v0.1.1) */
- VIR_ERR_DOM_EXIST = 28, /* the domain already exist (Since: v0.1.1) */
+ formed or broken (Since: 0.1.1) */
+ VIR_ERR_DOM_EXIST = 28, /* the domain already exist (Since: 0.1.1) */
VIR_ERR_OPERATION_DENIED = 29, /* operation forbidden on read-only
- connections (Since: v0.1.4) */
- VIR_ERR_OPEN_FAILED = 30, /* failed to open a conf file (Since: v0.1.6) */
- VIR_ERR_READ_FAILED = 31, /* failed to read a conf file (Since: v0.1.6) */
- VIR_ERR_PARSE_FAILED = 32, /* failed to parse a conf file (Since: v0.1.6) */
+ connections (Since: 0.1.4) */
+ VIR_ERR_OPEN_FAILED = 30, /* failed to open a conf file (Since: 0.1.6) */
+ VIR_ERR_READ_FAILED = 31, /* failed to read a conf file (Since: 0.1.6) */
+ VIR_ERR_PARSE_FAILED = 32, /* failed to parse a conf file (Since: 0.1.6) */
VIR_ERR_CONF_SYNTAX = 33, /* failed to parse the syntax of a
- conf file (Since: v0.1.6) */
- VIR_ERR_WRITE_FAILED = 34, /* failed to write a conf file (Since: v0.1.6) */
- VIR_ERR_XML_DETAIL = 35, /* detail of an XML error (Since: v0.1.9) */
- VIR_ERR_INVALID_NETWORK = 36, /* invalid network object (Since: v0.2.0) */
- VIR_ERR_NETWORK_EXIST = 37, /* the network already exist (Since: v0.2.0) */
- VIR_ERR_SYSTEM_ERROR = 38, /* general system call failure (Since: v0.2.1) */
- VIR_ERR_RPC = 39, /* some sort of RPC error (Since: v0.2.3) */
- VIR_ERR_GNUTLS_ERROR = 40, /* error from a GNUTLS call (Since: v0.2.3) */
- VIR_WAR_NO_NETWORK = 41, /* failed to start network (Since: v0.2.3) */
+ conf file (Since: 0.1.6) */
+ VIR_ERR_WRITE_FAILED = 34, /* failed to write a conf file (Since: 0.1.6) */
+ VIR_ERR_XML_DETAIL = 35, /* detail of an XML error (Since: 0.1.9) */
+ VIR_ERR_INVALID_NETWORK = 36, /* invalid network object (Since: 0.2.0) */
+ VIR_ERR_NETWORK_EXIST = 37, /* the network already exist (Since: 0.2.0) */
+ VIR_ERR_SYSTEM_ERROR = 38, /* general system call failure (Since: 0.2.1) */
+ VIR_ERR_RPC = 39, /* some sort of RPC error (Since: 0.2.3) */
+ VIR_ERR_GNUTLS_ERROR = 40, /* error from a GNUTLS call (Since: 0.2.3) */
+ VIR_WAR_NO_NETWORK = 41, /* failed to start network (Since: 0.2.3) */
VIR_ERR_NO_DOMAIN = 42, /* domain not found or unexpectedly
- disappeared (Since: v0.3.0) */
- VIR_ERR_NO_NETWORK = 43, /* network not found (Since: v0.3.0) */
- VIR_ERR_INVALID_MAC = 44, /* invalid MAC address (Since: v0.3.1) */
- VIR_ERR_AUTH_FAILED = 45, /* authentication failed (Since: v0.4.1) */
- VIR_ERR_INVALID_STORAGE_POOL = 46, /* invalid storage pool object (Since: v0.4.1) */
- VIR_ERR_INVALID_STORAGE_VOL = 47, /* invalid storage vol object (Since: v0.4.1) */
- VIR_WAR_NO_STORAGE = 48, /* failed to start storage (Since: v0.4.1) */
- VIR_ERR_NO_STORAGE_POOL = 49, /* storage pool not found (Since: v0.4.1) */
- VIR_ERR_NO_STORAGE_VOL = 50, /* storage volume not found (Since: v0.4.1) */
- VIR_WAR_NO_NODE = 51, /* failed to start node driver (Since: v0.5.0) */
- VIR_ERR_INVALID_NODE_DEVICE = 52, /* invalid node device object (Since: v0.5.0) */
- VIR_ERR_NO_NODE_DEVICE = 53, /* node device not found (Since: v0.5.0) */
- VIR_ERR_NO_SECURITY_MODEL = 54, /* security model not found (Since: v0.6.1) */
+ disappeared (Since: 0.3.0) */
+ VIR_ERR_NO_NETWORK = 43, /* network not found (Since: 0.3.0) */
+ VIR_ERR_INVALID_MAC = 44, /* invalid MAC address (Since: 0.3.1) */
+ VIR_ERR_AUTH_FAILED = 45, /* authentication failed (Since: 0.4.1) */
+ VIR_ERR_INVALID_STORAGE_POOL = 46, /* invalid storage pool object (Since: 0.4.1) */
+ VIR_ERR_INVALID_STORAGE_VOL = 47, /* invalid storage vol object (Since: 0.4.1) */
+ VIR_WAR_NO_STORAGE = 48, /* failed to start storage (Since: 0.4.1) */
+ VIR_ERR_NO_STORAGE_POOL = 49, /* storage pool not found (Since: 0.4.1) */
+ VIR_ERR_NO_STORAGE_VOL = 50, /* storage volume not found (Since: 0.4.1) */
+ VIR_WAR_NO_NODE = 51, /* failed to start node driver (Since: 0.5.0) */
+ VIR_ERR_INVALID_NODE_DEVICE = 52, /* invalid node device object (Since: 0.5.0) */
+ VIR_ERR_NO_NODE_DEVICE = 53, /* node device not found (Since: 0.5.0) */
+ VIR_ERR_NO_SECURITY_MODEL = 54, /* security model not found (Since: 0.6.1) */
VIR_ERR_OPERATION_INVALID = 55, /* operation is not applicable at this
- time (Since: v0.6.4) */
- VIR_WAR_NO_INTERFACE = 56, /* failed to start interface driver (Since: v0.6.4) */
- VIR_ERR_NO_INTERFACE = 57, /* interface driver not running (Since: v0.6.4) */
- VIR_ERR_INVALID_INTERFACE = 58, /* invalid interface object (Since: v0.6.4) */
+ time (Since: 0.6.4) */
+ VIR_WAR_NO_INTERFACE = 56, /* failed to start interface driver (Since: 0.6.4) */
+ VIR_ERR_NO_INTERFACE = 57, /* interface driver not running (Since: 0.6.4) */
+ VIR_ERR_INVALID_INTERFACE = 58, /* invalid interface object (Since: 0.6.4) */
VIR_ERR_MULTIPLE_INTERFACES = 59, /* more than one matching interface
- found (Since: v0.7.0) */
- VIR_WAR_NO_NWFILTER = 60, /* failed to start nwfilter driver (Since: v0.8.0) */
- VIR_ERR_INVALID_NWFILTER = 61, /* invalid nwfilter object (Since: v0.8.0) */
- VIR_ERR_NO_NWFILTER = 62, /* nw filter pool not found (Since: v0.8.0) */
- VIR_ERR_BUILD_FIREWALL = 63, /* nw filter pool not found (Since: v0.8.0) */
- VIR_WAR_NO_SECRET = 64, /* failed to start secret storage (Since: v0.7.1) */
- VIR_ERR_INVALID_SECRET = 65, /* invalid secret (Since: v0.7.1) */
- VIR_ERR_NO_SECRET = 66, /* secret not found (Since: v0.7.1) */
+ found (Since: 0.7.0) */
+ VIR_WAR_NO_NWFILTER = 60, /* failed to start nwfilter driver (Since: 0.8.0) */
+ VIR_ERR_INVALID_NWFILTER = 61, /* invalid nwfilter object (Since: 0.8.0) */
+ VIR_ERR_NO_NWFILTER = 62, /* nw filter pool not found (Since: 0.8.0) */
+ VIR_ERR_BUILD_FIREWALL = 63, /* nw filter pool not found (Since: 0.8.0) */
+ VIR_WAR_NO_SECRET = 64, /* failed to start secret storage (Since: 0.7.1) */
+ VIR_ERR_INVALID_SECRET = 65, /* invalid secret (Since: 0.7.1) */
+ VIR_ERR_NO_SECRET = 66, /* secret not found (Since: 0.7.1) */
VIR_ERR_CONFIG_UNSUPPORTED = 67, /* unsupported configuration
- construct (Since: v0.7.3) */
- VIR_ERR_OPERATION_TIMEOUT = 68, /* timeout occurred during operation (Since: v0.7.3) */
+ construct (Since: 0.7.3) */
+ VIR_ERR_OPERATION_TIMEOUT = 68, /* timeout occurred during operation (Since: 0.7.3) */
VIR_ERR_MIGRATE_PERSIST_FAILED = 69,/* a migration worked, but making the
- VM persist on the dest host failed (Since: v0.7.3) */
- VIR_ERR_HOOK_SCRIPT_FAILED = 70, /* a synchronous hook script failed (Since: v0.8.0) */
- VIR_ERR_INVALID_DOMAIN_SNAPSHOT = 71,/* invalid domain snapshot (Since: v0.8.0) */
- VIR_ERR_NO_DOMAIN_SNAPSHOT = 72, /* domain snapshot not found (Since: v0.8.0) */
- VIR_ERR_INVALID_STREAM = 73, /* stream pointer not valid (Since: v0.9.0) */
+ VM persist on the dest host failed (Since: 0.7.3) */
+ VIR_ERR_HOOK_SCRIPT_FAILED = 70, /* a synchronous hook script failed (Since: 0.8.0) */
+ VIR_ERR_INVALID_DOMAIN_SNAPSHOT = 71,/* invalid domain snapshot (Since: 0.8.0) */
+ VIR_ERR_NO_DOMAIN_SNAPSHOT = 72, /* domain snapshot not found (Since: 0.8.0) */
+ VIR_ERR_INVALID_STREAM = 73, /* stream pointer not valid (Since: 0.9.0) */
VIR_ERR_ARGUMENT_UNSUPPORTED = 74, /* valid API use but unsupported by
- the given driver (Since: v0.9.4) */
- VIR_ERR_STORAGE_PROBE_FAILED = 75, /* storage pool probe failed (Since: v0.9.5) */
- VIR_ERR_STORAGE_POOL_BUILT = 76, /* storage pool already built (Since: v0.9.5) */
+ the given driver (Since: 0.9.4) */
+ VIR_ERR_STORAGE_PROBE_FAILED = 75, /* storage pool probe failed (Since: 0.9.5) */
+ VIR_ERR_STORAGE_POOL_BUILT = 76, /* storage pool already built (Since: 0.9.5) */
VIR_ERR_SNAPSHOT_REVERT_RISKY = 77, /* force was not requested for a
- risky domain snapshot revert (Since: v0.9.7) */
+ risky domain snapshot revert (Since: 0.9.7) */
VIR_ERR_OPERATION_ABORTED = 78, /* operation on a domain was
- canceled/aborted by user (Since: v0.9.9) */
- VIR_ERR_AUTH_CANCELLED = 79, /* authentication cancelled (Since: v0.9.10) */
- VIR_ERR_NO_DOMAIN_METADATA = 80, /* The metadata is not present (Since: v0.9.10) */
- VIR_ERR_MIGRATE_UNSAFE = 81, /* Migration is not safe (Since: v0.9.11) */
- VIR_ERR_OVERFLOW = 82, /* integer overflow (Since: v0.9.11) */
- VIR_ERR_BLOCK_COPY_ACTIVE = 83, /* action prevented by block copy job (Since: v0.9.12) */
+ canceled/aborted by user (Since: 0.9.9) */
+ VIR_ERR_AUTH_CANCELLED = 79, /* authentication cancelled (Since: 0.9.10) */
+ VIR_ERR_NO_DOMAIN_METADATA = 80, /* The metadata is not present (Since: 0.9.10) */
+ VIR_ERR_MIGRATE_UNSAFE = 81, /* Migration is not safe (Since: 0.9.11) */
+ VIR_ERR_OVERFLOW = 82, /* integer overflow (Since: 0.9.11) */
+ VIR_ERR_BLOCK_COPY_ACTIVE = 83, /* action prevented by block copy job (Since: 0.9.12) */
VIR_ERR_OPERATION_UNSUPPORTED = 84, /* The requested operation is not
- supported (Since: v0.10.0) */
- VIR_ERR_SSH = 85, /* error in ssh transport driver (Since: v0.10.0) */
+ supported (Since: 0.10.0) */
+ VIR_ERR_SSH = 85, /* error in ssh transport driver (Since: 0.10.0) */
VIR_ERR_AGENT_UNRESPONSIVE = 86, /* guest agent is unresponsive,
- not running or not usable (Since: v0.10.0) */
- VIR_ERR_RESOURCE_BUSY = 87, /* resource is already in use (Since: v1.0.0) */
+ not running or not usable (Since: 0.10.0) */
+ VIR_ERR_RESOURCE_BUSY = 87, /* resource is already in use (Since: 1.0.0) */
VIR_ERR_ACCESS_DENIED = 88, /* operation on the object/resource
- was denied (Since: v1.1.0) */
- VIR_ERR_DBUS_SERVICE = 89, /* error from a dbus service (Since: v1.1.1) */
- VIR_ERR_STORAGE_VOL_EXIST = 90, /* the storage vol already exists (Since: v1.1.4) */
- VIR_ERR_CPU_INCOMPATIBLE = 91, /* given CPU is incompatible with host CPU (Since: v1.2.6) */
- VIR_ERR_XML_INVALID_SCHEMA = 92, /* XML document doesn't validate against schema (Since: v1.2.12) */
- VIR_ERR_MIGRATE_FINISH_OK = 93, /* Finish API succeeded but it is expected to return NULL (Since: v1.2.18) */
- VIR_ERR_AUTH_UNAVAILABLE = 94, /* authentication unavailable (Since: v1.3.3) */
- VIR_ERR_NO_SERVER = 95, /* Server was not found (Since: v1.3.3) */
- VIR_ERR_NO_CLIENT = 96, /* Client was not found (Since: v1.3.5) */
+ was denied (Since: 1.1.0) */
+ VIR_ERR_DBUS_SERVICE = 89, /* error from a dbus service (Since: 1.1.1) */
+ VIR_ERR_STORAGE_VOL_EXIST = 90, /* the storage vol already exists (Since: 1.1.4) */
+ VIR_ERR_CPU_INCOMPATIBLE = 91, /* given CPU is incompatible with host CPU (Since: 1.2.6) */
+ VIR_ERR_XML_INVALID_SCHEMA = 92, /* XML document doesn't validate against schema (Since: 1.2.12) */
+ VIR_ERR_MIGRATE_FINISH_OK = 93, /* Finish API succeeded but it is expected to return NULL (Since: 1.2.18) */
+ VIR_ERR_AUTH_UNAVAILABLE = 94, /* authentication unavailable (Since: 1.3.3) */
+ VIR_ERR_NO_SERVER = 95, /* Server was not found (Since: 1.3.3) */
+ VIR_ERR_NO_CLIENT = 96, /* Client was not found (Since: 1.3.5) */
VIR_ERR_AGENT_UNSYNCED = 97, /* guest agent replies with wrong id
- to guest-sync command (DEPRECATED) (Since: v2.3.0) */
- VIR_ERR_LIBSSH = 98, /* error in libssh transport driver (Since: v2.5.0) */
- VIR_ERR_DEVICE_MISSING = 99, /* fail to find the desired device (Since: v4.1.0) */
- VIR_ERR_INVALID_NWFILTER_BINDING = 100, /* invalid nwfilter binding (Since: v4.5.0) */
- VIR_ERR_NO_NWFILTER_BINDING = 101, /* no nwfilter binding (Since: v4.5.0) */
- VIR_ERR_INVALID_DOMAIN_CHECKPOINT = 102, /* invalid domain checkpoint (Since: v5.2.0) */
- VIR_ERR_NO_DOMAIN_CHECKPOINT = 103, /* domain checkpoint not found (Since: v5.2.0) */
- VIR_ERR_NO_DOMAIN_BACKUP = 104, /* domain backup job id not found (Since: v5.2.0) */
- VIR_ERR_INVALID_NETWORK_PORT = 105, /* invalid network port object (Since: v5.5.0) */
- VIR_ERR_NETWORK_PORT_EXIST = 106, /* the network port already exist (Since: v5.5.0) */
- VIR_ERR_NO_NETWORK_PORT = 107, /* network port not found (Since: v5.5.0) */
- VIR_ERR_NO_HOSTNAME = 108, /* no domain's hostname found (Since: v6.1.0) */
- VIR_ERR_CHECKPOINT_INCONSISTENT = 109, /* checkpoint can't be used (Since: v6.10.0) */
- VIR_ERR_MULTIPLE_DOMAINS = 110, /* more than one matching domain found (Since: v7.1.0) */
+ to guest-sync command (DEPRECATED) (Since: 2.3.0) */
+ VIR_ERR_LIBSSH = 98, /* error in libssh transport driver (Since: 2.5.0) */
+ VIR_ERR_DEVICE_MISSING = 99, /* fail to find the desired device (Since: 4.1.0) */
+ VIR_ERR_INVALID_NWFILTER_BINDING = 100, /* invalid nwfilter binding (Since: 4.5.0) */
+ VIR_ERR_NO_NWFILTER_BINDING = 101, /* no nwfilter binding (Since: 4.5.0) */
+ VIR_ERR_INVALID_DOMAIN_CHECKPOINT = 102, /* invalid domain checkpoint (Since: 5.2.0) */
+ VIR_ERR_NO_DOMAIN_CHECKPOINT = 103, /* domain checkpoint not found (Since: 5.2.0) */
+ VIR_ERR_NO_DOMAIN_BACKUP = 104, /* domain backup job id not found (Since: 5.2.0) */
+ VIR_ERR_INVALID_NETWORK_PORT = 105, /* invalid network port object (Since: 5.5.0) */
+ VIR_ERR_NETWORK_PORT_EXIST = 106, /* the network port already exist (Since: 5.5.0) */
+ VIR_ERR_NO_NETWORK_PORT = 107, /* network port not found (Since: 5.5.0) */
+ VIR_ERR_NO_HOSTNAME = 108, /* no domain's hostname found (Since: 6.1.0) */
+ VIR_ERR_CHECKPOINT_INCONSISTENT = 109, /* checkpoint can't be used (Since: 6.10.0) */
+ VIR_ERR_MULTIPLE_DOMAINS = 110, /* more than one matching domain found (Since: 7.1.0) */
# ifdef VIR_ENUM_SENTINELS
- VIR_ERR_NUMBER_LAST /* (Since: v5.0.0) */
+ VIR_ERR_NUMBER_LAST /* (Since: 5.0.0) */
# endif
} virErrorNumber;
@@ -361,7 +361,7 @@ typedef enum {
*
* Signature of a function to use when there is an error raised by the library.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
typedef void (*virErrorFunc) (void *userData, virErrorPtr error);
diff --git a/src/admin/libvirt-admin.c b/src/admin/libvirt-admin.c
index 3cdaaf1de2..5f64784a13 100644
--- a/src/admin/libvirt-admin.c
+++ b/src/admin/libvirt-admin.c
@@ -85,7 +85,7 @@ virAdmGlobalInit(void)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmInitialize(void)
@@ -203,7 +203,7 @@ virAdmGetDefaultURI(virConf *conf, char **uristr)
*
* Returns @virAdmConnectPtr object or NULL on error
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
virAdmConnectPtr
virAdmConnectOpen(const char *name, unsigned int flags)
@@ -289,7 +289,7 @@ virAdmConnectOpen(const char *name, unsigned int flags)
* application should not try to further use a connection after the
* virAdmConnectClose that matches the initial open.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmConnectClose(virAdmConnectPtr conn)
@@ -326,7 +326,7 @@ virAdmConnectClose(virAdmConnectPtr conn)
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmConnectRef(virAdmConnectPtr conn)
@@ -355,7 +355,7 @@ virAdmConnectRef(virAdmConnectPtr conn)
*
* Returns 0 on success, -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmGetVersion(unsigned long long *libVer)
@@ -388,7 +388,7 @@ virAdmGetVersion(unsigned long long *libVer)
* Returns 1, if the connection is alive, 0 if there isn't an existing
* connection at all or the channel has already been closed, or -1 on error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmConnectIsAlive(virAdmConnectPtr conn)
@@ -424,7 +424,7 @@ virAdmConnectIsAlive(virAdmConnectPtr conn)
* Returns an URI string related to the connection or NULL in case of an error.
* Caller is responsible for freeing the string.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
char *
virAdmConnectGetURI(virAdmConnectPtr conn)
@@ -460,7 +460,7 @@ virAdmConnectGetURI(virAdmConnectPtr conn)
*
* Returns 0 on success, -1 on error
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virAdmConnectRegisterCloseCallback(virAdmConnectPtr conn,
virAdmConnectCloseFunc cb,
@@ -515,7 +515,7 @@ int virAdmConnectRegisterCloseCallback(virAdmConnectPtr conn,
*
* Returns 0 on success, -1 on error
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virAdmConnectUnregisterCloseCallback(virAdmConnectPtr conn,
virAdmConnectCloseFunc cb)
@@ -547,7 +547,7 @@ int virAdmConnectUnregisterCloseCallback(virAdmConnectPtr conn,
*
* Returns 0 on success, -1 on failure and @libVer follows this format:
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virAdmConnectGetLibVersion(virAdmConnectPtr conn,
unsigned long long *libVer)
@@ -577,7 +577,7 @@ int virAdmConnectGetLibVersion(virAdmConnectPtr conn,
* Returns a pointer to the name or NULL. The string doesn't need to be
* deallocated since its lifetime will be the same as the server object.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
const char *
virAdmServerGetName(virAdmServerPtr srv)
@@ -599,7 +599,7 @@ virAdmServerGetName(virAdmServerPtr srv)
*
* Returns 0 on success, -1 on failure.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virAdmServerFree(virAdmServerPtr srv)
{
@@ -624,7 +624,7 @@ int virAdmServerFree(virAdmServerPtr srv)
*
* Returns numeric value used for client's ID or -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
unsigned long long
virAdmClientGetID(virAdmClientPtr client)
@@ -649,7 +649,7 @@ virAdmClientGetID(virAdmClientPtr client)
* (epoch time) if libvirt doesn't have any information about client's
* connection time, or -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
long long
virAdmClientGetTimestamp(virAdmClientPtr client)
@@ -676,7 +676,7 @@ virAdmClientGetTimestamp(virAdmClientPtr client)
* Returns integer representation of the connection transport used by @client
* (this will be one of virClientTransport) or -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmClientGetTransport(virAdmClientPtr client)
@@ -697,7 +697,7 @@ virAdmClientGetTransport(virAdmClientPtr client)
*
* Returns 0 in success, -1 on failure.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virAdmClientFree(virAdmClientPtr client)
{
@@ -730,7 +730,7 @@ int virAdmClientFree(virAdmClientPtr client)
* Caller is responsible to call virAdmServerFree() on each list element,
* followed by freeing @servers.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmConnectListServers(virAdmConnectPtr conn,
@@ -770,7 +770,7 @@ virAdmConnectListServers(virAdmConnectPtr conn,
* Returns the requested server or NULL in case of failure. If the
* server cannot be found, then VIR_ERR_NO_SERVER error is raised.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
virAdmServerPtr
virAdmConnectLookupServer(virAdmConnectPtr conn,
@@ -813,7 +813,7 @@ virAdmConnectLookupServer(virAdmConnectPtr conn,
*
* Returns 0 on success, -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmServerGetThreadPoolParameters(virAdmServerPtr srv,
@@ -854,7 +854,7 @@ virAdmServerGetThreadPoolParameters(virAdmServerPtr srv,
*
* Returns 0 on success, -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmServerSetThreadPoolParameters(virAdmServerPtr srv,
@@ -897,7 +897,7 @@ virAdmServerSetThreadPoolParameters(virAdmServerPtr srv,
* Caller is responsible to call virAdmClientFree() on each list element,
* followed by freeing @clients.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmServerListClients(virAdmServerPtr srv,
@@ -937,7 +937,7 @@ virAdmServerListClients(virAdmServerPtr srv,
* Returns the requested client or NULL in case of failure. If the
* client could not be found, then VIR_ERR_NO_CLIENT error is raised.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
virAdmClientPtr
virAdmServerLookupClient(virAdmServerPtr srv,
@@ -985,7 +985,7 @@ virAdmServerLookupClient(virAdmServerPtr srv,
* Returns 0 if the information has been successfully retrieved or -1 in case
* of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmClientGetInfo(virAdmClientPtr client,
@@ -1021,7 +1021,7 @@ virAdmClientGetInfo(virAdmClientPtr client,
* Returns 0 if the daemon's connection with @client was closed successfully
* or -1 in case of an error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virAdmClientClose(virAdmClientPtr client,
unsigned int flags)
@@ -1060,7 +1060,7 @@ int virAdmClientClose(virAdmClientPtr client,
* Returns 0 on success, allocating @params to size returned in @nparams, or
* -1 in case of an error. Caller is responsible for deallocating @params.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmServerGetClientLimits(virAdmServerPtr srv,
@@ -1102,7 +1102,7 @@ virAdmServerGetClientLimits(virAdmServerPtr srv,
* Returns 0 if the limits have been changed successfully or -1 in case of an
* error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virAdmServerSetClientLimits(virAdmServerPtr srv,
@@ -1142,7 +1142,7 @@ virAdmServerSetClientLimits(virAdmServerPtr srv,
* Returns 0 if the TLS files have been updated successfully or -1 in case of an
* error.
*
- * Since: v6.2.0
+ * Since: 6.2.0
*/
int
virAdmServerUpdateTlsFiles(virAdmServerPtr srv,
@@ -1182,7 +1182,7 @@ virAdmServerUpdateTlsFiles(virAdmServerPtr srv,
*
* Returns the count of outputs in @outputs, or -1 in case of an error.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virAdmConnectGetLoggingOutputs(virAdmConnectPtr conn,
@@ -1225,7 +1225,7 @@ virAdmConnectGetLoggingOutputs(virAdmConnectPtr conn,
* Returns the number of filters returned in @filters, or -1 in case of
* an error.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virAdmConnectGetLoggingFilters(virAdmConnectPtr conn,
@@ -1267,7 +1267,7 @@ virAdmConnectGetLoggingFilters(virAdmConnectPtr conn,
* Returns 0 if the new output or the set of outputs has been defined
* successfully, or -1 in case of an error.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virAdmConnectSetLoggingOutputs(virAdmConnectPtr conn,
@@ -1307,7 +1307,7 @@ virAdmConnectSetLoggingOutputs(virAdmConnectPtr conn,
* Returns 0 if the new filter or the set of filters has been defined
* successfully, or -1 in case of an error.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virAdmConnectSetLoggingFilters(virAdmConnectPtr conn,
diff --git a/src/libvirt-domain-checkpoint.c b/src/libvirt-domain-checkpoint.c
index a92404a56f..f58f1b4f8f 100644
--- a/src/libvirt-domain-checkpoint.c
+++ b/src/libvirt-domain-checkpoint.c
@@ -36,7 +36,7 @@ VIR_LOG_INIT("libvirt.domain-checkpoint");
* 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
+ * Since: 5.6.0
*/
const char *
virDomainCheckpointGetName(virDomainCheckpointPtr checkpoint)
@@ -61,7 +61,7 @@ virDomainCheckpointGetName(virDomainCheckpointPtr checkpoint)
*
* Returns the domain or NULL.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
virDomainPtr
virDomainCheckpointGetDomain(virDomainCheckpointPtr checkpoint)
@@ -86,7 +86,7 @@ virDomainCheckpointGetDomain(virDomainCheckpointPtr checkpoint)
*
* Returns the connection or NULL.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
virConnectPtr
virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint)
@@ -145,7 +145,7 @@ virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint)
* Returns an (opaque) new virDomainCheckpointPtr on success or NULL
* on failure.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
virDomainCheckpointPtr
virDomainCheckpointCreateXML(virDomainPtr domain,
@@ -216,7 +216,7 @@ 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
+ * Since: 5.6.0
*/
char *
virDomainCheckpointGetXMLDesc(virDomainCheckpointPtr checkpoint,
@@ -292,7 +292,7 @@ virDomainCheckpointGetXMLDesc(virDomainCheckpointPtr checkpoint,
* responsible for calling virDomainCheckpointFree() on each array element,
* then calling free() on @checkpoints.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
int
virDomainListAllCheckpoints(virDomainPtr domain,
@@ -361,7 +361,7 @@ virDomainListAllCheckpoints(virDomainPtr domain,
* for calling virDomainCheckpointFree() on each array element, then calling
* free() on @children.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
int
virDomainCheckpointListAllChildren(virDomainCheckpointPtr checkpoint,
@@ -409,7 +409,7 @@ virDomainCheckpointListAllChildren(virDomainCheckpointPtr checkpoint,
* domain checkpoint cannot be found, then the VIR_ERR_NO_DOMAIN_CHECKPOINT
* error is raised.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
virDomainCheckpointPtr
virDomainCheckpointLookupByName(virDomainPtr domain,
@@ -457,7 +457,7 @@ virDomainCheckpointLookupByName(virDomainPtr domain,
* given checkpoint is a root (no parent), then the VIR_ERR_NO_DOMAIN_CHECKPOINT
* error is raised.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
virDomainCheckpointPtr
virDomainCheckpointGetParent(virDomainCheckpointPtr checkpoint,
@@ -512,7 +512,7 @@ virDomainCheckpointGetParent(virDomainCheckpointPtr checkpoint,
*
* Returns 0 on success, -1 on error.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
int
virDomainCheckpointDelete(virDomainCheckpointPtr checkpoint,
@@ -564,7 +564,7 @@ virDomainCheckpointDelete(virDomainCheckpointPtr checkpoint,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
int
virDomainCheckpointRef(virDomainCheckpointPtr checkpoint)
@@ -589,7 +589,7 @@ virDomainCheckpointRef(virDomainCheckpointPtr checkpoint)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v5.6.0
+ * Since: 5.6.0
*/
int
virDomainCheckpointFree(virDomainCheckpointPtr checkpoint)
diff --git a/src/libvirt-domain-snapshot.c b/src/libvirt-domain-snapshot.c
index 021f6f599d..2917b8bd90 100644
--- a/src/libvirt-domain-snapshot.c
+++ b/src/libvirt-domain-snapshot.c
@@ -36,7 +36,7 @@ VIR_LOG_INIT("libvirt.domain-snapshot");
* 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
+ * Since: 0.9.5
*/
const char *
virDomainSnapshotGetName(virDomainSnapshotPtr snapshot)
@@ -61,7 +61,7 @@ virDomainSnapshotGetName(virDomainSnapshotPtr snapshot)
*
* Returns the domain or NULL.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
virDomainPtr
virDomainSnapshotGetDomain(virDomainSnapshotPtr snapshot)
@@ -86,7 +86,7 @@ virDomainSnapshotGetDomain(virDomainSnapshotPtr snapshot)
*
* Returns the connection or NULL.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
virConnectPtr
virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot)
@@ -220,7 +220,7 @@ virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot)
* Returns an (opaque) new virDomainSnapshotPtr on success or NULL on
* failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
virDomainSnapshotPtr
virDomainSnapshotCreateXML(virDomainPtr domain,
@@ -280,7 +280,7 @@ 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
+ * Since: 0.8.0
*/
char *
virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr snapshot,
@@ -335,7 +335,7 @@ virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr snapshot,
*
* Returns the number of domain snapshots found or -1 in case of error.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainSnapshotNum(virDomainPtr domain, unsigned int flags)
@@ -401,7 +401,7 @@ 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
+ * Since: 0.8.0
*/
int
virDomainSnapshotListNames(virDomainPtr domain, char **names, int nameslen,
@@ -491,7 +491,7 @@ virDomainSnapshotListNames(virDomainPtr domain, char **names, int nameslen,
* for calling virDomainSnapshotFree() on each array element, then calling
* free() on @snaps.
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
int
virDomainListAllSnapshots(virDomainPtr domain, virDomainSnapshotPtr **snaps,
@@ -542,7 +542,7 @@ virDomainListAllSnapshots(virDomainPtr domain, virDomainSnapshotPtr **snaps,
*
* Returns the number of domain snapshots found or -1 in case of error.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
int
virDomainSnapshotNumChildren(virDomainSnapshotPtr snapshot, unsigned int flags)
@@ -610,7 +610,7 @@ 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
+ * Since: 0.9.7
*/
int
virDomainSnapshotListChildrenNames(virDomainSnapshotPtr snapshot,
@@ -683,7 +683,7 @@ virDomainSnapshotListChildrenNames(virDomainSnapshotPtr snapshot,
* for calling virDomainSnapshotFree() on each array element, then calling
* free() on @snaps.
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
int
virDomainSnapshotListAllChildren(virDomainSnapshotPtr snapshot,
@@ -729,7 +729,7 @@ virDomainSnapshotListAllChildren(virDomainSnapshotPtr snapshot,
* domain snapshot cannot be found, then the VIR_ERR_NO_DOMAIN_SNAPSHOT
* error is raised.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
virDomainSnapshotPtr
virDomainSnapshotLookupByName(virDomainPtr domain,
@@ -771,7 +771,7 @@ virDomainSnapshotLookupByName(virDomainPtr domain,
*
* Returns 1 if such snapshot exists, 0 if it doesn't, -1 on error.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainHasCurrentSnapshot(virDomainPtr domain, unsigned int flags)
@@ -813,7 +813,7 @@ virDomainHasCurrentSnapshot(virDomainPtr domain, unsigned int flags)
* current domain snapshot cannot be found, then the VIR_ERR_NO_DOMAIN_SNAPSHOT
* error is raised.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
virDomainSnapshotPtr
virDomainSnapshotCurrent(virDomainPtr domain,
@@ -857,7 +857,7 @@ virDomainSnapshotCurrent(virDomainPtr domain,
* given snapshot is a root (no parent), then the VIR_ERR_NO_DOMAIN_SNAPSHOT
* error is raised.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
virDomainSnapshotPtr
virDomainSnapshotGetParent(virDomainSnapshotPtr snapshot,
@@ -897,7 +897,7 @@ virDomainSnapshotGetParent(virDomainSnapshotPtr snapshot,
*
* Returns 1 if current, 0 if not current, or -1 on error.
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
int
virDomainSnapshotIsCurrent(virDomainSnapshotPtr snapshot,
@@ -938,7 +938,7 @@ 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
+ * Since: 0.9.13
*/
int
virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot,
@@ -1019,7 +1019,7 @@ virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot,
*
* Returns 0 if the creation is successful, -1 on error.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainRevertToSnapshot(virDomainSnapshotPtr snapshot,
@@ -1078,7 +1078,7 @@ virDomainRevertToSnapshot(virDomainSnapshotPtr snapshot,
* Returns 0 if the selected snapshot(s) were successfully deleted,
* -1 on error.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainSnapshotDelete(virDomainSnapshotPtr snapshot,
@@ -1130,7 +1130,7 @@ virDomainSnapshotDelete(virDomainSnapshotPtr snapshot,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
int
virDomainSnapshotRef(virDomainSnapshotPtr snapshot)
@@ -1155,7 +1155,7 @@ virDomainSnapshotRef(virDomainSnapshotPtr snapshot)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainSnapshotFree(virDomainSnapshotPtr snapshot)
diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
index e27d611882..27993829a0 100644
--- a/src/libvirt-domain.c
+++ b/src/libvirt-domain.c
@@ -50,7 +50,7 @@ VIR_LOG_INIT("libvirt.domain");
* that all currently active domains were listed if the return is less
* than @maxids.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virConnectListDomains(virConnectPtr conn, int *ids, int maxids)
@@ -85,7 +85,7 @@ virConnectListDomains(virConnectPtr conn, int *ids, int maxids)
*
* Returns the number of domain found or -1 in case of error
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virConnectNumOfDomains(virConnectPtr conn)
@@ -120,7 +120,7 @@ virConnectNumOfDomains(virConnectPtr conn)
*
* Returns the virConnectPtr or NULL in case of failure.
*
- * Since: v0.3.0
+ * Since: 0.3.0
*/
virConnectPtr
virDomainGetConnect(virDomainPtr dom)
@@ -169,7 +169,7 @@ virDomainGetConnect(virDomainPtr dom)
*
* Returns a new domain object or NULL in case of failure
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
virDomainPtr
virDomainCreateXML(virConnectPtr conn, const char *xmlDesc,
@@ -237,7 +237,7 @@ virDomainCreateXML(virConnectPtr conn, const char *xmlDesc,
*
* Returns a new domain object or NULL in case of failure
*
- * Since: v1.1.1
+ * Since: 1.1.1
*/
virDomainPtr
virDomainCreateXMLWithFiles(virConnectPtr conn, const char *xmlDesc,
@@ -295,7 +295,7 @@ virDomainCreateXMLWithFiles(virConnectPtr conn, const char *xmlDesc,
*
* Returns a new domain object or NULL in case of failure
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
virDomainPtr
virDomainCreateLinux(virConnectPtr conn, const char *xmlDesc,
@@ -320,7 +320,7 @@ 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
+ * Since: 0.0.3
*/
virDomainPtr
virDomainLookupByID(virConnectPtr conn, int id)
@@ -361,7 +361,7 @@ 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
+ * Since: 0.0.5
*/
virDomainPtr
virDomainLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
@@ -402,7 +402,7 @@ 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
+ * Since: 0.1.1
*/
virDomainPtr
virDomainLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
@@ -441,7 +441,7 @@ 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
+ * Since: 0.0.3
*/
virDomainPtr
virDomainLookupByName(virConnectPtr conn, const char *name)
@@ -493,7 +493,7 @@ virDomainLookupByName(virConnectPtr conn, const char *name)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainDestroy(virDomainPtr domain)
@@ -560,7 +560,7 @@ virDomainDestroy(virDomainPtr domain)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainDestroyFlags(virDomainPtr domain,
@@ -602,7 +602,7 @@ virDomainDestroyFlags(virDomainPtr domain,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainFree(virDomainPtr domain)
@@ -635,7 +635,7 @@ virDomainFree(virDomainPtr domain)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.6.0
+ * Since: 0.6.0
*/
int
virDomainRef(virDomainPtr domain)
@@ -665,7 +665,7 @@ virDomainRef(virDomainPtr domain)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainSuspend(virDomainPtr domain)
@@ -709,7 +709,7 @@ virDomainSuspend(virDomainPtr domain)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainResume(virDomainPtr domain)
@@ -767,7 +767,7 @@ virDomainResume(virDomainPtr domain)
* Returns: 0 on success,
* -1 on failure.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virDomainPMSuspendForDuration(virDomainPtr dom,
@@ -816,7 +816,7 @@ virDomainPMSuspendForDuration(virDomainPtr dom,
* Returns: 0 on success,
* -1 on failure.
*
- * Since: v0.9.11
+ * Since: 0.9.11
*/
int
virDomainPMWakeup(virDomainPtr dom,
@@ -865,7 +865,7 @@ virDomainPMWakeup(virDomainPtr dom,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainSave(virDomainPtr domain, const char *to)
@@ -949,7 +949,7 @@ virDomainSave(virDomainPtr domain, const char *to)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainSaveFlags(virDomainPtr domain, const char *to,
@@ -1011,7 +1011,7 @@ virDomainSaveFlags(virDomainPtr domain, const char *to,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainRestore(virConnectPtr conn, const char *from)
@@ -1085,7 +1085,7 @@ virDomainRestore(virConnectPtr conn, const char *from)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainRestoreFlags(virConnectPtr conn, const char *from, const char *dxml,
@@ -1149,7 +1149,7 @@ 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
+ * Since: 0.9.4
*/
char *
virDomainSaveImageGetXMLDesc(virConnectPtr conn, const char *file,
@@ -1219,7 +1219,7 @@ virDomainSaveImageGetXMLDesc(virConnectPtr conn, const char *file,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainSaveImageDefineXML(virConnectPtr conn, const char *file,
@@ -1295,7 +1295,7 @@ virDomainSaveImageDefineXML(virConnectPtr conn, const char *file,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.1.9
+ * Since: 0.1.9
*/
int
virDomainCoreDump(virDomainPtr domain, const char *to, unsigned int flags)
@@ -1373,7 +1373,7 @@ virDomainCoreDump(virDomainPtr domain, const char *to, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
int
virDomainCoreDumpWithFormat(virDomainPtr domain, const char *to,
@@ -1454,7 +1454,7 @@ 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
+ * Since: 0.9.2
*/
char *
virDomainScreenshot(virDomainPtr domain,
@@ -1515,7 +1515,7 @@ virDomainScreenshot(virDomainPtr domain,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainShutdown(virDomainPtr domain)
@@ -1577,7 +1577,7 @@ virDomainShutdown(virDomainPtr domain)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virDomainShutdownFlags(virDomainPtr domain, unsigned int flags)
@@ -1637,7 +1637,7 @@ virDomainShutdownFlags(virDomainPtr domain, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
int
virDomainReboot(virDomainPtr domain, unsigned int flags)
@@ -1683,7 +1683,7 @@ virDomainReboot(virDomainPtr domain, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
int
virDomainReset(virDomainPtr domain, unsigned int flags)
@@ -1724,7 +1724,7 @@ 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
+ * Since: 0.0.3
*/
const char *
virDomainGetName(virDomainPtr domain)
@@ -1748,7 +1748,7 @@ virDomainGetName(virDomainPtr domain)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.0.5
+ * Since: 0.0.5
*/
int
virDomainGetUUID(virDomainPtr domain, unsigned char *uuid)
@@ -1780,7 +1780,7 @@ virDomainGetUUID(virDomainPtr domain, unsigned char *uuid)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.1.1
+ * Since: 0.1.1
*/
int
virDomainGetUUIDString(virDomainPtr domain, char *buf)
@@ -1809,7 +1809,7 @@ virDomainGetUUIDString(virDomainPtr domain, char *buf)
*
* Returns the domain ID number or (unsigned int) -1 in case of error
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
unsigned int
virDomainGetID(virDomainPtr domain)
@@ -1833,7 +1833,7 @@ 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
+ * Since: 0.0.3
*/
char *
virDomainGetOSType(virDomainPtr domain)
@@ -1874,7 +1874,7 @@ virDomainGetOSType(virDomainPtr domain)
* Returns the memory size in kibibytes (blocks of 1024 bytes), or 0 in
* case of error.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
unsigned long
virDomainGetMaxMemory(virDomainPtr domain)
@@ -1925,7 +1925,7 @@ virDomainGetMaxMemory(virDomainPtr domain)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainSetMaxMemory(virDomainPtr domain, unsigned long memory)
@@ -1980,7 +1980,7 @@ virDomainSetMaxMemory(virDomainPtr domain, unsigned long memory)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.1.1
+ * Since: 0.1.1
*/
int
virDomainSetMemory(virDomainPtr domain, unsigned long memory)
@@ -2044,7 +2044,7 @@ virDomainSetMemory(virDomainPtr domain, unsigned long memory)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int
virDomainSetMemoryFlags(virDomainPtr domain, unsigned long memory,
@@ -2106,7 +2106,7 @@ virDomainSetMemoryFlags(virDomainPtr domain, unsigned long memory,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v1.1.1
+ * Since: 1.1.1
*/
int
virDomainSetMemoryStatsPeriod(virDomainPtr domain, int period,
@@ -2158,7 +2158,7 @@ virDomainSetMemoryStatsPeriod(virDomainPtr domain, int period,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
int
virDomainSetMemoryParameters(virDomainPtr domain,
@@ -2234,7 +2234,7 @@ virDomainSetMemoryParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
int
virDomainGetMemoryParameters(virDomainPtr domain,
@@ -2303,7 +2303,7 @@ virDomainGetMemoryParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
int
virDomainSetNumaParameters(virDomainPtr domain,
@@ -2370,7 +2370,7 @@ virDomainSetNumaParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
int
virDomainGetNumaParameters(virDomainPtr domain,
@@ -2429,7 +2429,7 @@ virDomainGetNumaParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int
virDomainSetBlkioParameters(virDomainPtr domain,
@@ -2496,7 +2496,7 @@ virDomainSetBlkioParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int
virDomainGetBlkioParameters(virDomainPtr domain,
@@ -2556,7 +2556,7 @@ virDomainGetBlkioParameters(virDomainPtr domain,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virDomainGetInfo(virDomainPtr domain, virDomainInfoPtr info)
@@ -2604,7 +2604,7 @@ virDomainGetInfo(virDomainPtr domain, virDomainInfoPtr info)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virDomainGetState(virDomainPtr domain,
@@ -2649,7 +2649,7 @@ virDomainGetState(virDomainPtr domain,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virDomainGetControlInfo(virDomainPtr domain,
@@ -2712,7 +2712,7 @@ 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
+ * Since: 0.0.3
*/
char *
virDomainGetXMLDesc(virDomainPtr domain, unsigned int flags)
@@ -2763,7 +2763,7 @@ 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
+ * Since: 0.6.4
*/
char *
virConnectDomainXMLFromNative(virConnectPtr conn,
@@ -2815,7 +2815,7 @@ 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
+ * Since: 0.6.4
*/
char *
virConnectDomainXMLToNative(virConnectPtr conn,
@@ -3670,7 +3670,7 @@ virDomainMigrateUnmanaged(virDomainPtr domain,
* 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
+ * Since: 0.3.2
*/
virDomainPtr
virDomainMigrate(virDomainPtr domain,
@@ -3868,7 +3868,7 @@ virDomainMigrate(virDomainPtr domain,
* 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
+ * Since: 0.9.2
*/
virDomainPtr
virDomainMigrate2(virDomainPtr domain,
@@ -4079,7 +4079,7 @@ virDomainMigrate2(virDomainPtr domain,
* 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
+ * Since: 1.1.0
*/
virDomainPtr
virDomainMigrate3(virDomainPtr domain,
@@ -4369,7 +4369,7 @@ int virDomainMigrateUnmanagedCheckCompat(virDomainPtr domain,
*
* Returns 0 if the migration succeeded, -1 upon error.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virDomainMigrateToURI(virDomainPtr domain,
@@ -4447,7 +4447,7 @@ virDomainMigrateToURI(virDomainPtr domain,
*
* Returns 0 if the migration succeeded, -1 upon error.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virDomainMigrateToURI2(virDomainPtr domain,
@@ -4529,7 +4529,7 @@ virDomainMigrateToURI2(virDomainPtr domain,
*
* Returns 0 if the migration succeeded, -1 upon error.
*
- * Since: v1.1.0
+ * Since: 1.1.0
*/
int
virDomainMigrateToURI3(virDomainPtr domain,
@@ -5400,7 +5400,7 @@ virDomainMigrateConfirm3Params(virDomainPtr domain,
*
* Returns NULL in case of error. The caller must free the returned string.
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
char *
virDomainGetSchedulerType(virDomainPtr domain, int *nparams)
@@ -5450,7 +5450,7 @@ virDomainGetSchedulerType(virDomainPtr domain, int *nparams)
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
int
virDomainGetSchedulerParameters(virDomainPtr domain,
@@ -5517,7 +5517,7 @@ virDomainGetSchedulerParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virDomainGetSchedulerParametersFlags(virDomainPtr domain,
@@ -5583,7 +5583,7 @@ virDomainGetSchedulerParametersFlags(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.2.3
+ * Since: 0.2.3
*/
int
virDomainSetSchedulerParameters(virDomainPtr domain,
@@ -5639,7 +5639,7 @@ virDomainSetSchedulerParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virDomainSetSchedulerParametersFlags(virDomainPtr domain,
@@ -5712,7 +5712,7 @@ virDomainSetSchedulerParametersFlags(virDomainPtr domain,
*
* Returns: 0 in case of success or -1 in case of failure.
*
- * Since: v0.3.2
+ * Since: 0.3.2
*/
int
virDomainBlockStats(virDomainPtr dom, const char *disk,
@@ -5791,7 +5791,7 @@ virDomainBlockStats(virDomainPtr dom, const char *disk,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
int
virDomainBlockStatsFlags(virDomainPtr dom,
@@ -5862,7 +5862,7 @@ virDomainBlockStatsFlags(virDomainPtr dom,
*
* Returns: 0 in case of success or -1 in case of failure.
*
- * Since: v0.3.2
+ * Since: 0.3.2
*/
int
virDomainInterfaceStats(virDomainPtr dom, const char *device,
@@ -5924,7 +5924,7 @@ virDomainInterfaceStats(virDomainPtr dom, const char *device,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
int
virDomainSetInterfaceParameters(virDomainPtr domain,
@@ -5994,7 +5994,7 @@ virDomainSetInterfaceParameters(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.9
+ * Since: 0.9.9
*/
int
virDomainGetInterfaceParameters(virDomainPtr domain,
@@ -6086,7 +6086,7 @@ virDomainGetInterfaceParameters(virDomainPtr domain,
*
* Returns: The number of stats provided or -1 in case of failure.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
int
virDomainMemoryStats(virDomainPtr dom, virDomainMemoryStatPtr stats,
@@ -6167,7 +6167,7 @@ virDomainMemoryStats(virDomainPtr dom, virDomainMemoryStatPtr stats,
*
* Returns: 0 in case of success or -1 in case of failure.
*
- * Since: v0.4.3
+ * Since: 0.4.3
*/
int
virDomainBlockPeek(virDomainPtr dom,
@@ -6238,7 +6238,7 @@ virDomainBlockPeek(virDomainPtr dom,
*
* Returns: 0 in case of success or -1 in case of failure.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
int
virDomainBlockResize(virDomainPtr dom,
@@ -6308,7 +6308,7 @@ virDomainBlockResize(virDomainPtr dom,
*
* Returns: 0 in case of success or -1 in case of failure.
*
- * Since: v0.4.3
+ * Since: 0.4.3
*/
int
virDomainMemoryPeek(virDomainPtr dom,
@@ -6446,7 +6446,7 @@ virDomainMemoryPeek(virDomainPtr dom,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.8.1
+ * Since: 0.8.1
*/
int
virDomainGetBlockInfo(virDomainPtr domain, const char *disk,
@@ -6498,7 +6498,7 @@ virDomainGetBlockInfo(virDomainPtr domain, const char *disk,
*
* Returns NULL in case of error, a pointer to the domain otherwise
*
- * Since: v0.1.1
+ * Since: 0.1.1
*/
virDomainPtr
virDomainDefineXML(virConnectPtr conn, const char *xml)
@@ -6543,7 +6543,7 @@ virDomainDefineXML(virConnectPtr conn, const char *xml)
*
* Returns NULL in case of error, a pointer to the domain otherwise
*
- * Since: v1.2.12
+ * Since: 1.2.12
*/
virDomainPtr
virDomainDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags)
@@ -6588,7 +6588,7 @@ virDomainDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.1.1
+ * Since: 0.1.1
*/
int
virDomainUndefine(virDomainPtr domain)
@@ -6659,7 +6659,7 @@ virDomainUndefine(virDomainPtr domain)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainUndefineFlags(virDomainPtr domain,
@@ -6700,7 +6700,7 @@ virDomainUndefineFlags(virDomainPtr domain,
*
* Returns the number of domain found or -1 in case of error
*
- * Since: v0.1.5
+ * Since: 0.1.5
*/
int
virConnectNumOfDefinedDomains(virConnectPtr conn)
@@ -6745,7 +6745,7 @@ virConnectNumOfDefinedDomains(virConnectPtr conn)
* 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
+ * Since: 0.1.1
*/
int
virConnectListDefinedDomains(virConnectPtr conn, char **const names,
@@ -6846,7 +6846,7 @@ virConnectListDefinedDomains(virConnectPtr conn, char **const names,
* make iteration easier. The caller is responsible for calling virDomainFree()
* on each array element, then calling free() on @domains.
*
- * Since: v0.9.13
+ * Since: 0.9.13
*/
int
virConnectListAllDomains(virConnectPtr conn,
@@ -6889,7 +6889,7 @@ virConnectListAllDomains(virConnectPtr conn,
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.1.1
+ * Since: 0.1.1
*/
int
virDomainCreate(virDomainPtr domain)
@@ -6959,7 +6959,7 @@ virDomainCreate(virDomainPtr domain)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.8.2
+ * Since: 0.8.2
*/
int
virDomainCreateWithFlags(virDomainPtr domain, unsigned int flags)
@@ -7037,7 +7037,7 @@ virDomainCreateWithFlags(virDomainPtr domain, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v1.1.1
+ * Since: 1.1.1
*/
int
virDomainCreateWithFiles(virDomainPtr domain, unsigned int nfiles,
@@ -7096,7 +7096,7 @@ virDomainCreateWithFiles(virDomainPtr domain, unsigned int nfiles,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
int
virDomainGetAutostart(virDomainPtr domain,
@@ -7139,7 +7139,7 @@ virDomainGetAutostart(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
int
virDomainSetAutostart(virDomainPtr domain,
@@ -7181,7 +7181,7 @@ virDomainSetAutostart(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virDomainInjectNMI(virDomainPtr domain, unsigned int flags)
@@ -7225,7 +7225,7 @@ virDomainInjectNMI(virDomainPtr domain, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virDomainSendKey(virDomainPtr domain,
@@ -7312,7 +7312,7 @@ virDomainSendKey(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v1.0.1
+ * Since: 1.0.1
*/
int
virDomainSendProcessSignal(virDomainPtr domain,
@@ -7371,7 +7371,7 @@ virDomainSendProcessSignal(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
int
virDomainSetVcpus(virDomainPtr domain, unsigned int nvcpus)
@@ -7444,7 +7444,7 @@ virDomainSetVcpus(virDomainPtr domain, unsigned int nvcpus)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
int
virDomainSetVcpusFlags(virDomainPtr domain, unsigned int nvcpus,
@@ -7515,7 +7515,7 @@ virDomainSetVcpusFlags(virDomainPtr domain, unsigned int nvcpus,
*
* Returns the number of vCPUs in case of success, -1 in case of failure.
*
- * Since: v0.8.5
+ * Since: 0.8.5
*/
int
virDomainGetVcpusFlags(virDomainPtr domain, unsigned int flags)
@@ -7573,7 +7573,7 @@ virDomainGetVcpusFlags(virDomainPtr domain, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
int
virDomainPinVcpu(virDomainPtr domain, unsigned int vcpu,
@@ -7641,7 +7641,7 @@ virDomainPinVcpu(virDomainPtr domain, unsigned int vcpu,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virDomainPinVcpuFlags(virDomainPtr domain, unsigned int vcpu,
@@ -7701,7 +7701,7 @@ 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
+ * Since: 0.9.3
*/
int
virDomainGetVcpuPinInfo(virDomainPtr domain, int ncpumaps,
@@ -7779,7 +7779,7 @@ virDomainGetVcpuPinInfo(virDomainPtr domain, int ncpumaps,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
int
virDomainPinEmulator(virDomainPtr domain, unsigned char *cpumap,
@@ -7836,7 +7836,7 @@ virDomainPinEmulator(virDomainPtr domain, unsigned char *cpumap,
* 0 in case of no emulator threads are pined to pcpus,
* -1 in case of failure.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
int
virDomainGetEmulatorPinInfo(virDomainPtr domain, unsigned char *cpumap,
@@ -7903,7 +7903,7 @@ virDomainGetEmulatorPinInfo(virDomainPtr domain, unsigned char *cpumap,
*
* Returns the number of info filled in case of success, -1 in case of failure.
*
- * Since: v0.1.4
+ * Since: 0.1.4
*/
int
virDomainGetVcpus(virDomainPtr domain, virVcpuInfoPtr info, int maxinfo,
@@ -7964,7 +7964,7 @@ virDomainGetVcpus(virDomainPtr domain, virVcpuInfoPtr info, int maxinfo,
*
* Returns the maximum of virtual CPU or -1 in case of error.
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
int
virDomainGetMaxVcpus(virDomainPtr domain)
@@ -8010,7 +8010,7 @@ virDomainGetMaxVcpus(virDomainPtr domain)
* responsible for calling virDomainIOThreadInfoFree() on each array element,
* then calling free() on @info. On error, @info is set to NULL.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
int
virDomainGetIOThreadInfo(virDomainPtr dom,
@@ -8051,7 +8051,7 @@ virDomainGetIOThreadInfo(virDomainPtr dom,
*
* Frees the memory used by @info.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
void
virDomainIOThreadInfoFree(virDomainIOThreadInfoPtr info)
@@ -8096,7 +8096,7 @@ virDomainIOThreadInfoFree(virDomainIOThreadInfoPtr info)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
int
virDomainPinIOThread(virDomainPtr domain,
@@ -8162,7 +8162,7 @@ virDomainPinIOThread(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v1.2.15
+ * Since: 1.2.15
*/
int
virDomainAddIOThread(virDomainPtr domain,
@@ -8223,7 +8223,7 @@ virDomainAddIOThread(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v1.2.15
+ * Since: 1.2.15
*/
int
virDomainDelIOThread(virDomainPtr domain,
@@ -8286,7 +8286,7 @@ virDomainDelIOThread(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v4.10.0
+ * Since: 4.10.0
*/
int
virDomainSetIOThreadParams(virDomainPtr domain,
@@ -8341,7 +8341,7 @@ virDomainSetIOThreadParams(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
int
virDomainGetSecurityLabel(virDomainPtr domain, virSecurityLabelPtr seclabel)
@@ -8385,7 +8385,7 @@ virDomainGetSecurityLabel(virDomainPtr domain, virSecurityLabelPtr seclabel)
*
* Returns number of elements in @seclabels on success, -1 in case of failure.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
int
virDomainGetSecurityLabelList(virDomainPtr domain,
@@ -8449,7 +8449,7 @@ virDomainGetSecurityLabelList(virDomainPtr domain,
*
* Returns 0 on success, -1 in case of failure.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virDomainSetMetadata(virDomainPtr domain,
@@ -8536,7 +8536,7 @@ virDomainSetMetadata(virDomainPtr domain,
* Returns the metadata string on success (caller must free),
* or NULL in case of failure.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
char *
virDomainGetMetadata(virDomainPtr domain,
@@ -8605,7 +8605,7 @@ virDomainGetMetadata(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.1.9
+ * Since: 0.1.9
*/
int
virDomainAttachDevice(virDomainPtr domain, const char *xml)
@@ -8666,7 +8666,7 @@ virDomainAttachDevice(virDomainPtr domain, const char *xml)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
int
virDomainAttachDeviceFlags(virDomainPtr domain,
@@ -8712,7 +8712,7 @@ virDomainAttachDeviceFlags(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.1.9
+ * Since: 0.1.9
*/
int
virDomainDetachDevice(virDomainPtr domain, const char *xml)
@@ -8796,7 +8796,7 @@ virDomainDetachDevice(virDomainPtr domain, const char *xml)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
int
virDomainDetachDeviceFlags(virDomainPtr domain,
@@ -8862,7 +8862,7 @@ virDomainDetachDeviceFlags(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainUpdateDeviceFlags(virDomainPtr domain,
@@ -8918,7 +8918,7 @@ virDomainUpdateDeviceFlags(virDomainPtr domain,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v4.4.0
+ * Since: 4.4.0
*/
int
virDomainDetachDeviceAlias(virDomainPtr domain,
@@ -8980,7 +8980,7 @@ virDomainDetachDeviceAlias(virDomainPtr domain,
* sometimes returned a positive number on success, but without any reliable
* semantics on what that number represents.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virConnectDomainEventRegister(virConnectPtr conn,
@@ -9025,7 +9025,7 @@ virConnectDomainEventRegister(virConnectPtr conn,
* sometimes returned a positive number on success, but without any reliable
* semantics on what that number represents.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virConnectDomainEventDeregister(virConnectPtr conn,
@@ -9061,7 +9061,7 @@ virConnectDomainEventDeregister(virConnectPtr conn,
*
* Returns 1 if running, 0 if inactive, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virDomainIsActive(virDomainPtr dom)
@@ -9096,7 +9096,7 @@ virDomainIsActive(virDomainPtr dom)
*
* Returns 1 if persistent, 0 if transient, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virDomainIsPersistent(virDomainPtr dom)
@@ -9138,7 +9138,7 @@ virDomainIsPersistent(virDomainPtr dom)
*
* Returns 0 if successfully renamed, -1 on error
*
- * Since: v1.2.19
+ * Since: 1.2.19
*/
int
virDomainRename(virDomainPtr dom,
@@ -9173,7 +9173,7 @@ virDomainRename(virDomainPtr dom,
*
* Returns 1 if updated, 0 if not, -1 on error
*
- * Since: v0.8.6
+ * Since: 0.8.6
*/
int
virDomainIsUpdated(virDomainPtr dom)
@@ -9212,7 +9212,7 @@ virDomainIsUpdated(virDomainPtr dom)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
int
virDomainGetJobInfo(virDomainPtr domain, virDomainJobInfoPtr info)
@@ -9278,7 +9278,7 @@ virDomainGetJobInfo(virDomainPtr domain, virDomainJobInfoPtr info)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
int
virDomainGetJobStats(virDomainPtr domain,
@@ -9332,7 +9332,7 @@ virDomainGetJobStats(virDomainPtr domain,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
int
virDomainAbortJob(virDomainPtr domain)
@@ -9376,7 +9376,7 @@ virDomainAbortJob(virDomainPtr domain)
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainMigrateSetMaxDowntime(virDomainPtr domain,
@@ -9419,7 +9419,7 @@ virDomainMigrateSetMaxDowntime(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v3.7.0
+ * Since: 3.7.0
*/
int
virDomainMigrateGetMaxDowntime(virDomainPtr domain,
@@ -9461,7 +9461,7 @@ virDomainMigrateGetMaxDowntime(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
int
virDomainMigrateGetCompressionCache(virDomainPtr domain,
@@ -9507,7 +9507,7 @@ virDomainMigrateGetCompressionCache(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
int
virDomainMigrateSetCompressionCache(virDomainPtr domain,
@@ -9553,7 +9553,7 @@ virDomainMigrateSetCompressionCache(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int
virDomainMigrateSetMaxSpeed(virDomainPtr domain,
@@ -9598,7 +9598,7 @@ virDomainMigrateSetMaxSpeed(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v0.9.5
+ * Since: 0.9.5
*/
int
virDomainMigrateGetMaxSpeed(virDomainPtr domain,
@@ -9693,7 +9693,7 @@ virDomainMigrateGetMaxSpeed(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
int
virDomainMigrateStartPostCopy(virDomainPtr domain,
@@ -9758,7 +9758,7 @@ virDomainMigrateStartPostCopy(virDomainPtr domain,
*
* Returns a callback identifier on success, -1 on failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virConnectDomainEventRegisterAny(virConnectPtr conn,
@@ -9819,7 +9819,7 @@ virConnectDomainEventRegisterAny(virConnectPtr conn,
* sometimes returned a positive number on success, but without any reliable
* semantics on what that number represents.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virConnectDomainEventDeregisterAny(virConnectPtr conn,
@@ -9876,7 +9876,7 @@ virConnectDomainEventDeregisterAny(virConnectPtr conn,
*
* Returns 0 in case of success or -1 in case of failure
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainManagedSave(virDomainPtr dom, unsigned int flags)
@@ -9925,7 +9925,7 @@ 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
+ * Since: 0.8.0
*/
int
virDomainHasManagedSaveImage(virDomainPtr dom, unsigned int flags)
@@ -9965,7 +9965,7 @@ virDomainHasManagedSaveImage(virDomainPtr dom, unsigned int flags)
*
* Returns 0 in case of success, and -1 in case of error
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virDomainManagedSaveRemove(virDomainPtr dom, unsigned int flags)
@@ -10013,7 +10013,7 @@ 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
+ * Since: 3.7.0
*/
char *
virDomainManagedSaveGetXMLDesc(virDomainPtr domain, unsigned int flags)
@@ -10073,7 +10073,7 @@ virDomainManagedSaveGetXMLDesc(virDomainPtr domain, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v3.7.0
+ * Since: 3.7.0
*/
int
virDomainManagedSaveDefineXML(virDomainPtr domain, const char *dxml,
@@ -10140,7 +10140,7 @@ virDomainManagedSaveDefineXML(virDomainPtr domain, const char *dxml,
*
* Returns 0 if the console was opened, -1 on error
*
- * Since: v0.8.6
+ * Since: 0.8.6
*/
int
virDomainOpenConsole(virDomainPtr dom,
@@ -10206,7 +10206,7 @@ virDomainOpenConsole(virDomainPtr dom,
*
* Returns 0 if the channel was opened, -1 on error
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virDomainOpenChannel(virDomainPtr dom,
@@ -10265,7 +10265,7 @@ virDomainOpenChannel(virDomainPtr dom,
*
* Returns -1 in case of failure, 0 in case of success.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
int virDomainGetPerfEvents(virDomainPtr domain,
virTypedParameterPtr *params,
@@ -10317,7 +10317,7 @@ int virDomainGetPerfEvents(virDomainPtr domain,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v1.3.3
+ * Since: 1.3.3
*/
int virDomainSetPerfEvents(virDomainPtr domain,
virTypedParameterPtr params,
@@ -10402,7 +10402,7 @@ int virDomainSetPerfEvents(virDomainPtr domain,
*
* Returns -1 in case of failure, 0 when successful.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainBlockJobAbort(virDomainPtr dom, const char *disk,
@@ -10481,7 +10481,7 @@ virDomainBlockJobAbort(virDomainPtr dom, const char *disk,
*
* Returns -1 in case of failure, 0 when nothing found, 1 when info was found.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk,
@@ -10546,7 +10546,7 @@ virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk,
*
* Returns -1 in case of failure, 0 when successful.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk,
@@ -10622,7 +10622,7 @@ virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk,
*
* Returns 0 if the operation has started, -1 on failure.
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
int
virDomainBlockPull(virDomainPtr dom, const char *disk,
@@ -10768,7 +10768,7 @@ virDomainBlockPull(virDomainPtr dom, const char *disk,
*
* Returns 0 if the operation has started, -1 on failure.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virDomainBlockRebase(virDomainPtr dom, const char *disk,
@@ -10900,7 +10900,7 @@ virDomainBlockRebase(virDomainPtr dom, const char *disk,
*
* Returns 0 if the operation has started, -1 on failure.
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
int
virDomainBlockCopy(virDomainPtr dom, const char *disk,
@@ -11048,7 +11048,7 @@ virDomainBlockCopy(virDomainPtr dom, const char *disk,
*
* Returns 0 if the operation has started, -1 on failure.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virDomainBlockCommit(virDomainPtr dom, const char *disk,
@@ -11109,7 +11109,7 @@ virDomainBlockCommit(virDomainPtr dom, const char *disk,
*
* Returns 0 on success, -1 on failure
*
- * Since: v0.9.7
+ * Since: 0.9.7
*/
int
virDomainOpenGraphics(virDomainPtr dom,
@@ -11191,7 +11191,7 @@ virDomainOpenGraphics(virDomainPtr dom,
*
* Returns an fd on success, -1 on failure
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
int
virDomainOpenGraphicsFD(virDomainPtr dom,
@@ -11254,7 +11254,7 @@ virDomainOpenGraphicsFD(virDomainPtr dom,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
int
virDomainSetBlockIoTune(virDomainPtr dom,
@@ -11331,7 +11331,7 @@ virDomainSetBlockIoTune(virDomainPtr dom,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
int
virDomainGetBlockIoTune(virDomainPtr dom,
@@ -11462,7 +11462,7 @@ virDomainGetBlockIoTune(virDomainPtr dom,
* @ncpus is too large). The caller is responsible for freeing any
* returned string parameters.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virDomainGetCPUStats(virDomainPtr domain,
@@ -11564,7 +11564,7 @@ virDomainGetCPUStats(virDomainPtr domain,
* Returns number of disks with errors filled in the @errors array or -1 on
* error.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virDomainGetDiskErrors(virDomainPtr dom,
@@ -11611,7 +11611,7 @@ virDomainGetDiskErrors(virDomainPtr dom,
* Returns the hostname which must be freed by the caller, or
* NULL if there was an error.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
char *
virDomainGetHostname(virDomainPtr domain, unsigned int flags)
@@ -11662,7 +11662,7 @@ virDomainGetHostname(virDomainPtr domain, unsigned int flags)
*
* Returns 0 on success, -1 otherwise.
*
- * Since: v1.0.1
+ * Since: 1.0.1
*/
int
virDomainFSTrim(virDomainPtr dom,
@@ -11708,7 +11708,7 @@ virDomainFSTrim(virDomainPtr dom,
*
* Returns the number of frozen filesystems on success, -1 otherwise.
*
- * Since: v1.2.5
+ * Since: 1.2.5
*/
int
virDomainFSFreeze(virDomainPtr dom,
@@ -11753,7 +11753,7 @@ virDomainFSFreeze(virDomainPtr dom,
*
* Returns the number of thawed filesystems on success, -1 otherwise.
*
- * Since: v1.2.5
+ * Since: 1.2.5
*/
int
virDomainFSThaw(virDomainPtr dom,
@@ -11800,7 +11800,7 @@ virDomainFSThaw(virDomainPtr dom,
*
* Returns 0 on success, -1 otherwise.
*
- * Since: v1.2.5
+ * Since: 1.2.5
*/
int
virDomainGetTime(virDomainPtr dom,
@@ -11852,7 +11852,7 @@ virDomainGetTime(virDomainPtr dom,
*
* Returns 0 on success, -1 otherwise.
*
- * Since: v1.2.5
+ * Since: 1.2.5
*/
int
virDomainSetTime(virDomainPtr dom,
@@ -11900,7 +11900,7 @@ virDomainSetTime(virDomainPtr dom,
*
* Returns 0 on success, -1 otherwise.
*
- * Since: v1.2.16
+ * Since: 1.2.16
*/
int
virDomainSetUserPassword(virDomainPtr dom,
@@ -11952,7 +11952,7 @@ virDomainSetUserPassword(virDomainPtr dom,
* Returns NULL in case of error or an XML string
* defining the capabilities.
*
- * Since: v1.2.7
+ * Since: 1.2.7
*/
char *
virConnectGetDomainCapabilities(virConnectPtr conn,
@@ -12360,7 +12360,7 @@ virConnectGetDomainCapabilities(virConnectPtr conn,
* The requested data are returned in the @retStats parameter. The returned
* array should be freed by the caller. See virDomainStatsRecordListFree.
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
int
virConnectGetAllDomainStats(virConnectPtr conn,
@@ -12441,7 +12441,7 @@ virConnectGetAllDomainStats(virConnectPtr conn,
* Note that the count of returned stats may be less than the domain count
* provided via @doms.
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
int
virDomainListGetStats(virDomainPtr *doms,
@@ -12510,7 +12510,7 @@ virDomainListGetStats(virDomainPtr *doms,
* Convenience function to free a list of domain stats returned by
* virDomainListGetStats and virConnectGetAllDomainStats.
*
- * Since: v1.2.8
+ * Since: 1.2.8
*/
void
virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats)
@@ -12544,7 +12544,7 @@ virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats)
* responsible for calling virDomainFSInfoFree() on each array element, then
* calling free() on @info. On error, @info is set to NULL.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
int
virDomainGetFSInfo(virDomainPtr dom,
@@ -12581,7 +12581,7 @@ virDomainGetFSInfo(virDomainPtr dom,
*
* Frees all the memory occupied by @info.
*
- * Since: v1.2.11
+ * Since: 1.2.11
*/
void
virDomainFSInfoFree(virDomainFSInfoPtr info)
@@ -12675,7 +12675,7 @@ virDomainFSInfoFree(virDomainFSInfoPtr info)
*
* Returns the number of interfaces on success, -1 in case of error.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
int
virDomainInterfaceAddresses(virDomainPtr dom,
@@ -12718,7 +12718,7 @@ virDomainInterfaceAddresses(virDomainPtr dom,
* freed and should not be used thereafter. If @iface
* is NULL, then this method has no effect.
*
- * Since: v1.2.14
+ * Since: 1.2.14
*/
void
virDomainInterfaceFree(virDomainInterfacePtr iface)
@@ -12763,7 +12763,7 @@ virDomainInterfaceFree(virDomainInterfacePtr iface)
*
* Returns 0 on success, -1 on error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virDomainGetGuestVcpus(virDomainPtr domain,
@@ -12823,7 +12823,7 @@ virDomainGetGuestVcpus(virDomainPtr domain,
*
* Returns 0 on success, -1 on error.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virDomainSetGuestVcpus(virDomainPtr domain,
@@ -12874,7 +12874,7 @@ virDomainSetGuestVcpus(virDomainPtr domain,
*
* Returns 0 on success, -1 on error.
*
- * Since: v3.1.0
+ * Since: 3.1.0
*/
int
virDomainSetVcpu(virDomainPtr domain,
@@ -13028,7 +13028,7 @@ virDomainSetVcpu(virDomainPtr domain,
*
* Returns 0 on success, -1 on error.
*
- * Since: v5.7.0
+ * Since: 5.7.0
*/
int virDomainGetGuestInfo(virDomainPtr domain,
unsigned int types,
@@ -13104,7 +13104,7 @@ int virDomainGetGuestInfo(virDomainPtr domain,
*
* Returns 0 if the operation has started, -1 on failure.
*
- * Since: v3.2.0
+ * Since: 3.2.0
*/
int
virDomainSetBlockThreshold(virDomainPtr domain,
@@ -13155,7 +13155,7 @@ virDomainSetBlockThreshold(virDomainPtr domain,
*
* Returns 0 on success, -1 on failure.
*
- * Since: v3.9.0
+ * Since: 3.9.0
*/
int virDomainSetLifecycleAction(virDomainPtr domain,
unsigned int type,
@@ -13212,7 +13212,7 @@ int virDomainSetLifecycleAction(virDomainPtr domain,
*
* Returns -1 in case of failure, 0 in case of success.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int virDomainGetLaunchSecurityInfo(virDomainPtr domain,
virTypedParameterPtr *params,
@@ -13280,7 +13280,7 @@ int virDomainGetLaunchSecurityInfo(virDomainPtr domain,
*
* Returns -1 in case of failure, 0 in case of success.
*
- * Since: v8.0.0
+ * Since: 8.0.0
*/
int virDomainSetLaunchSecurityState(virDomainPtr domain,
virTypedParameterPtr params,
@@ -13339,7 +13339,7 @@ int virDomainSetLaunchSecurityState(virDomainPtr domain,
*
* Returns 0 on success, -1 on failure
*
- * Since: v5.10.0
+ * Since: 5.10.0
*/
int
virDomainAgentSetResponseTimeout(virDomainPtr domain,
@@ -13437,7 +13437,7 @@ virDomainAgentSetResponseTimeout(virDomainPtr domain,
*
* Returns 0 on success or -1 on failure.
*
- * Since: v6.0.0
+ * Since: 6.0.0
*/
int
virDomainBackupBegin(virDomainPtr domain,
@@ -13489,7 +13489,7 @@ 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
+ * Since: 6.0.0
*/
char *
virDomainBackupGetXMLDesc(virDomainPtr domain,
@@ -13540,7 +13540,7 @@ virDomainBackupGetXMLDesc(virDomainPtr domain,
* Returns: number of keys stored in @keys,
* -1 otherwise.
*
- * Since: v6.10.0
+ * Since: 6.10.0
*/
int
virDomainAuthorizedSSHKeysGet(virDomainPtr domain,
@@ -13610,7 +13610,7 @@ virDomainAuthorizedSSHKeysGet(virDomainPtr domain,
* Returns: 0 on success,
* -1 otherwise.
*
- * Since: v6.10.0
+ * Since: 6.10.0
*/
int
virDomainAuthorizedSSHKeysSet(virDomainPtr domain,
@@ -13680,7 +13680,7 @@ virDomainAuthorizedSSHKeysSet(virDomainPtr domain,
* Returns: number of messages stored in @msgs,
* -1 otherwise.
*
- * Since: v7.1.0
+ * Since: 7.1.0
*/
int
virDomainGetMessages(virDomainPtr domain,
@@ -13724,7 +13724,7 @@ virDomainGetMessages(virDomainPtr domain,
*
* Returns 0 in case of success, -1 otherwise.
*
- * Since: v7.2.0
+ * Since: 7.2.0
*/
int
virDomainStartDirtyRateCalc(virDomainPtr domain,
diff --git a/src/libvirt-host.c b/src/libvirt-host.c
index 7e7545d447..2ee6370bce 100644
--- a/src/libvirt-host.c
+++ b/src/libvirt-host.c
@@ -48,7 +48,7 @@ VIR_LOG_INIT("libvirt.host");
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v0.6.0
+ * Since: 0.6.0
*/
int
virConnectRef(virConnectPtr conn)
@@ -88,7 +88,7 @@ virConnectRef(virConnectPtr conn)
*
* Returns: 0 if the identity change was accepted, -1 on error
*
- * Since: v5.8.0
+ * Since: 5.8.0
*/
int
virConnectSetIdentity(virConnectPtr conn,
@@ -154,7 +154,7 @@ virConnectSupportsFeature(virConnectPtr conn, int feature)
*
* Returns NULL in case of error, a static zero terminated string otherwise.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
const char *
virConnectGetType(virConnectPtr conn)
@@ -187,7 +187,7 @@ virConnectGetType(virConnectPtr conn)
* 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
+ * Since: 0.0.3
*/
int
virConnectGetVersion(virConnectPtr conn, unsigned long *hvVer)
@@ -225,7 +225,7 @@ 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
+ * Since: 0.7.3
*/
int
virConnectGetLibVersion(virConnectPtr conn, unsigned long *libVer)
@@ -267,7 +267,7 @@ 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
+ * Since: 0.3.0
*/
char *
virConnectGetHostname(virConnectPtr conn)
@@ -308,7 +308,7 @@ 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
+ * Since: 0.3.0
*/
char *
virConnectGetURI(virConnectPtr conn)
@@ -344,7 +344,7 @@ 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
+ * Since: 0.8.8
*/
char *
virConnectGetSysinfo(virConnectPtr conn, unsigned int flags)
@@ -384,7 +384,7 @@ virConnectGetSysinfo(virConnectPtr conn, unsigned int flags)
*
* Returns the maximum of virtual CPU or -1 in case of error.
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
int
virConnectGetMaxVcpus(virConnectPtr conn,
@@ -435,7 +435,7 @@ virConnectGetMaxVcpus(virConnectPtr conn,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
int
virNodeGetInfo(virConnectPtr conn, virNodeInfoPtr info)
@@ -473,7 +473,7 @@ virNodeGetInfo(virConnectPtr conn, virNodeInfoPtr info)
* defining the capabilities.
* The client must free the returned string after use.
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
char *
virConnectGetCapabilities(virConnectPtr conn)
@@ -555,7 +555,7 @@ virConnectGetCapabilities(virConnectPtr conn)
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virNodeGetCPUStats(virConnectPtr conn,
@@ -644,7 +644,7 @@ virNodeGetCPUStats(virConnectPtr conn,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virNodeGetMemoryStats(virConnectPtr conn,
@@ -693,7 +693,7 @@ virNodeGetMemoryStats(virConnectPtr conn,
*
* Returns the available free memory in bytes or 0 in case of error
*
- * Since: v0.3.3
+ * Since: 0.3.3
*/
unsigned long long
virNodeGetFreeMemory(virConnectPtr conn)
@@ -741,7 +741,7 @@ virNodeGetFreeMemory(virConnectPtr conn)
* delay), -1 on failure (the operation is not supported, or an attempted
* suspend is already underway).
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
int
virNodeSuspendForDuration(virConnectPtr conn,
@@ -796,7 +796,7 @@ virNodeSuspendForDuration(virConnectPtr conn,
*
* Returns 0 in case of success, and -1 in case of failure.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virNodeGetMemoryParameters(virConnectPtr conn,
@@ -862,7 +862,7 @@ virNodeGetMemoryParameters(virConnectPtr conn,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virNodeSetMemoryParameters(virConnectPtr conn,
@@ -912,7 +912,7 @@ virNodeSetMemoryParameters(virConnectPtr conn,
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
int
virNodeGetSecurityModel(virConnectPtr conn, virSecurityModelPtr secmodel)
@@ -957,7 +957,7 @@ virNodeGetSecurityModel(virConnectPtr conn, virSecurityModelPtr secmodel)
*
* Returns the number of entries filled in freeMems, or -1 in case of error.
*
- * Since: v0.3.3
+ * Since: 0.3.3
*/
int
virNodeGetCellsFreeMemory(virConnectPtr conn, unsigned long long *freeMems,
@@ -997,7 +997,7 @@ virNodeGetCellsFreeMemory(virConnectPtr conn, unsigned long long *freeMems,
*
* Returns 1 if encrypted, 0 if not encrypted, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virConnectIsEncrypted(virConnectPtr conn)
@@ -1034,7 +1034,7 @@ virConnectIsEncrypted(virConnectPtr conn)
*
* Returns 1 if secure, 0 if not secure, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virConnectIsSecure(virConnectPtr conn)
@@ -1078,7 +1078,7 @@ virConnectIsSecure(virConnectPtr conn)
* VIR_ERR_CPU_INCOMPATIBLE code with a message providing more details about
* the incompatibility.
*
- * Since: v0.7.5
+ * Since: 0.7.5
*/
int
virConnectCompareCPU(virConnectPtr conn,
@@ -1136,7 +1136,7 @@ virConnectCompareCPU(virConnectPtr conn,
* VIR_ERR_CPU_INCOMPATIBLE code with a message providing more details about
* the incompatibility.
*
- * Since: v4.4.0
+ * Since: 4.4.0
*/
int
virConnectCompareHypervisorCPU(virConnectPtr conn,
@@ -1200,7 +1200,7 @@ 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
+ * Since: 1.1.3
*/
int
virConnectGetCPUModelNames(virConnectPtr conn, const char *arch, char ***models,
@@ -1258,7 +1258,7 @@ virConnectGetCPUModelNames(virConnectPtr conn, const char *arch, char ***models,
*
* Returns XML description of the computed CPU (caller frees) or NULL on error.
*
- * Since: v0.7.7
+ * Since: 0.7.7
*/
char *
virConnectBaselineCPU(virConnectPtr conn,
@@ -1329,7 +1329,7 @@ virConnectBaselineCPU(virConnectPtr conn,
*
* Returns XML description of the computed CPU (caller frees) or NULL on error.
*
- * Since: v4.4.0
+ * Since: 4.4.0
*/
char *
virConnectBaselineHypervisorCPU(virConnectPtr conn,
@@ -1404,7 +1404,7 @@ virConnectBaselineHypervisorCPU(virConnectPtr conn,
* Returns -1 on error, 0 on success, 1 when remote party doesn't support
* keepalive messages.
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
int
virConnectSetKeepAlive(virConnectPtr conn,
@@ -1443,7 +1443,7 @@ virConnectSetKeepAlive(virConnectPtr conn,
*
* Returns 1 if alive, 0 if dead, -1 on error
*
- * Since: v0.9.8
+ * Since: 0.9.8
*/
int
virConnectIsAlive(virConnectPtr conn)
@@ -1491,7 +1491,7 @@ virConnectIsAlive(virConnectPtr conn)
*
* Returns 0 on success, -1 on error
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
int
virConnectRegisterCloseCallback(virConnectPtr conn,
@@ -1530,7 +1530,7 @@ virConnectRegisterCloseCallback(virConnectPtr conn,
*
* Returns 0 on success, -1 on error
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
int
virConnectUnregisterCloseCallback(virConnectPtr conn,
@@ -1574,7 +1574,7 @@ virConnectUnregisterCloseCallback(virConnectPtr conn,
* Returns number of CPUs present on the host node,
* or -1 if there was an error.
*
- * Since: v1.0.0
+ * Since: 1.0.0
*/
int
virNodeGetCPUMap(virConnectPtr conn,
@@ -1662,7 +1662,7 @@ virNodeGetCPUMap(virConnectPtr conn,
*
* Returns: the number of entries filled in @counts or -1 in case of error.
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
int
virNodeGetFreePages(virConnectPtr conn,
@@ -1734,7 +1734,7 @@ virNodeGetFreePages(virConnectPtr conn,
* Returns: the number of nodes successfully adjusted or -1 in
* case of an error.
*
- * Since: v1.2.9
+ * Since: 1.2.9
*/
int
virNodeAllocPages(virConnectPtr conn,
@@ -1789,7 +1789,7 @@ virNodeAllocPages(virConnectPtr conn,
*
* Returns 0 in case of success, and -1 in case of failure.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int
virNodeGetSEVInfo(virConnectPtr conn,
diff --git a/src/libvirt-interface.c b/src/libvirt-interface.c
index b1194fd803..7affe03470 100644
--- a/src/libvirt-interface.c
+++ b/src/libvirt-interface.c
@@ -37,7 +37,7 @@ VIR_LOG_INIT("libvirt.interface");
*
* Returns the virConnectPtr or NULL in case of failure.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
virConnectPtr
virInterfaceGetConnect(virInterfacePtr iface)
@@ -79,7 +79,7 @@ virInterfaceGetConnect(virInterfacePtr iface)
* to make iteration easier. The caller is responsible for calling
* virStorageInterfaceFree() on each array element, then calling free() on @ifaces.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virConnectListAllInterfaces(virConnectPtr conn,
@@ -120,7 +120,7 @@ virConnectListAllInterfaces(virConnectPtr conn,
*
* Returns the number of active interfaces found or -1 in case of error
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
int
virConnectNumOfInterfaces(virConnectPtr conn)
@@ -165,7 +165,7 @@ virConnectNumOfInterfaces(virConnectPtr conn)
* 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
+ * Since: 0.6.4
*/
int
virConnectListInterfaces(virConnectPtr conn, char **const names, int maxnames)
@@ -202,7 +202,7 @@ virConnectListInterfaces(virConnectPtr conn, char **const names, int maxnames)
*
* Returns the number of defined interface found or -1 in case of error
*
- * Since: v0.7.0
+ * Since: 0.7.0
*/
int
virConnectNumOfDefinedInterfaces(virConnectPtr conn)
@@ -247,7 +247,7 @@ virConnectNumOfDefinedInterfaces(virConnectPtr conn)
* 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
+ * Since: 0.7.0
*/
int
virConnectListDefinedInterfaces(virConnectPtr conn,
@@ -291,7 +291,7 @@ 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
+ * Since: 0.6.4
*/
virInterfacePtr
virInterfaceLookupByName(virConnectPtr conn, const char *name)
@@ -332,7 +332,7 @@ 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
+ * Since: 0.6.4
*/
virInterfacePtr
virInterfaceLookupByMACString(virConnectPtr conn, const char *macstr)
@@ -369,7 +369,7 @@ 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
+ * Since: 0.6.4
*/
const char *
virInterfaceGetName(virInterfacePtr iface)
@@ -395,7 +395,7 @@ virInterfaceGetName(virInterfacePtr iface)
* format) or NULL, the string need not be deallocated its lifetime
* will be the same as the interface object.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
const char *
virInterfaceGetMACString(virInterfacePtr iface)
@@ -428,7 +428,7 @@ 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
+ * Since: 0.6.4
*/
char *
virInterfaceGetXMLDesc(virInterfacePtr iface, unsigned int flags)
@@ -481,7 +481,7 @@ virInterfaceGetXMLDesc(virInterfacePtr iface, unsigned int flags)
*
* Returns NULL in case of error, a pointer to the interface otherwise
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
virInterfacePtr
virInterfaceDefineXML(virConnectPtr conn, const char *xml, unsigned int flags)
@@ -529,7 +529,7 @@ virInterfaceDefineXML(virConnectPtr conn, const char *xml, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
int
virInterfaceUndefine(virInterfacePtr iface)
@@ -574,7 +574,7 @@ virInterfaceUndefine(virInterfacePtr iface)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
int
virInterfaceCreate(virInterfacePtr iface, unsigned int flags)
@@ -623,7 +623,7 @@ virInterfaceCreate(virInterfacePtr iface, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
int
virInterfaceDestroy(virInterfacePtr iface, unsigned int flags)
@@ -671,7 +671,7 @@ virInterfaceDestroy(virInterfacePtr iface, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
int
virInterfaceRef(virInterfacePtr iface)
@@ -696,7 +696,7 @@ virInterfaceRef(virInterfacePtr iface)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
int
virInterfaceFree(virInterfacePtr iface)
@@ -729,7 +729,7 @@ virInterfaceFree(virInterfacePtr iface)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virInterfaceChangeBegin(virConnectPtr conn, unsigned int flags)
@@ -771,7 +771,7 @@ virInterfaceChangeBegin(virConnectPtr conn, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virInterfaceChangeCommit(virConnectPtr conn, unsigned int flags)
@@ -813,7 +813,7 @@ virInterfaceChangeCommit(virConnectPtr conn, unsigned int flags)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.9.2
+ * Since: 0.9.2
*/
int
virInterfaceChangeRollback(virConnectPtr conn, unsigned int flags)
@@ -850,7 +850,7 @@ virInterfaceChangeRollback(virConnectPtr conn, unsigned int flags)
*
* Returns 1 if running, 0 if inactive, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virInterfaceIsActive(virInterfacePtr iface)
diff --git a/src/libvirt-lxc.c b/src/libvirt-lxc.c
index ea72e15569..ab7e88c1c5 100644
--- a/src/libvirt-lxc.c
+++ b/src/libvirt-lxc.c
@@ -60,7 +60,7 @@ VIR_LOG_INIT("libvirt-lxc");
*
* Returns the number of opened file descriptors, or -1 on error
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virDomainLxcOpenNamespace(virDomainPtr domain,
@@ -118,7 +118,7 @@ virDomainLxcOpenNamespace(virDomainPtr domain,
*
* Returns 0 on success, -1 on error
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virDomainLxcEnterNamespace(virDomainPtr domain,
@@ -187,7 +187,7 @@ virDomainLxcEnterNamespace(virDomainPtr domain,
*
* Returns 0 on success, -1 on error
*
- * Since: v1.0.4
+ * Since: 1.0.4
*/
int
virDomainLxcEnterSecurityLabel(virSecurityModelPtr model,
@@ -290,7 +290,7 @@ virDomainLxcEnterSecurityLabel(virSecurityModelPtr model,
*
* Returns 0 on success, -1 on error
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int virDomainLxcEnterCGroup(virDomainPtr domain,
unsigned int flags)
diff --git a/src/libvirt-network.c b/src/libvirt-network.c
index 0d1524ce34..50c4108641 100644
--- a/src/libvirt-network.c
+++ b/src/libvirt-network.c
@@ -39,7 +39,7 @@ VIR_LOG_INIT("libvirt.network");
*
* Returns the virConnectPtr or NULL in case of failure.
*
- * Since: v0.3.0
+ * Since: 0.3.0
*/
virConnectPtr
virNetworkGetConnect(virNetworkPtr net)
@@ -89,7 +89,7 @@ virNetworkGetConnect(virNetworkPtr net)
* to make iteration easier. The caller is responsible for calling
* virNetworkFree() on each array element, then calling free() on @nets.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virConnectListAllNetworks(virConnectPtr conn,
@@ -130,7 +130,7 @@ virConnectListAllNetworks(virConnectPtr conn,
*
* Returns the number of network found or -1 in case of error
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virConnectNumOfNetworks(virConnectPtr conn)
@@ -174,7 +174,7 @@ virConnectNumOfNetworks(virConnectPtr conn)
* 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
+ * Since: 0.2.0
*/
int
virConnectListNetworks(virConnectPtr conn, char **const names, int maxnames)
@@ -211,7 +211,7 @@ virConnectListNetworks(virConnectPtr conn, char **const names, int maxnames)
*
* Returns the number of networks found or -1 in case of error
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virConnectNumOfDefinedNetworks(virConnectPtr conn)
@@ -255,7 +255,7 @@ virConnectNumOfDefinedNetworks(virConnectPtr conn)
* 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
+ * Since: 0.2.0
*/
int
virConnectListDefinedNetworks(virConnectPtr conn, char **const names,
@@ -298,7 +298,7 @@ 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
+ * Since: 0.2.0
*/
virNetworkPtr
virNetworkLookupByName(virConnectPtr conn, const char *name)
@@ -339,7 +339,7 @@ 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
+ * Since: 0.2.0
*/
virNetworkPtr
virNetworkLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
@@ -377,7 +377,7 @@ 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
+ * Since: 0.2.0
*/
virNetworkPtr
virNetworkLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
@@ -418,7 +418,7 @@ virNetworkLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
*
* Returns a new network object or NULL in case of failure
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
virNetworkPtr
virNetworkCreateXML(virConnectPtr conn, const char *xmlDesc)
@@ -461,7 +461,7 @@ virNetworkCreateXML(virConnectPtr conn, const char *xmlDesc)
*
* Returns a new network object or NULL in case of failure
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
virNetworkPtr
virNetworkCreateXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags)
@@ -503,7 +503,7 @@ virNetworkCreateXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int f
*
* Returns NULL in case of error, a pointer to the network otherwise
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
virNetworkPtr
virNetworkDefineXML(virConnectPtr conn, const char *xml)
@@ -546,7 +546,7 @@ virNetworkDefineXML(virConnectPtr conn, const char *xml)
*
* Returns NULL in case of error, a pointer to the network otherwise
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
virNetworkPtr
virNetworkDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags)
@@ -583,7 +583,7 @@ virNetworkDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virNetworkUndefine(virNetworkPtr network)
@@ -633,7 +633,7 @@ virNetworkUndefine(virNetworkPtr network)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virNetworkUpdate(virNetworkPtr network,
@@ -701,7 +701,7 @@ virNetworkUpdate(virNetworkPtr network,
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virNetworkCreate(virNetworkPtr network)
@@ -743,7 +743,7 @@ virNetworkCreate(virNetworkPtr network)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virNetworkDestroy(virNetworkPtr network)
@@ -783,7 +783,7 @@ virNetworkDestroy(virNetworkPtr network)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virNetworkFree(virNetworkPtr network)
@@ -816,7 +816,7 @@ virNetworkFree(virNetworkPtr network)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.0
+ * Since: 0.6.0
*/
int
virNetworkRef(virNetworkPtr network)
@@ -841,7 +841,7 @@ 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
+ * Since: 0.2.0
*/
const char *
virNetworkGetName(virNetworkPtr network)
@@ -865,7 +865,7 @@ virNetworkGetName(virNetworkPtr network)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virNetworkGetUUID(virNetworkPtr network, unsigned char *uuid)
@@ -897,7 +897,7 @@ virNetworkGetUUID(virNetworkPtr network, unsigned char *uuid)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.2.0
+ * Since: 0.2.0
*/
int
virNetworkGetUUIDString(virNetworkPtr network, char *buf)
@@ -934,7 +934,7 @@ 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
+ * Since: 0.2.0
*/
char *
virNetworkGetXMLDesc(virNetworkPtr network, unsigned int flags)
@@ -973,7 +973,7 @@ 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
+ * Since: 0.2.0
*/
char *
virNetworkGetBridgeName(virNetworkPtr network)
@@ -1013,7 +1013,7 @@ virNetworkGetBridgeName(virNetworkPtr network)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
int
virNetworkGetAutostart(virNetworkPtr network,
@@ -1055,7 +1055,7 @@ virNetworkGetAutostart(virNetworkPtr network,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.2.1
+ * Since: 0.2.1
*/
int
virNetworkSetAutostart(virNetworkPtr network,
@@ -1095,7 +1095,7 @@ virNetworkSetAutostart(virNetworkPtr network,
*
* Returns 1 if running, 0 if inactive, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virNetworkIsActive(virNetworkPtr net)
@@ -1130,7 +1130,7 @@ virNetworkIsActive(virNetworkPtr net)
*
* Returns 1 if persistent, 0 if transient, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virNetworkIsPersistent(virNetworkPtr net)
@@ -1191,7 +1191,7 @@ virNetworkIsPersistent(virNetworkPtr net)
*
* Returns a callback identifier on success, -1 on failure.
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
int
virConnectNetworkEventRegisterAny(virConnectPtr conn,
@@ -1254,7 +1254,7 @@ virConnectNetworkEventRegisterAny(virConnectPtr conn,
*
* Returns 0 on success, -1 on failure
*
- * Since: v1.2.1
+ * Since: 1.2.1
*/
int
virConnectNetworkEventDeregisterAny(virConnectPtr conn,
@@ -1357,7 +1357,7 @@ virConnectNetworkEventDeregisterAny(virConnectPtr conn,
* Returns the number of leases found or -1 and sets @leases to NULL in
* case of error.
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
int
virNetworkGetDHCPLeases(virNetworkPtr network,
@@ -1400,7 +1400,7 @@ virNetworkGetDHCPLeases(virNetworkPtr network,
*
* Frees all the memory occupied by @lease.
*
- * Since: v1.2.6
+ * Since: 1.2.6
*/
void
virNetworkDHCPLeaseFree(virNetworkDHCPLeasePtr lease)
@@ -1430,7 +1430,7 @@ 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
+ * Since: 5.5.0
*/
virNetworkPortPtr
virNetworkPortLookupByUUID(virNetworkPtr net,
@@ -1469,7 +1469,7 @@ 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
+ * Since: 5.5.0
*/
virNetworkPortPtr
virNetworkPortLookupByUUIDString(virNetworkPtr net,
@@ -1511,7 +1511,7 @@ virNetworkPortLookupByUUIDString(virNetworkPtr net,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortSetParameters(virNetworkPortPtr port,
@@ -1561,7 +1561,7 @@ virNetworkPortSetParameters(virNetworkPortPtr port,
*
* Returns -1 in case of error, 0 in case of success.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortGetParameters(virNetworkPortPtr port,
@@ -1607,7 +1607,7 @@ virNetworkPortGetParameters(virNetworkPortPtr port,
*
* Returns a new network port object or NULL in case of failure
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
virNetworkPortPtr
virNetworkPortCreateXML(virNetworkPtr net,
@@ -1647,7 +1647,7 @@ virNetworkPortCreateXML(virNetworkPtr net,
*
* Returns the virNetworkPtr or NULL in case of failure.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
virNetworkPtr
virNetworkPortGetNetwork(virNetworkPortPtr port)
@@ -1673,7 +1673,7 @@ 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
+ * Since: 5.5.0
*/
char *
virNetworkPortGetXMLDesc(virNetworkPortPtr port,
@@ -1712,7 +1712,7 @@ virNetworkPortGetXMLDesc(virNetworkPortPtr port,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortGetUUID(virNetworkPortPtr port,
@@ -1745,7 +1745,7 @@ virNetworkPortGetUUID(virNetworkPortPtr port,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortGetUUIDString(virNetworkPortPtr port,
@@ -1779,7 +1779,7 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortDelete(virNetworkPortPtr port,
@@ -1829,7 +1829,7 @@ virNetworkPortDelete(virNetworkPortPtr port,
* for calling virNetworkPortFree() on each array element, then calling
* free() on @ports.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkListAllPorts(virNetworkPtr network,
@@ -1868,7 +1868,7 @@ virNetworkListAllPorts(virNetworkPtr network,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortFree(virNetworkPortPtr port)
@@ -1901,7 +1901,7 @@ virNetworkPortFree(virNetworkPortPtr port)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v5.5.0
+ * Since: 5.5.0
*/
int
virNetworkPortRef(virNetworkPortPtr port)
diff --git a/src/libvirt-nodedev.c b/src/libvirt-nodedev.c
index 1caf3c8479..d5a24ea2ef 100644
--- a/src/libvirt-nodedev.c
+++ b/src/libvirt-nodedev.c
@@ -41,7 +41,7 @@ VIR_LOG_INIT("libvirt.nodedev");
*
* Returns the number of node devices or -1 in case of error
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virNodeNumOfDevices(virConnectPtr conn, const char *cap, unsigned int flags)
@@ -89,7 +89,7 @@ virNodeNumOfDevices(virConnectPtr conn, const char *cap, unsigned int flags)
* virNodeDeviceFree() on each array element, then calling free() on
* @devices.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virConnectListAllNodeDevices(virConnectPtr conn,
@@ -140,7 +140,7 @@ virConnectListAllNodeDevices(virConnectPtr conn,
*
* Returns the number of node devices found or -1 in case of error
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virNodeListDevices(virConnectPtr conn,
@@ -185,7 +185,7 @@ virNodeListDevices(virConnectPtr conn,
*
* Returns a virNodeDevicePtr if found, NULL otherwise.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
virNodeDevicePtr
virNodeDeviceLookupByName(virConnectPtr conn, const char *name)
@@ -227,7 +227,7 @@ virNodeDeviceLookupByName(virConnectPtr conn, const char *name)
*
* Returns a virNodeDevicePtr if found, NULL otherwise.
*
- * Since: v1.0.3
+ * Since: 1.0.3
*/
virNodeDevicePtr
virNodeDeviceLookupSCSIHostByWWN(virConnectPtr conn,
@@ -271,7 +271,7 @@ virNodeDeviceLookupSCSIHostByWWN(virConnectPtr conn,
*
* Returns the XML document, or NULL on error
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
char *
virNodeDeviceGetXMLDesc(virNodeDevicePtr dev, unsigned int flags)
@@ -306,7 +306,7 @@ virNodeDeviceGetXMLDesc(virNodeDevicePtr dev, unsigned int flags)
*
* Returns the device name or NULL in case of error
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
const char *
virNodeDeviceGetName(virNodeDevicePtr dev)
@@ -330,7 +330,7 @@ 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
+ * Since: 0.5.0
*/
const char *
virNodeDeviceGetParent(virNodeDevicePtr dev)
@@ -363,7 +363,7 @@ virNodeDeviceGetParent(virNodeDevicePtr dev)
* Returns the number of capabilities supported by the device or -1
* in case of error.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virNodeDeviceNumOfCaps(virNodeDevicePtr dev)
@@ -401,7 +401,7 @@ virNodeDeviceNumOfCaps(virNodeDevicePtr dev)
* Returns the number of capability names listed in @names or -1
* in case of error.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virNodeDeviceListCaps(virNodeDevicePtr dev,
@@ -442,7 +442,7 @@ virNodeDeviceListCaps(virNodeDevicePtr dev,
*
* Returns the 0 for success, -1 for error.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
int
virNodeDeviceFree(virNodeDevicePtr dev)
@@ -475,7 +475,7 @@ virNodeDeviceFree(virNodeDevicePtr dev)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.0
+ * Since: 0.6.0
*/
int
virNodeDeviceRef(virNodeDevicePtr dev)
@@ -515,7 +515,7 @@ virNodeDeviceRef(virNodeDevicePtr dev)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
int
virNodeDeviceDettach(virNodeDevicePtr dev)
@@ -570,7 +570,7 @@ virNodeDeviceDettach(virNodeDevicePtr dev)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v1.0.5
+ * Since: 1.0.5
*/
int
virNodeDeviceDetachFlags(virNodeDevicePtr dev,
@@ -617,7 +617,7 @@ virNodeDeviceDetachFlags(virNodeDevicePtr dev,
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
int
virNodeDeviceReAttach(virNodeDevicePtr dev)
@@ -662,7 +662,7 @@ virNodeDeviceReAttach(virNodeDevicePtr dev)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
int
virNodeDeviceReset(virNodeDevicePtr dev)
@@ -704,7 +704,7 @@ virNodeDeviceReset(virNodeDevicePtr dev)
*
* Returns a node device object if successful, NULL in case of failure
*
- * Since: v0.6.3
+ * Since: 0.6.3
*/
virNodeDevicePtr
virNodeDeviceCreateXML(virConnectPtr conn,
@@ -745,7 +745,7 @@ virNodeDeviceCreateXML(virConnectPtr conn,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.6.3
+ * Since: 0.6.3
*/
int
virNodeDeviceDestroy(virNodeDevicePtr dev)
@@ -787,7 +787,7 @@ virNodeDeviceDestroy(virNodeDevicePtr dev)
*
* Returns a node device object if successful, NULL in case of failure
*
- * Since: v7.3.0
+ * Since: 7.3.0
*/
virNodeDevicePtr
virNodeDeviceDefineXML(virConnectPtr conn,
@@ -828,7 +828,7 @@ virNodeDeviceDefineXML(virConnectPtr conn,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v7.3.0
+ * Since: 7.3.0
*/
int
virNodeDeviceUndefine(virNodeDevicePtr dev,
@@ -867,7 +867,7 @@ virNodeDeviceUndefine(virNodeDevicePtr dev,
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v7.3.0
+ * Since: 7.3.0
*/
int
virNodeDeviceCreate(virNodeDevicePtr dev,
@@ -932,7 +932,7 @@ virNodeDeviceCreate(virNodeDevicePtr dev,
*
* Returns a callback identifier on success, -1 on failure.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
int
virConnectNodeDeviceEventRegisterAny(virConnectPtr conn,
@@ -998,7 +998,7 @@ virConnectNodeDeviceEventRegisterAny(virConnectPtr conn,
*
* Returns 0 on success, -1 on failure.
*
- * Since: v2.2.0
+ * Since: 2.2.0
*/
int
virConnectNodeDeviceEventDeregisterAny(virConnectPtr conn,
@@ -1037,7 +1037,7 @@ virConnectNodeDeviceEventDeregisterAny(virConnectPtr conn,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
int
virNodeDeviceSetAutostart(virNodeDevicePtr dev,
@@ -1078,7 +1078,7 @@ virNodeDeviceSetAutostart(virNodeDevicePtr dev,
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
int
virNodeDeviceGetAutostart(virNodeDevicePtr dev,
@@ -1116,7 +1116,7 @@ virNodeDeviceGetAutostart(virNodeDevicePtr dev,
*
* Returns 1 if persistent, 0 if transient, -1 on error
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
int
virNodeDeviceIsPersistent(virNodeDevicePtr dev)
@@ -1151,7 +1151,7 @@ virNodeDeviceIsPersistent(virNodeDevicePtr dev)
*
* Returns 1 if active, 0 if inactive, -1 on error
*
- * Since: v7.8.0
+ * Since: 7.8.0
*/
int virNodeDeviceIsActive(virNodeDevicePtr dev)
{
diff --git a/src/libvirt-nwfilter.c b/src/libvirt-nwfilter.c
index bac50e89a3..b0b53cb132 100644
--- a/src/libvirt-nwfilter.c
+++ b/src/libvirt-nwfilter.c
@@ -36,7 +36,7 @@ VIR_LOG_INIT("libvirt.nwfilter");
*
* Returns the number of nwfilters found or -1 in case of error
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virConnectNumOfNWFilters(virConnectPtr conn)
@@ -80,7 +80,7 @@ virConnectNumOfNWFilters(virConnectPtr conn)
* to make iteration easier. The caller is responsible for calling
* virNWFilterFree() on each array element, then calling free() on @filters.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virConnectListAllNWFilters(virConnectPtr conn,
@@ -126,7 +126,7 @@ virConnectListAllNWFilters(virConnectPtr conn,
*
* Returns the number of network filters found or -1 in case of error
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virConnectListNWFilters(virConnectPtr conn, char **const names, int maxnames)
@@ -168,7 +168,7 @@ 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
+ * Since: 0.8.0
*/
virNWFilterPtr
virNWFilterLookupByName(virConnectPtr conn, const char *name)
@@ -209,7 +209,7 @@ 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
+ * Since: 0.8.0
*/
virNWFilterPtr
virNWFilterLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
@@ -250,7 +250,7 @@ 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
+ * Since: 0.8.0
*/
virNWFilterPtr
virNWFilterLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
@@ -287,7 +287,7 @@ virNWFilterLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virNWFilterFree(virNWFilterPtr nwfilter)
@@ -312,7 +312,7 @@ 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
+ * Since: 0.8.0
*/
const char *
virNWFilterGetName(virNWFilterPtr nwfilter)
@@ -336,7 +336,7 @@ virNWFilterGetName(virNWFilterPtr nwfilter)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virNWFilterGetUUID(virNWFilterPtr nwfilter, unsigned char *uuid)
@@ -368,7 +368,7 @@ virNWFilterGetUUID(virNWFilterPtr nwfilter, unsigned char *uuid)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virNWFilterGetUUIDString(virNWFilterPtr nwfilter, char *buf)
@@ -402,7 +402,7 @@ virNWFilterGetUUIDString(virNWFilterPtr nwfilter, char *buf)
*
* Returns a new nwfilter object or NULL in case of failure
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
virNWFilterPtr
virNWFilterDefineXML(virConnectPtr conn, const char *xmlDesc)
@@ -445,7 +445,7 @@ virNWFilterDefineXML(virConnectPtr conn, const char *xmlDesc)
*
* Returns a new nwfilter object or NULL in case of failure
*
- * Since: v7.7.0
+ * Since: 7.7.0
*/
virNWFilterPtr
virNWFilterDefineXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags)
@@ -484,7 +484,7 @@ virNWFilterDefineXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virNWFilterUndefine(virNWFilterPtr nwfilter)
@@ -526,7 +526,7 @@ 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
+ * Since: 0.8.0
*/
char *
virNWFilterGetXMLDesc(virNWFilterPtr nwfilter, unsigned int flags)
@@ -572,7 +572,7 @@ virNWFilterGetXMLDesc(virNWFilterPtr nwfilter, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virNWFilterRef(virNWFilterPtr nwfilter)
@@ -605,7 +605,7 @@ virNWFilterRef(virNWFilterPtr nwfilter)
* to make iteration easier. The caller is responsible for calling
* virNWFilterFree() on each array element, then calling free() on @filters.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int
virConnectListAllNWFilterBindings(virConnectPtr conn,
@@ -653,7 +653,7 @@ virConnectListAllNWFilterBindings(virConnectPtr conn,
* network filter cannot be found, then VIR_ERR_NO_NWFILTER_BINDING
* error is raised.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
virNWFilterBindingPtr
virNWFilterBindingLookupByPortDev(virConnectPtr conn, const char *portdev)
@@ -690,7 +690,7 @@ virNWFilterBindingLookupByPortDev(virConnectPtr conn, const char *portdev)
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int
virNWFilterBindingFree(virNWFilterBindingPtr binding)
@@ -715,7 +715,7 @@ 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
+ * Since: 4.5.0
*/
const char *
virNWFilterBindingGetPortDev(virNWFilterBindingPtr binding)
@@ -739,7 +739,7 @@ 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
+ * Since: 4.5.0
*/
const char *
virNWFilterBindingGetFilterName(virNWFilterBindingPtr binding)
@@ -775,7 +775,7 @@ virNWFilterBindingGetFilterName(virNWFilterBindingPtr binding)
*
* Returns a new binding object or NULL in case of failure
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
virNWFilterBindingPtr
virNWFilterBindingCreateXML(virConnectPtr conn, const char *xml, unsigned int flags)
@@ -818,7 +818,7 @@ virNWFilterBindingCreateXML(virConnectPtr conn, const char *xml, unsigned int fl
*
* Returns 0 in case of success and -1 in case of failure.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int
virNWFilterBindingDelete(virNWFilterBindingPtr binding)
@@ -860,7 +860,7 @@ 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
+ * Since: 4.5.0
*/
char *
virNWFilterBindingGetXMLDesc(virNWFilterBindingPtr binding, unsigned int flags)
@@ -906,7 +906,7 @@ virNWFilterBindingGetXMLDesc(virNWFilterBindingPtr binding, unsigned int flags)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int
virNWFilterBindingRef(virNWFilterBindingPtr binding)
diff --git a/src/libvirt-qemu.c b/src/libvirt-qemu.c
index d4ddbed059..3cd8c8f745 100644
--- a/src/libvirt-qemu.c
+++ b/src/libvirt-qemu.c
@@ -61,7 +61,7 @@ VIR_LOG_INIT("libvirt-qemu");
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v0.8.3
+ * Since: 0.8.3
*/
int
virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd,
@@ -133,7 +133,7 @@ virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd,
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v8.2.0
+ * Since: 8.2.0
*/
int
virDomainQemuMonitorCommandWithFiles(virDomainPtr domain,
@@ -220,7 +220,7 @@ virDomainQemuMonitorCommandWithFiles(virDomainPtr domain,
*
* Returns a new domain object on success, NULL otherwise
*
- * Since: v0.9.4
+ * Since: 0.9.4
*/
virDomainPtr
virDomainQemuAttach(virConnectPtr conn,
@@ -278,7 +278,7 @@ virDomainQemuAttach(virConnectPtr conn,
*
* Returns strings if success, NULL in failure.
*
- * Since: v0.10.0
+ * Since: 0.10.0
*/
char *
virDomainQemuAgentCommand(virDomainPtr domain,
@@ -358,7 +358,7 @@ virDomainQemuAgentCommand(virDomainPtr domain,
*
* Returns a callback identifier on success, -1 on failure
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
int
virConnectDomainQemuMonitorEventRegister(virConnectPtr conn,
@@ -414,7 +414,7 @@ virConnectDomainQemuMonitorEventRegister(virConnectPtr conn,
*
* Returns 0 on success, -1 on failure
*
- * Since: v1.2.3
+ * Since: 1.2.3
*/
int
virConnectDomainQemuMonitorEventDeregister(virConnectPtr conn,
diff --git a/src/libvirt-secret.c b/src/libvirt-secret.c
index ccf47a8f07..fa00570043 100644
--- a/src/libvirt-secret.c
+++ b/src/libvirt-secret.c
@@ -36,7 +36,7 @@ VIR_LOG_INIT("libvirt.secret");
*
* Returns the virConnectPtr or NULL in case of failure.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
virConnectPtr
virSecretGetConnect(virSecretPtr secret)
@@ -59,7 +59,7 @@ virSecretGetConnect(virSecretPtr secret)
*
* Returns the number currently defined secrets.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virConnectNumOfSecrets(virConnectPtr conn)
@@ -121,7 +121,7 @@ virConnectNumOfSecrets(virConnectPtr conn)
* to make iteration easier. The caller is responsible for calling
* virSecretFree() on each array element, then calling free() on @secrets.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virConnectListAllSecrets(virConnectPtr conn,
@@ -167,7 +167,7 @@ virConnectListAllSecrets(virConnectPtr conn,
*
* Returns the number of UUIDs provided in the array, or -1 on failure.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virConnectListSecrets(virConnectPtr conn, char **uuids, int maxuuids)
@@ -211,7 +211,7 @@ 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
+ * Since: 0.7.1
*/
virSecretPtr
virSecretLookupByUUID(virConnectPtr conn, const unsigned char *uuid)
@@ -254,7 +254,7 @@ 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
+ * Since: 0.7.1
*/
virSecretPtr
virSecretLookupByUUIDString(virConnectPtr conn, const char *uuidstr)
@@ -298,7 +298,7 @@ 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
+ * Since: 0.7.1
*/
virSecretPtr
virSecretLookupByUsage(virConnectPtr conn,
@@ -347,7 +347,7 @@ virSecretLookupByUsage(virConnectPtr conn,
*
* Returns a secret on success, NULL on failure.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
virSecretPtr
virSecretDefineXML(virConnectPtr conn, const char *xml, unsigned int flags)
@@ -387,7 +387,7 @@ 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
+ * Since: 0.7.1
*/
int
virSecretGetUUID(virSecretPtr secret, unsigned char *uuid)
@@ -419,7 +419,7 @@ virSecretGetUUID(virSecretPtr secret, unsigned char *uuid)
*
* Returns -1 in case of error, 0 in case of success
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virSecretGetUUIDString(virSecretPtr secret, char *buf)
@@ -453,7 +453,7 @@ virSecretGetUUIDString(virSecretPtr secret, char *buf)
* Returns a positive integer identifying the type of object,
* or -1 upon error.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virSecretGetUsageType(virSecretPtr secret)
@@ -484,7 +484,7 @@ virSecretGetUsageType(virSecretPtr secret)
* Returns a string identifying the object using the secret,
* or NULL upon error
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
const char *
virSecretGetUsageID(virSecretPtr secret)
@@ -509,7 +509,7 @@ virSecretGetUsageID(virSecretPtr secret)
* Returns the XML document on success, NULL on failure. The caller must
* free() the XML.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
char *
virSecretGetXMLDesc(virSecretPtr secret, unsigned int flags)
@@ -551,7 +551,7 @@ virSecretGetXMLDesc(virSecretPtr secret, unsigned int flags)
*
* Returns 0 on success, -1 on failure.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virSecretSetValue(virSecretPtr secret, const unsigned char *value,
@@ -598,7 +598,7 @@ 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
+ * Since: 0.7.1
*/
unsigned char *
virSecretGetValue(virSecretPtr secret, size_t *value_size, unsigned int flags)
@@ -641,7 +641,7 @@ virSecretGetValue(virSecretPtr secret, size_t *value_size, unsigned int flags)
*
* Returns 0 on success, -1 on failure.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virSecretUndefine(virSecretPtr secret)
@@ -690,7 +690,7 @@ virSecretUndefine(virSecretPtr secret)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virSecretRef(virSecretPtr secret)
@@ -714,7 +714,7 @@ virSecretRef(virSecretPtr secret)
*
* Returns 0 on success, or -1 on error
*
- * Since: v0.7.1
+ * Since: 0.7.1
*/
int
virSecretFree(virSecretPtr secret)
@@ -765,7 +765,7 @@ virSecretFree(virSecretPtr secret)
*
* Returns a callback identifier on success, -1 on failure.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virConnectSecretEventRegisterAny(virConnectPtr conn,
@@ -833,7 +833,7 @@ virConnectSecretEventRegisterAny(virConnectPtr conn,
*
* Returns 0 on success, -1 on failure.
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virConnectSecretEventDeregisterAny(virConnectPtr conn,
diff --git a/src/libvirt-storage.c b/src/libvirt-storage.c
index a31a18dbe9..84900340a7 100644
--- a/src/libvirt-storage.c
+++ b/src/libvirt-storage.c
@@ -38,7 +38,7 @@ VIR_LOG_INIT("libvirt.storage");
*
* Returns the virConnectPtr or NULL in case of failure.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virConnectPtr
virStoragePoolGetConnect(virStoragePoolPtr pool)
@@ -107,7 +107,7 @@ virStoragePoolGetConnect(virStoragePoolPtr pool)
* for calling virStoragePoolFree() on each array element, then calling
* free() on @pools.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virConnectListAllStoragePools(virConnectPtr conn,
@@ -148,7 +148,7 @@ virConnectListAllStoragePools(virConnectPtr conn,
*
* Returns the number of pools found, or -1 on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virConnectNumOfStoragePools(virConnectPtr conn)
@@ -194,7 +194,7 @@ virConnectNumOfStoragePools(virConnectPtr conn)
* 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
+ * Since: 0.4.1
*/
int
virConnectListStoragePools(virConnectPtr conn,
@@ -233,7 +233,7 @@ virConnectListStoragePools(virConnectPtr conn,
*
* Returns the number of pools found, or -1 on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virConnectNumOfDefinedStoragePools(virConnectPtr conn)
@@ -279,7 +279,7 @@ virConnectNumOfDefinedStoragePools(virConnectPtr conn)
* 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
+ * Since: 0.4.1
*/
int
virConnectListDefinedStoragePools(virConnectPtr conn,
@@ -331,7 +331,7 @@ virConnectListDefinedStoragePools(virConnectPtr conn,
* containing a source document appropriate to the given pool
* type for each discovered source.
*
- * Since: v0.4.5
+ * Since: 0.4.5
*/
char *
virConnectFindStoragePoolSources(virConnectPtr conn,
@@ -376,7 +376,7 @@ virConnectFindStoragePoolSources(virConnectPtr conn,
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByName(virConnectPtr conn,
@@ -417,7 +417,7 @@ virStoragePoolLookupByName(virConnectPtr conn,
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByUUID(virConnectPtr conn,
@@ -458,7 +458,7 @@ virStoragePoolLookupByUUID(virConnectPtr conn,
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByUUIDString(virConnectPtr conn,
@@ -498,7 +498,7 @@ virStoragePoolLookupByUUIDString(virConnectPtr conn,
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStoragePoolPtr
virStoragePoolLookupByVolume(virStorageVolPtr vol)
@@ -539,7 +539,7 @@ virStoragePoolLookupByVolume(virStorageVolPtr vol)
*
* Returns a virStoragePoolPtr object, or NULL if no matching pool is found
*
- * Since: v4.1.0
+ * Since: 4.1.0
*/
virStoragePoolPtr
virStoragePoolLookupByTargetPath(virConnectPtr conn,
@@ -582,7 +582,7 @@ virStoragePoolLookupByTargetPath(virConnectPtr conn,
*
* Returns a virStoragePoolPtr object, or NULL if creation failed
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStoragePoolPtr
virStoragePoolCreateXML(virConnectPtr conn,
@@ -627,7 +627,7 @@ virStoragePoolCreateXML(virConnectPtr conn,
*
* Returns a virStoragePoolPtr object, or NULL if creation failed
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStoragePoolPtr
virStoragePoolDefineXML(virConnectPtr conn,
@@ -670,7 +670,7 @@ virStoragePoolDefineXML(virConnectPtr conn,
*
* Returns 0 on success, or -1 upon failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolBuild(virStoragePoolPtr pool,
@@ -710,7 +710,7 @@ virStoragePoolBuild(virStoragePoolPtr pool,
*
* Returns 0 on success, -1 on failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolUndefine(virStoragePoolPtr pool)
@@ -750,7 +750,7 @@ virStoragePoolUndefine(virStoragePoolPtr pool)
*
* Returns 0 on success, or -1 if it could not be started
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolCreate(virStoragePoolPtr pool,
@@ -794,7 +794,7 @@ virStoragePoolCreate(virStoragePoolPtr pool,
*
* Returns 0 on success, or -1 if it could not be destroyed
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolDestroy(virStoragePoolPtr pool)
@@ -836,7 +836,7 @@ virStoragePoolDestroy(virStoragePoolPtr pool)
*
* Returns 0 on success, or -1 if it could not be obliterate
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolDelete(virStoragePoolPtr pool,
@@ -877,7 +877,7 @@ virStoragePoolDelete(virStoragePoolPtr pool,
*
* Returns 0 on success, or -1 if it could not be free'd.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolFree(virStoragePoolPtr pool)
@@ -911,7 +911,7 @@ virStoragePoolFree(virStoragePoolPtr pool)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.0
+ * Since: 0.6.0
*/
int
virStoragePoolRef(virStoragePoolPtr pool)
@@ -938,7 +938,7 @@ virStoragePoolRef(virStoragePoolPtr pool)
*
* Returns 0 if the volume list was refreshed, -1 on failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolRefresh(virStoragePoolPtr pool,
@@ -978,7 +978,7 @@ virStoragePoolRefresh(virStoragePoolPtr pool,
*
* Returns the name of the pool, or NULL on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
const char*
virStoragePoolGetName(virStoragePoolPtr pool)
@@ -1002,7 +1002,7 @@ virStoragePoolGetName(virStoragePoolPtr pool)
*
* Returns 0 on success, or -1 on error;
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolGetUUID(virStoragePoolPtr pool,
@@ -1034,7 +1034,7 @@ virStoragePoolGetUUID(virStoragePoolPtr pool,
*
* Returns 0 on success, or -1 on error;
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolGetUUIDString(virStoragePoolPtr pool,
@@ -1066,7 +1066,7 @@ virStoragePoolGetUUIDString(virStoragePoolPtr pool,
*
* Returns 0 on success, or -1 on failure.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolGetInfo(virStoragePoolPtr pool,
@@ -1112,7 +1112,7 @@ virStoragePoolGetInfo(virStoragePoolPtr pool,
*
* Returns a XML document (caller frees), or NULL on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
char *
virStoragePoolGetXMLDesc(virStoragePoolPtr pool,
@@ -1152,7 +1152,7 @@ virStoragePoolGetXMLDesc(virStoragePoolPtr pool,
*
* Returns 0 on success, -1 on failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolGetAutostart(virStoragePoolPtr pool,
@@ -1194,7 +1194,7 @@ virStoragePoolGetAutostart(virStoragePoolPtr pool,
*
* Returns 0 on success, -1 on failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolSetAutostart(virStoragePoolPtr pool,
@@ -1244,7 +1244,7 @@ virStoragePoolSetAutostart(virStoragePoolPtr pool,
* for calling virStorageVolFree() on each array element, then calling
* free() on @vols.
*
- * Since: v0.10.2
+ * Since: 0.10.2
*/
int
virStoragePoolListAllVolumes(virStoragePoolPtr pool,
@@ -1282,7 +1282,7 @@ virStoragePoolListAllVolumes(virStoragePoolPtr pool,
*
* Returns the number of storage pools, or -1 on failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolNumOfVolumes(virStoragePoolPtr pool)
@@ -1323,7 +1323,7 @@ virStoragePoolNumOfVolumes(virStoragePoolPtr pool)
*
* Returns the number of names fetched, or -1 on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStoragePoolListVolumes(virStoragePoolPtr pool,
@@ -1364,7 +1364,7 @@ virStoragePoolListVolumes(virStoragePoolPtr pool,
*
* Returns the virConnectPtr or NULL in case of failure.
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virConnectPtr
virStorageVolGetConnect(virStorageVolPtr vol)
@@ -1392,7 +1392,7 @@ virStorageVolGetConnect(virStorageVolPtr vol)
*
* Returns a storage volume, or NULL if not found / error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStorageVolPtr
virStorageVolLookupByName(virStoragePoolPtr pool,
@@ -1434,7 +1434,7 @@ virStorageVolLookupByName(virStoragePoolPtr pool,
*
* Returns a storage volume, or NULL if not found / error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStorageVolPtr
virStorageVolLookupByKey(virConnectPtr conn,
@@ -1476,7 +1476,7 @@ virStorageVolLookupByKey(virConnectPtr conn,
*
* Returns a storage volume, or NULL if not found / error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStorageVolPtr
virStorageVolLookupByPath(virConnectPtr conn,
@@ -1514,7 +1514,7 @@ virStorageVolLookupByPath(virConnectPtr conn,
*
* Returns the volume name, or NULL on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
const char*
virStorageVolGetName(virStorageVolPtr vol)
@@ -1539,7 +1539,7 @@ virStorageVolGetName(virStorageVolPtr vol)
*
* Returns the volume key, or NULL on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
const char*
virStorageVolGetKey(virStorageVolPtr vol)
@@ -1574,7 +1574,7 @@ virStorageVolGetKey(virStorageVolPtr vol)
*
* Returns the storage volume, or NULL on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
virStorageVolPtr
virStorageVolCreateXML(virStoragePoolPtr pool,
@@ -1627,7 +1627,7 @@ virStorageVolCreateXML(virStoragePoolPtr pool,
*
* Returns the storage volume, or NULL on error
*
- * Since: v0.6.4
+ * Since: 0.6.4
*/
virStorageVolPtr
virStorageVolCreateXMLFrom(virStoragePoolPtr pool,
@@ -1693,7 +1693,7 @@ virStorageVolCreateXMLFrom(virStoragePoolPtr pool,
*
* Returns 0, or -1 upon error.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int
virStorageVolDownload(virStorageVolPtr vol,
@@ -1778,7 +1778,7 @@ virStorageVolDownload(virStorageVolPtr vol,
*
* Returns 0, or -1 upon error.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int
virStorageVolUpload(virStorageVolPtr vol,
@@ -1833,7 +1833,7 @@ virStorageVolUpload(virStorageVolPtr vol,
*
* Returns 0 on success, or -1 on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStorageVolDelete(virStorageVolPtr vol,
@@ -1884,7 +1884,7 @@ virStorageVolDelete(virStorageVolPtr vol,
*
* Returns 0 on success, or -1 on error
*
- * Since: v0.8.0
+ * Since: 0.8.0
*/
int
virStorageVolWipe(virStorageVolPtr vol,
@@ -1932,7 +1932,7 @@ virStorageVolWipe(virStorageVolPtr vol,
*
* Returns 0 on success, or -1 on error.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virStorageVolWipePattern(virStorageVolPtr vol,
@@ -1974,7 +1974,7 @@ virStorageVolWipePattern(virStorageVolPtr vol,
*
* Returns 0 on success, or -1 on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStorageVolFree(virStorageVolPtr vol)
@@ -2007,7 +2007,7 @@ virStorageVolFree(virStorageVolPtr vol)
*
* Returns 0 in case of success, -1 in case of failure.
*
- * Since: v0.6.0
+ * Since: 0.6.0
*/
int
virStorageVolRef(virStorageVolPtr vol)
@@ -2033,7 +2033,7 @@ virStorageVolRef(virStorageVolPtr vol)
*
* Returns 0 on success, or -1 on failure
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
int
virStorageVolGetInfo(virStorageVolPtr vol,
@@ -2085,7 +2085,7 @@ virStorageVolGetInfo(virStorageVolPtr vol,
*
* Returns 0 on success, or -1 on failure
*
- * Since: v3.0.0
+ * Since: 3.0.0
*/
int
virStorageVolGetInfoFlags(virStorageVolPtr vol,
@@ -2131,7 +2131,7 @@ virStorageVolGetInfoFlags(virStorageVolPtr vol,
*
* Returns the XML document, or NULL on error
*
- * Since: v0.4.1
+ * Since: 0.4.1
*/
char *
virStorageVolGetXMLDesc(virStorageVolPtr vol,
@@ -2174,7 +2174,7 @@ 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
+ * Since: 0.4.1
*/
char *
virStorageVolGetPath(virStorageVolPtr vol)
@@ -2237,7 +2237,7 @@ virStorageVolGetPath(virStorageVolPtr vol)
*
* Returns 0 on success, or -1 on error.
*
- * Since: v0.9.10
+ * Since: 0.9.10
*/
int
virStorageVolResize(virStorageVolPtr vol,
@@ -2288,7 +2288,7 @@ virStorageVolResize(virStorageVolPtr vol,
*
* Returns 1 if running, 0 if inactive, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virStoragePoolIsActive(virStoragePoolPtr pool)
@@ -2323,7 +2323,7 @@ virStoragePoolIsActive(virStoragePoolPtr pool)
*
* Returns 1 if persistent, 0 if transient, -1 on error
*
- * Since: v0.7.3
+ * Since: 0.7.3
*/
int
virStoragePoolIsPersistent(virStoragePoolPtr pool)
@@ -2383,7 +2383,7 @@ virStoragePoolIsPersistent(virStoragePoolPtr pool)
*
* Returns a callback identifier on success, -1 on failure.
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virConnectStoragePoolEventRegisterAny(virConnectPtr conn,
@@ -2448,7 +2448,7 @@ virConnectStoragePoolEventRegisterAny(virConnectPtr conn,
*
* Returns 0 on success, -1 on failure
*
- * Since: v2.0.0
+ * Since: 2.0.0
*/
int
virConnectStoragePoolEventDeregisterAny(virConnectPtr conn,
@@ -2489,7 +2489,7 @@ virConnectStoragePoolEventDeregisterAny(virConnectPtr conn,
*
* Returns NULL in case of error or an XML string defining the capabilities.
*
- * Since: v5.2.0
+ * Since: 5.2.0
*/
char *
virConnectGetStoragePoolCapabilities(virConnectPtr conn,
diff --git a/src/libvirt-stream.c b/src/libvirt-stream.c
index 2bc9535eb1..12b6333692 100644
--- a/src/libvirt-stream.c
+++ b/src/libvirt-stream.c
@@ -53,7 +53,7 @@ VIR_LOG_INIT("libvirt.stream");
*
* Returns the new stream, or NULL upon error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
virStreamPtr
virStreamNew(virConnectPtr conn,
@@ -88,7 +88,7 @@ virStreamNew(virConnectPtr conn,
*
* Returns 0 in case of success, -1 in case of failure
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamRef(virStreamPtr stream)
@@ -168,7 +168,7 @@ virStreamRef(virStreamPtr stream)
* Returns -2 if the outgoing transmit buffers are full &
* the stream is marked as non-blocking.
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamSend(virStreamPtr stream,
@@ -265,7 +265,7 @@ 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
+ * Since: 0.7.2
*/
int
virStreamRecv(virStreamPtr stream,
@@ -354,7 +354,7 @@ virStreamRecv(virStreamPtr stream,
* Returns -3 if there is a hole in stream and caller requested
* to stop at a hole.
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
int
virStreamRecvFlags(virStreamPtr stream,
@@ -423,7 +423,7 @@ virStreamRecvFlags(virStreamPtr stream,
* Returns 0 on success,
* -1 error
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
int
virStreamSendHole(virStreamPtr stream,
@@ -468,7 +468,7 @@ virStreamSendHole(virStreamPtr stream,
* Returns 0 on success,
* -1 on error or when there's currently no hole in the stream
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
int
virStreamRecvHole(virStreamPtr stream,
@@ -592,7 +592,7 @@ virStreamInData(virStreamPtr stream,
* having been called, so the caller need only call
* virStreamFree().
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamSendAll(virStreamPtr stream,
@@ -723,7 +723,7 @@ virStreamSendAll(virStreamPtr stream,
* having been called, so the caller need only call
* virStreamFree().
*
- * Since: v3.4.0
+ * Since: 3.4.0
*/
int virStreamSparseSendAll(virStreamPtr stream,
virStreamSourceFunc handler,
@@ -864,7 +864,7 @@ int virStreamSparseSendAll(virStreamPtr stream,
* having been called, so the caller need only call
* virStreamFree()
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamRecvAll(virStreamPtr stream,
@@ -979,7 +979,7 @@ 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
+ * Since: 3.4.0
*/
int
virStreamSparseRecvAll(virStreamPtr stream,
@@ -1074,7 +1074,7 @@ virStreamSparseRecvAll(virStreamPtr stream,
*
* Returns 0 on success, -1 upon error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamEventAddCallback(virStreamPtr stream,
@@ -1119,7 +1119,7 @@ virStreamEventAddCallback(virStreamPtr stream,
*
* Returns 0 on success, -1 if no callback is registered
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamEventUpdateCallback(virStreamPtr stream,
@@ -1156,7 +1156,7 @@ virStreamEventUpdateCallback(virStreamPtr stream,
*
* Returns 0 on success, -1 on error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamEventRemoveCallback(virStreamPtr stream)
@@ -1202,7 +1202,7 @@ virStreamEventRemoveCallback(virStreamPtr stream)
*
* Returns 0 on success, -1 upon error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamFinish(virStreamPtr stream)
@@ -1246,7 +1246,7 @@ virStreamFinish(virStreamPtr stream)
*
* Returns 0 on success, -1 upon error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamAbort(virStreamPtr stream)
@@ -1292,7 +1292,7 @@ virStreamAbort(virStreamPtr stream)
*
* Returns 0 upon success, or -1 on error
*
- * Since: v0.7.2
+ * Since: 0.7.2
*/
int
virStreamFree(virStreamPtr stream)
diff --git a/src/libvirt.c b/src/libvirt.c
index ec685355b1..b78b49a632 100644
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -297,7 +297,7 @@ virGlobalInit(void)
*
* Returns 0 in case of success, -1 in case of error
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
int
virInitialize(void)
@@ -800,7 +800,7 @@ virStateStop(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
+ * Since: 0.0.3
*/
int
virGetVersion(unsigned long *libVer, const char *type G_GNUC_UNUSED,
@@ -1190,7 +1190,7 @@ virConnectOpenInternal(const char *name,
*
* Returns a pointer to the hypervisor connection or NULL in case of error
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
virConnectPtr
virConnectOpen(const char *name)
@@ -1225,7 +1225,7 @@ virConnectOpen(const char *name)
*
* Returns a pointer to the hypervisor connection or NULL in case of error
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
virConnectPtr
virConnectOpenReadOnly(const char *name)
@@ -1261,7 +1261,7 @@ virConnectOpenReadOnly(const char *name)
*
* Returns a pointer to the hypervisor connection or NULL in case of error
*
- * Since: v0.4.0
+ * Since: 0.4.0
*/
virConnectPtr
virConnectOpenAuth(const char *name,
@@ -1311,7 +1311,7 @@ virConnectOpenAuth(const char *name,
* connection, but the application should not try to further use a
* connection after the virConnectClose that matches the initial open.
*
- * Since: v0.0.3
+ * Since: 0.0.3
*/
int
virConnectClose(virConnectPtr conn)
diff --git a/src/util/virerror.c b/src/util/virerror.c
index ea320ebbf1..5c8b9ebeb5 100644
--- a/src/util/virerror.c
+++ b/src/util/virerror.c
@@ -255,7 +255,7 @@ virLastErrorObject(void)
*
* Returns a pointer to the last error or NULL if none occurred.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
virErrorPtr
virGetLastError(void)
@@ -274,7 +274,7 @@ virGetLastError(void)
*
* Returns the most recent error code, or VIR_ERR_OK if none is set.
*
- * Since: v4.5.0
+ * Since: 4.5.0
*/
int
virGetLastErrorCode(void)
@@ -294,7 +294,7 @@ 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
+ * Since: 4.5.0
*/
int
virGetLastErrorDomain(void)
@@ -314,7 +314,7 @@ virGetLastErrorDomain(void)
* Returns the most recent error message string in this
* thread, or a generic message if none is set
*
- * Since: v1.0.6
+ * Since: 1.0.6
*/
const char *
virGetLastErrorMessage(void)
@@ -370,7 +370,7 @@ virSetError(virErrorPtr newerr)
*
* Returns error code or -1 in case of parameter error.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
int
virCopyLastError(virErrorPtr to)
@@ -403,7 +403,7 @@ virCopyLastError(virErrorPtr to)
* It is the caller's responsibility to free the error with
* virFreeError().
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
virErrorPtr
virSaveLastError(void)
@@ -468,7 +468,7 @@ virErrorRestore(virErrorPtr *savederr)
*
* Reset the error being pointed to
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
void
virResetError(virErrorPtr err)
@@ -488,7 +488,7 @@ virResetError(virErrorPtr err)
*
* Resets and frees the given error.
*
- * Since: v0.6.1
+ * Since: 0.6.1
*/
void
virFreeError(virErrorPtr err)
@@ -506,7 +506,7 @@ virFreeError(virErrorPtr err)
* threads can safely access this concurrently, only resetting
* their own error object.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
void
virResetLastError(void)
@@ -538,7 +538,7 @@ virResetLastError(void)
*
* Returns a pointer to the last error or NULL if none occurred.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
virErrorPtr
virConnGetLastError(virConnectPtr conn)
@@ -574,7 +574,7 @@ 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
+ * Since: 0.1.0
*/
int
virConnCopyLastError(virConnectPtr conn, virErrorPtr to)
@@ -602,7 +602,7 @@ virConnCopyLastError(virConnectPtr conn, virErrorPtr to)
*
* Reset the last error caught on that connection
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
void
virConnResetLastError(virConnectPtr conn)
@@ -623,7 +623,7 @@ virConnResetLastError(virConnectPtr conn)
* 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
+ * Since: 0.1.0
*/
void
virSetErrorFunc(void *userData, virErrorFunc handler)
@@ -642,7 +642,7 @@ virSetErrorFunc(void *userData, virErrorFunc handler)
* it will reset to default which is to pass error back to the global
* library handler.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
void
virConnSetErrorFunc(virConnectPtr conn, void *userData,
@@ -662,7 +662,7 @@ virConnSetErrorFunc(virConnectPtr conn, void *userData,
*
* Default routine reporting an error to stderr.
*
- * Since: v0.1.0
+ * Since: 0.1.0
*/
void
virDefaultErrorFunc(virErrorPtr err)
diff --git a/src/util/virevent.c b/src/util/virevent.c
index 6add093216..e625183a7f 100644
--- a/src/util/virevent.c
+++ b/src/util/virevent.c
@@ -70,7 +70,7 @@ static virEventRemoveTimeoutFunc removeTimeoutImpl;
* 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
+ * Since: 0.9.3
*/
int
virEventAddHandle(int fd,
@@ -97,7 +97,7 @@ virEventAddHandle(int fd,
*
* Will not fail if fd exists.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
void
virEventUpdateHandle(int watch, int events)
@@ -117,7 +117,7 @@ virEventUpdateHandle(int watch, int events)
*
* Returns -1 if the file handle was not registered, 0 upon success.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virEventRemoveHandle(int watch)
@@ -146,7 +146,7 @@ virEventRemoveHandle(int watch)
* Returns -1 if the timer cannot be registered, a positive
* integer timer id upon success.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virEventAddTimeout(int timeout,
@@ -175,7 +175,7 @@ virEventAddTimeout(int timeout,
*
* Will not fail if timer exists.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
void
virEventUpdateTimeout(int timer, int timeout)
@@ -195,7 +195,7 @@ virEventUpdateTimeout(int timer, int timeout)
*
* Returns -1 if the timer was not registered, 0 upon success.
*
- * Since: v0.9.3
+ * Since: 0.9.3
*/
int
virEventRemoveTimeout(int timer)
@@ -245,7 +245,7 @@ virEventRemoveTimeout(int timer)
* to stop running the event loop immediately after closing
* the connection.
*
- * Since: v0.5.0
+ * Since: 0.5.0
*/
void virEventRegisterImpl(virEventAddHandleFunc addHandle,
virEventUpdateHandleFunc updateHandle,
@@ -315,7 +315,7 @@ int virEventRequireImpl(void)
*
* Returns 0 on success, -1 on failure.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int virEventRegisterDefaultImpl(void)
{
@@ -352,7 +352,7 @@ int virEventRegisterDefaultImpl(void)
*
* Returns 0 on success, -1 on failure.
*
- * Since: v0.9.0
+ * Since: 0.9.0
*/
int virEventRunDefaultImpl(void)
{
diff --git a/src/util/virtypedparam-public.c b/src/util/virtypedparam-public.c
index 1aea13149f..5bd207d1e6 100644
--- a/src/util/virtypedparam-public.c
+++ b/src/util/virtypedparam-public.c
@@ -128,7 +128,7 @@ virTypedParameterAssignFromStr(virTypedParameterPtr param,
* Returns pointer to the parameter or NULL if it does not exist in @params.
* This function does not raise an error, even when returning NULL.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
virTypedParameterPtr
virTypedParamsGet(virTypedParameterPtr params,
@@ -179,7 +179,7 @@ virTypedParamsGet(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetInt(virTypedParameterPtr params,
@@ -217,7 +217,7 @@ virTypedParamsGetInt(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetUInt(virTypedParameterPtr params,
@@ -255,7 +255,7 @@ virTypedParamsGetUInt(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetLLong(virTypedParameterPtr params,
@@ -293,7 +293,7 @@ virTypedParamsGetLLong(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetULLong(virTypedParameterPtr params,
@@ -331,7 +331,7 @@ virTypedParamsGetULLong(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetDouble(virTypedParameterPtr params,
@@ -369,7 +369,7 @@ virTypedParamsGetDouble(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetBoolean(virTypedParameterPtr params,
@@ -409,7 +409,7 @@ virTypedParamsGetBoolean(virTypedParameterPtr params,
* Returns 1 on success, 0 when the parameter does not exist in @params, or
* -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsGetString(virTypedParameterPtr params,
@@ -450,7 +450,7 @@ virTypedParamsGetString(virTypedParameterPtr params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddInt(virTypedParameterPtr *params,
@@ -498,7 +498,7 @@ virTypedParamsAddInt(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddUInt(virTypedParameterPtr *params,
@@ -546,7 +546,7 @@ virTypedParamsAddUInt(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddLLong(virTypedParameterPtr *params,
@@ -594,7 +594,7 @@ virTypedParamsAddLLong(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddULLong(virTypedParameterPtr *params,
@@ -642,7 +642,7 @@ virTypedParamsAddULLong(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddDouble(virTypedParameterPtr *params,
@@ -690,7 +690,7 @@ virTypedParamsAddDouble(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddBoolean(virTypedParameterPtr *params,
@@ -740,7 +740,7 @@ virTypedParamsAddBoolean(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddString(virTypedParameterPtr *params,
@@ -788,7 +788,7 @@ virTypedParamsAddString(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.2.17
+ * Since: 1.2.17
*/
int
virTypedParamsAddStringList(virTypedParameterPtr *params,
@@ -835,7 +835,7 @@ virTypedParamsAddStringList(virTypedParameterPtr *params,
*
* Returns 0 on success, -1 on error.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
int
virTypedParamsAddFromString(virTypedParameterPtr *params,
@@ -875,7 +875,7 @@ virTypedParamsAddFromString(virTypedParameterPtr *params,
*
* Returns nothing.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
void
virTypedParamsClear(virTypedParameterPtr params,
@@ -903,7 +903,7 @@ virTypedParamsClear(virTypedParameterPtr params,
*
* Returns nothing.
*
- * Since: v1.0.2
+ * Since: 1.0.2
*/
void
virTypedParamsFree(virTypedParameterPtr params,
--
2.35.1
More information about the libvir-list
mailing list