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

Execle

Execute process (using argument list, environment)

Declaration

Source position: line 0

procedure Execle(

  Todo: String;

  Ep: ppchar

);

procedure Execle(

  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 environment in ep is passed to the program. On success, execle 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

Execl

  

Execute process (using argument list)

Execlp

  

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

Fork

  

Create child process

Example

Program Example11;

{ Program to demonstrate the Execle function. }

Uses oldlinux, 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.
The latest version of this document can be found at lazarus-ccr.sourceforge.net.