execle(3)

DESCRIPTION

Replaces the calling image with path, constructing argv up to a null pointer and taking the environment vector following that terminator.

SYNOPSIS

#include <unistd.h>

int execle(const char *path, const char *arg0, ...);

RETURN VALUE

  • Does not return on success
  • returns -1 and sets errno on failure.

ERRORS

  • -E2BIG
    • The argument or environment vector exceeds its limit.
  • -EFAULT
    • A path, argument, or environment pointer is invalid.
  • -ENOENT
    • Path does not exist.
  • -ENOEXEC
    • Path is not a valid executable.
  • -ENOMEM
    • The replacement image cannot be allocated.

NOTES

The argument list must contain a null pointer before the final environment-vector argument.