Overlays

API for loading and executing overlays. More...

Files
file	exec.h
	Program execution.

Functions
void	arch_exec_at (const void *image, uint32 length, uint32 address) __noreturn
	Replace the currently running binary.
void	arch_exec (const void *image, uint32 length) __noreturn
	Replace the currently running binary at the default address.

Detailed Description

API for loading and executing overlays.

Function Documentation

arch_exec()

void arch_exec	(	const void *	image,
		uint32	length
	)

Replace the currently running binary at the default address.

This is a convenience function for arch_exec_at() that assumes that the binary has been set up with its starting point at the standard location. In the case of the Dreamcast, this is 0xAC010000 (or 0x8C010000, in P1).

Parameters

image	The binary to run (already loaded into RAM).
length	The length of the binary.

arch_exec_at()

void arch_exec_at	(	const void *	image,
		uint32	length,
		uint32	address
	)

Replace the currently running binary.

This function will replace the currently running binary with whatever is at the specified address. This function does not return.

Parameters

image	The binary to run (already loaded into RAM).
length	The length of the binary.
address	The address of the binary's starting point.