Execv

Execute process

Declaration

Source position: line 0

procedure Execv(

const path: PathStr;

args: ppchar

); procedure Execv(

const path: AnsiString;

args: ppchar

);

Description

Replaces the currently running program with the program, specified in path. It gives the program the options in args. This is a pointer to an array of pointers to null-terminated strings. The last pointer in this array should be nil. The current environment is passed to the program. On success, execv 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.
sys_enotdir: A component of the path is not a directory.
sys_eloop: The path contains a circular reference (via symlinks).

Example

Program Example8;

{ Program to demonstrate the Execv function. }

Uses oldlinux, strings;

Const Arg0 : PChar = '/bin/ls';
      Arg1 : Pchar = '-l';

Var PP : PPchar;


begin
  GetMem (PP,3*SizeOf(Pchar));
  PP[0]:=Arg0;
  PP[1]:=Arg1;
  PP[3]:=Nil;
  { Execute '/bin/ls -l', with current environment }
  Execv ('/bin/ls',pp);
end.

Notes

 No notes exist for this page yet.