IPL Library Parent topic: IPL Library

image_start(), image_start_2()

Updated: April 19, 2023

Jump to the bootable OS image start point

Synopsis:

int image_start (unsigned long address)
int image_start_2 (unsigned long address)

Arguments:

address
The address in memory of the OS startup code to which the function must jump

Description:

The image_start() function starts the OS image by jumping to the startup_vaddr address as defined in the startup header (see “The startup header”).

Note: Use the image_start*() and image_setup*() functions that correspond to the image_scan*() function you used; for example, if you used image_scan_2(), use image_setup_2() and image_start_2().

Returns:

These functions should never return; if they fail, they return -1.

-1
Failure
Parent topic: IPL Library