Carlos Pizano
e803fd9b26
1- was not checking for the rights of the transferred handle 2- was not restoring the transferred handle upon start failure 3- ktrace was emitted before success 4- was not standard in returning bad handle for a bad handle It also takes less locks Change-Id: I418417ae280cf75188537acc5a09ab5a8eb719d9
1.9 KiB
mx_process_start
NAME
process_start - start execution on a process
SYNOPSIS
#include <magenta/syscalls.h>
mx_status_t mx_process_start(mx_handle_t process, mx_handle_t thread,
uintptr_t entry, uintptr_t stack,
mx_handle_t arg1, uintptr_t arg2);
DESCRIPTION
process_start() is similar to thread_start(), but is used for the purpose of starting the first thread in a process.
process_start() causes a thread to begin execution at the program counter specified by entry and with the stack pointer set to stack. The arguments arg1 and arg2 are arranged to be in the architecture specific registers used for the first two arguments of a function call before the thread is started. All other registers are zero upon start.
The first argument (arg1) is a handle, which will be transferred from the process of the caller to the process which is being started, and an appropriate handle value will be placed in arg1 for the newly started thread.
RETURN VALUE
process_start() returns MX_OK on success. In the event of failure, a negative error value is returned.
ERRORS
MX_ERR_BAD_HANDLE process or thread or arg1 is not a valid handle.
MX_ERR_WRONG_TYPE process is not a process handle or thread is not a thread handle.
MX_ERR_ACCESS_DENIED The handle thread lacks MX_RIGHT_WRITE or thread does not belong to process, or the handle process lacks MX_RIGHT_WRITE or arg1 lacks MX_RIGHT_TRANSFER.
MX_ERR_BAD_STATE process is already running or has exited.
SEE ALSO
handle_close, handle_duplicate, object_wait_one, object_wait_many, process_create, thread_create, thread_exit, thread_start.