virConnectAuthPtrDefault is the only variable that we export and with the documentation being at the C file, it makes harder to find it. With this patch, the documentation of this variable can be found by those who look at the header file for guidance plus, it will also be included in the XML API, as the followup patch will fix apibuild.py to store what is documented in the header file for this variable. Note that the apibuild, does not do the same with .c files. It'd require adding it for (parsing) recursion, similar to what is done for functions. Considering the pros/cons, seems more reasonable to move the docstring to the header file instead. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-host.h | 13 +++++++++++++ src/libvirt.c | 11 +---------- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index 1dc4b8a147..8081d9e39d 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -562,6 +562,19 @@ struct _virConnectAuth { typedef struct _virConnectAuth virConnectAuth; typedef virConnectAuth *virConnectAuthPtr; +/* + * virConnectAuthPtrDefault: + * + * A default implementation of the authentication callbacks. This + * implementation is suitable for command line based tools. It will + * prompt for username, passwords, realm and one time keys as needed. + * It will print on STDOUT, and read from STDIN. If this is not + * suitable for the application's needs an alternative implementation + * should be provided. + * + * Since: v1.0.0 + * + */ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault; /** diff --git a/src/libvirt.c b/src/libvirt.c index 45315f484c..6cda75d1ca 100644 --- a/src/libvirt.c +++ b/src/libvirt.c @@ -197,16 +197,7 @@ static virConnectAuth virConnectAuthDefault = { NULL, }; -/* - * virConnectAuthPtrDefault - * - * A default implementation of the authentication callbacks. This - * implementation is suitable for command line based tools. It will - * prompt for username, passwords, realm and one time keys as needed. - * It will print on STDOUT, and read from STDIN. If this is not - * suitable for the application's needs an alternative implementation - * should be provided. - */ +/* Explanation in the header file */ virConnectAuthPtr virConnectAuthPtrDefault = &virConnectAuthDefault; static bool virGlobalError; -- 2.35.1

