Standard C Library Functions         posix_spawnattr_getflags(3C)


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 refer-
     enced 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
       POSIX_SPAWN_NOSIGCHLD_NP
       POSIX_SPAWN_WAITPID_NP



     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 indi-
     cate 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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-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)