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

System Functions (t) tdm_execvep(2)
the new process is set to the ANCESTOR field of the calling process, and the MOM field of the
new process is null.
The MOM and ANCESTOR fields for the new process are the same as for a process created in
the Guardian environment if the new process is unnamed (the pe_name_options field is set to
_TPC_NO_NAME). If the caller is unnamed, the MOM field for the new process is set to the
MOM field of the caller. If the caller is named, the MOM field for the new process is set to the
ANCESTOR field of the calling process.
For detailed information about Guardian process attributes, see the PROCESS_LAUNCH_ pro-
cedure in the Guardian Procedure Calls Reference Manual.
Output Structure Information
If the pr_results parameter does not contain a null pointer, it points to an output structure defined
in the tdmext.h header file. This structure can contain fields that vary from RVU to RVU,
including reserved and filler fields.
First, the output structure must be initialized by using the #define
DEFAULT_PROCESS_EXTENSION_RESULTS
. This initialization sets the value of the
pr_len field to the correct value for the current RVU. The value of the pr_len field should not be
modified after being set by #define DEFAULT_PROCESS_EXTENSION_RESULTS.
The process_extension_results output structure is described in the
process_extension_results(5) reference page.
RETURN VALUES
If the tdm_execvep() function returns to the calling process image, an error has occurred; the
return value is -1, and errno is set to indicate the error. If the pr_results parameter does not con-
tain a null pointer, the structure it points to returns additional error information, including the
PROCESS_LAUNCH_ error and error detail.
ERRORS
If any of the following conditions occurs, the tdm_execvep() function sets errno to the
corresponding value, file descriptors marked close-on-exec are not closed, signals set to be
caught are not set to the default action, and none of these are changed:
• The argv[] array of pointers
• The envp[] array of pointers
• The elements pointed to by these arrays
• The value of the global variable environ
• The pointers contained within the global variable environ
• The elements pointed to by environ pointers
• The effective user ID of the current process
• The effective group ID of the current process
[E2BIG] The number of bytes used by the new process image’s argument list and environ-
ment list is greater than the system-imposed limit. The limit can be obtained by
calling the sysconf(_SC_ARG_MAX) function.
[EACCES] One of these conditions exists:
• Search permission is denied for the directory components of the path-
name prefix to the process image file.
527186-003 Hewlett-Packard Company 8−27