Standard C Library Functions        posixspawnattrgetpgroup(3C)



NAME
     posixspawnattrgetpgroup, posixspawnattrsetpgroup  -  get
     and set spawn-pgroup attribute of spawn attributes object

SYNOPSIS
     #include 

     int posixspawnattrgetpgroup(const posixspawnattrt *restrict attr,
          pidt *restrict pgroup);


     int posixspawnattrsetpgroup(posixspawnattrt *attr, pidt pgroup);


DESCRIPTION
     The posixspawnattrgetpgroup() function obtains  the  value
     of  the  spawn-pgroup  attribute  from the attributes object
     referenced by attr.


     The posixspawnattrsetpgroup()  function  sets  the  spawn-
     pgroup  attribute in an initialized attributes object refer-
     enced by attr.


     The spawn-pgroup attribute represents the process  group  to
     be  joined by the new process image in a spawn operation (if
     POSIXSPAWNSETPGROUP is set in the spawn-flags  attribute).
     The default value of this attribute is zero.

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


     Upon  successful   completion,   posixspawnattrsetpgroup()
     returns  0.  Otherwise, an error number is returned to indi-
     cate the error.

ERORS
     These functions may fail if:

     EINVAL    The value specified by attr is invalid.



     The posixspawnattrsetpgroup() function may fail if:





SunOS 5.11          Last change: 30 Jan 2004                    1






Standard C Library Functions        posixspawnattrgetpgroup(3C)



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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     posixspawn(3C),              posixspawnattrgetpgroup(3C),
     posixspawnattrgetpgroup(3C),
     posixspawnattrgetschedparam(3C),
     posixspawnattrgetschedpolicy(3C),
     posixspawnattrgetsigdefault(3C),
     posixspawnattrgetsigmask(3C), attributes(5), standards(5)






























SunOS 5.11          Last change: 30 Jan 2004                    2