名称

sem_destroy — 無名のセマフォを破壊する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < semaphore.h>

int
sem_destroy( sem_t *sem);

解説

sem_destroy() 関数は、 sem によって指される無名のセマフォを破壊します。 sem_destroy() への成功した呼び出しの後で、 sem_init(3) への別の呼び出しによって再初期化されるまで sem は使用不可能です。

戻り値

The sem_destroy() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

sem_destroy() 関数は、次の場合に失敗します:

[ EINVAL]

sem 引数が、無効なセマフォを指しています。

[ EBUSY]

sem が指しているセマフォをブロックしている現在のスレッドがあります。

関連項目

sem_init(3), sem(4)

規格

sem_destroy() 関数は、 ISO/IEC 9945-1:1996 (“POSIX.1”) に適合しています。

POSIX は、 sem の上でブロックされたスレッドがある間に呼ばれるなら、 sem_destroy() の振る舞いを定義しません。しかし、この実装は-1 を返し、かつ sem の上にブロックされたスレッドがある場合 EBUSY を errno に設定することが保証されてます。