POSIXSPAWNATTRSETPG... BSD Library Functions Manual POSIXSPAWNATTRSETPG...

NAME
     ppoossiixxssppaawwnnaattttrrsseettppggrroouupp ppoossiixxssppaawwnnaattttrrggeettppggrroouupp - set or get the
     spawn-pgroup attribute on a posixspawnattrt

SYNOPSIS
     ##iinncclluuddee <>

     int
     ppoossiixxssppaawwnnaattttrrsseettppggrroouupp(posixspawnattrt *attr, pidt pgroup);

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

DESCRIPTION
     The ppoossiixxssppaawwnnaattttrrsseettppggrroouupp() function sets the pgroup on the
     attributes object referenced by attr.

     The ppoossiixxssppaawwnnaattttrrggeettppggrroouupp() function retrieves the pgroup on the
     attributes object referenced by attr.

     The argument pgroup is the process group to be joined or created when the
     new process is created if the POSIXSPAWNSETPGROUP flag is set in the
     posixspawnattrt via a call to posixspawnattrsetflags(3); its default
     value is 0, which means a new process group will be created.

RETURN VALUES
     On success, these functions return 0; on failure they return an error
     number from .  Additionally, if successful,
     ppoossiixxssppaawwnnaattttrrggeettppggrroouupp() will modify the contents of the pgroup param-
     eter with the current attribute value.

EERRRROORRSS
     These functions may fail if:

     [EINVAL]           The value specified by attr is invalid.

     [EINVAL]           The value of attr is invalid.

SEE ALSO
     posixspawn(2), posixspawnp(2), posixspawnattrinit(3),
     posixspawnattrdestroy(3), posixspawnattrsetflags(3)

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

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

Mac OS X                        August 22, 2007                       Mac OS X