Function nstd_sys::proc::nstd_proc_spawn

source · 
#[no_mangle]
pub unsafe extern "C" fn nstd_proc_spawn(
    program: &NSTDStr,
    args: &NSTDSlice,
    vars: &NSTDSlice
) -> NSTDOptionalChildProcess
Available on crate feature proc only.
Expand description

Spawns a new child process with the name program and returns a handle to it.

Parameters:

  • const NSTDStr *program - A path to the program to run as a child process.

  • const NSTDSlice *args - A slice of NSTDStr arguments to pass to the program.

  • const NSTDSlice *vars - A slice of NSTDStr[2] key/value environment variables to give to the program.

Returns

NSTDOptionalChildProcess child - A handle to the new child process on success, or an uninitialized “none” variant if spawning the child process fails.

Panics

This operation will panic in any of the following situations:

  • args’s stride is not equal to sizeof(NSTDStr).

  • vars’s stride is not equal to sizeof(NSTDStr[2]).

Safety

The user must ensure that all of program, args, and vars and their data remain valid for reads while this function is executing.