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

execlp(2) OSS System Calls Reference Manual
• The creator access ID (CAID) is set to the process access ID (PAID) of the calling pro-
cess.
• The PAID depends on whether the S_ISUID mode bit of the image file is set. If so, the
PAID is based on the file owner ID. If not, the PAID is the same as for the caller. (The
S_ISUID mode bit of the image file has no effect on the security group list.)
• The MOM field for the new process depends on whether the calling process is named. If
so, the MOM field for the new process is set to the caller’s ANCESTOR field. Other-
wise, the MOM field for the new process is set to the caller’s MOM field.
• System debugger selection for the new process is based on Inspect mode.
• Code breakpoints and memory breakpoints are not inherited.
For detailed information about Guardian process attributes, see the PROCESS_LAUNCH_ pro-
cedure in the Guardian Procedure Calls Reference Manual.
Use From the Guardian Environment
If called from a Guardian process, the function call fails and errno is set to [ENOTOSS].
RETURN VALUES
If the execlp() function returns to the calling process image, an error has occurred; the return
value is -1, and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the function sets errno to the corresponding value. For
any of these error conditions, file descriptors marked close-on-exec are not closed, signals set to
be caught are not set to the default action, and none of the following are changed:
• 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 the following conditions exists:
• Search permission is denied for the directory components of the path-
name prefix to the process image file.
• The new process image file, any library file, or script file denies execu-
tion permission.
• The new process image file is not a regular file.
[EAGAIN] System resources such as disk space, process control block (PCB) space, MAP-
POOL space, stack space, or PFS space are temporarily inadequate.
2−24 Hewlett-Packard Company 527186-003