pthread_setconcurrency(3)

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

LIBRARY
POSIX threads library (libpthread, -lpthread)

СИНТАКСИС
#include <pthread.h>

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

ОПИСАНИЕ
Функция 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, привело бы к превышению системного ограничения»).

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

СТАНДАРТЫ
POSIX.1-2008.

ИСТОРИЯ
glibc 2.1. POSIX.1-2001.

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

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

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

СМ. ТАКЖЕ
pthread_attr_setscope(3), pthreads(7)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Alexey, Azamat Hackimov <azamat.hackimov@gmail.com>, kogamatranslator49 <r.podarov@yandex.ru>, Kogan, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.