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

tdm_fork(2) OSS System Calls Reference Manual
If the tdm_fork( ) function fails, the value -1 is returned to the parent process, no child process is
created, and errno is set to indicate the error. If pr_results does not contain a null pointer, it
returns additional error information including the PROCESS_LAUNCH_ procedure error and
error detail.
ERRORS
If any of the following conditions occurs, the tdm_fork( ) function sets errno to the correspond-
ing value:
[EACCES] Open for execute access on the code file or any library file was denied.
[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 address for a parameter in the process_extension structture pointed to by
pe_parms is out of allowable bounds. The Guardian PROCESS_LAUNCH_
procedure error and error detail information is returned in the structure pointed to
by the pr_results parameter, unless pr_results contains a null pointer.
[EHLDSEM] The process tried to create a child process in a different processor while having
at least one semadj value.
[EINVAL] An invalid parameter value was supplied in the process_extension structure
pointed to by pe_parms. The Guardian PROCESS_LAUNCH_ error and error
detail information is returned in the structure pointed to by the pr_results param-
eter, unless pr_results contains a null pointer.
[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 output
transfer. This value is used only for errors on the object file of a loaded program
or library, or during data transfer with a Guardian environment home terminal.
[ENOMEM] Required resources are not available. Subsequent calls to the same function will
not succeed for the same reason.
Possible causes of this error include insufficient primary memory (stack, globals,
or heap) for the child process.
[ENOTOSS] The parent process is not an OSS process. The tdm_fork( ) function cannot be
used from the Guardian environment.
[EUNKNOWN]
Unknown error. An unrecognized or very obscure error occurred. If this error
occurs, follow site-defined procedures for reporting software problems to
HP.
RELATED INFORMATION
Functions: exec(2), _exit(2), fork(2), raise(3), semget(2), semop(2), shmat(2), sigaction(2),
tdm_execve(2), tdm_execvep(2), tdm_spawn(2), tdm_spawnp(2), times(3), ulimit(2),
umask(2), wait(2).
Miscellaneous: process_extension_results(5).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification.
8−42 Hewlett-Packard Company 527186-023