]> git.proxmox.com Git - mirror_qemu.git/blame - error.h
vfio-pci: Don't use kvm_irqchip_in_kernel
[mirror_qemu.git] / error.h
CommitLineData
d5ec4f27
LC
1/*
2 * QEMU Error Objects
3 *
4 * Copyright IBM, Corp. 2011
5 *
6 * Authors:
7 * Anthony Liguori <aliguori@us.ibm.com>
8 *
9 * This work is licensed under the terms of the GNU LGPL, version 2. See
10 * the COPYING.LIB file in the top-level directory.
11 */
12#ifndef ERROR_H
13#define ERROR_H
14
d3608b7c 15#include "compiler.h"
13f59ae8 16#include "qapi-types.h"
d5ec4f27
LC
17#include <stdbool.h>
18
19/**
df1e608a
LC
20 * A class representing internal errors within QEMU. An error has a ErrorClass
21 * code and a human message.
d5ec4f27
LC
22 */
23typedef struct Error Error;
24
25/**
df1e608a
LC
26 * Set an indirect pointer to an error given a ErrorClass value and a
27 * printf-style human message. This function is not meant to be used outside
28 * of QEMU.
d5ec4f27 29 */
13f59ae8 30void error_set(Error **err, ErrorClass err_class, const char *fmt, ...) GCC_FMT_ATTR(3, 4);
d5ec4f27 31
680d16dc
PB
32/**
33 * Set an indirect pointer to an error given a ErrorClass value and a
34 * printf-style human message, followed by a strerror() string if
35 * @os_error is not zero.
36 */
37void error_set_errno(Error **err, int os_error, ErrorClass err_class, const char *fmt, ...) GCC_FMT_ATTR(4, 5);
38
75d789f8
LC
39/**
40 * Same as error_set(), but sets a generic error
41 */
42#define error_setg(err, fmt, ...) \
43 error_set(err, ERROR_CLASS_GENERIC_ERROR, fmt, ## __VA_ARGS__)
680d16dc
PB
44#define error_setg_errno(err, os_error, fmt, ...) \
45 error_set_errno(err, os_error, ERROR_CLASS_GENERIC_ERROR, fmt, ## __VA_ARGS__)
75d789f8 46
d5ec4f27
LC
47/**
48 * Returns true if an indirect pointer to an error is pointing to a valid
49 * error object.
50 */
51bool error_is_set(Error **err);
52
ea25fbca
LC
53/*
54 * Get the error class of an error object.
55 */
56ErrorClass error_get_class(const Error *err);
57
79020cfc
LC
58/**
59 * Returns an exact copy of the error passed as an argument.
60 */
61Error *error_copy(const Error *err);
62
d5ec4f27
LC
63/**
64 * Get a human readable representation of an error object.
65 */
66const char *error_get_pretty(Error *err);
67
d5ec4f27
LC
68/**
69 * Propagate an error to an indirect pointer to an error. This function will
70 * always transfer ownership of the error reference and handles the case where
d195325b 71 * dst_err is NULL correctly. Errors after the first are discarded.
d5ec4f27
LC
72 */
73void error_propagate(Error **dst_err, Error *local_err);
74
75/**
76 * Free an error object.
77 */
78void error_free(Error *err);
79
d5ec4f27 80#endif