SEM_DESTROY
Section: Linux Programmer's Manual (3)
Updated: 2006-03-25
Index
JM Home Page
roff page
名前
sem_destroy - 名前なしセマフォを破棄する
書式
#include <semaphore.h>
int sem_destroy(sem_t *sem);
説明
sem_destroy()
は
sem
が指すアドレスにある名前なしセマフォを破棄する。
sem_destroy()
を使って破棄するのは、
sem_init(3)
で初期化したセマフォだけにすべきである。
他のプロセスやスレッドが
(sem_wait(3)
で) 待ち状態になっているセマフォを破棄した場合の挙動は定義されていない。
すでに破棄されたセマフォを、
sem_init(3)
を使って再初期化される前に使用した場合、その結果は未定義である。
返り値
成功すると、
sem_destroy()
は 0 を返す。エラーの場合、-1 を返し、
errno
にエラーを示す値をセットする。
エラー
- EINVAL
-
sem
は有効なセマフォではない。
準拠
POSIX.1-2001.
注意
名前なしセマフォは、そのセマフォが置かれているメモリが解放される前に、
sem_destroy()
を使って破棄しておくべきである。これを行わなかった場合、実装によっては
リソースのリークが起こりえる。
関連項目
sem_init(3),
sem_post(3),
sem_wait(3),
sem_overview(7)
Index
- 名前
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 準拠
-
- 注意
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.
Time: 04:32:01 GMT, November 19, 2007