Standard C Library Functions
posixspawnfileactionsaddclose(3C)
NAME
posixspawnfileactionsaddclose,
posixspawnfileactionsaddopen - add close or open action
to spawn file actions object
SYNOPSIS
#include
int posixspawnfileactionsaddclose(
posixspawnfileactionst *fileactions, int fildes);
int posixspawnfileactionsaddopen(
posixspawnfileactionst *restrict fileactions, int fildes,
const char *restrict path, int oflag, modet mode);
DESCRIPTION
These functions add or delete a close or open action to a
spawn file actions object.
A spawn file actions object is of type
posixspawnfileactionst (defined in ) and is
used to specify a series of actions to be performed by a
posixspawn(3C) or posixspawn(3C) operation to arrive at
the set of open file descriptors for the child process given
the set of open file descriptors of the parent.
A spawn file actions object, when passed to posixspawn() or
posixspawnp(), specifies how the set of open file descrip-
tors in the calling process is transformed into a set of
potentially open file descriptors for the spawned process.
This transformation occurs as though the specified sequence
of actions was performed exactly once, in the context of the
spawned process (prior to execution of the new process
image), in the order in which the actions were added to the
object. Additionally, when the new process image is exe-
cuted, any file descriptor (from this new set) which has its
FDCLOEXEC flag set is closed (see posixspawn(3C)).
The posixspawnfileactionsaddclose() function adds a
close action to the object referenced by fileactions that
causes the file descriptor fildes to be closed (as if
close(fildes) had been called) when a new process is spawned
using this file actions object.
SunOS 5.11 Last change: 20 Feb 2009 1
Standard C Library Functions
posixspawnfileactionsaddclose(3C)
The posixspawnfileactionsaddopen() function adds an open
action to the object referenced by fileactions that causes
the file named by path to be opened (as if open(path, oflag,
mode) had been called, and the returned file descriptor, if
not fildes, had been changed to fildes) when a new process
is spawned using this file actions object. If fildes was
already an open file descriptor, it is closed before the new
file is opened.
The string described by path is copied by the
posixspawnfileactionsaddopen() function.
RETURN VALUES
Upon successful completion, these functions return 0. Other-
wise, an error number is returned to indicate the error.
ERORS
These functions will fail if:
EBADF The value specified by fildes is negative or
greater than or equal to {OPENMAX}.
These functions may fail if:
EINVAL The value specified by fileactions is invalid.
ENOMEM Insufficient memory exists to add to the spawn
file actions object.
It is not considered an error for the fildes argument passed
to these functions to specify a file descriptor for which
the specified operation could not be performed at the time
of the call. Any such error will be detected when the asso-
ciated file actions object is later used during a
posixspawn() or posixspawnp() operation.
If a close(2) operation is specified for a file descriptor
that is not open at the time of the call to posixspawn() or
posixspawnp(), the close operation will not cause the
posixspawn() or posixspawnp() operation to fail.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 20 Feb 2009 2
Standard C Library Functions
posixspawnfileactionsaddclose(3C)
ATRIBUTE TYPE ATRIBUTE VALUE
Interface Stability Committed
MT-Level MT-Safe
Standard See standards(5).
SEE ALSO
close(2), dup(2), open(2), posixspawn(3C),
posixspawnfileactionsadddup2(3C),
posixspawnfileactionsdestroy(3C), attributes(5), stan-
dards(5)
SunOS 5.11 Last change: 20 Feb 2009 3
Standard C Library Functions
posixspawnfileactionsaddclose(3C)
SunOS 5.11 Last change: 20 Feb 2009 4
|
