From 80d3580b29d84221650fd2dc7f26706d50f21197 Mon Sep 17 00:00:00 2001 From: aliguori Date: Fri, 31 Oct 2008 17:42:00 +0000 Subject: [PATCH] Clarify qemu_bh_schedule_idle() usage Signed-off-by: Anthony Liguori git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@5576 c046a42c-6fe2-441c-8c8c-71466251a162 --- qemu-common.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/qemu-common.h b/qemu-common.h index 0c6f4de3f2..f23d7b4cc7 100644 --- a/qemu-common.h +++ b/qemu-common.h @@ -70,6 +70,12 @@ typedef void QEMUBHFunc(void *opaque); QEMUBH *qemu_bh_new(QEMUBHFunc *cb, void *opaque); void qemu_bh_schedule(QEMUBH *bh); +/* Bottom halfs that are scheduled from a bottom half handler are instantly + * invoked. This can create an infinite loop if a bottom half handler + * schedules itself. qemu_bh_schedule_idle() avoids this infinite loop by + * ensuring that the bottom half isn't executed until the next main loop + * iteration. + */ void qemu_bh_schedule_idle(QEMUBH *bh); void qemu_bh_cancel(QEMUBH *bh); void qemu_bh_delete(QEMUBH *bh);