Open System Services System Calls Reference Manual (G06.25+, H06.03+)

System Functions (e) execvp(2)
NAME
execvp - Executes a file using a filename, an argv array, and **environ
LIBRARY
G-series native OSS processes: /G/system/sysnn/zossksrl
H-series OSS processes: /G/system/zdllnnn/zosskdll
SYNOPSIS
#include <unistd.h>
extern char ∗∗∗∗environ;
int execvp(
const char ∗∗file,
char ∗∗ const argv[ ]);
PARAMETERS
**environ Points to an array of character pointers to environment strings. The environment
strings define the OSS environment for the new process. The environ array is
terminated by a null pointer.
The **environ array of the new process is also passed as the env[]array in the
call to the main() function of the new process. Refer to Entering the New Pro-
cess later in this reference page.
file Identifies the new process image file. If this parameter
• Starts with a slash (/) character, then it contains the absolute pathname.
• Does not start with a slash but does contain a slash, then the pathname
resolves relative to the current working directory.
• Contains no slash, the system searches the directories listed in the PATH
environment variable for the file and prefixes the directory in which it is
found.
argv[] Specifies an array of character pointers to null-terminated strings containing
arguments to be passed to the main function of the new program. argv[0] should
point to the null-terminated string containing the filename of the new process
image. The last member of this array must be a null pointer.
These strings constitute the argument list available to the new process image.
DESCRIPTION
The execvp() function is one of the set of exec functions. The exec set of functions replace the
current process image with a new process image. The new image is constructed from a regular
executable file, called a new process image file. The new process image file is formatted as an
executable text or binary file in one of the formats recognized by the exec set of functions.
A successful execvp() function call does not return, because the calling process image is over-
laid by the new process image.
527186-003 Hewlett-Packard Company 2−43