#include "core_internal.h"
#include <kvec.h>
#include <ctype.h>
#include <limits.h>
#include <stdlib.h>
#include <string.h>

Data Structures
struct	install_entry

Typedefs
typedef struct install_entry	install_entry

Functions
typedef	kvec_t (install_entry)
const char *	DTTR_StatusName (DTTR_Status status)
bool	DTTR_StatusOK (DTTR_Status status)
bool	DTTR_StatusFailed (DTTR_Status status)
bool	DTTR_ResultOK (DTTR_Result result)
static bool	runtime_context_valid (const DTTR_Core_Context *ctx)
static int	hex_value (char ch)
static DTTR_Result	parse_aob_fail (char sig, char mask, DTTR_Status status, const char *message)
static DTTR_Result	parse_aob (const char aob, char out_sig, char *out_mask)
static DTTR_Result	aob_scan_with (HMODULE mod, DTTR_Core_SigscanFn sigscan, const char aob, uintptr_t out_addr)
DTTR_Result	DTTR_Core_AOBFindInModule (HMODULE mod, const char aob, uintptr_t out_addr)
DTTR_Result	DTTR_Core_AOBFind (const DTTR_Core_Context ctx, const char aob, uintptr_t *out_addr)
DTTR_Result	DTTR_Core_SignatureFind (const DTTR_Core_Context ctx, const char sig, const char mask, uintptr_t out_addr)
DTTR_Result	DTTR_Core_PatchBytes (const DTTR_Core_Context ctx, uintptr_t address, const uint8_t bytes, size_t size, DTTR_Core_Patch **out_patch)
DTTR_Result	DTTR_Core_HookFunction (const DTTR_Core_Context ctx, uintptr_t address, int prologue_size, void detour, void out_original, DTTR_Core_Hook out_hook)
DTTR_Result	DTTR_Core_HookAOB (const DTTR_Core_Context ctx, const char aob, intptr_t offset, int prologue_size, void detour, void out_original, DTTR_Core_Hook *out_hook)
static bool	rel32_displacement (uintptr_t site, void detour, int32_t out_rel)
DTTR_Result	DTTR_Core_PatchRel32Jump (const DTTR_Core_Context ctx, uintptr_t address, void detour, DTTR_Core_Patch **out_patch)
DTTR_Result	DTTR_Core_PatchAOBRel32Jump (const DTTR_Core_Context ctx, const char aob, intptr_t offset, void detour, DTTR_Core_Patch *out_patch)
DTTR_Result	DTTR_Core_HookPointer (const DTTR_Core_Context ctx, uintptr_t address, void new_value, void out_original, DTTR_Core_Hook out_hook)
DTTR_Result	DTTR_Core_Unpatch (DTTR_Core_Patch *patch)
DTTR_Result	DTTR_Core_Unhook (DTTR_Core_Hook *hook)
static DTTR_Result	install_one_target (const DTTR_Core_Context ctx, const DTTR_Core_TargetSpec target, DTTR_Core_Hook **out_handle)
static DTTR_Result	patch_group_reserve (DTTR_Core_PatchGroup *group)
static DTTR_Result	patch_group_prepare_install (DTTR_Core_PatchGroup *group)
static bool	patch_group_detach_checked (const DTTR_Core_PatchGroup group, DTTR_Core_Hook hook)
static DTTR_Result	patch_group_uninstall_from (DTTR_Core_PatchGroup *group, size_t keep_count)
DTTR_Result	DTTR_Core_PatchGroupCreate (const DTTR_Core_Context ctx, DTTR_Core_PatchGroup *out_group)
DTTR_Result	DTTR_Core_PatchGroupUninstall (DTTR_Core_PatchGroup *group)
DTTR_Result	DTTR_Core_PatchGroupDestroy (DTTR_Core_PatchGroup *group)
DTTR_Result	DTTR_Core_PatchGroupRelease (DTTR_Core_PatchGroup **group)
const DTTR_Core_Context *	dttr_core_patch_group_context (const DTTR_Core_PatchGroup *group)
static DTTR_Result	patch_group_finish_install (DTTR_Core_PatchGroup group, DTTR_Result result, DTTR_Core_Hook hook, void out_original, DTTR_Core_Hook out_hook)
DTTR_Result	DTTR_Core_PatchGroupPatchBytes (DTTR_Core_PatchGroup group, uintptr_t address, const uint8_t bytes, size_t size, DTTR_Core_Patch **out_patch)
DTTR_Result	DTTR_Core_PatchGroupHookFunction (DTTR_Core_PatchGroup group, uintptr_t address, int prologue_size, void detour, void out_original, DTTR_Core_Hook out_hook)
DTTR_Result	DTTR_Core_PatchGroupHookPointer (DTTR_Core_PatchGroup group, uintptr_t address, void new_value, void out_original, DTTR_Core_Hook out_hook)
DTTR_Result	DTTR_Core_PatchGroupPatchRel32Jump (DTTR_Core_PatchGroup group, uintptr_t address, void detour, DTTR_Core_Patch **out_patch)
static void **	target_original_slot (const DTTR_Core_TargetSpec *target)
DTTR_Result	DTTR_Core_PatchGroupInstallTargets (DTTR_Core_PatchGroup group, const DTTR_Core_TargetSpec targets, size_t target_count, DTTR_Core_TargetReport *out_report)
void	dttr_core_report_init (DTTR_Core_TargetReport *report)
void	dttr_core_report_fail (DTTR_Core_TargetReport *report, size_t index, DTTR_Result result)
static DTTR_Result	target_address (const DTTR_Core_Context ctx, const DTTR_Core_TargetSpec target, uintptr_t *out_address)

