include/qom/object.h

39  * @errp: a pointer to an Error that is filled if getting/setting fails.
107  * Called when an object is being removed from the QOM composition tree.
116  * Called when an object's last reference is removed.
125  * The base for all classes.  The only thing that #ObjectClass contains is an
387  * for defining an abstract type, without any interfaces.
444  * @instance_init: This function is called to initialize an object.  The parent
448  *   an object, after all @instance_init functions were called, as well as
452  *   An object should only free the members that are unique to its type in this
459  *   implementing an explicit class type if they are not adding additional
501  * Converts an object to a #Object.  Since all objects are #Objects,
511  * Converts a class to an #ObjectClass.  Since all objects are #Objects,
527  * If an invalid object is passed to this function, a run time assert will be
556  * from an object.
565  * The information associated with an interface.
594  * Returns: An #InterfaceClass or raise an error if cast is invalid
602  * @obj: the object to convert to an interface
657  *    :caption: Creating an object with properties
717  * This function will set a list of properties on an existing object
725  *    :caption: Update an object's properties
765  * This function will initialize an object.  The memory for the object should
778  * @errp: If an error occurs, a pointer to an area to store the error
781  * This function will initialize an object. The memory for the object should
806  * @errp: If an error occurs, a pointer to an area to store the error
844  * This function will determine if @obj is-a @typename.  @obj can refer to an
845  * object or an interface associated with an object.
921  * Return whether an object was found.
966  * If @typename is an interface, this function returns the interface
1080  * @opaque: an opaque pointer to pass to the callbacks for the property
1113  * @opaque: an opaque pointer to pass to the callbacks for the property
1153  * Set the property default value to be an empty list.
1180  * Look up a property for an object.
1190  * @errp: returns an error if this function fails
1192  * Look up a property for an object.
1205  * Look up a property for an object class.
1216  * @errp: returns an error if this function fails
1218  * Look up a property for an object class.
1236  * Initializes an iterator for traversing all properties
1237  * registered against an object instance, its class and all parent classes.
1263  * Initializes an iterator for traversing all properties
1264  * registered against an object class and all parent classes.
1295  * @v: the visitor that will receive the property value.  This should be an
1297  * @errp: returns an error if this function fails
1311  * @errp: returns an error if this function fails
1324  * @errp: returns an error if this function fails
1327  * an error occurs (including when the property value is not a string).
1338  * @errp: returns an error if this function fails
1340  * Writes an object's canonical path to a property.
1355  * @errp: returns an error if this function fails
1357  * Returns: the value of the property, resolved from a path to an Object,
1358  * or NULL if an error occurs (including when the property value is not a
1369  * @errp: returns an error if this function fails
1382  * @errp: returns an error if this function fails
1385  * an error occurs (including when the property value is not a bool).
1395  * @errp: returns an error if this function fails
1397  * Writes an integer value to a property.
1408  * @errp: returns an error if this function fails
1410  * Returns: the value of the property, converted to an integer, or -1 if
1411  * an error occurs (including when the property value is not an integer).
1421  * @errp: returns an error if this function fails
1423  * Writes an unsigned integer value to a property.
1434  * @errp: returns an error if this function fails
1436  * Returns: the value of the property, converted to an unsigned integer, or 0
1437  * an error occurs (including when the property value is not an integer).
1447  * @errp: returns an error if this function fails
1449  * Returns: the value of the property, converted to an integer (which
1451  * value is not an enum).
1461  *   be an Input visitor and the data will be first read with @name as the
1463  * @errp: returns an error if this function fails
1477  * @errp: returns an error if this function fails
1479  * Parses a string and writes the result into a property of an object.
1491  * @errp: returns an error if this function fails
1503  * @errp: returns an error if this function fails
1586  * path is matched as an absolute path.  The first match is not returned.  At
1622  * If no match or more than one match is found, an error is
1646  * This is similar to object_resolve_path with an absolute path, but it
1705  * an error.
1726  * object_property_set_link() is called and can raise an error to prevent the
1806  * Add an enum property using getters/setters.  This function will add a
1858  * Add an integer property in memory.  This function will add a
1879  * Add an integer property in memory.  This function will add a
1900  * Add an integer property in memory.  This function will add a
1921  * Add an integer property in memory.  This function will add a
1942  * Add an alias for a property on an object.  This function will add a property
1946  * this property exists.  In the case of a child object or an alias on the same
1961  * Add an unmodifiable link for a property on an object.  This function will
1980  * Set an object property's description.
1993  * @opaque: an opaque value that will be passed to the iterator
2010  * @opaque: an opaque value that will be passed to the iterator