Skip to content

    FpExecL

    Execute process (using argument list, environment).

    Declaration

    Source position: unix.pp line 124

    function FpExecL(const PathName: RawByteString; 
                const S: Array of RawByteString = type string(CP_NONE))
                 : 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

    Name Description
    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.