include/qom/object.h

10  * See the COPYING file in the top-level directory.
17 #include "qapi/qapi-builtin-types.h"
147  * always begins at byte 0 of that structure, as long as any sub-object places
228  *   - create the typedefs for the object and class structs
229  *   - register the type for use with g_autoptr
230  *   - provide three standard type cast functions
319  *   - declare prototypes for _finalize, _class_init and _init methods
320  *   - declare the TypeInfo struct instance
321  *   - provide the constructor to register the type
324  * and _init methods need to be written. Any of these can be zero-line
325  * no-op impls if no special logic is required for a given type.
347  * for the common case of a non-abstract type, without any interfaces.
365  * for the common case of a non-abstract type, with one or more implemented
404  * the case of a non-abstract type, with interfaces, and with no requirement
424  * the common case of a non-abstract type, without any interfaces, and with
442  *   is 0, then normal malloc alignment is sufficient; if non-zero, then we
656  * .. code-block:: c
667  *                                  "mem-path", "/dev/shm/somefile",
724  * .. code-block:: c
733  *                            "mem-path", "/dev/shm/somefile",
844  * This function will determine if @obj is-a @typename.  @obj can refer to an
1028  * Returns: A singly-linked list of the classes in reverse hashtable order.
1038  * Returns: A singly-linked list of the classes in alphabetical
1039  * case-insensitive order.
1067  *  a forward slash.  In general, you should use hyphens '-' instead of
1070  *   defined.  Sub namespaces are constructed by using a prefix and then
1071  *   to angle brackets.  For instance, the type 'virtio-net-pci' in the
1072  *   'link' namespace would be 'link<virtio-net-pci>'.
1100  *  a forward slash.  In general, you should use hyphens '-' instead of
1103  *   defined.  Sub namespaces are constructed by using a prefix and then
1104  *   to angle brackets.  For instance, the type 'virtio-net-pci' in the
1105  *   'link' namespace would be 'link<virtio-net-pci>'.
1244  * .. code-block:: c
1282  * re-initializing it.
1410  * Returns: the value of the property, converted to an integer, or -1 if
1450  * can't be negative), or -1 on error (including when the property
1576  * There are two types of supported paths--absolute paths and partial paths.
1716  * @check: callback to veto setting or NULL if the property is read-only
1727  * link being set.  If @check is NULL, the property is read-only
1757  * @get: the getter or NULL if the property is write-only.  This function must
1759  * @set: the setter or NULL if the property is read-only
1780  * @get: the getter or NULL if the property is write-only.
1781  * @set: the setter or NULL if the property is read-only
1803  * @get: the getter or %NULL if the property is write-only.
1804  * @set: the setter or %NULL if the property is read-only
1828  * @get: the getter or NULL if the property is write-only.
1830  * Add a read-only struct tm valued property using a getter function.
1856  * @flags: bitwise-or'd ObjectPropertyFlags
1877  * @flags: bitwise-or'd ObjectPropertyFlags
1898  * @flags: bitwise-or'd ObjectPropertyFlags
1919  * @flags: bitwise-or'd ObjectPropertyFlags
1996  * non-zero.
2013  * non-zero. Calls recursively, all child nodes of @obj will also be passed
2014  * all the way down to the leaf nodes of the tree. Depth first ordering.
2017  * child nodes) from the @fn callback.
2044  * Returns: a user-friendly formatted string describing the property