OSDN Git Service

error: Add error_abort
authorPeter Crosthwaite <peter.crosthwaite@xilinx.com>
Thu, 2 Jan 2014 02:46:59 +0000 (18:46 -0800)
committerLuiz Capitulino <lcapitulino@redhat.com>
Mon, 6 Jan 2014 19:01:53 +0000 (14:01 -0500)
commit5d24ee70bcbcf578614193526bcd5ed30a8eb16c
tree142d730254e19a9fb70e80b5592e25e01fa0fabb
parentcff8b2c6fcdc9492d1141da11f55615843fa0a5e
error: Add error_abort

Add a special Error * that can be passed to error handling APIs to
signal that any errors are fatal and should abort QEMU. There are two
advantages to this:

- allows for brevity when wishing to assert success of Error **
  accepting APIs. No need for this pattern:
        Error * local_err = NULL;
        api_call(foo, bar, &local_err);
        assert_no_error(local_err);
  This also removes the need for _nofail variants of APIs with
  asserting call sites now reduced to 1LOC.
- SIGABRT happens from within the offending API. When a fatal error
  occurs in an API call (when the caller is asserting sucess) failure
  often means the API itself is broken. With the abort happening in the
  API call now, the stack frames into the call are available at debug
  time. In the assert_no_error scheme the abort happens after the fact.

The exact semantic is that when an error is raised, if the argument
Error ** matches &error_abort, then the abort occurs immediately. The
error messaged is reported.

For error_propagate, if the destination error is &error_abort, then
the abort happens at propagation time.

Signed-off-by: Peter Crosthwaite <peter.crosthwaite@xilinx.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Luiz Capitulino <lcapitulino@redhat.com>
include/qapi/error.h
util/error.c