release/man2/nanosleep.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (C) Markus Kuhn, 1996
   4 .\" and Copyright (C) Linux Foundation, 2008, written by Michael Kerrisk
   5 .\"     <mtk.manpages@gmail.com>
   6 .\"
   7 .\" This is free documentation; you can redistribute it and/or
   8 .\" modify it under the terms of the GNU General Public License as
   9 .\" published by the Free Software Foundation; either version 2 of
  10 .\" the License, or (at your option) any later version.
  11 .\"
  12 .\" The GNU General Public License's references to "object code"
  13 .\" and "executables" are to be interpreted as the output of any
  14 .\" document formatting or typesetting system, including
  15 .\" intermediate and printed output.
  16 .\"
  17 .\" This manual is distributed in the hope that it will be useful,
  18 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 .\" GNU General Public License for more details.
  21 .\"
  22 .\" You should have received a copy of the GNU General Public
  23 .\" License along with this manual; if not, write to the Free
  24 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  25 .\" USA.
  26 .\"
  27 .\" 1996-04-10  Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de>
  28 .\"             First version written
  29 .\" Modified, 2004-10-24, aeb
  30 .\" 2008-06-24, mtk
  31 .\"     Minor rewrites of some parts.
  32 .\"     NOTES: describe case where clock_nanosleep() can be preferable.
  33 .\"     NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP
  34 .\"     Replace crufty discussion of HZ with a pointer to time(7).
  35 .\"
  36 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
  37 .\"         all rights reserved.
  38 .\" Translated 1997-02-23, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  39 .\" Updated 1999-02-27, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  40 .\" Updated 2003-09-15, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  41 .\" Updated 2005-02-10, Akihiro MOTOKI
  42 .\" Updated 2006-07-23, Akihiro MOTOKI, LDP v2.36
  43 .\" Updated 2006-08-13, Akihiro MOTOKI, LDP v2.39
  44 .\" Updated 2008-08-08, Akihiro MOTOKI, LDP v3.05
  45 .\"
  46 .\"WORD:        puase                   Ää»ß
  47 .\"WORD:        sleep                   Ää»ß
  48 .\"WORD:        signal                  ¥·¥°¥Ê¥ë
  49 .\"WORD:        NULL                    NULL
  50 .\"WORD:        block                   ¶Ø»ß(block)
  51 .\"WORD:        kernel                  ¥«¡¼¥Í¥ë
  52 .\"WORD:        real-time               ¥ê¥¢¥ë¡¦¥¿¥¤¥à
  53 .\"WORD:        schedule                ¥¹¥±¥¸¥å¡¼¥ë
  54 .\"WORD:        busy wait               ¥Ó¥·¡¼¡¦¥¦¥§¥¤¥È
  55 .\"
  56 .TH NANOSLEEP 2 2009-01-19 "Linux" "Linux Programmer's Manual"
  57 .SH Ì¾Á°
  58 nanosleep \- ¹âÀºÅÙ¤Ê¥¹¥ê¡¼¥×
  59 .SH ½ñ¼°
  60 .B #include <time.h>
  61 .sp
  62 .BI "int nanosleep(const struct timespec *" req ", struct timespec *" rem );
  63 .sp
  64 .in -4n
  65 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  66 .RB ( feature_test_macros (7)
  67 »²¾È):
  68 .in
  69 .sp
  70 .BR nanosleep ():
  71 _POSIX_C_SOURCE\ >=\ 199309L
  72 .SH ÀâÌÀ
  73 .BR nanosleep ()
  74 ¤Ï¡¢¾¯¤Ê¤¯¤È¤â
  75 .I *req
  76 ¤Ç»ØÄê¤µ¤ì¤¿»þ´Ö¤Î´Ö¡¢¥×¥í¥°¥é¥à¤Î¼Â¹Ô¤òÃÙ±ä¤µ¤»¤ë¡£
  77 .BR nanosleep ()
  78 ¤Ï¡¢¸Æ¤Ó½Ð¤·¤¿¥¹¥ì¥Ã¥É¤Î¼Â¹Ô¤ò¡¢
  79 ¾¯¤Ê¤¯¤È¤â
  80 .I *req
  81 ¤Ç»ØÄê¤µ¤ì¤¿»þ´Ö¤Î´Ö¡¢¤â¤·¤¯¤Ï¸Æ¤Ó½Ð¤·¤¿¥¹¥ì¥Ã¥É¤Ç¥Ï¥ó¥É¥é¤Îµ¯Æ°¤Î
  82 ¤¤Ã¤«¤±¤È¤Ê¤ë¥·¥°¥Ê¥ë¡¢¤Þ¤¿¤Ï¥×¥í¥»¥¹¤ò½ªÎ»¤µ¤»¤ë¥·¥°¥Ê¥ë¤ÎÇÛÁ÷¤¬
  83 ¹Ô¤ï¤ì¤ë¤Þ¤Ç°ì»þÄä»ß¤¹¤ë¡£
  84
  85 ¸Æ¤Ó½Ð¤·¤¬¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Ë¤è¤ê³ä¤ê¹þ¤Þ¤ì¤¿¾ì¹ç¡¢
  86 .BR nanosleep
  87 ¤Ï \-1 ¤òÊÖ¤·¡¢
  88 .I errno
  89 ¤Ë
  90 .B EINTR
  91 ¤òÀßÄê¤·¡¢
  92 .I rem
  93 ¤¬ NULL ¤Ç¤Ê¤±¤ì¤Ð
  94 »Ä¤ê¤Î»þ´Ö¤ò
  95 .I rem
  96 ¤¬»Ø¤¹¹½Â¤ÂÎ¤Ë³ÊÇ¼¤¹¤ë¡£
  97 .I *rem
  98 ¤ÎÃÍ¤ò»È¤¦¤È¡¢
  99 .BR nanosleep ()
 100 ¤ò¤â¤¦°ìÅÙ¸Æ¤Ó½Ð¤·¤Æ¡¢»ØÄê¤·¤¿»þ´Ö¤ÎÄä»ß¤ò
 101 ´°Î»¤µ¤»¤ë¤³¤È¤¬¤Ç¤¤ë (Ã¢¤·¡¢¡ÖÃí°Õ¡×¤ÎÀá¤ò»²¾È¤Î¤³¤È)¡£
 102
 103 ¥Ê¥ÎÉÃ¹ï¤ß¤Î»þ´Ö´Ö³Ö¤ò»ØÄê¤¹¤ë¤Î¤Ë
 104 .I timespec
 105 ¹½Â¤ÂÎ¤¬»ÈÍÑ¤µ¤ì¤ë¡£¤³¤Î¹½Â¤ÂÎ¤Ï¼¡¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
 106 .sp
 107 .in +4n
 108 .nf
 109     time_t tv_sec;        /* ÉÃ */
 110     long   tv_nsec;       /* ¥Ê¥ÎÉÃ */
 111 };
 112 .fi
 113 .in
 114 .PP
 115 ¥Ê¥ÎÉÃ¤Î¥Õ¥£¡¼¥ë¥É¤ÎÃÍ¤Ï 0 ¤«¤é 999999999 ¤ÎÈÏ°Ï¤Ë¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 116
 117 .BR sleep  (3)
 118 ¤ä
 119 .BR usleep (3)
 120 ¤ËÈæ¤Ù¤ë¤È
 121 .BR nanosleep ()
 122 ¤Ë¤Ï°Ê²¼¤Î¤è¤¦¤ÊÍøÅÀ¤¬¤¢¤ë:
 123 Ää»ß´ü´Ö¤Î»ØÄê¤Ë´Ø¤·¤Æ¹â¤¤»þ´ÖÊ¬²òÇ½¤¬Äó¶¡¤µ¤ì¤Æ¤¤¤ë¡£
 124 ¥·¥°¥Ê¥ë¤È¸ß¤¤¤Ë±Æ¶Á¤òµÚ¤Ü¤¹¤³¤È¤¬¤Ê¤¤¤È
 125 POSIX.1 ¤ÇÌÀ¼¨Åª¤Ëµ¬Äê¤µ¤ì¤Æ¤¤¤ë¡£
 126 ¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Ë¤è¤Ã¤Æ³ä¤ê¹þ¤Þ¤ì¤¿ºÝ¤Ë¡¢Ää»ß¤òºÆ³«¤¹¤ë¤Î¤¬
 127 ¤è¤ê´ÊÃ±¤Ë¤Ç¤¤ë¡£
 128 .SH ÊÖ¤êÃÍ
 129 Í×µá¤µ¤ì¤¿´ü´Ö¤ÎÄä»ß¤ËÀ®¸ù¤·¤¿¾ì¹ç¡¢
 130 .BR nanosleep ()
 131 ¤Ï 0 ¤òÊÖ¤¹¡£¸Æ¤Ó½Ð¤·¤¬¥·¥°¥Ê¥ë¥Ï¥ó¥É¥é¤Ë¤è¤ê³ä¤ê¹þ¤Þ¤ì¤¿¤ê¡¢
 132 ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï¡¢\-1 ¤òÊÖ¤·¡¢
 133 .I errno
 134 ¤Ë¥¨¥é¡¼ÆâÍÆ¤ò¼¨¤¹ÃÍ¤òÀßÄê¤¹¤ë¡£
 135 .SH ¥¨¥é¡¼
 136 .TP
 137 .B EFAULT
 138 ¥æ¡¼¥¶¶õ´Ö¤«¤é¤Î¾ðÊó¤Î¥³¥Ô¡¼¤ÇÌäÂê¤¬¤¢¤Ã¤¿¡£
 139 .TP
 140 .B EINTR
 141 ¤½¤Î¥¹¥ì¥Ã¥É¤ËÇÛÁ÷¤µ¤ì¤¿¥·¥°¥Ê¥ë¤Ë¤è¤êÄä»ß¤¬ÃæÃÇ¤µ¤ì¤¿¡£
 142 ¥¹¥ì¥Ã¥É¤¬´ÊÃ±¤Ë
 143 .BR nanosleep ()
 144 ¤òºÆ¤Ó¸Æ¤Ó½Ð¤·¤ÆÄä»ß¤òÂ³¤±¤ë¤³¤È¤¬¤Ç¤¤ë¤è¤¦¤Ë¡¢
 145 »Ä¤ê¤ÎÄä»ß»þ´Ö¤¬ \fI*rem\fP ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 146 .TP
 147 .B EINVAL
 148 .I tv_nsec
 149 ¥Õ¥£¡¼¥ë¥É¤ÎÃÍ¤¬ 0 ¤«¤é 999999999 ¤Þ¤Ç¤ÎÈÏ°Ï¤Ë¤Ê¤«¤Ã¤¿¤«¡¢
 150 .I tv_sec
 151 ¤¬Éé¤Ç¤¢¤Ã¤¿¡£
 152 .SH ½àµò
 153 POSIX.1-2001.
 154 .SH Ãí°Õ
 155 .I req
 156 ¤Ç»ØÄê¤µ¤ì¤¿´ü´Ö¤¬¡¢ÆâÉô¤Ç»ÈÍÑ¤µ¤ì¤ë¥¯¥í¥Ã¥¯¤ÎÎ³ÅÙ¤ÎÇÜ¿ô¤Ë¤Ê¤Ã¤Æ¤¤¤Ê¤¤
 157 ¾ì¹ç¡¢´ü´Ö¤Ï°ìÈÖ¶á¤¤ÇÜ¿ô¤ËÀÚ¤ê¾å¤²¤é¤ì¤ë¡£
 158 ¤Þ¤¿¡¢Ää»ß¤¬´°Î»¤·¤¿¸å¡¢CPU ¤¬¸Æ¤Ó½Ð¤·¸µ¤Î¥¹¥ì¥Ã¥É¤òºÆ¤Ó¼Â¹Ô¤Ç¤¤ë¤è¤¦¤Ë
 159 ¤Ê¤ë¤Þ¤Ç¤Ë¤ÏÃÙ±ä¤¬Æþ¤ë¡£
 160
 161 ¥·¥°¥Ê¥ë¤Ë¤è¤ë³ä¤ê¹þ¤ß¸å¤Ë·«¤êÊÖ¤·ºÆ³«¤µ¤ì¤¿¾ì¹ç¡¢
 162 .BR nanosleep ()
 163 ¤ÎÄä»ß¤¬ÁêÂÐÅª¤Ê´ü´Ö¤Ç¤¢¤ë¤³¤È¤ÏÌäÂê¤È¤Ê¤ë¤³¤È¤¬¤¢¤ë¡£
 164 ¤³¤ì¤Ï¡¢¸Æ¤Ó½Ð¤·¤Î³ä¤ê¹þ¤ß¤«¤éºÆ³«¤Þ¤Ç¤Î´Ö¤Î»þ´Ö¤¬¸¶°ø¤Ç
 165 Ää»ß¤¬ºÇ½ªÅª¤Ë´°Î»¤·¤¿ºÝ¤Ë»þ´Ö¤Ë¤º¤ì¤¬È¯À¸¤¹¤ë¤«¤é¤Ç¤¢¤ë¡£
 166 ¤³¤ÎÌäÂê¤Ï¡¢ÀäÂÐ»þ¹ï¤¬»ØÄê¤Ç¤¤ë
 167 .BR clock_nanosleep (2)
 168 ¤ò»È¤¦¤³¤È¤Ç²óÈò¤Ç¤¤ë¡£
 169
 170 POSIX.1 ¤Ï¡¢
 171 .BR nanosleep ()
 172 ¤Ï
 173 .B CLOCK_REALTIME
 174 ¤ËÂÐ¤·¤Æ»þ¹ï¤ò·×Â¬¤¹¤ë¤Ù¤¤À¤Èµ¬Äê¤·¤Æ¤¤¤ë¡£
 175 ¤·¤«¤·¤Ê¤¬¤é¡¢Linux ¤Ï
 176 .B CLOCK_MONOTONIC
 177 ¥¯¥í¥Ã¥¯¤òÍÑ¤¤¤Æ»þ¹ï¤ò·×Â¬¤·¤Æ¤¤¤ë¡£
 178 .\" See also http://thread.gmane.org/gmane.linux.kernel/696854/
 179 .\" Subject: nanosleep() uses CLOCK_MONOTONIC, should be CLOCK_REALTIME?
 180 .\" Date: 2008-06-22 07:35:41 GMT
 181 ¤³¤Î¤³¤È¤Ï¤ª¤½¤é¤¯ÌäÂê¤Ë¤Ê¤é¤Ê¤¤¤À¤í¤¦¡£
 182 ¤Ê¤¼¤Ê¤é¡¢POSIX.1 ¤Î
 183 .BR clock_settime (2)
 184 ¤Î»ÅÍÍ¤Ë¤Ï¡¢
 185 .B CLOCK_REALTIME
 186 ¤ÎÉÔÏ¢Â³¤ÊÊÑ²½¤Ï
 187 .BR nanosleep ()
 188 ¤Ë±Æ¶Á¤¹¤Ù¤¤Ç¤Ï¤Ê¤¤¡¢¤È½ñ¤«¤ì¤Æ¤¤¤ë¤«¤é¤Ç¤¢¤ë¡£
 189 .RS
 190 .PP
 191 .BR clock_settime (2)
 192 ·ÐÍ³¤Ç
 193 .B CLOCK_REALTIME
 194 ¥¯¥í¥Ã¥¯¤ÎÃÍ¤òÀßÄê¤·¤Æ¤â¡¢
 195 .BR nanosleep ()
 196 ´Ø¿ô¤Ê¤É¤Î
 197 .B CLOCK_REALTIME
 198 ¤Ë´ð¤Å¤¯¥µ¡¼¥Ó¥¹¤Ë¤è¤êÁêÂÐÅª¤Ê´ü´Ö¤À¤±¼Â¹Ô¤òÄä»ß¤¹¤ë¥¹¥ì¥Ã¥É¤Ë¤Ï±Æ¶Á¤Ï¤Ê¤¤¡£
 199 ·ë²Ì¤È¤·¤Æ¡¢¥¯¥í¥Ã¥¯ÃÍ¤¬¹¹¿·Á°¤«¸å¤«¤Ë´Ø¤ï¤é¤º¡¢Í×µá¤µ¤ì¤¿ÁêÂÐÅª¤Ê»þ´Ö¤¬
 200 ·Ð²á¤¹¤ë¤ÈËþÎ»¤¹¤ë¤³¤È¤Ë¤Ê¤ë¡£
 201 .RE
 202 .SS °ÊÁ°¤ÎÆ°ºî
 203 (Îã¤¨¤Ð¡¢»þ´Ö¤¬½ÅÍ×¤Ê°ÕÌ£¤ò»ý¤Ä¥Ï¡¼¥É¥¦¥§¥¢¤òÀ©¸æ¤¹¤ë¾ì¹ç¤Ê¤É)
 204 ¤è¤êÀµ³Î¤ÊÄä»ß¤òÉ¬Í×¤È¤¹¤ë¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤ËÂÐ±þ¤¹¤ë¤¿¤á¤Ë¡¢
 205 .BR nanosleep ()
 206 ¤Ï¡¢¥Þ¥¤¥¯¥íÉÃÀºÅÙ¤Î¥Ó¥¸¡¼¡¦¥¦¥§¥¤¥È¤òÍøÍÑ¤¹¤ë¤³¤È¤Ç¡¢
 207 2\ ms °Ê²¼¤ÎÄä»ß¤ò¹Ô¤¦¤³¤È¤¬¤Ç¤¤¿¡£
 208 Ã¢¤·¡¢¤³¤Îµ¡Ç½¤òÍøÍÑ¤¹¤ë¤Ë¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¤Î¥¹¥ì¥Ã¥É¤¬
 209 .B SCHED_FIFO
 210 ¤ä
 211 .B SCHED_RR
 212 ¤È¤¤¤Ã¤¿¥ê¥¢¥ë¥¿¥¤¥à¡¦¥Ý¥ê¥·¡¼¤Î¸µ¤Ç¥¹¥±¥¸¥å¡¼¥ê¥ó¥°¤µ¤ì¤Æ¤¤¤ë
 213 É¬Í×¤¬¤¢¤Ã¤¿¡£
 214 ¤³¤ÎÆÃÊÌ¤Ê³ÈÄ¥¤Ï¥«¡¼¥Í¥ë 2.5.39 ¤Çºï½ü¤µ¤ì¤¿¡£¤·¤¿¤¬¤Ã¤Æ¡¢
 215 ¸½ºß¤Î 2.4 ·ÏÎó¤Î¥«¡¼¥Í¥ë¤Ë¤Ï¤³¤Îµ¡Ç½¤¬Â¸ºß¤¹¤ë¤¬¡¢
 216 2.6·ÏÎó¤Î¥«¡¼¥Í¥ë¤Ë¤Ï¤Ê¤¤¡£
 217 .SH ¥Ð¥°
 218 Linux 2.4 ¤Ç¤Ï¡¢
 219 .BR nanosleep ()
 220 ¤¬
 221 .RB ( SIGTSTP
 222 ¤Ê¤É¤Î) ¥·¥°¥Ê¥ë¤Ë¤è¤êÄä»ß¤µ¤ì¤¿¾ì¹ç¡¢
 223 .BR nanosleep ()
 224 ¤Î¸Æ¤Ó½Ð¤·¤Ï
 225 .B SIGCONT
 226 ¥·¥°¥Ê¥ë¤Ë¤è¤ë¥¹¥ì¥Ã¥É¤ÎºÆ³«¸å¤Ë
 227 .B EINTR
 228 ¥¨¥é¡¼¤Ç¼ºÇÔ¤¹¤ë¡£
 229 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬¤³¤Î¸å¤ÇºÆ¥¹¥¿¡¼¥È¤µ¤ì¤¿¾ì¹ç¡¢
 230 ¥¹¥ì¥Ã¥É¤¬Ää»ß¾õÂÖ¤Ë¤¢¤ë´Ö¤Ë·Ð²á¤·¤¿»þ´Ö¤Ï
 231 Ää»ß´ü´Ö¤È¤·¤Æ¥«¥¦¥ó¥È¡Ö¤µ¤ì¤Ê¤¤¡×¡£
 232 .SH ´ØÏ¢¹àÌÜ
 233 .BR clock_nanosleep (2),
 234 .BR sched_setscheduler (2),
 235 .BR timer_create (2),
 236 .BR sleep (3),
 237 .BR usleep (3),
 238 .BR time (7)