KCREATE(2)

NAME
kcreate - Create a LAM process from an executable program.

SYNOPSIS
int kcreate (char *filename, char **argv);

DESCRIPTION
This local layer function is used to create a process on the local node from an executable program. Higher level functions are available that simplify process creation.

The filename argument is a locally accessible pathname containing the exectuable program. The argv argument points to a null terminated array of strings. By convention, the first string is the filename argument.

The new process must call kenter(2) before any other system functions.

For most purposes, users will prefer to create LAM processes using rploadgo(2), which permits a process to be created on any node, including locally, from an executable file on any node.

RETURN VALUE
Upon successful completion, the new process identifier is returned. Otherwise -1 is returned and the global variable errno is set to indicate the error.

SEE ALSO
rploadgo(2)