Linux repositories inspector

pthread_getattr_default_np(3) - Russkiy

Linux
2019-03-06
Aliases: pthread_setattr_default_np(3), pthread_setattr_default_np(3), pthread_setattr_default_np(3)

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

pthread_getattr_default_np, pthread_setattr_default_np - возврат или изменение атрибутов создания нити по умолчанию

ОБЗОР

#define _GNU_SOURCE             /* Смотрите feature_test_macros(7) */
#include <pthread.h>

int pthread_getattr_default_np(pthread_attr_t *attr); int pthread_setattr_default_np(pthread_attr_t *attr);
Компилируется и компонуется вместе с -pthread.

ОПИСАНИЕ

Функция pthread_setattr_default_np() изменяет атрибуты по умолчанию, используемые при создании новой нити — то есть атрибуты, которые используются при вызове pthread_create(3) со вторым аргументом, равным NULL. Атрибуты по умолчанию изменяются в соответствии с атрибутами, переданными в *attr — объекте атрибутов нити, инициализированном ранее. Вот, что нужно знать об объекте атрибутов:
* Значения атрибутов в объекте должны быть корректными.
* Атрибут stack address не должен быть указан в объекте.
* Значение нуля в stack size означает, что размер стека по умолчанию остаётся без изменения.
Функция pthread_getattr_default_np() инициализирует объект атрибутов нити, на который указывает attr, так, что он содержит значения атрибутов по умолчанию, использованные при создании нити.

ОШИБКИ

EINVAL (pthread_setattr_default_np()) Одно из значений атрибутов в attr неверно или в attr изменён атрибут адреса стека.
ENOMEM (pthread_setattr_default_np()) Недостаточно памяти.

ВЕРСИИ

Эти функции доступны в glibc начиная с версии 2.18.

АТРИБУТЫ

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

СООТВЕТСТВИЕ СТАНДАРТАМ

Данные функции являются не стандартизированными расширениями GNU, о чём свидетельствует наличие суффикса «_np» (nonportable).

ПРИМЕР

В программе, показанной далее, используется pthread_getattr_default_np() для получения атрибутов создания нити по умолчанию, а затем выводятся различные параметры полученного объекта. Вывод работы программы:
$ ./a.out Размер стека: 8388608 Размер защиты: 4096 Алгоритм планирования: SCHED_OTHER Приоритет планирования: 0 Состояние отсоединения: JOINABLE Наследование планировщика: INHERIT

Исходный код программы

#define _GNU_SOURCE #include <pthread.h> #include <stdio.h> #include <stdlib.h> #include <errno.h>
#define errExitEN(en, msg) \
do { errno = en; perror(msg); \
exit(EXIT_FAILURE); } while (0)
static void display_pthread_attr(pthread_attr_t *attr) {
int s;
size_t stacksize;
size_t guardsize;
int policy;
struct sched_param schedparam;
int detachstate;
int inheritsched;
s = pthread_attr_getstacksize(attr, &stacksize);
if (s != 0)
errExitEN(s, "pthread_attr_getstacksize");
printf("Размер стека: %zd\n", stacksize);
s = pthread_attr_getguardsize(attr, &guardsize);
if (s != 0)
errExitEN(s, "pthread_attr_getguardsize");
printf("Размер защиты: %zd\n", guardsize);
s = pthread_attr_getschedpolicy(attr, &policy);
if (s != 0)
errExitEN(s, "pthread_attr_getschedpolicy");
printf("Алгоритм планирования: %s\n",
(policy == SCHED_FIFO) ? "SCHED_FIFO" :
(policy == SCHED_RR) ? "SCHED_RR" :
(policy == SCHED_OTHER) ? "SCHED_OTHER" : "[неизвестно]");
s = pthread_attr_getschedparam(attr, &schedparam);
if (s != 0)
errExitEN(s, "pthread_attr_getschedparam");
printf("Приоритет планирования: %d\n", schedparam.sched_priority);
s = pthread_attr_getdetachstate(attr, &detachstate);
if (s != 0)
errExitEN(s, "pthread_attr_getdetachstate");
printf("Состояние отсоединения: %s\n",
(detachstate == PTHREAD_CREATE_DETACHED) ? "DETACHED" :
(detachstate == PTHREAD_CREATE_JOINABLE) ? "JOINABLE" :
"???");
s = pthread_attr_getinheritsched(attr, &inheritsched);
if (s != 0)
errExitEN(s, "pthread_attr_getinheritsched");
printf("Наследование планировщика: %s\n",
(inheritsched == PTHREAD_INHERIT_SCHED) ? "INHERIT" :
(inheritsched == PTHREAD_EXPLICIT_SCHED) ? "EXPLICIT" :
"???"); }
int main(int argc, char *argv[]) {
int s;
pthread_attr_t attr;
s = pthread_getattr_default_np(&attr);
if (s != 0)
errExitEN(s, "pthread_getattr_default_np");
display_pthread_attr(&attr);
exit(EXIT_SUCCESS); }
⇧ Top