draft/man3/aio_fsync.3

   1 .\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" The GNU General Public License's references to "object code"
   9 .\" and "executables" are to be interpreted as the output of any
  10 .\" document formatting or typesetting system, including
  11 .\" intermediate and printed output.
  12 .\"
  13 .\" This manual is distributed in the hope that it will be useful,
  14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 .\" GNU General Public License for more details.
  17 .\"
  18 .\" You should have received a copy of the GNU General Public
  19 .\" License along with this manual; if not, write to the Free
  20 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  21 .\" USA.
  22 .\"
  23 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
  24 .\"         all rights reserved.
  25 .\" Translated Sun Jul  4 17:20:13 JST 2004
  26 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  27 .\"
  28 .TH AIO_FSYNC 3 2003-11-14  "" "Linux Programmer's Manual"
  29 .\"O .SH NAME
  30 .SH Ì¾Á°
  31 .\"O aio_fsync \- asynchronous file synchronization
  32 aio_fsync \- ÈóÆ±´ü¥Õ¥¡¥¤¥ë¤òÆ±´ü¤µ¤»¤ë
  33 .\"O .SH SYNOPSIS
  34 .SH ½ñ¼°
  35 .B "#include <aio.h>"
  36 .sp
  37 .BI "int aio_fsync(int " op ", struct aiocb *" aiocbp );
  38 .sp
  39 .\"O Link with \fI\-lrt\fP.
  40 \fI\-lrt\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
  41 .\"O .SH DESCRIPTION
  42 .SH ÀâÌÀ
  43 .\"O The
  44 .\"O .BR aio_fsync ()
  45 .\"O function does a sync on all outstanding asynchronous I/O operations
  46 .\"O associated with
  47 .\"O .IR aiocbp\->aio_fildes .
  48 .BR aio_fsync ()
  49 ´Ø¿ô¤Ï¡¢
  50 .I aiocbp\->aio_fildes
  51 ¤Ç´ØÏ¢ÉÕ¤±¤é¤ì¤Æ¤¤¤ë¤Þ¤À´°Î»¤·¤Æ¤¤¤Ê¤¤Á´¤Æ¤ÎÈóÆ±´ü I/O Áàºî¤òÆ±´ü¤µ¤»¤ë¡£
  52 .LP
  53 .\"O More precisely, if
  54 .\"O .I op
  55 .\"O is
  56 .\"O .BR O_SYNC ,
  57 .\"O then all currently queued I/O operations shall be
  58 .\"O completed as if by a call of
  59 .\"O .BR fsync (2),
  60 .\"O and if
  61 .\"O .I op
  62 .\"O is
  63 .\"O .BR O_DSYNC ,
  64 .\"O this call is the asynchronous analog of
  65 .\"O .BR fdatasync (2).
  66 ¤è¤êÀµ³Î¤Ë¸À¤¦¤È¡¢
  67 .I op
  68 ¤¬
  69 .B O_SYNC
  70 ¤Î¾ì¹ç¡¢¸½ºß¥¥å¡¼¤ËÆþ¤ì¤é¤ì¤Æ¤¤¤ëÁ´¤Æ¤Î I/O Áàºî¤Ï¡¢
  71 .BR fsync (2)
  72 ¤¬¸Æ¤Ð¤ì¤¿¤«¤Î¤è¤¦¤Ë´°Î»¤µ¤ì¤ë¤À¤í¤¦¡£
  73 ¤Þ¤¿
  74 .I op
  75 ¤¬
  76 .B O_DSYNC
  77 ¤Î¾ì¹ç¡¢¤³¤Î¸Æ¤Ó½Ð¤·¤Ï
  78 .BR fdatasync (2)
  79 ¤ÎÈóÆ±´üÈÇ¤È¤Ê¤ë¡£
  80 .\"O Note that this is a request only \(em this call does not wait
  81 .\"O for I/O completion.
  82 ¤³¤Î´Ø¿ô¤Ï¥ê¥¯¥¨¥¹¥È¤ò¹Ô¤¦¤À¤±¤Ç¤¢¤ëÅÀ¤ËÃí°Õ¤¹¤ë¤³¤È \(em
  83 ¤³¤Î¸Æ¤Ó½Ð¤·¤Ï I/O ¤Î´°Î»¤òÂÔ¤¿¤Ê¤¤¡£
  84 .LP
  85 .\"O Apart from
  86 .\"O .I aio_fildes
  87 .\"O the only field in the structure pointed to by
  88 .\"O .I aiocbp
  89 .\"O that is used by this call is the
  90 .\"O .I aio_sigevent
  91 .\"O field (a \fIstruct sigevent\fP) that indicates the desired type of
  92 .\"O asynchronous notification at completion.
  93 .I aiocbp
  94 ¤Ç»Ø¤µ¤ì¤ë¹½Â¤ÂÎ¤Î¥Õ¥£¡¼¥ë¥É¤Î¤¦¤Á¡¢¤³¤Î¸Æ¤Ó½Ð¤·¤Ç
  95 .I aio_fildes
  96 °Ê³°¤Ë»ÈÍÑ¤µ¤ì¤ë¤Î¤Ï
  97 .I aio_sigevent
  98 ¥Õ¥£¡¼¥ë¥É (\fIstruct sigevent\fP) ¤Î¤ß¤Ç¤¢¤ë¡£
  99 ¤³¤Î¥Õ¥£¡¼¥ë¥É¤Ï¡¢´°Î»»þ¤ÎÈóÆ±´üÄÌÃÎ¤Ë»ÈÍÑ¤·¤¿¤¤¥¿¥¤¥×¤ò¼¨¤¹¡£
 100 .\"O All other fields are ignored.
 101 ¤½¤ÎÂ¾¤Î¥Õ¥£¡¼¥ë¥É¤ÏÌµ»ë¤µ¤ì¤ë¡£
 102 .\"O .SH "RETURN VALUE"
 103 .SH ÊÖ¤êÃÍ
 104 .\"O On success (the sync request was successfully queued)
 105 .\"O this function returns 0.
 106 .\"O On error \-1 is returned, and
 107 .\"O .I errno
 108 .\"O is set appropriately.
 109 À®¸ù¤·¤¿¾ì¹ç (Æ±´ü¥ê¥¯¥¨¥¹¥È¤ò¥¥å¡¼¤ËÆþ¤ì¤ë¤Î¤ËÀ®¸ù¤·¤¿¾ì¹ç)¡¢
 110 ¤³¤Î´Ø¿ô¤Ï 0 ¤òÊÖ¤¹¡£
 111 ¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤¬ÊÖ¤µ¤ì¡¢
 112 .I errno
 113 ¤¬Å¬ÀÚ¤ËÀßÄê¤µ¤ì¤ë¡£
 114 .\"O .SH ERRORS
 115 .SH ¥¨¥é¡¼
 116 .TP
 117 .B EAGAIN
 118 .\"O Out of resources.
 119 ¥ê¥½¡¼¥¹¤¬Â¤ê¤Ê¤¤¡£
 120 .TP
 121 .B EBADF
 122 .\"O .I aio_fildes
 123 .\"O is not a valid file descriptor open for writing.
 124 .I aio_fildes
 125 ¤¬½ñ¤¹þ¤ß¤Î¤¿¤á¤Ë¥ª¡¼¥×¥ó¤µ¤ì¤¿Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ï¤Ê¤¤¡£
 126 .TP
 127 .B EINVAL
 128 .\"O No synchronized I/O for this file is supported, or
 129 .\"O .I op
 130 .\"O is not
 131 .\"O .B O_SYNC
 132 .\"O or
 133 .\"O .BR O_DSYNC .
 134 ¤³¤Î¥Õ¥¡¥¤¥ë¤ËÂÐ¤¹¤ëÆ±´ü I/O ¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 135 ¤Þ¤¿¤Ï
 136 .I op
 137 ¤¬
 138 .B O_SYNC
 139 ¤Ç¤â
 140 .B O_DSYNC
 141 ¤Ç¤â¤Ê¤¤¡£
 142 .\"O .SH "CONFORMING TO"
 143 .SH ½àµò
 144 POSIX.1-2001.
 145 .\"O .SH "SEE ALSO"
 146 .SH ´ØÏ¢¹àÌÜ
 147 .BR aio_cancel (3),
 148 .BR aio_error (3),
 149 .BR aio_read (3),
 150 .BR aio_return (3),
 151 .BR aio_suspend (3),
 152 .BR aio_write (3)