error: Add error_vprepend() in comment of ERRP_GUARD() rules

The error_vprepend() should use ERRP_GUARD() just as the documentation
of ERRP_GUARD() says:

> It must be used when the function dereferences @errp or passes
> @errp to error_prepend(), error_vprepend(), or error_append_hint().

Considering that error_vprepend() is also an API provided in error.h,
it is necessary to add it to the description of the rules for using
ERRP_GUARD().

Cc: Markus Armbruster <armbru@redhat.com>
Cc: Michael Roth <michael.roth@amd.com>
Signed-off-by: Zhao Liu <zhao1.liu@intel.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240311033822.3142585-2-zhao1.liu@linux.intel.com>
Signed-off-by: Thomas Huth <thuth@redhat.com>
This commit is contained in:
Zhao Liu 2024-03-11 11:37:54 +08:00 committed by Thomas Huth
parent 4a9fafb478
commit 042e4942b9

View File

@ -207,7 +207,7 @@
* *
* Without ERRP_GUARD(), use of the @errp parameter is restricted: * Without ERRP_GUARD(), use of the @errp parameter is restricted:
* - It must not be dereferenced, because it may be null. * - It must not be dereferenced, because it may be null.
* - It should not be passed to error_prepend() or * - It should not be passed to error_prepend(), error_vprepend(), or
* error_append_hint(), because that doesn't work with &error_fatal. * error_append_hint(), because that doesn't work with &error_fatal.
* ERRP_GUARD() lifts these restrictions. * ERRP_GUARD() lifts these restrictions.
* *