Typedef Documentation

◆ install_entry

typedef struct install_entry install_entry

Function Documentation

◆ aob_scan_with()

DTTR_Result aob_scan_with	(	HMODULE	mod,
		DTTR_Core_SigscanFn	sigscan,
		const char *	aob,
		uintptr_t *	out_addr )

static

Definition at line 212 of file core.c.

References dttr_core_result(), DTTR_ERR_NOT_FOUND, DTTR_OK, DTTR_ResultOK(), free, NULL, parse_aob(), and sigscan().

Referenced by DTTR_Core_AOBFind(), and DTTR_Core_AOBFindInModule().

◆ DTTR_Core_AOBFind()

DTTR_Result DTTR_Core_AOBFind	(	const DTTR_Core_Context *	ctx,
		const char *	aob,
		uintptr_t *	out_addr )

Resolve a textual AOB pattern through the context runtime scanner.

Parameters

ctx	Runtime context that supplies the runtime scanner and target module.
aob	Space-separated byte pattern. Wildcards follow the runtime scanner.
out_addr	Receives the resolved address on success.

Returns: DTTR_OK when the pattern is found, otherwise an error status.

Definition at line 247 of file core.c.

References aob_scan_with(), ctx, dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_RUNTIME_UNAVAILABLE, runtime_context_valid(), and DTTR_Core_API::sigscan.

Referenced by DTTR_Core_HookAOB(), DTTR_Core_PatchAOBRel32Jump(), target_address(), and test_signature_helpers_resolve_aob_patterns().

◆ DTTR_Core_AOBFindInModule()

DTTR_Result DTTR_Core_AOBFindInModule	(	HMODULE	mod,
		const char *	aob,
		uintptr_t *	out_addr )

Resolve a textual AOB pattern in an explicit module without an SDK context.

Parameters

mod	Module to scan.
aob	Space-separated byte pattern.
out_addr	Receives the resolved address on success.

Returns: DTTR_OK when the pattern is found, otherwise an error status.

Definition at line 238 of file core.c.

References aob_scan_with(), DTTR_Core_HookSigscan(), dttr_core_result(), and DTTR_ERR_INVALID_ARGUMENT.

◆ DTTR_Core_HookAOB()

DTTR_Result DTTR_Core_HookAOB	(	const DTTR_Core_Context *	ctx,
		const char *	aob,
		intptr_t	offset,
		int	prologue_size,
		void *	detour,
		void **	out_original,
		DTTR_Core_Hook **	out_hook )

Resolve an AOB target and install a function detour at its offset.

Parameters

ctx	Runtime context used to resolve and install the hook.
aob	Space-separated byte pattern to resolve.
offset	Offset added to the resolved match before installing the hook.
prologue_size	Minimum prologue bytes, or 0 for automatic sizing.
detour	Replacement function to call.
out_original	Optional output receiving the original trampoline.
out_hook	Required output receiving the hook handle.

Returns: DTTR_OK when the target resolves and the hook installs.

Definition at line 380 of file core.c.

References ctx, DTTR_Core_AOBFind(), DTTR_Core_HookFunction(), DTTR_ResultOK(), and NULL.

◆ DTTR_Core_HookFunction()

DTTR_Result DTTR_Core_HookFunction	(	const DTTR_Core_Context *	ctx,
		uintptr_t	address,
		int	prologue_size,
		void *	detour,
		void **	out_original,
		DTTR_Core_Hook **	out_hook )

Install a function detour and return both the trampoline and hook handle.

