---
name: "kcreate"
section: "2"
platform: "linux"
package: "lam2-dev"
version: "6.3.2-3"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/kcreate"
---

# kcreate(2)

Create a LAM process from an executable program.

## 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)](/kenter/2.md) before any other system functions.

For most purposes, users will prefer to create LAM processes using [rploadgo(2)](/rploadgo/2.md), 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)](/rploadgo/2.md)