Lines Matching full:it
21 * parameter. It should be the last parameter, except for functions
31 * function should not examine it.
33 * - The function may pass @errp to functions it calls to pass on
34 * their errors to its caller. If it dereferences @errp to check
35 * for errors, it must use ERRP_GUARD().
37 * - On success, the function should not touch *errp. On failure, it
104 * Handle an error without reporting it (just for completeness):
107 * Assert that an expected error occurred, but clean it up without
108 * reporting it (primarily useful in testsuites):
116 * Create a new error and pass it to the caller:
119 * Call a function, receive an error from it, and pass it to the caller
125 * - when it does not, say because it is a void function:
140 * Avoid in new code. Do *not* "optimize" it to
147 * But when all you do with the error is pass it on, please use
151 * Receive an error, and handle it locally
158 * - when it does not, say because it is a void function:
209 * - It must not be dereferenced, because it may be null.
210 * - It should not be passed to error_prepend(), error_vprepend(), or
214 * To use ERRP_GUARD(), add it right at the beginning of the function.
218 * Using it when it's not needed is safe, but please avoid cluttering
225 * 0. If the Error ** parameter is not named @errp, rename it to
303 * Create a new error object and assign it to *@errp.
406 * too. If it's reported via QMP, the hints will be ignored.
408 * e.g. a list of valid values. It's not for clarifying a confusing
411 * Trivially the case if you call it only after error_setg() or
443 * Convenience function to assert that *@errp is set, then silently free it.
472 * Similar to warn_report_err(), except it prints the message just once.
473 * Return true when it prints, false otherwise.
503 * It must be used when the function dereferences @errp or passes
505 * It is safe to use even when it's not needed, but please avoid
508 * If @errp is NULL or &error_fatal, rewrite it to point to a local
514 * it's propagated.