Standard C Library Functions          posixspawnattrdestroy(3C)



NAME
     posixspawnattrdestroy, posixspawnattrinit - destroy  and
     initialize spawn attributes object

SYNOPSIS
     #include 

     int posixspawnattrdestroy(posixspawnattrt *attr);


     int posixspawnattrinit(posixspawnattrt *attr);


DESCRIPTION
     The  posixspawnattrdestroy()  function  destroys  a  spawn
     attributes object. A destroyed attr attributes object can be
     reinitialized using posixspawnattrinit(). The  results  of
     otherwise referencing the object after it has been destroyed
     are    undefined.    An     implementation     can     cause
     posixspawnattrdestroy()  to  set  the object referenced by
     attr to an invalid value.


     The  posixspawnattrinit()  function  initializes  a  spawn
     attributes object attr with the default value for all of the
     individual attributes used by  the  implementation.  Results
     are undefined if posixspawnattrinit() is called specifying
     an already initialized attr attributes object.


     A spawn  attributes  object  is  of  type  posixspawnattrt
     (defined  in  )  and is used to specify the inheri-
     tance of process attributes across a spawn operation.


     No attributes other than those defined by IE  Std  1003.1-
     200x are provided.


     The resulting spawn attributes object (possibly modified  by
     setting  individual attribute values), is used to modify the
     behavior of posixspawn(3C)  or  posixspawnp(3C).  After  a
     spawn  attributes object has been used to spawn a process by
     a call to  posixspawn()  or  posixspawnp(),  any  function
     affecting the attributes object (including destruction) will
     not affect any process that has been spawned in this way.

RETURN VALUES
     Upon successful  completion,  posixspawnattrdestroy()  and
     posixspawnattrinit()  return 0. Otherwise, an error number
     is returned to indicate the error.




SunOS 5.11          Last change: 30 Jan 2004                    1






Standard C Library Functions          posixspawnattrdestroy(3C)



ERORS
     The posixspawnattrinit() function will fail if:

     ENOMEM    Insufficient memory exists to initialize the spawn
               attributes object.



     The posixspawnattrdestroy() function may fail if:

     EINVAL    The value specified by attr is invalid.


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),               posixspawnattrgetflags(3C),
     posixspawnattrgetpgroup(3C),
     posixspawnattrgetschedparam(3C),
     posixspawnattrgetschedpolicy(3C),
     posixspawnattrgetsigdefault(3C),
     posixspawnattrgetsigmask(3C), attributes(5), standards(5)




















SunOS 5.11          Last change: 30 Jan 2004                    2