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

# FpExecL

Execute process (using argument list, environment)

## Declaration

Source position: unix.pp line 79

`function FpExecL(`
`const PathName: RawByteString;`
`const S: array of RawByteString`
`):cint;`

## Description

FpExecL replaces the currently running program with the program, specified in PathName. S is an array of command options. The executable in PathName must be an absolute pathname. The current process' environment is passed to the program. On success, FpExecL does not return.

## Errors

Extended error information is returned by the FpGetErrno function:

sys_eacces
  File is not a regular file, or has no execute permission. A component 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

FpExecve |  | Execute process using environment
FpExecv |  | Execute process
FpExecvp |  | Execute process, search path
FpExecle |  | Execute process (using argument list, environment)
FpExeclp |  | Execute process (using argument list, environment; search path)
FpFork |  | Create child process

## Example

    Program Example77;

    { Program to demonstrate the FPExecL function. }

    Uses Unix, strings;

    begin
      { Execute 'ls -l', with current environment. }
      { 'ls' is NOT looked for in PATH environment variable.}
      FpExecL ('/bin/ls',['-l']);
    end.