Method map

qiling/os/memory.py:622–642

Map a new memory range. Args: addr: memory range base address size: memory range size (in bytes) perms: requested permissions mask info: range label string ptr: pointer to use (if any) Raises: QlMemoryMappedErr

(self, addr: int, size: int, perms: int = UC_PROT_ALL, info: Optional[str] = None)

        self.change_mapinfo(aligned_address, aligned_address + aligned_size, new_perms=perms)

    def map(self, addr: int, size: int, perms: int = UC_PROT_ALL, info: Optional[str] = None):
        """Map a new memory range.

        Args:
            addr: memory range base address
            size: memory range size (in bytes)
            perms: requested permissions mask
            info: range label string
            ptr: pointer to use (if any)

        Raises:
            QlMemoryMappedError: in case requested memory range is not fully available
        """

        assert perms & ~UC_PROT_ALL == 0, f'unexpected permissions mask {perms}'

        if not self.is_available(addr, size):
            raise QlMemoryMappedError('Requested memory is unavailable')

        self.ql.uc.mem_map(addr, size, perms)
        self.add_mapinfo(addr, addr + size, perms, info or '[mapped]', None)

    def map_mmio(self, addr: int, size: int, handler: QlMmioHandler, info: str = '[mmio]'):
        # TODO: mmio memory overlap with ram? Is that possible?