Method emu_start

qiling/extensions/multitask.py:303–333

Emulate an area of code just once. This overwrites the original emu_start interface and provides extra cares when multitask is enabled. If no task is registerd, this call bahaves like the original emu_start. NOTE: Calling this method may cause current greenlet to

(self, begin: int, end: int, timeout: int, count: int)

        self._tasks[utk_id]._stop_request = True

    def emu_start(self, begin: int, end: int, timeout: int, count: int):
        """ Emulate an area of code just once. This overwrites the original emu_start interface and
            provides extra cares when multitask is enabled. If no task is registerd, this call bahaves
            like the original emu_start.
            NOTE: Calling this method may cause current greenlet to be switched out.
            begin, end, timeout, count: refer to Uc.emu_start
        """
        if self._multitask_enabled:
            if self._nested_started > 0:
                with NestedCounter(self):
                    pool = gevent.get_hub().threadpool # type: gevent.threadpool.ThreadPool
                    task = pool.spawn(self._emu_start_locked, begin, end, timeout, count)
                    ucerr = task.get()

                    if ucerr != UC_ERR_OK:
                        raise UcError(ucerr)

                    return ucerr
            else:

                # Assume users resume on the last thread (and that should be the case)
                if self._cur_utk_id in self._tasks:
                    self._tasks[self._cur_utk_id]._begin = begin
                    self._tasks[self._cur_utk_id]._end = end
                else:
                    print(f"Warning: Can't found last thread we scheduled")

                # This translation is not accurate, though.
                self.tasks_start(count, timeout)
        else:
            return super().emu_start(begin, end, timeout, count)

    def emu_stop(self):
        """ Stop the emulation. If no task is registerd, this call bahaves like the original emu_stop.