Leunsel: Initial page creation.

2026-06-21T17:13:52Z

Initial page creation.

New page

[[Category:Lua]]
{{CodeBox|'''class''' RIPRelativeScanner ''':''' Object}}

The RIPRelativeScanner class scans a memory range or module for RIP-relative instructions.

A RIPRelativeScanner inherits from Object. It can be used to find instructions that contain RIP-relative addresses. The resulting addresses point to the RIP-relative offset inside the instruction.

===Inheritance===
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
!align="left"|Class
!align="left"|Inherits From
!style="width: 80%;background-color:white;" align="left"|Description
|-
|RIPRelativeScanner
|Object
|Scans a memory range or module for RIP-relative instructions.
|}

===Creation===
{{CodeBox|'''function''' createRipRelativeScanner(''startaddress'', ''stopaddress'', ''includejumpsandcalls'') ''':''' RIPRelativeScanner}}
{{CodeBox|'''function''' createRipRelativeScanner(''modulename'', ''includejumpsandcalls'') ''':''' RIPRelativeScanner}}

Creates a RIP-relative scanner.

When a start and stop address are provided, the scanner scans the specified address range. When a module name is provided, the scanner scans the specified module.

The ''includejumpsandcalls'' parameter controls whether RIP-relative jumps and calls are included in the results.

===Function Parameters===
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
!align="left"|Parameter
!align="left"|Type
!style="width: 80%;background-color:white;" align="left"|Description
|-
|startaddress
|Integer or [[CEAddressString]]
|The start address of the memory range to scan.
|-
|stopaddress
|Integer or [[CEAddressString]]
|The stop address of the memory range to scan.
|-
|modulename
|String
|The name of the module to scan.
|-
|includejumpsandcalls
|Boolean (optional)
|If true, RIP-relative jumps and calls are included in the scan results.
|}

===Returns===
RIPRelativeScanner — The created RIPRelativeScanner object.

===Properties===
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
!align="left"|Property
!align="left"|Type
!style="width: 80%;background-color:white;" align="left"|Description
|-
|Count
|Integer
|The number of instructions found that have a RIP-relative address.
|-
|Address[]
|Integer
|An array used to access the results. Each entry is the address of the RIP-relative offset inside the instruction.
|}

===Methods===
This class has no documented methods.

===Examples===
<pre>
local scanner = createRipRelativeScanner("game.exe")

print("RIP-relative instruction count: " .. tostring(scanner.Count))

for i = 0, scanner.Count - 1 do
print(string.format("%X", scanner.Address[i]))
end
</pre>

<pre>
local startAddress = getAddress("game.exe")
local stopAddress = startAddress + getModuleSize("game.exe")

local scanner = createRipRelativeScanner(startAddress, stopAddress, true)

print("RIP-relative instruction count: " .. tostring(scanner.Count))

for i = 0, math.min(scanner.Count - 1, 9) do
print(string.format("%X", scanner.Address[i]))
end
</pre>

{{LuaSeeAlso}}

Lua:Class:RIPRelativeScanner - Revision history

Leunsel: Initial page creation.