pthread_attr_setscope(3) [mojave man page]
PTHREAD_ATTR(3) BSD Library Functions Manual PTHREAD_ATTR(3) NAME
pthread_attr_getscope, pthread_attr_setscope -- thread attribute operations SYNOPSIS
#include <pthread.h> int pthread_attr_getscope(const pthread_attr_t *restrict attr, int *restrict contentionscope); int pthread_attr_setscope(pthread_attr_t *attr, int contentionscope); DESCRIPTION
Thread attributes are used to specify parameters to pthread_create(). One attribute object can be used in multiple calls to pthread_create(), with or without modifications between calls. The pthread_attr_setscope() and pthread_attr_getscope() functions, respectively, set and get the attribute within attr argument that controls the contention scope of the thread. The acceptable values are PTHREAD_SCOPE_SYSTEM, indicating a scheduling contention scope that is system- wide, and PTHREAD_SCOPE_PROCESS, which indicates a process scheduling contention scope. Currently on Mac OS X we only support PTHREAD_SCOPE_SYSTEM. RETURN VALUES
If successful, these functions return 0. Otherwise, an error number is returned to indicate the error. ERRORS
pthread_attr_getscope() will fail if: [EINVAL] Invalid value for attr. pthread_attr_setscope() will fail if: [EINVAL] Invalid value for attr. [ENOTSUP] Invalid or unsupported value for contentionscope. SEE ALSO
pthread_create(3), pthread_attr_init(3), pthread_attr_setinheritsched(3), pthread_attr_setschedpolicy(3), pthread_attr_setschedparam(3) STANDARDS
pthread_attr_setscope(), pthread_attr_getscope() conform to Version 2 of the Single UNIX Specification (``SUSv2'') BSD
December 31, 2007 BSD
Check Out this Related Man Page
pthread_attr_getscope(3C) Standard C Library Functions pthread_attr_getscope(3C) NAME
pthread_attr_getscope, pthread_attr_setscope - get or set contentionscope attribute SYNOPSIS
cc -mt [ flag... ] file... -lpthread [ library... ] #include <pthread.h> int pthread_attr_getscope(const pthread_attr_t *restrict attr, int *restrict contentionscope); int pthread_attr_setscope(pthread_attr_t *attr, int contentionscope); DESCRIPTION
The pthread_attr_setscope() and pthread_attr_getscope() functions are used to set and get the contentionscope attribute in the attr object. The contentionscope attribute can have the value PTHREAD_SCOPE_SYSTEM, signifying system scheduling contention scope, or PTHREAD_SCOPE_PROCESS, signifying process scheduling contention scope. The symbols PTHREAD_SCOPE_SYSTEM and PTHREAD_SCOPE_PROCESS are defined by the header <pthread.h>. RETURN VALUES
If successful, the pthread_attr_setscope() and pthread_attr_getscope() functions return 0. Otherwise, an error number is returned to indi- cate the error. ERRORS
The pthread_attr_setscope(), or pthread_attr_getscope(), function may fail if: EINVAL attr or contentionscope is invalid. USAGE
After these attributes have been set, a thread can be created with the specified attributes using pthread_create(). Using these routines does not affect the current running thread. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
pthread_attr_init(3C), pthread_attr_setinheritsched(3C), pthread_attr_setschedpolicy(3C), pthread_attr_setschedparam(3C), pthread_cre- ate(3C), pthread_setschedparam(3C), attributes(5), standards(5) SunOS 5.11 23 Mar 2005 pthread_attr_getscope(3C)