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)