pthread_detach

PTHREAD_DETACH(3)        Руководство программиста Linux        PTHREAD_DETACH(3)



ИМЯ
       pthread_detach - отсоединяет нить

ОБЗОР
       #include <pthread.h>

       int pthread_detach(pthread_t thread);

       Компилируется и компонуется вместе с -pthread.

ОПИСАНИЕ
       Функция pthread_detach() помечает нить, указанную thread, как
       отсоединённую. Когда отсоединённая нить завершается, её ресурсы
       автоматически отдаются обратно системе и не нужно объединять другую нить
       с завершившей работу.

       Попытка отсоединить уже отсоединённую нить приводит к непредсказуемым
       последствиям.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
       При успешном выполнении pthread_detach() возвращается 0; при ошибке
       возвращается номер ошибки.

ОШИБКИ
       EINVAL Нить thread не является присоединяемой.

       ESRCH  Нить с идентификатором thread не найдена.

АТРИБУТЫ
       Описание терминов данного раздела смотрите в attributes(7).

       ┌─────────────────┬──────────────────────┬──────────┐
       │Интерфейс        Атрибут              Значение │
       ├─────────────────┼──────────────────────┼──────────┤
       │pthread_detach() │ Безвредность в нитях │ MT-Safe  │
       └─────────────────┴──────────────────────┴──────────┘

СООТВЕТСТВИЕ СТАНДАРТАМ
       POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ
       После отсоединения нить её нельзя обратно присоединить с помощью
       pthread_join(3) или снова сделать присоединяемой.

       Новую нить можно создать в отсоединённом состоянии с помощью
       pthread_attr_setdetachstate(3), установив атрибут отсоединения у
       аргумента attr при pthread_create(3).

       Атрибут отсоединения просто определяет поведение системы при завершении
       нити; он не препятствует завершению нити при завершении работы процесс с
       помощью exit(3) (или эквивалента, если завершается основная нить).

       Функция pthread_join(3) или pthread_detach() должна вызываться для каждой
       нити, созданной приложением, для того, чтобы можно было освободить
       системные ресурсы нити (но, заметим, что ресурсы всех нитей освобождаются
       при завершении процесса).

ПРИМЕР
       Следующее выражение отсоединяет вызвавшую нить:

           pthread_detach(pthread_self());

СМОТРИТЕ ТАКЖЕ
       pthread_attr_setdetachstate(3), pthread_cancel(3), pthread_create(3),
       pthread_exit(3), pthread_join(3), pthreads(7)



Linux                              2015-07-23                  PTHREAD_DETACH(3)