Parameters

ctx	Runtime context used to install the hook.
address	Function entry or instruction site to hook.
prologue_size	Minimum prologue bytes for the hook injection site, or 0 for automatic sizing.
detour	Replacement function to call.
out_original	Optional output receiving the original trampoline.
out_hook	Required output receiving the hook handle.

Returns: DTTR_OK when the hook is installed, otherwise an error status.

Definition at line 336 of file core.c.

References ctx, dttr_core_hook_last_error(), dttr_core_result(), DTTR_ERR_HOOK_CHAIN_UNSUPPORTED, DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_MEMORY_PROTECTION, DTTR_ERR_RUNTIME_UNAVAILABLE, DTTR_OK, DTTR_Core_API::hook_function, NULL, runtime_context_valid(), and DTTR_Result::status.

Referenced by DTTR_Core_HookAOB(), DTTR_Core_PatchGroupHookFunction(), and install_one_target().

◆ DTTR_Core_HookPointer()

DTTR_Result DTTR_Core_HookPointer	(	const DTTR_Core_Context *	ctx,
		uintptr_t	address,
		void *	new_value,
		void **	out_original,
		DTTR_Core_Hook **	out_hook )

Patch a pointer slot and optionally return the previous slot value.

Parameters

ctx	Runtime context used to patch the pointer slot.
address	Address of the pointer slot to replace.
new_value	Replacement pointer value, or NULL to clear the slot.
out_original	Optional output receiving the previous pointer value.
out_hook	Required output receiving the hook handle.

Returns: DTTR_OK when the slot is patched, otherwise an error status.

Definition at line 472 of file core.c.

References ctx, dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_MEMORY_PROTECTION, DTTR_ERR_RUNTIME_UNAVAILABLE, DTTR_OK, DTTR_Core_API::hook_pointer, NULL, and runtime_context_valid().

Referenced by DTTR_Core_PatchGroupHookPointer(), DTTR_PCDOGS_Hook_DataPointer(), install_one_target(), and install_pointer_hook().

◆ dttr_core_patch_group_context()

const DTTR_Core_Context * dttr_core_patch_group_context ( const DTTR_Core_PatchGroup * group )

Definition at line 672 of file core.c.

References NULL.

Referenced by DTTR_PCDOGS_PatchGroup_HookDataPointer(), and patch_group_hook_symbol_function().

◆ DTTR_Core_PatchAOBRel32Jump()

DTTR_Result DTTR_Core_PatchAOBRel32Jump	(	const DTTR_Core_Context *	ctx,
		const char *	aob,
		intptr_t	offset,
		void *	detour,
		DTTR_Core_Patch **	out_patch )

Resolve an AOB target and patch it with a relative JMP.

Parameters

ctx	Runtime context used to resolve and patch memory.
aob	Space-separated byte pattern to resolve.
offset	Offset added to the resolved match before writing the jump.
detour	Destination address for the relative jump.
out_patch	Required output receiving the patch handle.

Returns: DTTR_OK when the target resolves and the jump patch installs.

Definition at line 446 of file core.c.

References ctx, DTTR_Core_AOBFind(), DTTR_Core_PatchRel32Jump(), DTTR_ResultOK(), and NULL.

◆ DTTR_Core_PatchBytes()

DTTR_Result DTTR_Core_PatchBytes	(	const DTTR_Core_Context *	ctx,
		uintptr_t	address,
		const uint8_t *	bytes,
		size_t	size,
		DTTR_Core_Patch **	out_patch )

Patch bytes and return a handle that can restore the original memory.

Parameters

ctx	Runtime context used to patch memory.
address	Address to patch.
bytes	Replacement bytes to write.
size	Number of replacement bytes.
out_patch	Required output receiving the patch handle.

Returns: DTTR_OK when the bytes were patched, otherwise an error status.

Definition at line 302 of file core.c.

References ctx, dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_MEMORY_PROTECTION, DTTR_ERR_RUNTIME_UNAVAILABLE, DTTR_OK, NULL, DTTR_Core_API::patch_bytes, runtime_context_valid(), and size.

Referenced by DTTR_Core_PatchGroupPatchBytes(), DTTR_Core_PatchRel32Jump(), and install_one_target().

◆ DTTR_Core_PatchGroupCreate()

DTTR_Result DTTR_Core_PatchGroupCreate	(	const DTTR_Core_Context *	ctx,
		DTTR_Core_PatchGroup **	out_group )

Create a patch group for rollback and teardown.

Parameters

ctx	Runtime context used by patch-group installs.
out_group	Receives the created patch group on success.

