Scroll to navigation

PTHREAD_SETCONCURRENCY(3) Руководство программиста Linux 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() может завершиться со следующей ошибкой:

Значение 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)

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан 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 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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

15 сентября 2017 г. Linux