xref: /qemu/tests/qtest/libqmp.h (revision b88651cb)
1 /*
2  * libqmp test unit
3  *
4  * Copyright IBM, Corp. 2012
5  * Copyright Red Hat, Inc. 2012
6  * Copyright SUSE LINUX Products GmbH 2013
7  *
8  * Authors:
9  *  Anthony Liguori   <aliguori@us.ibm.com>
10  *  Paolo Bonzini     <pbonzini@redhat.com>
11  *  Andreas Färber    <afaerber@suse.de>
12  *
13  * This work is licensed under the terms of the GNU GPL, version 2 or later.
14  * See the COPYING file in the top-level directory.
15  *
16  */
17 
18 #ifndef LIBQMP_H
19 #define LIBQMP_H
20 
21 #include "qapi/qmp/qdict.h"
22 
23 QDict *qmp_fd_receive(int fd);
24 void qmp_fd_vsend_fds(int fd, int *fds, size_t fds_num,
25                       const char *fmt, va_list ap) G_GNUC_PRINTF(4, 0);
26 void qmp_fd_vsend(int fd, const char *fmt, va_list ap) G_GNUC_PRINTF(2, 0);
27 void qmp_fd_send(int fd, const char *fmt, ...) G_GNUC_PRINTF(2, 3);
28 void qmp_fd_send_raw(int fd, const char *fmt, ...) G_GNUC_PRINTF(2, 3);
29 void qmp_fd_vsend_raw(int fd, const char *fmt, va_list ap) G_GNUC_PRINTF(2, 0);
30 QDict *qmp_fdv(int fd, const char *fmt, va_list ap) G_GNUC_PRINTF(2, 0);
31 QDict *qmp_fd(int fd, const char *fmt, ...) G_GNUC_PRINTF(2, 3);
32 
33 /**
34  * qmp_rsp_is_err:
35  * @rsp: QMP response to check for error
36  *
37  * Test @rsp for error and discard @rsp.
38  * Returns 'true' if there is error in @rsp and 'false' otherwise.
39  */
40 bool qmp_rsp_is_err(QDict *rsp);
41 
42 /**
43  * qmp_expect_error_and_unref:
44  * @rsp: QMP response to check for error
45  * @class: an error class
46  *
47  * Assert the response has the given error class and discard @rsp.
48  */
49 void qmp_expect_error_and_unref(QDict *rsp, const char *class);
50 
51 #endif /* LIBQMP_H */
52