Параллельное и распределенное программирование на С++

Хьюз Камерон

pthread_attr_getdetachstate, pthread_attr__setdetachstate — функции считывания и записи атрибута detachstate.

Синопсис

THR #include <pthread.h>

int pthread_attr_getdetachstate (

const pthread_attr_t *attr, int *detachstate) ;

int pthread_attr_setdetachstate (pthread_attr_t *attr,

int detachstate) ;

Описание

Атрибут detachstate управляет тем, создается ли поток в открепленно м (отсоединенно м) состоянии. Если поток создается открепленным,

то использование его идентификационного но м ера (ID) функция м и pthread_detach или pthread_join является ошибкой.

Функции pthread_attr_getdetachstate и pthread_attr_setdetachstate считывают и устанавливают соответственно атрибут detachstate в объекте атрибутов, адресуе м о м пара м етро м аttr.

С по м ощью функции pthread_attr_setdetachstate приложение м ожет установить атрибут detachstate равны м либо значению PTHREAD_CREATE_DETACHED, либо значению PTHREAD_CREATE_JOINABLE.

С по м ощью функции pthread_attr_getdetachstate считывается значение атрибута detachstate, которое м ожет быть равны м либо PTHREAD_ CREATE_DE TACHED, либо PTHREAD_CREATE_JO INABLE.

Значение PTHREAD_CREATE_DETACHED используется для перевода всех потоков, создавае м ых с по м ощью объекта, адресуе м ого пара м етро м attr, в открепленное состояние, в то вре м я как значение PTHREAD_CREATE_JO INABLE при м еняется для перевода всех потоков, создавае м ых с по м ощью объекта, адресуе м ого пара м етро м attr, в присоединенное состояние. По у м олчанию атрибут detachstate устанавливается равны м значению PTHREAD_CREATE_JO INABLE.

Возвращаемые значения

При успешно м завершении функции pthread_attr_getdetachstate и pthread_attr_setdetachstate возвращают нулевое значение; в противном случае — код ошибки, обозначающий ее характер.

Функция pthread_attr_getdetachstate при успешно м выполнении сохраняет значение атрибута detachstate в пара м етре detachstate.

Ошибки

Функция pthread_attr_setdetachstate завершится неу д ачно, если: [EINVAL ] значение, за д анное пара м етро м de tachsta te, недействительно. Эти функции не возвра щ ают код ошибки [EINTR].

Примеры

Отсутствуют.

Замечания

по использованию

Отсутствует.

Логическое обоснование

Отсутствует.

Будущие направления

Отсутствуют.

Смотри также

pthread_attr_destroy , pthread_attr_getstackaddr ,

pthread_attr_getstacksize , pthread_create , том Base Definidons стандарта IEEEStd 1003.1-2001, <pthread.h>.

Последовательность внесения изменений

Функции впервые реализованы в выпуске Issue 5. Включены для согласования с расширением POSIX Threads Extension.

Issue 6

Функции pthread_attr_getdetachstate и pthread_attr_setdetachstate от м ечены как часть опции Threads.

Раздел «Описание» был отредактирован с целью исключить из него слово «must» («должен»).

pthread_attr_getguardsize, pthread_attr_setguardsize

Имя

pthread_attr_getguardsize, pthread_attr_setguardsize— функции считывания и установки значения потоково г о атрибута guardsize.

Синопсис

XSI #include <pthread.h>

int pthread_attr_getguardsize (

const pthread_attr_t *restrict attr, size_t *restrict guardsize);

int pthread_attr_setguardsize (pthread_attr_t *attr,

size_t guardsize);

Описание

Функция pthread_attr_getguardsize используется для считывания атрибута guardsize из объекта атрибутов, адресуе м ого пара м етро м attr. Этот атрибут возвращается в пара м етре guardsize.

Функция pthread_attr_setguardsize позволяет установить атрибут guardsize в объекте атрибутов, адресуемом параметром аttr. Новое значение этого атрибута записывается из пара м етра guardsize. Если значение пара м етра guardsize равно нулю, то для потоков, создавае м ых с использование м атрибута attr, защищенная область не предоставляется. Если значение пара м етра guardsize больше нуля, то для каждого потока, создавае м ого с использование м атрибута attr, предоставляется защищенная область, раз м ер которой составляет не м енее guardsize байтов.

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