execlp(3)

DESCRIPTION

Searches PATH for file and replaces the calling image, constructing argv from the NULL-terminated argument list and inheriting environ.

SYNOPSIS

#include <unistd.h>

int execlp(const char *file, 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
    • An argument pointer is invalid.
  • -ENOENT
    • No PATH entry names file.
  • -ENOEXEC
    • A selected file is not a valid executable.
  • -ENOMEM
    • The replacement image cannot be allocated.

NOTES

The final variadic argument must be a null pointer.