FpExecL

Execute process (using argument list, environment)

Declaration

Source position: unix.pp line 79

function FpExecL(

const PathName: AnsiString;

const S: array of AnsiString

):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 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).

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.

Notes

 No notes exist for this page yet.