sim: Add hooks to implement event reference counting
authorAndreas Sandberg <andreas.sandberg@arm.com>
Wed, 10 May 2017 09:51:53 +0000 (10:51 +0100)
committerAndreas Sandberg <andreas.sandberg@arm.com>
Wed, 24 May 2017 14:28:45 +0000 (14:28 +0000)
commit5b3752c37280b0ae508bda824c89810136bf9360
treecc87a50f88396eac17c11f75d51ce3032c7fd0e5
parent76692f360c243401a850ea74cf123d4d006113ec
sim: Add hooks to implement event reference counting

We currently only support deleting an event if it is triggered and not
re-scheduled. This is fine for most native code. However, there are
cases where Python needs to count references to make sure that the
Python object stays live while the native object is live.

Generalise the mechanism used to implement by adding reference
counting hooks to the event base class:

  * Event::acquire() / Event::acquireImpl()
  * Event::release() / Event::releaseImpl()

These calls can be used to implement both reference counting and the
existing AutoDelete functionality. The default implementation in Event
maintains backwards compatibility with the existing AutoDelete feature
by ignoring acquireImpl() and deleting the event on releaseImpl() if
it isn't scheduled anymore.

Since AutoDelete functionality is no longer the only way events can be
managed, this change introduces the new Managed flag. This flag
activates automatic memory management. The acquireImpl()/releaseImpl()
methods are only called from acquire()/release() it is set. To
maintain backwards compatibility, AutoDelete is used as an alias for
Managed.

Change-Id: I5637984c906a9d44c22780712cf1c521b8297149
Signed-off-by: Andreas Sandberg <andreas.sandberg@arm.com>
Reviewed-by: Curtis Dunham <curtis.dunham@arm.com>
Reviewed-on: https://gem5-review.googlesource.com/3221
Reviewed-by: Jason Lowe-Power <jason@lowepower.com>
src/sim/eventq.cc
src/sim/eventq.hh
src/sim/eventq_impl.hh