Open System Services Porting Guide (G06.29+, H06.06+, J06.03+)

regular files, sockets, FIFOs, and OSSTTY (terminal process must be
running on a system running G06.27 and later G-series RVUs, H06.06
and later H-series RVUs, or J-series RVUs).
Provides information about the set of files that are enabled for
completion. Supports Guardian files, OSS regular files, sockets, FIFOs,
FILE_COMPLETE_GETINFO_
and OSSTTY (terminal process must be running on a system running
G06.27 and later G-series RVUs, H06.06 and later H-series RVUs, or
J-series RVUs).
Maps Guardian filename to OSS pathname.FILENAME_TO_PATHNAME_
Maps OSS pathname to Guardian filename.PATHNAME_TO_FILENAME_
Provides group information.GROUP_GETINFO_
Provides user information.USER_GETINFO_
Provides user information for next user.USER_GETNEXT_
The PROCESS_SPAWN_ procedure can create OSS processes from the Guardian environment,
but it can also be used from the OSS environment.
Beginning with the H06.24 and J06.13 RVUs, 64-bit OSS processes are supported and can be
created by Guardian processes with PROCESS_SPAWN_. For information about creating 64-bit
OSS processes with PROCESS_SPAWN_, see the 64-Bit Support in OSS and Guardian chapter
in the Open System Services Programmer's Guide.
The FILE_COMPLETE_ procedure and its companion procedures, FILE_COMPLETE_SET_ and
FILE_COMPLETE_GETINFO_, provide additional capabilities for programs that use nowait I/O.
They combine and enhance the function of the AWAITIO[X] procedures and the OSS select()
function. For example, you can use these procedures to complete nowait I/O on OSS files in
parallel with nowait I/O on Guardian files. You can define a particular set of files to be enabledfor
completion and then complete outstanding I/O operations on these files over a series of calls. For
more information about nowait I/O and the use of these procedures, see the Guardian Programmer’s
Guide.
The FILENAME_TO_PATHNAME_ and PATHNAME_TO_FILENAME_ mapping procedures facilitate
interoperability between OSS and Guardian file systems by providing the link between OSS
pathnames and Guardian filenames.
The other Guardian procedures return user and group information to the application. More
information on using these extended Guardian procedure calls is provided in “Using New and
Extended Guardian Procedures” (page 143).
Process-Creation Functions Specific to HP
A set of process-creation functions are provided to give the OSS programmer more control over
which attributes are given to a new process. The “Using Process-Creation Calls” (page 96) provides
information about when to use these process-creation functions. The HP extension process-creation
functions are:
Executes a file with HP extensionstdm_execve()
Executes a file with HP extensionstdm_execvep()
Creates a new process with HP extensionstdm_fork()
Executes a new process with HP extensionstdm_spawn()
Executes a new process with HP extensionstdm_spawnp()
Using the tdm_fork() and tdm_execve Set of Functions
The tdm_fork() function and the tdm_execve set of functions perform the same actions as
fork() and the exec set of functions with the addition that many Guardian process attributes
130 Porting UNIX Applications to the OSS Environment