Returns: DTTR_OK when the patch group is created, otherwise an error status.

Definition at line 607 of file core.c.

References ctx, dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_OUT_OF_MEMORY, DTTR_OK, NULL, and runtime_context_valid().

Referenced by DTTR_PCDOGS_PatchGroup_Install(), and test_patch_group_target_failure_rolls_back_only_new_entries().

◆ DTTR_Core_PatchGroupDestroy()

DTTR_Result DTTR_Core_PatchGroupDestroy ( DTTR_Core_PatchGroup * group )

Uninstall a patch group and release its storage.

Parameters

group Patch group to destroy, or NULL.

Returns: DTTR_OK when all tracked handles detached and storage was released. On restore failure, the group is retained so callers can retry or diagnose.

Definition at line 642 of file core.c.

References DTTR_Core_PatchGroupUninstall(), dttr_core_result(), DTTR_OK, DTTR_ResultOK(), and free.

Referenced by DTTR_Core_PatchGroupRelease(), and test_patch_group_target_failure_rolls_back_only_new_entries().

◆ DTTR_Core_PatchGroupHookFunction()

DTTR_Result DTTR_Core_PatchGroupHookFunction	(	DTTR_Core_PatchGroup *	group,
		uintptr_t	address,
		int	prologue_size,
		void *	detour,
		void **	out_original,
		DTTR_Core_Hook **	out_hook )

Install a function hook and adopt the handle into a patch group.

Parameters

group	Patch group that will own the hook handle.
address	Function entry or instruction site to hook.
prologue_size	Minimum prologue bytes, or 0 for automatic sizing.
detour	Replacement function to call.
out_original	Optional output receiving the original trampoline.
out_hook	Optional output receiving the hook handle.

Returns: DTTR_OK when the hook is installed and adopted.

Definition at line 726 of file core.c.

References DTTR_Core_HookFunction(), DTTR_ResultOK(), NULL, patch_group_finish_install(), and patch_group_prepare_install().

Referenced by patch_group_hook_symbol_function().

◆ DTTR_Core_PatchGroupHookPointer()

DTTR_Result DTTR_Core_PatchGroupHookPointer	(	DTTR_Core_PatchGroup *	group,
		uintptr_t	address,
		void *	new_value,
		void **	out_original,
		DTTR_Core_Hook **	out_hook )

Install a pointer hook and adopt the handle into a patch group.

Parameters

group	Patch group that will own the hook handle.
address	Address of the pointer slot to replace.
new_value	Replacement pointer value, or NULL to clear the slot.
out_original	Optional output receiving the previous pointer value.
out_hook	Optional output receiving the hook handle.

Returns: DTTR_OK when the slot is patched and adopted.

Definition at line 757 of file core.c.

References DTTR_Core_HookPointer(), DTTR_ResultOK(), NULL, patch_group_finish_install(), and patch_group_prepare_install().

Referenced by DTTR_PCDOGS_PatchGroup_HookDataPointer().

◆ DTTR_Core_PatchGroupInstallTargets()

DTTR_Result DTTR_Core_PatchGroupInstallTargets	(	DTTR_Core_PatchGroup *	group,
		const DTTR_Core_TargetSpec *	targets,
		size_t	target_count,
		DTTR_Core_TargetReport *	out_report )

Install target specs transactionally into a patch group.

Parameters

group	Patch group that will own installed target handles.
targets	Array of target specifications to install.
target_count	Number of entries in targets.
out_report	Optional output receiving install counts and failure details.

Returns: DTTR_OK when all required targets install. Required-target failure rolls back installed handles.

Definition at line 826 of file core.c.

References DTTR_Core_TargetReport::attempted, dttr_core_report_fail(), dttr_core_report_init(), dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_NOT_FOUND, DTTR_OK, DTTR_ResultOK(), install_one_target(), DTTR_Core_TargetReport::installed, NULL, patch_group_reserve(), patch_group_uninstall_from(), DTTR_Core_TargetReport::skipped_optional, DTTR_Result::status, and target_original_slot().

Referenced by patch_spec_install(), and test_patch_group_target_failure_rolls_back_only_new_entries().

◆ DTTR_Core_PatchGroupPatchBytes()

DTTR_Result DTTR_Core_PatchGroupPatchBytes	(	DTTR_Core_PatchGroup *	group,
		uintptr_t	address,
		const uint8_t *	bytes,
		size_t	size,
		DTTR_Core_Patch **	out_patch )

Patch bytes and adopt the handle into a patch group.

Parameters

