PTHREAD_SETCONCURRENCY(3)

ИМЯ
pthread_setconcurrency, pthread_getconcurrency - изменяет/возвращает уровень распараллеливания

ОБЗОР
#include <pthread.h>

int pthread_setconcurrency(int new_level);
int pthread_getconcurrency(void);

Компилируется и компонуется вместе с -pthread.

ОПИСАНИЕ
Функция pthread_setconcurrency() информирует реализацию приложения о желаемом уровне распараллеливания (concurrency level), задаваемом в new_level. Реализация принимает это только как рекомендацию: в POSIX.1 не указан уровень распараллеливания, который должен получиться в результате вызова pthread_setconcurrency().

Значение new_level равное 0 указывает реализации использовать уровень распараллеливания по своему усмотрению.

Функция pthread_getconcurrency() возвращает текущее значение уровня распараллеливания для этого процесса.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении pthread_setconcurrency() возвращается 0; при ошибке возвращается ненулевой номер ошибки.

Функция pthread_getconcurrency() всегда завершается успешно, возвращая уровень распараллеливания, заданный предыдущим вызовом pthread_setconcurrency(), или 0, если функция pthread_setconcurrency() не вызывалась.

ОШИБКИ
Функция pthread_setconcurrency() может завершиться со следующей ошибкой:

EINVAL
    Значение new_level отрицательно.

В POSIX.1 также описана ошибка EAGAIN («значение, указанное в new_level, привело бы к превышению системного ограничения»).

ВЕРСИИ
Эти функции доступны в glibc начиная с версии 2.1.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
pthread_setconcurrency(), pthread_getconcurrency() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ
Значение уровня распараллеливания по умолчанию равно 0.

Уровни распараллеливания имеют смысл только в реализациях нитей M:N, где в любой момент времени поднабор из набора пользовательских нитей процесса может быть ограничен меньшим количеством единиц планирования ядра. Назначение уровня распараллеливания позволяет приложению дать системе подсказку о количестве единиц планирования ядра для эффективного выполнения приложения.

В реализациях нитей LinuxThreads и NPTL используется отношение 1:1, поэтому назначение уровня распараллеливания не имеет смысла. Другими словами, в Linux эти функции существуют только лишь для совместимости с другими системами и никак не влияют на выполнение программы.

СМОТРИТЕ ТАКЖЕ
pthread_attr_setscope(3), pthreads(7)