PTHREAD_GETATTR_DEFAULT_NP(3)

ИМЯ
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);
    }

СМОТРИТЕ ТАКЖЕ
pthread_attr_getaffinity_np(3), pthread_attr_getdetachstate(3), pthread_attr_getguardsize(3), pthread_attr_getinheritsched(3), pthread_attr_getschedparam(3), pthread_attr_getschedpolicy(3), pthread_attr_getscope(3), pthread_attr_getstack(3), pthread_attr_getstackaddr(3), pthread_attr_getstacksize(3), pthread_attr_init(3), pthread_create(3), pthreads(7)