Minor hand adjustments around syntax, not the metadata per se. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain-checkpoint.h | 28 +- include/libvirt/libvirt-domain-snapshot.h | 60 +- include/libvirt/libvirt-domain.h | 877 +++++++++++--------- include/libvirt/libvirt-host.h | 36 +- include/libvirt/libvirt-interface.h | 4 +- include/libvirt/libvirt-network.h | 50 +- include/libvirt/libvirt-nodedev.h | 54 +- include/libvirt/libvirt-nwfilter.h | 4 +- include/libvirt/libvirt-secret.h | 10 +- include/libvirt/libvirt-storage.h | 96 ++- include/libvirt/virterror.h | 394 ++++----- 11 files changed, 877 insertions(+), 736 deletions(-) diff --git a/include/libvirt/libvirt-domain-checkpoint.h b/include/libvirt/libvirt-domain-checkpoint.h index a2f97531f8..a59578b857 100644 --- a/include/libvirt/libvirt-domain-checkpoint.h +++ b/include/libvirt/libvirt-domain-checkpoint.h @@ -52,13 +52,13 @@ virConnectPtr virDomainCheckpointGetConnect(virDomainCheckpointPtr checkpoint); typedef enum { VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE = (1 << 0), /* Restore or alter - metadata */ + metadata (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_CREATE_QUIESCE = (1 << 1), /* use guest agent to quiesce all mounted file systems within - the domain */ + the domain (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE_VALIDATE = (1 << 2), /* validate disk data state - when redefining a checkpoint */ + when redefining a checkpoint (Since: v6.10.0) */ } virDomainCheckpointCreateFlags; /* Create a checkpoint using the current VM state. */ @@ -67,11 +67,11 @@ virDomainCheckpointPtr virDomainCheckpointCreateXML(virDomainPtr domain, unsigned int flags); typedef enum { - VIR_DOMAIN_CHECKPOINT_XML_SECURE = (1 << 0), /* Include sensitive data */ + VIR_DOMAIN_CHECKPOINT_XML_SECURE = (1 << 0), /* Include sensitive data (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_XML_NO_DOMAIN = (1 << 1), /* Suppress <domain> - subelement */ + subelement (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_XML_SIZE = (1 << 2), /* Include dynamic - per-<disk> size */ + per-<disk> size (Since: v5.6.0) */ } virDomainCheckpointXMLFlags; /* Dump the XML of a checkpoint */ @@ -90,18 +90,18 @@ char *virDomainCheckpointGetXMLDesc(virDomainCheckpointPtr checkpoint, typedef enum { VIR_DOMAIN_CHECKPOINT_LIST_ROOTS = (1 << 0), /* Filter by checkpoints with no parents, when - listing a domain */ + listing a domain (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_LIST_DESCENDANTS = (1 << 0), /* List all descendants, not just children, when - listing a checkpoint */ + listing a checkpoint (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_LIST_TOPOLOGICAL = (1 << 1), /* Ensure parents occur before children in - the resulting list */ + the resulting list (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_LIST_LEAVES = (1 << 2), /* Filter by checkpoints - with no children */ + with no children (Since: v5.6.0) */ VIR_DOMAIN_CHECKPOINT_LIST_NO_LEAVES = (1 << 3), /* Filter by checkpoints - that have children */ + that have children (Since: v5.6.0) */ } virDomainCheckpointListFlags; /* Get all checkpoint objects for this domain */ @@ -125,9 +125,9 @@ virDomainCheckpointPtr virDomainCheckpointGetParent(virDomainCheckpointPtr check /* Delete a checkpoint */ typedef enum { - VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN = (1 << 0), /* Also delete children */ - VIR_DOMAIN_CHECKPOINT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata */ - VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children */ + 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) */ } virDomainCheckpointDeleteFlags; int virDomainCheckpointDelete(virDomainCheckpointPtr checkpoint, diff --git a/include/libvirt/libvirt-domain-snapshot.h b/include/libvirt/libvirt-domain-snapshot.h index d729d1a532..40f7a95441 100644 --- a/include/libvirt/libvirt-domain-snapshot.h +++ b/include/libvirt/libvirt-domain-snapshot.h @@ -51,28 +51,28 @@ virConnectPtr virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot); typedef enum { VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE = (1 << 0), /* Restore or alter - metadata */ + metadata (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_CURRENT = (1 << 1), /* With redefine, make - snapshot current */ + snapshot current (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_NO_METADATA = (1 << 2), /* Make snapshot without - remembering it */ + remembering it (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_HALT = (1 << 3), /* Stop running guest - after snapshot */ + after snapshot (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_DISK_ONLY = (1 << 4), /* disk snapshot, not - full system */ + full system (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_REUSE_EXT = (1 << 5), /* reuse any existing - external files */ + external files (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_QUIESCE = (1 << 6), /* use guest agent to quiesce all mounted file systems within - the domain */ + the domain (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_ATOMIC = (1 << 7), /* atomically avoid - partial changes */ + partial changes (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_CREATE_LIVE = (1 << 8), /* create the snapshot while the guest is - running */ + running (Since: v1.0.1) */ VIR_DOMAIN_SNAPSHOT_CREATE_VALIDATE = (1 << 9), /* validate the XML - against the schema */ + against the schema (Since: v5.6.0) */ } virDomainSnapshotCreateFlags; /* Take a snapshot of the current VM state */ @@ -81,7 +81,7 @@ virDomainSnapshotPtr virDomainSnapshotCreateXML(virDomainPtr domain, unsigned int flags); typedef enum { - VIR_DOMAIN_SNAPSHOT_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too */ + VIR_DOMAIN_SNAPSHOT_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: v5.1.0) */ } virDomainSnapshotXMLFlags; /* Dump the XML of a snapshot */ @@ -102,45 +102,45 @@ char *virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr snapshot, typedef enum { VIR_DOMAIN_SNAPSHOT_LIST_ROOTS = (1 << 0), /* Filter by snapshots with no parents, when - listing a domain */ + listing a domain (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_LIST_DESCENDANTS = (1 << 0), /* List all descendants, not just children, when listing a snapshot */ - /* For historical reasons, groups do not use contiguous bits. */ + /* For historical reasons, groups do not use contiguous bits. (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_LIST_LEAVES = (1 << 2), /* Filter by snapshots - with no children */ + with no children (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_LIST_NO_LEAVES = (1 << 3), /* Filter by snapshots - that have children */ + that have children (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_LIST_METADATA = (1 << 1), /* Filter by snapshots - which have metadata */ + which have metadata (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_LIST_NO_METADATA = (1 << 4), /* Filter by snapshots - with no metadata */ + with no metadata (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_LIST_INACTIVE = (1 << 5), /* Filter by snapshots taken while guest was - shut off */ + shut off (Since: v1.0.1) */ VIR_DOMAIN_SNAPSHOT_LIST_ACTIVE = (1 << 6), /* Filter by snapshots taken while guest was active, and with - memory state */ + memory state (Since: v1.0.1) */ VIR_DOMAIN_SNAPSHOT_LIST_DISK_ONLY = (1 << 7), /* Filter by snapshots taken while guest was active, but without - memory state */ + memory state (Since: v1.0.1) */ VIR_DOMAIN_SNAPSHOT_LIST_INTERNAL = (1 << 8), /* Filter by snapshots stored internal to - disk images */ + disk images (Since: v1.0.1) */ VIR_DOMAIN_SNAPSHOT_LIST_EXTERNAL = (1 << 9), /* Filter by snapshots that use files external - to disk images */ + to disk images (Since: v1.0.1) */ VIR_DOMAIN_SNAPSHOT_LIST_TOPOLOGICAL = (1 << 10), /* Ensure parents occur before children in - the resulting list */ + the resulting list (Since: v5.2.0) */ } virDomainSnapshotListFlags; /* Return the number of snapshots for this domain */ @@ -195,10 +195,10 @@ int virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot, unsigned int flags); typedef enum { - VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING = 1 << 0, /* Run after revert */ - VIR_DOMAIN_SNAPSHOT_REVERT_PAUSED = 1 << 1, /* Pause after revert */ - VIR_DOMAIN_SNAPSHOT_REVERT_FORCE = 1 << 2, /* Allow risky reverts */ - VIR_DOMAIN_SNAPSHOT_REVERT_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template */ + VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING = 1 << 0, /* Run after revert (Since: v1.0.0) */ + VIR_DOMAIN_SNAPSHOT_REVERT_PAUSED = 1 << 1, /* Pause after revert (Since: v1.0.0) */ + VIR_DOMAIN_SNAPSHOT_REVERT_FORCE = 1 << 2, /* Allow risky reverts (Since: v1.0.0) */ + VIR_DOMAIN_SNAPSHOT_REVERT_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template (Since: v8.1.0) */ } virDomainSnapshotRevertFlags; /* Revert the domain to a point-in-time snapshot. The @@ -210,9 +210,9 @@ int virDomainRevertToSnapshot(virDomainSnapshotPtr snapshot, /* Delete a snapshot */ typedef enum { - VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN = (1 << 0), /* Also delete children */ - VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata */ - VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children */ + VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN = (1 << 0), /* Also delete children (Since: v1.0.0) */ + VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY = (1 << 1), /* Delete just metadata (Since: v1.0.0) */ + VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLY = (1 << 2), /* Delete just children (Since: v1.0.0) */ } virDomainSnapshotDeleteFlags; int virDomainSnapshotDelete(virDomainSnapshotPtr snapshot, diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 1275f4530d..c3dd4d33c0 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -49,15 +49,15 @@ typedef virDomain *virDomainPtr; * A domain may be in different states at a given point in time */ typedef enum { - VIR_DOMAIN_NOSTATE = 0, /* no state */ - VIR_DOMAIN_RUNNING = 1, /* the domain is running */ - VIR_DOMAIN_BLOCKED = 2, /* the domain is blocked on resource */ - VIR_DOMAIN_PAUSED = 3, /* the domain is paused by user */ - VIR_DOMAIN_SHUTDOWN= 4, /* the domain is being shut down */ - VIR_DOMAIN_SHUTOFF = 5, /* the domain is shut off */ - VIR_DOMAIN_CRASHED = 6, /* the domain is crashed */ + VIR_DOMAIN_NOSTATE = 0, /* no state (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING = 1, /* the domain is running (Since: v1.0.0) */ + VIR_DOMAIN_BLOCKED = 2, /* the domain is blocked on resource (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED = 3, /* the domain is paused by user (Since: v1.0.0) */ + VIR_DOMAIN_SHUTDOWN= 4, /* the domain is being shut down (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF = 5, /* the domain is shut off (Since: v1.0.0) */ + VIR_DOMAIN_CRASHED = 6, /* the domain is crashed (Since: v1.0.0) */ VIR_DOMAIN_PMSUSPENDED = 7, /* the domain is suspended by guest - power management */ + power management (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_LAST @@ -79,17 +79,17 @@ typedef enum { typedef enum { VIR_DOMAIN_RUNNING_UNKNOWN = 0, - VIR_DOMAIN_RUNNING_BOOTED = 1, /* normal startup from boot */ - VIR_DOMAIN_RUNNING_MIGRATED = 2, /* migrated from another host */ - VIR_DOMAIN_RUNNING_RESTORED = 3, /* restored from a state file */ - VIR_DOMAIN_RUNNING_FROM_SNAPSHOT = 4, /* restored from snapshot */ - VIR_DOMAIN_RUNNING_UNPAUSED = 5, /* returned from paused state */ - VIR_DOMAIN_RUNNING_MIGRATION_CANCELED = 6, /* returned from migration */ - VIR_DOMAIN_RUNNING_SAVE_CANCELED = 7, /* returned from failed save process */ + VIR_DOMAIN_RUNNING_BOOTED = 1, /* normal startup from boot (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING_MIGRATED = 2, /* migrated from another host (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING_RESTORED = 3, /* restored from a state file (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING_FROM_SNAPSHOT = 4, /* restored from snapshot (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING_UNPAUSED = 5, /* returned from paused state (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING_MIGRATION_CANCELED = 6, /* returned from migration (Since: v1.0.0) */ + VIR_DOMAIN_RUNNING_SAVE_CANCELED = 7, /* returned from failed save process (Since: v1.0.0) */ VIR_DOMAIN_RUNNING_WAKEUP = 8, /* returned from pmsuspended due to - wakeup event */ - VIR_DOMAIN_RUNNING_CRASHED = 9, /* resumed from crashed */ - VIR_DOMAIN_RUNNING_POSTCOPY = 10, /* running in post-copy migration mode */ + wakeup event (Since: v1.0.0) */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_RUNNING_LAST @@ -97,7 +97,7 @@ typedef enum { } virDomainRunningReason; typedef enum { - VIR_DOMAIN_BLOCKED_UNKNOWN = 0, /* the reason is unknown */ + VIR_DOMAIN_BLOCKED_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_BLOCKED_LAST @@ -105,20 +105,20 @@ typedef enum { } virDomainBlockedReason; typedef enum { - VIR_DOMAIN_PAUSED_UNKNOWN = 0, /* the reason is unknown */ - VIR_DOMAIN_PAUSED_USER = 1, /* paused on user request */ - VIR_DOMAIN_PAUSED_MIGRATION = 2, /* paused for offline migration */ - VIR_DOMAIN_PAUSED_SAVE = 3, /* paused for save */ - VIR_DOMAIN_PAUSED_DUMP = 4, /* paused for offline core dump */ - VIR_DOMAIN_PAUSED_IOERROR = 5, /* paused due to a disk I/O error */ - VIR_DOMAIN_PAUSED_WATCHDOG = 6, /* paused due to a watchdog event */ - VIR_DOMAIN_PAUSED_FROM_SNAPSHOT = 7, /* paused after restoring from snapshot */ - VIR_DOMAIN_PAUSED_SHUTTING_DOWN = 8, /* paused during shutdown process */ - VIR_DOMAIN_PAUSED_SNAPSHOT = 9, /* paused while creating a snapshot */ - VIR_DOMAIN_PAUSED_CRASHED = 10, /* paused due to a guest crash */ - VIR_DOMAIN_PAUSED_STARTING_UP = 11, /* the domain is being started */ - VIR_DOMAIN_PAUSED_POSTCOPY = 12, /* paused for post-copy migration */ - VIR_DOMAIN_PAUSED_POSTCOPY_FAILED = 13, /* paused after failed post-copy */ + VIR_DOMAIN_PAUSED_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_USER = 1, /* paused on user request (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_MIGRATION = 2, /* paused for offline migration (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_SAVE = 3, /* paused for save (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_DUMP = 4, /* paused for offline core dump (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_IOERROR = 5, /* paused due to a disk I/O error (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_WATCHDOG = 6, /* paused due to a watchdog event (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_FROM_SNAPSHOT = 7, /* paused after restoring from snapshot (Since: v1.0.0) */ + VIR_DOMAIN_PAUSED_SHUTTING_DOWN = 8, /* paused during shutdown process (Since: v1.0.0) */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_PAUSED_LAST @@ -126,8 +126,8 @@ typedef enum { } virDomainPausedReason; typedef enum { - VIR_DOMAIN_SHUTDOWN_UNKNOWN = 0, /* the reason is unknown */ - VIR_DOMAIN_SHUTDOWN_USER = 1, /* shutting down on user request */ + VIR_DOMAIN_SHUTDOWN_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ + VIR_DOMAIN_SHUTDOWN_USER = 1, /* shutting down on user request (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_SHUTDOWN_LAST @@ -135,25 +135,25 @@ typedef enum { } virDomainShutdownReason; typedef enum { - VIR_DOMAIN_SHUTOFF_UNKNOWN = 0, /* the reason is unknown */ - VIR_DOMAIN_SHUTOFF_SHUTDOWN = 1, /* normal shutdown */ - VIR_DOMAIN_SHUTOFF_DESTROYED = 2, /* forced poweroff */ - VIR_DOMAIN_SHUTOFF_CRASHED = 3, /* domain crashed */ - VIR_DOMAIN_SHUTOFF_MIGRATED = 4, /* migrated to another host */ - VIR_DOMAIN_SHUTOFF_SAVED = 5, /* saved to a file */ - VIR_DOMAIN_SHUTOFF_FAILED = 6, /* domain failed to start */ + VIR_DOMAIN_SHUTOFF_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF_SHUTDOWN = 1, /* normal shutdown (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF_DESTROYED = 2, /* forced poweroff (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF_CRASHED = 3, /* domain crashed (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF_MIGRATED = 4, /* migrated to another host (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF_SAVED = 5, /* saved to a file (Since: v1.0.0) */ + VIR_DOMAIN_SHUTOFF_FAILED = 6, /* domain failed to start (Since: v1.0.0) */ VIR_DOMAIN_SHUTOFF_FROM_SNAPSHOT = 7, /* restored from a snapshot which was - * taken while domain was shutoff */ + * taken while domain was shutoff (Since: v1.0.0) */ VIR_DOMAIN_SHUTOFF_DAEMON = 8, /* daemon decides to kill domain - during reconnection processing */ + during reconnection processing (Since: v4.10.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_SHUTOFF_LAST # endif } virDomainShutoffReason; typedef enum { - VIR_DOMAIN_CRASHED_UNKNOWN = 0, /* crashed for unknown reason */ - VIR_DOMAIN_CRASHED_PANICKED = 1, /* domain panicked */ + VIR_DOMAIN_CRASHED_UNKNOWN = 0, /* crashed for unknown reason (Since: v1.0.0) */ + VIR_DOMAIN_CRASHED_PANICKED = 1, /* domain panicked (Since: v1.1.1) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_CRASHED_LAST @@ -182,14 +182,14 @@ typedef enum { * Current state of a control interface to the domain. */ typedef enum { - VIR_DOMAIN_CONTROL_OK = 0, /* operational, ready to accept commands */ + VIR_DOMAIN_CONTROL_OK = 0, /* operational, ready to accept commands (Since: v1.0.0) */ VIR_DOMAIN_CONTROL_JOB = 1, /* background job is running (can be monitored by virDomainGetJobInfo); only - limited set of commands may be allowed */ - VIR_DOMAIN_CONTROL_OCCUPIED = 2, /* occupied by a running command */ + limited set of commands may be allowed (Since: v1.0.0) */ + VIR_DOMAIN_CONTROL_OCCUPIED = 2, /* occupied by a running command (Since: v1.0.0) */ VIR_DOMAIN_CONTROL_ERROR = 3, /* unusable, domain cannot be fully operated, possible reason is provided - in the details field */ + in the details field (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_CONTROL_LAST @@ -203,13 +203,13 @@ typedef enum { */ typedef enum { VIR_DOMAIN_CONTROL_ERROR_REASON_NONE = 0, /* server didn't provide a - reason */ + reason (Since: v1.2.14) */ VIR_DOMAIN_CONTROL_ERROR_REASON_UNKNOWN = 1, /* unknown reason for the - error */ + error (Since: v1.2.14) */ VIR_DOMAIN_CONTROL_ERROR_REASON_MONITOR = 2, /* monitor connection is - broken */ + broken (Since: v1.2.14) */ VIR_DOMAIN_CONTROL_ERROR_REASON_INTERNAL = 3, /* error caused due to - internal failure in libvirt + internal failure in libvirt (Since: v1.2.14) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_CONTROL_ERROR_REASON_LAST @@ -258,10 +258,10 @@ typedef virDomainControlInfo *virDomainControlInfoPtr; * These enums should not conflict with those of virTypedParameterFlags. */ typedef enum { - VIR_DOMAIN_AFFECT_CURRENT = 0, /* Affect current domain state. */ - VIR_DOMAIN_AFFECT_LIVE = 1 << 0, /* Affect running domain state. */ + VIR_DOMAIN_AFFECT_CURRENT = 0, /* Affect current domain state. (Since: v1.0.0) */ + VIR_DOMAIN_AFFECT_LIVE = 1 << 0, /* Affect running domain state. (Since: v1.0.0) */ VIR_DOMAIN_AFFECT_CONFIG = 1 << 1, /* Affect persistent domain state. */ - /* 1 << 2 is reserved for virTypedParameterFlags */ + /* 1 << 2 is reserved for virTypedParameterFlags (Since: v1.0.0) */ } virDomainModificationImpact; /** @@ -296,13 +296,13 @@ typedef virDomainInfo *virDomainInfoPtr; * Domain. */ typedef enum { - VIR_DOMAIN_NONE = 0, /* Default behavior */ - VIR_DOMAIN_START_PAUSED = 1 << 0, /* Launch guest in paused state */ - VIR_DOMAIN_START_AUTODESTROY = 1 << 1, /* Automatically kill guest when virConnectPtr is closed */ - VIR_DOMAIN_START_BYPASS_CACHE = 1 << 2, /* Avoid file system cache pollution */ - VIR_DOMAIN_START_FORCE_BOOT = 1 << 3, /* Boot, discarding any managed save */ - VIR_DOMAIN_START_VALIDATE = 1 << 4, /* Validate the XML document against schema */ - VIR_DOMAIN_START_RESET_NVRAM = 1 << 5, /* Re-initialize NVRAM from template */ + VIR_DOMAIN_NONE = 0, /* Default behavior (Since: v1.0.0) */ + VIR_DOMAIN_START_PAUSED = 1 << 0, /* Launch guest in paused state (Since: v1.0.0) */ + VIR_DOMAIN_START_AUTODESTROY = 1 << 1, /* Automatically kill guest when virConnectPtr is closed (Since: v1.0.0) */ + VIR_DOMAIN_START_BYPASS_CACHE = 1 << 2, /* Avoid file system cache pollution (Since: v1.0.0) */ + VIR_DOMAIN_START_FORCE_BOOT = 1 << 3, /* Boot, discarding any managed save (Since: v1.0.0) */ + 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) */ } virDomainCreateFlags; @@ -585,9 +585,9 @@ typedef virDomainInterfaceStatsStruct *virDomainInterfaceStatsPtr; * Memory Statistics Tags: */ typedef enum { - /* The total amount of data read from swap space (in kB). */ + /* The total amount of data read from swap space (in kB). (Since: v1.0.0) */ VIR_DOMAIN_MEMORY_STAT_SWAP_IN = 0, - /* The total amount of memory written out to swap space (in kB). */ + /* The total amount of memory written out to swap space (in kB). (Since: v1.0.0) */ VIR_DOMAIN_MEMORY_STAT_SWAP_OUT = 1, /* @@ -595,6 +595,9 @@ typedef enum { * that is not available. When servicing the page fault, if disk IO is * 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: v1.0.0 + * */ VIR_DOMAIN_MEMORY_STAT_MAJOR_FAULT = 2, VIR_DOMAIN_MEMORY_STAT_MINOR_FAULT = 3, @@ -603,6 +606,9 @@ typedef enum { * The amount of memory left completely unused by the system. Memory that * is available but used for reclaimable caches should NOT be reported as * free. This value is expressed in kB. + * + * Since: v1.0.0 + * */ VIR_DOMAIN_MEMORY_STAT_UNUSED = 4, @@ -611,47 +617,77 @@ typedef enum { * may be less than the amount of memory assigned to the domain if a * balloon driver is in use or if the guest OS does not initialize all * assigned pages. This value is expressed in kB. + * + * Since: v1.0.0 + * */ VIR_DOMAIN_MEMORY_STAT_AVAILABLE = 5, - /* Current balloon value (in KB). */ + /* + * Current balloon value (in KB). + * + * Since: v1.0.0 + * + */ VIR_DOMAIN_MEMORY_STAT_ACTUAL_BALLOON = 6, /* Resident Set Size of the process running the domain. This value - * is in kB */ + * is in kB + * + * Since: v1.0.0 + */ VIR_DOMAIN_MEMORY_STAT_RSS = 7, /* * How much the balloon can be inflated without pushing the guest system * to swap, corresponds to 'Available' in /proc/meminfo + * + * Since: v2.1.0 + * */ VIR_DOMAIN_MEMORY_STAT_USABLE = 8, - /* Timestamp of the last update of statistics, in seconds. */ + /* + * Timestamp of the last update of statistics, in seconds. + * + * Since: v2.1.0 + */ VIR_DOMAIN_MEMORY_STAT_LAST_UPDATE = 9, /* * The amount of memory, that can be quickly reclaimed without * additional I/O (in kB). Typically these pages are used for caching files * from disk. + * + * Since: v4.6.0 + * */ VIR_DOMAIN_MEMORY_STAT_DISK_CACHES = 10, /* * The number of successful huge page allocations from inside the domain via * virtio balloon. + * + * Since: v5.4.0 + * */ VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGALLOC = 11, /* * The number of failed huge page allocations from inside the domain via * virtio balloon. + * + * Since: v5.4.0 + * */ VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGFAIL = 12, /* * 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: v1.0.0 + * */ VIR_DOMAIN_MEMORY_STAT_NR = 13, @@ -672,11 +708,11 @@ typedef virDomainMemoryStatStruct *virDomainMemoryStatPtr; /* Domain core dump flags. */ typedef enum { - VIR_DUMP_CRASH = (1 << 0), /* crash after dump */ - VIR_DUMP_LIVE = (1 << 1), /* live dump */ - VIR_DUMP_BYPASS_CACHE = (1 << 2), /* avoid file system cache pollution */ - VIR_DUMP_RESET = (1 << 3), /* reset domain after dump finishes */ - VIR_DUMP_MEMORY_ONLY = (1 << 4), /* use dump-guest-memory */ + VIR_DUMP_CRASH = (1 << 0), /* crash after dump (Since: v1.0.0) */ + VIR_DUMP_LIVE = (1 << 1), /* live dump (Since: v1.0.0) */ + VIR_DUMP_BYPASS_CACHE = (1 << 2), /* avoid file system cache pollution (Since: v1.0.0) */ + VIR_DUMP_RESET = (1 << 3), /* reset domain after dump finishes (Since: v1.0.0) */ + VIR_DUMP_MEMORY_ONLY = (1 << 4), /* use dump-guest-memory (Since: v1.0.0) */ } virDomainCoreDumpFlags; /** @@ -685,14 +721,14 @@ typedef enum { * Values for specifying different formats of domain core dumps. */ typedef enum { - VIR_DOMAIN_CORE_DUMP_FORMAT_RAW, /* dump guest memory in raw format */ + VIR_DOMAIN_CORE_DUMP_FORMAT_RAW, /* dump guest memory in raw format (Since: v1.2.3) */ VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_ZLIB, /* kdump-compressed format, with - * zlib compression */ + * zlib compression (Since: v1.2.3) */ VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_LZO, /* kdump-compressed format, with - * lzo compression */ + * lzo compression (Since: v1.2.3) */ VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_SNAPPY, /* kdump-compressed format, with - * snappy compression */ - VIR_DOMAIN_CORE_DUMP_FORMAT_WIN_DMP, /* Windows full crashdump format */ + * snappy compression (Since: v1.2.3) */ + VIR_DOMAIN_CORE_DUMP_FORMAT_WIN_DMP, /* Windows full crashdump format (Since: v7.4.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_CORE_DUMP_FORMAT_LAST /* @@ -710,6 +746,9 @@ typedef enum { * The migration may never converge if the domain is changing its memory * faster then it can be transferred. The domain can be manually paused * anytime during migration using virDomainSuspend. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_LIVE = (1 << 0), @@ -718,6 +757,9 @@ typedef enum { * controls the migration process. In peer-to-peer mode, the source * libvirtd controls the migration by calling the destination daemon * directly. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_PEER2PEER = (1 << 1), @@ -728,6 +770,9 @@ typedef enum { * * Note the less-common spelling that we're stuck with: * VIR_MIGRATE_TUNNELLED should be VIR_MIGRATE_TUNNELED. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_TUNNELLED = (1 << 2), @@ -735,17 +780,26 @@ typedef enum { * migration. If the domain was persistent on the source host and * VIR_MIGRATE_UNDEFINE_SOURCE is not used, it will end up persistent on * both hosts. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_PERSIST_DEST = (1 << 3), /* Undefine the domain on the source host once migration successfully * finishes. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_UNDEFINE_SOURCE = (1 << 4), /* Leave the domain suspended on the destination host. virDomainResume (on * the virDomainPtr returned by the migration API) has to be called * explicitly to resume domain's virtual CPUs. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_PAUSED = (1 << 5), @@ -755,6 +809,9 @@ typedef enum { * disks should be migrated. * * This flag and VIR_MIGRATE_NON_SHARED_INC are mutually exclusive. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_NON_SHARED_DISK = (1 << 6), @@ -765,6 +822,9 @@ typedef enum { * on the source host. * * This flag and VIR_MIGRATE_NON_SHARED_DISK are mutually exclusive. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_NON_SHARED_INC = (1 << 7), @@ -772,6 +832,9 @@ typedef enum { * process. This flag is used automatically when both sides support it. * Explicitly setting this flag will cause migration to fail if either the * source or the destination does not support it. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_CHANGE_PROTECTION = (1 << 8), @@ -782,6 +845,9 @@ typedef enum { * without explicitly setting cache mode to "none". Migrating such domains * is unsafe unless the disk images are stored on coherent clustered * filesystem, such as GFS2 or GPFS. + * + * Since: v1.0.0 + * */ VIR_MIGRATE_UNSAFE = (1 << 9), @@ -791,6 +857,9 @@ typedef enum { * * Offline migration may not copy disk storage or any other file based * storage (such as UEFI variables). + * + * Since: v1.0.1 + * */ VIR_MIGRATE_OFFLINE = (1 << 10), @@ -798,11 +867,17 @@ typedef enum { * VIR_MIGRATE_PARAM_COMPRESSION. A hypervisor default method will be used * if this parameter is omitted. Individual compression methods can be * tuned via their specific VIR_MIGRATE_PARAM_COMPRESSION_* parameters. + * + * Since: v1.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 + * */ VIR_MIGRATE_ABORT_ON_ERROR = (1 << 12), @@ -811,6 +886,9 @@ typedef enum { * not change its memory faster than a hypervisor can transfer the changed * memory to the destination host. VIR_MIGRATE_PARAM_AUTO_CONVERGE_* * parameters can be used to tune the algorithm. + * + * Since: v1.2.3 + * */ VIR_MIGRATE_AUTO_CONVERGE = (1 << 13), @@ -828,6 +906,9 @@ typedef enum { * most of the host's memory). Doing so may be dangerous to both the * domain and the host itself since the host's kernel may run out of * memory. + * + * Since: v1.2.9 + * */ VIR_MIGRATE_RDMA_PIN_ALL = (1 << 14), @@ -835,6 +916,9 @@ typedef enum { * migration. However, the migration will start normally and * virDomainMigrateStartPostCopy needs to be called to switch it into the * post-copy mode. See virDomainMigrateStartPostCopy for more details. + * + * Since: v1.3.3 + * */ VIR_MIGRATE_POSTCOPY = (1 << 15), @@ -842,12 +926,18 @@ typedef enum { * to use the TLS environment configured by the hypervisor in order to * perform the migration. If incorrectly configured on either source or * destination, the migration will fail. + * + * Since: v3.2.0 + * */ VIR_MIGRATE_TLS = (1 << 16), /* Send memory pages to the destination host through several network * connections. See VIR_MIGRATE_PARAM_PARALLEL_* parameters for * configuring the parallel migration. + * + * Since: v5.2.0 + * */ VIR_MIGRATE_PARALLEL = (1 << 17), @@ -858,6 +948,9 @@ typedef enum { * * Requires one of VIR_MIGRATE_NON_SHARED_DISK, VIR_MIGRATE_NON_SHARED_INC * to be present as well. + * + * Since: v8.0.0 + * */ VIR_MIGRATE_NON_SHARED_SYNCHRONOUS_WRITES = (1 << 18), @@ -1138,7 +1231,7 @@ int virDomainMigrateSetCompressionCache(virDomainPtr domain, /* Domain migration speed flags. */ typedef enum { - /* Set or get maximum speed of post-copy migration. */ + /* Set or get maximum speed of post-copy migration. (Since: v5.1.0) */ VIR_DOMAIN_MIGRATE_MAX_SPEED_POSTCOPY = (1 << 0), } virDomainMigrateMaxSpeedFlags; @@ -1200,12 +1293,12 @@ virDomainPtr virDomainLookupByUUIDString (virConnectPtr conn, const char *uuid); typedef enum { - VIR_DOMAIN_SHUTDOWN_DEFAULT = 0, /* hypervisor choice */ - VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event */ - VIR_DOMAIN_SHUTDOWN_GUEST_AGENT = (1 << 1), /* Use guest agent */ - VIR_DOMAIN_SHUTDOWN_INITCTL = (1 << 2), /* Use initctl */ - VIR_DOMAIN_SHUTDOWN_SIGNAL = (1 << 3), /* Send a signal */ - VIR_DOMAIN_SHUTDOWN_PARAVIRT = (1 << 4), /* Use paravirt guest control */ + VIR_DOMAIN_SHUTDOWN_DEFAULT = 0, /* hypervisor choice (Since: v1.0.0) */ + VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: v1.0.0) */ + VIR_DOMAIN_SHUTDOWN_GUEST_AGENT = (1 << 1), /* Use guest agent (Since: v1.0.0) */ + 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) */ } virDomainShutdownFlagValues; int virDomainShutdown (virDomainPtr domain); @@ -1213,12 +1306,12 @@ int virDomainShutdownFlags (virDomainPtr domain, unsigned int flags); typedef enum { - VIR_DOMAIN_REBOOT_DEFAULT = 0, /* hypervisor choice */ - VIR_DOMAIN_REBOOT_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event */ - VIR_DOMAIN_REBOOT_GUEST_AGENT = (1 << 1), /* Use guest agent */ - VIR_DOMAIN_REBOOT_INITCTL = (1 << 2), /* Use initctl */ - VIR_DOMAIN_REBOOT_SIGNAL = (1 << 3), /* Send a signal */ - VIR_DOMAIN_REBOOT_PARAVIRT = (1 << 4), /* Use paravirt guest control */ + VIR_DOMAIN_REBOOT_DEFAULT = 0, /* hypervisor choice (Since: v1.0.0) */ + VIR_DOMAIN_REBOOT_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: v1.0.0) */ + VIR_DOMAIN_REBOOT_GUEST_AGENT = (1 << 1), /* Use guest agent (Since: v1.0.0) */ + 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) */ } virDomainRebootFlagValues; int virDomainReboot (virDomainPtr domain, @@ -1235,9 +1328,9 @@ int virDomainDestroy (virDomainPtr domain); * virDomainDestroyFlags() function */ typedef enum { - VIR_DOMAIN_DESTROY_DEFAULT = 0, /* Default behavior - could lead to data loss!! */ - VIR_DOMAIN_DESTROY_GRACEFUL = 1 << 0, /* only SIGTERM, no SIGKILL */ - VIR_DOMAIN_DESTROY_REMOVE_LOGS = 1 << 1, /* remove VM logs on destroy */ + VIR_DOMAIN_DESTROY_DEFAULT = 0, /* Default behavior - could lead to data loss!! (Since: v1.0.0) */ + VIR_DOMAIN_DESTROY_GRACEFUL = 1 << 0, /* only SIGTERM, no SIGKILL (Since: v1.0.0) */ + VIR_DOMAIN_DESTROY_REMOVE_LOGS = 1 << 1, /* remove VM logs on destroy (Since: v8.3.0) */ } virDomainDestroyFlagsValues; int virDomainDestroyFlags (virDomainPtr domain, @@ -1267,10 +1360,10 @@ int virDomainPMWakeup (virDomainPtr domain, * flags apply to all these functions. */ typedef enum { - VIR_DOMAIN_SAVE_BYPASS_CACHE = 1 << 0, /* Avoid file system cache pollution */ - VIR_DOMAIN_SAVE_RUNNING = 1 << 1, /* Favor running over paused */ - VIR_DOMAIN_SAVE_PAUSED = 1 << 2, /* Favor paused over running */ - VIR_DOMAIN_SAVE_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template */ + VIR_DOMAIN_SAVE_BYPASS_CACHE = 1 << 0, /* Avoid file system cache pollution (Since: v1.0.0) */ + VIR_DOMAIN_SAVE_RUNNING = 1 << 1, /* Favor running over paused (Since: v1.0.0) */ + VIR_DOMAIN_SAVE_PAUSED = 1 << 2, /* Favor paused over running (Since: v1.0.0) */ + VIR_DOMAIN_SAVE_RESET_NVRAM = 1 << 3, /* Re-initialize NVRAM from template (Since: v8.1.0) */ } virDomainSaveRestoreFlags; int virDomainSave (virDomainPtr domain, @@ -1520,12 +1613,12 @@ int virDomainGetMemoryParameters(virDomainPtr domain, /* Memory size modification flags. */ typedef enum { - /* See virDomainModificationImpact for these flags. */ + /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ VIR_DOMAIN_MEM_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, VIR_DOMAIN_MEM_LIVE = VIR_DOMAIN_AFFECT_LIVE, VIR_DOMAIN_MEM_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, - /* Additionally, these flags may be bitwise-OR'd in. */ + /* Additionally, these flags may be bitwise-OR'd in. (Since: v1.0.0) */ VIR_DOMAIN_MEM_MAXIMUM = (1 << 2), /* affect Max rather than current */ } virDomainMemoryModFlags; @@ -1544,7 +1637,7 @@ typedef enum { VIR_DOMAIN_NUMATUNE_MEM_RESTRICTIVE = 3, # ifdef VIR_ENUM_SENTINELS - VIR_DOMAIN_NUMATUNE_MEM_LAST /* This constant is subject to change */ + VIR_DOMAIN_NUMATUNE_MEM_LAST /* This constant is subject to change (Since: v1.0.0) */ # endif } virDomainNumatuneMemMode; @@ -1597,8 +1690,8 @@ int virDomainGetSecurityLabel (virDomainPtr domain, virSecurityLabelPtr seclabel); typedef enum { - VIR_DOMAIN_GET_HOSTNAME_LEASE = (1 << 0), /* Parse DHCP lease file */ - VIR_DOMAIN_GET_HOSTNAME_AGENT = (1 << 1), /* Query qemu guest agent */ + 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) */ } virDomainGetHostnameFlags; char * virDomainGetHostname (virDomainPtr domain, @@ -1607,9 +1700,9 @@ int virDomainGetSecurityLabelList (virDomainPtr domain, virSecurityLabelPtr* seclabels); typedef enum { - VIR_DOMAIN_METADATA_DESCRIPTION = 0, /* Operate on <description> */ - VIR_DOMAIN_METADATA_TITLE = 1, /* Operate on <title> */ - VIR_DOMAIN_METADATA_ELEMENT = 2, /* Operate on <metadata> */ + VIR_DOMAIN_METADATA_DESCRIPTION = 0, /* Operate on <description> (Since: v1.0.0) */ + VIR_DOMAIN_METADATA_TITLE = 1, /* Operate on <title> (Since: v1.0.0) */ + VIR_DOMAIN_METADATA_ELEMENT = 2, /* Operate on <metadata> (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_METADATA_LAST @@ -1640,14 +1733,14 @@ virDomainGetMetadata(virDomainPtr domain, */ typedef enum { - VIR_DOMAIN_XML_SECURE = (1 << 0), /* dump security sensitive information too */ - VIR_DOMAIN_XML_INACTIVE = (1 << 1), /* dump inactive domain information */ - VIR_DOMAIN_XML_UPDATE_CPU = (1 << 2), /* update guest CPU requirements according to host CPU */ - VIR_DOMAIN_XML_MIGRATABLE = (1 << 3), /* dump XML suitable for migration */ + VIR_DOMAIN_XML_SECURE = (1 << 0), /* dump security sensitive information too (Since: v1.0.0) */ + VIR_DOMAIN_XML_INACTIVE = (1 << 1), /* dump inactive domain information (Since: v1.0.0) */ + VIR_DOMAIN_XML_UPDATE_CPU = (1 << 2), /* update guest CPU requirements according to host CPU (Since: v1.0.0) */ + VIR_DOMAIN_XML_MIGRATABLE = (1 << 3), /* dump XML suitable for migration (Since: v1.0.0) */ } virDomainXMLFlags; typedef enum { - VIR_DOMAIN_SAVE_IMAGE_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too */ + VIR_DOMAIN_SAVE_IMAGE_XML_SECURE = VIR_DOMAIN_XML_SECURE, /* dump security sensitive information too (Since: v5.1.0) */ } virDomainSaveImageXMLFlags; char * virDomainGetXMLDesc (virDomainPtr domain, @@ -1752,7 +1845,7 @@ int virDomainBlockPeek (virDomainPtr dom, * Flags available for virDomainBlockResize(). */ typedef enum { - VIR_DOMAIN_BLOCK_RESIZE_BYTES = 1 << 0, /* size in bytes instead of KiB */ + VIR_DOMAIN_BLOCK_RESIZE_BYTES = 1 << 0, /* size in bytes instead of KiB (Since: v1.0.0) */ } virDomainBlockResizeFlags; int virDomainBlockResize (virDomainPtr dom, @@ -1814,8 +1907,8 @@ int virDomainMemoryStats (virDomainPtr dom, /* Memory peeking flags. */ typedef enum { - VIR_MEMORY_VIRTUAL = 1 << 0, /* addresses are virtual addresses */ - VIR_MEMORY_PHYSICAL = 1 << 1, /* addresses are physical addresses */ + VIR_MEMORY_VIRTUAL = 1 << 0, /* addresses are virtual addresses (Since: v1.0.0) */ + VIR_MEMORY_PHYSICAL = 1 << 1, /* addresses are physical addresses (Since: v1.0.0) */ } virDomainMemoryFlags; int virDomainMemoryPeek (virDomainPtr dom, @@ -1825,7 +1918,7 @@ int virDomainMemoryPeek (virDomainPtr dom, unsigned int flags); typedef enum { - VIR_DOMAIN_DEFINE_VALIDATE = (1 << 0), /* Validate the XML document against schema */ + VIR_DOMAIN_DEFINE_VALIDATE = (1 << 0), /* Validate the XML document against schema (Since: v1.2.12) */ } virDomainDefineFlags; /* @@ -1841,18 +1934,18 @@ int virDomainUndefine (virDomainPtr domain); typedef enum { VIR_DOMAIN_UNDEFINE_MANAGED_SAVE = (1 << 0), /* Also remove any - managed save */ + managed save (Since: v1.0.0) */ VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATA = (1 << 1), /* If last use of domain, then also remove any - snapshot metadata */ + snapshot metadata (Since: v1.0.0) */ VIR_DOMAIN_UNDEFINE_NVRAM = (1 << 2), /* Also remove any - nvram file */ - VIR_DOMAIN_UNDEFINE_KEEP_NVRAM = (1 << 3), /* Keep nvram file */ + nvram file (Since: v1.2.9) */ + VIR_DOMAIN_UNDEFINE_KEEP_NVRAM = (1 << 3), /* Keep nvram file (Since: v2.3.0) */ VIR_DOMAIN_UNDEFINE_CHECKPOINTS_METADATA = (1 << 4), /* If last use of domain, then also remove any checkpoint metadata */ - /* Future undefine control flags should come here. */ + /* Future undefine control flags should come here. (Since: v5.6.0) */ } virDomainUndefineFlagsValues; @@ -1916,9 +2009,9 @@ int virDomainSetAutostart (virDomainPtr domain, */ typedef enum { - VIR_VCPU_OFFLINE = 0, /* the virtual CPU is offline */ - VIR_VCPU_RUNNING = 1, /* the virtual CPU is running */ - VIR_VCPU_BLOCKED = 2, /* the virtual CPU is blocked on resource */ + VIR_VCPU_OFFLINE = 0, /* the virtual CPU is offline (Since: v1.0.0) */ + VIR_VCPU_RUNNING = 1, /* the virtual CPU is running (Since: v1.0.0) */ + VIR_VCPU_BLOCKED = 2, /* the virtual CPU is blocked on resource (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_VCPU_LAST @@ -1926,8 +2019,8 @@ typedef enum { } virVcpuState; typedef enum { - VIR_VCPU_INFO_CPU_OFFLINE = -1, /* the vCPU is offline */ - VIR_VCPU_INFO_CPU_UNAVAILABLE = -2, /* the hypervisor does not expose real CPU information */ + 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; typedef struct _virVcpuInfo virVcpuInfo; @@ -1941,14 +2034,14 @@ typedef virVcpuInfo *virVcpuInfoPtr; /* Flags for controlling virtual CPU hot-plugging. */ typedef enum { - /* See virDomainModificationImpact for these flags. */ + /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ VIR_DOMAIN_VCPU_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, VIR_DOMAIN_VCPU_LIVE = VIR_DOMAIN_AFFECT_LIVE, VIR_DOMAIN_VCPU_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, - /* Additionally, these flags may be bitwise-OR'd in. */ - VIR_DOMAIN_VCPU_MAXIMUM = (1 << 2), /* Max rather than current count */ - VIR_DOMAIN_VCPU_GUEST = (1 << 3), /* Modify state of the cpu in the guest */ + /* Additionally, these flags may be bitwise-OR'd in. (Since: v1.0.0) */ + VIR_DOMAIN_VCPU_MAXIMUM = (1 << 2), /* Max rather than current count (Since: v1.1.0) */ + VIR_DOMAIN_VCPU_GUEST = (1 << 3), /* Modify state of the cpu in the guest (Since: v2.4.0) */ VIR_DOMAIN_VCPU_HOTPLUGGABLE = (1 << 4), /* Make vcpus added hot(un)pluggable */ } virDomainVcpuFlags; @@ -2159,12 +2252,12 @@ int virDomainGetVcpus (virDomainPtr domain, typedef enum { - /* See virDomainModificationImpact for these flags. */ + /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ VIR_DOMAIN_DEVICE_MODIFY_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, VIR_DOMAIN_DEVICE_MODIFY_LIVE = VIR_DOMAIN_AFFECT_LIVE, VIR_DOMAIN_DEVICE_MODIFY_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, - /* Additionally, these flags may be bitwise-OR'd in. */ + /* Additionally, these flags may be bitwise-OR'd in. (Since: v1.0.0) */ VIR_DOMAIN_DEVICE_MODIFY_FORCE = (1 << 2), /* Forcibly modify device (ex. force eject a cdrom) */ } virDomainDeviceModifyFlags; @@ -2191,16 +2284,16 @@ struct _virDomainStatsRecord { }; typedef enum { - VIR_DOMAIN_STATS_STATE = (1 << 0), /* return domain state */ - VIR_DOMAIN_STATS_CPU_TOTAL = (1 << 1), /* return domain CPU info */ - VIR_DOMAIN_STATS_BALLOON = (1 << 2), /* return domain balloon info */ - VIR_DOMAIN_STATS_VCPU = (1 << 3), /* return domain virtual CPU info */ - VIR_DOMAIN_STATS_INTERFACE = (1 << 4), /* return domain interfaces info */ - VIR_DOMAIN_STATS_BLOCK = (1 << 5), /* return domain block info */ - VIR_DOMAIN_STATS_PERF = (1 << 6), /* return domain perf event info */ - VIR_DOMAIN_STATS_IOTHREAD = (1 << 7), /* return iothread poll info */ - VIR_DOMAIN_STATS_MEMORY = (1 << 8), /* return domain memory info */ - VIR_DOMAIN_STATS_DIRTYRATE = (1 << 9), /* return domain dirty rate info */ + 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) */ } virDomainStatsTypes; typedef enum { @@ -2216,9 +2309,9 @@ typedef enum { VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER = VIR_CONNECT_LIST_DOMAINS_OTHER, VIR_CONNECT_GET_ALL_DOMAINS_STATS_NOWAIT = 1 << 29, /* report statistics that can be obtained - immediately without any blocking */ - VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING = 1 << 30, /* include backing chain for block stats */ - VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS = 1U << 31, /* enforce requested stats */ + 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) */ } virConnectGetAllDomainStatsFlags; int virConnectGetAllDomainStats(virConnectPtr conn, @@ -2482,26 +2575,41 @@ int virDomainSetPerfEvents(virDomainPtr dom, * Describes various possible block jobs. */ typedef enum { - /* Placeholder */ + /* Placeholder (Since: v1.0.0) */ VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWN = 0, /* Block Pull (virDomainBlockPull, or virDomainBlockRebase without - * flags), job ends on completion */ + * flags), job ends on completion + * + * Since: v1.0.0 + */ VIR_DOMAIN_BLOCK_JOB_TYPE_PULL = 1, /* Block Copy (virDomainBlockCopy, or virDomainBlockRebase with - * flags), job exists as long as mirroring is active */ + * flags), job exists as long as mirroring is active + * + * Since: v1.0.0 + */ VIR_DOMAIN_BLOCK_JOB_TYPE_COPY = 2, /* Block Commit (virDomainBlockCommit without flags), job ends on - * completion */ + * completion + * + * Since: v1.0.0 + */ VIR_DOMAIN_BLOCK_JOB_TYPE_COMMIT = 3, /* Active Block Commit (virDomainBlockCommit with flags), job - * exists as long as sync is active */ + * exists as long as sync is active + * + * Since: v1.2.6 + */ VIR_DOMAIN_BLOCK_JOB_TYPE_ACTIVE_COMMIT = 4, - /* Backup (virDomainBackupBegin) */ + /* Backup (virDomainBackupBegin) + * + * Since: v6.0.0 + */ VIR_DOMAIN_BLOCK_JOB_TYPE_BACKUP = 5, # ifdef VIR_ENUM_SENTINELS @@ -2527,7 +2635,7 @@ int virDomainBlockJobAbort(virDomainPtr dom, const char *disk, /* Flags for use with virDomainGetBlockJobInfo */ typedef enum { VIR_DOMAIN_BLOCK_JOB_INFO_BANDWIDTH_BYTES = 1 << 0, /* bandwidth in bytes/s - instead of MiB/s */ + instead of MiB/s (Since: v1.2.9) */ } virDomainBlockJobInfoFlags; /* An iterator for monitoring block job operations */ @@ -2556,7 +2664,7 @@ int virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk, /* Flags for use with virDomainBlockJobSetSpeed */ typedef enum { VIR_DOMAIN_BLOCK_JOB_SPEED_BANDWIDTH_BYTES = 1 << 0, /* bandwidth in bytes/s - instead of MiB/s */ + instead of MiB/s (Since: v1.2.9) */ } virDomainBlockJobSetSpeedFlags; int virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk, @@ -2566,7 +2674,7 @@ int virDomainBlockJobSetSpeed(virDomainPtr dom, const char *disk, * of the flags for virDomainBlockRebase) */ typedef enum { VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTES = 1 << 6, /* bandwidth in bytes/s - instead of MiB/s */ + instead of MiB/s (Since: v1.2.9) */ } virDomainBlockPullFlags; int virDomainBlockPull(virDomainPtr dom, const char *disk, @@ -2579,18 +2687,18 @@ int virDomainBlockPull(virDomainPtr dom, const char *disk, */ typedef enum { VIR_DOMAIN_BLOCK_REBASE_SHALLOW = 1 << 0, /* Limit copy to top of source - backing chain */ + backing chain (Since: v1.0.0) */ VIR_DOMAIN_BLOCK_REBASE_REUSE_EXT = 1 << 1, /* Reuse existing external - file for a copy */ - VIR_DOMAIN_BLOCK_REBASE_COPY_RAW = 1 << 2, /* Make destination file raw */ - VIR_DOMAIN_BLOCK_REBASE_COPY = 1 << 3, /* Start a copy job */ + file for a copy (Since: v1.0.0) */ + VIR_DOMAIN_BLOCK_REBASE_COPY_RAW = 1 << 2, /* Make destination file raw (Since: v1.0.0) */ + VIR_DOMAIN_BLOCK_REBASE_COPY = 1 << 3, /* Start a copy job (Since: v1.0.0) */ VIR_DOMAIN_BLOCK_REBASE_RELATIVE = 1 << 4, /* Keep backing chain referenced using relative - names */ + names (Since: v1.2.7) */ VIR_DOMAIN_BLOCK_REBASE_COPY_DEV = 1 << 5, /* Treat destination as block - device instead of file */ + device instead of file (Since: v1.2.9) */ VIR_DOMAIN_BLOCK_REBASE_BANDWIDTH_BYTES = 1 << 6, /* bandwidth in bytes/s - instead of MiB/s */ + instead of MiB/s (Since: v1.2.9) */ } virDomainBlockRebaseFlags; int virDomainBlockRebase(virDomainPtr dom, const char *disk, @@ -2603,17 +2711,20 @@ int virDomainBlockRebase(virDomainPtr dom, const char *disk, * Flags available for virDomainBlockCopy(). */ typedef enum { - /* Limit copy to top of source backing chain */ + /* Limit copy to top of source backing chain (Since: v1.2.8) */ VIR_DOMAIN_BLOCK_COPY_SHALLOW = 1 << 0, - /* Reuse existing external file for a copy */ + /* Reuse existing external file for a copy (Since: v1.2.8) */ VIR_DOMAIN_BLOCK_COPY_REUSE_EXT = 1 << 1, - /* Don't force usage of recoverable job for the copy operation */ + /* Don't force usage of recoverable job for the copy operation (Since: v3.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 */ + * the destination image, so that the copy is guaranteed to converge + * + * Since: v8.0.0 + */ VIR_DOMAIN_BLOCK_COPY_SYNCHRONOUS_WRITES = 1 << 3, } virDomainBlockCopyFlags; @@ -2669,17 +2780,17 @@ int virDomainBlockCopy(virDomainPtr dom, const char *disk, */ typedef enum { VIR_DOMAIN_BLOCK_COMMIT_SHALLOW = 1 << 0, /* NULL base means next backing - file, not whole chain */ + file, not whole chain (Since: v1.0.0) */ VIR_DOMAIN_BLOCK_COMMIT_DELETE = 1 << 1, /* Delete any files that are now invalid after their contents - have been committed */ + have been committed (Since: v1.0.0) */ VIR_DOMAIN_BLOCK_COMMIT_ACTIVE = 1 << 2, /* Allow a two-phase commit when - top is the active layer */ + top is the active layer (Since: v1.2.6) */ VIR_DOMAIN_BLOCK_COMMIT_RELATIVE = 1 << 3, /* keep the backing chain referenced using relative - names */ + names (Since: v1.2.7) */ VIR_DOMAIN_BLOCK_COMMIT_BANDWIDTH_BYTES = 1 << 4, /* bandwidth in bytes/s - instead of MiB/s */ + instead of MiB/s (Since: v1.2.9) */ } virDomainBlockCommitFlags; int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base, @@ -2864,9 +2975,9 @@ virDomainGetBlockIoTune(virDomainPtr dom, * Disk I/O error. */ typedef enum { - VIR_DOMAIN_DISK_ERROR_NONE = 0, /* no error */ - VIR_DOMAIN_DISK_ERROR_UNSPEC = 1, /* unspecified I/O error */ - VIR_DOMAIN_DISK_ERROR_NO_SPACE = 2, /* no space left on the device */ + VIR_DOMAIN_DISK_ERROR_NONE = 0, /* no error (Since: v1.0.0) */ + VIR_DOMAIN_DISK_ERROR_UNSPEC = 1, /* unspecified I/O error (Since: v1.0.0) */ + VIR_DOMAIN_DISK_ERROR_NO_SPACE = 2, /* no space left on the device (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_DISK_ERROR_LAST @@ -2951,77 +3062,77 @@ int virDomainSendKey(virDomainPtr domain, * mapping in Linux. */ typedef enum { - VIR_DOMAIN_PROCESS_SIGNAL_NOP = 0, /* No constant in POSIX/Linux */ - VIR_DOMAIN_PROCESS_SIGNAL_HUP = 1, /* SIGHUP */ - VIR_DOMAIN_PROCESS_SIGNAL_INT = 2, /* SIGINT */ - VIR_DOMAIN_PROCESS_SIGNAL_QUIT = 3, /* SIGQUIT */ - VIR_DOMAIN_PROCESS_SIGNAL_ILL = 4, /* SIGILL */ - VIR_DOMAIN_PROCESS_SIGNAL_TRAP = 5, /* SIGTRAP */ - VIR_DOMAIN_PROCESS_SIGNAL_ABRT = 6, /* SIGABRT */ - VIR_DOMAIN_PROCESS_SIGNAL_BUS = 7, /* SIGBUS */ - VIR_DOMAIN_PROCESS_SIGNAL_FPE = 8, /* SIGFPE */ - VIR_DOMAIN_PROCESS_SIGNAL_KILL = 9, /* SIGKILL */ - - VIR_DOMAIN_PROCESS_SIGNAL_USR1 = 10, /* SIGUSR1 */ - VIR_DOMAIN_PROCESS_SIGNAL_SEGV = 11, /* SIGSEGV */ - VIR_DOMAIN_PROCESS_SIGNAL_USR2 = 12, /* SIGUSR2 */ - VIR_DOMAIN_PROCESS_SIGNAL_PIPE = 13, /* SIGPIPE */ - VIR_DOMAIN_PROCESS_SIGNAL_ALRM = 14, /* SIGALRM */ - VIR_DOMAIN_PROCESS_SIGNAL_TERM = 15, /* SIGTERM */ - VIR_DOMAIN_PROCESS_SIGNAL_STKFLT = 16, /* Not in POSIX (SIGSTKFLT on Linux )*/ - VIR_DOMAIN_PROCESS_SIGNAL_CHLD = 17, /* SIGCHLD */ - VIR_DOMAIN_PROCESS_SIGNAL_CONT = 18, /* SIGCONT */ - VIR_DOMAIN_PROCESS_SIGNAL_STOP = 19, /* SIGSTOP */ - - VIR_DOMAIN_PROCESS_SIGNAL_TSTP = 20, /* SIGTSTP */ - VIR_DOMAIN_PROCESS_SIGNAL_TTIN = 21, /* SIGTTIN */ - VIR_DOMAIN_PROCESS_SIGNAL_TTOU = 22, /* SIGTTOU */ - VIR_DOMAIN_PROCESS_SIGNAL_URG = 23, /* SIGURG */ - VIR_DOMAIN_PROCESS_SIGNAL_XCPU = 24, /* SIGXCPU */ - VIR_DOMAIN_PROCESS_SIGNAL_XFSZ = 25, /* SIGXFSZ */ - VIR_DOMAIN_PROCESS_SIGNAL_VTALRM = 26, /* SIGVTALRM */ - VIR_DOMAIN_PROCESS_SIGNAL_PROF = 27, /* SIGPROF */ - VIR_DOMAIN_PROCESS_SIGNAL_WINCH = 28, /* Not in POSIX (SIGWINCH on Linux) */ - VIR_DOMAIN_PROCESS_SIGNAL_POLL = 29, /* SIGPOLL (also known as SIGIO on Linux) */ - - VIR_DOMAIN_PROCESS_SIGNAL_PWR = 30, /* Not in POSIX (SIGPWR on Linux) */ - VIR_DOMAIN_PROCESS_SIGNAL_SYS = 31, /* SIGSYS (also known as SIGUNUSED on Linux) */ - VIR_DOMAIN_PROCESS_SIGNAL_RT0 = 32, /* SIGRTMIN */ + 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 */ VIR_DOMAIN_PROCESS_SIGNAL_RT2 = 34, /* SIGRTMIN + 2 */ VIR_DOMAIN_PROCESS_SIGNAL_RT3 = 35, /* SIGRTMIN + 3 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT4 = 36, /* SIGRTMIN + 4 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT5 = 37, /* SIGRTMIN + 5 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT6 = 38, /* SIGRTMIN + 6 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT7 = 39, /* SIGRTMIN + 7 */ - - VIR_DOMAIN_PROCESS_SIGNAL_RT8 = 40, /* SIGRTMIN + 8 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT9 = 41, /* SIGRTMIN + 9 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT10 = 42, /* SIGRTMIN + 10 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT11 = 43, /* SIGRTMIN + 11 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT12 = 44, /* SIGRTMIN + 12 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT13 = 45, /* SIGRTMIN + 13 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT14 = 46, /* SIGRTMIN + 14 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT15 = 47, /* SIGRTMIN + 15 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT16 = 48, /* SIGRTMIN + 16 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT17 = 49, /* SIGRTMIN + 17 */ - - VIR_DOMAIN_PROCESS_SIGNAL_RT18 = 50, /* SIGRTMIN + 18 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT19 = 51, /* SIGRTMIN + 19 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT20 = 52, /* SIGRTMIN + 20 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT21 = 53, /* SIGRTMIN + 21 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT22 = 54, /* SIGRTMIN + 22 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT23 = 55, /* SIGRTMIN + 23 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT24 = 56, /* SIGRTMIN + 24 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT25 = 57, /* SIGRTMIN + 25 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT26 = 58, /* SIGRTMIN + 26 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT27 = 59, /* SIGRTMIN + 27 */ - - VIR_DOMAIN_PROCESS_SIGNAL_RT28 = 60, /* SIGRTMIN + 28 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT29 = 61, /* SIGRTMIN + 29 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT30 = 62, /* SIGRTMIN + 30 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT31 = 63, /* SIGRTMIN + 31 */ - VIR_DOMAIN_PROCESS_SIGNAL_RT32 = 64, /* SIGRTMIN + 32 / SIGRTMAX */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_PROCESS_SIGNAL_LAST @@ -3072,10 +3183,10 @@ typedef enum { * Details on the cause of a 'defined' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_DEFINED_ADDED = 0, /* Newly created config file */ - VIR_DOMAIN_EVENT_DEFINED_UPDATED = 1, /* Changed config file */ - VIR_DOMAIN_EVENT_DEFINED_RENAMED = 2, /* Domain was renamed */ - VIR_DOMAIN_EVENT_DEFINED_FROM_SNAPSHOT = 3, /* Config was restored from a snapshot */ + VIR_DOMAIN_EVENT_DEFINED_ADDED = 0, /* Newly created config file (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_DEFINED_UPDATED = 1, /* Changed config file (Since: v1.0.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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_DEFINED_LAST @@ -3088,8 +3199,8 @@ typedef enum { * Details on the cause of an 'undefined' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = 0, /* Deleted the config file */ - VIR_DOMAIN_EVENT_UNDEFINED_RENAMED = 1, /* Domain was renamed */ + VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = 0, /* Deleted the config file (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_UNDEFINED_RENAMED = 1, /* Domain was renamed (Since: v1.2.19) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_UNDEFINED_LAST @@ -3102,11 +3213,11 @@ typedef enum { * Details on the cause of a 'started' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_STARTED_BOOTED = 0, /* Normal startup from boot */ - VIR_DOMAIN_EVENT_STARTED_MIGRATED = 1, /* Incoming migration from another host */ - VIR_DOMAIN_EVENT_STARTED_RESTORED = 2, /* Restored from a state file */ - VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOT = 3, /* Restored from snapshot */ - VIR_DOMAIN_EVENT_STARTED_WAKEUP = 4, /* Started due to wakeup event */ + VIR_DOMAIN_EVENT_STARTED_BOOTED = 0, /* Normal startup from boot (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STARTED_MIGRATED = 1, /* Incoming migration from another host (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STARTED_RESTORED = 2, /* Restored from a state file (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOT = 3, /* Restored from snapshot (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STARTED_WAKEUP = 4, /* Started due to wakeup event (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_STARTED_LAST @@ -3119,15 +3230,15 @@ typedef enum { * Details on the cause of a 'suspended' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_SUSPENDED_PAUSED = 0, /* Normal suspend due to admin pause */ - VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED = 1, /* Suspended for offline migration */ - VIR_DOMAIN_EVENT_SUSPENDED_IOERROR = 2, /* Suspended due to a disk I/O error */ - VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG = 3, /* Suspended due to a watchdog firing */ - VIR_DOMAIN_EVENT_SUSPENDED_RESTORED = 4, /* Restored from paused state file */ - VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT = 5, /* Restored from paused snapshot */ - VIR_DOMAIN_EVENT_SUSPENDED_API_ERROR = 6, /* suspended after failure during libvirt API call */ - VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY = 7, /* suspended for post-copy migration */ - VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY_FAILED = 8, /* suspended after failed post-copy */ + VIR_DOMAIN_EVENT_SUSPENDED_PAUSED = 0, /* Normal suspend due to admin pause (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED = 1, /* Suspended for offline migration (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_SUSPENDED_IOERROR = 2, /* Suspended due to a disk I/O error (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG = 3, /* Suspended due to a watchdog firing (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_SUSPENDED_RESTORED = 4, /* Restored from paused state file (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT = 5, /* Restored from paused snapshot (Since: v1.0.0) */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_SUSPENDED_LAST @@ -3140,11 +3251,11 @@ typedef enum { * Details on the cause of a 'resumed' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_RESUMED_UNPAUSED = 0, /* Normal resume due to admin unpause */ - VIR_DOMAIN_EVENT_RESUMED_MIGRATED = 1, /* Resumed for completion of migration */ - VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT = 2, /* Resumed from snapshot */ + VIR_DOMAIN_EVENT_RESUMED_UNPAUSED = 0, /* Normal resume due to admin unpause (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_RESUMED_MIGRATED = 1, /* Resumed for completion of migration (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT = 2, /* Resumed from snapshot (Since: v1.0.0) */ VIR_DOMAIN_EVENT_RESUMED_POSTCOPY = 3, /* Resumed, but migration is still - running in post-copy mode */ + running in post-copy mode (Since: v1.3.3) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_RESUMED_LAST @@ -3157,13 +3268,13 @@ typedef enum { * Details on the cause of a 'stopped' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN = 0, /* Normal shutdown */ - VIR_DOMAIN_EVENT_STOPPED_DESTROYED = 1, /* Forced poweroff from host */ - VIR_DOMAIN_EVENT_STOPPED_CRASHED = 2, /* Guest crashed */ - VIR_DOMAIN_EVENT_STOPPED_MIGRATED = 3, /* Migrated off to another host */ - VIR_DOMAIN_EVENT_STOPPED_SAVED = 4, /* Saved to a state file */ - VIR_DOMAIN_EVENT_STOPPED_FAILED = 5, /* Host emulator/mgmt failed */ - VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT = 6, /* offline snapshot loaded */ + VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN = 0, /* Normal shutdown (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STOPPED_DESTROYED = 1, /* Forced poweroff from host (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STOPPED_CRASHED = 2, /* Guest crashed (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STOPPED_MIGRATED = 3, /* Migrated off to another host (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STOPPED_SAVED = 4, /* Saved to a state file (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STOPPED_FAILED = 5, /* Host emulator/mgmt failed (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT = 6, /* offline snapshot loaded (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_STOPPED_LAST @@ -3177,15 +3288,18 @@ typedef enum { * Details on the cause of a 'shutdown' lifecycle event */ typedef enum { - /* Guest finished shutdown sequence */ + /* Guest finished shutdown sequence (Since: v1.0.0) */ VIR_DOMAIN_EVENT_SHUTDOWN_FINISHED = 0, /* Domain finished shutting down after request from the guest itself - * (e.g. hardware-specific action) */ + * (e.g. hardware-specific action) (Since: v3.4.0) */ VIR_DOMAIN_EVENT_SHUTDOWN_GUEST = 1, /* Domain finished shutting down after request from the host (e.g. killed by - * a signal) */ + * a signal) + * + * Since: v3.4.0 + */ VIR_DOMAIN_EVENT_SHUTDOWN_HOST = 2, # ifdef VIR_ENUM_SENTINELS @@ -3199,8 +3313,8 @@ typedef enum { * Details on the cause of a 'pmsuspended' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY = 0, /* Guest was PM suspended to memory */ - VIR_DOMAIN_EVENT_PMSUSPENDED_DISK = 1, /* Guest was PM suspended to disk */ + VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY = 0, /* Guest was PM suspended to memory (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_PMSUSPENDED_DISK = 1, /* Guest was PM suspended to disk (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_PMSUSPENDED_LAST @@ -3213,8 +3327,8 @@ typedef enum { * Details on the cause of a 'crashed' lifecycle event */ typedef enum { - VIR_DOMAIN_EVENT_CRASHED_PANICKED = 0, /* Guest was panicked */ - VIR_DOMAIN_EVENT_CRASHED_CRASHLOADED = 1, /* Guest was crashloaded */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_CRASHED_LAST @@ -3227,10 +3341,10 @@ typedef enum { * Recipient of a memory failure event. */ typedef enum { - /* memory failure at hypersivor memory address space */ + /* memory failure at hypersivor memory address space (Since: v6.9.0) */ VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_HYPERVISOR = 0, - /* memory failure at guest memory address space */ + /* memory failure at guest memory address space (Since: v6.9.0) */ VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_GUEST = 1, # ifdef VIR_ENUM_SENTINELS @@ -3246,20 +3360,32 @@ typedef enum { */ typedef enum { /* the memory failure could be ignored. This will only be the case for - * action-optional failures. */ + * action-optional failures. + * + * Since: v6.9.0 + */ VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_IGNORE = 0, /* memory failure occurred in guest memory, the guest enabled MCE handling * mechanism, and hypervisor could inject the MCE into the guest - * successfully. */ + * successfully. + * + * Since: v6.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. */ + * if the recipient is the hypervisor; hypervisor will exit. + * + * Since: v6.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. */ + * the recipient is a guest which is not ready to handle memory failures. + * + * Since: v6.9.0 + */ VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_RESET = 3, # ifdef VIR_ENUM_SENTINELS @@ -3270,11 +3396,14 @@ typedef enum { typedef enum { /* whether a memory failure event is action-required or action-optional - * (e.g. a failure during memory scrub). */ + * (e.g. a failure during memory scrub). (Since: v6.9.0) */ VIR_DOMAIN_MEMORY_FAILURE_ACTION_REQUIRED = (1 << 0), /* whether the failure occurred while the previous failure was still in - * progress. */ + * progress. + * + * Since: v6.9.0 + */ VIR_DOMAIN_MEMORY_FAILURE_RECURSIVE = (1 << 1), } virDomainMemoryFailureFlags; @@ -3311,12 +3440,12 @@ int virDomainIsPersistent(virDomainPtr dom); int virDomainIsUpdated(virDomainPtr dom); typedef enum { - VIR_DOMAIN_JOB_NONE = 0, /* No job is active */ - VIR_DOMAIN_JOB_BOUNDED = 1, /* Job with a finite completion time */ - VIR_DOMAIN_JOB_UNBOUNDED = 2, /* Job without a finite completion time */ - VIR_DOMAIN_JOB_COMPLETED = 3, /* Job has finished, but isn't cleaned up */ - VIR_DOMAIN_JOB_FAILED = 4, /* Job hit error, but isn't cleaned up */ - VIR_DOMAIN_JOB_CANCELLED = 5, /* Job was aborted, but isn't cleaned up */ + VIR_DOMAIN_JOB_NONE = 0, /* No job is active (Since: v1.0.0) */ + VIR_DOMAIN_JOB_BOUNDED = 1, /* Job with a finite completion time (Since: v1.0.0) */ + VIR_DOMAIN_JOB_UNBOUNDED = 2, /* Job without a finite completion time (Since: v1.0.0) */ + VIR_DOMAIN_JOB_COMPLETED = 3, /* Job has finished, but isn't cleaned up (Since: v1.0.0) */ + VIR_DOMAIN_JOB_FAILED = 4, /* Job hit error, but isn't cleaned up (Since: v1.0.0) */ + VIR_DOMAIN_JOB_CANCELLED = 5, /* Job was aborted, but isn't cleaned up (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_JOB_LAST @@ -3367,9 +3496,9 @@ struct _virDomainJobInfo { */ typedef enum { VIR_DOMAIN_JOB_STATS_COMPLETED = 1 << 0, /* return stats of a recently - * completed job */ + * completed job (Since: v1.2.9) */ VIR_DOMAIN_JOB_STATS_KEEP_COMPLETED = 1 << 1, /* don't remove completed - stats when reading them */ + stats when reading them (Since: v6.0.0) */ } virDomainGetJobStatsFlags; int virDomainGetJobInfo(virDomainPtr dom, @@ -3388,7 +3517,7 @@ typedef enum { VIR_DOMAIN_JOB_OPERATION_RESTORE = 3, VIR_DOMAIN_JOB_OPERATION_MIGRATION_IN = 4, VIR_DOMAIN_JOB_OPERATION_MIGRATION_OUT = 5, - VIR_DOMAIN_JOB_OPERATION_SNAPSHOT = 6, + VIR_DOMAIN_JOB_OPERATION_SNAPSHOT = 6, /* Since: v3.3.0 */ VIR_DOMAIN_JOB_OPERATION_SNAPSHOT_REVERT = 7, VIR_DOMAIN_JOB_OPERATION_DUMP = 8, VIR_DOMAIN_JOB_OPERATION_BACKUP = 9, @@ -3769,13 +3898,13 @@ typedef void (*virConnectDomainEventRTCChangeCallback)(virConnectPtr conn, * The action that is to be taken due to the watchdog device firing */ typedef enum { - VIR_DOMAIN_EVENT_WATCHDOG_NONE = 0, /* No action, watchdog ignored */ - VIR_DOMAIN_EVENT_WATCHDOG_PAUSE, /* Guest CPUs are paused */ - VIR_DOMAIN_EVENT_WATCHDOG_RESET, /* Guest CPUs are reset */ - VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF, /* Guest is forcibly powered off */ - VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWN, /* Guest is requested to gracefully shutdown */ - VIR_DOMAIN_EVENT_WATCHDOG_DEBUG, /* No action, a debug message logged */ - VIR_DOMAIN_EVENT_WATCHDOG_INJECTNMI,/* Inject a non-maskable interrupt into guest */ + VIR_DOMAIN_EVENT_WATCHDOG_NONE = 0, /* No action, watchdog ignored (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_WATCHDOG_PAUSE, /* Guest CPUs are paused (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_WATCHDOG_RESET, /* Guest CPUs are reset (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF, /* Guest is forcibly powered off (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWN, /* Guest is requested to gracefully shutdown (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_WATCHDOG_DEBUG, /* No action, a debug message logged (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_WATCHDOG_INJECTNMI,/* Inject a non-maskable interrupt into guest (Since: v1.2.17) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_WATCHDOG_LAST @@ -3804,9 +3933,9 @@ typedef void (*virConnectDomainEventWatchdogCallback)(virConnectPtr conn, * The action that is to be taken due to an IO error occurring */ typedef enum { - VIR_DOMAIN_EVENT_IO_ERROR_NONE = 0, /* No action, IO error ignored */ - VIR_DOMAIN_EVENT_IO_ERROR_PAUSE, /* Guest CPUs are paused */ - VIR_DOMAIN_EVENT_IO_ERROR_REPORT, /* IO error reported to guest OS */ + VIR_DOMAIN_EVENT_IO_ERROR_NONE = 0, /* No action, IO error ignored (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_IO_ERROR_PAUSE, /* Guest CPUs are paused (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_IO_ERROR_REPORT, /* IO error reported to guest OS (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_IO_ERROR_LAST @@ -3867,9 +3996,9 @@ typedef void (*virConnectDomainEventIOErrorReasonCallback)(virConnectPtr conn, * The phase of the graphics client connection */ typedef enum { - VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = 0, /* Initial socket connection established */ - VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE, /* Authentication & setup completed */ - VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECT, /* Final socket disconnection */ + VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = 0, /* Initial socket connection established (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE, /* Authentication & setup completed (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECT, /* Final socket disconnection (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_GRAPHICS_LAST @@ -3882,9 +4011,9 @@ typedef enum { * The type of address for the connection */ typedef enum { - VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address */ - VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6, /* IPv6 address */ - VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX, /* UNIX socket path */ + VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6, /* IPv6 address (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX, /* UNIX socket path (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_LAST @@ -4017,11 +4146,17 @@ typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn, */ typedef enum { /* Removable media changed to empty according to startup policy as source - * was missing. oldSrcPath is set, newSrcPath is NULL */ + * was missing. oldSrcPath is set, newSrcPath is NULL + * + * Since: v1.0.0 + * */ 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 */ + * oldSrcPath is set, newSrcPath is NULL + * + * Since: v1.1.2 + * */ VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START = 1, # ifdef VIR_ENUM_SENTINELS @@ -4579,8 +4714,8 @@ typedef void (*virConnectDomainEventTunableCallback)(virConnectPtr conn, typedef enum { - VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_CONNECTED = 1, /* agent connected */ - VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTED = 2, /* agent disconnected */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_LAST @@ -4588,9 +4723,9 @@ typedef enum { } virConnectDomainEventAgentLifecycleState; typedef enum { - VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_UNKNOWN = 0, /* unknown state change reason */ - VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_DOMAIN_STARTED = 1, /* state changed due to domain start */ - VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_CHANNEL = 2, /* channel state changed */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_LAST @@ -4713,33 +4848,33 @@ typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPt * signature of callback function will be used. */ typedef enum { - VIR_DOMAIN_EVENT_ID_LIFECYCLE = 0, /* virConnectDomainEventCallback */ - VIR_DOMAIN_EVENT_ID_REBOOT = 1, /* virConnectDomainEventGenericCallback */ - VIR_DOMAIN_EVENT_ID_RTC_CHANGE = 2, /* virConnectDomainEventRTCChangeCallback */ - VIR_DOMAIN_EVENT_ID_WATCHDOG = 3, /* virConnectDomainEventWatchdogCallback */ - VIR_DOMAIN_EVENT_ID_IO_ERROR = 4, /* virConnectDomainEventIOErrorCallback */ - VIR_DOMAIN_EVENT_ID_GRAPHICS = 5, /* virConnectDomainEventGraphicsCallback */ - VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON = 6, /* virConnectDomainEventIOErrorReasonCallback */ - VIR_DOMAIN_EVENT_ID_CONTROL_ERROR = 7, /* virConnectDomainEventGenericCallback */ - VIR_DOMAIN_EVENT_ID_BLOCK_JOB = 8, /* virConnectDomainEventBlockJobCallback */ - VIR_DOMAIN_EVENT_ID_DISK_CHANGE = 9, /* virConnectDomainEventDiskChangeCallback */ - VIR_DOMAIN_EVENT_ID_TRAY_CHANGE = 10, /* virConnectDomainEventTrayChangeCallback */ - VIR_DOMAIN_EVENT_ID_PMWAKEUP = 11, /* virConnectDomainEventPMWakeupCallback */ - VIR_DOMAIN_EVENT_ID_PMSUSPEND = 12, /* virConnectDomainEventPMSuspendCallback */ - VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE = 13, /* virConnectDomainEventBalloonChangeCallback */ - VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK = 14, /* virConnectDomainEventPMSuspendDiskCallback */ - VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED = 15, /* virConnectDomainEventDeviceRemovedCallback */ - VIR_DOMAIN_EVENT_ID_BLOCK_JOB_2 = 16, /* virConnectDomainEventBlockJobCallback */ - VIR_DOMAIN_EVENT_ID_TUNABLE = 17, /* virConnectDomainEventTunableCallback */ - VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE = 18,/* virConnectDomainEventAgentLifecycleCallback */ - VIR_DOMAIN_EVENT_ID_DEVICE_ADDED = 19, /* virConnectDomainEventDeviceAddedCallback */ - VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION = 20, /* virConnectDomainEventMigrationIterationCallback */ - VIR_DOMAIN_EVENT_ID_JOB_COMPLETED = 21, /* virConnectDomainEventJobCompletedCallback */ - VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED = 22, /* virConnectDomainEventDeviceRemovalFailedCallback */ - VIR_DOMAIN_EVENT_ID_METADATA_CHANGE = 23, /* virConnectDomainEventMetadataChangeCallback */ - VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD = 24, /* virConnectDomainEventBlockThresholdCallback */ - VIR_DOMAIN_EVENT_ID_MEMORY_FAILURE = 25, /* virConnectDomainEventMemoryFailureCallback */ - VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGE = 26, /* virConnectDomainEventMemoryDeviceSizeChangeCallback */ + VIR_DOMAIN_EVENT_ID_LIFECYCLE = 0, /* virConnectDomainEventCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_REBOOT = 1, /* virConnectDomainEventGenericCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_RTC_CHANGE = 2, /* virConnectDomainEventRTCChangeCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_WATCHDOG = 3, /* virConnectDomainEventWatchdogCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_IO_ERROR = 4, /* virConnectDomainEventIOErrorCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_GRAPHICS = 5, /* virConnectDomainEventGraphicsCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON = 6, /* virConnectDomainEventIOErrorReasonCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_CONTROL_ERROR = 7, /* virConnectDomainEventGenericCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_BLOCK_JOB = 8, /* virConnectDomainEventBlockJobCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_DISK_CHANGE = 9, /* virConnectDomainEventDiskChangeCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_TRAY_CHANGE = 10, /* virConnectDomainEventTrayChangeCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_PMWAKEUP = 11, /* virConnectDomainEventPMWakeupCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_PMSUSPEND = 12, /* virConnectDomainEventPMSuspendCallback (Since: v1.0.0) */ + VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE = 13, /* virConnectDomainEventBalloonChangeCallback (Since: v1.0.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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_EVENT_ID_LAST @@ -4773,9 +4908,9 @@ typedef enum { VIR_DOMAIN_CONSOLE_FORCE = (1 << 0), /* abort a (possibly) active console connection to force a new - connection */ + connection (Since: v1.0.0) */ VIR_DOMAIN_CONSOLE_SAFE = (1 << 1), /* check if the console driver supports - safe console operations */ + safe console operations (Since: v1.0.0) */ } virDomainConsoleFlags; int virDomainOpenConsole(virDomainPtr dom, @@ -4791,7 +4926,7 @@ int virDomainOpenConsole(virDomainPtr dom, typedef enum { VIR_DOMAIN_CHANNEL_FORCE = (1 << 0), /* abort a (possibly) active channel connection to force a new - connection */ + connection (Since: v1.0.2) */ } virDomainChannelFlags; int virDomainOpenChannel(virDomainPtr dom, @@ -4857,7 +4992,7 @@ int virDomainGetTime(virDomainPtr dom, unsigned int flags); typedef enum { - VIR_DOMAIN_TIME_SYNC = (1 << 0), /* Re-sync domain time from domain's RTC */ + VIR_DOMAIN_TIME_SYNC = (1 << 0), /* Re-sync domain time from domain's RTC (Since: v1.2.5) */ } virDomainSetTimeFlags; int virDomainSetTime(virDomainPtr dom, @@ -4998,9 +5133,9 @@ typedef struct _virTypedParameter virMemoryParameter; typedef virMemoryParameter *virMemoryParameterPtr; typedef enum { - VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE = 0, /* Parse DHCP lease file */ - VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENT = 1, /* Query qemu guest agent */ - VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_ARP = 2, /* Query ARP tables */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LAST @@ -5032,7 +5167,7 @@ int virDomainInterfaceAddresses(virDomainPtr dom, void virDomainInterfaceFree(virDomainInterfacePtr iface); typedef enum { - VIR_DOMAIN_PASSWORD_ENCRYPTED = 1 << 0, /* the password is already encrypted */ + VIR_DOMAIN_PASSWORD_ENCRYPTED = 1 << 0, /* the password is already encrypted (Since: v1.2.16) */ } virDomainSetUserPasswordFlags; int virDomainSetUserPassword(virDomainPtr dom, @@ -5076,7 +5211,7 @@ typedef enum { typedef enum { VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY = 0, - VIR_DOMAIN_LIFECYCLE_ACTION_RESTART = 1, + VIR_DOMAIN_LIFECYCLE_ACTION_RESTART = 1, /* Since: v3.9.0 */ VIR_DOMAIN_LIFECYCLE_ACTION_RESTART_RENAME = 2, VIR_DOMAIN_LIFECYCLE_ACTION_PRESERVE = 3, VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_DESTROY = 4, @@ -5178,13 +5313,13 @@ int virDomainSetLaunchSecurityState(virDomainPtr domain, unsigned int flags); typedef enum { - VIR_DOMAIN_GUEST_INFO_USERS = (1 << 0), /* return active users */ - VIR_DOMAIN_GUEST_INFO_OS = (1 << 1), /* return OS information */ - VIR_DOMAIN_GUEST_INFO_TIMEZONE = (1 << 2), /* return timezone information */ - VIR_DOMAIN_GUEST_INFO_HOSTNAME = (1 << 3), /* return hostname information */ - VIR_DOMAIN_GUEST_INFO_FILESYSTEM = (1 << 4), /* return filesystem information */ - VIR_DOMAIN_GUEST_INFO_DISKS = (1 << 5), /* return disks information */ - VIR_DOMAIN_GUEST_INFO_INTERFACES = (1 << 6), /* return interfaces information */ + 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) */ } virDomainGuestInfoTypes; int virDomainGetGuestInfo(virDomainPtr domain, @@ -5205,7 +5340,7 @@ int virDomainAgentSetResponseTimeout(virDomainPtr domain, typedef enum { VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNAL = (1 << 0), /* reuse separately - provided images */ + provided images (Since: v6.0.0) */ } virDomainBackupBeginFlags; int virDomainBackupBegin(virDomainPtr domain, @@ -5222,8 +5357,8 @@ int virDomainAuthorizedSSHKeysGet(virDomainPtr domain, unsigned int flags); typedef enum { - VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_APPEND = (1 << 0), /* don't truncate file, just append */ - VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_REMOVE = (1 << 1), /* remove keys, instead of adding them */ + 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) */ } virDomainAuthorizedSSHKeysSetFlags; @@ -5249,11 +5384,11 @@ int virDomainGetMessages(virDomainPtr domain, */ typedef enum { VIR_DOMAIN_DIRTYRATE_UNSTARTED = 0, /* the dirtyrate calculation has - not been started */ + not been started (Since: v7.2.0) */ VIR_DOMAIN_DIRTYRATE_MEASURING = 1, /* the dirtyrate calculation is - measuring */ + measuring (Since: v7.2.0) */ VIR_DOMAIN_DIRTYRATE_MEASURED = 2, /* the dirtyrate calculation is - completed */ + completed (Since: v7.2.0) */ # ifdef VIR_ENUM_SENTINELS VIR_DOMAIN_DIRTYRATE_LAST @@ -5268,9 +5403,9 @@ typedef enum { * */ typedef enum { - VIR_DOMAIN_DIRTYRATE_MODE_PAGE_SAMPLING = 0, /* default mode - page-sampling */ - VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_BITMAP = 1 << 0, /* dirty-bitmap mode */ - VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_RING = 1 << 1, /* dirty-ring mode */ + 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) */ } virDomainDirtyRateCalcFlags; int virDomainStartDirtyRateCalc(virDomainPtr domain, diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index 8081d9e39d..f6a9588568 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -56,7 +56,7 @@ typedef enum { VIR_NODE_SUSPEND_TARGET_HYBRID = 2, # ifdef VIR_ENUM_SENTINELS - VIR_NODE_SUSPEND_TARGET_LAST /* This constant is subject to change */ + VIR_NODE_SUSPEND_TARGET_LAST /* This constant is subject to change (Since: v1.0.0) */ # endif } virNodeSuspendTarget; @@ -499,24 +499,24 @@ int virNodeGetSEVInfo (virConnectPtr conn, * Flags when opening a connection to a hypervisor */ typedef enum { - VIR_CONNECT_RO = (1 << 0), /* A readonly connection */ - VIR_CONNECT_NO_ALIASES = (1 << 1), /* Don't try to resolve URI aliases */ + VIR_CONNECT_RO = (1 << 0), /* A readonly connection (Since: v1.0.0) */ + VIR_CONNECT_NO_ALIASES = (1 << 1), /* Don't try to resolve URI aliases (Since: v1.0.0) */ } virConnectFlags; typedef enum { - VIR_CRED_USERNAME = 1, /* Identity to act as */ - VIR_CRED_AUTHNAME = 2, /* Identify to authorize as */ - VIR_CRED_LANGUAGE = 3, /* RFC 1766 languages, comma separated */ - VIR_CRED_CNONCE = 4, /* client supplies a nonce */ - VIR_CRED_PASSPHRASE = 5, /* Passphrase secret */ - VIR_CRED_ECHOPROMPT = 6, /* Challenge response */ + VIR_CRED_USERNAME = 1, /* Identity to act as (Since: v1.0.0) */ + VIR_CRED_AUTHNAME = 2, /* Identify to authorize as (Since: v1.0.0) */ + VIR_CRED_LANGUAGE = 3, /* RFC 1766 languages, comma separated (Since: v1.0.0) */ + VIR_CRED_CNONCE = 4, /* client supplies a nonce (Since: v1.0.0) */ + VIR_CRED_PASSPHRASE = 5, /* Passphrase secret (Since: v1.0.0) */ + VIR_CRED_ECHOPROMPT = 6, /* Challenge response (Since: v1.0.0) */ VIR_CRED_NOECHOPROMPT = 7, /* Challenge response */ - VIR_CRED_REALM = 8, /* Authentication realm */ - VIR_CRED_EXTERNAL = 9, /* Externally managed credential */ + VIR_CRED_REALM = 8, /* Authentication realm (Since: v1.0.0) */ + VIR_CRED_EXTERNAL = 9, /* Externally managed credential (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS - VIR_CRED_LAST /* More may be added - expect the unexpected */ + VIR_CRED_LAST /* More may be added - expect the unexpected (Since: v1.0.0) */ # endif } virConnectCredentialType; @@ -782,9 +782,9 @@ typedef enum { typedef enum { VIR_CONNECT_COMPARE_CPU_FAIL_INCOMPATIBLE = (1 << 0), /* treat incompatible - CPUs as failure */ + CPUs as failure (Since: v1.2.6) */ VIR_CONNECT_COMPARE_CPU_VALIDATE_XML = (1 << 1), /* validate the xml - document */ + document (Since: v6.9.0) */ } virConnectCompareCPUFlags; int virConnectCompareCPU(virConnectPtr conn, @@ -809,8 +809,8 @@ int virConnectGetCPUModelNames(virConnectPtr conn, * Flags when getting XML description of a computed CPU */ typedef enum { - VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES = (1 << 0), /* show all features */ - VIR_CONNECT_BASELINE_CPU_MIGRATABLE = (1 << 1), /* filter out non-migratable features */ + 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) */ } virConnectBaselineCPUFlags; char *virConnectBaselineCPU(virConnectPtr conn, @@ -837,10 +837,10 @@ int virNodeGetFreePages(virConnectPtr conn, typedef enum { VIR_NODE_ALLOC_PAGES_ADD = 0, /* Add @pageCounts to the pages pool. This - can be used only to size up the pool. */ + can be used only to size up the pool. (Since: v1.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. */ + used to free allocated pages. (Since: v1.2.9) */ } virNodeAllocPagesFlags; int virNodeAllocPages(virConnectPtr conn, diff --git a/include/libvirt/libvirt-interface.h b/include/libvirt/libvirt-interface.h index 803cb33ffe..289c3d0b07 100644 --- a/include/libvirt/libvirt-interface.h +++ b/include/libvirt/libvirt-interface.h @@ -76,11 +76,11 @@ const char* virInterfaceGetName (virInterfacePtr iface); const char* virInterfaceGetMACString (virInterfacePtr iface); typedef enum { - VIR_INTERFACE_XML_INACTIVE = 1 << 0 /* dump inactive interface information */ + VIR_INTERFACE_XML_INACTIVE = 1 << 0 /* dump inactive interface information (Since: v1.0.0) */ } virInterfaceXMLFlags; typedef enum { - VIR_INTERFACE_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_INTERFACE_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virInterfaceDefineFlags; char * virInterfaceGetXMLDesc (virInterfacePtr iface, diff --git a/include/libvirt/libvirt-network.h b/include/libvirt/libvirt-network.h index 80bd03878b..4868a49427 100644 --- a/include/libvirt/libvirt-network.h +++ b/include/libvirt/libvirt-network.h @@ -28,7 +28,7 @@ # endif typedef enum { - VIR_NETWORK_XML_INACTIVE = (1 << 0), /* dump inactive network information */ + VIR_NETWORK_XML_INACTIVE = (1 << 0), /* dump inactive network information (Since: v1.0.0) */ } virNetworkXMLFlags; /** @@ -114,7 +114,7 @@ virNetworkPtr virNetworkLookupByUUIDString (virConnectPtr conn, const char *uuid); typedef enum { - VIR_NETWORK_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_NETWORK_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.8.0) */ } virNetworkCreateFlags; /* @@ -127,7 +127,7 @@ virNetworkPtr virNetworkCreateXMLFlags(virConnectPtr conn, unsigned int flags); typedef enum { - VIR_NETWORK_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_NETWORK_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virNetworkDefineFlags; /* @@ -152,11 +152,11 @@ int virNetworkUndefine (virNetworkPtr network); * */ typedef enum { - VIR_NETWORK_UPDATE_COMMAND_NONE = 0, /* (invalid) */ - VIR_NETWORK_UPDATE_COMMAND_MODIFY = 1, /* modify an existing element */ - VIR_NETWORK_UPDATE_COMMAND_DELETE = 2, /* delete an existing element */ - VIR_NETWORK_UPDATE_COMMAND_ADD_LAST = 3, /* add an element at end of list */ - VIR_NETWORK_UPDATE_COMMAND_ADD_FIRST = 4, /* add an element at start of list */ + VIR_NETWORK_UPDATE_COMMAND_NONE = 0, /* (invalid (Since: v1.0.0)) */ + VIR_NETWORK_UPDATE_COMMAND_MODIFY = 1, /* modify an existing element (Since: v1.0.0) */ + VIR_NETWORK_UPDATE_COMMAND_DELETE = 2, /* delete an existing element (Since: v1.0.0) */ + VIR_NETWORK_UPDATE_COMMAND_ADD_LAST = 3, /* add an element at end of list (Since: v1.0.0) */ + VIR_NETWORK_UPDATE_COMMAND_ADD_FIRST = 4, /* add an element at start of list (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_NETWORK_UPDATE_COMMAND_LAST # endif @@ -170,19 +170,19 @@ typedef enum { * */ typedef enum { - VIR_NETWORK_SECTION_NONE = 0, /* (invalid) */ - VIR_NETWORK_SECTION_BRIDGE = 1, /* <bridge> */ - VIR_NETWORK_SECTION_DOMAIN = 2, /* <domain> */ + VIR_NETWORK_SECTION_NONE = 0, /* (invalid (Since: v1.0.0)) */ + VIR_NETWORK_SECTION_BRIDGE = 1, /* <bridge> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_DOMAIN = 2, /* <domain> (Since: v1.0.0) */ VIR_NETWORK_SECTION_IP = 3, /* <ip> */ - VIR_NETWORK_SECTION_IP_DHCP_HOST = 4, /* <ip>/<dhcp>/<host> */ - VIR_NETWORK_SECTION_IP_DHCP_RANGE = 5, /* <ip>/<dhcp>/<range> */ + VIR_NETWORK_SECTION_IP_DHCP_HOST = 4, /* <ip>/<dhcp>/<host> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_IP_DHCP_RANGE = 5, /* <ip>/<dhcp>/<range> (Since: v1.0.0) */ VIR_NETWORK_SECTION_FORWARD = 6, /* <forward> */ - VIR_NETWORK_SECTION_FORWARD_INTERFACE = 7, /* <forward>/<interface> */ - VIR_NETWORK_SECTION_FORWARD_PF = 8, /* <forward>/<pf> */ - VIR_NETWORK_SECTION_PORTGROUP = 9, /* <portgroup> */ - VIR_NETWORK_SECTION_DNS_HOST = 10, /* <dns>/<host> */ - VIR_NETWORK_SECTION_DNS_TXT = 11, /* <dns>/<txt> */ - VIR_NETWORK_SECTION_DNS_SRV = 12, /* <dns>/<srv> */ + VIR_NETWORK_SECTION_FORWARD_INTERFACE = 7, /* <forward>/<interface> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_FORWARD_PF = 8, /* <forward>/<pf> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_PORTGROUP = 9, /* <portgroup> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_DNS_HOST = 10, /* <dns>/<host> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_DNS_TXT = 11, /* <dns>/<txt> (Since: v1.0.0) */ + VIR_NETWORK_SECTION_DNS_SRV = 12, /* <dns>/<srv> (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_NETWORK_SECTION_LAST # endif @@ -195,9 +195,9 @@ typedef enum { */ typedef enum { VIR_NETWORK_UPDATE_AFFECT_CURRENT = 0, /* affect live if network is active, - config if it's not active */ - VIR_NETWORK_UPDATE_AFFECT_LIVE = 1 << 0, /* affect live state of network only */ - VIR_NETWORK_UPDATE_AFFECT_CONFIG = 1 << 1, /* affect persistent config only */ + config if it's not active (Since: v1.0.0) */ + VIR_NETWORK_UPDATE_AFFECT_LIVE = 1 << 0, /* affect live state of network only (Since: v1.0.0) */ + VIR_NETWORK_UPDATE_AFFECT_CONFIG = 1 << 1, /* affect persistent config only (Since: v1.0.0) */ } virNetworkUpdateFlags; /* @@ -294,7 +294,7 @@ typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn, * signature of callback function will be used. */ typedef enum { - VIR_NETWORK_EVENT_ID_LIFECYCLE = 0, /* virConnectNetworkEventLifecycleCallback */ + VIR_NETWORK_EVENT_ID_LIFECYCLE = 0, /* virConnectNetworkEventLifecycleCallback (Since: v1.2.1) */ # ifdef VIR_ENUM_SENTINELS VIR_NETWORK_EVENT_ID_LAST @@ -373,8 +373,8 @@ virNetworkPortLookupByUUIDString(virNetworkPtr net, const char *uuidstr); typedef enum { - VIR_NETWORK_PORT_CREATE_RECLAIM = (1 << 0), /* reclaim existing used resources */ - VIR_NETWORK_PORT_CREATE_VALIDATE = (1 << 1), /* Validate the XML document against schema */ + 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) */ } virNetworkPortCreateFlags; virNetworkPortPtr diff --git a/include/libvirt/libvirt-nodedev.h b/include/libvirt/libvirt-nodedev.h index 8efcd7f506..de398a1767 100644 --- a/include/libvirt/libvirt-nodedev.h +++ b/include/libvirt/libvirt-nodedev.h @@ -63,31 +63,31 @@ int virNodeListDevices (virConnectPtr conn, * Flags used to filter either by capability or active state, the * returned node devices. */ typedef enum { - VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM = 1 << 0, /* System capability */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEV = 1 << 1, /* PCI device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_DEV = 1 << 2, /* USB device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_INTERFACE = 1 << 3, /* USB interface */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_NET = 1 << 4, /* Network device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_HOST = 1 << 5, /* SCSI Host Bus Adapter */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_TARGET = 1 << 6, /* SCSI Target */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI = 1 << 7, /* SCSI device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_STORAGE = 1 << 8, /* Storage device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_FC_HOST = 1 << 9, /* FC Host Bus Adapter */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPORTS = 1 << 10, /* Capable of vport */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_GENERIC = 1 << 11, /* Capable of scsi_generic */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_DRM = 1 << 12, /* DRM device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV_TYPES = 1 << 13, /* Capable of mediated devices */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV = 1 << 14, /* Mediated device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCW_DEV = 1 << 15, /* CCW device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_CSS_DEV = 1 << 16, /* CSS device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_VDPA = 1 << 17, /* vDPA device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_CARD = 1 << 18, /* s390 AP Card device */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_QUEUE = 1 << 19, /* s390 AP Queue */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_MATRIX = 1 << 20, /* s390 AP Matrix */ - VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPD = 1 << 21, /* Device with VPD */ - - VIR_CONNECT_LIST_NODE_DEVICES_INACTIVE = 1 << 30, /* Inactive devices */ - VIR_CONNECT_LIST_NODE_DEVICES_ACTIVE = 1U << 31, /* Active devices */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM = 1 << 0, /* System capability (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEV = 1 << 1, /* PCI device (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_DEV = 1 << 2, /* USB device (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_INTERFACE = 1 << 3, /* USB interface (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_NET = 1 << 4, /* Network device (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_HOST = 1 << 5, /* SCSI Host Bus Adapter (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_TARGET = 1 << 6, /* SCSI Target (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI = 1 << 7, /* SCSI device (Since: v1.0.0) */ + VIR_CONNECT_LIST_NODE_DEVICES_CAP_STORAGE = 1 << 8, /* Storage device (Since: v1.0.0) */ + 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) */ } virConnectListAllNodeDeviceFlags; int virConnectListAllNodeDevices (virConnectPtr conn, @@ -167,8 +167,8 @@ int virNodeDeviceIsActive(virNodeDevicePtr dev); * signature of callback function will be used. */ typedef enum { - VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE = 0, /* virConnectNodeDeviceEventLifecycleCallback */ - VIR_NODE_DEVICE_EVENT_ID_UPDATE = 1, /* virConnectNodeDeviceEventGenericCallback */ + VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE = 0, /* virConnectNodeDeviceEventLifecycleCallback (Since: v2.2.0) */ + VIR_NODE_DEVICE_EVENT_ID_UPDATE = 1, /* virConnectNodeDeviceEventGenericCallback (Since: v2.2.0) */ # ifdef VIR_ENUM_SENTINELS VIR_NODE_DEVICE_EVENT_ID_LAST diff --git a/include/libvirt/libvirt-nwfilter.h b/include/libvirt/libvirt-nwfilter.h index 4e28801006..aa8872e156 100644 --- a/include/libvirt/libvirt-nwfilter.h +++ b/include/libvirt/libvirt-nwfilter.h @@ -81,7 +81,7 @@ virNWFilterPtr virNWFilterLookupByUUIDString (virConnectPtr conn, const char *uuid); typedef enum { - VIR_NWFILTER_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_NWFILTER_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virNWFilterDefineFlags; /* @@ -109,7 +109,7 @@ int virNWFilterFree (virNWFilterPtr nwfilter); */ typedef enum { - VIR_NWFILTER_BINDING_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_NWFILTER_BINDING_CREATE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.8.0) */ } virNWFilterBindingCreateFlags; const char* virNWFilterGetName (virNWFilterPtr nwfilter); diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-secret.h index 82e18b8611..6134989369 100644 --- a/include/libvirt/libvirt-secret.h +++ b/include/libvirt/libvirt-secret.h @@ -69,12 +69,12 @@ int virConnectListSecrets (virConnectPtr conn, */ typedef enum { VIR_CONNECT_LIST_SECRETS_EPHEMERAL = 1 << 0, /* kept in memory, never - stored persistently */ + stored persistently (Since: v1.0.0) */ VIR_CONNECT_LIST_SECRETS_NO_EPHEMERAL = 1 << 1, VIR_CONNECT_LIST_SECRETS_PRIVATE = 1 << 2, /* not revealed to any caller of libvirt, nor to any other - node */ + node (Since: v1.0.0) */ VIR_CONNECT_LIST_SECRETS_NO_PRIVATE = 1 << 3, } virConnectListAllSecretsFlags; @@ -90,7 +90,7 @@ virSecretPtr virSecretLookupByUsage(virConnectPtr conn, const char *usageID); typedef enum { - VIR_SECRET_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_SECRET_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virSecretDefineFlags; virSecretPtr virSecretDefineXML (virConnectPtr conn, @@ -131,8 +131,8 @@ int virSecretFree (virSecretPtr secret); * signature of callback function will be used. */ typedef enum { - VIR_SECRET_EVENT_ID_LIFECYCLE = 0, /* virConnectSecretEventLifecycleCallback */ - VIR_SECRET_EVENT_ID_VALUE_CHANGED = 1, /* virConnectSecretEventGenericCallback */ + VIR_SECRET_EVENT_ID_LIFECYCLE = 0, /* virConnectSecretEventLifecycleCallback (Since: v3.0.0) */ + VIR_SECRET_EVENT_ID_VALUE_CHANGED = 1, /* virConnectSecretEventGenericCallback (Since: v3.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_SECRET_EVENT_ID_LAST diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h index bee738880d..e7265fe772 100644 --- a/include/libvirt/libvirt-storage.h +++ b/include/libvirt/libvirt-storage.h @@ -45,11 +45,11 @@ typedef virStoragePool *virStoragePoolPtr; typedef enum { - VIR_STORAGE_POOL_INACTIVE = 0, /* Not running */ - VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available */ - VIR_STORAGE_POOL_RUNNING = 2, /* Running normally */ - VIR_STORAGE_POOL_DEGRADED = 3, /* Running degraded */ - VIR_STORAGE_POOL_INACCESSIBLE = 4, /* Running, but not accessible */ + VIR_STORAGE_POOL_INACTIVE = 0, /* Not running (Since: v1.0.0) */ + VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available (Since: v1.0.0) */ + VIR_STORAGE_POOL_RUNNING = 2, /* Running normally (Since: v1.0.0) */ + VIR_STORAGE_POOL_DEGRADED = 3, /* Running degraded (Since: v1.0.0) */ + VIR_STORAGE_POOL_INACCESSIBLE = 4, /* Running, but not accessible (Since: v1.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_STORAGE_POOL_STATE_LAST @@ -57,33 +57,39 @@ typedef enum { } virStoragePoolState; typedef enum { - VIR_STORAGE_POOL_BUILD_NEW = 0, /* Regular build from scratch */ - VIR_STORAGE_POOL_BUILD_REPAIR = (1 << 0), /* Repair / reinitialize */ - VIR_STORAGE_POOL_BUILD_RESIZE = (1 << 1), /* Extend existing pool */ - VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = (1 << 2), /* Do not overwrite existing pool */ - VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data */ + VIR_STORAGE_POOL_BUILD_NEW = 0, /* Regular build from scratch (Since: v1.0.0) */ + VIR_STORAGE_POOL_BUILD_REPAIR = (1 << 0), /* Repair / reinitialize (Since: v1.0.0) */ + VIR_STORAGE_POOL_BUILD_RESIZE = (1 << 1), /* Extend existing pool (Since: v1.0.0) */ + VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = (1 << 2), /* Do not overwrite existing pool (Since: v1.0.0) */ + VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data (Since: v1.0.0) */ } virStoragePoolBuildFlags; typedef enum { - VIR_STORAGE_POOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) */ - VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) */ + VIR_STORAGE_POOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: v1.0.0) */ + VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: v1.0.0) */ } virStoragePoolDeleteFlags; typedef enum { - /* Create the pool but do not perform pool build */ + /* Create the pool but do not perform pool build (Since: v1.3.1) */ VIR_STORAGE_POOL_CREATE_NORMAL = 0, - /* Create the pool and perform pool build without any flags */ + /* Create the pool and perform pool build without any flags (Since: v1.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 */ + * exclusive to VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE + * + * Since: v1.3.1 + */ VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITE = 1 << 1, /* Create the pool and perform pool build using the * VIR_STORAGE_POOL_BUILD_NO_OVERWRITE flag. This is mutually - * exclusive to VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITE */ + * exclusive to VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITE + * + * Since: v1.3.1 + */ VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE = 1 << 2, } virStoragePoolCreateFlags; @@ -116,13 +122,13 @@ typedef virStorageVol *virStorageVolPtr; typedef enum { - VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes */ - VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes */ - VIR_STORAGE_VOL_DIR = 2, /* Directory-passthrough based volume */ - VIR_STORAGE_VOL_NETWORK = 3, /* Network volumes like RBD (RADOS Block Device) */ + VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes (Since: v1.0.0) */ + VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes (Since: v1.0.0) */ + VIR_STORAGE_VOL_DIR = 2, /* Directory-passthrough based volume (Since: v1.0.0) */ + VIR_STORAGE_VOL_NETWORK = 3, /* Network volumes like RBD (RADOS Block Device) (Since: v1.0.0) */ VIR_STORAGE_VOL_NETDIR = 4, /* Network accessible directory that can - * contain other network volumes */ - VIR_STORAGE_VOL_PLOOP = 5, /* Ploop based volumes */ + * contain other network volumes (Since: v1.2.0) */ + VIR_STORAGE_VOL_PLOOP = 5, /* Ploop based volumes (Since: v1.3.4) */ # ifdef VIR_ENUM_SENTINELS VIR_STORAGE_VOL_LAST @@ -130,32 +136,32 @@ typedef enum { } virStorageVolType; typedef enum { - VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) */ - VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) */ - VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTS = 1 << 1, /* Force removal of volume, even if in use */ + VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: v1.0.0) */ + VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: v1.0.0) */ + VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTS = 1 << 1, /* Force removal of volume, even if in use (Since: v1.2.21) */ } virStorageVolDeleteFlags; typedef enum { - VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes */ + VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes (Since: v1.0.0) */ VIR_STORAGE_VOL_WIPE_ALG_NNSA = 1, /* 4-pass NNSA Policy Letter - NAP-14.1-C (XVI-8) */ + NAP-14.1-C (XVI-8) (Since: v1.0.0) */ VIR_STORAGE_VOL_WIPE_ALG_DOD = 2, /* 4-pass DoD 5220.22-M section - 8-306 procedure */ + 8-306 procedure (Since: v1.0.0) */ VIR_STORAGE_VOL_WIPE_ALG_BSI = 3, /* 9-pass method recommended by the German Center of Security in - Information Technologies */ - VIR_STORAGE_VOL_WIPE_ALG_GUTMANN = 4, /* The canonical 35-pass sequence */ + Information Technologies (Since: v1.0.0) */ + VIR_STORAGE_VOL_WIPE_ALG_GUTMANN = 4, /* The canonical 35-pass sequence (Since: v1.0.0) */ VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER = 5, /* 7-pass method described by Bruce Schneier in "Applied - Cryptography" (1996) */ - VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7 = 6, /* 7-pass random */ + Cryptography" (1996) (Since: v1.0.0) */ + VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7 = 6, /* 7-pass random (Since: v1.0.0) */ - VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = 7, /* 33-pass random */ + VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = 7, /* 33-pass random (Since: v1.0.0) */ - VIR_STORAGE_VOL_WIPE_ALG_RANDOM = 8, /* 1-pass random */ + VIR_STORAGE_VOL_WIPE_ALG_RANDOM = 8, /* 1-pass random (Since: v1.0.0) */ VIR_STORAGE_VOL_WIPE_ALG_TRIM = 9, /* 1-pass, trim all data on the - volume by using TRIM or DISCARD */ + volume by using TRIM or DISCARD (Since: v1.3.2) */ # ifdef VIR_ENUM_SENTINELS VIR_STORAGE_VOL_WIPE_ALG_LAST @@ -186,7 +192,7 @@ struct _virStorageVolInfo { typedef virStorageVolInfo *virStorageVolInfoPtr; typedef enum { - VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information */ + VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information (Since: v1.0.0) */ } virStorageXMLFlags; /* @@ -273,7 +279,7 @@ virStoragePoolPtr virStoragePoolLookupByTargetPath(virConnectPtr conn, const char *path); typedef enum { - VIR_STORAGE_POOL_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema */ + VIR_STORAGE_POOL_DEFINE_VALIDATE = 1 << 0, /* Validate the XML document against schema (Since: v7.7.0) */ } virStoragePoolDefineFlags; /* @@ -347,7 +353,7 @@ const char* virStorageVolGetKey (virStorageVolPtr vol); typedef enum { VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA = 1 << 0, - VIR_STORAGE_VOL_CREATE_REFLINK = 1 << 1, /* perform a btrfs lightweight copy */ + VIR_STORAGE_VOL_CREATE_REFLINK = 1 << 1, /* perform a btrfs lightweight copy (Since: v1.2.13) */ } virStorageVolCreateFlags; virStorageVolPtr virStorageVolCreateXML (virStoragePoolPtr pool, @@ -359,7 +365,7 @@ virStorageVolPtr virStorageVolCreateXMLFrom (virStoragePoolPtr pool, unsigned int flags); typedef enum { - VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream */ + VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: v3.4.0) */ } virStorageVolDownloadFlags; int virStorageVolDownload (virStorageVolPtr vol, @@ -368,7 +374,7 @@ int virStorageVolDownload (virStorageVolPtr vol, unsigned long long length, unsigned int flags); typedef enum { - VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream */ + VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM = 1 << 0, /* Use sparse stream (Since: v3.4.0) */ } virStorageVolUploadFlags; int virStorageVolUpload (virStorageVolPtr vol, @@ -397,9 +403,9 @@ char * virStorageVolGetXMLDesc (virStorageVolPtr pool, char * virStorageVolGetPath (virStorageVolPtr vol); typedef enum { - VIR_STORAGE_VOL_RESIZE_ALLOCATE = 1 << 0, /* force allocation of new size */ - VIR_STORAGE_VOL_RESIZE_DELTA = 1 << 1, /* size is relative to current */ - VIR_STORAGE_VOL_RESIZE_SHRINK = 1 << 2, /* allow decrease in capacity */ + VIR_STORAGE_VOL_RESIZE_ALLOCATE = 1 << 0, /* force allocation of new size (Since: v1.0.0) */ + VIR_STORAGE_VOL_RESIZE_DELTA = 1 << 1, /* size is relative to current (Since: v1.0.0) */ + VIR_STORAGE_VOL_RESIZE_SHRINK = 1 << 2, /* allow decrease in capacity (Since: v1.0.0) */ } virStorageVolResizeFlags; int virStorageVolResize (virStorageVolPtr vol, @@ -425,8 +431,8 @@ int virStoragePoolIsPersistent(virStoragePoolPtr pool); * signature of callback function will be used. */ typedef enum { - VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE = 0, /* virConnectStoragePoolEventLifecycleCallback */ - VIR_STORAGE_POOL_EVENT_ID_REFRESH = 1, /* virConnectStoragePoolEventGenericCallback */ + VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE = 0, /* virConnectStoragePoolEventLifecycleCallback (Since: v2.0.0) */ + VIR_STORAGE_POOL_EVENT_ID_REFRESH = 1, /* virConnectStoragePoolEventGenericCallback (Since: v2.0.0) */ # ifdef VIR_ENUM_SENTINELS VIR_STORAGE_POOL_EVENT_ID_LAST diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h index 57986931fd..5cdcf17dd9 100644 --- a/include/libvirt/virterror.h +++ b/include/libvirt/virterror.h @@ -37,8 +37,8 @@ extern "C" { */ typedef enum { VIR_ERR_NONE = 0, - VIR_ERR_WARNING = 1, /* A simple warning */ - VIR_ERR_ERROR = 2 /* An error */ + VIR_ERR_WARNING = 1, /* A simple warning (Since: v1.0.0) */ + VIR_ERR_ERROR = 2 /* An error (Since: v1.0.0) */ } virErrorLevel; /** @@ -49,94 +49,94 @@ typedef enum { */ typedef enum { VIR_FROM_NONE = 0, - VIR_FROM_XEN = 1, /* Error at Xen hypervisor layer */ - VIR_FROM_XEND = 2, /* Error at connection with xend daemon */ - VIR_FROM_XENSTORE = 3, /* Error at connection with xen store */ - VIR_FROM_SEXPR = 4, /* Error in the S-Expression code */ - - VIR_FROM_XML = 5, /* Error in the XML code */ - VIR_FROM_DOM = 6, /* Error when operating on a domain */ - VIR_FROM_RPC = 7, /* Error in the XML-RPC code */ + VIR_FROM_XEN = 1, /* Error at Xen hypervisor layer (Since: v1.0.0) */ + VIR_FROM_XEND = 2, /* Error at connection with xend daemon (Since: v1.0.0) */ + VIR_FROM_XENSTORE = 3, /* Error at connection with xen store (Since: v1.0.0) */ + VIR_FROM_SEXPR = 4, /* Error in the S-Expression code (Since: v1.0.0) */ + + VIR_FROM_XML = 5, /* Error in the XML code (Since: v1.0.0) */ + VIR_FROM_DOM = 6, /* Error when operating on a domain (Since: v1.0.0) */ + VIR_FROM_RPC = 7, /* Error in the XML-RPC code (Since: v1.0.0) */ VIR_FROM_PROXY = 8, /* Error in the proxy code; unused since - 0.8.6 */ - VIR_FROM_CONF = 9, /* Error in the configuration file handling */ - - VIR_FROM_QEMU = 10, /* Error at the QEMU daemon */ - VIR_FROM_NET = 11, /* Error when operating on a network */ - VIR_FROM_TEST = 12, /* Error from test driver */ - VIR_FROM_REMOTE = 13, /* Error from remote driver */ - VIR_FROM_OPENVZ = 14, /* Error from OpenVZ driver */ - - VIR_FROM_XENXM = 15, /* Error at Xen XM layer */ - VIR_FROM_STATS_LINUX = 16, /* Error in the Linux Stats code */ - VIR_FROM_LXC = 17, /* Error from Linux Container driver */ - VIR_FROM_STORAGE = 18, /* Error from storage driver */ - VIR_FROM_NETWORK = 19, /* Error from network config */ - - VIR_FROM_DOMAIN = 20, /* Error from domain config */ - VIR_FROM_UML = 21, /* Error at the UML driver; unused since 5.0.0 */ - VIR_FROM_NODEDEV = 22, /* Error from node device monitor */ - VIR_FROM_XEN_INOTIFY = 23, /* Error from xen inotify layer */ - VIR_FROM_SECURITY = 24, /* Error from security framework */ - - VIR_FROM_VBOX = 25, /* Error from VirtualBox driver */ - VIR_FROM_INTERFACE = 26, /* Error when operating on an interface */ + 0.8.6 (Since: v1.0.0) */ + VIR_FROM_CONF = 9, /* Error in the configuration file handling (Since: v1.0.0) */ + + VIR_FROM_QEMU = 10, /* Error at the QEMU daemon (Since: v1.0.0) */ + VIR_FROM_NET = 11, /* Error when operating on a network (Since: v1.0.0) */ + VIR_FROM_TEST = 12, /* Error from test driver (Since: v1.0.0) */ + VIR_FROM_REMOTE = 13, /* Error from remote driver (Since: v1.0.0) */ + VIR_FROM_OPENVZ = 14, /* Error from OpenVZ driver (Since: v1.0.0) */ + + VIR_FROM_XENXM = 15, /* Error at Xen XM layer (Since: v1.0.0) */ + VIR_FROM_STATS_LINUX = 16, /* Error in the Linux Stats code (Since: v1.0.0) */ + VIR_FROM_LXC = 17, /* Error from Linux Container driver (Since: v1.0.0) */ + VIR_FROM_STORAGE = 18, /* Error from storage driver (Since: v1.0.0) */ + VIR_FROM_NETWORK = 19, /* Error from network config (Since: v1.0.0) */ + + VIR_FROM_DOMAIN = 20, /* Error from domain config (Since: v1.0.0) */ + VIR_FROM_UML = 21, /* Error at the UML driver; unused since 5.0.0 (Since: v1.0.0) */ + VIR_FROM_NODEDEV = 22, /* Error from node device monitor (Since: v1.0.0) */ + VIR_FROM_XEN_INOTIFY = 23, /* Error from xen inotify layer (Since: v1.0.0) */ + VIR_FROM_SECURITY = 24, /* Error from security framework (Since: v1.0.0) */ + + VIR_FROM_VBOX = 25, /* Error from VirtualBox driver (Since: v1.0.0) */ + VIR_FROM_INTERFACE = 26, /* Error when operating on an interface (Since: v1.0.0) */ VIR_FROM_ONE = 27, /* The OpenNebula driver no longer exists. - Retained for ABI/API compat only */ - VIR_FROM_ESX = 28, /* Error from ESX driver */ - VIR_FROM_PHYP = 29, /* Error from the phyp driver, unused since 6.0.0 */ - - VIR_FROM_SECRET = 30, /* Error from secret storage */ - VIR_FROM_CPU = 31, /* Error from CPU driver */ - VIR_FROM_XENAPI = 32, /* Error from XenAPI */ - VIR_FROM_NWFILTER = 33, /* Error from network filter driver */ - VIR_FROM_HOOK = 34, /* Error from Synchronous hooks */ - - VIR_FROM_DOMAIN_SNAPSHOT = 35,/* Error from domain snapshot */ - VIR_FROM_AUDIT = 36, /* Error from auditing subsystem */ - VIR_FROM_SYSINFO = 37, /* Error from sysinfo/SMBIOS */ - VIR_FROM_STREAMS = 38, /* Error from I/O streams */ - VIR_FROM_VMWARE = 39, /* Error from VMware driver */ - - VIR_FROM_EVENT = 40, /* Error from event loop impl */ - VIR_FROM_LIBXL = 41, /* Error from libxenlight driver */ - VIR_FROM_LOCKING = 42, /* Error from lock manager */ - VIR_FROM_HYPERV = 43, /* Error from Hyper-V driver */ - VIR_FROM_CAPABILITIES = 44, /* Error from capabilities */ - - VIR_FROM_URI = 45, /* Error from URI handling */ - VIR_FROM_AUTH = 46, /* Error from auth handling */ - VIR_FROM_DBUS = 47, /* Error from DBus */ - VIR_FROM_PARALLELS = 48, /* Error from Parallels */ - VIR_FROM_DEVICE = 49, /* Error from Device */ - - VIR_FROM_SSH = 50, /* Error from libssh2 connection transport */ - VIR_FROM_LOCKSPACE = 51, /* Error from lockspace */ - VIR_FROM_INITCTL = 52, /* Error from initctl device communication */ - VIR_FROM_IDENTITY = 53, /* Error from identity code */ - VIR_FROM_CGROUP = 54, /* Error from cgroups */ - - VIR_FROM_ACCESS = 55, /* Error from access control manager */ - VIR_FROM_SYSTEMD = 56, /* Error from systemd code */ - VIR_FROM_BHYVE = 57, /* Error from bhyve driver */ - VIR_FROM_CRYPTO = 58, /* Error from crypto code */ - VIR_FROM_FIREWALL = 59, /* Error from firewall */ - - VIR_FROM_POLKIT = 60, /* Error from polkit code */ - VIR_FROM_THREAD = 61, /* Error from thread utils */ - VIR_FROM_ADMIN = 62, /* Error from admin backend */ - VIR_FROM_LOGGING = 63, /* Error from log manager */ - VIR_FROM_XENXL = 64, /* Error from Xen xl config code */ - - VIR_FROM_PERF = 65, /* Error from perf */ - VIR_FROM_LIBSSH = 66, /* Error from libssh connection transport */ - VIR_FROM_RESCTRL = 67, /* Error from resource control */ - VIR_FROM_FIREWALLD = 68, /* Error from firewalld */ - VIR_FROM_DOMAIN_CHECKPOINT = 69, /* Error from domain checkpoint */ - - VIR_FROM_TPM = 70, /* Error from TPM */ - VIR_FROM_BPF = 71, /* Error from BPF code */ - VIR_FROM_CH = 72, /* Error from Cloud-Hypervisor driver */ + Retained for ABI/API compat only (Since: v1.0.0) */ + VIR_FROM_ESX = 28, /* Error from ESX driver (Since: v1.0.0) */ + VIR_FROM_PHYP = 29, /* Error from the phyp driver, unused since 6.0.0 (Since: v1.0.0) */ + + VIR_FROM_SECRET = 30, /* Error from secret storage (Since: v1.0.0) */ + VIR_FROM_CPU = 31, /* Error from CPU driver (Since: v1.0.0) */ + VIR_FROM_XENAPI = 32, /* Error from XenAPI (Since: v1.0.0) */ + VIR_FROM_NWFILTER = 33, /* Error from network filter driver (Since: v1.0.0) */ + VIR_FROM_HOOK = 34, /* Error from Synchronous hooks (Since: v1.0.0) */ + + VIR_FROM_DOMAIN_SNAPSHOT = 35,/* Error from domain snapshot (Since: v1.0.0) */ + VIR_FROM_AUDIT = 36, /* Error from auditing subsystem (Since: v1.0.0) */ + VIR_FROM_SYSINFO = 37, /* Error from sysinfo/SMBIOS (Since: v1.0.0) */ + VIR_FROM_STREAMS = 38, /* Error from I/O streams (Since: v1.0.0) */ + VIR_FROM_VMWARE = 39, /* Error from VMware driver (Since: v1.0.0) */ + + VIR_FROM_EVENT = 40, /* Error from event loop impl (Since: v1.0.0) */ + VIR_FROM_LIBXL = 41, /* Error from libxenlight driver (Since: v1.0.0) */ + VIR_FROM_LOCKING = 42, /* Error from lock manager (Since: v1.0.0) */ + VIR_FROM_HYPERV = 43, /* Error from Hyper-V driver (Since: v1.0.0) */ + VIR_FROM_CAPABILITIES = 44, /* Error from capabilities (Since: v1.0.0) */ + + VIR_FROM_URI = 45, /* Error from URI handling (Since: v1.0.0) */ + VIR_FROM_AUTH = 46, /* Error from auth handling (Since: v1.0.0) */ + VIR_FROM_DBUS = 47, /* Error from DBus (Since: v1.0.0) */ + VIR_FROM_PARALLELS = 48, /* Error from Parallels (Since: v1.0.0) */ + VIR_FROM_DEVICE = 49, /* Error from Device (Since: v1.0.0) */ + + VIR_FROM_SSH = 50, /* Error from libssh2 connection transport (Since: v1.0.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) */ # ifdef VIR_ENUM_SENTINELS VIR_ERR_DOMAIN_LAST @@ -208,133 +208,133 @@ struct _virError { */ typedef enum { VIR_ERR_OK = 0, - VIR_ERR_INTERNAL_ERROR = 1, /* internal error */ - VIR_ERR_NO_MEMORY = 2, /* memory allocation failure */ - VIR_ERR_NO_SUPPORT = 3, /* no support for this function */ - VIR_ERR_UNKNOWN_HOST = 4, /* could not resolve hostname */ - VIR_ERR_NO_CONNECT = 5, /* can't connect to hypervisor */ - VIR_ERR_INVALID_CONN = 6, /* invalid connection object */ - VIR_ERR_INVALID_DOMAIN = 7, /* invalid domain object */ - VIR_ERR_INVALID_ARG = 8, /* invalid function argument */ - VIR_ERR_OPERATION_FAILED = 9, /* a command to hypervisor failed */ - VIR_ERR_GET_FAILED = 10, /* a HTTP GET command to failed */ - VIR_ERR_POST_FAILED = 11, /* a HTTP POST command to failed */ - VIR_ERR_HTTP_ERROR = 12, /* unexpected HTTP error code */ - VIR_ERR_SEXPR_SERIAL = 13, /* failure to serialize an S-Expr */ + VIR_ERR_INTERNAL_ERROR = 1, /* internal error (Since: v1.0.0) */ + VIR_ERR_NO_MEMORY = 2, /* memory allocation failure (Since: v1.0.0) */ + VIR_ERR_NO_SUPPORT = 3, /* no support for this function (Since: v1.0.0) */ + VIR_ERR_UNKNOWN_HOST = 4, /* could not resolve hostname (Since: v1.0.0) */ + VIR_ERR_NO_CONNECT = 5, /* can't connect to hypervisor (Since: v1.0.0) */ + VIR_ERR_INVALID_CONN = 6, /* invalid connection object (Since: v1.0.0) */ + VIR_ERR_INVALID_DOMAIN = 7, /* invalid domain object (Since: v1.0.0) */ + VIR_ERR_INVALID_ARG = 8, /* invalid function argument (Since: v1.0.0) */ + VIR_ERR_OPERATION_FAILED = 9, /* a command to hypervisor failed (Since: v1.0.0) */ + VIR_ERR_GET_FAILED = 10, /* a HTTP GET command to failed (Since: v1.0.0) */ + VIR_ERR_POST_FAILED = 11, /* a HTTP POST command to failed (Since: v1.0.0) */ + VIR_ERR_HTTP_ERROR = 12, /* unexpected HTTP error code (Since: v1.0.0) */ + VIR_ERR_SEXPR_SERIAL = 13, /* failure to serialize an S-Expr (Since: v1.0.0) */ VIR_ERR_NO_XEN = 14, /* could not open Xen hypervisor - control */ - VIR_ERR_XEN_CALL = 15, /* failure doing an hypervisor call */ - VIR_ERR_OS_TYPE = 16, /* unknown OS type */ - VIR_ERR_NO_KERNEL = 17, /* missing kernel information */ - VIR_ERR_NO_ROOT = 18, /* missing root device information */ - VIR_ERR_NO_SOURCE = 19, /* missing source device information */ - VIR_ERR_NO_TARGET = 20, /* missing target device information */ - VIR_ERR_NO_NAME = 21, /* missing domain name information */ - VIR_ERR_NO_OS = 22, /* missing domain OS information */ - VIR_ERR_NO_DEVICE = 23, /* missing domain devices information */ - VIR_ERR_NO_XENSTORE = 24, /* could not open Xen Store control */ - VIR_ERR_DRIVER_FULL = 25, /* too many drivers registered */ + control (Since: v1.0.0) */ + VIR_ERR_XEN_CALL = 15, /* failure doing an hypervisor call (Since: v1.0.0) */ + VIR_ERR_OS_TYPE = 16, /* unknown OS type (Since: v1.0.0) */ + VIR_ERR_NO_KERNEL = 17, /* missing kernel information (Since: v1.0.0) */ + VIR_ERR_NO_ROOT = 18, /* missing root device information (Since: v1.0.0) */ + VIR_ERR_NO_SOURCE = 19, /* missing source device information (Since: v1.0.0) */ + VIR_ERR_NO_TARGET = 20, /* missing target device information (Since: v1.0.0) */ + VIR_ERR_NO_NAME = 21, /* missing domain name information (Since: v1.0.0) */ + VIR_ERR_NO_OS = 22, /* missing domain OS information (Since: v1.0.0) */ + VIR_ERR_NO_DEVICE = 23, /* missing domain devices information (Since: v1.0.0) */ + VIR_ERR_NO_XENSTORE = 24, /* could not open Xen Store control (Since: v1.0.0) */ + VIR_ERR_DRIVER_FULL = 25, /* too many drivers registered (Since: v1.0.0) */ VIR_ERR_CALL_FAILED = 26, /* not supported by the drivers - (DEPRECATED) */ + (DEPRECATED) (Since: v1.0.0) */ VIR_ERR_XML_ERROR = 27, /* an XML description is not well - formed or broken */ - VIR_ERR_DOM_EXIST = 28, /* the domain already exist */ + formed or broken (Since: v1.0.0) */ + VIR_ERR_DOM_EXIST = 28, /* the domain already exist (Since: v1.0.0) */ VIR_ERR_OPERATION_DENIED = 29, /* operation forbidden on read-only - connections */ - VIR_ERR_OPEN_FAILED = 30, /* failed to open a conf file */ - VIR_ERR_READ_FAILED = 31, /* failed to read a conf file */ - VIR_ERR_PARSE_FAILED = 32, /* failed to parse a conf file */ + connections (Since: v1.0.0) */ + VIR_ERR_OPEN_FAILED = 30, /* failed to open a conf file (Since: v1.0.0) */ + VIR_ERR_READ_FAILED = 31, /* failed to read a conf file (Since: v1.0.0) */ + VIR_ERR_PARSE_FAILED = 32, /* failed to parse a conf file (Since: v1.0.0) */ VIR_ERR_CONF_SYNTAX = 33, /* failed to parse the syntax of a - conf file */ - VIR_ERR_WRITE_FAILED = 34, /* failed to write a conf file */ - VIR_ERR_XML_DETAIL = 35, /* detail of an XML error */ - VIR_ERR_INVALID_NETWORK = 36, /* invalid network object */ - VIR_ERR_NETWORK_EXIST = 37, /* the network already exist */ - VIR_ERR_SYSTEM_ERROR = 38, /* general system call failure */ - VIR_ERR_RPC = 39, /* some sort of RPC error */ - VIR_ERR_GNUTLS_ERROR = 40, /* error from a GNUTLS call */ - VIR_WAR_NO_NETWORK = 41, /* failed to start network */ + conf file (Since: v1.0.0) */ + VIR_ERR_WRITE_FAILED = 34, /* failed to write a conf file (Since: v1.0.0) */ + VIR_ERR_XML_DETAIL = 35, /* detail of an XML error (Since: v1.0.0) */ + VIR_ERR_INVALID_NETWORK = 36, /* invalid network object (Since: v1.0.0) */ + VIR_ERR_NETWORK_EXIST = 37, /* the network already exist (Since: v1.0.0) */ + VIR_ERR_SYSTEM_ERROR = 38, /* general system call failure (Since: v1.0.0) */ + VIR_ERR_RPC = 39, /* some sort of RPC error (Since: v1.0.0) */ + VIR_ERR_GNUTLS_ERROR = 40, /* error from a GNUTLS call (Since: v1.0.0) */ + VIR_WAR_NO_NETWORK = 41, /* failed to start network (Since: v1.0.0) */ VIR_ERR_NO_DOMAIN = 42, /* domain not found or unexpectedly - disappeared */ - VIR_ERR_NO_NETWORK = 43, /* network not found */ - VIR_ERR_INVALID_MAC = 44, /* invalid MAC address */ - VIR_ERR_AUTH_FAILED = 45, /* authentication failed */ - VIR_ERR_INVALID_STORAGE_POOL = 46, /* invalid storage pool object */ - VIR_ERR_INVALID_STORAGE_VOL = 47, /* invalid storage vol object */ - VIR_WAR_NO_STORAGE = 48, /* failed to start storage */ - VIR_ERR_NO_STORAGE_POOL = 49, /* storage pool not found */ - VIR_ERR_NO_STORAGE_VOL = 50, /* storage volume not found */ - VIR_WAR_NO_NODE = 51, /* failed to start node driver */ - VIR_ERR_INVALID_NODE_DEVICE = 52, /* invalid node device object */ - VIR_ERR_NO_NODE_DEVICE = 53, /* node device not found */ - VIR_ERR_NO_SECURITY_MODEL = 54, /* security model not found */ + disappeared (Since: v1.0.0) */ + VIR_ERR_NO_NETWORK = 43, /* network not found (Since: v1.0.0) */ + VIR_ERR_INVALID_MAC = 44, /* invalid MAC address (Since: v1.0.0) */ + VIR_ERR_AUTH_FAILED = 45, /* authentication failed (Since: v1.0.0) */ + VIR_ERR_INVALID_STORAGE_POOL = 46, /* invalid storage pool object (Since: v1.0.0) */ + VIR_ERR_INVALID_STORAGE_VOL = 47, /* invalid storage vol object (Since: v1.0.0) */ + VIR_WAR_NO_STORAGE = 48, /* failed to start storage (Since: v1.0.0) */ + VIR_ERR_NO_STORAGE_POOL = 49, /* storage pool not found (Since: v1.0.0) */ + VIR_ERR_NO_STORAGE_VOL = 50, /* storage volume not found (Since: v1.0.0) */ + VIR_WAR_NO_NODE = 51, /* failed to start node driver (Since: v1.0.0) */ + VIR_ERR_INVALID_NODE_DEVICE = 52, /* invalid node device object (Since: v1.0.0) */ + VIR_ERR_NO_NODE_DEVICE = 53, /* node device not found (Since: v1.0.0) */ + VIR_ERR_NO_SECURITY_MODEL = 54, /* security model not found (Since: v1.0.0) */ VIR_ERR_OPERATION_INVALID = 55, /* operation is not applicable at this - time */ - VIR_WAR_NO_INTERFACE = 56, /* failed to start interface driver */ - VIR_ERR_NO_INTERFACE = 57, /* interface driver not running */ - VIR_ERR_INVALID_INTERFACE = 58, /* invalid interface object */ + time (Since: v1.0.0) */ + VIR_WAR_NO_INTERFACE = 56, /* failed to start interface driver (Since: v1.0.0) */ + VIR_ERR_NO_INTERFACE = 57, /* interface driver not running (Since: v1.0.0) */ + VIR_ERR_INVALID_INTERFACE = 58, /* invalid interface object (Since: v1.0.0) */ VIR_ERR_MULTIPLE_INTERFACES = 59, /* more than one matching interface - found */ - VIR_WAR_NO_NWFILTER = 60, /* failed to start nwfilter driver */ - VIR_ERR_INVALID_NWFILTER = 61, /* invalid nwfilter object */ - VIR_ERR_NO_NWFILTER = 62, /* nw filter pool not found */ + found (Since: v1.0.0) */ + VIR_WAR_NO_NWFILTER = 60, /* failed to start nwfilter driver (Since: v1.0.0) */ + VIR_ERR_INVALID_NWFILTER = 61, /* invalid nwfilter object (Since: v1.0.0) */ + VIR_ERR_NO_NWFILTER = 62, /* nw filter pool not found (Since: v1.0.0) */ VIR_ERR_BUILD_FIREWALL = 63, /* nw filter pool not found */ - VIR_WAR_NO_SECRET = 64, /* failed to start secret storage */ - VIR_ERR_INVALID_SECRET = 65, /* invalid secret */ - VIR_ERR_NO_SECRET = 66, /* secret not found */ + VIR_WAR_NO_SECRET = 64, /* failed to start secret storage (Since: v1.0.0) */ + VIR_ERR_INVALID_SECRET = 65, /* invalid secret (Since: v1.0.0) */ + VIR_ERR_NO_SECRET = 66, /* secret not found (Since: v1.0.0) */ VIR_ERR_CONFIG_UNSUPPORTED = 67, /* unsupported configuration - construct */ - VIR_ERR_OPERATION_TIMEOUT = 68, /* timeout occurred during operation */ + construct (Since: v1.0.0) */ + VIR_ERR_OPERATION_TIMEOUT = 68, /* timeout occurred during operation (Since: v1.0.0) */ VIR_ERR_MIGRATE_PERSIST_FAILED = 69,/* a migration worked, but making the - VM persist on the dest host failed */ - VIR_ERR_HOOK_SCRIPT_FAILED = 70, /* a synchronous hook script failed */ - VIR_ERR_INVALID_DOMAIN_SNAPSHOT = 71,/* invalid domain snapshot */ - VIR_ERR_NO_DOMAIN_SNAPSHOT = 72, /* domain snapshot not found */ - VIR_ERR_INVALID_STREAM = 73, /* stream pointer not valid */ + VM persist on the dest host failed (Since: v1.0.0) */ + VIR_ERR_HOOK_SCRIPT_FAILED = 70, /* a synchronous hook script failed (Since: v1.0.0) */ + VIR_ERR_INVALID_DOMAIN_SNAPSHOT = 71,/* invalid domain snapshot (Since: v1.0.0) */ + VIR_ERR_NO_DOMAIN_SNAPSHOT = 72, /* domain snapshot not found (Since: v1.0.0) */ + VIR_ERR_INVALID_STREAM = 73, /* stream pointer not valid (Since: v1.0.0) */ VIR_ERR_ARGUMENT_UNSUPPORTED = 74, /* valid API use but unsupported by - the given driver */ - VIR_ERR_STORAGE_PROBE_FAILED = 75, /* storage pool probe failed */ - VIR_ERR_STORAGE_POOL_BUILT = 76, /* storage pool already built */ + the given driver (Since: v1.0.0) */ + VIR_ERR_STORAGE_PROBE_FAILED = 75, /* storage pool probe failed (Since: v1.0.0) */ + VIR_ERR_STORAGE_POOL_BUILT = 76, /* storage pool already built (Since: v1.0.0) */ VIR_ERR_SNAPSHOT_REVERT_RISKY = 77, /* force was not requested for a - risky domain snapshot revert */ + risky domain snapshot revert (Since: v1.0.0) */ VIR_ERR_OPERATION_ABORTED = 78, /* operation on a domain was - canceled/aborted by user */ - VIR_ERR_AUTH_CANCELLED = 79, /* authentication cancelled */ - VIR_ERR_NO_DOMAIN_METADATA = 80, /* The metadata is not present */ - VIR_ERR_MIGRATE_UNSAFE = 81, /* Migration is not safe */ - VIR_ERR_OVERFLOW = 82, /* integer overflow */ - VIR_ERR_BLOCK_COPY_ACTIVE = 83, /* action prevented by block copy job */ + canceled/aborted by user (Since: v1.0.0) */ + VIR_ERR_AUTH_CANCELLED = 79, /* authentication cancelled (Since: v1.0.0) */ + VIR_ERR_NO_DOMAIN_METADATA = 80, /* The metadata is not present (Since: v1.0.0) */ + VIR_ERR_MIGRATE_UNSAFE = 81, /* Migration is not safe (Since: v1.0.0) */ + VIR_ERR_OVERFLOW = 82, /* integer overflow (Since: v1.0.0) */ + VIR_ERR_BLOCK_COPY_ACTIVE = 83, /* action prevented by block copy job (Since: v1.0.0) */ VIR_ERR_OPERATION_UNSUPPORTED = 84, /* The requested operation is not - supported */ - VIR_ERR_SSH = 85, /* error in ssh transport driver */ + supported (Since: v1.0.0) */ + VIR_ERR_SSH = 85, /* error in ssh transport driver (Since: v1.0.0) */ VIR_ERR_AGENT_UNRESPONSIVE = 86, /* guest agent is unresponsive, - not running or not usable */ - VIR_ERR_RESOURCE_BUSY = 87, /* resource is already in use */ + not running or not usable (Since: v1.0.0) */ + VIR_ERR_RESOURCE_BUSY = 87, /* resource is already in use (Since: v1.0.0) */ VIR_ERR_ACCESS_DENIED = 88, /* operation on the object/resource - was denied */ - VIR_ERR_DBUS_SERVICE = 89, /* error from a dbus service */ - VIR_ERR_STORAGE_VOL_EXIST = 90, /* the storage vol already exists */ - VIR_ERR_CPU_INCOMPATIBLE = 91, /* given CPU is incompatible with host CPU */ - VIR_ERR_XML_INVALID_SCHEMA = 92, /* XML document doesn't validate against schema */ - VIR_ERR_MIGRATE_FINISH_OK = 93, /* Finish API succeeded but it is expected to return NULL */ - VIR_ERR_AUTH_UNAVAILABLE = 94, /* authentication unavailable */ - VIR_ERR_NO_SERVER = 95, /* Server was not found */ - VIR_ERR_NO_CLIENT = 96, /* Client was not found */ + 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) */ VIR_ERR_AGENT_UNSYNCED = 97, /* guest agent replies with wrong id - to guest-sync command (DEPRECATED) */ - VIR_ERR_LIBSSH = 98, /* error in libssh transport driver */ - VIR_ERR_DEVICE_MISSING = 99, /* fail to find the desired device */ - VIR_ERR_INVALID_NWFILTER_BINDING = 100, /* invalid nwfilter binding */ - VIR_ERR_NO_NWFILTER_BINDING = 101, /* no nwfilter binding */ - VIR_ERR_INVALID_DOMAIN_CHECKPOINT = 102, /* invalid domain checkpoint */ - VIR_ERR_NO_DOMAIN_CHECKPOINT = 103, /* domain checkpoint not found */ - VIR_ERR_NO_DOMAIN_BACKUP = 104, /* domain backup job id not found */ - VIR_ERR_INVALID_NETWORK_PORT = 105, /* invalid network port object */ - VIR_ERR_NETWORK_PORT_EXIST = 106, /* the network port already exist */ - VIR_ERR_NO_NETWORK_PORT = 107, /* network port not found */ - VIR_ERR_NO_HOSTNAME = 108, /* no domain's hostname found */ - VIR_ERR_CHECKPOINT_INCONSISTENT = 109, /* checkpoint can't be used */ - VIR_ERR_MULTIPLE_DOMAINS = 110, /* more than one matching domain found */ + 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) */ # ifdef VIR_ENUM_SENTINELS VIR_ERR_NUMBER_LAST -- 2.35.1

Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-qemu.h | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/include/libvirt/libvirt-qemu.h b/include/libvirt/libvirt-qemu.h index 98f2ac3823..24bf67998b 100644 --- a/include/libvirt/libvirt-qemu.h +++ b/include/libvirt/libvirt-qemu.h @@ -32,7 +32,7 @@ extern "C" { typedef enum { VIR_DOMAIN_QEMU_MONITOR_COMMAND_DEFAULT = 0, - VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP = (1 << 0), /* cmd is in HMP */ + VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP = (1 << 0), /* cmd is in HMP (Since: v1.0.0) */ } virDomainQemuMonitorCommandFlags; int virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd, @@ -85,10 +85,10 @@ typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn, typedef enum { - /* Event filter is a regex rather than a literal string */ + /* Event filter is a regex rather than a literal string (Since: v1.2.3) */ VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_REGEX = (1 << 0), - /* Event filter is case insensitive */ + /* Event filter is case insensitive (Since: v1.2.3) */ VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_NOCASE = (1 << 1), } virConnectDomainQemuMonitorEventRegisterFlags; -- 2.35.1

Minor style changes by hand. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain.h | 636 +++++++++++++++++++++++++++++- include/libvirt/libvirt-host.h | 123 ++++++ include/libvirt/libvirt-network.h | 24 ++ include/libvirt/libvirt-nodedev.h | 3 + include/libvirt/libvirt-secret.h | 3 + include/libvirt/libvirt-storage.h | 3 + 6 files changed, 786 insertions(+), 6 deletions(-) diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index c3dd4d33c0..4983494a0b 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -313,6 +313,9 @@ typedef enum { * * Macro represents proportional weight of the scheduler used on the * host cpu, when using the posix scheduler, as a ullong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_CPU_SHARES "cpu_shares" @@ -321,6 +324,9 @@ 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 + * */ # define VIR_DOMAIN_SCHEDULER_GLOBAL_PERIOD "global_period" @@ -329,6 +335,9 @@ 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 + * */ # define VIR_DOMAIN_SCHEDULER_GLOBAL_QUOTA "global_quota" @@ -337,6 +346,9 @@ typedef enum { * * Macro represents the enforcement period for a quota, in microseconds, * for vcpus only, when using the posix scheduler, as a ullong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_VCPU_PERIOD "vcpu_period" @@ -345,6 +357,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_VCPU_QUOTA "vcpu_quota" @@ -354,6 +369,9 @@ typedef enum { * Macro represents the enforcement period for a quota in microseconds, * when using the posix scheduler, for all emulator activity not tied to * vcpus, as a ullong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_EMULATOR_PERIOD "emulator_period" @@ -363,6 +381,9 @@ typedef enum { * Macro represents the maximum bandwidth to be used within a period for * all emulator activity not tied to vcpus, when using the posix scheduler, * as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_EMULATOR_QUOTA "emulator_quota" @@ -371,6 +392,9 @@ 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 + * */ # define VIR_DOMAIN_SCHEDULER_IOTHREAD_PERIOD "iothread_period" @@ -379,6 +403,9 @@ 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 + * */ # define VIR_DOMAIN_SCHEDULER_IOTHREAD_QUOTA "iothread_quota" @@ -387,6 +414,9 @@ typedef enum { * * Macro represents the relative weight, when using the credit * scheduler, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_WEIGHT "weight" @@ -395,6 +425,9 @@ typedef enum { * * Macro represents the maximum scheduler cap, when using the credit * scheduler, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_CAP "cap" @@ -403,6 +436,9 @@ typedef enum { * * Macro represents the scheduler reservation value, when using the * allocation scheduler, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_RESERVATION "reservation" @@ -411,6 +447,9 @@ typedef enum { * * Macro represents the scheduler limit value, when using the * allocation scheduler, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_LIMIT "limit" @@ -419,6 +458,9 @@ typedef enum { * * Macro represents the scheduler shares value, when using the * allocation scheduler, as an int. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SCHEDULER_SHARES "shares" @@ -477,6 +519,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro providing the field length of parameter names when using * virDomainBlockStatsFlags(). + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH @@ -485,6 +530,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total number of read bytes of the * block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_READ_BYTES "rd_bytes" @@ -493,6 +541,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total read requests of the * block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_READ_REQ "rd_operations" @@ -501,6 +552,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total time spend on cache reads in * nano-seconds of the block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_READ_TOTAL_TIMES "rd_total_times" @@ -509,6 +563,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total number of write bytes of the * block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_WRITE_BYTES "wr_bytes" @@ -517,6 +574,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total write requests of the * block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_WRITE_REQ "wr_operations" @@ -525,6 +585,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total time spend on cache writes in * nano-seconds of the block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_WRITE_TOTAL_TIMES "wr_total_times" @@ -533,6 +596,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total flush requests of the * block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_FLUSH_REQ "flush_operations" @@ -541,6 +607,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * * Macro represents the total time spend on cache flushing in * nano-seconds of the block device, as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_FLUSH_TOTAL_TIMES "flush_total_times" @@ -548,6 +617,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * VIR_DOMAIN_BLOCK_STATS_ERRS: * * In Xen this returns the mysterious 'oo_req', as an llong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_STATS_ERRS "errs" @@ -969,6 +1041,9 @@ typedef enum { * required to transmit migration data. * * This field may not be used when VIR_MIGRATE_TUNNELLED flag is set. + * + * Since: v1.1.0 + * */ # define VIR_MIGRATE_PARAM_URI "migrate_uri" @@ -979,6 +1054,9 @@ typedef enum { * destination host as VIR_TYPED_PARAM_STRING. Omitting this parameter keeps * 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 + * */ # define VIR_MIGRATE_PARAM_DEST_NAME "destination_name" @@ -998,6 +1076,9 @@ typedef enum { * Omitting this parameter keeps the original domain configuration. Using this * field with hypervisors that do not support changing domain configuration * during migration will result in a failure. + * + * Since: v1.1.0 + * */ # define VIR_MIGRATE_PARAM_DEST_XML "destination_xml" @@ -1013,6 +1094,9 @@ typedef enum { * Omitting this parameter keeps the original domain persistent configuration. * Using this field with hypervisors that do not support changing domain * configuration during migration will result in a failure. + * + * Since: v1.3.4 + * */ # define VIR_MIGRATE_PARAM_PERSIST_XML "persistent_xml" @@ -1023,6 +1107,9 @@ typedef enum { * be used for migration as VIR_TYPED_PARAM_ULLONG. If set to 0 or omitted, * 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 + * */ # define VIR_MIGRATE_PARAM_BANDWIDTH "bandwidth" @@ -1032,6 +1119,9 @@ typedef enum { * virDomainMigrate* params field: the maximum bandwidth (in MiB/s) that will * 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 + * */ # define VIR_MIGRATE_PARAM_BANDWIDTH_POSTCOPY "bandwidth.postcopy" @@ -1053,6 +1143,9 @@ typedef enum { * parameters are "tlsPort" and "tlsSubject". For example, * * spice://target.host.com:1234/?tlsPort=4567 + * + * Since: v1.1.0 + * */ # define VIR_MIGRATE_PARAM_GRAPHICS_URI "graphics_uri" @@ -1064,6 +1157,9 @@ typedef enum { * addresses are accepted as well as hostnames (the resolving is done on * destination). Some hypervisors do not support this feature and will return * an error if this field is used. + * + * Since: v1.1.4 + * */ # define VIR_MIGRATE_PARAM_LISTEN_ADDRESS "listen_address" @@ -1073,6 +1169,9 @@ typedef enum { * virDomainMigrate* params multiple field: The multiple values that list * 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 + * */ # define VIR_MIGRATE_PARAM_MIGRATE_DISKS "migrate_disks" @@ -1083,6 +1182,9 @@ typedef enum { * for incoming disks migration. Type is VIR_TYPED_PARAM_INT. If set to 0 or * omitted, libvirt will choose a suitable default. At the moment this is only * supported by the QEMU driver. + * + * Since: v1.3.3 + * */ # define VIR_MIGRATE_PARAM_DISKS_PORT "disks_port" @@ -1096,6 +1198,9 @@ typedef enum { * currently only supported by the QEMU driver. UNIX URI is only usable if the * 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 + * */ # define VIR_MIGRATE_PARAM_DISKS_URI "disks_uri" @@ -1106,6 +1211,9 @@ typedef enum { * compress migration traffic. Supported compression methods: xbzrle, mt. * The parameter may be specified multiple times if more than one method * should be used. + * + * Since: v1.3.4 + * */ # define VIR_MIGRATE_PARAM_COMPRESSION "compression" @@ -1115,6 +1223,9 @@ typedef enum { * virDomainMigrate* params field: the level of compression for multithread * 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 + * */ # define VIR_MIGRATE_PARAM_COMPRESSION_MT_LEVEL "compression.mt.level" @@ -1123,6 +1234,9 @@ typedef enum { * * virDomainMigrate* params field: the number of compression threads for * multithread compression as VIR_TYPED_PARAM_INT. + * + * Since: v1.3.4 + * */ # define VIR_MIGRATE_PARAM_COMPRESSION_MT_THREADS "compression.mt.threads" @@ -1131,6 +1245,9 @@ typedef enum { * * virDomainMigrate* params field: the number of decompression threads for * multithread compression as VIR_TYPED_PARAM_INT. + * + * Since: v1.3.4 + * */ # define VIR_MIGRATE_PARAM_COMPRESSION_MT_DTHREADS "compression.mt.dthreads" @@ -1139,6 +1256,9 @@ typedef enum { * * virDomainMigrate* params field: the size of page cache for xbzrle * compression as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.3.4 + * */ # define VIR_MIGRATE_PARAM_COMPRESSION_XBZRLE_CACHE "compression.xbzrle.cache" @@ -1148,6 +1268,9 @@ typedef enum { * virDomainMigrate* params field: the initial percentage guest CPUs are * throttled to when auto-convergence decides migration is not converging. * As VIR_TYPED_PARAM_INT. + * + * Since: v2.0.0 + * */ # define VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIAL "auto_converge.initial" @@ -1158,6 +1281,9 @@ typedef enum { * VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIAL whenever the hypervisor decides * the current rate is not enough to ensure convergence of the migration. * As VIR_TYPED_PARAM_INT. + * + * Since: v2.0.0 + * */ # define VIR_MIGRATE_PARAM_AUTO_CONVERGE_INCREMENT "auto_converge.increment" @@ -1166,6 +1292,9 @@ typedef enum { * * virDomainMigrate* params field: number of connections used during parallel * migration. As VIR_TYPED_PARAM_INT. + * + * Since: v5.2.0 + * */ # define VIR_MIGRATE_PARAM_PARALLEL_CONNECTIONS "parallel.connections" @@ -1180,6 +1309,9 @@ typedef enum { * the destination hostname and the expected certificate's hostname is known, * this parameter can be used to pass this expected hostname when starting * the migration. + * + * Since: v6.0.0 + * */ # define VIR_MIGRATE_PARAM_TLS_DESTINATION "tls.destination" @@ -1442,18 +1574,27 @@ int virDomainGetState (virDomainPtr domain, * VIR_DOMAIN_CPU_STATS_CPUTIME: * cpu usage (sum of both vcpu and hypervisor usage) in nanoseconds, * as a ullong + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_CPU_STATS_CPUTIME "cpu_time" /** * VIR_DOMAIN_CPU_STATS_USERTIME: * cpu time charged to user instructions in nanoseconds, as a ullong + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_CPU_STATS_USERTIME "user_time" /** * VIR_DOMAIN_CPU_STATS_SYSTEMTIME: * cpu time charged to system instructions in nanoseconds, as a ullong + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_CPU_STATS_SYSTEMTIME "system_time" @@ -1461,6 +1602,9 @@ int virDomainGetState (virDomainPtr domain, * VIR_DOMAIN_CPU_STATS_VCPUTIME: * vcpu usage in nanoseconds (cpu_time excluding hypervisor time), * as a ullong + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_CPU_STATS_VCPUTIME "vcpu_time" @@ -1489,6 +1633,9 @@ char * virDomainGetSchedulerType(virDomainPtr domain, * * Macro for the Blkio tunable weight: it represents the io weight * the guest can use, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLKIO_WEIGHT "weight" @@ -1499,6 +1646,9 @@ char * virDomainGetSchedulerType(virDomainPtr domain, * Macro for the blkio tunable weight_device: it represents the * per-device weight, as a string. The string is parsed as a * series of /path/to/device,weight elements, separated by ','. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLKIO_DEVICE_WEIGHT "device_weight" @@ -1510,6 +1660,9 @@ char * virDomainGetSchedulerType(virDomainPtr domain, * the number of reading the block device per second, as a string. The * string is parsed as a series of /path/to/device, read_iops elements, * separated by ','. + * + * Since: v1.2.2 + * */ # define VIR_DOMAIN_BLKIO_DEVICE_READ_IOPS "device_read_iops_sec" @@ -1522,6 +1675,9 @@ char * virDomainGetSchedulerType(virDomainPtr domain, * the number of writing the block device per second, as a string. The * string is parsed as a series of /path/to/device, write_iops elements, * separated by ','. + * + * Since: v1.2.2 + * */ # define VIR_DOMAIN_BLKIO_DEVICE_WRITE_IOPS "device_write_iops_sec" @@ -1533,6 +1689,9 @@ char * virDomainGetSchedulerType(virDomainPtr domain, * the bytes of reading the block device per second, as a string. The * string is parsed as a series of /path/to/device, read_bps elements, * separated by ','. + * + * Since: v1.2.2 + * */ # define VIR_DOMAIN_BLKIO_DEVICE_READ_BPS "device_read_bytes_sec" @@ -1544,6 +1703,9 @@ char * virDomainGetSchedulerType(virDomainPtr domain, * the number of reading the block device per second, as a string. The * string is parsed as a series of /path/to/device, write_bps elements, * separated by ','. + * + * Since: v1.2.2 + * */ # define VIR_DOMAIN_BLKIO_DEVICE_WRITE_BPS "device_write_bytes_sec" @@ -1562,6 +1724,9 @@ int virDomainGetBlkioParameters(virDomainPtr domain, * VIR_DOMAIN_MEMORY_PARAM_UNLIMITED: * * Macro providing the virMemoryParameter value that indicates "unlimited" + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_MEMORY_PARAM_UNLIMITED 9007199254740991LL /* = INT64_MAX >> 10 */ @@ -1571,6 +1736,9 @@ int virDomainGetBlkioParameters(virDomainPtr domain, * * Macro for the memory tunable hard_limit: it represents the maximum memory * the guest can use, as a ullong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_MEMORY_HARD_LIMIT "hard_limit" @@ -1580,6 +1748,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_MEMORY_SOFT_LIMIT "soft_limit" @@ -1589,6 +1760,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_MEMORY_MIN_GUARANTEE "min_guarantee" @@ -1599,6 +1773,9 @@ int virDomainGetBlkioParameters(virDomainPtr domain, * Macro for the swap tunable swap_hard_limit: it represents the maximum swap * plus memory the guest can use, as a ullong. This limit has to be more than * VIR_DOMAIN_MEMORY_HARD_LIMIT. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_MEMORY_SWAP_HARD_LIMIT "swap_hard_limit" @@ -1646,6 +1823,9 @@ typedef enum { * * Macro for typed parameter name that lists the numa nodeset of a * domain, as a string. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_NUMA_NODESET "numa_nodeset" @@ -1654,6 +1834,9 @@ typedef enum { * * Macro for typed parameter name that lists the numa mode of a domain, * as an int containing a virDomainNumatuneMemMode value. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_NUMA_MODE "numa_mode" @@ -1776,6 +1959,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_IN_AVERAGE: * * Macro represents the inbound average of NIC bandwidth, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BANDWIDTH_IN_AVERAGE "inbound.average" @@ -1783,6 +1969,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_IN_PEAK: * * Macro represents the inbound peak of NIC bandwidth, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BANDWIDTH_IN_PEAK "inbound.peak" @@ -1790,6 +1979,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_IN_BURST: * * Macro represents the inbound burst of NIC bandwidth, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BANDWIDTH_IN_BURST "inbound.burst" @@ -1797,6 +1989,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_IN_FLOOR: * * Macro represents the inbound floor of NIC bandwidth, as a uint. + * + * Since: v1.2.19 + * */ # define VIR_DOMAIN_BANDWIDTH_IN_FLOOR "inbound.floor" @@ -1804,6 +1999,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_OUT_AVERAGE: * * Macro represents the outbound average of NIC bandwidth, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BANDWIDTH_OUT_AVERAGE "outbound.average" @@ -1811,6 +2009,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_OUT_PEAK: * * Macro represents the outbound peak of NIC bandwidth, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BANDWIDTH_OUT_PEAK "outbound.peak" @@ -1818,6 +2019,9 @@ int virDomainInterfaceStats (virDomainPtr dom, * VIR_DOMAIN_BANDWIDTH_OUT_BURST: * * Macro represents the outbound burst of NIC bandwidth, as a uint. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BANDWIDTH_OUT_BURST "outbound.burst" @@ -2123,6 +2327,9 @@ int virDomainDelIOThread(virDomainPtr domain, * will cause more CPU time to be allocated the guest. A value set too * 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 + * */ # define VIR_DOMAIN_IOTHREAD_POLL_MAX_NS "poll_max_ns" @@ -2133,6 +2340,9 @@ int virDomainDelIOThread(virDomainPtr domain, * use to grow its polling interval up to the poll_max_ns value. A value * of 0 (zero) allows the hypervisor to choose its own value. The algorithm * to use for adjustment is hypervisor specific. + * + * Since: v4.10.0 + * */ # define VIR_DOMAIN_IOTHREAD_POLL_GROW "poll_grow" @@ -2144,6 +2354,9 @@ int virDomainDelIOThread(virDomainPtr domain, * the poll_max_ns value. A value of 0 (zero) allows the hypervisor to * choose its own value. The algorithm to use for adjustment is hypervisor * specific. + * + * Since: v4.10.0 + * */ # define VIR_DOMAIN_IOTHREAD_POLL_SHRINK "poll_shrink" @@ -2161,6 +2374,9 @@ 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: v1.0.0 + * */ # define VIR_USE_CPU(cpumap, cpu) ((cpumap)[(cpu) / 8] |= (1 << ((cpu) % 8))) @@ -2172,6 +2388,9 @@ 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: v1.0.0 + * */ # define VIR_UNUSE_CPU(cpumap, cpu) ((cpumap)[(cpu) / 8] &= ~(1 << ((cpu) % 8))) @@ -2183,6 +2402,9 @@ 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 + * */ # define VIR_CPU_USED(cpumap, cpu) ((cpumap)[(cpu) / 8] & (1 << ((cpu) % 8))) @@ -2194,6 +2416,9 @@ int virDomainSetIOThreadParams(virDomainPtr domain, * This macro is to be used in conjunction with virDomainPinVcpu() API. * It returns the length (in bytes) required to store the complete * CPU map between a single virtual & all physical CPUs of a domain. + * + * Since: v1.0.0 + * */ # define VIR_CPU_MAPLEN(cpu) (((cpu) + 7) / 8) @@ -2215,6 +2440,9 @@ int virDomainGetVcpus (virDomainPtr domain, * This macro is to be used in conjunction with virDomainGetVcpus() API. * VIR_CPU_USABLE macro returns a non-zero value (true) if the cpu * is usable by the vcpu, and 0 otherwise. + * + * Since: v1.0.0 + * */ # define VIR_CPU_USABLE(cpumaps, maplen, vcpu, cpu) \ @@ -2233,6 +2461,9 @@ int virDomainGetVcpus (virDomainPtr domain, * virDomainPinVcpu() APIs. VIR_COPY_CPUMAP macro extracts the cpumap of * the specified vcpu from cpumaps array and copies it into cpumap to be used * later by virDomainPinVcpu() API. + * + * Since: v1.0.0 + * */ # define VIR_COPY_CPUMAP(cpumaps, maplen, vcpu, cpumap) \ memcpy(cpumap, VIR_GET_CPUMAP(cpumaps, maplen, vcpu), maplen) @@ -2247,6 +2478,9 @@ int virDomainGetVcpus (virDomainPtr domain, * This macro is to be used in conjunction with virDomainGetVcpus() and * virDomainPinVcpu() APIs. VIR_GET_CPUMAP macro returns a pointer to the * cpumap of the specified vcpu from cpumaps array. + * + * Since: v1.0.0 + * */ # define VIR_GET_CPUMAP(cpumaps, maplen, vcpu) (&((cpumaps)[(vcpu) * (maplen)])) @@ -2337,6 +2571,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * which can be used to measure the usage of cache (bytes) by * applications running on the platform. It corresponds to the * "perf.cmt" field in the *Stats APIs. + * + * Since: v1.3.3 + * */ # define VIR_PERF_PARAM_CMT "cmt" @@ -2347,6 +2584,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * which can be used to monitor total system bandwidth (bytes/s) * from one level of cache to another. It corresponds to the * "perf.mbmt" field in the *Stats APIs. + * + * Since: v1.3.5 + * */ # define VIR_PERF_PARAM_MBMT "mbmt" @@ -2358,6 +2598,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * which can be used to monitor the amount of data (bytes/s) sent * through the memory controller on the socket. It corresponds to * the "perf.mbml" field in the *Stats APIs. + * + * Since: v1.3.5 + * */ # define VIR_PERF_PARAM_MBML "mbml" @@ -2368,6 +2611,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * event which can be used to measure the count of cache misses by * applications running on the platform. It corresponds to the * "perf.cache_misses" field in the *Stats APIs. + * + * Since: v2.3.0 + * */ # define VIR_PERF_PARAM_CACHE_MISSES "cache_misses" @@ -2378,6 +2624,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of cache hits * by applications running on the platform. It corresponds to the * "perf.cache_references" field in the *Stats APIs. + * + * Since: v2.3.0 + * */ # define VIR_PERF_PARAM_CACHE_REFERENCES "cache_references" @@ -2388,6 +2637,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * event which can be used to measure the count of instructions * by applications running on the platform. It corresponds to the * "perf.instructions" field in the *Stats APIs. + * + * Since: v2.3.0 + * */ # define VIR_PERF_PARAM_INSTRUCTIONS "instructions" @@ -2398,6 +2650,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * describing the total/elapsed cpu cycles. This can be used to measure * how many cpu cycles one instruction needs. * It corresponds to the "perf.cpu_cycles" field in the *Stats APIs. + * + * Since: v2.3.0 + * */ # define VIR_PERF_PARAM_CPU_CYCLES "cpu_cycles" @@ -2408,6 +2663,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of branch instructions * by applications running on the platform. It corresponds to the * "perf.branch_instructions" field in the *Stats APIs. + * + * Since: v3.0.0 + * */ # define VIR_PERF_PARAM_BRANCH_INSTRUCTIONS "branch_instructions" @@ -2418,6 +2676,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of branch misses * by applications running on the platform. It corresponds to the * "perf.branch_misses" field in the *Stats APIs. + * + * Since: v3.0.0 + * */ # define VIR_PERF_PARAM_BRANCH_MISSES "branch_misses" @@ -2428,6 +2689,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of bus cycles * by applications running on the platform. It corresponds to the * "perf.bus_cycles" field in the *Stats APIs. + * + * Since: v3.0.0 + * */ # define VIR_PERF_PARAM_BUS_CYCLES "bus_cycles" @@ -2439,6 +2703,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * in the frontend of the instruction processor pipeline by applications * running on the platform. It corresponds to the * "perf.stalled_cycles_frontend" field in the *Stats APIs. + * + * Since: v3.0.0 + * */ # define VIR_PERF_PARAM_STALLED_CYCLES_FRONTEND "stalled_cycles_frontend" @@ -2450,6 +2717,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * in the backend of the instruction processor pipeline by application * running on the platform. It corresponds to the * "perf.stalled_cycles_backend" field in the *Stats APIs. + * + * Since: v3.0.0 + * */ # define VIR_PERF_PARAM_STALLED_CYCLES_BACKEND "stalled_cycles_backend" @@ -2461,6 +2731,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * cycles not affected by CPU frequency scaling by applications * running on the platform. It corresponds to the * "perf.ref_cpu_cycles" field in the *Stats APIs. + * + * Since: v3.0.0 + * */ # define VIR_PERF_PARAM_REF_CPU_CYCLES "ref_cpu_cycles" @@ -2472,6 +2745,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * clock time by applications running on the platform. It * corresponds to the "perf.cpu_clock" field in the *Stats * APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_CPU_CLOCK "cpu_clock" @@ -2483,6 +2759,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * clock time by applications running on the platform. It * corresponds to the "perf.task_clock" field in the *Stats * APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_TASK_CLOCK "task_clock" @@ -2493,6 +2772,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of page * faults by applications running on the platform. It corresponds * to the "perf.page_faults" field in the *Stats APIs. +* +* Since: v3.2.0 +* */ # define VIR_PERF_PARAM_PAGE_FAULTS "page_faults" @@ -2503,6 +2785,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of context * switches by applications running on the platform. It corresponds * to the "perf.context_switches" field in the *Stats APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_CONTEXT_SWITCHES "context_switches" @@ -2513,6 +2798,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of cpu * migrations by applications running on the platform. It corresponds * to the "perf.cpu_migrations" field in the *Stats APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_CPU_MIGRATIONS "cpu_migrations" @@ -2523,6 +2811,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of minor page * faults by applications running on the platform. It corresponds * to the "perf.page_faults_min" field in the *Stats APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_PAGE_FAULTS_MIN "page_faults_min" @@ -2533,6 +2824,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of major page * faults by applications running on the platform. It corresponds * to the "perf.page_faults_maj" field in the *Stats APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_PAGE_FAULTS_MAJ "page_faults_maj" @@ -2543,6 +2837,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of alignment * faults by applications running on the platform. It corresponds * to the "perf.alignment_faults" field in the *Stats APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_ALIGNMENT_FAULTS "alignment_faults" @@ -2553,6 +2850,9 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats); * perf event which can be used to measure the count of emulation * faults by applications running on the platform. It corresponds * to the "perf.emulation_faults" field in the *Stats APIs. + * + * Since: v3.2.0 + * */ # define VIR_PERF_PARAM_EMULATION_FAULTS "emulation_faults" @@ -2744,6 +3044,9 @@ typedef enum { * allowing a subsequent change of bandwidth via * virDomainBlockJobSetSpeed(). The actual speed can be determined * with virDomainGetBlockJobInfo(). + * + * Since: v1.2.8 + * */ # define VIR_DOMAIN_BLOCK_COPY_BANDWIDTH "bandwidth" @@ -2755,6 +3058,9 @@ typedef enum { * restrict this to be a power of two or fall within a certain * range. Specifying 0 is the same as omitting this parameter, to * request the hypervisor default. + * + * Since: v1.2.8 + * */ # define VIR_DOMAIN_BLOCK_COPY_GRANULARITY "granularity" @@ -2764,6 +3070,9 @@ typedef enum { * how much data in bytes can be in flight between source and destination, * as an unsigned long long. Specifying 0 is the same as omitting this * parameter, to request the hypervisor default. + * + * Since: v1.2.8 + * */ # define VIR_DOMAIN_BLOCK_COPY_BUF_SIZE "buf-size" @@ -2805,6 +3114,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC "total_bytes_sec" @@ -2813,6 +3125,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC "read_bytes_sec" @@ -2821,6 +3136,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC "write_bytes_sec" @@ -2829,6 +3147,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC "total_iops_sec" @@ -2837,6 +3158,9 @@ 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: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC "read_iops_sec" @@ -2844,6 +3168,9 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base, * VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC: * Macro for the BlockIoTune tunable weight: it represents the write * I/O operations per second permitted through a block device, as a ullong. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC "write_iops_sec" @@ -2852,6 +3179,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX "total_bytes_sec_max" @@ -2860,6 +3190,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX "read_bytes_sec_max" @@ -2868,6 +3201,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX "write_bytes_sec_max" @@ -2876,6 +3212,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX "total_iops_sec_max" @@ -2884,6 +3223,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX "read_iops_sec_max" @@ -2891,6 +3233,9 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base, * VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX: * 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX "write_iops_sec_max" @@ -2899,6 +3244,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX_LENGTH "total_bytes_sec_max_length" @@ -2907,6 +3255,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX_LENGTH "read_bytes_sec_max_length" @@ -2915,6 +3266,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX_LENGTH "write_bytes_sec_max_length" @@ -2923,6 +3277,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX_LENGTH "total_iops_sec_max_length" @@ -2931,6 +3288,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX_LENGTH "read_iops_sec_max_length" @@ -2939,6 +3299,9 @@ 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX_LENGTH "write_iops_sec_max_length" @@ -2946,6 +3309,9 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base, * VIR_DOMAIN_BLOCK_IOTUNE_SIZE_IOPS_SEC: * 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_SIZE_IOPS_SEC "size_iops_sec" @@ -2953,6 +3319,9 @@ int virDomainBlockCommit(virDomainPtr dom, const char *disk, const char *base, * VIR_DOMAIN_BLOCK_IOTUNE_GROUP_NAME: * 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 + * */ # define VIR_DOMAIN_BLOCK_IOTUNE_GROUP_NAME "group_name" @@ -3034,6 +3403,9 @@ typedef enum { * VIR_KEYCODE_SET_RFB: * * Compatibility alias for VIR_KEYCODE_SET_QNUM, which replaced it since 4.2.0. + * + * Since: v1.0.0 + * */ # define VIR_KEYCODE_SET_RFB VIR_KEYCODE_SET_QNUM @@ -3041,6 +3413,9 @@ typedef enum { * VIR_DOMAIN_SEND_KEY_MAX_KEYS: * * Maximum number of keycodes that can be sent in one virDomainSendKey() call. + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_SEND_KEY_MAX_KEYS 16 @@ -3533,6 +3908,9 @@ typedef enum { * virDomainGetJobStats field: the operation which started the job as * VIR_TYPED_PARAM_INT. The values correspond to the items in * virDomainJobOperation enum. + * + * Since: v3.3.0 + * */ # define VIR_DOMAIN_JOB_OPERATION "operation" @@ -3543,6 +3921,9 @@ typedef enum { * job, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to timeElapsed field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_TIME_ELAPSED "time_elapsed" @@ -3553,6 +3934,9 @@ typedef enum { * migration job NOT including the time required to transfer control * flow from the source host to the destination host, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.15 + * */ # define VIR_DOMAIN_JOB_TIME_ELAPSED_NET "time_elapsed_net" @@ -3563,6 +3947,9 @@ typedef enum { * jobs, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to timeRemaining field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_TIME_REMAINING "time_remaining" @@ -3573,6 +3960,9 @@ typedef enum { * during migration, as VIR_TYPED_PARAM_ULLONG. The real computed downtime * between the time guest CPUs were paused and the time they were resumed * is reported for completed migration. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DOWNTIME "downtime" @@ -3582,6 +3972,9 @@ typedef enum { * virDomainGetJobStats field: real measured downtime (ms) NOT including * the time required to transfer control flow from the source host to the * destination host, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.15 + * */ # define VIR_DOMAIN_JOB_DOWNTIME_NET "downtime_net" @@ -3591,6 +3984,9 @@ typedef enum { * virDomainGetJobStats field: total time in milliseconds spent preparing * the migration in the 'setup' phase before the iterations begin, as * VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_JOB_SETUP_TIME "setup_time" @@ -3606,6 +4002,9 @@ typedef enum { * VIR_DOMAIN_JOB_DATA_PROCESSED + VIR_DOMAIN_JOB_DATA_REMAINING. * * This field corresponds to dataTotal field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DATA_TOTAL "data_total" @@ -3616,6 +4015,9 @@ typedef enum { * beginning of the job, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to dataProcessed field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DATA_PROCESSED "data_processed" @@ -3626,6 +4028,9 @@ typedef enum { * transferred, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to dataRemaining field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DATA_REMAINING "data_remaining" @@ -3636,6 +4041,9 @@ typedef enum { * tracking guest memory progress, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to memTotal field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_MEMORY_TOTAL "memory_total" @@ -3646,6 +4054,9 @@ typedef enum { * tracking guest memory progress, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to memProcessed field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_MEMORY_PROCESSED "memory_processed" @@ -3656,6 +4067,9 @@ typedef enum { * tracking guest memory progress, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to memRemaining field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_MEMORY_REMAINING "memory_remaining" @@ -3668,6 +4082,9 @@ typedef enum { * * The most common example of such pages are zero pages, i.e., pages filled * with zero bytes. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_MEMORY_CONSTANT "memory_constant" @@ -3678,6 +4095,9 @@ typedef enum { * any kind of compression (i.e., pages which were not filled with a constant * byte and which could not be compressed) transferred since the beginning * of the migration job, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_MEMORY_NORMAL "memory_normal" @@ -3688,6 +4108,9 @@ typedef enum { * as VIR_TYPED_PARAM_ULLONG. * * See VIR_DOMAIN_JOB_MEMORY_NORMAL for more details. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_MEMORY_NORMAL_BYTES "memory_normal_bytes" @@ -3696,6 +4119,9 @@ typedef enum { * * virDomainGetJobStats field: network throughput used while migrating * memory in Bytes per second, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_JOB_MEMORY_BPS "memory_bps" @@ -3704,6 +4130,9 @@ typedef enum { * virDomainGetJobStats field: number of memory pages dirtied by the guest * per second, as VIR_TYPED_PARAM_ULLONG. This statistics makes sense only * when live migration is running. + * + * Since: v1.3.1 + * */ # define VIR_DOMAIN_JOB_MEMORY_DIRTY_RATE "memory_dirty_rate" @@ -3715,6 +4144,9 @@ typedef enum { * convert other page based statistics, such as * VIR_DOMAIN_JOB_MEMORY_DIRTY_RATE or VIR_DOMAIN_JOB_COMPRESSION_PAGES * to bytes. + * + * Since: v3.9.0 + * */ # define VIR_DOMAIN_JOB_MEMORY_PAGE_SIZE "memory_page_size" @@ -3726,6 +4158,9 @@ typedef enum { * when memory starts to be transferred and the value is increased by one * every time a new iteration is started to transfer memory pages dirtied * since the last iteration. + * + * Since: v1.3.1 + * */ # define VIR_DOMAIN_JOB_MEMORY_ITERATION "memory_iteration" @@ -3736,6 +4171,9 @@ typedef enum { * destination host during post-copy migration, as VIR_TYPED_PARAM_ULLONG. * 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 + * */ # define VIR_DOMAIN_JOB_MEMORY_POSTCOPY_REQS "memory_postcopy_requests" @@ -3746,6 +4184,9 @@ typedef enum { * tracking guest disk progress, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to fileTotal field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DISK_TOTAL "disk_total" @@ -3756,6 +4197,9 @@ typedef enum { * tracking guest disk progress, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to fileProcessed field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DISK_PROCESSED "disk_processed" @@ -3766,6 +4210,9 @@ typedef enum { * tracking guest disk progress, as VIR_TYPED_PARAM_ULLONG. * * This field corresponds to fileRemaining field in virDomainJobInfo. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_DISK_REMAINING "disk_remaining" @@ -3774,6 +4221,9 @@ typedef enum { * * virDomainGetJobStats field: network throughput used while migrating * disks in Bytes per second, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_JOB_DISK_BPS "disk_bps" @@ -3783,6 +4233,9 @@ typedef enum { * virDomainGetJobStats field: size of the cache (in bytes) used for * compressing repeatedly transferred memory pages during live migration, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_COMPRESSION_CACHE "compression_cache" @@ -3791,6 +4244,9 @@ typedef enum { * * virDomainGetJobStats field: number of compressed bytes transferred * since the beginning of migration, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_COMPRESSION_BYTES "compression_bytes" @@ -3799,6 +4255,9 @@ typedef enum { * * virDomainGetJobStats field: number of compressed pages transferred * since the beginning of migration, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_COMPRESSION_PAGES "compression_pages" @@ -3808,6 +4267,9 @@ typedef enum { * virDomainGetJobStats field: number of repeatedly changing pages that * were not found in compression cache and thus could not be compressed, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_COMPRESSION_CACHE_MISSES "compression_cache_misses" @@ -3818,6 +4280,9 @@ typedef enum { * were found in compression cache but were sent uncompressed because * the result of compression was larger than the original page as a whole, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.0.3 + * */ # define VIR_DOMAIN_JOB_COMPRESSION_OVERFLOW "compression_overflow" @@ -3827,6 +4292,9 @@ typedef enum { * virDomainGetJobStats field: current percentage guest CPUs are throttled * to when auto-convergence decided migration was not converging, as * VIR_TYPED_PARAM_INT. + * + * Since: v2.0.0 + * */ # define VIR_DOMAIN_JOB_AUTO_CONVERGE_THROTTLE "auto_converge_throttle" @@ -3835,6 +4303,9 @@ 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 + * */ # define VIR_DOMAIN_JOB_SUCCESS "success" @@ -3843,6 +4314,9 @@ typedef enum { * * virDomainGetJobStats field: Present only in statistics for a completed job. * Optional error message for a failed job. + * + * Since: v6.3.0 + * */ # define VIR_DOMAIN_JOB_ERRMSG "errmsg" @@ -3851,6 +4325,9 @@ typedef enum { * VIR_DOMAIN_JOB_DISK_TEMP_USED: * virDomainGetJobStats field: current usage of temporary disk space for the * job in bytes as VIR_TYPED_PARAM_ULLONG. + * + * Since: v6.0.0 + * */ # define VIR_DOMAIN_JOB_DISK_TEMP_USED "disk_temp_used" @@ -3858,6 +4335,9 @@ typedef enum { * VIR_DOMAIN_JOB_DISK_TEMP_TOTAL: * virDomainGetJobStats field: possible total temporary disk space for the * job in bytes as VIR_TYPED_PARAM_ULLONG. + * + * Since: v6.0.0 + * */ # define VIR_DOMAIN_JOB_DISK_TEMP_TOTAL "disk_temp_total" @@ -4419,6 +4899,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents formatted pinning for one vcpu specified by id which is * appended to the parameter name, for example "cputune.vcpupin1", * as VIR_TYPED_PARAM_STRING. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_CPU_VCPUPIN "cputune.vcpupin%u" @@ -4427,6 +4910,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents formatted pinning for emulator process, * as VIR_TYPED_PARAM_STRING. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_CPU_EMULATORPIN "cputune.emulatorpin" @@ -4436,6 +4922,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents formatted pinning for one IOThread specified by id which is * appended to the parameter name, for example "cputune.iothreadpin1", * as VIR_TYPED_PARAM_STRING. + * + * Since: v1.2.14 + * */ # define VIR_DOMAIN_TUNABLE_CPU_IOTHREADSPIN "cputune.iothreadpin%u" @@ -4444,6 +4933,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_CPU_SHARES "cputune.cpu_shares" @@ -4452,6 +4944,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_GLOBAL_PERIOD "cputune.global_period" @@ -4460,6 +4955,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_GLOBAL_QUOTA "cputune.global_quota" @@ -4468,6 +4966,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_VCPU_PERIOD "cputune.vcpu_period" @@ -4476,6 +4977,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_VCPU_QUOTA "cputune.vcpu_quota" @@ -4485,6 +4989,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the enforcement period for a quota in microseconds, * when using the posix scheduler, for all emulator activity not tied to * vcpus, as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_CPU_EMULATOR_PERIOD "cputune.emulator_period" @@ -4494,6 +5001,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the maximum bandwidth to be used within a period for * all emulator activity not tied to vcpus, when using the posix scheduler, * as an VIR_TYPED_PARAM_LLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_CPU_EMULATOR_QUOTA "cputune.emulator_quota" @@ -4502,6 +5012,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_IOTHREAD_PERIOD "cputune.iothread_period" @@ -4510,6 +5023,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_CPU_IOTHREAD_QUOTA "cputune.iothread_quota" @@ -4518,6 +5034,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_DISK "blkdeviotune.disk" @@ -4526,6 +5045,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the total throughput limit in bytes per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC "blkdeviotune.total_bytes_sec" @@ -4534,6 +5056,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the read throughput limit in bytes per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC "blkdeviotune.read_bytes_sec" @@ -4542,6 +5067,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the write throughput limit in bytes per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC "blkdeviotune.write_bytes_sec" @@ -4550,6 +5078,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the total I/O operations per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC "blkdeviotune.total_iops_sec" @@ -4558,6 +5089,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the read I/O operations per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC "blkdeviotune.read_iops_sec" @@ -4566,6 +5100,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the write I/O operations per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.9 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC "blkdeviotune.write_iops_sec" @@ -4574,6 +5111,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC_MAX "blkdeviotune.total_bytes_sec_max" @@ -4582,6 +5122,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC_MAX "blkdeviotune.read_bytes_sec_max" @@ -4590,6 +5133,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC_MAX "blkdeviotune.write_bytes_sec_max" @@ -4598,6 +5144,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC_MAX "blkdeviotune.total_iops_sec_max" @@ -4606,6 +5155,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC_MAX "blkdeviotune.read_iops_sec_max" @@ -4614,6 +5166,9 @@ 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 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC_MAX "blkdeviotune.write_iops_sec_max" @@ -4622,6 +5177,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the size maximum I/O operations per second, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v1.2.11 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_SIZE_IOPS_SEC "blkdeviotune.size_iops_sec" @@ -4630,6 +5188,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * * Macro represents the group name to be used, * as VIR_TYPED_PARAM_STRING. + * + * Since: v3.0.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_GROUP_NAME "blkdeviotune.group_name" @@ -4639,6 +5200,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the length in seconds allowed for a burst period * for the blkdeviotune.total_bytes_sec_max, * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v2.4.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC_MAX_LENGTH "blkdeviotune.total_bytes_sec_max_length" @@ -4648,6 +5212,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the length in seconds allowed for a burst period * for the blkdeviotune.read_bytes_sec_max * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v2.4.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC_MAX_LENGTH "blkdeviotune.read_bytes_sec_max_length" @@ -4657,6 +5224,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the length in seconds allowed for a burst period * for the blkdeviotune.write_bytes_sec_max * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v2.4.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC_MAX_LENGTH "blkdeviotune.write_bytes_sec_max_length" @@ -4666,6 +5236,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the length in seconds allowed for a burst period * for the blkdeviotune.total_iops_sec_max * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v2.4.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC_MAX_LENGTH "blkdeviotune.total_iops_sec_max_length" @@ -4675,6 +5248,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the length in seconds allowed for a burst period * for the blkdeviotune.read_iops_sec_max * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v2.4.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC_MAX_LENGTH "blkdeviotune.read_iops_sec_max_length" @@ -4684,6 +5260,9 @@ typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn, * Macro represents the length in seconds allowed for a burst period * for the blkdeviotune.write_iops_sec_max * as VIR_TYPED_PARAM_ULLONG. + * + * Since: v2.4.0 + * */ # define VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC_MAX_LENGTH "blkdeviotune.write_iops_sec_max_length" @@ -4836,6 +5415,9 @@ typedef void (*virConnectDomainEventMemoryDeviceSizeChangeCallback)(virConnectPt * * Used to cast the event specific callback into the generic one * for use for virConnectDomainEventRegisterAny() + * + * Since: v1.0.0 + * */ # define VIR_DOMAIN_EVENT_CALLBACK(cb) ((virConnectDomainEventGenericCallback)(cb)) @@ -5021,7 +5603,10 @@ typedef enum { * * Macro providing the field length of virSchedParameter. Provided * for backwards compatibility; VIR_TYPED_PARAM_FIELD_LENGTH is the - * preferred value since 0.9.2. + * preferred value + * + * Since: v0.9.2 + * */ # define VIR_DOMAIN_SCHED_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH @@ -5030,7 +5615,10 @@ typedef enum { * * a virSchedParameter is the set of scheduler parameters. * Provided for backwards compatibility; virTypedParameter is the - * preferred alias since 0.9.2. + * preferred alias. + * + * Since: v0.9.2 + * */ # define _virSchedParameter _virTypedParameter typedef struct _virTypedParameter virSchedParameter; @@ -5065,7 +5653,10 @@ typedef enum { * * Macro providing the field length of virBlkioParameter. Provided * for backwards compatibility; VIR_TYPED_PARAM_FIELD_LENGTH is the - * preferred value since 0.9.2. + * preferred value. + * + * Since: v0.9.2 + * */ # define VIR_DOMAIN_BLKIO_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH @@ -5074,7 +5665,10 @@ typedef enum { * * a virBlkioParameter is the set of blkio parameters. * Provided for backwards compatibility; virTypedParameter is the - * preferred alias since 0.9.2. + * preferred alias. + * + * Since: v0.9.2 + * */ # define _virBlkioParameter _virTypedParameter typedef struct _virTypedParameter virBlkioParameter; @@ -5109,7 +5703,10 @@ typedef enum { * * Macro providing the field length of virMemoryParameter. Provided * for backwards compatibility; VIR_TYPED_PARAM_FIELD_LENGTH is the - * preferred value since 0.9.2. + * preferred value. + * + * Since: v0.9.2 + * */ # define VIR_DOMAIN_MEMORY_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH @@ -5118,7 +5715,10 @@ typedef enum { * * a virMemoryParameter is the set of scheduler parameters. * Provided for backwards compatibility; virTypedParameter is the - * preferred alias since 0.9.2. + * preferred alias. + * + * Since: v0.9.2 + * */ # define _virMemoryParameter _virTypedParameter typedef struct _virTypedParameter virMemoryParameter; @@ -5236,6 +5836,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * * Macro represents the launch measurement of the SEV guest, * as VIR_TYPED_PARAM_STRING. + * + * Since: v4.5.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_MEASUREMENT "sev-measurement" @@ -5245,6 +5848,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * * Macro represents the API major version of the SEV host, * as VIR_TYPED_PARAM_UINT. + * + * Since: v8.0.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MAJOR "sev-api-major" @@ -5253,6 +5859,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * * Macro represents the API minor version of the SEV guest, * as VIR_TYPED_PARAM_UINT. + * + * Since: v8.0.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MINOR "sev-api-minor" @@ -5261,6 +5870,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * * Macro represents the build ID of the SEV host, * as VIR_TYPED_PARAM_UINT. + * + * Since: v8.0.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_BUILD_ID "sev-build-id" @@ -5269,6 +5881,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * * Macro represents the policy of the SEV guest, * as VIR_TYPED_PARAM_UINT. + * + * Since: v8.0.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_POLICY "sev-policy" @@ -5280,6 +5895,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * the SEV firmware to recover the plain text of the launch secret. See * section "6.6 LAUNCH_SECRET" in the SEV API specification for a detailed * description of the secret header. + * + * Since: v8.0.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_HEADER "sev-secret-header" @@ -5290,6 +5908,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * base64-encoded VIR_TYPED_PARAM_STRING containing an encrypted launch * secret. The secret is created by the domain owner after the SEV launch * measurement is retrieved and verified. + * + * Since: v8.0.0 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET "sev-secret" @@ -5299,6 +5920,9 @@ int virDomainSetLifecycleAction(virDomainPtr domain, * A macro used to represent the physical address within the guest's memory * 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 + * */ # define VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_SET_ADDRESS "sev-secret-set-address" diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index f6a9588568..a31fa2d9ee 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -80,6 +80,9 @@ 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: v1.0.0 + * */ # define VIR_SECURITY_LABEL_BUFLEN (4096 + 1) @@ -108,6 +111,9 @@ typedef virSecurityLabel *virSecurityLabelPtr; * VIR_SECURITY_MODEL_BUFLEN: * * Macro providing the maximum length of the virSecurityModel model string. + * + * Since: v1.0.0 + * */ # define VIR_SECURITY_MODEL_BUFLEN (256 + 1) @@ -115,6 +121,9 @@ typedef virSecurityLabel *virSecurityLabelPtr; * VIR_SECURITY_DOI_BUFLEN: * * Macro providing the maximum length of the virSecurityModel doi string. + * + * Since: v1.0.0 + * */ # define VIR_SECURITY_DOI_BUFLEN (256 + 1) @@ -176,6 +185,9 @@ struct _virNodeInfo { * VIR_NODE_CPU_STATS_FIELD_LENGTH: * * Macro providing the field length of virNodeCPUStats + * + * Since: v1.0.0 + * */ # define VIR_NODE_CPU_STATS_FIELD_LENGTH 80 @@ -193,6 +205,9 @@ typedef enum { * * Macro for the cumulative CPU time which was spent by the kernel, * since the node booting up (in nanoseconds). + * + * Since: v1.0.0 + * */ # define VIR_NODE_CPU_STATS_KERNEL "kernel" @@ -201,6 +216,9 @@ typedef enum { * * The cumulative CPU time which was spent by user processes, * since the node booting up (in nanoseconds). + * + * Since: v1.0.0 + * */ # define VIR_NODE_CPU_STATS_USER "user" @@ -209,6 +227,9 @@ typedef enum { * * The cumulative idle CPU time, * since the node booting up (in nanoseconds). + * + * Since: v1.0.0 + * */ # define VIR_NODE_CPU_STATS_IDLE "idle" @@ -217,6 +238,9 @@ typedef enum { * * The cumulative I/O wait CPU time, * since the node booting up (in nanoseconds). + * + * Since: v1.0.0 + * */ # define VIR_NODE_CPU_STATS_IOWAIT "iowait" @@ -225,6 +249,9 @@ typedef enum { * * The cumulative interrupt CPU time, * since the node booting up (in nanoseconds). + * + * Since: v1.2.2 + * */ # define VIR_NODE_CPU_STATS_INTR "intr" @@ -234,6 +261,9 @@ typedef enum { * The CPU utilization of a node. * The usage value is in percent and 100% represents all CPUs of * the node. + * + * Since: v1.0.0 + * */ # define VIR_NODE_CPU_STATS_UTILIZATION "utilization" @@ -254,6 +284,9 @@ struct _virNodeCPUStats { * VIR_NODE_MEMORY_STATS_FIELD_LENGTH: * * Macro providing the field length of virNodeMemoryStats + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_STATS_FIELD_LENGTH 80 @@ -271,6 +304,9 @@ typedef enum { * * Macro for the total memory of specified cell: * it represents the maximum memory. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_STATS_TOTAL "total" @@ -280,6 +316,9 @@ typedef enum { * Macro for the free memory of specified cell: * On Linux, it includes buffer and cached memory, in case of * VIR_NODE_MEMORY_STATS_ALL_CELLS. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_STATS_FREE "free" @@ -288,6 +327,9 @@ typedef enum { * * Macro for the buffer memory: On Linux, it is only returned in case of * VIR_NODE_MEMORY_STATS_ALL_CELLS. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_STATS_BUFFERS "buffers" @@ -296,6 +338,9 @@ typedef enum { * * Macro for the cached memory: On Linux, it is only returned in case of * VIR_NODE_MEMORY_STATS_ALL_CELLS. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_STATS_CACHED "cached" @@ -317,6 +362,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many present pages * to scan before the shared memory service goes to sleep. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_PAGES_TO_SCAN "shm_pages_to_scan" @@ -325,6 +373,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many milliseconds * the shared memory service should sleep before next scan. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_SLEEP_MILLISECS "shm_sleep_millisecs" @@ -333,6 +384,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many the shared * memory pages are being used. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_PAGES_SHARED "shm_pages_shared" @@ -341,6 +395,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many sites are * sharing the pages i.e. how much saved. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_PAGES_SHARING "shm_pages_sharing" @@ -349,6 +406,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many pages unique * but repeatedly checked for merging. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_PAGES_UNSHARED "shm_pages_unshared" @@ -357,6 +417,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many pages changing * too fast to be placed in a tree. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_PAGES_VOLATILE "shm_pages_volatile" @@ -365,6 +428,9 @@ struct _virNodeMemoryStats { * * Macro for typed parameter that represents how many times all * mergeable areas have been scanned. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_FULL_SCANS "shm_full_scans" @@ -377,6 +443,9 @@ struct _virNodeMemoryStats { * memory area of same NUMA node are merged; When its value is 1, * pages from all nodes can be merged. Other values are reserved * for future use. + * + * Since: v1.0.0 + * */ # define VIR_NODE_MEMORY_SHARED_MERGE_ACROSS_NODES "shm_merge_across_nodes" @@ -406,6 +475,9 @@ int virNodeGetCPUMap(virConnectPtr conn, * * This macro is to calculate the total number of CPUs supported * but not necessary active in the host. + * + * Since: v1.0.0 + * */ @@ -445,6 +517,9 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr; * VIR_NODE_SEV_PDH: * * Macro represents the Platform Diffie-Hellman key, as VIR_TYPED_PARAMS_STRING. + * + * Since: v4.5.0 + * */ # define VIR_NODE_SEV_PDH "pdh" @@ -454,6 +529,9 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr; * Macro represents the platform certificate chain that includes the platform * endorsement key (PEK), owner certificate authority (OCD) and chip * endorsement key (CEK), as VIR_TYPED_PARAMS_STRING. + * + * Since: v4.5.0 + * */ # define VIR_NODE_SEV_CERT_CHAIN "cert-chain" @@ -461,6 +539,9 @@ typedef virNodeMemoryStats *virNodeMemoryStatsPtr; * VIR_NODE_SEV_CBITPOS: * * Macro represents the CBit Position used by hypervisor when SEV is enabled. + * + * Since: v4.5.0 + * */ # define VIR_NODE_SEV_CBITPOS "cbitpos" @@ -469,6 +550,9 @@ 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 + * */ # define VIR_NODE_SEV_REDUCED_PHYS_BITS "reduced-phys-bits" @@ -477,6 +561,9 @@ 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 + * */ # define VIR_NODE_SEV_MAX_GUESTS "max-guests" @@ -485,6 +572,9 @@ 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 + * */ # define VIR_NODE_SEV_MAX_ES_GUESTS "max-es-guests" @@ -582,6 +672,9 @@ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault; * * This macro provides the length of the buffer required * for virDomainGetUUID() + * + * Since: v1.0.0 + * */ # define VIR_UUID_BUFLEN (16) @@ -591,6 +684,9 @@ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefault; * * This macro provides the length of the buffer required * for virDomainGetUUIDString() + * + * Since: v1.0.0 + * */ # define VIR_UUID_STRING_BUFLEN (36+1) @@ -617,6 +713,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_USER_NAME: * * The operating system user name as VIR_TYPED_PARAM_STRING. + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_USER_NAME "user-name" @@ -624,6 +723,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_UNIX_USER_ID: * * The UNIX user ID as VIR_TYPED_PARAM_ULLONG. + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_UNIX_USER_ID "unix-user-id" @@ -631,6 +733,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_GROUP_NAME: * * The operating system group name as VIR_TYPED_PARAM_STRING. + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_GROUP_NAME "group-name" @@ -638,6 +743,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_UNIX_GROUP_ID: * * The UNIX group ID as VIR_TYPED_PARAM_ULLONG. + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_UNIX_GROUP_ID "unix-group-id" @@ -645,6 +753,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_PROCESS_ID: * * The operating system process ID as VIR_TYPED_PARAM_LLONG. + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_PROCESS_ID "process-id" @@ -656,6 +767,9 @@ int virConnectClose (virConnectPtr conn); * The units the time is measured in vary according to the * host operating system. On Linux this is usually clock * ticks (as reported in /proc/$PID/stat field 22). + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_PROCESS_TIME "process-time" @@ -663,6 +777,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_SASL_USER_NAME: * * The SASL authenticated username as VIR_TYPED_PARAM_STRING + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_SASL_USER_NAME "sasl-user-name" @@ -670,6 +787,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_X509_DISTINGUISHED_NAME: * * The TLS x509 certificate distinguished named as VIR_TYPED_PARAM_STRING + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_X509_DISTINGUISHED_NAME "x509-distinguished-name" @@ -677,6 +797,9 @@ int virConnectClose (virConnectPtr conn); * VIR_CONNECT_IDENTITY_SELINUX_CONTEXT: * * The application's SELinux context as VIR_TYPED_PARAM_STRING. + * + * Since: v5.8.0 + * */ # define VIR_CONNECT_IDENTITY_SELINUX_CONTEXT "selinux-context" diff --git a/include/libvirt/libvirt-network.h b/include/libvirt/libvirt-network.h index 4868a49427..3bf6df34a7 100644 --- a/include/libvirt/libvirt-network.h +++ b/include/libvirt/libvirt-network.h @@ -283,6 +283,9 @@ typedef void (*virConnectNetworkEventLifecycleCallback)(virConnectPtr conn, * * Used to cast the event specific callback into the generic one * for use for virConnectNetworkEventRegisterAny() + * + * Since: v1.2.1 + * */ # define VIR_NETWORK_EVENT_CALLBACK(cb) ((virConnectNetworkEventGenericCallback)(cb)) @@ -402,6 +405,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_IN_AVERAGE: * * Macro represents the inbound average of NIC bandwidth, as a uint. + * + * Since: v5.5.0 + * */ # define VIR_NETWORK_PORT_BANDWIDTH_IN_AVERAGE "inbound.average" @@ -409,6 +415,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_IN_PEAK: * * Macro represents the inbound peak of NIC bandwidth, as a uint. + * + * Since: v5.5.0 + * */ # define VIR_NETWORK_PORT_BANDWIDTH_IN_PEAK "inbound.peak" @@ -416,6 +425,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_IN_BURST: * * Macro represents the inbound burst of NIC bandwidth, as a uint. + * + * Since: v5.5.0 + * */ # define VIR_NETWORK_PORT_BANDWIDTH_IN_BURST "inbound.burst" @@ -423,6 +435,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_IN_FLOOR: * * Macro represents the inbound floor of NIC bandwidth, as a uint. + * + * Since: v5.5.0 + * */ # define VIR_NETWORK_PORT_BANDWIDTH_IN_FLOOR "inbound.floor" @@ -430,6 +445,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_OUT_AVERAGE: * * Macro represents the outbound average of NIC bandwidth, as a uint. + * + * Since: v5.5.0 + * */ # define VIR_NETWORK_PORT_BANDWIDTH_OUT_AVERAGE "outbound.average" @@ -437,6 +455,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_OUT_PEAK: * * Macro represents the outbound peak of NIC bandwidth, as a uint. + * + * Since: v5.5.0 + * */ # define VIR_NETWORK_PORT_BANDWIDTH_OUT_PEAK "outbound.peak" @@ -444,6 +465,9 @@ virNetworkPortGetUUIDString(virNetworkPortPtr port, * VIR_NETWORK_PORT_BANDWIDTH_OUT_BURST: * * Macro represents the outbound burst of NIC bandwidth, as a uint. + * + * Since: v5.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 de398a1767..589495213c 100644 --- a/include/libvirt/libvirt-nodedev.h +++ b/include/libvirt/libvirt-nodedev.h @@ -156,6 +156,9 @@ int virNodeDeviceIsActive(virNodeDevicePtr dev); * * Used to cast the event specific callback into the generic one * for use for virConnectNodeDeviceEventRegisterAny() + * + * Since: v2.2.0 + * */ # define VIR_NODE_DEVICE_EVENT_CALLBACK(cb)((virConnectNodeDeviceEventGenericCallback)(cb)) diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-secret.h index 6134989369..cd636f14be 100644 --- a/include/libvirt/libvirt-secret.h +++ b/include/libvirt/libvirt-secret.h @@ -120,6 +120,9 @@ int virSecretFree (virSecretPtr secret); * * Used to cast the event specific callback into the generic one * for use for virConnectSecretEventRegisterAny() + * + * Since: v3.0.0 + * */ # define VIR_SECRET_EVENT_CALLBACK(cb)((virConnectSecretEventGenericCallback)(cb)) diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h index e7265fe772..a0c4dab809 100644 --- a/include/libvirt/libvirt-storage.h +++ b/include/libvirt/libvirt-storage.h @@ -420,6 +420,9 @@ int virStoragePoolIsPersistent(virStoragePoolPtr pool); * * Used to cast the event specific callback into the generic one * for use for virConnectStoragePoolEventRegisterAny() + * + * Since: v2.0.0 + * */ # define VIR_STORAGE_POOL_EVENT_CALLBACK(cb)((virConnectStoragePoolEventGenericCallback)(cb)) -- 2.35.1

There were a few style fixes introduced with this commit. With 'style fixes', I mean the docstring enforced/used by scripts/apibuild.py As most of the metadata was generated by a script, it did not seem useful to split the style fixes with those generated by the script. In the end, they are all typedef fixes that are related to appending *Since* metadata. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain-checkpoint.h | 18 +- include/libvirt/libvirt-domain-snapshot.h | 24 +- include/libvirt/libvirt-domain.h | 583 +++++++++++++++++++- include/libvirt/libvirt-event.h | 3 + include/libvirt/libvirt-host.h | 100 +++- include/libvirt/libvirt-interface.h | 13 +- include/libvirt/libvirt-network.h | 50 +- include/libvirt/libvirt-nodedev.h | 22 +- include/libvirt/libvirt-nwfilter.h | 12 + include/libvirt/libvirt-secret.h | 22 +- include/libvirt/libvirt-storage.h | 81 +++ include/libvirt/libvirt-stream.h | 18 + include/libvirt/virterror.h | 12 + 13 files changed, 913 insertions(+), 45 deletions(-) diff --git a/include/libvirt/libvirt-domain-checkpoint.h b/include/libvirt/libvirt-domain-checkpoint.h index a59578b857..1a1631b9cf 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) */ @@ -86,7 +98,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 diff --git a/include/libvirt/libvirt-domain-snapshot.h b/include/libvirt/libvirt-domain-snapshot.h index 40f7a95441..aa7bfa903a 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: v1.0.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: v1.0.0 + * */ typedef virDomainSnapshot *virDomainSnapshotPtr; @@ -49,6 +55,12 @@ const char *virDomainSnapshotGetName(virDomainSnapshotPtr snapshot); virDomainPtr virDomainSnapshotGetDomain(virDomainSnapshotPtr snapshot); virConnectPtr virDomainSnapshotGetConnect(virDomainSnapshotPtr snapshot); +/** + * virDomainSnapshotCreateFlags: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE = (1 << 0), /* Restore or alter metadata (Since: v1.0.0) */ @@ -98,7 +110,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: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_SNAPSHOT_LIST_ROOTS = (1 << 0), /* Filter by snapshots with no parents, when @@ -194,6 +210,12 @@ int virDomainSnapshotIsCurrent(virDomainSnapshotPtr snapshot, int virDomainSnapshotHasMetadata(virDomainSnapshotPtr snapshot, unsigned int flags); +/** + * virDomainSnapshotRevertFlags: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING = 1 << 0, /* Run after revert (Since: v1.0.0) */ VIR_DOMAIN_SNAPSHOT_REVERT_PAUSED = 1 << 1, /* Pause after revert (Since: v1.0.0) */ diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 4983494a0b..912ed26a56 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: v1.0.0 + * */ 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: v1.0.0 + * */ 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: v1.0.0 + * */ typedef enum { VIR_DOMAIN_NOSTATE = 0, /* no state (Since: v1.0.0) */ @@ -69,6 +78,12 @@ typedef enum { # endif } virDomainState; +/** + * virDomainNostateReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_NOSTATE_UNKNOWN = 0, @@ -77,6 +92,12 @@ typedef enum { # endif } virDomainNostateReason; +/** + * virDomainRunningReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_RUNNING_UNKNOWN = 0, VIR_DOMAIN_RUNNING_BOOTED = 1, /* normal startup from boot (Since: v1.0.0) */ @@ -96,6 +117,12 @@ typedef enum { # endif } virDomainRunningReason; +/** + * virDomainBlockedReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_BLOCKED_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ @@ -104,6 +131,12 @@ typedef enum { # endif } virDomainBlockedReason; +/** + * virDomainPausedReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_PAUSED_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ VIR_DOMAIN_PAUSED_USER = 1, /* paused on user request (Since: v1.0.0) */ @@ -125,6 +158,12 @@ typedef enum { # endif } virDomainPausedReason; +/** + * virDomainShutdownReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_SHUTDOWN_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ VIR_DOMAIN_SHUTDOWN_USER = 1, /* shutting down on user request (Since: v1.0.0) */ @@ -134,6 +173,12 @@ typedef enum { # endif } virDomainShutdownReason; +/** + * virDomainShutoffReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_SHUTOFF_UNKNOWN = 0, /* the reason is unknown (Since: v1.0.0) */ VIR_DOMAIN_SHUTOFF_SHUTDOWN = 1, /* normal shutdown (Since: v1.0.0) */ @@ -151,6 +196,12 @@ typedef enum { # endif } virDomainShutoffReason; +/** + * virDomainCrashedReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_CRASHED_UNKNOWN = 0, /* crashed for unknown reason (Since: v1.0.0) */ VIR_DOMAIN_CRASHED_PANICKED = 1, /* domain panicked (Since: v1.1.1) */ @@ -160,6 +211,12 @@ typedef enum { # endif } virDomainCrashedReason; +/** + * virDomainPMSuspendedReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_PMSUSPENDED_UNKNOWN = 0, @@ -168,6 +225,12 @@ typedef enum { # endif } virDomainPMSuspendedReason; +/** + * virDomainPMSuspendedDiskReason: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWN = 0, @@ -180,6 +243,9 @@ typedef enum { * virDomainControlState: * * Current state of a control interface to the domain. + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_CONTROL_OK = 0, /* operational, ready to accept commands (Since: v1.0.0) */ @@ -200,6 +266,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 @@ -221,6 +290,9 @@ typedef enum { * * Structure filled in by virDomainGetControlInfo and providing details about * current state of control interface to a domain. + * + * Since: v1.0.0 + * */ typedef struct _virDomainControlInfo virDomainControlInfo; struct _virDomainControlInfo { @@ -236,6 +308,9 @@ struct _virDomainControlInfo { * virDomainControlInfoPtr: * * Pointer to virDomainControlInfo structure. + * + * Since: v1.0.0 + * */ typedef virDomainControlInfo *virDomainControlInfoPtr; @@ -256,6 +331,9 @@ typedef virDomainControlInfo *virDomainControlInfoPtr; * (whether or not it is running). * * These enums should not conflict with those of virTypedParameterFlags. + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_AFFECT_CURRENT = 0, /* Affect current domain state. (Since: v1.0.0) */ @@ -265,12 +343,14 @@ typedef enum { } virDomainModificationImpact; /** - * virDomainInfoPtr: + * virDomainInfo: * * a virDomainInfo is a structure filled by virDomainGetInfo() and extracting * runtime information for a given active Domain + * + * Since: v1.0.0 + * */ - typedef struct _virDomainInfo virDomainInfo; struct _virDomainInfo { @@ -285,6 +365,9 @@ struct _virDomainInfo { * virDomainInfoPtr: * * a virDomainInfoPtr is a pointer to a virDomainInfo structure. + * + * Since: v1.0.0 + * */ typedef virDomainInfo *virDomainInfoPtr; @@ -294,6 +377,9 @@ typedef virDomainInfo *virDomainInfoPtr; * * Flags OR'ed together to provide specific behaviour when creating a * Domain. + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_NONE = 0, /* Default behavior (Since: v1.0.0) */ @@ -487,7 +573,7 @@ int virDomainSetSchedulerParametersFlags (virDomainPtr domain, unsigned int flags); /** - * virDomainBlockStats: + * virDomainBlockStatsStruct: * * Block device stats for virDomainBlockStats. * @@ -495,6 +581,9 @@ int virDomainSetSchedulerParametersFlags (virDomainPtr domain, * that the hypervisor does not support that statistic. * * NB. Here 'long long' means 64 bit integer. + * + * Since: v1.0.0 + * */ typedef struct _virDomainBlockStats virDomainBlockStatsStruct; @@ -510,6 +599,9 @@ struct _virDomainBlockStats { * virDomainBlockStatsPtr: * * A pointer to a virDomainBlockStats structure + * + * Since: v1.0.0 + * */ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; @@ -624,7 +716,7 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; # define VIR_DOMAIN_BLOCK_STATS_ERRS "errs" /** - * virDomainInterfaceStats: + * virDomainInterfaceStatsStruct: * * Network interface stats for virDomainInterfaceStats. * @@ -632,6 +724,9 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; * that the hypervisor does not support that statistic. * * NB. Here 'long long' means 64 bit integer. + * + * Since: v1.0.0 + * */ typedef struct _virDomainInterfaceStats virDomainInterfaceStatsStruct; @@ -650,11 +745,19 @@ struct _virDomainInterfaceStats { * virDomainInterfaceStatsPtr: * * A pointer to a virDomainInterfaceStats structure + * + * Since: v1.0.0 + * */ typedef virDomainInterfaceStatsStruct *virDomainInterfaceStatsPtr; /** + * virDomainMemoryStatTags: + * * Memory Statistics Tags: + * + * Since: v1.0.0 + * */ typedef enum { /* The total amount of data read from swap space (in kB). (Since: v1.0.0) */ @@ -768,6 +871,12 @@ typedef enum { # endif } virDomainMemoryStatTags; +/** + * virDomainMemoryStatStruct: + * + * Since: v1.0.0 + * + */ typedef struct _virDomainMemoryStat virDomainMemoryStatStruct; struct _virDomainMemoryStat { @@ -775,6 +884,12 @@ struct _virDomainMemoryStat { unsigned long long val; }; +/** + * *virDomainMemoryStatPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainMemoryStatStruct *virDomainMemoryStatPtr; @@ -791,6 +906,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) */ @@ -811,7 +929,14 @@ typedef enum { # endif } virDomainCoreDumpFormat; -/* Domain migration flags. */ +/** + * virDomainMigrateFlags: + * + * Domain migration flags. + * + * Since: v1.0.0 + * + */ 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. @@ -1361,7 +1486,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), @@ -1424,6 +1556,12 @@ virDomainPtr virDomainLookupByUUID (virConnectPtr conn, virDomainPtr virDomainLookupByUUIDString (virConnectPtr conn, const char *uuid); +/** + * virDomainShutdownFlagValues: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_SHUTDOWN_DEFAULT = 0, /* hypervisor choice (Since: v1.0.0) */ VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: v1.0.0) */ @@ -1437,6 +1575,12 @@ int virDomainShutdown (virDomainPtr domain); int virDomainShutdownFlags (virDomainPtr domain, unsigned int flags); +/** + * virDomainRebootFlagValues: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_REBOOT_DEFAULT = 0, /* hypervisor choice (Since: v1.0.0) */ VIR_DOMAIN_REBOOT_ACPI_POWER_BTN = (1 << 0), /* Send ACPI event (Since: v1.0.0) */ @@ -1458,6 +1602,9 @@ int virDomainDestroy (virDomainPtr domain); * * Flags used to provide specific behaviour to the * virDomainDestroyFlags() function + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_DESTROY_DEFAULT = 0, /* Default behavior - could lead to data loss!! (Since: v1.0.0) */ @@ -1487,9 +1634,13 @@ int virDomainPMWakeup (virDomainPtr domain, /** * virDomainSaveRestoreFlags: + * * Flags for use in virDomainSaveFlags(), virDomainManagedSave(), * virDomainRestoreFlags(), and virDomainSaveImageDefineXML(). Not all * flags apply to all these functions. + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_SAVE_BYPASS_CACHE = 1 << 0, /* Avoid file system cache pollution (Since: v1.0.0) */ @@ -1788,7 +1939,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, @@ -1806,6 +1964,9 @@ typedef enum { * virDomainNumatuneMemMode: * Representation of the various modes in the <numatune> element of * a domain. + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_NUMATUNE_MEM_STRICT = 0, @@ -1882,6 +2043,12 @@ char * virDomainGetHostname (virDomainPtr domain, int virDomainGetSecurityLabelList (virDomainPtr domain, virSecurityLabelPtr* seclabels); +/** + * virDomainMetadataType: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_METADATA_DESCRIPTION = 0, /* Operate on <description> (Since: v1.0.0) */ VIR_DOMAIN_METADATA_TITLE = 1, /* Operate on <title> (Since: v1.0.0) */ @@ -1909,12 +2076,15 @@ virDomainGetMetadata(virDomainPtr domain, /* * XML domain description */ + /** * virDomainXMLFlags: * * Flags available for virDomainGetXMLDesc + * + * Since: v1.0.0 + * */ - typedef enum { VIR_DOMAIN_XML_SECURE = (1 << 0), /* dump security sensitive information too (Since: v1.0.0) */ VIR_DOMAIN_XML_INACTIVE = (1 << 1), /* dump inactive domain information (Since: v1.0.0) */ @@ -1922,6 +2092,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; @@ -2047,6 +2223,9 @@ int virDomainBlockPeek (virDomainPtr dom, * virDomainBlockResizeFlags: * * Flags available for virDomainBlockResize(). + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_BLOCK_RESIZE_BYTES = 1 << 0, /* size in bytes instead of KiB (Since: v1.0.0) */ @@ -2080,8 +2259,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: v1.0.0 + * */ typedef struct _virDomainBlockInfo virDomainBlockInfo; + +/** + * virDomainBlockInfoPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainBlockInfo *virDomainBlockInfoPtr; struct _virDomainBlockInfo { unsigned long long capacity; /* logical size in bytes of the @@ -2136,6 +2325,12 @@ virDomainPtr virDomainDefineXMLFlags (virConnectPtr conn, unsigned int flags); int virDomainUndefine (virDomainPtr domain); +/** + * virDomainUndefineFlagsValues: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_UNDEFINE_MANAGED_SAVE = (1 << 0), /* Also remove any managed save (Since: v1.0.0) */ @@ -2165,6 +2360,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: v1.0.0 */ typedef enum { VIR_CONNECT_LIST_DOMAINS_ACTIVE = 1 << 0, @@ -2209,9 +2406,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: v1.0.0 + * */ - typedef enum { VIR_VCPU_OFFLINE = 0, /* the virtual CPU is offline (Since: v1.0.0) */ VIR_VCPU_RUNNING = 1, /* the virtual CPU is running (Since: v1.0.0) */ @@ -2227,6 +2428,12 @@ typedef enum { VIR_VCPU_INFO_CPU_UNAVAILABLE = -2, /* the hypervisor does not expose real CPU information (Since: v6.10.0) */ } virVcpuHostCpuState; +/** + * virVcpuInfo: + * + * Since: v1.0.0 + * + */ typedef struct _virVcpuInfo virVcpuInfo; struct _virVcpuInfo { unsigned int number; /* virtual CPU number */ @@ -2234,9 +2441,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: v1.0.0 + * + */ 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, @@ -2284,9 +2505,12 @@ 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; typedef virDomainIOThreadInfo *virDomainIOThreadInfoPtr; @@ -2485,6 +2709,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, @@ -2509,6 +2739,12 @@ int virDomainUpdateDeviceFlags(virDomainPtr domain, int virDomainDetachDeviceAlias(virDomainPtr domain, const char *alias, unsigned int flags); +/** + * virDomainStatsRecord: + * + * Since: v1.2.8 + * + */ typedef struct _virDomainStatsRecord virDomainStatsRecord; typedef virDomainStatsRecord *virDomainStatsRecordPtr; struct _virDomainStatsRecord { @@ -2517,6 +2753,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) */ @@ -2873,6 +3115,9 @@ int virDomainSetPerfEvents(virDomainPtr dom, * virDomainBlockJobType: * * Describes various possible block jobs. + * + * Since: v1.0.0 + * */ typedef enum { /* Placeholder (Since: v1.0.0) */ @@ -2923,6 +3168,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: v1.0.0 + * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC = 1 << 0, @@ -2941,6 +3189,12 @@ typedef enum { /* An iterator for monitoring block job operations */ typedef unsigned long long virDomainBlockJobCursor; +/** + * virDomainBlockJobInfo: + * + * Since: v1.0.0 + * + */ typedef struct _virDomainBlockJobInfo virDomainBlockJobInfo; struct _virDomainBlockJobInfo { int type; /* virDomainBlockJobType */ @@ -2955,6 +3209,13 @@ struct _virDomainBlockJobInfo { virDomainBlockJobCursor cur; virDomainBlockJobCursor end; }; + +/** + * *virDomainBlockJobInfoPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainBlockJobInfo *virDomainBlockJobInfoPtr; int virDomainGetBlockJobInfo(virDomainPtr dom, const char *disk, @@ -2984,6 +3245,9 @@ int virDomainBlockPull(virDomainPtr dom, const char *disk, * virDomainBlockRebaseFlags: * * Flags available for virDomainBlockRebase(). + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_BLOCK_REBASE_SHALLOW = 1 << 0, /* Limit copy to top of source @@ -3009,6 +3273,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) */ @@ -3086,6 +3353,9 @@ int virDomainBlockCopy(virDomainPtr dom, const char *disk, * virDomainBlockCommitFlags: * * Flags available for virDomainBlockCommit(). + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_BLOCK_COMMIT_SHALLOW = 1 << 0, /* NULL base means next backing @@ -3342,6 +3612,9 @@ virDomainGetBlockIoTune(virDomainPtr dom, * virDomainDiskErrorCode: * * Disk I/O error. + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_DISK_ERROR_NONE = 0, /* no error (Since: v1.0.0) */ @@ -3356,8 +3629,17 @@ typedef enum { /** * virDomainDiskError: * + * Since: v1.0.0 + * */ typedef struct _virDomainDiskError virDomainDiskError; + +/** + * *virDomainDiskErrorPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainDiskError *virDomainDiskErrorPtr; struct _virDomainDiskError { @@ -3376,6 +3658,9 @@ int virDomainGetDiskErrors(virDomainPtr dom, * virKeycodeSet: * * Enum to specify which keycode mapping is in use for virDomainSendKey(). + * + * Since: v1.0.0 + * */ typedef enum { VIR_KEYCODE_SET_LINUX = 0, @@ -3426,7 +3711,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 @@ -3435,6 +3722,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) */ @@ -3535,6 +3825,9 @@ virDomainPtr virDomainCreateLinux (virConnectPtr conn, * virDomainEventType: * * a virDomainEventType is emitted during domain lifecycle events + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_DEFINED = 0, @@ -3556,6 +3849,9 @@ typedef enum { * virDomainEventDefinedDetailType: * * Details on the cause of a 'defined' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_DEFINED_ADDED = 0, /* Newly created config file (Since: v1.0.0) */ @@ -3572,6 +3868,9 @@ typedef enum { * virDomainEventUndefinedDetailType: * * Details on the cause of an 'undefined' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_UNDEFINED_REMOVED = 0, /* Deleted the config file (Since: v1.0.0) */ @@ -3586,6 +3885,9 @@ typedef enum { * virDomainEventStartedDetailType: * * Details on the cause of a 'started' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_STARTED_BOOTED = 0, /* Normal startup from boot (Since: v1.0.0) */ @@ -3603,6 +3905,9 @@ typedef enum { * virDomainEventSuspendedDetailType: * * Details on the cause of a 'suspended' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_SUSPENDED_PAUSED = 0, /* Normal suspend due to admin pause (Since: v1.0.0) */ @@ -3624,6 +3929,9 @@ typedef enum { * virDomainEventResumedDetailType: * * Details on the cause of a 'resumed' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_RESUMED_UNPAUSED = 0, /* Normal resume due to admin unpause (Since: v1.0.0) */ @@ -3641,6 +3949,9 @@ typedef enum { * virDomainEventStoppedDetailType: * * Details on the cause of a 'stopped' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN = 0, /* Normal shutdown (Since: v1.0.0) */ @@ -3661,6 +3972,9 @@ typedef enum { * virDomainEventShutdownDetailType: * * Details on the cause of a 'shutdown' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { /* Guest finished shutdown sequence (Since: v1.0.0) */ @@ -3686,6 +4000,9 @@ typedef enum { * virDomainEventPMSuspendedDetailType: * * Details on the cause of a 'pmsuspended' lifecycle event + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY = 0, /* Guest was PM suspended to memory (Since: v1.0.0) */ @@ -3700,6 +4017,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) */ @@ -3714,6 +4034,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) */ @@ -3732,6 +4055,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 @@ -3769,6 +4095,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) */ @@ -3814,6 +4146,12 @@ int virDomainIsActive(virDomainPtr dom); int virDomainIsPersistent(virDomainPtr dom); int virDomainIsUpdated(virDomainPtr dom); +/** + * virDomainJobType: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_JOB_NONE = 0, /* No job is active (Since: v1.0.0) */ VIR_DOMAIN_JOB_BOUNDED = 1, /* Job with a finite completion time (Since: v1.0.0) */ @@ -3827,7 +4165,20 @@ typedef enum { # endif } virDomainJobType; +/** + * virDomainJobInfo: + * + * Since: v1.0.0 + * + */ typedef struct _virDomainJobInfo virDomainJobInfo; + +/** + * *virDomainJobInfoPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainJobInfo *virDomainJobInfoPtr; struct _virDomainJobInfo { /* One of virDomainJobType */ @@ -3868,6 +4219,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 @@ -3885,6 +4239,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, VIR_DOMAIN_JOB_OPERATION_START = 1, @@ -4376,6 +4736,9 @@ typedef void (*virConnectDomainEventRTCChangeCallback)(virConnectPtr conn, * virDomainEventWatchdogAction: * * The action that is to be taken due to the watchdog device firing + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_WATCHDOG_NONE = 0, /* No action, watchdog ignored (Since: v1.0.0) */ @@ -4411,6 +4774,9 @@ typedef void (*virConnectDomainEventWatchdogCallback)(virConnectPtr conn, * virDomainEventIOErrorAction: * * The action that is to be taken due to an IO error occurring + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_IO_ERROR_NONE = 0, /* No action, IO error ignored (Since: v1.0.0) */ @@ -4474,6 +4840,9 @@ typedef void (*virConnectDomainEventIOErrorReasonCallback)(virConnectPtr conn, * virDomainEventGraphicsPhase: * * The phase of the graphics client connection + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_GRAPHICS_CONNECT = 0, /* Initial socket connection established (Since: v1.0.0) */ @@ -4489,6 +4858,9 @@ typedef enum { * virDomainEventGraphicsAddressType: * * The type of address for the connection + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address (Since: v1.0.0) */ @@ -4502,22 +4874,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: v1.0.0 + * + */ typedef struct _virDomainEventGraphicsAddress virDomainEventGraphicsAddress; + +/** + * virDomainEventGraphicsAddressPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainEventGraphicsAddress *virDomainEventGraphicsAddressPtr; /** - * virDomainEventGraphicsSubjectIdentity: + * _virDomainEventGraphicsSubjectIdentity: * * The data structure representing a single identity * @@ -4528,7 +4916,21 @@ struct _virDomainEventGraphicsSubjectIdentity { char *type; /* Type of identity */ char *name; /* Identity value */ }; + +/** + * virDomainEventGraphicsSubjectIdentity: + * + * Since: v1.0.0 + * + */ typedef struct _virDomainEventGraphicsSubjectIdentity virDomainEventGraphicsSubjectIdentity; + +/** + * virDomainEventGraphicsSubjectIdentityPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainEventGraphicsSubjectIdentity *virDomainEventGraphicsSubjectIdentityPtr; @@ -4539,12 +4941,29 @@ typedef virDomainEventGraphicsSubjectIdentity *virDomainEventGraphicsSubjectIden * * A subject will have zero or more identities. The types of * identity differ according to the authentication scheme + * + * Since: v1.0.0 + * */ struct _virDomainEventGraphicsSubject { int nidentity; /* Number of identities in array*/ virDomainEventGraphicsSubjectIdentityPtr identities; /* Array of identities for subject */ }; + +/** + * virDomainEventGraphicsSubject: + * + * Since: v1.0.0 + * + */ typedef struct _virDomainEventGraphicsSubject virDomainEventGraphicsSubject; + +/** + * virDomainEventGraphicsSubjectPtr: + * + * Since: v1.0.0 + * + */ typedef virDomainEventGraphicsSubject *virDomainEventGraphicsSubjectPtr; @@ -4576,6 +4995,9 @@ typedef void (*virConnectDomainEventGraphicsCallback)(virConnectPtr conn, * * Tracks status of a virDomainBlockPull(), virDomainBlockRebase(), * virDomainBlockCopy(), or virDomainBlockCommit() operation + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_COMPLETED = 0, @@ -4623,6 +5045,9 @@ typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn, * virConnectDomainEventDiskChangeReason: * * The reason describing why this callback is called + * + * Since: v1.0.0 + * */ typedef enum { /* Removable media changed to empty according to startup policy as source @@ -4675,6 +5100,9 @@ typedef void (*virConnectDomainEventDiskChangeCallback)(virConnectPtr conn, * virDomainEventTrayChangeReason: * * The reason describing why the callback was called + * + * Since: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN = 0, @@ -5292,6 +5720,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) */ @@ -5301,6 +5735,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) */ @@ -5428,6 +5868,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: v1.0.0 + * */ typedef enum { VIR_DOMAIN_EVENT_ID_LIFECYCLE = 0, /* virConnectDomainEventCallback (Since: v1.0.0) */ @@ -5482,9 +5925,10 @@ int virConnectDomainEventDeregisterAny(virConnectPtr conn, /** - * virDomainConsoleFlags + * virDomainConsoleFlags: + * + * Since: v0.9.10 * - * Since 0.9.10 */ typedef enum { @@ -5501,9 +5945,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 @@ -5516,6 +5960,12 @@ int virDomainOpenChannel(virDomainPtr dom, virStreamPtr st, unsigned int flags); +/** + * virDomainOpenGraphicsFlags: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH = (1 << 0), } virDomainOpenGraphicsFlags; @@ -5551,6 +6001,9 @@ int virDomainFSThaw(virDomainPtr dom, * * The data structure containing mounted file systems within a guset * + * Since: v1.2.11 + * + * */ typedef struct _virDomainFSInfo virDomainFSInfo; typedef virDomainFSInfo *virDomainFSInfoPtr; @@ -5586,8 +6039,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.9.2 + * */ typedef enum { VIR_DOMAIN_SCHED_FIELD_INT = VIR_TYPED_PARAM_INT, @@ -5629,6 +6084,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: v1.0.0 + * */ typedef virSchedParameter *virSchedParameterPtr; @@ -5636,8 +6094,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.2 + * */ typedef enum { VIR_DOMAIN_BLKIO_PARAM_INT = VIR_TYPED_PARAM_INT, @@ -5678,7 +6138,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.2 + * */ typedef virBlkioParameter *virBlkioParameterPtr; @@ -5686,8 +6149,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.9.2 + * */ typedef enum { VIR_DOMAIN_MEMORY_PARAM_INT = VIR_TYPED_PARAM_INT, @@ -5728,10 +6193,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.9.2 + * */ 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) */ @@ -5742,7 +6216,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 */ @@ -5750,6 +6237,12 @@ struct _virDomainInterfaceIPAddress { unsigned int prefix; /* IP address prefix */ }; +/** + * virDomainInterface: + * + * Since: v1.0.0 + * + */ typedef struct _virDomainInterface virDomainInterface; typedef virDomainInterface *virDomainInterfacePtr; struct _virDomainInterface { @@ -5799,6 +6292,12 @@ int virDomainSetBlockThreshold(virDomainPtr domain, unsigned long long threshold, unsigned int flags); +/** + * virDomainLifecycle: + * + * Since: v3.9.0 + * + */ typedef enum { VIR_DOMAIN_LIFECYCLE_POWEROFF = 0, VIR_DOMAIN_LIFECYCLE_REBOOT = 1, @@ -5809,6 +6308,12 @@ typedef enum { # endif } virDomainLifecycle; +/** + * virDomainLifecycleAction: + * + * Since: v3.9.0 + * + */ typedef enum { VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY = 0, VIR_DOMAIN_LIFECYCLE_ACTION_RESTART = 1, /* Since: v3.9.0 */ @@ -5936,6 +6441,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) */ @@ -5952,6 +6463,12 @@ int virDomainGetGuestInfo(virDomainPtr domain, int *nparams, unsigned int flags); +/** + * virDomainAgentResponseTimeoutValues: + * + * Since: v5.10.0 + * + */ typedef enum { VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK = -2, VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT = -1, @@ -5992,6 +6509,12 @@ int virDomainAuthorizedSSHKeysSet(virDomainPtr domain, unsigned int nkeys, unsigned int flags); +/** + * virDomainMessageType: + * + * Since: v7.1.0 + * + */ typedef enum { VIR_DOMAIN_MESSAGE_DEPRECATION = (1 << 0), VIR_DOMAIN_MESSAGE_TAINTING = (1 << 1), @@ -6005,6 +6528,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 @@ -6025,6 +6551,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 facdc3a3ec..a5c73dda2a 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: v1.0.0 + * */ typedef enum { VIR_EVENT_HANDLE_READABLE = (1 << 0), diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index a31fa2d9ee..a11bfb5f95 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: v1.0.0 + * */ 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: v1.0.0 + * */ 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: v1.0.0 + * */ typedef enum { VIR_NODE_SUSPEND_TARGET_MEM = 0, @@ -64,6 +73,9 @@ typedef enum { * virStream: * * a virStream is a private structure representing a data stream. + * + * Since: v1.0.0 + * */ 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: v1.0.0 + * */ 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: v1.0.0 + * */ typedef struct _virSecurityLabel virSecurityLabel; @@ -104,6 +122,9 @@ struct _virSecurityLabel { * virSecurityLabelPtr: * * a virSecurityLabelPtr is a pointer to a virSecurityLabel. + * + * Since: v1.0.0 + * */ 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: v1.0.0 + * */ typedef struct _virSecurityModel virSecurityModel; @@ -145,6 +169,9 @@ struct _virSecurityModel { * virSecurityModelPtr: * * a virSecurityModelPtr is a pointer to a virSecurityModel. + * + * Since: v1.0.0 + * */ 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: v1.0.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: v1.0.0 + * */ typedef enum { VIR_NODE_CPU_STATS_ALL_CPUS = -1, @@ -272,6 +303,9 @@ typedef enum { * * a virNodeCPUStats is a structure filled by virNodeGetCPUStats() * providing information about the CPU stats of the node. + * + * Since: v1.0.0 + * */ 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: v1.0.0 + * */ typedef enum { VIR_NODE_MEMORY_STATS_ALL_CELLS = -1, @@ -349,6 +386,9 @@ typedef enum { * * a virNodeMemoryStats is a structure filled by virNodeGetMemoryStats() * providing information about the memory of the node. + * + * Since: v1.0.0 + * */ typedef struct _virNodeMemoryStats virNodeMemoryStats; @@ -487,6 +527,9 @@ int virNodeGetCPUMap(virConnectPtr conn, * virNodeInfoPtr: * * a virNodeInfoPtr is a pointer to a virNodeInfo structure. + * + * Since: v1.0.0 + * */ typedef virNodeInfo *virNodeInfoPtr; @@ -495,6 +538,9 @@ typedef virNodeInfo *virNodeInfoPtr; * virNodeCPUStatsPtr: * * a virNodeCPUStatsPtr is a pointer to a virNodeCPUStats structure. + * + * Since: v1.0.0 + * */ typedef virNodeCPUStats *virNodeCPUStatsPtr; @@ -503,6 +549,9 @@ typedef virNodeCPUStats *virNodeCPUStatsPtr; * virNodeMemoryStatsPtr: * * a virNodeMemoryStatsPtr is a pointer to a virNodeMemoryStats structure. + * + * Since: v1.0.0 + * */ typedef virNodeMemoryStats *virNodeMemoryStatsPtr; @@ -584,9 +633,12 @@ int virNodeGetSEVInfo (virConnectPtr conn, unsigned int flags); /** - * virConnectFlags + * virConnectFlags: * * Flags when opening a connection to a hypervisor + * + * Since: v1.0.0 + * */ typedef enum { VIR_CONNECT_RO = (1 << 0), /* A readonly connection (Since: v1.0.0) */ @@ -619,7 +671,20 @@ struct _virConnectCredential { unsigned int resultlen; /* Length of the result */ }; +/** + * virConnectCredential: + * + * Since: v1.0.0 + * + */ typedef struct _virConnectCredential virConnectCredential; + +/** + * virConnectCredentialPtr: + * + * Since: v1.0.0 + * + */ typedef virConnectCredential *virConnectCredentialPtr; @@ -648,8 +713,14 @@ struct _virConnectAuth { void *cbdata; }; - +/** + * virConnectAuth: + * + * Since: v1.0.0 + * + */ typedef struct _virConnectAuth virConnectAuth; + typedef virConnectAuth *virConnectAuthPtr; /* @@ -892,6 +963,12 @@ int virConnectIsAlive(virConnectPtr conn); * CPU specification API */ +/** + * virCPUCompareResult: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_CPU_COMPARE_ERROR = -1, VIR_CPU_COMPARE_INCOMPATIBLE = 0, @@ -903,6 +980,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 +1010,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) */ diff --git a/include/libvirt/libvirt-interface.h b/include/libvirt/libvirt-interface.h index 289c3d0b07..22a90a6452 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: v1.0.0 + * */ 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: v1.0.0 + * */ 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: v1.0.0 + * */ typedef enum { VIR_CONNECT_LIST_INTERFACES_INACTIVE = 1 << 0, diff --git a/include/libvirt/libvirt-network.h b/include/libvirt/libvirt-network.h index 3bf6df34a7..ab8b34ae1c 100644 --- a/include/libvirt/libvirt-network.h +++ b/include/libvirt/libvirt-network.h @@ -35,6 +35,9 @@ typedef enum { * virNetwork: * * a virNetwork is a private structure representing a virtual network. + * + * Since: v1.0.0 + * */ typedef struct _virNetwork virNetwork; @@ -43,6 +46,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: v1.0.0 + * */ typedef virNetwork *virNetworkPtr; @@ -51,6 +57,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 +68,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 +94,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: v1.0.0 + * */ typedef enum { VIR_CONNECT_LIST_NETWORKS_INACTIVE = 1 << 0, @@ -150,6 +165,8 @@ int virNetworkUndefine (virNetworkPtr network); * describes which type of update to perform on a <network> * definition. * + * Since: v1.0.0 + * */ typedef enum { VIR_NETWORK_UPDATE_COMMAND_NONE = 0, /* (invalid (Since: v1.0.0)) */ @@ -168,6 +185,8 @@ typedef enum { * describes which section of a <network> definition the provided * xml should be applied to. * + * Since: v1.0.0 + * */ typedef enum { VIR_NETWORK_SECTION_NONE = 0, /* (invalid (Since: v1.0.0)) */ @@ -192,6 +211,9 @@ typedef enum { * virNetworkUpdateFlags: * * Flags to control options for virNetworkUpdate() + * + * Since: v1.0.0 + * */ typedef enum { VIR_NETWORK_UPDATE_AFFECT_CURRENT = 0, /* affect live if network is active, @@ -246,6 +268,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, @@ -295,6 +320,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) */ @@ -309,6 +337,12 @@ typedef enum { # endif } virNetworkEventID; +/** + * virIPAddrType: + * + * Since: v1.2.6 + * + */ typedef enum { VIR_IP_ADDR_TYPE_IPV4, VIR_IP_ADDR_TYPE_IPV6, @@ -318,6 +352,12 @@ typedef enum { # endif } virIPAddrType; +/** + * virNetworkDHCPLease: + * + * Since: v1.2.6 + * + */ typedef struct _virNetworkDHCPLease virNetworkDHCPLease; typedef virNetworkDHCPLease *virNetworkDHCPLeasePtr; struct _virNetworkDHCPLease { @@ -375,6 +415,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 589495213c..a19821bb75 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: v1.0.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: v1.0.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: v1.0.0 + * + */ typedef enum { VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM = 1 << 0, /* System capability (Since: v1.0.0) */ VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEV = 1 << 1, /* PCI device (Since: v1.0.0) */ @@ -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) */ @@ -215,6 +228,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, diff --git a/include/libvirt/libvirt-nwfilter.h b/include/libvirt/libvirt-nwfilter.h index aa8872e156..5c78ea9d8b 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: v1.0.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: v1.0.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; diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-secret.h index cd636f14be..9f4f60dcaa 100644 --- a/include/libvirt/libvirt-secret.h +++ b/include/libvirt/libvirt-secret.h @@ -33,10 +33,19 @@ * * A virSecret stores a secret value (e.g. a passphrase or encryption key) * and associated metadata. + * + * Since: v1.0.0 + * */ typedef struct _virSecret virSecret; typedef virSecret *virSecretPtr; +/** + * virSecretUsageType: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_SECRET_USAGE_TYPE_NONE = 0, VIR_SECRET_USAGE_TYPE_VOLUME = 1, @@ -61,11 +70,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: v1.0.0 + * */ typedef enum { VIR_CONNECT_LIST_SECRETS_EPHEMERAL = 1 << 0, /* kept in memory, never @@ -132,6 +144,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) */ @@ -179,6 +194,9 @@ int virConnectSecretEventDeregisterAny(virConnectPtr conn, * * a virSecretEventLifecycleType is emitted during secret * lifecycle events + * + * Since: v3.0.0 + * */ typedef enum { VIR_SECRET_EVENT_DEFINED = 0, diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h index a0c4dab809..c86b1439b6 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: v1.0.0 + * */ 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: v1.0.0 + * */ typedef virStoragePool *virStoragePoolPtr; +/** + * virStoragePoolState: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_STORAGE_POOL_INACTIVE = 0, /* Not running (Since: v1.0.0) */ VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available (Since: v1.0.0) */ @@ -69,6 +81,12 @@ typedef enum { VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: v1.0.0) */ } 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 +111,12 @@ typedef enum { VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE = 1 << 2, } virStoragePoolCreateFlags; +/** + * virStoragePoolInfo: + * + * Since: v1.0.0 + * + */ typedef struct _virStoragePoolInfo virStoragePoolInfo; struct _virStoragePoolInfo { @@ -102,6 +126,12 @@ struct _virStoragePoolInfo { unsigned long long available; /* Remaining free space bytes */ }; +/** + * virStoragePoolInfoPtr: + * + * Since: v1.0.0 + * + */ typedef virStoragePoolInfo *virStoragePoolInfoPtr; @@ -109,6 +139,9 @@ typedef virStoragePoolInfo *virStoragePoolInfoPtr; * virStorageVol: * * a virStorageVol is a private structure representing a storage volume + * + * Since: v1.0.0 + * */ typedef struct _virStorageVol virStorageVol; @@ -117,10 +150,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: v1.0.0 + * */ typedef virStorageVol *virStorageVolPtr; +/** + * virStorageVolType: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes (Since: v1.0.0) */ VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes (Since: v1.0.0) */ @@ -135,12 +177,24 @@ typedef enum { # endif } virStorageVolType; +/** + * virStorageVolDeleteFlags: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) (Since: v1.0.0) */ VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) (Since: v1.0.0) */ VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTS = 1 << 1, /* Force removal of volume, even if in use (Since: v1.2.21) */ } virStorageVolDeleteFlags; +/** + * virStorageVolWipeAlgorithm: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes (Since: v1.0.0) */ VIR_STORAGE_VOL_WIPE_ALG_NNSA = 1, /* 4-pass NNSA Policy Letter @@ -173,6 +227,12 @@ typedef enum { # endif } virStorageVolWipeAlgorithm; +/** + * virStorageVolInfoFlags: + * + * Since: v3.0.0 + * + */ typedef enum { VIR_STORAGE_VOL_USE_ALLOCATION = 0, @@ -181,6 +241,12 @@ typedef enum { } virStorageVolInfoFlags; +/** + * virStorageVolInfo: + * + * Since: v1.0.0 + * + */ typedef struct _virStorageVolInfo virStorageVolInfo; struct _virStorageVolInfo { @@ -226,6 +292,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, @@ -351,6 +420,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, VIR_STORAGE_VOL_CREATE_REFLINK = 1 << 1, /* perform a btrfs lightweight copy (Since: v1.2.13) */ @@ -432,6 +507,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) */ @@ -479,6 +557,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, diff --git a/include/libvirt/libvirt-stream.h b/include/libvirt/libvirt-stream.h index 076f9ee8b8..5feb66ac35 100644 --- a/include/libvirt/libvirt-stream.h +++ b/include/libvirt/libvirt-stream.h @@ -28,6 +28,12 @@ # endif +/** + * virStreamFlags: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_STREAM_NONBLOCK = (1 << 0), } 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), } virStreamRecvFlagsValues; @@ -229,6 +241,12 @@ int virStreamSparseRecvAll(virStreamPtr stream, virStreamSinkHoleFunc holeHandler, void *opaque); +/** + * virStreamEventType: + * + * Since: v1.0.0 + * + */ typedef enum { VIR_STREAM_EVENT_READABLE = (1 << 0), VIR_STREAM_EVENT_WRITABLE = (1 << 1), diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h index 5cdcf17dd9..4feaffd1e3 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: v1.0.0 + * */ typedef enum { VIR_ERR_NONE = 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: v1.0.0 + * */ typedef enum { VIR_FROM_NONE = 0, @@ -152,6 +158,9 @@ 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: v1.0.0 + * */ typedef struct _virError virError; @@ -205,6 +214,9 @@ struct _virError { * break; * default: * } + * + * Since: v1.0.0 + * */ typedef enum { VIR_ERR_OK = 0, -- 2.35.1

With style fixes. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-admin.h | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/include/libvirt/libvirt-admin.h b/include/libvirt/libvirt-admin.h index f54aeb0c1d..2bfb45145d 100644 --- a/include/libvirt/libvirt-admin.h +++ b/include/libvirt/libvirt-admin.h @@ -37,6 +37,9 @@ extern "C" { * * a virAdmConnect is a private structure representing a connection to * libvirt daemon. + * + * Since: v1.2.17 + * */ typedef struct _virAdmConnect virAdmConnect; @@ -45,6 +48,9 @@ typedef struct _virAdmConnect virAdmConnect; * * a virAdmServer is a private structure and client-side representation of * a remote server object + * + * Since: v1.3.2 + * */ typedef struct _virAdmServer virAdmServer; @@ -53,6 +59,9 @@ 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: v1.3.5 + * */ typedef struct _virAdmClient virAdmClient; @@ -62,6 +71,9 @@ typedef struct _virAdmClient virAdmClient; * a virAdmConnectPtr is pointer to a virAdmConnect private structure, * this is the type used to reference a connection to the daemon * in the API. + * + * Since: v1.2.17 + * */ typedef virAdmConnect *virAdmConnectPtr; @@ -71,6 +83,9 @@ typedef virAdmConnect *virAdmConnectPtr; * a virAdmServerPtr is a pointer to a virAdmServer structure, * this is the type used to reference client-side representation of a * remote server object throughout all the APIs. + * + * Since: v1.3.2 + * */ typedef virAdmServer *virAdmServerPtr; @@ -80,6 +95,9 @@ typedef virAdmServer *virAdmServerPtr; * a virAdmClientPtr is a pointer to a virAdmClient structure, * this is the type used to reference client-side representation of a * client object throughout all the APIs. + * + * Since: v1.3.5 + * */ typedef virAdmClient *virAdmClientPtr; @@ -222,6 +240,12 @@ long long virAdmClientGetTimestamp(virAdmClientPtr client); int virAdmClientGetTransport(virAdmClientPtr client); int virAdmClientFree(virAdmClientPtr client); +/** + * virClientTransport: + * + * Since: v1.3.5 + * + */ typedef enum { VIR_CLIENT_TRANS_UNIX = 0, /* connection via UNIX socket (Since: v1.3.5) */ VIR_CLIENT_TRANS_TCP, /* connection via unencrypted TCP socket (Since: v1.3.5) */ -- 2.35.1

Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-qemu.h | 3 +++ src/libvirt-qemu.c | 18 ++++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/include/libvirt/libvirt-qemu.h b/include/libvirt/libvirt-qemu.h index 838b6e9caf..b85e77f5b1 100644 --- a/include/libvirt/libvirt-qemu.h +++ b/include/libvirt/libvirt-qemu.h @@ -80,6 +80,9 @@ 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 + * */ typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn, virDomainPtr dom, diff --git a/src/libvirt-qemu.c b/src/libvirt-qemu.c index 896aba2f0b..4d0f1f1cca 100644 --- a/src/libvirt-qemu.c +++ b/src/libvirt-qemu.c @@ -61,6 +61,9 @@ VIR_LOG_INIT("libvirt-qemu"); * * Returns 0 in case of success, -1 in case of failure * + * Since: v1.0.0 + * + * */ int virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd, @@ -131,6 +134,9 @@ virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd, * @cmd, and the caller must free this string. * * Returns 0 in case of success, -1 in case of failure + * + * Since: v8.2.0 + * */ int virDomainQemuMonitorCommandWithFiles(virDomainPtr domain, @@ -216,6 +222,9 @@ virDomainQemuMonitorCommandWithFiles(virDomainPtr domain, * normally (provided the above requirements were honored). * * Returns a new domain object on success, NULL otherwise + * + * Since: v1.0.0 + * */ virDomainPtr virDomainQemuAttach(virConnectPtr conn, @@ -272,6 +281,9 @@ virDomainQemuAttach(virConnectPtr conn, * positive value: wait for @timeout seconds * * Returns strings if success, NULL in failure. + * + * Since: v1.0.0 + * */ char * virDomainQemuAgentCommand(virDomainPtr domain, @@ -350,6 +362,9 @@ virDomainQemuAgentCommand(virDomainPtr domain, * be passed to the virConnectDomainQemuMonitorEventDeregister() method. * * Returns a callback identifier on success, -1 on failure + * + * Since: v1.2.3 + * */ int virConnectDomainQemuMonitorEventRegister(virConnectPtr conn, @@ -404,6 +419,9 @@ virConnectDomainQemuMonitorEventRegister(virConnectPtr conn, * method. * * Returns 0 on success, -1 on failure + * + * Since: v1.2.3 + * */ int virConnectDomainQemuMonitorEventDeregister(virConnectPtr conn, -- 2.35.1

Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-admin.h | 3 ++ src/admin/libvirt-admin.c | 93 +++++++++++++++++++++++++++++++++ 2 files changed, 96 insertions(+) diff --git a/include/libvirt/libvirt-admin.h b/include/libvirt/libvirt-admin.h index 2bfb45145d..f2cb528524 100644 --- a/include/libvirt/libvirt-admin.h +++ b/include/libvirt/libvirt-admin.h @@ -126,6 +126,9 @@ int virAdmConnectGetLibVersion(virAdmConnectPtr conn, * @opaque: opaque client data * * A callback to be registered, in case a connection was closed. + * + * Since: v1.3.1 + * */ typedef void (*virAdmConnectCloseFunc)(virAdmConnectPtr conn, int reason, diff --git a/src/admin/libvirt-admin.c b/src/admin/libvirt-admin.c index 01546a7bc2..35470c866e 100644 --- a/src/admin/libvirt-admin.c +++ b/src/admin/libvirt-admin.c @@ -84,6 +84,9 @@ virAdmGlobalInit(void) * necessary for the application to call virAdmInitialize. * * Returns 0 in case of success, -1 in case of error + * + * Since: v2.0.0 + * */ int virAdmInitialize(void) @@ -200,6 +203,9 @@ virAdmGetDefaultURI(virConf *conf, char **uristr) * Opens connection to admin interface of the daemon. * * Returns @virAdmConnectPtr object or NULL on error + * + * Since: v1.2.17 + * */ virAdmConnectPtr virAdmConnectOpen(const char *name, unsigned int flags) @@ -284,6 +290,9 @@ virAdmConnectOpen(const char *name, unsigned int flags) * some other object still has a temporary reference to the connection, but the * application should not try to further use a connection after the * virAdmConnectClose that matches the initial open. + * + * Since: v1.2.17 + * */ int virAdmConnectClose(virAdmConnectPtr conn) @@ -319,6 +328,9 @@ virAdmConnectClose(virAdmConnectPtr conn) * would increment the reference count. * * Returns 0 in case of success, -1 in case of failure + * + * Since: v1.2.17 + * */ int virAdmConnectRef(virAdmConnectPtr conn) @@ -346,6 +358,9 @@ virAdmConnectRef(virAdmConnectPtr conn) * instead. * * Returns 0 on success, -1 in case of an error. + * + * Since: v1.3.0 + * */ int virAdmGetVersion(unsigned long long *libVer) @@ -377,6 +392,9 @@ 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: v1.3.1 + * */ int virAdmConnectIsAlive(virAdmConnectPtr conn) @@ -411,6 +429,9 @@ 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: v1.3.1 + * */ char * virAdmConnectGetURI(virAdmConnectPtr conn) @@ -445,6 +466,9 @@ virAdmConnectGetURI(virAdmConnectPtr conn) * context. * * Returns 0 on success, -1 on error + * + * Since: v1.3.1 + * */ int virAdmConnectRegisterCloseCallback(virAdmConnectPtr conn, virAdmConnectCloseFunc cb, @@ -498,6 +522,9 @@ int virAdmConnectRegisterCloseCallback(virAdmConnectPtr conn, * registration, it will be invoked. * * Returns 0 on success, -1 on error + * + * Since: v1.3.1 + * */ int virAdmConnectUnregisterCloseCallback(virAdmConnectPtr conn, virAdmConnectCloseFunc cb) @@ -528,6 +555,9 @@ int virAdmConnectUnregisterCloseCallback(virAdmConnectPtr conn, * major * 1,000,000 + minor * 1,000 + release. * * Returns 0 on success, -1 on failure and @libVer follows this format: + * + * Since: v1.3.1 + * */ int virAdmConnectGetLibVersion(virAdmConnectPtr conn, unsigned long long *libVer) @@ -556,6 +586,9 @@ 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: v1.3.2 + * */ const char * virAdmServerGetName(virAdmServerPtr srv) @@ -576,6 +609,9 @@ virAdmServerGetName(virAdmServerPtr srv) * The data structure is freed and should not be used thereafter. * * Returns 0 on success, -1 on failure. + * + * Since: v1.3.2 + * */ int virAdmServerFree(virAdmServerPtr srv) { @@ -599,6 +635,9 @@ int virAdmServerFree(virAdmServerPtr srv) * Get client's unique numeric ID. * * Returns numeric value used for client's ID or -1 in case of an error. + * + * Since: v1.3.5 + * */ unsigned long long virAdmClientGetID(virAdmClientPtr client) @@ -622,6 +661,9 @@ virAdmClientGetID(virAdmClientPtr client) * Returns client's connection timestamp (seconds from epoch in UTC) or 0 * (epoch time) if libvirt doesn't have any information about client's * connection time, or -1 in case of an error. + * + * Since: v1.3.5 + * */ long long virAdmClientGetTimestamp(virAdmClientPtr client) @@ -647,6 +689,9 @@ 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: v1.3.5 + * */ int virAdmClientGetTransport(virAdmClientPtr client) @@ -666,6 +711,9 @@ virAdmClientGetTransport(virAdmClientPtr client) * structure is freed and should not be used thereafter. * * Returns 0 in success, -1 on failure. + * + * Since: v1.3.5 + * */ int virAdmClientFree(virAdmClientPtr client) { @@ -697,6 +745,9 @@ int virAdmClientFree(virAdmClientPtr client) * this extra element from the final count. * Caller is responsible to call virAdmServerFree() on each list element, * followed by freeing @servers. + * + * Since: v1.3.2 + * */ int virAdmConnectListServers(virAdmConnectPtr conn, @@ -735,6 +786,9 @@ 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: v1.3.3 + * */ virAdmServerPtr virAdmConnectLookupServer(virAdmConnectPtr conn, @@ -776,6 +830,9 @@ virAdmConnectLookupServer(virAdmConnectPtr conn, * VIR_THREADPOOL_WORKERS_CURRENT * * Returns 0 on success, -1 in case of an error. + * + * Since: v1.3.4 + * */ int virAdmServerGetThreadPoolParameters(virAdmServerPtr srv, @@ -815,6 +872,9 @@ virAdmServerGetThreadPoolParameters(virAdmServerPtr srv, * failure. * * Returns 0 on success, -1 in case of an error. + * + * Since: v1.3.4 + * */ int virAdmServerSetThreadPoolParameters(virAdmServerPtr srv, @@ -856,6 +916,9 @@ virAdmServerSetThreadPoolParameters(virAdmServerPtr srv, * excluding this extra element from the final count. * Caller is responsible to call virAdmClientFree() on each list element, * followed by freeing @clients. + * + * Since: v1.3.5 + * */ int virAdmServerListClients(virAdmServerPtr srv, @@ -894,6 +957,9 @@ 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: v1.3.5 + * */ virAdmClientPtr virAdmServerLookupClient(virAdmServerPtr srv, @@ -940,6 +1006,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * Returns 0 if the information has been successfully retrieved or -1 in case * of an error. + * + * Since: v1.3.5 + * */ int virAdmClientGetInfo(virAdmClientPtr client, @@ -974,6 +1043,9 @@ virAdmClientGetInfo(virAdmClientPtr client, * * Returns 0 if the daemon's connection with @client was closed successfully * or -1 in case of an error. + * + * Since: v1.3.5 + * */ int virAdmClientClose(virAdmClientPtr client, unsigned int flags) @@ -1011,6 +1083,9 @@ 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: v1.3.5 + * */ int virAdmServerGetClientLimits(virAdmServerPtr srv, @@ -1051,6 +1126,9 @@ virAdmServerGetClientLimits(virAdmServerPtr srv, * * Returns 0 if the limits have been changed successfully or -1 in case of an * error. + * + * Since: v1.3.5 + * */ int virAdmServerSetClientLimits(virAdmServerPtr srv, @@ -1089,6 +1167,9 @@ virAdmServerSetClientLimits(virAdmServerPtr srv, * * Returns 0 if the TLS files have been updated successfully or -1 in case of an * error. + * + * Since: v6.2.0 + * */ int virAdmServerUpdateTlsFiles(virAdmServerPtr srv, @@ -1127,6 +1208,9 @@ virAdmServerUpdateTlsFiles(virAdmServerPtr srv, * caller. Caller is also responsible for freeing @outputs correctly. * * Returns the count of outputs in @outputs, or -1 in case of an error. + * + * Since: v3.0.0 + * */ int virAdmConnectGetLoggingOutputs(virAdmConnectPtr conn, @@ -1168,6 +1252,9 @@ virAdmConnectGetLoggingOutputs(virAdmConnectPtr conn, * * Returns the number of filters returned in @filters, or -1 in case of * an error. + * + * Since: v3.0.0 + * */ int virAdmConnectGetLoggingFilters(virAdmConnectPtr conn, @@ -1208,6 +1295,9 @@ 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 + * */ int virAdmConnectSetLoggingOutputs(virAdmConnectPtr conn, @@ -1246,6 +1336,9 @@ 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 + * */ int virAdmConnectSetLoggingFilters(virAdmConnectPtr conn, -- 2.35.1

This commit finishes the script work and adds docstring to types that are not documented. Further commits will enforce that it stays like that with new additions. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- src/libvirt-domain.c | 3 +++ src/libvirt-network.c | 12 ++++++++++++ src/libvirt-nwfilter.c | 9 +++++++++ src/libvirt-storage.c | 3 +++ 4 files changed, 27 insertions(+) diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c index b9c0a65cfa..76b4b7e67d 100644 --- a/src/libvirt-domain.c +++ b/src/libvirt-domain.c @@ -409,6 +409,9 @@ 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: v1.0.0 + * */ virDomainPtr virDomainLookupByUUIDString(virConnectPtr conn, const char *uuidstr) diff --git a/src/libvirt-network.c b/src/libvirt-network.c index eae005e91f..e03f1f0910 100644 --- a/src/libvirt-network.c +++ b/src/libvirt-network.c @@ -470,6 +470,9 @@ virNetworkCreateXML(virConnectPtr conn, const char *xmlDesc) * network object is no longer needed. * * Returns a new network object or NULL in case of failure + * + * Since: v7.8.0 + * */ virNetworkPtr virNetworkCreateXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags) @@ -554,6 +557,9 @@ virNetworkDefineXML(virConnectPtr conn, const char *xml) * network object is no longer needed. * * Returns NULL in case of error, a pointer to the network otherwise + * + * Since: v7.7.0 + * */ virNetworkPtr virNetworkDefineXMLFlags(virConnectPtr conn, const char *xml, unsigned int flags) @@ -640,6 +646,9 @@ virNetworkUndefine(virNetworkPtr network) * running state, its persistent configuration, or both. * * Returns 0 in case of success, -1 in case of error + * + * Since: v1.0.0 + * */ int virNetworkUpdate(virNetworkPtr network, @@ -1776,6 +1785,9 @@ virNetworkPortGetUUID(virNetworkPortPtr port, * UUID see RFC4122. * * Returns -1 in case of error, 0 in case of success + * + * Since: v5.5.0 + * */ int virNetworkPortGetUUIDString(virNetworkPortPtr port, diff --git a/src/libvirt-nwfilter.c b/src/libvirt-nwfilter.c index 1204d2fdbe..17eed96c0a 100644 --- a/src/libvirt-nwfilter.c +++ b/src/libvirt-nwfilter.c @@ -455,6 +455,9 @@ virNWFilterDefineXML(virConnectPtr conn, const char *xmlDesc) * nwfilter object is no longer needed. * * Returns a new nwfilter object or NULL in case of failure + * + * Since: v7.7.0 + * */ virNWFilterPtr virNWFilterDefineXMLFlags(virConnectPtr conn, const char *xmlDesc, unsigned int flags) @@ -616,6 +619,9 @@ virNWFilterRef(virNWFilterPtr nwfilter) * have an extra allocated element set to NULL but not included in the return count, * to make iteration easier. The caller is responsible for calling * virNWFilterFree() on each array element, then calling free() on @filters. + * + * Since: v4.5.0 + * */ int virConnectListAllNWFilterBindings(virConnectPtr conn, @@ -875,6 +881,9 @@ virNWFilterBindingDelete(virNWFilterBindingPtr binding) * * Returns a 0 terminated UTF-8 encoded XML instance, or NULL in case * of error. The caller must free() the returned value. + * + * Since: v4.5.0 + * */ char * virNWFilterBindingGetXMLDesc(virNWFilterBindingPtr binding, unsigned int flags) diff --git a/src/libvirt-storage.c b/src/libvirt-storage.c index 33b7ff8c39..bf819d9268 100644 --- a/src/libvirt-storage.c +++ b/src/libvirt-storage.c @@ -466,6 +466,9 @@ virStoragePoolLookupByUUID(virConnectPtr conn, * storage pool object is no longer needed. * * Returns a virStoragePoolPtr object, or NULL if no matching pool is found + * + * Since: v1.0.0 + * */ virStoragePoolPtr virStoragePoolLookupByUUIDString(virConnectPtr conn, -- 2.35.1

This commit finishes the script work and adds docstring to types that are not documented. Further commits will enforce that it stays like that with new additions. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain.h | 27 ++++++++++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 9163c9dcab..20a476412f 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -6244,6 +6244,14 @@ typedef enum { */ # define VIR_DOMAIN_SCHED_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH +/** + * _virSchedParameter: + * + * Since: v0.9.2 + * + */ +# define _virSchedParameter _virTypedParameter + /** * virSchedParameter: * @@ -6254,7 +6262,6 @@ typedef enum { * Since: v0.9.2 * */ -# define _virSchedParameter _virTypedParameter typedef struct _virTypedParameter virSchedParameter; /** @@ -6299,6 +6306,14 @@ typedef enum { */ # define VIR_DOMAIN_BLKIO_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH +/** + * _virBlkioParameter: + * + * Since: v0.9.2 + * + */ +# define _virBlkioParameter _virTypedParameter + /** * virBlkioParameter: * @@ -6309,7 +6324,6 @@ typedef enum { * Since: v0.9.2 * */ -# define _virBlkioParameter _virTypedParameter typedef struct _virTypedParameter virBlkioParameter; /** @@ -6354,6 +6368,14 @@ typedef enum { */ # define VIR_DOMAIN_MEMORY_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH +/** + * _virMemoryParameter: + * + * Since: v0.9.2 + * + */ +# define _virMemoryParameter _virTypedParameter + /** * virMemoryParameter: * @@ -6364,7 +6386,6 @@ typedef enum { * Since: v0.9.2 * */ -# define _virMemoryParameter _virTypedParameter typedef struct _virTypedParameter virMemoryParameter; /** -- 2.35.1

This commit is similar to "docs: Fix generated documentation of virConnectListAllNodeDeviceFlags", check it out for more info. Using git diff --word-diff to show the fixed output xml (redacted). <enum name='VIR_STORAGE_VOL_GET_PHYSICAL' ... [-type='virStorageVolInfoFlags'/>-] {+type='virStorageVolInfoFlags' version='3.0.0' info='Return the physical size in allocation'/>+} ... <enum name='VIR_STORAGE_VOL_USE_ALLOCATION' ... type='virStorageVolInfoFlags' [-info='Return the physical size in allocation'/>-] {+version='3.0.0'/>+} Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-storage.h | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h index 9a0439f348..9d220c6f3c 100644 --- a/include/libvirt/libvirt-storage.h +++ b/include/libvirt/libvirt-storage.h @@ -248,11 +248,8 @@ typedef enum { * */ typedef enum { - VIR_STORAGE_VOL_USE_ALLOCATION = 0, - - /* Return the physical size in allocation */ - VIR_STORAGE_VOL_GET_PHYSICAL = 1 << 0, - + 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) */ } virStorageVolInfoFlags; /** -- 2.35.1

Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain.h | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 20a476412f..8f9a3775f2 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -2758,18 +2758,18 @@ int virDomainGetVcpus (virDomainPtr domain, /** * virDomainDeviceModifyFlags: * + * These flags may be bitwise-OR'd in. + * * Since: v1.0.0 * */ typedef enum { - /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ - VIR_DOMAIN_DEVICE_MODIFY_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, - VIR_DOMAIN_DEVICE_MODIFY_LIVE = VIR_DOMAIN_AFFECT_LIVE, - VIR_DOMAIN_DEVICE_MODIFY_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, + VIR_DOMAIN_DEVICE_MODIFY_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: v1.0.0) */ + VIR_DOMAIN_DEVICE_MODIFY_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* (Since: v1.0.0) */ + VIR_DOMAIN_DEVICE_MODIFY_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* (Since: v1.0.0) */ - /* Additionally, these flags may be bitwise-OR'd in. (Since: v1.0.0) */ VIR_DOMAIN_DEVICE_MODIFY_FORCE = (1 << 2), /* Forcibly modify device - (ex. force eject a cdrom) */ + (ex. force eject a cdrom) (Since: v1.0.0) */ } virDomainDeviceModifyFlags; int virDomainAttachDevice(virDomainPtr domain, const char *xml); -- 2.35.1

Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- include/libvirt/libvirt-domain.h | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 015bc2faa4..451a398c42 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -2491,20 +2491,19 @@ typedef virVcpuInfo *virVcpuInfoPtr; * virDomainVcpuFlags: * * Flags for controlling virtual CPU hot-plugging. + * These flags may be bitwise-OR'd in. * * Since: v1.0.0 * */ typedef enum { - /* See virDomainModificationImpact for these flags. (Since: v1.0.0) */ - VIR_DOMAIN_VCPU_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, - VIR_DOMAIN_VCPU_LIVE = VIR_DOMAIN_AFFECT_LIVE, - VIR_DOMAIN_VCPU_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, + VIR_DOMAIN_VCPU_CURRENT = VIR_DOMAIN_AFFECT_CURRENT, /* See virDomainModificationImpact (Since: v1.0.0) */ + VIR_DOMAIN_VCPU_LIVE = VIR_DOMAIN_AFFECT_LIVE, /* See virDomainModificationImpact (Since: v1.0.0) */ + VIR_DOMAIN_VCPU_CONFIG = VIR_DOMAIN_AFFECT_CONFIG, /* See virDomainModificationImpact (Since: v1.0.0) */ - /* Additionally, these flags may be bitwise-OR'd in. (Since: v1.0.0) */ VIR_DOMAIN_VCPU_MAXIMUM = (1 << 2), /* Max rather than current count (Since: v1.1.0) */ VIR_DOMAIN_VCPU_GUEST = (1 << 3), /* Modify state of the cpu in the guest (Since: v2.4.0) */ - VIR_DOMAIN_VCPU_HOTPLUGGABLE = (1 << 4), /* Make vcpus added hot(un)pluggable */ + VIR_DOMAIN_VCPU_HOTPLUGGABLE = (1 << 4), /* Make vcpus added hot(un)pluggable (Since: v2.4.0) */ } virDomainVcpuFlags; int virDomainSetVcpus (virDomainPtr domain, -- 2.35.1

Removed the TODO as we can rely to the serialize_typedef() the job to report missing comments. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- scripts/apibuild.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/scripts/apibuild.py b/scripts/apibuild.py index 4e9f802bde..5335670c1c 100755 --- a/scripts/apibuild.py +++ b/scripts/apibuild.py @@ -1145,6 +1145,12 @@ class CParser: def parseTypedef(self, token): if token is None: return None + + # With typedef enum types, we can have comments parsed before the + # enum themselves. The parsing of enum values does clear the + # self.comment variable. So we store it here for later. + typedef_comment = self.comment + token = self.parseType(token) if token is None: self.error("parsing typedef") @@ -1168,7 +1174,7 @@ class CParser: "struct", type) base_type = "struct " + name else: - # TODO report missing or misformatted comments + self.comment = typedef_comment info = self.parseTypeComment(name, 1) self.index_add(name, self.filename, not self.is_header, "typedef", type, info) -- 2.35.1

This patch adds 'version' parameter to the generated XML API for macros It'll require, for new additions, to add a comment with the version that the macro was added. An example bellow of code diff and the change in the generated XML. Note that the Since tag is removed from the comment as there is a proper field for it in the XML. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- scripts/apibuild.py | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/scripts/apibuild.py b/scripts/apibuild.py index da70d67fa6..c4ff733550 100755 --- a/scripts/apibuild.py +++ b/scripts/apibuild.py @@ -2265,11 +2265,15 @@ class docBuilder: output.write(" string='%s'" % strValue) else: output.write(" raw='%s'" % escape(rawValue)) + + (since, comment) = self.retrieve_comment_tags(name, desc) + if len(since) > 0: + output.write(" version='%s'" % escape(since)) output.write(">\n") - if desc is not None and desc != "": - output.write(" <info><![CDATA[%s]]></info>\n" % (desc)) - self.indexString(name, desc) + if comment is not None and comment != "": + output.write(" <info><![CDATA[%s]]></info>\n" % (comment)) + self.indexString(name, comment) for arg in args: (name, desc) = arg if desc is not None and desc != "": -- 2.35.1

So we can use for comments that are being hold in helper variables. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- scripts/apibuild.py | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/scripts/apibuild.py b/scripts/apibuild.py index d16beaa4ae..97f448f6bf 100755 --- a/scripts/apibuild.py +++ b/scripts/apibuild.py @@ -722,15 +722,18 @@ class CParser: line = line.replace('*', '', 1) return line - def cleanupComment(self): - if not isinstance(self.comment, str): - return - # remove the leading * on multi-line comments - lines = self.comment.splitlines(True) + def cleanup_code_comment(self, comment: str) -> str: + if not isinstance(self.comment, str) or comment == "": + return "" + + lines = comment.splitlines(True) com = "" for line in lines: com = com + self.strip_lead_star(line) - self.comment = com.strip() + return com.strip() + + def cleanupComment(self): + self.comment = self.cleanup_code_comment(self.comment) def parseComment(self, token): com = token[1] -- 2.35.1

Discover this mismatch with the docstring work. scripts/apibuild.py complained. Signed-off-by: Victor Toso <victortoso(a)redhat.com&gt; --- src/admin/libvirt_admin_public.syms | 58 ++++++++++++++++++++++------- 1 file changed, 45 insertions(+), 13 deletions(-) diff --git a/src/admin/libvirt_admin_public.syms b/src/admin/libvirt_admin_public.syms index 8126973e5b..79bfb76822 100644 --- a/src/admin/libvirt_admin_public.syms +++ b/src/admin/libvirt_admin_public.syms @@ -10,36 +10,63 @@ # soname version info can't enforce this since we never # change the soname # -LIBVIRT_ADMIN_2.0.0 { +LIBVIRT_ADMIN_1.2.17 { global: - virAdmInitialize; - virAdmClientFree; - virAdmClientGetID; - virAdmClientGetTimestamp; - virAdmClientGetTransport; virAdmConnectOpen; virAdmConnectClose; virAdmConnectRef; +}; + +LIBVIRT_ADMIN_1.3.0 { + global: virAdmGetVersion; +} LIBVIRT_ADMIN_1.2.17; + +LIBVIRT_ADMIN_1.3.1 { + global: virAdmConnectIsAlive; virAdmConnectGetURI; virAdmConnectGetLibVersion; virAdmConnectRegisterCloseCallback; virAdmConnectUnregisterCloseCallback; - virAdmConnectListServers; +} LIBVIRT_ADMIN_1.3.0; + +LIBVIRT_ADMIN_1.3.2 { + global: virAdmServerGetName; - virAdmServerGetThreadPoolParameters; virAdmServerFree; - virAdmServerLookupClient; + virAdmConnectListServers; +} LIBVIRT_ADMIN_1.3.1; + +LIBVIRT_ADMIN_1.3.3 { + global: virAdmConnectLookupServer; +} LIBVIRT_ADMIN_1.3.2; + +LIBVIRT_ADMIN_1.3.4 { + global: + virAdmServerGetThreadPoolParameters; virAdmServerSetThreadPoolParameters; - virAdmServerListClients; - virAdmClientGetInfo; +} LIBVIRT_ADMIN_1.3.3; + +LIBVIRT_ADMIN_1.3.5 { + global: virAdmClientClose; + virAdmClientFree; + virAdmClientGetID; + virAdmClientGetTimestamp; + virAdmClientGetInfo; + virAdmClientGetTransport; virAdmServerGetClientLimits; virAdmServerSetClientLimits; - virAdmServerUpdateTlsFiles; -}; + virAdmServerListClients; + virAdmServerLookupClient; +} LIBVIRT_ADMIN_1.3.4; + +LIBVIRT_ADMIN_2.0.0 { + global: + virAdmInitialize; +} LIBVIRT_ADMIN_1.3.5; LIBVIRT_ADMIN_3.0.0 { global: @@ -48,3 +75,8 @@ LIBVIRT_ADMIN_3.0.0 { virAdmConnectSetLoggingOutputs; virAdmConnectSetLoggingFilters; } LIBVIRT_ADMIN_2.0.0; + +LIBVIRT_ADMIN_6.2.0 { + global: + virAdmServerUpdateTlsFiles; +} LIBVIRT_ADMIN_3.0.0; -- 2.35.1