SEM_DESTROY(3)

ИМЯ
sem_destroy - уничтожает безымянный семафор

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

int sem_destroy(sem_t *sem);

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

ОПИСАНИЕ
Функция sem_destroy() уничтожает безымянный семафор, расположенный по адресу sem.

С помощью sem_destroy() должны уничтожаться только семафоры, которые были инициализированы с помощью sem_init(3).

Уничтожение семафора, заблокированного другим процессом или нитью (в sem_wait(3)), приводит к непредсказуемым последствиям.

Использование уничтоженного семафора (и повторно не инициализированного с помощью sem_init(3)) приводит к непредсказуемым результатам.

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

ОШИБКИ

EINVAL
    Значение sem не является корректным для семафора.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
sem_destroy() | Безвредность в нитях | MT-Safe

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

ЗАМЕЧАНИЯ
Безымянный семафор должен уничтожаться с помощью sem_destroy() до высвобождения памяти, которую он использует. Неследование этому правилу приводит в некоторых реализациях к утечке ресурсов.

СМОТРИТЕ ТАКЖЕ
sem_init(3), sem_post(3), sem_wait(3), sem_overview(7)