group	Patch group that will own the patch handle.
address	Address to patch.
bytes	Replacement bytes to write.
size	Number of replacement bytes.
out_patch	Optional output receiving the patch handle.

Returns: DTTR_OK when the bytes are patched and adopted.

Definition at line 697 of file core.c.

References DTTR_Core_PatchBytes(), DTTR_ResultOK(), NULL, patch_group_finish_install(), patch_group_prepare_install(), and size.

Referenced by test_patch_group_target_failure_rolls_back_only_new_entries().

◆ DTTR_Core_PatchGroupPatchRel32Jump()

DTTR_Result DTTR_Core_PatchGroupPatchRel32Jump	(	DTTR_Core_PatchGroup *	group,
		uintptr_t	address,
		void *	detour,
		DTTR_Core_Patch **	out_patch )

Patch a rel32 jump and adopt the handle into a patch group.

Parameters

group	Patch group that will own the patch handle.
address	Address of the jump instruction to write.
detour	Destination address for the relative jump.
out_patch	Optional output receiving the patch handle.

Returns: DTTR_OK when the jump patch is installed and adopted.

Definition at line 786 of file core.c.

References DTTR_Core_PatchRel32Jump(), DTTR_ResultOK(), NULL, patch_group_finish_install(), and patch_group_prepare_install().

◆ DTTR_Core_PatchGroupRelease()

DTTR_Result DTTR_Core_PatchGroupRelease ( DTTR_Core_PatchGroup ** group )

Destroy a patch group pointer and clear the caller slot.

Parameters

group Address of the caller-owned patch group pointer, or NULL.

Returns: DTTR_OK when all tracked handles detached and *group was cleared. On restore failure, *group is retained so callers can retry or diagnose.

Definition at line 657 of file core.c.

References DTTR_Core_PatchGroupDestroy(), dttr_core_result(), DTTR_OK, DTTR_ResultOK(), and NULL.

Referenced by dttr_audio_cleanup(), dttr_game_hooks_cleanup(), dttr_graphics_hooks_cleanup(), dttr_inputs_hooks_cleanup(), dttr_movies_hooks_cleanup(), DTTR_PCDOGS_PatchGroup_Install(), and dttr_sidecar_install_pcdogs_patch_group().

◆ DTTR_Core_PatchGroupUninstall()

DTTR_Result DTTR_Core_PatchGroupUninstall ( DTTR_Core_PatchGroup * group )

Detach every active handle in a patch group while keeping it reusable.

Parameters

group Patch group to uninstall.

Returns: DTTR_OK when all tracked handles are detached.

Definition at line 634 of file core.c.

References dttr_core_result(), DTTR_OK, and patch_group_uninstall_from().

Referenced by DTTR_Core_PatchGroupDestroy().

◆ DTTR_Core_PatchRel32Jump()

DTTR_Result DTTR_Core_PatchRel32Jump	(	const DTTR_Core_Context *	ctx,
		uintptr_t	address,
		void *	detour,
		DTTR_Core_Patch **	out_patch )

Patch a site with a five-byte relative JMP when the target is in range.

Parameters

ctx	Runtime context used to patch memory.
address	Address of the jump instruction to write.
detour	Destination address for the relative jump.
out_patch	Required output receiving the patch handle.

Returns: DTTR_OK when the jump patch is installed, otherwise an error status.

Definition at line 421 of file core.c.

References ctx, DTTR_Core_PatchBytes(), dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_UNSUPPORTED, NULL, rel32_displacement(), and runtime_context_valid().

Referenced by DTTR_Core_PatchAOBRel32Jump(), DTTR_Core_PatchGroupPatchRel32Jump(), and install_one_target().

◆ dttr_core_report_fail()

void dttr_core_report_fail	(	DTTR_Core_TargetReport *	report,
		size_t	index,
		DTTR_Result	result )

Definition at line 912 of file core.c.

References DTTR_Core_TargetReport::failed_index, DTTR_Core_TargetReport::message, DTTR_Result::message, DTTR_Core_TargetReport::status, and DTTR_Result::status.

Referenced by DTTR_Core_PatchGroupInstallTargets(), and patch_report_fail().

◆ dttr_core_report_init()

void dttr_core_report_init ( DTTR_Core_TargetReport * report )

Definition at line 898 of file core.c.

References DTTR_Core_TargetReport::attempted, DTTR_OK, DTTR_Core_TargetReport::failed_index, DTTR_Core_TargetReport::installed, DTTR_Core_TargetReport::message, DTTR_Core_TargetReport::skipped_optional, and DTTR_Core_TargetReport::status.

Referenced by DTTR_Core_PatchGroupInstallTargets(), and patch_report_init().

