|
|
#include <unistd.h>int execl (const char path, const char arg0, .../*, const char argn, (char *)0*/);
int execv (const char path, char const argv);
int execle (const char path, const char arg0, .../*, const char argn, (char *)0, const char envp[]*/);
int execve (const char path, char const argv, char const envp);
int execlp (const char file, const char arg0, .../*, const char argn, (char *)0*/);
int execvp (const char file, char const argv);
An interpreter file begins with a line of the form
#! pathname [arg]
where pathname is the path of the interpreter, and arg is an optional argument. When you exec an interpreter file, the system execs the specified interpreter. The pathname specified in the interpreter file is passed as arg0 to the interpreter. If arg was specified in the interpreter file, it is passed as arg1 to the interpreter. The remaining arguments to the interpreter are arg0 through argn of the originally executed file.
When a C program is executed, it is called as follows:
int main (int argc, char argv[], char envp[]);
where argc is the argument count, argv is an array of character pointers to the arguments themselves, and envp is an array of character pointers to null-terminated strings that constitute the environment for the new process. The value of the argument argc is conventionally at least one. The initial member of the array argv points to a string containing the name of the file.
The argument path points to a pathname that identifies the new process file. For execlp and execvp, the argument file points to the new process file. If the file argument does not contain a slash character, the path prefix for this file is obtained by searching the directories passed as the environment variable PATH [see environ(M)]. The environment is supplied typically by the shell [see sh(C)].
If the new executable file is not an executable object file and not an interpreter file, execlp and execvp use the contents of that file as standard input to the user's default shell.
The arguments arg0, ... are pointers to null-terminated character strings. These strings constitute the argument list available to the new process. The list is terminated by a null pointer. By convention, at least arg0 is present and points to a string that is the same as file or path (or its last component), point to null-terminated character strings. It will become the name of the process, as displayed by the ps command. The list of argument strings is terminated by a (char )0 argument.
argv is an array of character pointers to null-terminated strings. These strings constitute the argument list available to the new process. By convention, argv[0] must have at least one member, and it should point to a string that is the same as file or path (or its last component). argv is terminated by a null pointer.
The argument envp is an array of character pointers to null-terminated strings. These strings constitute the environment for the new process. A null pointer terminates envp. For execl, execv, execvp, and execlp, the C run-time start-off routine places a pointer to the environment of the calling process in the global object extern char environ, and it is used to pass the environment of the calling process to the new process image.
File descriptors open in the calling process remain open in the new process image, except for those whose ``close-on-exec'' flag is set [see fcntl(S)]. For those file descriptors that remain open, the file pointer remains unchanged and all file locks associated with the file are preserved.
Signals being caught by the calling process are set to the default disposition in the new process image [see signal(S)]. Otherwise, the new process image inherits the signal dispositions of the calling process.
If the set-user-ID-on-execution mode bit of the new process file is set, the exec routines set the effective user ID of the new process to the owner ID of the new process file [see chmod(S)]. Similarly, if the set-group-ID mode bit of the new process file is set, the effective group ID of the new process is set to the group ID of the new process file. The real user ID, real group ID and supplementary group IDs of the new process remain the same as those of the calling process. The saved user and group IDs of the new process image are set to the effective user and group IDs of the calling process. Set-user-ID and set-group-ID on execution shall occur for interpreter files.
If the calling process has the P_SYSOPS privilege, the set-user-ID and set-group-ID bits are honored when the process is being controlled by ptrace; otherwise, they are not honored by ptrace.
The shared memory segments attached to the calling process will not be attached to the new process image [see shmop(S)].
Profiling is disabled for the new process image [see profil(S)].
The new process image also preserves the following attributes across this system call.
If exec succeeds, it marks for update the st_atime field of the file.
If exec succeeds, an internal reference to the process image file is created. This reference is removed some time later, but not later than process termination or successful completion of a subsequent call to one of the exec functions.