.\" Translated 2006-04-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
.TH SEM_DESTROY 3 2006-03-25 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-sem_destroy \- ̾Á°¤Ê¤·¥»¥Þ¥Õ¥©¤òÇË´þ¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+sem_destroy \- 名前なしセマフォを破棄する
+.SH 書式
.nf
.B #include <semaphore.h>
.sp
.BI "int sem_destroy(sem_t *" sem );
.fi
.sp
-\fI\-lrt\fP ¤Þ¤¿¤Ï \fI\-pthread\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.SH ÀâÌÀ
+\fI\-lrt\fP または \fI\-pthread\fP でリンクする。
+.SH 説明
.BR sem_destroy ()
-¤Ï
+は
.I sem
-¤¬»Ø¤¹¥¢¥É¥ì¥¹¤Ë¤¢¤ë̾Á°¤Ê¤·¥»¥Þ¥Õ¥©¤òÇË´þ¤¹¤ë¡£
+が指すアドレスにある名前なしセマフォを破棄する。
.BR sem_destroy ()
-¤ò»È¤Ã¤ÆÇË´þ¤¹¤ë¤Î¤Ï¡¢
+を使って破棄するのは、
.BR sem_init (3)
-¤Ç½é´ü²½¤·¤¿¥»¥Þ¥Õ¥©¤À¤±¤Ë¤¹¤Ù¤¤Ç¤¢¤ë¡£
+で初期化したセマフォだけにすべきである。
-¾¤Î¥×¥í¥»¥¹¤ä¥¹¥ì¥Ã¥É¤¬
+他のプロセスやスレッドが
.RB ( sem_wait (3)
-¤Ç) ÂÔ¤Á¾õÂ֤ˤʤäƤ¤¤ë¥»¥Þ¥Õ¥©¤òÇË´þ¤·¤¿¾ì¹ç¤ÎµóÆ°¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
+で) 待ち状態になっているセマフォを破棄した場合の挙動は定義されていない。
-¤¹¤Ç¤ËÇË´þ¤µ¤ì¤¿¥»¥Þ¥Õ¥©¤ò¡¢
+すでに破棄されたセマフォを、
.BR sem_init (3)
-¤ò»È¤Ã¤ÆºÆ½é´ü²½¤µ¤ì¤ëÁ°¤Ë»ÈÍѤ·¤¿¾ì¹ç¡¢¤½¤Î·ë²Ì¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢
+を使って再初期化される前に使用した場合、その結果は未定義である。
+.SH 返り値
+成功すると、
.BR sem_destroy ()
-¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
+は 0 を返す。エラーの場合、\-1 を返し、
.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹Ãͤò¥»¥Ã¥È¤¹¤ë¡£
-.SH ¥¨¥é¡¼
+にエラーを示す値をセットする。
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EINVAL
.I sem
-¤Ï͸ú¤Ê¥»¥Þ¥Õ¥©¤Ç¤Ï¤Ê¤¤¡£
-.SH ½àµò
+は有効なセマフォではない。
+.SH 準拠
POSIX.1-2001.
-.SH Ãí°Õ
-̾Á°¤Ê¤·¥»¥Þ¥Õ¥©¤Ï¡¢¤½¤Î¥»¥Þ¥Õ¥©¤¬ÃÖ¤«¤ì¤Æ¤¤¤ë¥á¥â¥ê¤¬²òÊü¤µ¤ì¤ëÁ°¤Ë¡¢
+.SH 注意
+名前なしセマフォは、そのセマフォが置かれているメモリが解放される前に、
.BR sem_destroy ()
-¤ò»È¤Ã¤ÆÇË´þ¤·¤Æ¤ª¤¯¤Ù¤¤Ç¤¢¤ë¡£¤³¤ì¤ò¹Ô¤ï¤Ê¤«¤Ã¤¿¾ì¹ç¡¢¼ÂÁõ¤Ë¤è¤Ã¤Æ¤Ï
-¥ê¥½¡¼¥¹¤Î¥ê¡¼¥¯¤¬µ¯¤³¤ê¤¨¤ë¡£
-.\" NPTL ¤Ç¤Ï¥ê¡¼¥¯¤Ïµ¯¤³¤é¤Ê¤¤¡£sem_destroy () ¤Ï²¿¤â¤·¤Ê¤¤¤À¤±..
-.SH ´ØÏ¢¹àÌÜ
+を使って破棄しておくべきである。これを行わなかった場合、実装によっては
+リソースのリークが起こりえる。
+.\" NPTL ではリークは起こらない。sem_destroy () は何もしないだけ..
+.SH 関連項目
.BR sem_init (3),
.BR sem_post (3),
.BR sem_wait (3),
OSDN Git Service
