image_start(), image_start_2(), image_start_ext()

Jump to the bootable OS image start point

Synopsis:

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

Arguments:

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

Description:

The image_start() and image_start_ext() functions start the OS image by jumping to the startup_vaddr address as defined in the startup header (see The startup header).

Use the image_start_ext() function for an x86 system with a BIOS. This function starts the OS image with a jump instruction that uses the BIOS.

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