OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man3 / sem_destroy.3
index 35791b7..e9f3d6a 100644 (file)
@@ -1,4 +1,4 @@
-'\" t
+.\" t
 .\" Hey Emacs! This file is -*- nroff -*- source.
 .\"
 .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI all rights reserved.
-.\" 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 ½ñ¼°
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH SEM_DESTROY 3 2006\-03\-25 Linux "Linux Programmer's Manual"
+.SH 名前
+sem_destroy \- 名前なしセマフォを破棄する
+.SH 書式
 .nf
-.B #include <semaphore.h>
+\fB#include <semaphore.h>\fP
 .sp
-.BI "int sem_destroy(sem_t *" sem );
+\fBint sem_destroy(sem_t *\fP\fIsem\fP\fB);\fP
 .fi
 .sp
-\fI\-lrt\fP ¤Þ¤¿¤Ï \fI\-pthread\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.SH ÀâÌÀ
-.BR sem_destroy ()
-¤Ï
-.I sem
-¤¬»Ø¤¹¥¢¥É¥ì¥¹¤Ë¤¢¤ë̾Á°¤Ê¤·¥»¥Þ¥Õ¥©¤òÇË´þ¤¹¤ë¡£
+\fI\-lrt\fP または \fI\-pthread\fP でリンクする。
+.SH 説明
+\fBsem_destroy\fP()  は \fIsem\fP が指すアドレスにある名前なしセマフォを破棄する。
 
-.BR sem_destroy ()
-¤ò»È¤Ã¤ÆÇË´þ¤¹¤ë¤Î¤Ï¡¢
-.BR sem_init (3)
-¤Ç½é´ü²½¤·¤¿¥»¥Þ¥Õ¥©¤À¤±¤Ë¤¹¤Ù¤­¤Ç¤¢¤ë¡£
+\fBsem_destroy\fP()  を使って破棄するのは、 \fBsem_init\fP(3)  で初期化したセマフォだけにすべきである。
 
-¾¤Î¥×¥í¥»¥¹¤ä¥¹¥ì¥Ã¥É¤¬
-.RB ( sem_wait (3)
-¤Ç) ÂÔ¤Á¾õÂ֤ˤʤäƤ¤¤ë¥»¥Þ¥Õ¥©¤òÇË´þ¤·¤¿¾ì¹ç¤ÎµóÆ°¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
+他のプロセスやスレッドが (\fBsem_wait\fP(3)  で) 待ち状態になっているセマフォを破棄した場合の挙動は定義されていない。
 
-¤¹¤Ç¤ËÇË´þ¤µ¤ì¤¿¥»¥Þ¥Õ¥©¤ò¡¢
-.BR sem_init (3)
-¤ò»È¤Ã¤ÆºÆ½é´ü²½¤µ¤ì¤ëÁ°¤Ë»ÈÍѤ·¤¿¾ì¹ç¡¢¤½¤Î·ë²Ì¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢
-.BR sem_destroy ()
-¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
-.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹Ãͤò¥»¥Ã¥È¤¹¤ë¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EINVAL
-.I sem
-¤ÏÍ­¸ú¤Ê¥»¥Þ¥Õ¥©¤Ç¤Ï¤Ê¤¤¡£
-.SH ½àµò
-POSIX.1-2001.
-.SH Ãí°Õ
-̾Á°¤Ê¤·¥»¥Þ¥Õ¥©¤Ï¡¢¤½¤Î¥»¥Þ¥Õ¥©¤¬ÃÖ¤«¤ì¤Æ¤¤¤ë¥á¥â¥ê¤¬²òÊü¤µ¤ì¤ëÁ°¤Ë¡¢
-.BR sem_destroy ()
-¤ò»È¤Ã¤ÆÇË´þ¤·¤Æ¤ª¤¯¤Ù¤­¤Ç¤¢¤ë¡£¤³¤ì¤ò¹Ô¤ï¤Ê¤«¤Ã¤¿¾ì¹ç¡¢¼ÂÁõ¤Ë¤è¤Ã¤Æ¤Ï
-¥ê¥½¡¼¥¹¤Î¥ê¡¼¥¯¤¬µ¯¤³¤ê¤¨¤ë¡£
-.\" NPTL ¤Ç¤Ï¥ê¡¼¥¯¤Ïµ¯¤³¤é¤Ê¤¤¡£sem_destroy () ¤Ï²¿¤â¤·¤Ê¤¤¤À¤±..
-.SH ´ØÏ¢¹àÌÜ
-.BR sem_init (3),
-.BR sem_post (3),
-.BR sem_wait (3),
-.BR sem_overview (7)
+すでに破棄されたセマフォを、 \fBsem_init\fP(3)  を使って再初期化される前に使用した場合、その結果は未定義である。
+.SH 返り値
+成功すると、 \fBsem_destroy\fP()  は 0 を返す。エラーの場合、\-1 を返し、 \fIerrno\fP にエラーを示す値をセットする。
+.SH エラー
+.TP 
+\fBEINVAL\fP
+\fIsem\fP は有効なセマフォではない。
+.SH 準拠
+POSIX.1\-2001.
+.SH 注意
+.\" But not on NPTL, where sem_destroy () is a no-op..
+名前なしセマフォは、そのセマフォが置かれているメモリが解放される前に、 \fBsem_destroy\fP()
+を使って破棄しておくべきである。これを行わなかった場合、実装によっては リソースのリークが起こりえる。
+.SH 関連項目
+\fBsem_init\fP(3), \fBsem_post\fP(3), \fBsem_wait\fP(3), \fBsem_overview\fP(7)