Mac Developer Library Developer
Search

 

This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




POSIX_SPAWNATTR_INIT(3)  BSD Library Functions Manual  POSIX_SPAWNATTR_INIT(3)

NAME
     posix_spawnattr_init posix_spawnattr_destroy -- initialize or destroy a spawn attributes object

SYNOPSIS
     #include <spawn.h>

     int
     posix_spawnattr_init(posix_spawnattr_t *attr);

     int
     posix_spawnattr_destroy(posix_spawnattr_t *attr);

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

     A posix_spawnattr_t object is an opaque type that is used to collect set of spawn attributes specified
     by calls to posix_spawnattr_setflags(3), posix_spawnattr_setpgroup(3),
     posix_spawnattr_setsigdefault(3), posix_spawnattr_setsigmask(3), posix_spawnattr_setbinpref_np(3),
     posix_spawnattr_setspecialport_np(3), or posix_spawnattr_setexceptionports_np(3) such that once the
     spawn operation 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 order-ing. ordering.
     ing.

     The posix_spawnattr_destroy() function destroys the object referenced by attr which was previously
     intialized by posix_spawnattr_init(), returning any resources obtained at the time of initialization to
     the system for subsequent reuse.  A posix_spawnattr_t 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 <errno.h>.

ERRORS
     The posix_spawnattr_init() and posix_spawnattr_destroy() functions will fail and return an error if:

     [ENOMEM]           Insufficient resources to initialize the posix_spawnattr_t object.

     [EINVAL]           The posix_spawnattr_t being destroyed is invalid.

SEE ALSO
     posix_spawn(2), posix_spawnp(2), posix_spawnattr_setflags(3), posix_spawnattr_setpgroup(3),
     posix_spawnattr_setsigdefault(3), posix_spawnattr_setsigmask(3), posix_spawnattr_setbinpref_np(3),
     posix_spawnattr_setspecialport_np(3), posix_spawnattr_setexceptionports_np(3)

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

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

Mac OS X                        August 22, 2007                       Mac OS X

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback