Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-169
PROCESS_SPAWN_ Procedure
oss-program-file input
STRING .EXT:ref:*
specifies the null-terminated OSS pathname of the OSS program file to be run. If
the pathname is an absolute pathname, it is resolved relative to the root of the
caller. If the pathname is a relative pathname, it is resolved with respect to the
caller’s current working directory. If the pathname is the program name, the path
provided in the
path parameter is searched for the program file.
Shell scripts that exist on nodes other than the caller’s node (remote shell scripts)
cannot be spawned (see “Considerations for Resolving File Names” for more
information). Shell scripts that exist on the caller’s node (local shell scripts) are
supported, but security is ignored if an interpreter that exists on another node is
used. A shell script must contain the following string syntax in the first line of the
file when the
path parameter is not specified:
#! interpreter-name optional-arguments
If the Guardian caller does not already have a current working directory,
PROCESS_SPAWN_ attempts to establish the caller’s default subvolume as the
current working directory.
Refer to Appendix D, File Names and Process Identifiers
for a description of OSS
pathname syntax.
fdinfo input
STRING .EXT:ref:(ZSYS^DDL^FDINFO)
specifies the file creation mask, current working directory, and file descriptors to be
opened or duplicated by the new process. This parameter also allows the caller to
limit the time allowed for the child process to open all of its files. If the pathnames
are absolute pathnames, they are resolved relative to the child’s root. If the
pathnames are relative pathnames, they are resolved relative to the child’s current
working directory. For information on how to assign field values to the structure,
see “Structure Definition for
fdinfo.”
argv input
EXTADDR .EXT:ref:1
if present and not equal to 0D, specifies the address of an array of addresses that
point to null-terminated strings containing arguments to be passed to the main
function of the new process. The last member of this array must be a null pointer
(0D). Most programs expect
argv[0] to point to a null-terminated string containing
the pathname of the OSS program file (use the address of the
oss-program-
file parameter). The argument (argv) string is passed to the child unmodified by
PROCESS_SPAWN_.
The number of bytes available for the new process’s combined argument (
argv)
and environment (
envp) lists has a system-imposed limit. This limit, which