FpExecLE
Execute process (using argument list, environment)
Declaration
Source position: unix.pp line 108
function FpExecLE(const PathName: RawByteString;
const S: Array of RawByteString; MyEnv: ppchar) : cint;
Description
FpExecLE 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 environment in MyEnv is passed to the program. On success, FpExecLE 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 |
|---|---|
| FpExecl | Execute process (using argument list, environment) |
| FpExeclp | Execute process (using argument list, environment; search path) |
| FpExecv | Execute process |
| FpExecvp | Execute process, search path |
| FpExecve | Execute process using environment |
| FpFork | Create child process |
Example
Program Example11;
{ Program to demonstrate the Execle function. }
Uses Unix, strings;
begin
{ Execute 'ls -l', with current environment. }
{ 'ls' is NOT looked for in PATH environment variable.}
{ envp is defined in the system unit.}
Execle ('/bin/ls -l',envp);
end.