ИМЯ

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

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

POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ

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

СМОТРИТЕ ТАКЖЕ

sem_init(3), sem_post(3), sem_wait(3), sem_overview(7)