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

execl(2) OSS System 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 execl() 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.
[EFAULT] An input address parameter is outside valid bounds limits.
[EINVAL] The new process image file is a binary executable file with invalid attributes.
[ELOOP] Too many symbolic links were encountered in pathname resolution.
[EMFILE] The maximum number of files is open. The process attempted to open more than
the maximum number of file descriptors allowed for the process. The process
file segment (PFS) of the new process might be smaller than that of the calling
process.
[ENAMETOOLONG]
One of the following is too long:
• The pathname pointed to by the path parameter
• A component of the pathname pointed to by the path parameter
2−8 Hewlett-Packard Company 527186-003