◆ DTTR_Core_SignatureFind()

DTTR_Result DTTR_Core_SignatureFind	(	const DTTR_Core_Context *	ctx,
		const char *	sig,
		const char *	mask,
		uintptr_t *	out_addr )

Resolve a raw signature and mask through the context runtime scanner.

Parameters

ctx	Runtime context that supplies the runtime scanner and target module.
sig	Raw byte signature buffer.
mask	Mask string where implementation-defined wildcard characters skip bytes.
out_addr	Receives the resolved address on success.

Returns: DTTR_OK when the signature is found, otherwise an error status.

Definition at line 269 of file core.c.

References ctx, dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_NOT_FOUND, DTTR_ERR_RUNTIME_UNAVAILABLE, DTTR_OK, runtime_context_valid(), and DTTR_Core_API::sigscan.

Referenced by test_signature_helpers_resolve_aob_patterns().

◆ DTTR_Core_Unhook()

DTTR_Result DTTR_Core_Unhook ( DTTR_Core_Hook * hook )

Detach a function or pointer hook created by the SDK runtime.

Parameters

hook	Hook handle returned by an SDK hook call, or NULL.

Returns: DTTR_OK when detached or already null, otherwise an error.

Definition at line 517 of file core.c.

References DTTR_Core_HookDetachChecked(), dttr_core_result(), DTTR_ERR_MEMORY_PROTECTION, and DTTR_OK.

Referenced by dttr_mss_sdl_release_hooks().

◆ DTTR_Core_Unpatch()

DTTR_Result DTTR_Core_Unpatch ( DTTR_Core_Patch * patch )

Detach a byte patch created by the SDK runtime.

Parameters

patch Patch handle returned by an SDK patching call, or NULL.

Returns: DTTR_OK when detached or already null, otherwise an error.

Definition at line 509 of file core.c.

References DTTR_Core_HookDetachChecked(), dttr_core_result(), DTTR_ERR_MEMORY_PROTECTION, and DTTR_OK.

◆ DTTR_ResultOK()

bool DTTR_ResultOK ( DTTR_Result result )

Report whether an SDK result represents success.

Parameters

result Result object returned by an SDK operation.

Returns: true when result.status is DTTR_OK.

Definition at line 78 of file core.c.

References DTTR_StatusOK(), and DTTR_Result::status.

Referenced by aob_scan_with(), default_load_entry(), DTTR_Core_HookAOB(), DTTR_Core_PatchAOBRel32Jump(), DTTR_Core_PatchGroupDestroy(), DTTR_Core_PatchGroupHookFunction(), DTTR_Core_PatchGroupHookPointer(), DTTR_Core_PatchGroupInstallTargets(), DTTR_Core_PatchGroupPatchBytes(), DTTR_Core_PatchGroupPatchRel32Jump(), DTTR_Core_PatchGroupRelease(), dttr_hook_directdraw_create_ex_callback(), dttr_inputs_handle_device_event(), dttr_inputs_hook_dinput_poll_callback(), dttr_inputs_hooks_init(), dttr_mss_sdl_release_hooks(), DTTR_PCDOGS_Hook_DataPointer(), DTTR_PCDOGS_PatchGroup_HookDataPointer(), DTTR_PCDOGS_PatchGroup_Install(), dttr_sidecar_install_pcdogs_patch_group(), DTTR_Util_GetActiveActor(), file_open_with_mode(), install_one_target(), install_pointer_hook(), patch_group_finish_install(), patch_group_hook_symbol_function(), patch_spec_install(), require_pcdogs_call(), resolve_toc(), set_joystick_available(), target_address(), test_patch_group_target_failure_rolls_back_only_new_entries(), and test_signature_helpers_resolve_aob_patterns().

◆ DTTR_StatusFailed()

bool DTTR_StatusFailed ( DTTR_Status status )

Report whether an SDK status represents failure.

Parameters

status Status value returned by an SDK operation.

Returns: true when status is not DTTR_OK.

Definition at line 74 of file core.c.

References DTTR_StatusOK().

◆ DTTR_StatusName()

const char * DTTR_StatusName ( DTTR_Status status )

Return a stable text token for SDK status values used by logs and tests.

Parameters

status Status value to name.

Returns: Static string like DTTR_OK or DTTR_ERR_INVALID_ARGUMENT.

Definition at line 23 of file core.c.

