pthread_attr_getscope(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

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)