PTHREAD_ATTR_GETSCOPE(3C) Standard C Library Functions
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 indicate
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(7) 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_setschedparam(3C),
pthread_attr_setschedpolicy(3C),
pthread_create(3C),
pthread_setschedparam(3C),
attributes(7),
standards(7) March 23, 2005
PTHREAD_ATTR_GETSCOPE(3C)