mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-08-05 16:33:50 +00:00
docstring: libvirt-common: Add 'Since version' metadata
Similarly to previous commits but with the targeting libvirt-common in a batch. Either create or append to existing docstring, the version (git tag) that a given typedef, enum value, macro or function was introduced in the format: Since: v1.2.3 Signed-off-by: Victor Toso <victortoso@redhat.com> Reviewed-by: Peter Krempa <pkrempa@redhat.com>
This commit is contained in:
parent
36dbddec24
commit
4b120e51f1
@ -70,6 +70,8 @@ extern "C" {
|
|||||||
*
|
*
|
||||||
* Macro providing the version of the library as
|
* Macro providing the version of the library as
|
||||||
* version * 1,000,000 + minor * 1000 + micro
|
* version * 1,000,000 + minor * 1000 + micro
|
||||||
|
*
|
||||||
|
* Since: v0.0.1
|
||||||
*/
|
*/
|
||||||
|
|
||||||
# define LIBVIR_VERSION_NUMBER @LIBVIRT_VERSION_NUMBER@
|
# define LIBVIR_VERSION_NUMBER @LIBVIRT_VERSION_NUMBER@
|
||||||
@ -86,6 +88,8 @@ extern "C" {
|
|||||||
* #if LIBVIR_CHECK_VERSION(1,1,3)
|
* #if LIBVIR_CHECK_VERSION(1,1,3)
|
||||||
* // some code that only works in 1.1.3 and newer
|
* // some code that only works in 1.1.3 and newer
|
||||||
* #endif
|
* #endif
|
||||||
|
*
|
||||||
|
* Since: v1.2.0
|
||||||
*/
|
*/
|
||||||
# define LIBVIR_CHECK_VERSION(major, minor, micro) \
|
# define LIBVIR_CHECK_VERSION(major, minor, micro) \
|
||||||
((major) * 1000000 + (minor) * 1000 + (micro) <= LIBVIR_VERSION_NUMBER)
|
((major) * 1000000 + (minor) * 1000 + (micro) <= LIBVIR_VERSION_NUMBER)
|
||||||
@ -104,17 +108,24 @@ extern "C" {
|
|||||||
* from a context which is not re-entrant safe. Failure to
|
* from a context which is not re-entrant safe. Failure to
|
||||||
* abide by this requirement may lead to application deadlocks
|
* abide by this requirement may lead to application deadlocks
|
||||||
* or crashes.
|
* or crashes.
|
||||||
|
*
|
||||||
|
* Since: v0.5.0
|
||||||
*/
|
*/
|
||||||
typedef void (*virFreeCallback)(void *opaque);
|
typedef void (*virFreeCallback)(void *opaque);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* virConnectCloseReason:
|
||||||
|
*
|
||||||
|
* Since: v0.10.0
|
||||||
|
*/
|
||||||
typedef enum {
|
typedef enum {
|
||||||
VIR_CONNECT_CLOSE_REASON_ERROR = 0, /* Misc I/O error */
|
VIR_CONNECT_CLOSE_REASON_ERROR = 0, /* Misc I/O error (Since: v0.10.0) */
|
||||||
VIR_CONNECT_CLOSE_REASON_EOF = 1, /* End-of-file from server */
|
VIR_CONNECT_CLOSE_REASON_EOF = 1, /* End-of-file from server (Since: v0.10.0) */
|
||||||
VIR_CONNECT_CLOSE_REASON_KEEPALIVE = 2, /* Keepalive timer triggered */
|
VIR_CONNECT_CLOSE_REASON_KEEPALIVE = 2, /* Keepalive timer triggered (Since: v0.10.0) */
|
||||||
VIR_CONNECT_CLOSE_REASON_CLIENT = 3, /* Client requested it */
|
VIR_CONNECT_CLOSE_REASON_CLIENT = 3, /* Client requested it (Since: v0.10.0) */
|
||||||
|
|
||||||
# ifdef VIR_ENUM_SENTINELS
|
# ifdef VIR_ENUM_SENTINELS
|
||||||
VIR_CONNECT_CLOSE_REASON_LAST
|
VIR_CONNECT_CLOSE_REASON_LAST /* (Since: v0.10.0) */
|
||||||
# endif
|
# endif
|
||||||
} virConnectCloseReason;
|
} virConnectCloseReason;
|
||||||
|
|
||||||
@ -122,18 +133,20 @@ typedef enum {
|
|||||||
* virTypedParameterType:
|
* virTypedParameterType:
|
||||||
*
|
*
|
||||||
* Express the type of a virTypedParameter
|
* Express the type of a virTypedParameter
|
||||||
|
*
|
||||||
|
* Since: v0.9.2
|
||||||
*/
|
*/
|
||||||
typedef enum {
|
typedef enum {
|
||||||
VIR_TYPED_PARAM_INT = 1, /* integer case */
|
VIR_TYPED_PARAM_INT = 1, /* integer case (Since: v0.9.2) */
|
||||||
VIR_TYPED_PARAM_UINT = 2, /* unsigned integer case */
|
VIR_TYPED_PARAM_UINT = 2, /* unsigned integer case (Since: v0.9.2) */
|
||||||
VIR_TYPED_PARAM_LLONG = 3, /* long long case */
|
VIR_TYPED_PARAM_LLONG = 3, /* long long case (Since: v0.9.2) */
|
||||||
VIR_TYPED_PARAM_ULLONG = 4, /* unsigned long long case */
|
VIR_TYPED_PARAM_ULLONG = 4, /* unsigned long long case (Since: v0.9.2) */
|
||||||
VIR_TYPED_PARAM_DOUBLE = 5, /* double case */
|
VIR_TYPED_PARAM_DOUBLE = 5, /* double case (Since: v0.9.2) */
|
||||||
VIR_TYPED_PARAM_BOOLEAN = 6, /* boolean(character) case */
|
VIR_TYPED_PARAM_BOOLEAN = 6, /* boolean(character) case (Since: v0.9.2) */
|
||||||
VIR_TYPED_PARAM_STRING = 7, /* string case */
|
VIR_TYPED_PARAM_STRING = 7, /* string case (Since: v0.9.8) */
|
||||||
|
|
||||||
# ifdef VIR_ENUM_SENTINELS
|
# ifdef VIR_ENUM_SENTINELS
|
||||||
VIR_TYPED_PARAM_LAST
|
VIR_TYPED_PARAM_LAST /* (Since: v0.9.10) */
|
||||||
# endif
|
# endif
|
||||||
} virTypedParameterType;
|
} virTypedParameterType;
|
||||||
|
|
||||||
@ -143,6 +156,8 @@ typedef enum {
|
|||||||
* Flags related to libvirt APIs that use virTypedParameter.
|
* Flags related to libvirt APIs that use virTypedParameter.
|
||||||
*
|
*
|
||||||
* These enums should not conflict with those of virDomainModificationImpact.
|
* These enums should not conflict with those of virDomainModificationImpact.
|
||||||
|
*
|
||||||
|
* Since: v0.9.8
|
||||||
*/
|
*/
|
||||||
typedef enum {
|
typedef enum {
|
||||||
/* 1 << 0 is reserved for virDomainModificationImpact */
|
/* 1 << 0 is reserved for virDomainModificationImpact */
|
||||||
@ -157,6 +172,8 @@ typedef enum {
|
|||||||
* the user does not have to worry about it; however, manually
|
* the user does not have to worry about it; however, manually
|
||||||
* setting the flag can be used to reject servers that cannot
|
* setting the flag can be used to reject servers that cannot
|
||||||
* return typed strings, even if no strings would be returned.
|
* return typed strings, even if no strings would be returned.
|
||||||
|
*
|
||||||
|
* Since: v0.9.8
|
||||||
*/
|
*/
|
||||||
VIR_TYPED_PARAM_STRING_OKAY = 1 << 2,
|
VIR_TYPED_PARAM_STRING_OKAY = 1 << 2,
|
||||||
|
|
||||||
@ -166,6 +183,8 @@ typedef enum {
|
|||||||
* VIR_TYPED_PARAM_FIELD_LENGTH:
|
* VIR_TYPED_PARAM_FIELD_LENGTH:
|
||||||
*
|
*
|
||||||
* Macro providing the field length of virTypedParameter name
|
* Macro providing the field length of virTypedParameter name
|
||||||
|
*
|
||||||
|
* Since: v0.9.2
|
||||||
*/
|
*/
|
||||||
# define VIR_TYPED_PARAM_FIELD_LENGTH 80
|
# define VIR_TYPED_PARAM_FIELD_LENGTH 80
|
||||||
|
|
||||||
@ -177,6 +196,8 @@ typedef enum {
|
|||||||
* The types virSchedParameter, virBlkioParameter, and
|
* The types virSchedParameter, virBlkioParameter, and
|
||||||
* virMemoryParameter are aliases of this type, for use when
|
* virMemoryParameter are aliases of this type, for use when
|
||||||
* targeting libvirt earlier than 0.9.2.
|
* targeting libvirt earlier than 0.9.2.
|
||||||
|
*
|
||||||
|
* Since: v0.9.2
|
||||||
*/
|
*/
|
||||||
typedef struct _virTypedParameter virTypedParameter;
|
typedef struct _virTypedParameter virTypedParameter;
|
||||||
|
|
||||||
@ -198,6 +219,8 @@ struct _virTypedParameter {
|
|||||||
* virTypedParameterPtr:
|
* virTypedParameterPtr:
|
||||||
*
|
*
|
||||||
* a pointer to a virTypedParameter structure.
|
* a pointer to a virTypedParameter structure.
|
||||||
|
*
|
||||||
|
* Since: v0.9.2
|
||||||
*/
|
*/
|
||||||
typedef virTypedParameter *virTypedParameterPtr;
|
typedef virTypedParameter *virTypedParameterPtr;
|
||||||
|
|
||||||
|
@ -127,6 +127,8 @@ virTypedParameterAssignFromStr(virTypedParameterPtr param,
|
|||||||
*
|
*
|
||||||
* Returns pointer to the parameter or NULL if it does not exist in @params.
|
* Returns pointer to the parameter or NULL if it does not exist in @params.
|
||||||
* This function does not raise an error, even when returning NULL.
|
* This function does not raise an error, even when returning NULL.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
virTypedParameterPtr
|
virTypedParameterPtr
|
||||||
virTypedParamsGet(virTypedParameterPtr params,
|
virTypedParamsGet(virTypedParameterPtr params,
|
||||||
@ -176,6 +178,8 @@ virTypedParamsGet(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetInt(virTypedParameterPtr params,
|
virTypedParamsGetInt(virTypedParameterPtr params,
|
||||||
@ -212,6 +216,8 @@ virTypedParamsGetInt(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetUInt(virTypedParameterPtr params,
|
virTypedParamsGetUInt(virTypedParameterPtr params,
|
||||||
@ -248,6 +254,8 @@ virTypedParamsGetUInt(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetLLong(virTypedParameterPtr params,
|
virTypedParamsGetLLong(virTypedParameterPtr params,
|
||||||
@ -284,6 +292,8 @@ virTypedParamsGetLLong(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetULLong(virTypedParameterPtr params,
|
virTypedParamsGetULLong(virTypedParameterPtr params,
|
||||||
@ -320,6 +330,8 @@ virTypedParamsGetULLong(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetDouble(virTypedParameterPtr params,
|
virTypedParamsGetDouble(virTypedParameterPtr params,
|
||||||
@ -356,6 +368,8 @@ virTypedParamsGetDouble(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetBoolean(virTypedParameterPtr params,
|
virTypedParamsGetBoolean(virTypedParameterPtr params,
|
||||||
@ -394,6 +408,8 @@ virTypedParamsGetBoolean(virTypedParameterPtr params,
|
|||||||
*
|
*
|
||||||
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
* Returns 1 on success, 0 when the parameter does not exist in @params, or
|
||||||
* -1 on error.
|
* -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsGetString(virTypedParameterPtr params,
|
virTypedParamsGetString(virTypedParameterPtr params,
|
||||||
@ -433,6 +449,8 @@ virTypedParamsGetString(virTypedParameterPtr params,
|
|||||||
* if the parameter already exists in @params.
|
* if the parameter already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddInt(virTypedParameterPtr *params,
|
virTypedParamsAddInt(virTypedParameterPtr *params,
|
||||||
@ -479,6 +497,8 @@ virTypedParamsAddInt(virTypedParameterPtr *params,
|
|||||||
* error if the parameter already exists in @params.
|
* error if the parameter already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddUInt(virTypedParameterPtr *params,
|
virTypedParamsAddUInt(virTypedParameterPtr *params,
|
||||||
@ -525,6 +545,8 @@ virTypedParamsAddUInt(virTypedParameterPtr *params,
|
|||||||
* error if the parameter already exists in @params.
|
* error if the parameter already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddLLong(virTypedParameterPtr *params,
|
virTypedParamsAddLLong(virTypedParameterPtr *params,
|
||||||
@ -571,6 +593,8 @@ virTypedParamsAddLLong(virTypedParameterPtr *params,
|
|||||||
* error if the parameter already exists in @params.
|
* error if the parameter already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddULLong(virTypedParameterPtr *params,
|
virTypedParamsAddULLong(virTypedParameterPtr *params,
|
||||||
@ -617,6 +641,8 @@ virTypedParamsAddULLong(virTypedParameterPtr *params,
|
|||||||
* error if the parameter already exists in @params.
|
* error if the parameter already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddDouble(virTypedParameterPtr *params,
|
virTypedParamsAddDouble(virTypedParameterPtr *params,
|
||||||
@ -663,6 +689,8 @@ virTypedParamsAddDouble(virTypedParameterPtr *params,
|
|||||||
* error if the parameter already exists in @params.
|
* error if the parameter already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddBoolean(virTypedParameterPtr *params,
|
virTypedParamsAddBoolean(virTypedParameterPtr *params,
|
||||||
@ -711,6 +739,8 @@ virTypedParamsAddBoolean(virTypedParameterPtr *params,
|
|||||||
* already exists in @params.
|
* already exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddString(virTypedParameterPtr *params,
|
virTypedParamsAddString(virTypedParameterPtr *params,
|
||||||
@ -757,6 +787,8 @@ virTypedParamsAddString(virTypedParameterPtr *params,
|
|||||||
* key @name.
|
* key @name.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.2.17
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddStringList(virTypedParameterPtr *params,
|
virTypedParamsAddStringList(virTypedParameterPtr *params,
|
||||||
@ -802,6 +834,8 @@ virTypedParamsAddStringList(virTypedParameterPtr *params,
|
|||||||
* exists in @params.
|
* exists in @params.
|
||||||
*
|
*
|
||||||
* Returns 0 on success, -1 on error.
|
* Returns 0 on success, -1 on error.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
int
|
int
|
||||||
virTypedParamsAddFromString(virTypedParameterPtr *params,
|
virTypedParamsAddFromString(virTypedParameterPtr *params,
|
||||||
@ -840,6 +874,8 @@ virTypedParamsAddFromString(virTypedParameterPtr *params,
|
|||||||
* is not freed; use virTypedParamsFree if you want it to be freed too.
|
* is not freed; use virTypedParamsFree if you want it to be freed too.
|
||||||
*
|
*
|
||||||
* Returns nothing.
|
* Returns nothing.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
void
|
void
|
||||||
virTypedParamsClear(virTypedParameterPtr params,
|
virTypedParamsClear(virTypedParameterPtr params,
|
||||||
@ -866,6 +902,8 @@ virTypedParamsClear(virTypedParameterPtr params,
|
|||||||
* @params.
|
* @params.
|
||||||
*
|
*
|
||||||
* Returns nothing.
|
* Returns nothing.
|
||||||
|
*
|
||||||
|
* Since: v1.0.2
|
||||||
*/
|
*/
|
||||||
void
|
void
|
||||||
virTypedParamsFree(virTypedParameterPtr params,
|
virTypedParamsFree(virTypedParameterPtr params,
|
||||||
|
Loading…
Reference in New Issue
Block a user