Content-type: text/html Man page of posix_spawnattr_getflags

posix_spawnattr_getflags

Section: Standard C Library Functions (3C)
Updated: 30 Jan 2004
Index Return to Main Contents
 

NAME

posix_spawnattr_getflags, posix_spawnattr_setflags - get and set spawn-flags attribute of spawn attributes object  

SYNOPSIS

#include <spawn.h>

int posix_spawnattr_getflags(const posix_spawnattr_t *restrict attr, short *restrict flags);

int posix_spawnattr_setflags(posix_spawnattr_t * attr, short flags);  

DESCRIPTION

The posix_spawnattr_getflags() function obtains the value of the spawn-flags attribute from the attributes object referenced by attr.

The posix_spawnattr_setflags() function sets the spawn-flags attribute in an initialized attributes object referenced by attr.

The spawn-flags attribute is used to indicate which process attributes are to be changed in the new process image when invoking posix_spawn(3C) or posix_spawnp(3C). It is the bitwise-inclusive OR of zero or more of the following flags:

POSIX_SPAWN_RESETIDS
POSIX_SPAWN_SETPGROUP
POSIX_SPAWN_SETSIGDEF
POSIX_SPAWN_SETSIGMASK
POSIX_SPAWN_SETSCHEDPARAM
POSIX_SPAWN_SETSCHEDULER

These flags are defined in <spawn.h>. The default value of this attribute is as if no flags were set.  

RETURN VALUES

Upon successful completion, posix_spawnattr_getflags() returns 0 and stores the value of the spawn-flags attribute of attr into the object referenced by the flags parameter. Otherwise, an error number is returned to indicate the error.

Upon successful completion, posix_spawnattr_setflags() returns 0. Otherwise, an error number is returned to indicate the error.  

ERRORS

These functions may fail if:

EINVAL The value specified by attr is invalid.

The posix_spawnattr_setflags() function may fail if:

EINVAL The value of the attribute being set is not valid.

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-LevelMT-Safe

 

SEE ALSO

posix_spawn(3C), posix_spawnattr_destroy(3C), posix_spawnattr_getpgroup(3C), posix_spawnattr_getschedparam(3C), posix_spawnattr_getschedpolicy(3C), posix_spawnattr_getsigdefault(3C), posix_spawnattr_getsigmask(3C), attributes(5), standards(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:18 GMT, October 02, 2010