Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

execv(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 execv() 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 argv[]array of pointers
• The elements pointed to by this array
• 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.
[EIO] Some physical input or output error has occurred. Either a file cannot be opened
because of an input or output error, or data has been lost during an input or out-
put transfer. This value is used for errors on the object file of a loaded program
or library, or during data transfer with a Guardian environment home terminal.
For systems running J06.07 and later J-series RVUs or H06.18 or later H-series
RVUs, this error can also occur when the OSS file system is out of memory and
one or more open files cannot be propagated from the parent process to the child
process. In this case, if you are running a program from the shell with the shell
reporting any errors, you might see an error like this:
/bin/-sh: /bin/ps: tdm_execve(): failed with unexpected error pr_errno=(4005)
pr_TPCerror=(110) pr_TPCdetail=(36)
where:
2−32 Hewlett-Packard Company 527186-023