Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(PROCESS_SPAWN_)>
__int32_t PROCESS_SPAWN_ ( char _ptr32 *oss-program-file
,[ void _ptr32 *fdinfo ]
,[ char _ptr32 *argv ]
,[ char _ptr32 *envp ]
,[ void _ptr32 *inheritance ]
,[ __int32_t inheritance-length ]
,[ void _ptr32 *process-extension ]
,[ void _ptr32 *process-results ]
,[ __int32_t nowait-tag ]
,[ char _ptr32 *path ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
oss-pid:= PROCESS_SPAWN_ ( oss-program-file ! i
,[ fdinfo ] ! i
,[ argv ] ! i
,[ envp ] ! i
,[ inheritance ] ! i
,[ inheritance-length ] ! i
,[ process-extension ] ! i
,[ process-results ] ! i:o
,[ nowait-tag ] ! i
,[ path ] ); ! i
Parameters
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 (for more information, see Considerations for Resolving File Names (page 1116)). 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 this 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.
For a description of OSS pathname syntax, see Appendix D: File Names and Process Identifiers.
PROCESS_SPAWN_ Procedure 1097