[PATCH v3 10/30] docstring: typedef: libvirt:: Add 'Since version' metadata

Either create or append to existing docstring, the version (git tag) that a given typedef was introduced in the format: Since: v1.2.3 Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain-checkpoint.h | 34 +- include/libvirt/libvirt-domain-snapshot.h | 40 +- include/libvirt/libvirt-domain.h | 734 ++++++++++++++++++-- include/libvirt/libvirt-event.h | 3 + include/libvirt/libvirt-host.h | 120 +++- include/libvirt/libvirt-interface.h | 25 +- include/libvirt/libvirt-network.h | 77 +- include/libvirt/libvirt-nodedev.h | 22 +- include/libvirt/libvirt-nwfilter.h | 25 +- include/libvirt/libvirt-secret.h | 36 +- include/libvirt/libvirt-storage.h | 133 +++- include/libvirt/libvirt-stream.h | 18 + include/libvirt/virterror.h | 19 + 13 files changed, 1212 insertions(+), 74 deletions(-) diff --git a/include/libvirt/libvirt-domain-checkpoint.h b/include/libvirt/libvirt-domain-checkpoint.h index a59578b857..5a53717175 100644 --- a/include/libvirt/libvirt-domain-checkpoint.h +++ b/include/libvirt/libvirt-domain-checkpoint.h @@ -34,6 +34,9 @@ * a domain. A checkpoint is useful for tracking which portions of the * 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 + * */ typedef struct _virDomainCheckpoint virDomainCheckpoint; @@ -43,6 +46,9 @@ typedef struct _virDomainCheckpoint virDomainCheckpoint; * A virDomainCheckpointPtr is pointer to a virDomainCheckpoint * private structure, and is the type used to reference a domain * checkpoint in the API. + * + * Since: v5.2.0 + * */ typedef virDomainCheckpoint *virDomainCheckpointPtr; @@ -50,6 +56,12 @@ const char *virDomainCheckpointGetName(virDomainCheckpointPtr checkpoint); virDomainPtr virDomainCheckpointGetDomain(virDomainCheckpointPtr checkpoint); virConnectPtr virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint); +/** + * virDomainCheckpointCreateFlags: + * + * Since: v5.6.0 + * + */ typedef enum { VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE = (1 << 0), /* Restore or alter metadata (Since: v5.6.0) */ @@ -65,7 +77,12 @@ typedef enum { virDomainCheckpointPtr virDomainCheckpointCreateXML(virDomainPtr domain, const char *xmlDesc, unsigned int flags); - +/** + * virDomainCheckpointXMLFlags: + * + * Since: v5.6.0 + * + */ typedef enum { VIR_DOMAIN_CHECKPOINT_XML_SECURE = (1 << 0), /* Include sensitive data (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_XML_NO_DOMAIN = (1 << 1), /* Suppress <domain> @@ -86,7 +103,11 @@ char *virDomainCheckpointGetXMLDesc(virDomainCheckpointPtr checkpoint, * flag (1<<0) depends on which function it is passed to; but serves * to toggle the per-call default of whether the listing is shallow or * recursive. Remaining bits come in groups; if all bits from a group - * are 0, then that group is not used to filter results. */ + * are 0, then that group is not used to filter results. + * + * Since: v5.6.0 + * + */ typedef enum { VIR_DOMAIN_CHECKPOINT_LIST_ROOTS = (1 << 0), /* Filter by checkpoints with no parents, when @@ -123,7 +144,14 @@ virDomainCheckpointPtr virDomainCheckpointLookupByName(virDomainPtr domain, virDomainCheckpointPtr virDomainCheckpointGetParent(virDomainCheckpointPtr checkpoint, unsigned int flags); -/* Delete a checkpoint */ +/** + * virDomainCheckpointDeleteFlags: + * + * Delete a checkpoint + * + * Since: v5.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) */ diff --git a/include/libvirt/libvirt-domain-snapshot.h b/include/libvirt/libvirt-domain-snapshot.h index 5dffabb764..cdf82b29ce 100644 --- a/include/libvirt/libvirt-domain-snapshot.h +++ b/include/libvirt/libvirt-domain-snapshot.h @@ -34,6 +34,9 @@ * a domain. A snapshot captures the state of the domain at a point in * time, with the intent that the guest can be reverted back to that * state at a later time. + * + * Since: v0.8.0 + * */ typedef struct _virDomainSnapshot virDomainSnapshot; @@ -42,6 +45,9 @@ 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 + * */ typedef virDomainSnapshot *virDomainSnapshotPtr; @@ -49,6 +55,12 @@ const char *virDomainSnapshotGetName(virDomainSnapshotPtr snapshot); virDomainPtr virDomainSnapshotGetDomain(virDomainSnapshotPtr snapshot); virConnectPtr virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot); +/** + * virDomainSnapshotCreateFlags: + * + * Since: v0.9.5 + * + */ typedef enum { VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE = (1 << 0), /* Restore or alter metadata (Since: v0.9.5) */ @@ -79,7 +91,12 @@ typedef enum { virDomainSnapshotPtr virDomainSnapshotCreateXML(virDomainPtr domain, const char *xmlDesc, unsigned int flags); - +/** + * virDomainSnapshotXMLFlags: + * + * Since: v5.1.0 + * + */ typedef enum { VIR_DOMAIN_SNAPSHOT_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: v5.1.0) */ } virDomainSnapshotXMLFlags; @@ -98,7 +115,11 @@ char *virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr snapshot, * of flag (1<<0) depends on which function it is passed to; but serves * to toggle the per-call default of whether the listing is shallow or * recursive. Remaining bits come in groups; if all bits from a group are - * 0, then that group is not used to filter results. */ + * 0, then that group is not used to filter results. + * + * Since: v0.9.5 + * + */ typedef enum { VIR_DOMAIN_SNAPSHOT_LIST_ROOTS = (1 << 0), /* Filter by snapshots with no parents, when @@ -194,6 +215,12 @@ int virDomainSnapshotIsCurrent(virDomainSnapshotPtr snapshot, int virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot, unsigned int flags); +/** + * virDomainSnapshotRevertFlags: + * + * Since: v0.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) */ @@ -208,7 +235,14 @@ typedef enum { int virDomainRevertToSnapshot(virDomainSnapshotPtr snapshot, unsigned int flags); -/* Delete a snapshot */ +/** + * virDomainSnapshotDeleteFlags: + * + * Delete a snapshot + * + * Since: v0.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) */ diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 01ea2a750f..5654a50c7e 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -32,6 +32,9 @@ * virDomain: * * a virDomain is a private structure representing a domain. + * + * Since: v0.0.1 + * */ typedef struct _virDomain virDomain; @@ -40,6 +43,9 @@ 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 + * */ typedef virDomain *virDomainPtr; @@ -47,6 +53,9 @@ typedef virDomain *virDomainPtr; * virDomainState: * * A domain may be in different states at a given point in time + * + * Since: v0.0.1 + * */ typedef enum { VIR_DOMAIN_NOSTATE = 0, /* no state (Since: v0.0.1) */ @@ -71,6 +80,12 @@ typedef enum { # endif } virDomainState; +/** + * virDomainNostateReason: + * + * Since: v0.9.2 + * + */ typedef enum { VIR_DOMAIN_NOSTATE_UNKNOWN = 0, /* (Since: v0.9.2) */ @@ -79,6 +94,12 @@ typedef enum { # endif } virDomainNostateReason; +/** + * virDomainRunningReason: + * + * Since: v0.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) */ @@ -98,6 +119,12 @@ typedef enum { # endif } virDomainRunningReason; +/** + * virDomainBlockedReason: + * + * Since: v0.9.2 + * + */ typedef enum { VIR_DOMAIN_BLOCKED_UNKNOWN = 0, /* the reason is unknown (Since: v0.9.2) */ @@ -106,6 +133,12 @@ typedef enum { # endif } virDomainBlockedReason; +/** + * virDomainPausedReason: + * + * Since: v0.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) */ @@ -127,6 +160,12 @@ typedef enum { # endif } virDomainPausedReason; +/** + * virDomainShutdownReason: + * + * Since: v0.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) */ @@ -136,6 +175,12 @@ typedef enum { # endif } virDomainShutdownReason; +/** + * virDomainShutoffReason: + * + * Since: v0.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) */ @@ -153,6 +198,12 @@ typedef enum { # endif } virDomainShutoffReason; +/** + * virDomainCrashedReason: + * + * Since: v0.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) */ @@ -162,6 +213,12 @@ typedef enum { # endif } virDomainCrashedReason; +/** + * virDomainPMSuspendedReason: + * + * Since: v0.9.11 + * + */ typedef enum { VIR_DOMAIN_PMSUSPENDED_UNKNOWN = 0, /* (Since: v0.9.11) */ @@ -170,6 +227,12 @@ typedef enum { # endif } virDomainPMSuspendedReason; +/** + * virDomainPMSuspendedDiskReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWN = 0, /* (Since: v1.0.0) */ @@ -182,6 +245,9 @@ typedef enum { * virDomainControlState: * * Current state of a control interface to the domain. + * + * Since: v0.9.3 + * */ typedef enum { VIR_DOMAIN_CONTROL_OK = 0, /* operational, ready to accept commands (Since: v0.9.3) */ @@ -202,6 +268,9 @@ typedef enum { * virDomainControlErrorReason: * * Reason for the error state. + * + * Since: v1.2.14 + * */ typedef enum { VIR_DOMAIN_CONTROL_ERROR_REASON_NONE = 0, /* server didn't provide a @@ -223,6 +292,9 @@ typedef enum { * * Structure filled in by virDomainGetControlInfo and providing details about * current state of control interface to a domain. + * + * Since: v0.9.3 + * */ typedef struct _virDomainControlInfo virDomainControlInfo; struct _virDomainControlInfo { @@ -238,6 +310,9 @@ struct _virDomainControlInfo { * virDomainControlInfoPtr: * * Pointer to virDomainControlInfo structure. + * + * Since: v0.9.3 + * */ typedef virDomainControlInfo *virDomainControlInfoPtr; @@ -258,6 +333,9 @@ typedef virDomainControlInfo *virDomainControlInfoPtr; * (whether or not it is running). * * These enums should not conflict with those of virTypedParameterFlags. + * + * Since: v0.9.2 + * */ typedef enum { VIR_DOMAIN_AFFECT_CURRENT = 0, /* Affect current domain state. (Since: v0.9.2) */ @@ -267,12 +345,14 @@ typedef enum { } virDomainModificationImpact; /** - * virDomainInfoPtr: + * virDomainInfo: * * a virDomainInfo is a structure filled by virDomainGetInfo() and extracting * runtime information for a given active Domain + * + * Since: v0.0.1 + * */ - typedef struct _virDomainInfo virDomainInfo; struct _virDomainInfo { @@ -287,6 +367,9 @@ struct _virDomainInfo { * virDomainInfoPtr: * * a virDomainInfoPtr is a pointer to a virDomainInfo structure. + * + * Since: v0.0.1 + * */ typedef virDomainInfo *virDomainInfoPtr; @@ -296,6 +379,9 @@ typedef virDomainInfo *virDomainInfoPtr; * * Flags OR'ed together to provide specific behaviour when creating a * Domain. + * + * Since: v0.0.1 + * */ typedef enum { VIR_DOMAIN_NONE = 0, /* Default behavior (Since: v0.0.1) */ @@ -489,7 +575,7 @@ int virDomainSetSchedulerParametersFlags (virDomainPtr domain, unsigned int flags); /** - * virDomainBlockStats: + * virDomainBlockStatsStruct: * * Block device stats for virDomainBlockStats. * @@ -497,6 +583,9 @@ int virDomainSetSchedulerParametersFlags (virDomainPtr domain, * that the hypervisor does not support that statistic. * * NB. Here 'long long' means 64 bit integer. + * + * Since: v0.3.3 + * */ typedef struct _virDomainBlockStats virDomainBlockStatsStruct; @@ -512,6 +601,9 @@ struct _virDomainBlockStats { * virDomainBlockStatsPtr: * * A pointer to a virDomainBlockStats structure + * + * Since: v0.3.2 + * */ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; @@ -626,7 +718,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; # define VIR_DOMAIN_BLOCK_STATS_ERRS "errs" /** - * virDomainInterfaceStats: + * virDomainInterfaceStatsStruct: * * Network interface stats for virDomainInterfaceStats. * @@ -634,6 +726,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * that the hypervisor does not support that statistic. * * NB. Here 'long long' means 64 bit integer. + * + * Since: v0.3.3 + * */ typedef struct _virDomainInterfaceStats virDomainInterfaceStatsStruct; @@ -652,11 +747,19 @@ struct _virDomainInterfaceStats { * virDomainInterfaceStatsPtr: * * A pointer to a virDomainInterfaceStats structure + * + * Since: v0.3.2 + * */ typedef virDomainInterfaceStatsStruct *virDomainInterfaceStatsPtr; /** + * virDomainMemoryStatTags: + * * Memory Statistics Tags: + * + * Since: v0.7.5 + * */ typedef enum { /* The total amount of data read from swap space (in kB). (Since: v0.7.5) */ @@ -774,6 +877,12 @@ typedef enum { # endif } virDomainMemoryStatTags; +/** + * virDomainMemoryStatStruct: + * + * Since: v0.7.5 + * + */ typedef struct _virDomainMemoryStat virDomainMemoryStatStruct; struct _virDomainMemoryStat { @@ -781,10 +890,23 @@ struct _virDomainMemoryStat { unsigned long long val; }; +/** + * virDomainMemoryStatPtr: + * + * Since: v0.7.5 + * + */ typedef virDomainMemoryStatStruct *virDomainMemoryStatPtr; -/* Domain core dump flags. */ +/** + * virDomainCoreDumpFlags: + * + * Domain core dump flags. + * + * Since: v0.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) */ @@ -797,6 +919,9 @@ typedef enum { * virDomainCoreDumpFormat: * * Values for specifying different formats of domain core dumps. + * + * Since: v1.2.3 + * */ typedef enum { VIR_DOMAIN_CORE_DUMP_FORMAT_RAW, /* dump guest memory in raw format (Since: v1.2.3) */ @@ -819,7 +944,14 @@ typedef enum { # endif } virDomainCoreDumpFormat; -/* Domain migration flags. */ +/** + * virDomainMigrateFlags: + * + * Domain migration flags. + * + * Since: v0.3.2 + * + */ typedef enum { /* Do not pause the domain during migration. The domain's memory will * be transferred to the destination host while the domain is running. @@ -1369,7 +1501,14 @@ int virDomainMigrateSetCompressionCache(virDomainPtr domain, unsigned long long cacheSize, unsigned int flags); -/* Domain migration speed flags. */ +/** + * virDomainMigrateMaxSpeedFlags: + * + * Domain migration speed flags. + * + * Since: v5.1.0 + * + */ typedef enum { /* Set or get maximum speed of post-copy migration. (Since: v5.1.0) */ VIR_DOMAIN_MIGRATE_MAX_SPEED_POSTCOPY = (1 << 0), @@ -1432,6 +1571,12 @@ virDomainPtr virDomainLookupByUUID (virConnectPtr conn, virDomainPtr virDomainLookupByUUIDString (virConnectPtr conn, const char *uuid); +/** + * virDomainShutdownFlagValues: + * + * Since: v0.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) */ @@ -1445,6 +1590,12 @@ int virDomainShutdown (virDomainPtr domain); int virDomainShutdownFlags (virDomainPtr domain, unsigned int flags); +/** + * virDomainRebootFlagValues: + * + * Since: v0.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) */ @@ -1466,6 +1617,9 @@ int virDomainDestroy (virDomainPtr domain); * * Flags used to provide specific behaviour to the * virDomainDestroyFlags() function + * + * Since: v0.9.4 + * */ typedef enum { VIR_DOMAIN_DESTROY_DEFAULT = 0, /* Default behavior - could lead to data loss!! (Since: v0.9.10) */ @@ -1495,9 +1649,13 @@ int virDomainPMWakeup (virDomainPtr domain, /** * virDomainSaveRestoreFlags: + * * Flags for use in virDomainSaveFlags(), virDomainManagedSave(), * virDomainRestoreFlags(), and virDomainSaveImageDefineXML(). Not all * flags apply to all these functions. + * + * Since: v0.9.4 + * */ typedef enum { VIR_DOMAIN_SAVE_BYPASS_CACHE = 1 << 0, /* Avoid file system cache pollution (Since: v0.9.4) */ @@ -1796,7 +1954,14 @@ int virDomainGetMemoryParameters(virDomainPtr domain, virTypedParameterPtr params, int *nparams, unsigned int flags); -/* Memory size modification flags. */ +/** + * virDomainMemoryModFlags: + * + * Memory size modification flags. + * + * Since: v1.0.0 + * + */ typedef enum { /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ VIR_DOMAIN_MEM_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, @@ -1814,6 +1979,9 @@ typedef enum { * virDomainNumatuneMemMode: * Representation of the various modes in the <numatune> element of * a domain. + * + * Since: v0.9.9 + * */ typedef enum { VIR_DOMAIN_NUMATUNE_MEM_STRICT = 0, /* (Since: v0.9.9) */ @@ -1879,7 +2047,12 @@ int virDomainSetMemoryStatsPeriod (virDomainPtr domain, int virDomainGetMaxVcpus (virDomainPtr domain); int virDomainGetSecurityLabel (virDomainPtr domain, virSecurityLabelPtr seclabel); - +/** + * virDomainGetHostnameFlags: + * + * Since: v6.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) */ @@ -1890,6 +2063,12 @@ char * virDomainGetHostname (virDomainPtr domain, int virDomainGetSecurityLabelList (virDomainPtr domain, virSecurityLabelPtr* seclabels); +/** + * virDomainMetadataType: + * + * Since: v0.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) */ @@ -1917,12 +2096,15 @@ virDomainGetMetadata(virDomainPtr domain, /* * XML domain description */ + /** * virDomainXMLFlags: * * Flags available for virDomainGetXMLDesc + * + * Since: v0.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) */ @@ -1930,6 +2112,12 @@ typedef enum { VIR_DOMAIN_XML_MIGRATABLE = (1 << 3), /* dump XML suitable for migration (Since: v1.0.0) */ } virDomainXMLFlags; +/** + * virDomainSaveImageXMLFlags: + * + * Since: v5.1.0 + * + */ typedef enum { VIR_DOMAIN_SAVE_IMAGE_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: v5.1.0) */ } virDomainSaveImageXMLFlags; @@ -2055,6 +2243,9 @@ int virDomainBlockPeek (virDomainPtr dom, * virDomainBlockResizeFlags: * * Flags available for virDomainBlockResize(). + * + * Since: v0.9.11 + * */ typedef enum { VIR_DOMAIN_BLOCK_RESIZE_BYTES = 1 << 0, /* size in bytes instead of KiB (Since: v0.9.11) */ @@ -2088,8 +2279,18 @@ int virDomainBlockResize (virDomainPtr dom, * * capacity: logical size from qcow2 header * * allocation: highest qcow extent written for an active domain * * physical: size of the block device container + * + * Since: v0.8.1 + * */ typedef struct _virDomainBlockInfo virDomainBlockInfo; + +/** + * virDomainBlockInfoPtr: + * + * Since: v0.8.1 + * + */ typedef virDomainBlockInfo *virDomainBlockInfoPtr; struct _virDomainBlockInfo { unsigned long long capacity; /* logical size in bytes of the @@ -2116,8 +2317,14 @@ int virDomainMemoryStats (virDomainPtr dom, unsigned int nr_stats, unsigned int flags); -/* Memory peeking flags. */ - +/** + * virDomainMemoryFlags: + * + * Memory peeking flags. + * + * Since: v0.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) */ @@ -2129,6 +2336,12 @@ int virDomainMemoryPeek (virDomainPtr dom, void *buffer, unsigned int flags); +/** + * virDomainDefineFlags: + * + * Since: v1.2.12 + * + */ typedef enum { VIR_DOMAIN_DEFINE_VALIDATE = (1 << 0), /* Validate the XML document against schema (Since: v1.2.12) */ } virDomainDefineFlags; @@ -2144,6 +2357,12 @@ virDomainPtr virDomainDefineXMLFlags (virConnectPtr conn, unsigned int flags); int virDomainUndefine (virDomainPtr domain); +/** + * virDomainUndefineFlagsValues: + * + * Since: v0.9.4 + * + */ typedef enum { VIR_DOMAIN_UNDEFINE_MANAGED_SAVE = (1 << 0), /* Also remove any managed save (Since: v0.9.4) */ @@ -2173,6 +2392,8 @@ int virConnectListDefinedDomains (virConnectPtr conn, * Flags used to tune which domains are listed by virConnectListAllDomains(). * 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 */ typedef enum { VIR_CONNECT_LIST_DOMAINS_ACTIVE = 1 << 0, /* (Since: v0.9.13) */ @@ -2217,9 +2438,13 @@ int virDomainSetAutostart (virDomainPtr domain, int autostart); /** - * virVcpuInfo: structure for information about a virtual CPU in a domain. + * virVcpuState: + * + * structure for information about a virtual CPU in a domain. + * + * Since: v0.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) */ @@ -2230,11 +2455,23 @@ typedef enum { # endif } virVcpuState; +/** + * virVcpuHostCpuState: + * + * Since: v6.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) */ } virVcpuHostCpuState; +/** + * virVcpuInfo: + * + * Since: v0.1.4 + * + */ typedef struct _virVcpuInfo virVcpuInfo; struct _virVcpuInfo { unsigned int number; /* virtual CPU number */ @@ -2242,9 +2479,23 @@ struct _virVcpuInfo { unsigned long long cpuTime; /* CPU time used, in nanoseconds */ int cpu; /* real CPU number, or one of the values from virVcpuHostCpuState */ }; + +/** + * virVcpuInfoPtr: + * + * Since: v0.1.4 + * + */ typedef virVcpuInfo *virVcpuInfoPtr; -/* Flags for controlling virtual CPU hot-plugging. */ +/** + * virDomainVcpuFlags: + * + * Flags for controlling virtual CPU hot-plugging. + * + * Since: v1.0.0 + * + */ typedef enum { /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ VIR_DOMAIN_VCPU_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, @@ -2292,11 +2543,22 @@ int virDomainGetEmulatorPinInfo (virDomainPtr domain, unsigned int flags); /** - * virIOThreadInfo: + * virDomainIOThreadInfo: * * The data structure for information about all IOThreads in a domain + * + * Since: v1.2.14 + * */ typedef struct _virDomainIOThreadInfo virDomainIOThreadInfo; + + +/** + * virDomainIOThreadInfoPtr: + * + * Since: v1.2.14 + * + */ typedef virDomainIOThreadInfo *virDomainIOThreadInfoPtr; struct _virDomainIOThreadInfo { unsigned int iothread_id; /* IOThread ID */ @@ -2493,6 +2755,12 @@ int virDomainGetVcpus (virDomainPtr domain, # define VIR_GET_CPUMAP(cpumaps, maplen, vcpu) (&((cpumaps)[(vcpu) * (maplen)])) +/** + * virDomainDeviceModifyFlags: + * + * Since: v1.0.0 + * + */ typedef enum { /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ VIR_DOMAIN_DEVICE_MODIFY_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, @@ -2517,7 +2785,20 @@ int virDomainUpdateDeviceFlags(virDomainPtr domain, int virDomainDetachDeviceAlias(virDomainPtr domain, const char *alias, unsigned int flags); +/** + * virDomainStatsRecord: + * + * Since: v1.2.8 + * + */ typedef struct _virDomainStatsRecord virDomainStatsRecord; + +/** + * virDomainStatsRecordPtr: + * + * Since: v1.2.8 + * + */ typedef virDomainStatsRecord *virDomainStatsRecordPtr; struct _virDomainStatsRecord { virDomainPtr dom; @@ -2525,6 +2806,12 @@ struct _virDomainStatsRecord { int nparams; }; +/** + * virDomainStatsTypes: + * + * Since: v1.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) */ @@ -2538,6 +2825,12 @@ typedef enum { VIR_DOMAIN_STATS_DIRTYRATE = (1 << 9), /* return domain dirty rate info (Since: v7.2.0) */ } virDomainStatsTypes; +/** + * virConnectGetAllDomainStatsFlags: + * + * Since: v1.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) */ @@ -2881,6 +3174,9 @@ int virDomainSetPerfEvents(virDomainPtr dom, * virDomainBlockJobType: * * Describes various possible block jobs. + * + * Since: v0.9.4 + * */ typedef enum { /* Placeholder (Since: v0.9.4) */ @@ -2931,6 +3227,9 @@ typedef enum { * VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC: Request only, do not wait for completion * VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT: Pivot to new file when ending a copy or * active commit job + * + * Since: v0.9.12 + * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC = 1 << 0, /* (Since: v0.9.12) */ @@ -2940,17 +3239,37 @@ typedef enum { int virDomainBlockJobAbort(virDomainPtr dom, const char *disk, unsigned int flags); -/* Flags for use with virDomainGetBlockJobInfo */ +/** + * virDomainBlockJobInfoFlags: + * + * Flags for use with virDomainGetBlockJobInfo + * + * Since: v1.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) */ } virDomainBlockJobInfoFlags; -/* An iterator for monitoring block job operations */ -typedef unsigned long long virDomainBlockJobCursor; - -typedef struct _virDomainBlockJobInfo virDomainBlockJobInfo; -struct _virDomainBlockJobInfo { +/** + * virDomainBlockJobCursor: + * + * An iterator for monitoring block job operations + * + * Since: v0.9.4 + * + */ +typedef unsigned long long virDomainBlockJobCursor; + +/** + * virDomainBlockJobInfo: + * + * Since: v0.9.4 + * + */ +typedef struct _virDomainBlockJobInfo virDomainBlockJobInfo; +struct _virDomainBlockJobInfo { int type; /* virDomainBlockJobType */ unsigned long bandwidth; /* either bytes/s or MiB/s, according to flags */ @@ -2963,13 +3282,27 @@ struct _virDomainBlockJobInfo { virDomainBlockJobCursor cur; virDomainBlockJobCursor end; }; + +/** + * virDomainBlockJobInfoPtr: + * + * Since: v0.9.4 + * + */ typedef virDomainBlockJobInfo *virDomainBlockJobInfoPtr; int virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk, virDomainBlockJobInfoPtr info, unsigned int flags); -/* Flags for use with virDomainBlockJobSetSpeed */ +/** + * virDomainBlockJobSetSpeedFlags: + * + * Flags for use with virDomainBlockJobSetSpeed + * + * Since: v1.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) */ @@ -2978,8 +3311,15 @@ typedef enum { int virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk, unsigned long bandwidth, unsigned int flags); -/* Flags for use with virDomainBlockPull (values chosen to be a subset - * of the flags for virDomainBlockRebase) */ +/** + * virDomainBlockPullFlags: + * + * Flags for use with virDomainBlockPull (values chosen to be a subset of the + * flags for virDomainBlockRebase) + * + * Since: v1.2.9 + * + */ typedef enum { VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTES = 1 << 6, /* bandwidth in bytes/s instead of MiB/s (Since: v1.2.9) */ @@ -2992,6 +3332,9 @@ int virDomainBlockPull(virDomainPtr dom, const char *disk, * virDomainBlockRebaseFlags: * * Flags available for virDomainBlockRebase(). + * + * Since: v0.9.12 + * */ typedef enum { VIR_DOMAIN_BLOCK_REBASE_SHALLOW = 1 << 0, /* Limit copy to top of source @@ -3017,6 +3360,9 @@ int virDomainBlockRebase(virDomainPtr dom, const char *disk, * virDomainBlockCopyFlags: * * Flags available for virDomainBlockCopy(). + * + * Since: v1.2.8 + * */ typedef enum { /* Limit copy to top of source backing chain (Since: v1.2.8) */ @@ -3094,6 +3440,9 @@ int virDomainBlockCopy(virDomainPtr dom, const char *disk, * virDomainBlockCommitFlags: * * Flags available for virDomainBlockCommit(). + * + * Since: v0.10.2 + * */ typedef enum { VIR_DOMAIN_BLOCK_COMMIT_SHALLOW = 1 << 0, /* NULL base means next backing @@ -3350,6 +3699,9 @@ virDomainGetBlockIoTune(virDomainPtr dom, * virDomainDiskErrorCode: * * Disk I/O error. + * + * Since: v0.9.10 + * */ typedef enum { VIR_DOMAIN_DISK_ERROR_NONE = 0, /* no error (Since: v0.9.10) */ @@ -3364,8 +3716,17 @@ typedef enum { /** * virDomainDiskError: * + * Since: v0.9.10 + * */ typedef struct _virDomainDiskError virDomainDiskError; + +/** + * virDomainDiskErrorPtr: + * + * Since: v0.9.10 + * + */ typedef virDomainDiskError *virDomainDiskErrorPtr; struct _virDomainDiskError { @@ -3384,6 +3745,9 @@ int virDomainGetDiskErrors(virDomainPtr dom, * virKeycodeSet: * * Enum to specify which keycode mapping is in use for virDomainSendKey(). + * + * Since: v0.9.3 + * */ typedef enum { VIR_KEYCODE_SET_LINUX = 0, /* (Since: v0.9.3) */ @@ -3436,7 +3800,9 @@ int virDomainSendKey(virDomainPtr domain, int nkeycodes, unsigned int flags); -/* +/** + * virDomainProcessSignal: + * * These just happen to match Linux signal numbers. The numbers * will be mapped to whatever the SIGNUM is in the guest OS in * question by the agent delivering the signal. The names are @@ -3445,6 +3811,9 @@ int virDomainSendKey(virDomainPtr domain, * Do not rely on all values matching Linux though. It is possible * this enum might be extended with new signals which have no * mapping in Linux. + * + * Since: v1.0.1 + * */ typedef enum { VIR_DOMAIN_PROCESS_SIGNAL_NOP = 0, /* No constant in POSIX/Linux (Since: v1.0.1) */ @@ -3545,6 +3914,9 @@ virDomainPtr virDomainCreateLinux (virConnectPtr conn, * virDomainEventType: * * a virDomainEventType is emitted during domain lifecycle events + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_DEFINED = 0, /* (Since: v0.5.0) */ @@ -3566,6 +3938,9 @@ typedef enum { * virDomainEventDefinedDetailType: * * Details on the cause of a 'defined' lifecycle event + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_DEFINED_ADDED = 0, /* Newly created config file (Since: v0.5.0) */ @@ -3582,6 +3957,9 @@ typedef enum { * virDomainEventUndefinedDetailType: * * Details on the cause of an 'undefined' lifecycle event + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = 0, /* Deleted the config file (Since: v0.5.0) */ @@ -3596,6 +3974,9 @@ typedef enum { * virDomainEventStartedDetailType: * * Details on the cause of a 'started' lifecycle event + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_STARTED_BOOTED = 0, /* Normal startup from boot (Since: v0.5.0) */ @@ -3613,6 +3994,9 @@ typedef enum { * virDomainEventSuspendedDetailType: * * Details on the cause of a 'suspended' lifecycle event + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_SUSPENDED_PAUSED = 0, /* Normal suspend due to admin pause (Since: v0.5.0) */ @@ -3634,6 +4018,9 @@ typedef enum { * virDomainEventResumedDetailType: * * Details on the cause of a 'resumed' lifecycle event + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_RESUMED_UNPAUSED = 0, /* Normal resume due to admin unpause (Since: v0.5.0) */ @@ -3651,6 +4038,9 @@ typedef enum { * virDomainEventStoppedDetailType: * * Details on the cause of a 'stopped' lifecycle event + * + * Since: v0.5.0 + * */ typedef enum { VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN = 0, /* Normal shutdown (Since: v0.5.0) */ @@ -3671,6 +4061,9 @@ typedef enum { * virDomainEventShutdownDetailType: * * Details on the cause of a 'shutdown' lifecycle event + * + * Since: v0.9.8 + * */ typedef enum { /* Guest finished shutdown sequence (Since: v0.9.8) */ @@ -3696,6 +4089,9 @@ typedef enum { * virDomainEventPMSuspendedDetailType: * * Details on the cause of a 'pmsuspended' lifecycle event + * + * Since: v0.10.2 + * */ typedef enum { VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY = 0, /* Guest was PM suspended to memory (Since: v0.10.2) */ @@ -3710,6 +4106,9 @@ typedef enum { * virDomainEventCrashedDetailType: * * Details on the cause of a 'crashed' lifecycle event + * + * Since: v1.1.1 + * */ typedef enum { VIR_DOMAIN_EVENT_CRASHED_PANICKED = 0, /* Guest was panicked (Since: v1.1.1) */ @@ -3724,6 +4123,9 @@ typedef enum { * virDomainMemoryFailureRecipientType: * * Recipient of a memory failure event. + * + * Since: v6.9.0 + * */ typedef enum { /* memory failure at hypersivor memory address space (Since: v6.9.0) */ @@ -3742,6 +4144,9 @@ typedef enum { * virDomainMemoryFailureActionType: * * Action of a memory failure event. + * + * Since: v6.9.0 + * */ typedef enum { /* the memory failure could be ignored. This will only be the case for @@ -3779,6 +4184,12 @@ typedef enum { } virDomainMemoryFailureActionType; +/** + * virDomainMemoryFailureFlags: + * + * Since: v6.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) */ @@ -3824,6 +4235,12 @@ int virDomainIsActive(virDomainPtr dom); int virDomainIsPersistent(virDomainPtr dom); int virDomainIsUpdated(virDomainPtr dom); +/** + * virDomainJobType: + * + * Since: v0.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) */ @@ -3837,7 +4254,20 @@ typedef enum { # endif } virDomainJobType; +/** + * virDomainJobInfo: + * + * Since: v0.7.7 + * + */ typedef struct _virDomainJobInfo virDomainJobInfo; + +/** + * virDomainJobInfoPtr: + * + * Since: v0.7.7 + * + */ typedef virDomainJobInfo *virDomainJobInfoPtr; struct _virDomainJobInfo { /* One of virDomainJobType */ @@ -3878,6 +4308,9 @@ struct _virDomainJobInfo { * * Flags OR'ed together to provide specific behavior when querying domain * job statistics. + * + * Since: v1.2.9 + * */ typedef enum { VIR_DOMAIN_JOB_STATS_COMPLETED = 1 << 0, /* return stats of a recently @@ -3895,6 +4328,12 @@ int virDomainGetJobStats(virDomainPtr domain, unsigned int flags); int virDomainAbortJob(virDomainPtr dom); +/** + * virDomainJobOperation: + * + * Since: v3.3.0 + * + */ typedef enum { VIR_DOMAIN_JOB_OPERATION_UNKNOWN = 0, /* (Since: v3.3.0) */ VIR_DOMAIN_JOB_OPERATION_START = 1, /* (Since: v3.3.0) */ @@ -4386,6 +4825,9 @@ typedef void (*virConnectDomainEventRTCChangeCallback)(virConnectPtr conn, * virDomainEventWatchdogAction: * * The action that is to be taken due to the watchdog device firing + * + * Since: v0.8.0 + * */ typedef enum { VIR_DOMAIN_EVENT_WATCHDOG_NONE = 0, /* No action, watchdog ignored (Since: v0.8.0) */ @@ -4421,6 +4863,9 @@ typedef void (*virConnectDomainEventWatchdogCallback)(virConnectPtr conn, * virDomainEventIOErrorAction: * * The action that is to be taken due to an IO error occurring + * + * Since: v0.8.0 + * */ typedef enum { VIR_DOMAIN_EVENT_IO_ERROR_NONE = 0, /* No action, IO error ignored (Since: v0.8.0) */ @@ -4484,6 +4929,9 @@ typedef void (*virConnectDomainEventIOErrorReasonCallback)(virConnectPtr conn, * virDomainEventGraphicsPhase: * * The phase of the graphics client connection + * + * Since: v0.8.0 + * */ typedef enum { VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = 0, /* Initial socket connection established (Since: v0.8.0) */ @@ -4499,6 +4947,9 @@ typedef enum { * virDomainEventGraphicsAddressType: * * The type of address for the connection + * + * Since: v0.8.0 + * */ typedef enum { VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address (Since: v0.8.0) */ @@ -4512,22 +4963,38 @@ typedef enum { /** - * virDomainEventGraphicsAddress: + * _virDomainEventGraphicsAddress: * * The data structure containing connection address details * + * Since: v1.0.0 + * */ struct _virDomainEventGraphicsAddress { int family; /* Address family, virDomainEventGraphicsAddressType */ char *node; /* Address of node (eg IP address, or UNIX path) */ char *service; /* Service name/number (eg TCP port, or NULL) */ }; + +/** + * virDomainEventGraphicsAddress: + * + * Since: v0.8.0 + * + */ typedef struct _virDomainEventGraphicsAddress virDomainEventGraphicsAddress; + +/** + * virDomainEventGraphicsAddressPtr: + * + * Since: v0.8.0 + * + */ typedef virDomainEventGraphicsAddress *virDomainEventGraphicsAddressPtr; /** - * virDomainEventGraphicsSubjectIdentity: + * _virDomainEventGraphicsSubjectIdentity: * * The data structure representing a single identity * @@ -4538,7 +5005,21 @@ struct _virDomainEventGraphicsSubjectIdentity { char *type; /* Type of identity */ char *name; /* Identity value */ }; + +/** + * virDomainEventGraphicsSubjectIdentity: + * + * Since: v0.8.0 + * + */ typedef struct _virDomainEventGraphicsSubjectIdentity virDomainEventGraphicsSubjectIdentity; + +/** + * virDomainEventGraphicsSubjectIdentityPtr: + * + * Since: v0.8.0 + * + */ typedef virDomainEventGraphicsSubjectIdentity *virDomainEventGraphicsSubjectIdentityPtr; @@ -4549,12 +5030,29 @@ 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 + * */ struct _virDomainEventGraphicsSubject { int nidentity; /* Number of identities in array*/ virDomainEventGraphicsSubjectIdentityPtr identities; /* Array of identities for subject */ }; + +/** + * virDomainEventGraphicsSubject: + * + * Since: v0.8.0 + * + */ typedef struct _virDomainEventGraphicsSubject virDomainEventGraphicsSubject; + +/** + * virDomainEventGraphicsSubjectPtr: + * + * Since: v0.8.0 + * + */ typedef virDomainEventGraphicsSubject *virDomainEventGraphicsSubjectPtr; @@ -4586,6 +5084,9 @@ typedef void (*virConnectDomainEventGraphicsCallback)(virConnectPtr conn, * * Tracks status of a virDomainBlockPull(), virDomainBlockRebase(), * virDomainBlockCopy(), or virDomainBlockCommit() operation + * + * Since: v0.9.4 + * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_COMPLETED = 0, /* (Since: v0.9.4) */ @@ -4633,6 +5134,9 @@ typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn, * virConnectDomainEventDiskChangeReason: * * The reason describing why this callback is called + * + * Since: v0.9.7 + * */ typedef enum { /* Removable media changed to empty according to startup policy as source @@ -4685,6 +5189,9 @@ typedef void (*virConnectDomainEventDiskChangeCallback)(virConnectPtr conn, * virDomainEventTrayChangeReason: * * The reason describing why the callback was called + * + * Since: v0.9.11 + * */ typedef enum { VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN = 0, /* (Since: v0.9.11) */ @@ -5302,6 +5809,12 @@ typedef void (*virConnectDomainEventTunableCallback)(virConnectPtr conn, void *opaque); +/** + * virConnectDomainEventAgentLifecycleState: + * + * Since: v1.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) */ @@ -5311,6 +5824,12 @@ typedef enum { # endif } virConnectDomainEventAgentLifecycleState; +/** + * virConnectDomainEventAgentLifecycleReason: + * + * Since: v1.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) */ @@ -5438,6 +5957,9 @@ typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPt * An enumeration of supported eventId parameters for * virConnectDomainEventRegisterAny(). Each event id determines which * signature of callback function will be used. + * + * Since: v0.8.0 + * */ typedef enum { VIR_DOMAIN_EVENT_ID_LIFECYCLE = 0, /* virConnectDomainEventCallback (Since: v0.8.0) */ @@ -5494,9 +6016,10 @@ int virConnectDomainEventDeregisterAny(virConnectPtr conn, /** - * virDomainConsoleFlags + * virDomainConsoleFlags: + * + * Since: v0.9.11 * - * Since 0.9.10 */ typedef enum { @@ -5513,9 +6036,9 @@ int virDomainOpenConsole(virDomainPtr dom, unsigned int flags); /** - * virDomainChannelFlags + * virDomainChannelFlags: * - * Since 1.0.2 + * Since: v1.0.2 */ typedef enum { VIR_DOMAIN_CHANNEL_FORCE = (1 << 0), /* abort a (possibly) active channel @@ -5528,6 +6051,12 @@ int virDomainOpenChannel(virDomainPtr dom, virStreamPtr st, unsigned int flags); +/** + * virDomainOpenGraphicsFlags: + * + * Since: v0.9.7 + * + */ typedef enum { VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH = (1 << 0), /* (Since: v0.9.7) */ } virDomainOpenGraphicsFlags; @@ -5563,9 +6092,20 @@ int virDomainFSThaw(virDomainPtr dom, * * The data structure containing mounted file systems within a guset * + * Since: v1.2.11 + * + * */ typedef struct _virDomainFSInfo virDomainFSInfo; + +/** + * virDomainFSInfoPtr: + * + * Since: v1.2.11 + * + */ typedef virDomainFSInfo *virDomainFSInfoPtr; + struct _virDomainFSInfo { char *mountpoint; /* path to mount point */ char *name; /* device name in the guest (e.g. "sda1") */ @@ -5584,7 +6124,12 @@ int virDomainGetTime(virDomainPtr dom, long long *seconds, unsigned int *nseconds, unsigned int flags); - +/** + * virDomainSetTimeFlags: + * + * Since: v1.2.5 + * + */ typedef enum { VIR_DOMAIN_TIME_SYNC = (1 << 0), /* Re-sync domain time from domain's RTC (Since: v1.2.5) */ } virDomainSetTimeFlags; @@ -5598,8 +6143,10 @@ int virDomainSetTime(virDomainPtr dom, * virSchedParameterType: * * A scheduler parameter field type. Provided for backwards - * compatibility; virTypedParameterType is the preferred enum since - * 0.9.2. + * compatibility; virTypedParameterType is the preferred enum + * + * Since: v0.2.3 + * */ typedef enum { VIR_DOMAIN_SCHED_FIELD_INT = VIR_TYPED_PARAM_INT, /* (Since: v0.2.3) */ @@ -5637,7 +6184,7 @@ typedef enum { * Provided for backwards compatibility; virTypedParameter is the * preferred alias. * - * Since: v0.9.2 + * Since: v0.2.3 * */ typedef struct _virTypedParameter virSchedParameter; @@ -5648,6 +6195,9 @@ typedef struct _virTypedParameter virSchedParameter; * a virSchedParameterPtr is a pointer to a virSchedParameter structure. * Provided for backwards compatibility; virTypedParameterPtr is the * preferred alias since 0.9.2. + * + * Since: v0.2.3 + * */ typedef virSchedParameter *virSchedParameterPtr; @@ -5655,8 +6205,10 @@ typedef virSchedParameter *virSchedParameterPtr; * virBlkioParameterType: * * A blkio parameter field type. Provided for backwards - * compatibility; virTypedParameterType is the preferred enum since - * 0.9.2. + * compatibility; virTypedParameterType is the preferred enum + * + * Since: v0.9.0 + * */ typedef enum { VIR_DOMAIN_BLKIO_PARAM_INT = VIR_TYPED_PARAM_INT, /* (Since: v0.9.0) */ @@ -5694,7 +6246,7 @@ typedef enum { * Provided for backwards compatibility; virTypedParameter is the * preferred alias. * - * Since: v0.9.2 + * Since: v0.9.0 * */ typedef struct _virTypedParameter virBlkioParameter; @@ -5704,7 +6256,10 @@ typedef struct _virTypedParameter virBlkioParameter; * * a virBlkioParameterPtr is a pointer to a virBlkioParameter structure. * Provided for backwards compatibility; virTypedParameterPtr is the - * preferred alias since 0.9.2. + * preferred alias. + * + * Since: v0.9.0 + * */ typedef virBlkioParameter *virBlkioParameterPtr; @@ -5712,8 +6267,10 @@ typedef virBlkioParameter *virBlkioParameterPtr; * virMemoryParameterType: * * A memory parameter field type. Provided for backwards - * compatibility; virTypedParameterType is the preferred enum since - * 0.9.2. + * compatibility; virTypedParameterType is the preferred enum + * + * Since: v0.8.5 + * */ typedef enum { VIR_DOMAIN_MEMORY_PARAM_INT = VIR_TYPED_PARAM_INT, /* (Since: v0.8.5) */ @@ -5751,7 +6308,7 @@ typedef enum { * Provided for backwards compatibility; virTypedParameter is the * preferred alias. * - * Since: v0.9.2 + * Since: v0.8.5 * */ typedef struct _virTypedParameter virMemoryParameter; @@ -5761,10 +6318,19 @@ typedef struct _virTypedParameter virMemoryParameter; * * a virMemoryParameterPtr is a pointer to a virMemoryParameter structure. * Provided for backwards compatibility; virTypedParameterPtr is the - * preferred alias since 0.9.2. + * preferred alias. + * + * Since: v0.8.5 + * */ typedef virMemoryParameter *virMemoryParameterPtr; +/** + * virDomainInterfaceAddressesSource: + * + * Since: v1.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) */ @@ -5775,7 +6341,20 @@ typedef enum { # endif } virDomainInterfaceAddressesSource; +/** + * virDomainIPAddress: + * + * Since: v1.2.14 + * + */ typedef struct _virDomainInterfaceIPAddress virDomainIPAddress; + +/** + * virDomainIPAddressPtr: + * + * Since: v1.2.14 + * + */ typedef virDomainIPAddress *virDomainIPAddressPtr; struct _virDomainInterfaceIPAddress { int type; /* virIPAddrType */ @@ -5783,7 +6362,20 @@ struct _virDomainInterfaceIPAddress { unsigned int prefix; /* IP address prefix */ }; +/** + * virDomainInterface: + * + * Since: v1.2.14 + * + */ typedef struct _virDomainInterface virDomainInterface; + +/** + * virDomainInterfacePtr: + * + * Since: v1.2.14 + * + */ typedef virDomainInterface *virDomainInterfacePtr; struct _virDomainInterface { char *name; /* interface name */ @@ -5799,6 +6391,12 @@ int virDomainInterfaceAddresses(virDomainPtr dom, void virDomainInterfaceFree(virDomainInterfacePtr iface); +/** + * virDomainSetUserPasswordFlags: + * + * Since: v1.2.16 + * + */ typedef enum { VIR_DOMAIN_PASSWORD_ENCRYPTED = 1 << 0, /* the password is already encrypted (Since: v1.2.16) */ } virDomainSetUserPasswordFlags; @@ -5832,6 +6430,12 @@ int virDomainSetBlockThreshold(virDomainPtr domain, unsigned long long threshold, unsigned int flags); +/** + * virDomainLifecycle: + * + * Since: v3.9.0 + * + */ typedef enum { VIR_DOMAIN_LIFECYCLE_POWEROFF = 0, /* (Since: v3.9.0) */ VIR_DOMAIN_LIFECYCLE_REBOOT = 1, /* (Since: v3.9.0) */ @@ -5842,6 +6446,12 @@ typedef enum { # endif } virDomainLifecycle; +/** + * virDomainLifecycleAction: + * + * Since: v3.9.0 + * + */ typedef enum { VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY = 0, /* (Since: v3.9.0) */ VIR_DOMAIN_LIFECYCLE_ACTION_RESTART = 1, /* (Since: v3.9.0) */ @@ -5969,6 +6579,12 @@ int virDomainSetLaunchSecurityState(virDomainPtr domain, int nparams, unsigned int flags); +/** + * virDomainGuestInfoTypes: + * + * Since: v5.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) */ @@ -5985,6 +6601,12 @@ int virDomainGetGuestInfo(virDomainPtr domain, int *nparams, unsigned int flags); +/** + * virDomainAgentResponseTimeoutValues: + * + * Since: v5.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) */ @@ -5995,6 +6617,12 @@ int virDomainAgentSetResponseTimeout(virDomainPtr domain, int timeout, unsigned int flags); +/** + * virDomainBackupBeginFlags: + * + * Since: v6.0.0 + * + */ typedef enum { VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNAL = (1 << 0), /* reuse separately provided images (Since: v6.0.0) */ @@ -6013,6 +6641,12 @@ int virDomainAuthorizedSSHKeysGet(virDomainPtr domain, char ***keys, unsigned int flags); +/** + * virDomainAuthorizedSSHKeysSetFlags: + * + * Since: v6.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) */ @@ -6025,6 +6659,12 @@ int virDomainAuthorizedSSHKeysSet(virDomainPtr domain, unsigned int nkeys, unsigned int flags); +/** + * virDomainMessageType: + * + * Since: v7.1.0 + * + */ typedef enum { VIR_DOMAIN_MESSAGE_DEPRECATION = (1 << 0), /* (Since: v7.1.0) */ VIR_DOMAIN_MESSAGE_TAINTING = (1 << 1), /* (Since: v7.1.0) */ @@ -6038,6 +6678,9 @@ int virDomainGetMessages(virDomainPtr domain, * virDomainDirtyRateStatus: * * Details on the cause of a dirty rate calculation status. + * + * Since: v7.2.0 + * */ typedef enum { VIR_DOMAIN_DIRTYRATE_UNSTARTED = 0, /* the dirtyrate calculation has @@ -6058,6 +6701,9 @@ typedef enum { * Flags OR'ed together to provide specific behaviour when calculating dirty page * rate for a Domain * + * + * Since: v8.1.0 + * */ typedef enum { VIR_DOMAIN_DIRTYRATE_MODE_PAGE_SAMPLING = 0, /* default mode - page-sampling (Since: v8.1.0) */ diff --git a/include/libvirt/libvirt-event.h b/include/libvirt/libvirt-event.h index f86a55ecf6..fe2234913f 100644 --- a/include/libvirt/libvirt-event.h +++ b/include/libvirt/libvirt-event.h @@ -34,6 +34,9 @@ * a virEventHandleType is used similar to POLLxxx FD events, but is specific * to libvirt. A client app must translate to, and from POLL events when using * this construct. + * + * Since: v0.5.0 + * */ typedef enum { VIR_EVENT_HANDLE_READABLE = (1 << 0), /* (Since: v0.5.0) */ diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index de08dcc118..1996ea87c9 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -33,6 +33,9 @@ * * a virConnect is a private structure representing a connection to * the Hypervisor. + * + * Since: v0.0.1 + * */ typedef struct _virConnect virConnect; @@ -41,6 +44,9 @@ 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 + * */ typedef virConnect *virConnectPtr; @@ -49,6 +55,9 @@ typedef virConnect *virConnectPtr; * * Flags to indicate which system-wide sleep state the host must be * transitioned to. + * + * Since: v0.9.8 + * */ typedef enum { VIR_NODE_SUSPEND_TARGET_MEM = 0, /* (Since: v0.9.8) */ @@ -64,6 +73,9 @@ typedef enum { * virStream: * * a virStream is a private structure representing a data stream. + * + * Since: v0.7.2 + * */ typedef struct _virStream virStream; @@ -72,6 +84,9 @@ 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 + * */ typedef virStream *virStreamPtr; @@ -92,6 +107,9 @@ typedef virStream *virStreamPtr; * a virSecurityLabel is a structure filled by virDomainGetSecurityLabel(), * providing the security label and associated attributes for the specified * domain. + * + * Since: v0.6.1 + * */ typedef struct _virSecurityLabel virSecurityLabel; @@ -104,6 +122,9 @@ struct _virSecurityLabel { * virSecurityLabelPtr: * * a virSecurityLabelPtr is a pointer to a virSecurityLabel. + * + * Since: v0.6.1 + * */ typedef virSecurityLabel *virSecurityLabelPtr; @@ -133,6 +154,9 @@ typedef virSecurityLabel *virSecurityLabelPtr; * a virSecurityModel is a structure filled by virNodeGetSecurityModel(), * providing the per-hypervisor security model and DOI attributes for the * specified domain. + * + * Since: v0.6.1 + * */ typedef struct _virSecurityModel virSecurityModel; @@ -145,6 +169,9 @@ struct _virSecurityModel { * virSecurityModelPtr: * * a virSecurityModelPtr is a pointer to a virSecurityModel. + * + * Since: v0.6.1 + * */ typedef virSecurityModel *virSecurityModelPtr; @@ -152,7 +179,7 @@ typedef virSecurityModel *virSecurityModelPtr; /* data types related to virNodePtr */ /** - * virNodeInfoPtr: + * virNodeInfo: * * a virNodeInfo is a structure filled by virNodeGetInfo() and providing * the information for the Node. @@ -160,8 +187,9 @@ typedef virSecurityModel *virSecurityModelPtr; * Note that the information in this struct is not guaranteed to be an * accurate relection of the system hardware. See the virNodeGetInfo() * API documentation for further guidance. + * + * Since: v0.1.0 */ - typedef struct _virNodeInfo virNodeInfo; struct _virNodeInfo { @@ -192,9 +220,12 @@ struct _virNodeInfo { # define VIR_NODE_CPU_STATS_FIELD_LENGTH 80 /** - * VIR_NODE_CPU_STATS_ALL_CPUS: + * virNodeGetCPUStatsAllCPUs: * * Value for specifying request for the total CPU time/utilization + * + * Since: v0.9.8 + * */ typedef enum { VIR_NODE_CPU_STATS_ALL_CPUS = -1, /* (Since: v0.9.3) */ @@ -272,6 +303,9 @@ typedef enum { * * a virNodeCPUStats is a structure filled by virNodeGetCPUStats() * providing information about the CPU stats of the node. + * + * Since: v0.9.3 + * */ typedef struct _virNodeCPUStats virNodeCPUStats; @@ -291,9 +325,12 @@ struct _virNodeCPUStats { # define VIR_NODE_MEMORY_STATS_FIELD_LENGTH 80 /** - * VIR_NODE_MEMORY_STATS_ALL_CELLS: + * virNodeGetMemoryStatsAllCells: * * Value for specifying request for the total memory of all cells. + * + * Since: v0.9.8 + * */ typedef enum { VIR_NODE_MEMORY_STATS_ALL_CELLS = -1, /* (Since: v0.9.3) */ @@ -349,6 +386,9 @@ typedef enum { * * a virNodeMemoryStats is a structure filled by virNodeGetMemoryStats() * providing information about the memory of the node. + * + * Since: v0.9.3 + * */ typedef struct _virNodeMemoryStats virNodeMemoryStats; @@ -487,6 +527,9 @@ int virNodeGetCPUMap(virConnectPtr conn, * virNodeInfoPtr: * * a virNodeInfoPtr is a pointer to a virNodeInfo structure. + * + * Since: v0.1.0 + * */ typedef virNodeInfo *virNodeInfoPtr; @@ -495,6 +538,9 @@ typedef virNodeInfo *virNodeInfoPtr; * virNodeCPUStatsPtr: * * a virNodeCPUStatsPtr is a pointer to a virNodeCPUStats structure. + * + * Since: v0.9.3 + * */ typedef virNodeCPUStats *virNodeCPUStatsPtr; @@ -503,6 +549,9 @@ typedef virNodeCPUStats *virNodeCPUStatsPtr; * virNodeMemoryStatsPtr: * * a virNodeMemoryStatsPtr is a pointer to a virNodeMemoryStats structure. + * + * Since: v0.9.3 + * */ typedef virNodeMemoryStats *virNodeMemoryStatsPtr; @@ -584,16 +633,24 @@ int virNodeGetSEVInfo (virConnectPtr conn, unsigned int flags); /** - * virConnectFlags + * virConnectFlags: * * Flags when opening a connection to a hypervisor + * + * Since: v0.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) */ } virConnectFlags; - +/** + * virConnectCredentialType: + * + * Since: v0.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) */ @@ -619,7 +676,20 @@ struct _virConnectCredential { unsigned int resultlen; /* Length of the result */ }; +/** + * virConnectCredential: + * + * Since: v0.4.1 + * + */ typedef struct _virConnectCredential virConnectCredential; + +/** + * virConnectCredentialPtr: + * + * Since: v0.4.1 + * + */ typedef virConnectCredential *virConnectCredentialPtr; @@ -648,8 +718,20 @@ struct _virConnectAuth { void *cbdata; }; - +/** + * virConnectAuth: + * + * Since: v0.4.1 + * + */ typedef struct _virConnectAuth virConnectAuth; + +/** + * virConnectAuthPtr: + * + * Since: v0.4.1 + * + */ typedef virConnectAuth *virConnectAuthPtr; /* @@ -892,6 +974,12 @@ int virConnectIsAlive(virConnectPtr conn); * CPU specification API */ +/** + * virCPUCompareResult: + * + * Since: v0.7.5 + * + */ typedef enum { VIR_CPU_COMPARE_ERROR = -1, /* (Since: v0.7.5) */ VIR_CPU_COMPARE_INCOMPATIBLE = 0, /* (Since: v0.7.5) */ @@ -903,6 +991,12 @@ typedef enum { # endif } virCPUCompareResult; +/** + * virConnectCompareCPUFlags: + * + * Since: v1.2.6 + * + */ typedef enum { VIR_CONNECT_COMPARE_CPU_FAIL_INCOMPATIBLE = (1 << 0), /* treat incompatible CPUs as failure (Since: v1.2.6) */ @@ -927,9 +1021,12 @@ int virConnectGetCPUModelNames(virConnectPtr conn, unsigned int flags); /** - * virConnectBaselineCPUFlags + * virConnectBaselineCPUFlags: * * Flags when getting XML description of a computed CPU + * + * Since: v1.1.2 + * */ typedef enum { VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES = (1 << 0), /* show all features (Since: v1.1.2) */ @@ -957,7 +1054,12 @@ int virNodeGetFreePages(virConnectPtr conn, unsigned int cellcount, unsigned long long *counts, unsigned int flags); - +/** + * virNodeAllocPagesFlags: + * + * Since: v1.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) */ diff --git a/include/libvirt/libvirt-interface.h b/include/libvirt/libvirt-interface.h index 64bcb08c94..b90bf67140 100644 --- a/include/libvirt/libvirt-interface.h +++ b/include/libvirt/libvirt-interface.h @@ -31,6 +31,9 @@ * virInterface: * * a virInterface is a private structure representing a virtual interface. + * + * Since: v0.6.4 + * */ typedef struct _virInterface virInterface; @@ -39,6 +42,9 @@ 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 + * */ typedef virInterface *virInterfacePtr; @@ -53,10 +59,13 @@ int virConnectNumOfDefinedInterfaces (virConnectPtr conn); int virConnectListDefinedInterfaces (virConnectPtr conn, char **const names, int maxnames); -/* - * virConnectListAllInterfaces: +/** + * virConnectListAllInterfacesFlags: * * Flags used to filter the returned interfaces. + * + * Since: v0.10.2 + * */ typedef enum { VIR_CONNECT_LIST_INTERFACES_INACTIVE = 1 << 0, /* (Since: v0.10.2) */ @@ -75,10 +84,22 @@ virInterfacePtr virInterfaceLookupByMACString (virConnectPtr conn, const char* virInterfaceGetName (virInterfacePtr iface); const char* virInterfaceGetMACString (virInterfacePtr iface); +/** + * virInterfaceXMLFlags: + * + * Since: v0.7.3 + * + */ typedef enum { VIR_INTERFACE_XML_INACTIVE = 1 << 0 /* dump inactive interface information (Since: v0.7.3) */ } virInterfaceXMLFlags; +/** + * virInterfaceDefineFlags: + * + * Since: v7.7.0 + * + */ typedef enum { VIR_INTERFACE_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virInterfaceDefineFlags; diff --git a/include/libvirt/libvirt-network.h b/include/libvirt/libvirt-network.h index 161c61de28..d735611437 100644 --- a/include/libvirt/libvirt-network.h +++ b/include/libvirt/libvirt-network.h @@ -27,6 +27,12 @@ # error "Don't include this file directly, only use libvirt/libvirt.h" # endif +/** + * virNetworkXMLFlags: + * + * Since: v0.9.10 + * + */ typedef enum { VIR_NETWORK_XML_INACTIVE = (1 << 0), /* dump inactive network information (Since: v0.9.10) */ } virNetworkXMLFlags; @@ -35,6 +41,9 @@ typedef enum { * virNetwork: * * a virNetwork is a private structure representing a virtual network. + * + * Since: v0.2.0 + * */ typedef struct _virNetwork virNetwork; @@ -43,6 +52,9 @@ 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 + * */ typedef virNetwork *virNetworkPtr; @@ -51,6 +63,9 @@ typedef virNetwork *virNetworkPtr; * * a virNetworkPort is a private structure representing a virtual network * port + * + * Since: v5.5.0 + * */ typedef struct _virNetworkPort virNetworkPort; @@ -59,6 +74,9 @@ 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 + * */ typedef virNetworkPort *virNetworkPortPtr; @@ -82,11 +100,14 @@ int virConnectNumOfDefinedNetworks (virConnectPtr conn); int virConnectListDefinedNetworks (virConnectPtr conn, char **const names, int maxnames); -/* - * virConnectListAllNetworks: +/** + * virConnectListAllNetworksFlags: * * Flags used to filter the returned networks. Flags in each group * are exclusive attributes of a network. + * + * Since: v0.10.2 + * */ typedef enum { VIR_CONNECT_LIST_NETWORKS_INACTIVE = 1 << 0, /* (Since: v0.10.2) */ @@ -112,7 +133,12 @@ virNetworkPtr virNetworkLookupByUUID (virConnectPtr conn, const unsigned char *uuid); virNetworkPtr virNetworkLookupByUUIDString (virConnectPtr conn, const char *uuid); - +/** + * virNetworkCreateFlags: + * + * Since: v7.8.0 + * + */ typedef enum { VIR_NETWORK_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.8.0) */ } virNetworkCreateFlags; @@ -125,7 +151,12 @@ virNetworkPtr virNetworkCreateXML (virConnectPtr conn, virNetworkPtr virNetworkCreateXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags); - +/** + * virNetworkDefineFlags: + * + * Since: v7.7.0 + * + */ typedef enum { VIR_NETWORK_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virNetworkDefineFlags; @@ -150,6 +181,8 @@ int virNetworkUndefine (virNetworkPtr network); * describes which type of update to perform on a <network> * definition. * + * Since: v0.10.2 + * */ typedef enum { VIR_NETWORK_UPDATE_COMMAND_NONE = 0, /* (invalid (Since: v0.10.2) */ @@ -168,6 +201,8 @@ typedef enum { * describes which section of a <network> definition the provided * xml should be applied to. * + * Since: v0.10.2 + * */ typedef enum { VIR_NETWORK_SECTION_NONE = 0, /* (invalid (Since: v0.10.2) */ @@ -192,6 +227,9 @@ typedef enum { * virNetworkUpdateFlags: * * Flags to control options for virNetworkUpdate() + * + * Since: v0.10.2 + * */ typedef enum { VIR_NETWORK_UPDATE_AFFECT_CURRENT = 0, /* affect live if network is active, @@ -246,6 +284,9 @@ int virNetworkIsPersistent(virNetworkPtr net); * virNetworkEventLifecycleType: * * a virNetworkEventLifecycleType is emitted during network lifecycle events + * + * Since: v1.2.1 + * */ typedef enum { VIR_NETWORK_EVENT_DEFINED = 0, /* (Since: v1.2.1) */ @@ -295,6 +336,9 @@ typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn, * An enumeration of supported eventId parameters for * virConnectNetworkEventRegisterAny(). Each event id determines which * signature of callback function will be used. + * + * Since: v1.2.1 + * */ typedef enum { VIR_NETWORK_EVENT_ID_LIFECYCLE = 0, /* virConnectNetworkEventLifecycleCallback (Since: v1.2.1) */ @@ -311,6 +355,12 @@ typedef enum { # endif } virNetworkEventID; +/** + * virIPAddrType: + * + * Since: v1.2.6 + * + */ typedef enum { VIR_IP_ADDR_TYPE_IPV4, /* (Since: v1.2.6) */ VIR_IP_ADDR_TYPE_IPV6, /* (Since: v1.2.6) */ @@ -320,7 +370,20 @@ typedef enum { # endif } virIPAddrType; +/** + * virNetworkDHCPLease: + * + * Since: v1.2.6 + * + */ typedef struct _virNetworkDHCPLease virNetworkDHCPLease; + +/** + * virNetworkDHCPLeasePtr: + * + * Since: v1.2.6 + * + */ typedef virNetworkDHCPLease *virNetworkDHCPLeasePtr; struct _virNetworkDHCPLease { char *iface; /* Network interface name */ @@ -377,6 +440,12 @@ virNetworkPortPtr virNetworkPortLookupByUUIDString(virNetworkPtr net, const char *uuidstr); +/** + * virNetworkPortCreateFlags: + * + * Since: v5.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) */ diff --git a/include/libvirt/libvirt-nodedev.h b/include/libvirt/libvirt-nodedev.h index 8fdded2f34..1bec57fca4 100644 --- a/include/libvirt/libvirt-nodedev.h +++ b/include/libvirt/libvirt-nodedev.h @@ -32,6 +32,9 @@ * virNodeDevice: * * A virNodeDevice contains a node (host) device details. + * + * Since: v0.5.0 + * */ typedef struct _virNodeDevice virNodeDevice; @@ -43,6 +46,9 @@ typedef struct _virNodeDevice virNodeDevice; * one via virNodeDeviceLookupByName, or virNodeDeviceCreate. Be sure * to call virNodeDeviceFree when done using a virNodeDevicePtr obtained * from any of the above functions to avoid leaking memory. + * + * Since: v0.5.0 + * */ typedef virNodeDevice *virNodeDevicePtr; @@ -57,11 +63,15 @@ int virNodeListDevices (virConnectPtr conn, char **const names, int maxnames, unsigned int flags); -/* - * virConnectListAllNodeDevices: +/** + * virConnectListAllNodeDeviceFlags: * * Flags used to filter either by capability or active state, the - * returned node devices. */ + * returned node devices. + * + * Since: v0.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) */ @@ -168,6 +178,9 @@ int virNodeDeviceIsActive(virNodeDevicePtr dev); * An enumeration of supported eventId parameters for * virConnectNodeDeviceEventRegisterAny(). Each event id determines which * signature of callback function will be used. + * + * Since: v2.2.0 + * */ typedef enum { VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE = 0, /* virConnectNodeDeviceEventLifecycleCallback (Since: v2.2.0) */ @@ -217,6 +230,9 @@ int virConnectNodeDeviceEventDeregisterAny(virConnectPtr conn, * * a virNodeDeviceEventLifecycleType is emitted during node device * lifecycle events + * + * Since: v2.2.0 + * */ typedef enum { VIR_NODE_DEVICE_EVENT_CREATED = 0, /* (Since: v2.2.0) */ diff --git a/include/libvirt/libvirt-nwfilter.h b/include/libvirt/libvirt-nwfilter.h index aa8872e156..18008426c2 100644 --- a/include/libvirt/libvirt-nwfilter.h +++ b/include/libvirt/libvirt-nwfilter.h @@ -31,6 +31,9 @@ * virNWFilter: * * a virNWFilter is a private structure representing a network filter + * + * Since: v0.8.0 + * */ typedef struct _virNWFilter virNWFilter; @@ -39,6 +42,9 @@ 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 + * */ typedef virNWFilter *virNWFilterPtr; @@ -47,6 +53,9 @@ typedef virNWFilter *virNWFilterPtr; * * a virNWFilterBinding is a private structure representing a network * filter binding to a port + * + * Since: v4.5.0 + * */ typedef struct _virNWFilterBinding virNWFilterBinding; @@ -56,6 +65,9 @@ typedef struct _virNWFilterBinding virNWFilterBinding; * a virNWFilterBindingPtr is pointer to a virNWFilterBinding private * structure, this is the type used to reference a network filter * port binding in the API. + * + * Since: v4.5.0 + * */ typedef virNWFilterBinding *virNWFilterBindingPtr; @@ -79,7 +91,12 @@ virNWFilterPtr virNWFilterLookupByUUID (virConnectPtr conn, const unsigned char *uuid); virNWFilterPtr virNWFilterLookupByUUIDString (virConnectPtr conn, const char *uuid); - +/** + * virNWFilterDefineFlags: + * + * Since: v7.7.0 + * + */ typedef enum { VIR_NWFILTER_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virNWFilterDefineFlags; @@ -108,6 +125,12 @@ int virNWFilterFree (virNWFilterPtr nwfilter); * NWFilter information */ +/** + * virNWFilterBindingCreateFlags: + * + * Since: v7.8.0 + * + */ typedef enum { VIR_NWFILTER_BINDING_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.8.0) */ } virNWFilterBindingCreateFlags; diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-secret.h index cee27155a3..92fd03f726 100644 --- a/include/libvirt/libvirt-secret.h +++ b/include/libvirt/libvirt-secret.h @@ -33,10 +33,26 @@ * * A virSecret stores a secret value (e.g. a passphrase or encryption key) * and associated metadata. + * + * Since: v0.7.1 + * */ typedef struct _virSecret virSecret; + +/** + * virSecretPtr: + * + * Since: v0.7.1 + * + */ typedef virSecret *virSecretPtr; +/** + * virSecretUsageType: + * + * Since: v0.7.1 + * + */ typedef enum { VIR_SECRET_USAGE_TYPE_NONE = 0, /* (Since: v0.7.1) */ VIR_SECRET_USAGE_TYPE_VOLUME = 1, /* (Since: v0.7.1) */ @@ -63,11 +79,14 @@ int virConnectListSecrets (virConnectPtr conn, char **uuids, int maxuuids); -/* - * virConnectListAllSecrets: +/** + * virConnectListAllSecretsFlags: * * Flags used to filter the returned secrets. Flags in each group * are exclusive attributes of a secret. + * + * Since: v0.10.2 + * */ typedef enum { VIR_CONNECT_LIST_SECRETS_EPHEMERAL = 1 << 0, /* kept in memory, never @@ -90,7 +109,12 @@ virSecretPtr virSecretLookupByUUIDString(virConnectPtr conn, virSecretPtr virSecretLookupByUsage(virConnectPtr conn, int usageType, const char *usageID); - +/** + * virSecretDefineFlags: + * + * Since: v7.7.0 + * + */ typedef enum { VIR_SECRET_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virSecretDefineFlags; @@ -134,6 +158,9 @@ int virSecretFree (virSecretPtr secret); * An enumeration of supported eventId parameters for * virConnectSecretEventRegisterAny(). Each event id determines which * signature of callback function will be used. + * + * Since: v3.0.0 + * */ typedef enum { VIR_SECRET_EVENT_ID_LIFECYCLE = 0, /* virConnectSecretEventLifecycleCallback (Since: v3.0.0) */ @@ -183,6 +210,9 @@ int virConnectSecretEventDeregisterAny(virConnectPtr conn, * * a virSecretEventLifecycleType is emitted during secret * lifecycle events + * + * Since: v3.0.0 + * */ typedef enum { VIR_SECRET_EVENT_DEFINED = 0, /* (Since: v3.0.0) */ diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h index 9bd437bf66..0b27d5d99f 100644 --- a/include/libvirt/libvirt-storage.h +++ b/include/libvirt/libvirt-storage.h @@ -32,6 +32,9 @@ * virStoragePool: * * a virStoragePool is a private structure representing a storage pool + * + * Since: v0.4.1 + * */ typedef struct _virStoragePool virStoragePool; @@ -40,10 +43,19 @@ 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 + * */ typedef virStoragePool *virStoragePoolPtr; +/** + * virStoragePoolState: + * + * Since: v0.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) */ @@ -56,6 +68,12 @@ typedef enum { # endif } virStoragePoolState; +/** + * virStoragePoolBuildFlags: + * + * Since: v0.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) */ @@ -64,11 +82,23 @@ typedef enum { VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data (Since: v0.9.5) */ } virStoragePoolBuildFlags; +/** + * virStoragePoolDeleteFlags: + * + * Since: v0.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) */ } virStoragePoolDeleteFlags; +/** + * virStoragePoolCreateFlags: + * + * Since: v1.3.1 + * + */ typedef enum { /* Create the pool but do not perform pool build (Since: v1.3.1) */ VIR_STORAGE_POOL_CREATE_NORMAL = 0, @@ -93,6 +123,12 @@ typedef enum { VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE = 1 << 2, } virStoragePoolCreateFlags; +/** + * virStoragePoolInfo: + * + * Since: v0.4.1 + * + */ typedef struct _virStoragePoolInfo virStoragePoolInfo; struct _virStoragePoolInfo { @@ -102,6 +138,12 @@ struct _virStoragePoolInfo { unsigned long long available; /* Remaining free space bytes */ }; +/** + * virStoragePoolInfoPtr: + * + * Since: v0.4.1 + * + */ typedef virStoragePoolInfo *virStoragePoolInfoPtr; @@ -109,6 +151,9 @@ typedef virStoragePoolInfo *virStoragePoolInfoPtr; * virStorageVol: * * a virStorageVol is a private structure representing a storage volume + * + * Since: v0.4.1 + * */ typedef struct _virStorageVol virStorageVol; @@ -117,10 +162,19 @@ 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 + * */ typedef virStorageVol *virStorageVolPtr; +/** + * virStorageVolType: + * + * Since: v0.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) */ @@ -135,12 +189,24 @@ typedef enum { # endif } virStorageVolType; +/** + * virStorageVolDeleteFlags: + * + * Since: v0.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) */ } virStorageVolDeleteFlags; +/** + * virStorageVolWipeAlgorithm: + * + * Since: v0.9.10 + * + */ typedef enum { VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes (Since: v0.9.10) */ VIR_STORAGE_VOL_WIPE_ALG_NNSA = 1, /* 4-pass NNSA Policy Letter @@ -175,6 +241,12 @@ typedef enum { # endif } virStorageVolWipeAlgorithm; +/** + * virStorageVolInfoFlags: + * + * Since: v3.0.0 + * + */ typedef enum { VIR_STORAGE_VOL_USE_ALLOCATION = 0, @@ -183,6 +255,12 @@ typedef enum { } virStorageVolInfoFlags; +/** + * virStorageVolInfo: + * + * Since: v0.4.1 + * + */ typedef struct _virStorageVolInfo virStorageVolInfo; struct _virStorageVolInfo { @@ -191,8 +269,21 @@ struct _virStorageVolInfo { unsigned long long allocation; /* Current allocation bytes */ }; + +/** + * virStorageVolInfoPtr: + * + * Since: v0.4.1 + * + */ typedef virStorageVolInfo *virStorageVolInfoPtr; +/** + * virStorageXMLFlags: + * + * Since: v0.9.13 + * + */ typedef enum { VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information (Since: v0.9.13) */ } virStorageXMLFlags; @@ -228,6 +319,9 @@ int virConnectListDefinedStoragePools(virConnectPtr conn, * Flags used to tune pools returned by virConnectListAllStoragePools(). * 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: v1.0.0 + * */ typedef enum { VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE = 1 << 0, @@ -279,7 +373,12 @@ virStoragePoolPtr virStoragePoolLookupByUUIDString(virConnectPtr conn, virStoragePoolPtr virStoragePoolLookupByVolume (virStorageVolPtr vol); virStoragePoolPtr virStoragePoolLookupByTargetPath(virConnectPtr conn, const char *path); - +/** + * virStoragePoolDefineFlags: + * + * Since: v7.7.0 + * + */ typedef enum { VIR_STORAGE_POOL_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virStoragePoolDefineFlags; @@ -353,6 +452,12 @@ virStorageVolPtr virStorageVolLookupByPath (virConnectPtr conn, const char* virStorageVolGetName (virStorageVolPtr vol); const char* virStorageVolGetKey (virStorageVolPtr vol); +/** + * virStorageVolCreateFlags: + * + * Since: v1.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) */ @@ -365,7 +470,12 @@ virStorageVolPtr virStorageVolCreateXMLFrom (virStoragePoolPtr pool, const char *xmldesc, virStorageVolPtr clonevol, unsigned int flags); - +/** + * virStorageVolDownloadFlags: + * + * Since: v3.4.0 + * + */ typedef enum { VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: v3.4.0) */ } virStorageVolDownloadFlags; @@ -375,6 +485,13 @@ int virStorageVolDownload (virStorageVolPtr vol, unsigned long long offset, unsigned long long length, unsigned int flags); + +/** + * virStorageVolUploadFlags: + * + * Since: v3.4.0 + * + */ typedef enum { VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: v3.4.0) */ } virStorageVolUploadFlags; @@ -404,6 +521,12 @@ char * virStorageVolGetXMLDesc (virStorageVolPtr pool, char * virStorageVolGetPath (virStorageVolPtr vol); +/** + * virStorageVolResizeFlags: + * + * Since: v0.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) */ @@ -434,6 +557,9 @@ int virStoragePoolIsPersistent(virStoragePoolPtr pool); * An enumeration of supported eventId parameters for * virConnectStoragePoolEventRegisterAny(). Each event id determines which * signature of callback function will be used. + * + * Since: v2.0.0 + * */ typedef enum { VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE = 0, /* virConnectStoragePoolEventLifecycleCallback (Since: v2.0.0) */ @@ -483,6 +609,9 @@ int virConnectStoragePoolEventDeregisterAny(virConnectPtr conn, * * a virStoragePoolEventLifecycleType is emitted during storage pool * lifecycle events + * + * Since: v2.0.0 + * */ typedef enum { VIR_STORAGE_POOL_EVENT_DEFINED = 0, /* (Since: v2.0.0) */ diff --git a/include/libvirt/libvirt-stream.h b/include/libvirt/libvirt-stream.h index d69131030b..caf6779cd6 100644 --- a/include/libvirt/libvirt-stream.h +++ b/include/libvirt/libvirt-stream.h @@ -28,6 +28,12 @@ # endif +/** + * virStreamFlags: + * + * Since: v0.7.2 + * + */ typedef enum { VIR_STREAM_NONBLOCK = (1 << 0), /* (Since: v0.7.2) */ } virStreamFlags; @@ -44,6 +50,12 @@ int virStreamRecv(virStreamPtr st, char *data, size_t nbytes); +/** + * virStreamRecvFlagsValues: + * + * Since: v3.4.0 + * + */ typedef enum { VIR_STREAM_RECV_STOP_AT_HOLE = (1 << 0), /* (Since: v3.4.0) */ } virStreamRecvFlagsValues; @@ -229,6 +241,12 @@ int virStreamSparseRecvAll(virStreamPtr stream, virStreamSinkHoleFunc holeHandler, void *opaque); +/** + * virStreamEventType: + * + * Since: v0.7.2 + * + */ typedef enum { VIR_STREAM_EVENT_READABLE = (1 << 0), /* (Since: v0.7.2) */ VIR_STREAM_EVENT_WRITABLE = (1 << 1), /* (Since: v0.7.2) */ diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h index 3c1b27a36f..6d15c12358 100644 --- a/include/libvirt/virterror.h +++ b/include/libvirt/virterror.h @@ -34,6 +34,9 @@ extern "C" { * virErrorLevel: * * Indicates the level of an error + * + * Since: v0.1.0 + * */ typedef enum { VIR_ERR_NONE = 0, /* (Since: v0.1.0) */ @@ -46,6 +49,9 @@ 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 + * */ typedef enum { VIR_FROM_NONE = 0, /* (Since: v0.1.0) */ @@ -152,9 +158,19 @@ typedef enum { * The conn, dom and net fields should be used with extreme care. * Reference counts are not incremented so the underlying objects * may be deleted without notice after the error has been delivered. + * + * Since: v0.1.0 + * */ typedef struct _virError virError; + +/** + * virErrorPtr: + * + * Since: v0.1.0 + * + */ typedef virError *virErrorPtr; struct _virError { int code; /* The error code, a virErrorNumber */ @@ -205,6 +221,9 @@ struct _virError { * break; * default: * } + * + * Since: v0.1.0 + * */ typedef enum { VIR_ERR_OK = 0, /* (Since: v0.1.0) */ -- 2.35.1