ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



POSIX_SPAWNATTR_SETPG... BSD Library Functions Manual POSIX_SPAWNATTR_SETPG...

NAME
     posix_spawnattr_setpgroup posix_spawnattr_getpgroup -- set or get the spawn-pgroup attribute on a
     posix_spawnattr_t

SYNOPSIS
     #include <spawn.h>

     int
     posix_spawnattr_setpgroup(posix_spawnattr_t *attr, pid_t pgroup);

     int
     posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict attr, pid_t *restrict pgroup);

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

     The posix_spawnattr_getpgroup() 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
     POSIX_SPAWN_SETPGROUP flag is set in the posix_spawnattr_t via a call to posix_spawnattr_setflags(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 <errno.h>.  Addition-ally, Additionally,
     ally, if successful, posix_spawnattr_getpgroup() will modify the contents of the pgroup parameter with
     the current attribute value.

ERRORS
     These functions may fail if:

     [EINVAL]           The value specified by attr is invalid.

     [EINVAL]           The value of attr is invalid.

SEE ALSO
     posix_spawn(2), posix_spawnp(2), posix_spawnattr_init(3), posix_spawnattr_destroy(3),
     posix_spawnattr_setflags(3)

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

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

Mac OS X                        August 22, 2007                       Mac OS X

Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.