POSIXSPAWNATTRINIT(3) BSD Library Functions Manual POSIXSPAWNATTRINIT(3)

NAME
     ppoossiixxssppaawwnnaattttrriinniitt ppoossiixxssppaawwnnaattttrrddeessttrrooyy - initialize or destroy a
     spawn attributes object

SYNOPSIS
     ##iinncclluuddee <>

     int
     ppoossiixxssppaawwnnaattttrriinniitt(posixspawnattrt *attr);

     int
     ppoossiixxssppaawwnnaattttrrddeessttrrooyy(posixspawnattrt *attr);

DESCRIPTION
     The ppoossiixxssppaawwnnaattttrriinniitt() function initializes the object referenced by
     attr, to an empty set of spawn attributes for subsequent use in a call to
     posixspawn(2) or posixspawnp(2).

     A posixspawnattrt object is an opaque type that is used to collect set
     of spawn attributes specified by calls to posixspawnattrsetflags(3),
     posixspawnattrsetpgroup(3), posixspawnattrsetsigdefault(3),
     posixspawnattrsetsigmask(3), posixspawnattrsetbinprefnp(3),
     posixspawnattrsetspecialportnp(3), or
     posixspawnattrsetexceptionportsnp(3) such that once the spawn opera-
     tion is complete, the child process will have a different set of
     attributes than the parent.  The order of these operations is unspecified
     and may change; programs should not depend on their ordering.

     The ppoossiixxssppaawwnnaattttrrddeessttrrooyy() function destroys the object referenced by
     attr which was previously intialized by ppoossiixxssppaawwnnaattttrriinniitt(), returning
     any resources obtained at the time of initialization to the system for
     subsequent reuse.  A posixspawnattrt may be reinitialized after having
     been destroyed, but must not be reused after destruction, unless it has
     been reinitialized.

RETURN VALUES
     On success, these functions return 0; on failure they return an error
     number from .

EERRRROORRSS
     The ppoossiixxssppaawwnnaattttrriinniitt() and ppoossiixxssppaawwnnaattttrrddeessttrrooyy() functions will
     fail and return an error if:

     [ENOMEM]           Insufficient resources to initialize the
                        posixspawnattrt object.

     [EINVAL]           The posixspawnattrt being destroyed is invalid.

SEE ALSO
     posixspawn(2), posixspawnp(2), posixspawnattrsetflags(3),
     posixspawnattrsetpgroup(3), posixspawnattrsetsigdefault(3),
     posixspawnattrsetsigmask(3), posixspawnattrsetbinprefnp(3),
     posixspawnattrsetspecialportnp(3),
     posixspawnattrsetexceptionportsnp(3)

STANDARDS     Version 3 of the Single UNIX Specification (``SUSv3'') [SPN]

HISTORY     The ppoossiixxssppaawwnn() and ppoossiixxssppaawwnnpp() function calls appeared in Version 3
     of the Single UNIX Specification (``SUSv3'') [SPN].

Mac OS X                        August 22, 2007                       Mac OS X