OSDN Git Service

(split) LDP: Update release pages
[linuxjm/LDP_man-pages.git] / release / man3 / usleep.3
index 3d5f11b..6e2cbb7 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\" Modified 2001-04-01 by aeb
 .\" Modified 2003-07-23 by aeb
 .\"
-.\" Japanese Version Copyright (c) 1997 YOSHINO Takashi
-.\"       all rights reserved.
-.\" Translated Mon Jan 20 18:47:50 JST 1997
-.\"       by YOSHINO Takashi <yoshino@civil.jcn.nihon-u.ac.jp>
-.\" Updated Sat May 19 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
-.\" Updated Mon Sep  1 JST 2003 by Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2007-05-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.44
+.\"*******************************************************************
 .\"
-.TH USLEEP 3  2007-07-26 "" "Linux Programmer's Manual"
-.SH Ì¾Á°
-usleep \- ¥Þ¥¤¥¯¥íÉÃñ°Ì¤Ç¼Â¹Ô¤ò±ä´ü¤¹¤ë
-.SH ½ñ¼°
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH USLEEP 3 2013\-04\-19 "" "Linux Programmer's Manual"
+.SH 名前
+usleep \- マイクロ秒単位で実行を延期する
+.SH 書式
 .nf
-.B "#include <unistd.h>"
+\fB#include <unistd.h>\fP
 .sp
-.BI "int usleep(useconds_t " usec );
+\fBint usleep(useconds_t \fP\fIusec\fP\fB);\fP
 .fi
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR usleep ():
-_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500
-.SH ÀâÌÀ
-.BR usleep ()
-´Ø¿ô¤Ï
-(¾¯¤Ê¤¯¤È¤â) \fIusec\fP¥Þ¥¤¥¯¥íÉäδ֡¢
-¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¼Â¹Ô¤ò±ä´ü¤¹¤ë¡£
-¥·¥¹¥Æ¥à¤ÎÆ°ºî¾õ¶·¤ä¸Æ¤Ó½Ð¤·¤Ë¤è¤ë»þ´Ö¤Î¾ÃÈñ¤ä¥·¥¹¥Æ¥à¥¿¥¤¥Þ¤ÎγÅ٤ˤè¤Ã¤Æ¡¢
-Ää»ß»þ´Ö¤ÏÀßÄꤷ¤¿Ãͤè¤ê¤â¾¯¤·±ä¤Ð¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È 0¡¢¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤¹¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EINTR
-¥·¥°¥Ê¥ë¤Ë¤è¤Ã¤ÆÃæÃǤµ¤ì¤¿¡£
-.BR signal (7)
-»²¾È¡£
-.TP
-.B EINVAL
-\fIusec\fP ¤¬ 1000000 °Ê¾å¤À¤Ã¤¿¡£
-(¤³¤ì¤ò¥¨¥é¡¼¤È¤ß¤Ê¤¹¥·¥¹¥Æ¥à¤Î¤ß)
-.SH ½àµò
-4.3BSD, POSIX.1-2001.
-POSIX.1-2001 ¤Ç¤Ï¡¢¤³¤Î´Ø¿ô¤Ï²áµî¤Î¤â¤Î¤ÈÀë¸À¤µ¤ì¤Æ¤¤¤ë¡£
-Âå¤ï¤ê¤Ë
-.BR nanosleep (2)
-¤ò»È¤¦¤³¤È¡£
-POSIX.1-2008 ¤Ç¤Ï¡¢
-.BR usleep ()
-¤Îµ¬Ä꤬ºï½ü¤µ¤ì¤Æ¤¤¤ë¡£
+\fBusleep\fP():
+.ad l
+.RS 4
+.PD 0
+.TP  4
+glibc 2.12 以降:
+.nf
+_BSD_SOURCE ||
+    (_XOPEN_SOURCE\ >=\ 500 ||
+        _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) &&
+    !(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700)
+.TP  4
+.fi
+glibc 2.12 より前: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+.PD
+.RE
+.ad b
+.SH 説明
+\fBusleep\fP()  関数は (少なくとも) \fIusec\fPマイクロ秒の間、 呼び出し元スレッドの実行を延期する。
+システムの動作状況や呼び出しによる時間の消費やシステムタイマの粒度によって、 停止時間は設定した値よりも少し延ばされるかもしれない。
+.SH 返り値
+\fBusleep\fP() 関数は成功すると 0 を返す。 エラーの場合、 \-1 が返され、 \fIerrno\fP にエラーの原因を示す値が設定される。
+.SH エラー
+.TP 
+\fBEINTR\fP
+シグナルによって中断された。 \fBsignal\fP(7)  参照。
+.TP 
+\fBEINVAL\fP
+\fIusec\fP が 1000000 以上だった。 (これをエラーとみなすシステムのみ)
+.SH 準拠
+4.3BSD, POSIX.1\-2001.  POSIX.1\-2001 では、この関数は過去のものと宣言されている。 代わりに
+\fBnanosleep\fP(2)  を使うこと。 POSIX.1\-2008 では、 \fBusleep\fP()  の規定が削除されている。
 
