posix_spawnattr_getbinpref_np(3) [mojave man page]

POSIX_SPAWNATTR_SETBINPREF_NP(3)			   BSD Library Functions Manual 			  POSIX_SPAWNATTR_SETBINPREF_NP(3)

NAME

     posix_spawnattr_setbinpref_np posix_spawnattr_getbinpref_np -- set or get the spawn-binpref attribute on a posix_spawnattr_t

SYNOPSIS

     #include <spawn.h>

     int
     posix_spawnattr_setbinpref_np(posix_spawnattr_t *restrict attr, size_t count, cpu_type_t *pref, size_t *restrict ocount);

     int
     posix_spawnattr_getbinpref_np(const posix_spawnattr_t *restrict attr, size_t count, cpu_type_t *pref, size_t * restrict ocount);

IMPORTANT

     These functions represent an Apple extension to posix_spawn(2) and posix_spawnp(2), and as such should not be used by programs intending
     their code to be portable to other platforms.

DESCRIPTION

     The posix_spawnattr_setbinpref_np() function sets the universal binary preferences for the spawn attribute value referenced by attr from the
     memory containing the cpu_type_t referenced by pref with a size of count elements; the actual number of elements that are set in the
     attribute is returned in ocount.

     When spawn(2) or spawnp(2) is subsequently invoked on a Universal binary with the posix_spawnattr_t, the elements which were set will be
     used, in the order they were set, to select the first element in the list which matches any cpu_type_t of those available in the Universal
     binary.  If there is no match, then the attempt to create the child process will fail with the error EBADARCH.  If the cpu_type_t
     CPU_TYPE_ANY is the last element in the list, then rather than returning EBADARCH on no match, the system will instead fall back to the stan-
     dard Universal binary grading preference order.

     The posix_spawnattr_getbinpref_np() function gets the universal binary preferences for the spawn attribute value referenced by attr into the
     memory containing the cpu_type_t referenced by pref with a prereserved size of count elements; the actual number of elements that are copied
     from the attribute is returned in ocount.

RETURN VALUES

     On success, these functions return 0; on failure they return an error number from <errno.h> and modify the value of ocount.  Additionally, if
     successful, posix_spawnattr_getbinpref_np() will modify the contents of the pref array with the current attribute values.

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

     Nonstandard

HISTORY

     The posix_spawnattr_setbinpref_np() and posix_spawnattr_getbinpref_np() function calls appeared in Mac OS X.

Mac OS X							  August 22, 2007							  Mac OS X

Check Out this Related Man Page

posix_spawnattr_getflags(3C)				   Standard C Library Functions 			      posix_spawnattr_getflags(3C)

NAME

       posix_spawnattr_getflags, posix_spawnattr_setflags - get and set spawn-flags attribute of spawn attributes object

SYNOPSIS

       #include <spawn.h>

       int posix_spawnattr_getflags(const posix_spawnattr_t *restrict attr, short *restrict flags);

       int posix_spawnattr_setflags(posix_spawnattr_t * attr, short flags);

DESCRIPTION

       The posix_spawnattr_getflags() function obtains the value of the spawn-flags attribute from the attributes object referenced by attr.

       The posix_spawnattr_setflags() function sets the spawn-flags attribute in an initialized attributes object referenced by attr.

       The  spawn-flags  attribute  is	used  to  indicate  which  process  attributes	are  to  be changed in the new process image when invoking
       posix_spawn(3C) or posix_spawnp(3C). It is the bitwise-inclusive OR of zero or more of the following flags:

       POSIX_SPAWN_RESETIDS
       POSIX_SPAWN_SETPGROUP
       POSIX_SPAWN_SETSIGDEF
       POSIX_SPAWN_SETSIGMASK
       POSIX_SPAWN_SETSCHEDPARAM
       POSIX_SPAWN_SETSCHEDULER

       These flags are defined in <spawn.h>. The default value of this attribute is as if no flags were set.

RETURN VALUES

       Upon successful completion, posix_spawnattr_getflags() returns 0 and stores the value of the spawn-flags attribute of attr into the  object
       referenced by the flags parameter. Otherwise, an error number is returned to indicate the error.

       Upon successful completion, posix_spawnattr_setflags() returns 0. Otherwise, an error number is returned to indicate the error.

ERRORS

       These functions may fail if:

       EINVAL	       The value specified by attr is invalid.

       The posix_spawnattr_setflags() function may fail if:

       EINVAL	       The value of the attribute being set is not valid.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       posix_spawn(3C),  posix_spawnattr_destroy(3C),  posix_spawnattr_getpgroup(3C), posix_spawnattr_getschedparam(3C), posix_spawnattr_getsched-
       policy(3C), posix_spawnattr_getsigdefault(3C), posix_spawnattr_getsigmask(3C), attributes(5), standards(5)

SunOS 5.10							    30 Jan 2004 				      posix_spawnattr_getflags(3C)

Linux and UNIX Man Pages

posix_spawnattr_getbinpref_np(3) [mojave man page]

Check Out this Related Man Page