zx_system_mexec

NAME

system_mexec - Soft reboot the system with a new kernel and bootimage

SYNOPSIS

#include <zircon/syscalls.h>

zx_status_t zx_system_mexec(zx_handle_t resource,
                            zx_handle_t kernel_vmo,
                            zx_handle_t bootimage_vmo);

DESCRIPTION

zx_system_mexec() accepts two vmo handles: kernel_vmo should contain a kernel image and bootimage_vmo should contain an initrd whose address shall be passed to the new kernel as a kernel argument.

To supplant the running kernel, a resource of ZX_RSRC_KIND_ROOT must be supplied.

Upon success, zx_system_mexec shall supplant the currently running kernel image with the kernel image contained within kernel_vmo, load the ramdisk contained within bootimage_vmo to a location in physical memory and branch directly into the new kernel while providing the address of the loaded initrd to the new kernel.

RIGHTS

TODO(ZX-2399)

RETURN VALUE

zx_system_mexec() shall not return upon success.