References DTTR_ERR_ABI_MISMATCH, DTTR_ERR_ALREADY_INSTALLED, DTTR_ERR_HOOK_CHAIN_UNSUPPORTED, DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_MEMORY_PROTECTION, DTTR_ERR_MISSING_SYMBOL, DTTR_ERR_NOT_CALLABLE, DTTR_ERR_NOT_FOUND, DTTR_ERR_NOT_INSTALLED, DTTR_ERR_OUT_OF_MEMORY, DTTR_ERR_POLICY_MISMATCH, DTTR_ERR_PROVENANCE_UNSAFE, DTTR_ERR_READ_FAILED, DTTR_ERR_RUNTIME_UNAVAILABLE, DTTR_ERR_UNRESOLVED, DTTR_ERR_UNSUPPORTED, DTTR_ERR_UNSUPPORTED_CONTRACT, DTTR_ERR_UNSUPPORTED_LAYOUT, DTTR_ERR_WRITE_FAILED, and DTTR_OK.

Referenced by dttr_sidecar_result_detail().

◆ DTTR_StatusOK()

bool DTTR_StatusOK ( DTTR_Status status )

Report whether an SDK status represents success.

Parameters

status Status value returned by an SDK operation.

Returns: true when status is DTTR_OK.

Definition at line 70 of file core.c.

References DTTR_OK.

Referenced by DTTR_ResultOK(), and DTTR_StatusFailed().

◆ hex_value()

int hex_value ( char ch )

static

Definition at line 86 of file core.c.

Referenced by parse_aob().

◆ install_one_target()

DTTR_Result install_one_target	(	const DTTR_Core_Context *	ctx,
		const DTTR_Core_TargetSpec *	target,
		DTTR_Core_Hook **	out_handle )

static

Definition at line 956 of file core.c.

References ctx, DTTR_Core_HookFunction(), DTTR_Core_HookPointer(), DTTR_Core_PatchBytes(), DTTR_Core_PatchRel32Jump(), dttr_core_result(), DTTR_ERR_UNSUPPORTED, DTTR_ResultOK(), DTTR_TARGET_ADDRESS_HOOK, DTTR_TARGET_ADDRESS_PATCH, DTTR_TARGET_ADDRESS_REL32_JMP, DTTR_TARGET_AOB_HOOK, DTTR_TARGET_AOB_PATCH, DTTR_TARGET_AOB_REL32_JMP, DTTR_TARGET_POINTER_HOOK, NULL, target, and target_address().

Referenced by DTTR_Core_PatchGroupInstallTargets().

◆ kvec_t()

typedef kvec_t ( install_entry )

Definition at line 15 of file core.c.

References ctx.

◆ parse_aob()

DTTR_Result parse_aob	(	const char *	aob,
		char **	out_sig,
		char **	out_mask )

static

Definition at line 114 of file core.c.

References count, dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_ERR_OUT_OF_MEMORY, DTTR_OK, hex_value(), NULL, and parse_aob_fail().

Referenced by aob_scan_with().

◆ parse_aob_fail()

DTTR_Result parse_aob_fail	(	char *	sig,
		char *	mask,
		DTTR_Status	status,
		const char *	message )

static

Definition at line 102 of file core.c.

References dttr_core_result(), and free.

Referenced by parse_aob().

◆ patch_group_detach_checked()

bool patch_group_detach_checked	(	const DTTR_Core_PatchGroup *	group,
		DTTR_Core_Hook *	hook )

static

Definition at line 566 of file core.c.

References DTTR_Core_HookDetachChecked(), NULL, DTTR_Core_API::unhook, and DTTR_Core_API::unhook_checked.

Referenced by patch_group_uninstall_from().

◆ patch_group_finish_install()

DTTR_Result patch_group_finish_install	(	DTTR_Core_PatchGroup *	group,
		DTTR_Result	result,
		DTTR_Core_Hook *	hook,
		void **	out_original,
		DTTR_Core_Hook **	out_hook )

static

Definition at line 677 of file core.c.

References DTTR_ResultOK().

Referenced by DTTR_Core_PatchGroupHookFunction(), DTTR_Core_PatchGroupHookPointer(), DTTR_Core_PatchGroupPatchBytes(), and DTTR_Core_PatchGroupPatchRel32Jump().

◆ patch_group_prepare_install()

DTTR_Result patch_group_prepare_install ( DTTR_Core_PatchGroup * group )

static

Definition at line 557 of file core.c.

References dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, and patch_group_reserve().

Referenced by DTTR_Core_PatchGroupHookFunction(), DTTR_Core_PatchGroupHookPointer(), DTTR_Core_PatchGroupPatchBytes(), and DTTR_Core_PatchGroupPatchRel32Jump().

◆ patch_group_reserve()