-¤â¤È¤â¤È¤Î BSD ¤Î¼ÂÁõ¤ä¡¢¥Ð¡¼¥¸¥ç¥ó 2.2.2 ¤è¤êÁ°¤Î glibc ¤Ç¤Ï¡¢
-¤³¤Î´Ø¿ô¤ÎÊÖ¤êÃͤη¿¤Ï
-.I void
-¤Ç¤¢¤ë¡£
-POSIX ÈǤÏ
-.I int
-¤òÊÖ¤·¡¢¤³¤Î¥×¥í¥È¥¿¥¤¥×¤Ï glibc 2.2.2 °Ê¹ß¤Ç»ÈÍѤµ¤ì¤Æ¤¤¤ë¡£
+もともとの BSD の実装や、バージョン 2.2.2 より前の glibc では、 この関数の返り値の型は \fIvoid\fP である。 POSIX 版は
+\fIint\fP を返し、このプロトタイプは glibc 2.2.2 以降で使用されている。
 
-¥¨¥é¡¼¤È¤·¤Æ
-.B EINVAL
-¤òÊÖ¤¹¤È¤¤¤¦¤Î¤Ï
-SUSv2 ¤È POSIX.1-2001 ¤Ç¤Î¤ßʸ½ñ²½¤µ¤ì¤Æ¤¤¤ë¡£
-.SH Ãí°Õ
-.I useconds_t
-·¿¤Ï [0,1000000] ¤ÎÈϰϤÎÀ°¿ô¤ò°·¤¦¤³¤È¤¬¤Ç¤­¤ë
-Éä¹æ¤Ê¤·À°¿ô·¿¤Ç¤¢¤ë¡£
-ÌÀ¼¨Åª¤Ë¤³¤Î·¿¤ò»È¤ï¤Ê¤¤¤³¤È¤Ç¥×¥í¥°¥é¥à¤Î°Ü¿¢À­¤¬¤è¤ê¹â¤Þ¤ë¡£
-°Ê²¼¤Î¤è¤¦¤Ë»È¤¦¤³¤È¡£
+エラーとして \fBEINVAL\fP を返すというのは SUSv2 と POSIX.1\-2001 でのみ文書化されている。
+.SH 注意
+\fIuseconds_t\fP 型は [0,1000000] の範囲の整数を扱うことができる 符号なし整数型である。
+明示的にこの型を使わないことでプログラムの移植性がより高まる。 以下のように使うこと。
 .in +4n
 .nf
 .sp
@@ -112,26 +100,14 @@ SUSv2 
 .fi
 .in
 .LP
-¤³¤Î´Ø¿ô¤È¡¢
-.B SIGALRM
-¥·¥°¥Ê¥ë¤¢¤ë¤¤¤Ï
-.BR alarm (2),
-.BR sleep (3),
-.BR nanosleep (2),
-.BR setitimer (2),
-.BR timer_create (2),
-.BR timer_delete (2),
-.BR timer_getoverrun (2),
-.BR timer_gettime (2),
-.BR timer_settime (2),
-.BR ualarm (3)
-¤È¤¤¤Ã¤¿¤½¤Î¾¤Î¥¿¥¤¥Þ¡¼´Ø¿ô¤òƱ»þ¤Ë»È¤Ã¤¿¾ì¹ç¤ÎÆ°ºî¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR alarm (2),
-.BR getitimer (2),
-.BR nanosleep (2),
-.BR select (2),
-.BR setitimer (2),
-.BR sleep (3),
-.BR ualarm (3),
-.BR time (7)
+この関数と、 \fBSIGALRM\fP シグナルあるいは \fBalarm\fP(2), \fBsleep\fP(3), \fBnanosleep\fP(2),
+\fBsetitimer\fP(2), \fBtimer_create\fP(2), \fBtimer_delete\fP(2),
+\fBtimer_getoverrun\fP(2), \fBtimer_gettime\fP(2), \fBtimer_settime\fP(2),
+\fBualarm\fP(3)  といったその他のタイマー関数を同時に使った場合の動作は未定義である。
+.SH 関連項目
+\fBalarm\fP(2), \fBgetitimer\fP(2), \fBnanosleep\fP(2), \fBselect\fP(2),
+\fBsetitimer\fP(2), \fBsleep\fP(3), \fBualarm\fP(3), \fBtime\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。