Method run

qiling/core.py:561–592

Start binary emulation. Args: begin : emulation starting address end : emulation ending address timeout : limit emulation to a specific amount of time (microseconds); unlimited by default count : limit emulation to a specific amount of

(self, begin: Optional[int] = None, end: Optional[int] = None, timeout: int = 0, count: int = 0)

    ###############

    def run(self, begin: Optional[int] = None, end: Optional[int] = None, timeout: int = 0, count: int = 0):
        """Start binary emulation.

        Args:
            begin   : emulation starting address
            end     : emulation ending address
            timeout : limit emulation to a specific amount of time (microseconds); unlimited by default
            count   : limit emulation to a specific amount of instructions; unlimited by default
        """

        # replace the original entry point, exit point, timeout and count
        self.entry_point = begin
        self.exit_point = end
        self.timeout = timeout
        self.count = count

        # init debugger (if set)
        debugger = select_debugger(self._debugger)

        if debugger:
            debugger = debugger(self)

        # patch binary
        self.do_bin_patch()

        self.write_exit_trap()
        # emulate the binary
        self.os.run()

        # run debugger
        if debugger and self.debugger:
            debugger.run()

    def patch(self, offset: int, data: bytes, target: Optional[str] = None) -> None:
        """Volatilely patch binary and libraries with arbitrary content.