Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pthread_attr_setscope(3) [netbsd man page]

PTHREAD_ATTR_GETSCOPE(3)				   BSD Library Functions Manual 				  PTHREAD_ATTR_GETSCOPE(3)

NAME
pthread_attr_getscope -- get and set the contention scope attribute LIBRARY
POSIX Threads Library (libpthread, -lpthread) 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
The pthread_attr_getscope() and pthread_attr_setscope() functions get and set, respectively, the contention scope attribute in the attr object. The contentionscope parameter specifies the scheduling contention scope of a thread. It is only possible to set the scope of a thread before the thread is created. There are two possible contention scopes: PTHREAD_SCOPE_SYSTEM The thread will contend for CPU resources with all other processes and threads in the system. Generally this means that the user thread is bound directly to the kernel scheduling for its entire lifetime. PTHREAD_SCOPE_PROCESS The thread will contend with other threads with the same scope attribute. In general, this means that all PTHREAD_SCOPE_PROCESS threads are grouped together and this group of threads contends for CPU resources. This is commonly seen to require a hybrid (``M:N'') threading model in order to multiplex the user and kernel space schedul- ing. Only PTHREAD_SCOPE_SYSTEM is supported in NetBSD. RETURN VALUES
Upon successful completion, both functions return 0. Otherwise an error number is returned to indicate the error. ERRORS
No errors are defined for pthread_attr_getscope(). The pthread_attr_setscope() function shall fail if: [EINVAL] Invalid parameter. SEE ALSO
pthread_attr(3), csf(9) STANDARDS
Both functions conform to ISO/IEC 9945-1:1996 (``POSIX.1''). BSD
July 7, 2010 BSD

Check Out this Related 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
Man Page