ИМЯ¶

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).

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

Данные функции являются не стандартизированными расширениями 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)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта 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.