Provided by: manpages-ru-dev_4.27.0-1_all bug

НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Библиотека потоков POSIX (libpthread, -lpthread)

ОБЗОР

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

       int pthread_getattr_default_np(pthread_attr_t *attr);
       int pthread_setattr_default_np(const pthread_attr_t *attr);

ОПИСАНИЕ

       The pthread_setattr_default_np()  function sets the default attributes used for creation of a new thread—
       that  is,  the  attributes that are used when pthread_create(3)  is called with a second argument that is
       NULL.  The default attributes are set using the attributes supplied in *attr,  a  previously  initialized
       thread attributes object.  Note the following details about the supplied attributes object:

       •  Значения атрибутов в объекте должны быть корректными.

       •  Атрибут stack address не должен быть указан в объекте.

       •  Значение нуля в stack size означает, что размер стека по умолчанию остаётся без изменения.

       Функция  pthread_getattr_default_np()  инициализирует  объект  атрибутов нити, на который указывает attr,
       так, что он содержит значения атрибутов по умолчанию, использованные при создании нити.

ОШИБКИ

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

       ENOMEM (pthread_setattr_default_np())  Недостаточно памяти.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌─────────────────────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ ИнтерфейсАтрибутЗначение │
       ├─────────────────────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │ pthread_getattr_default_np(), pthread_setattr_default_np()          │ Безвредность в нитях │ MT-Safe  │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       GNU; hence the suffix "_np" (nonportable) in their names.

ИСТОРИЯ

       glibc 2.18.

ПРИМЕРЫ

       В программе, показанной далее, используется pthread_getattr_default_np() для получения атрибутов создания
       нити по умолчанию, а затем выводятся различные параметры полученного объекта. Вывод работы программы:

           $ ./a.out
           Размер стека:          8388608
           Размер защиты:          4096
           Алгоритм планирования:   SCHED_OTHER
           Приоритет планирования: 0
           Состояние отсоединения:        JOINABLE
           Наследование планировщика:   INHERIT

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

       #define _GNU_SOURCE
       #include <err.h>
       #include <errno.h>
       #include <pthread.h>
       #include <stdio.h>
       #include <stdlib.h>

       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)
               errc(EXIT_FAILURE, s, "pthread_attr_getstacksize");
           printf("Stack size:          %zu\n", stacksize);

           s = pthread_attr_getguardsize(attr, &guardsize);
           if (s != 0)
               errc(EXIT_FAILURE, s, "pthread_attr_getguardsize");
           printf("Guard size:          %zu\n", guardsize);

           s = pthread_attr_getschedpolicy(attr, &policy);
           if (s != 0)
               errc(EXIT_FAILURE, s, "pthread_attr_getschedpolicy");
           printf("Scheduling policy:   %s\n",
                  (policy == SCHED_FIFO) ? "SCHED_FIFO" :
                  (policy == SCHED_RR) ? "SCHED_RR" :
                  (policy == SCHED_OTHER) ? "SCHED_OTHER" : "[unknown]");

           s = pthread_attr_getschedparam(attr, &schedparam);
           if (s != 0)
               errc(EXIT_FAILURE, s, "pthread_attr_getschedparam");
           printf("Scheduling priority: %d\n", schedparam.sched_priority);

           s = pthread_attr_getdetachstate(attr, &detachstate);
           if (s != 0)
               errc(EXIT_FAILURE, s, "pthread_attr_getdetachstate");
           printf("Detach state:        %s\n",
                  (detachstate == PTHREAD_CREATE_DETACHED) ? "DETACHED" :
                  (detachstate == PTHREAD_CREATE_JOINABLE) ? "JOINABLE" :
                  "???");

           s = pthread_attr_getinheritsched(attr, &inheritsched);
           if (s != 0)
               errc(EXIT_FAILURE, s, "pthread_attr_getinheritsched");
           printf("Inherit scheduler:   %s\n",
                  (inheritsched == PTHREAD_INHERIT_SCHED) ? "INHERIT" :
                  (inheritsched == PTHREAD_EXPLICIT_SCHED) ? "EXPLICIT" :
                  "???");
       }

       int
       main(void)
       {
           int s;
           pthread_attr_t attr;

           s = pthread_getattr_default_np(&attr);
           if (s != 0)
               errc(EXIT_FAILURE, 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)

ПЕРЕВОД

       Русский перевод этой страницы руководства разработал(и) Alexey, Azamat Hackimov
       <azamat.hackimov@gmail.com>, kogamatranslator49 <r.podarov@yandex.ru>, Darima Kogan
       <silverdk99@gmail.com>, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом
       разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                  15 июня 2024 г.                   pthread_getattr_default_np(3)