From: Peter Krempa <pkrempa@redhat.com>
Date: Wed, 30 Nov 2016 08:58:12 +0000 (+0100)
Subject: tests: qemu: Document qemuMonitorTestNewFromFile
X-Git-Tag: CVE-2017-2635~295
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fa755dd59a86ba0c91b009fd291bf612cdec0eb8;p=thirdparty%2Flibvirt.git

tests: qemu: Document qemuMonitorTestNewFromFile
---

diff --git a/tests/qemumonitortestutils.c b/tests/qemumonitortestutils.c
index f8f23c3d72..3722b07298 100644
--- a/tests/qemumonitortestutils.c
+++ b/tests/qemumonitortestutils.c
@@ -1037,6 +1037,19 @@ qemuMonitorTestNew(bool json,
 }
 
 
+/**
+ * qemuMonitorTestNewFromFile:
+ * @fileName: File name to load monitor replies from
+ * @xmlopt: XML parser configuration object
+ * @simple: see below
+ *
+ * Create a JSON test monitor simulator object and fill it with replies
+ * specified in @fileName. The file contains JSON reply objects separated by
+ * empty lines. If @simple is true a generic QMP greeting is automatically
+ * added as the first reply, otherwise the first entry in the file is used.
+ *
+ * Returns the monitor object on success; NULL on error.
+ */
 qemuMonitorTestPtr
 qemuMonitorTestNewFromFile(const char *fileName,
                            virDomainXMLOptionPtr xmlopt,