summaryrefslogtreecommitdiffstats
path: root/include/chardev/char-fe.h
diff options
context:
space:
mode:
authorAnton Nefedov2017-07-06 14:08:51 +0200
committerPaolo Bonzini2017-07-14 11:04:33 +0200
commit7c44a2a9d178118193febd71cfc6943dd21bdde9 (patch)
tree2206791e4494c36a2f70d3a020001910b9a79a9f /include/chardev/char-fe.h
parentchar: chardevice hotswap (diff)
downloadqemu-7c44a2a9d178118193febd71cfc6943dd21bdde9.tar.gz
qemu-7c44a2a9d178118193febd71cfc6943dd21bdde9.tar.xz
qemu-7c44a2a9d178118193febd71cfc6943dd21bdde9.zip
char: forbid direct chardevice access for hotswap devices
qemu_chr_fe_get_driver() is unsafe, frontends with hotswap support should not access CharDriver ptr directly as CharDriver might change. Signed-off-by: Anton Nefedov <anton.nefedov@virtuozzo.com> Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> Message-Id: <1499342940-56739-5-git-send-email-anton.nefedov@virtuozzo.com> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Diffstat (limited to 'include/chardev/char-fe.h')
-rw-r--r--include/chardev/char-fe.h10
1 files changed, 10 insertions, 0 deletions
diff --git a/include/chardev/char-fe.h b/include/chardev/char-fe.h
index 9f38060c7e..588abed606 100644
--- a/include/chardev/char-fe.h
+++ b/include/chardev/char-fe.h
@@ -46,10 +46,20 @@ void qemu_chr_fe_deinit(CharBackend *b, bool del);
*
* Returns the driver associated with a CharBackend or NULL if no
* associated Chardev.
+ * Note: avoid this function as the driver should never be accessed directly,
+ * especially by the frontends that support chardevice hotswap.
+ * Consider qemu_chr_fe_backend_connected() to check for driver existence
*/
Chardev *qemu_chr_fe_get_driver(CharBackend *be);
/**
+ * @qemu_chr_fe_backend_connected:
+ *
+ * Returns true if there is a chardevice associated with @be.
+ */
+bool qemu_chr_fe_backend_connected(CharBackend *be);
+
+/**
* @qemu_chr_fe_set_handlers:
* @b: a CharBackend
* @fd_can_read: callback to get the amount of data the frontend may