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

tdm_spawnp(2) OSS System Calls Reference Manual
NAME
tdm_spawnp - Executes a new process with HP extensions
LIBRARY
G-series native OSS processes: /G/system/sysnn/zossksrl
H-series OSS processes: /G/system/zdllnnn/zosskdll
SYNOPSIS
#include <spawn.h>
#include <tdmext.h>
[ extern char **environ; ]
pid_t tdm_spawnp(
const char ∗∗file,
const int fd_count,
const int fd_map[],
const struct inheritance ∗∗inherit,
char ∗∗ const argv[],
char ∗∗ const envp[],
const struct process_extension ∗∗pe_parms,
struct process_extension_results ∗∗pr_results);
PARAMETERS
**environ Points to an array of character pointers to environment strings. The environment
strings define the OSS environment for the parent process. The environ array is
terminated by a null pointer.
file Points to a pathname that identifies the new process image file. If the pathname:
• Starts with a slash ( / ) character; it is the absolute pathname.
• Does not start with a slash but does contain a slash; the pathname
resolves relative to the current working directory.
• Contains no slash, the system searches the directories listed in the PATH
environment variable for the file and prefixes the directory in which the
file is found.
fd_count Specifies the number of file descriptors designated by the fd_map[]parameter.
All file descriptors higher than fd_count are closed in the child process. This
parameter can take values from 0 (zero) through POSIX_OPEN_MAX.
fd_map[] Maps file descriptors from the parent process to the child process. File descrip-
tors identified with the value SPAWN_FDCLOSED are closed in the child pro-
cess.
If this parameter is a null pointer, all open OSS file descriptors of the parent pro-
cess (except for files opened by Guardian function or procedure calls and those
with the FD_CLOEXEC attribute flag set) are inherited by the child process.
Such inherited file descriptors behave here as they do for the tdm_execvep()
function.
8−56 Hewlett-Packard Company 527186-003