util/qemu-timer: Make timer_free() imply timer_del()
commit5f8e93c3e262ab518c9e8f9a5bb2b391b3d64be9
authorPeter Maydell <peter.maydell@linaro.org>
Tue, 15 Dec 2020 15:41:04 +0000 (15 15:41 +0000)
committerPeter Maydell <peter.maydell@linaro.org>
Fri, 8 Jan 2021 15:13:38 +0000 (8 15:13 +0000)
treeb90b1b0de483d93844950e012b5c20b6849350c6
parent416dd95295b1c13fc9f1f2dbb2803ad581de415a
util/qemu-timer: Make timer_free() imply timer_del()

Currently timer_free() is a simple wrapper for g_free().  This means
that the timer being freed must not be currently active, as otherwise
QEMU might crash later when the active list is processed and still
has a pointer to freed memory on it.  As a result almost all calls to
timer_free() are preceded by a timer_del() call, as can be seen in
the output of
  git grep -B1 '\<timer_free\>'

This is unfortunate API design as it makes it easy to accidentally
misuse (by forgetting the timer_del()), and the correct use is
annoyingly verbose.

Make timer_free() imply a timer_del().

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Message-id: 20201215154107.3255-2-peter.maydell@linaro.org
include/qemu/timer.h