[Overview][Constants][Types][Procedures and functions][Variables][Index] | Reference for unit 'oldlinux' (#rtl)

# Execlp

Execute process (using argument list, environment; search path)

## Declaration

Source position: line 0

`procedure Execlp(`
`Todo: string;`
`Ep: ppchar`
`); procedure Execlp(`
`Todo: Ansistring;`
`Ep: ppchar`
`);`

## Description

Replaces the currently running program with the program, specified in path. Path is split into a command and it's options. The executable in path is searched in the path, if it isn't an absolute filename. The current environment is passed to the program. On success, execlp does not return.

## Errors

Errors are reported in LinuxError:

sys_eacces
  File is not a regular file, or has no execute permission. A compononent of the path has no search permission.
sys_eperm
  The file system is mounted noexec.
sys_e2big
  Argument list too big.
sys_enoexec
  The magic number in the file is incorrect.
sys_enoent
  The file does not exist.
sys_enomem
  Not enough memory for kernel, or to split command line.
sys_enotdir
  A component of the path is not a directory.
sys_eloop
  The path contains a circular reference (via symlinks).

## See also

Execve |  | Execute process using environment
Execv |  | Execute process
Execvp |  | Execute process, search path
Execle |  | Execute process (using argument list, environment)
Execl |  | Execute process (using argument list)
Fork |  | Create child process

## Example

    Program Example12;

    { Program to demonstrate the Execlp function. }

    Uses oldlinux, strings;

    begin
      { Execute 'ls -l', with current environment. }
      { 'ls' is looked for in PATH environment variable.}
      { envp is defined in the system unit.}
      Execlp ('ls -l',envp);
    end.

Documentation generated on: Feb 26 2014