DTTR_Result patch_group_reserve ( DTTR_Core_PatchGroup * group )

static

Definition at line 532 of file core.c.

References dttr_core_result(), DTTR_ERR_OUT_OF_MEMORY, and DTTR_OK.

Referenced by DTTR_Core_PatchGroupInstallTargets(), and patch_group_prepare_install().

◆ patch_group_uninstall_from()

DTTR_Result patch_group_uninstall_from	(	DTTR_Core_PatchGroup *	group,
		size_t	keep_count )

static

Definition at line 585 of file core.c.

References dttr_core_result(), DTTR_ERR_MEMORY_PROTECTION, DTTR_OK, install_entry::hook, NULL, install_entry::out_original, and patch_group_detach_checked().

Referenced by DTTR_Core_PatchGroupInstallTargets(), and DTTR_Core_PatchGroupUninstall().

◆ rel32_displacement()

bool rel32_displacement	(	uintptr_t	site,
		void *	detour,
		int32_t *	out_rel )

static

Definition at line 410 of file core.c.

Referenced by DTTR_Core_PatchRel32Jump().

◆ runtime_context_valid()

bool runtime_context_valid ( const DTTR_Core_Context * ctx )

static

Definition at line 82 of file core.c.

References ctx.

Referenced by DTTR_Core_AOBFind(), DTTR_Core_HookFunction(), DTTR_Core_HookPointer(), DTTR_Core_PatchBytes(), DTTR_Core_PatchGroupCreate(), DTTR_Core_PatchRel32Jump(), and DTTR_Core_SignatureFind().

◆ target_address()

DTTR_Result target_address	(	const DTTR_Core_Context *	ctx,
		const DTTR_Core_TargetSpec *	target,
		uintptr_t *	out_address )

static

Definition at line 927 of file core.c.

References ctx, DTTR_Core_AOBFind(), dttr_core_result(), DTTR_ERR_INVALID_ARGUMENT, DTTR_OK, DTTR_ResultOK(), DTTR_TARGET_ADDRESS_HOOK, DTTR_TARGET_ADDRESS_PATCH, DTTR_TARGET_ADDRESS_REL32_JMP, DTTR_TARGET_POINTER_HOOK, and target.

Referenced by assert_pointer_ff25_e8_target(), assert_pointer_u32_at_match_plus_2(), and install_one_target().

◆ target_original_slot()

void ** target_original_slot ( const DTTR_Core_TargetSpec * target )

static

Definition at line 814 of file core.c.

References DTTR_TARGET_ADDRESS_HOOK, DTTR_TARGET_AOB_HOOK, DTTR_TARGET_POINTER_HOOK, NULL, and target.

Referenced by DTTR_Core_PatchGroupInstallTargets().

Data Structures

Typedefs

Functions

Typedef Documentation

◆ install_entry

Function Documentation

◆ aob_scan_with()

◆ DTTR_Core_AOBFind()

◆ DTTR_Core_AOBFindInModule()

◆ DTTR_Core_HookAOB()

◆ DTTR_Core_HookFunction()

◆ DTTR_Core_HookPointer()

◆ dttr_core_patch_group_context()

◆ DTTR_Core_PatchAOBRel32Jump()

◆ DTTR_Core_PatchBytes()

◆ DTTR_Core_PatchGroupCreate()

◆ DTTR_Core_PatchGroupDestroy()

◆ DTTR_Core_PatchGroupHookFunction()

◆ DTTR_Core_PatchGroupHookPointer()

◆ DTTR_Core_PatchGroupInstallTargets()

◆ DTTR_Core_PatchGroupPatchBytes()

◆ DTTR_Core_PatchGroupPatchRel32Jump()

◆ DTTR_Core_PatchGroupRelease()

◆ DTTR_Core_PatchGroupUninstall()

◆ DTTR_Core_PatchRel32Jump()

◆ dttr_core_report_fail()

◆ dttr_core_report_init()

◆ DTTR_Core_SignatureFind()

◆ DTTR_Core_Unhook()

◆ DTTR_Core_Unpatch()

◆ DTTR_ResultOK()

◆ DTTR_StatusFailed()

◆ DTTR_StatusName()

◆ DTTR_StatusOK()

◆ hex_value()

◆ install_one_target()

◆ kvec_t()

◆ parse_aob()

◆ parse_aob_fail()

◆ patch_group_detach_checked()

◆ patch_group_finish_install()

◆ patch_group_prepare_install()

◆ patch_group_reserve()

◆ patch_group_uninstall_from()

◆ rel32_displacement()

◆ runtime_context_valid()

◆ target_address()

◆ target_original_slot()