execl(3)						     Library Functions Manual							  execl(3)

Name
       execl, execv, execle, execlp, execvp, exect, environ - execute a file

Syntax
       execl(name, arg0, arg1, ..., argn, (char *)0)
       char *name, *arg0, *arg1, ..., *argn;

       execv(name, argv)
       char *name, *argv[];

       execle(name, arg0, arg1, ..., argn, (char *)0, envp)
       char *name, *arg0, *arg1, ..., *argn, *envp[];

       execlp(file, arg0, arg1, ..., argn, (char *)0)
       char *file, *arg0, *arg1, ..., *argn;

       execvp(file,argv)
       char *file, *argv[];

       exect(name, argv, envp)
       char *name, *argv[], *envp[];

       extern char **environ;

Description
       These  routines provide various interfaces to the system call.  Refer to for a description of their properties; only brief descriptions are
       provided here.

       In all their forms, these calls overlay the calling process with the named file, then transfer to the entry point of the core image of  the
       file.  There can be no return from a successful exec.  The calling core image is lost.

       The  name  argument is a pointer to the name of the file to be executed.  The pointers arg[0], arg[1] ...  address null-terminated strings.
       Conventionally arg[0] is the name of the file.

       Two interfaces are available.  is useful when a known file with known arguments is being called; the arguments to are the character strings
       constituting the file and the arguments; the first argument is conventionally the same as the file name (or its last component).  A 0 argu-
       ment must end the argument list.

       The version is useful when the number of arguments is unknown in advance.  The arguments to are the name of the file to be executed  and  a
       vector of strings containing the arguments.  The last argument string must be followed by a 0 pointer.

       The  version  is used when the executed file is to be manipulated with The program is forced to single step a single instruction giving the
       parent an opportunity to manipulate its state.  On VAX-11 machines, this is done by setting the trace bit in the process status longword.

       When a C program is executed, it is called as follows:
	    main(argc, argv, envp)
	    int argc;
	    char **argv, **envp;
       where argc is the argument count and argv is an array of character pointers to the arguments themselves.  As indicated, argc is convention-
       ally at least one and the first member of the array points to a string containing the name of the file.

       The argv is directly usable in another because argv[argc] is 0.

       The envp is a pointer to an array of strings that constitute the environment of the process.  Each string consists of a name, an "=", and a
       null-terminated value.  The array of pointers is terminated by a null pointer.  The shell passes an environment entry for each global shell
       variable  defined  when	the program is called.	See for some conventionally used names.  The C run-time start-off routine places a copy of
       envp in the global cell which is used by and to pass the environment to any subprograms executed by the current program.

       The and routines are called with the same arguments as and but duplicate the shell's actions in searching for an executable file in a  list
       of directories.	The directory list is obtained from the environment.

Restrictions
       If  is  called  to  execute  a  file that turns out to be a shell command file, and if it is impossible to execute the shell, the values of
       argv[0] and argv[-1] will be modified before return.

Diagnostics
       If the file cannot be found, if it is not executable, if it does not start with a valid magic number if maximum memory is exceeded,  or	if
       the  arguments  require too much space, a return constitutes the diagnostic; the return value is -1.  For further information, see Even for
       the super-user, at least one of the execute-permission bits must be set for a file to be executed.

Files
       /bin/sh	 Shell, invoked if command file found by execlp or execvp

See Also
       csh(1), execve(2), fork(2), environ(7)

								       RISC								  execl(3)