📄 aio_fsync.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>aio_fsync</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_001_122"> </a>NAME</h4><blockquote>aio_fsync - asynchronous file synchronisation(<b>REALTIME</b>)</blockquote><h4><a name = "tag_000_001_123"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="aio.h.html">aio.h</a>>int aio_fsync(int <i>op</i>, struct aiocb *<i>aiocbp</i>);</code></pre></blockquote><h4><a name = "tag_000_001_124"> </a>DESCRIPTION</h4><blockquote>The<i>aio_fsync()</i>function asynchronously forces all I/O operations associated with the fileindicated by the file descriptor<i>aio_fildes</i>member of the<b>aiocb</b>structure referenced by the<i>aiocbp</i>argument and queued at the time of the call to<i>aio_fsync()</i>to the synchronised I/O completion state.The function call returnswhen the synchronisation request has been initiatedor queued to the file or device(even when the data cannot be synchronised immediately).<p>If<i>op</i>is O_DSYNC,all currently queued I/O operations are completed as if by a call to<i><a href="fdatasync.html">fdatasync()</a></i>;that is, as defined forsynchronised I/O data integrity completion.If<i>op</i>is O_SYNC,all currently queued I/O operations are completed as if by a call to<i><a href="fsync.html">fsync()</a></i>;that is, as defined forsynchronised I/O file integrity completion.If the<i>aio_fsync()</i>function fails, or if the operation queued by<i>aio_fsync()</i>fails, then, as for<i><a href="fsync.html">fsync()</a></i>and<i><a href="fdatasync.html">fdatasync()</a></i>,outstanding I/O operations are not guaranteed to have been completed.<p>If<i>aio_fsync()</i>succeeds, then it is only the I/O that was queued at the time of the callto<i>aio_fsync()</i>that is guaranteed to be forced to the relevant completion state.The completion of subsequent I/O on the file descriptor is not guaranteedto be completed in a synchronised fashion.<p>The<i>aiocbp</i>argument refers to an asynchronous I/O control block.The<i>aiocbp</i>value may be used as an argument to<i><a href="aio_error.html">aio_error()</a></i>and<i><a href="aio_return.html">aio_return()</a></i>in order to determine theerror status and return status, respectively, of the asynchronous operationwhile it is proceeding.When the request is queued,the error status for the operation isEINPROGRESS.When all data has beensuccessfully transferred,the error status will be resetto reflect the success or failure of the operation.If the operation does not complete successfully,the error status for the operation will be set to indicate the error.The<i>aio_sigevent</i>member determines the asynchronous notification to occur as specified in<xref href=siggendel><a href="sigaction.html#tag_000_008_581_001">Signal Generation and Delivery</a></xref>when all operations have achievedsynchronised I/O completion.All other members of the structure referenced by<i>aiocbp</i>are ignored.If the control block referenced by<i>aiocbp</i>becomes an illegal address prior to asynchronous I/O completion,then the behaviour is undefined.<p>If the<i>aio_fsync()</i>function fails or the<i>aiocbp</i>indicates an error condition, data is not guaranteed to have beensuccessfully transferred.<p>If<i>aiocbp</i>is NULL,then no status is returned in<i>aiocbp</i>,and no signal is generated upon completion of the operation.</blockquote><h4><a name = "tag_000_001_125"> </a>RETURN VALUE</h4><blockquote>The<i>aio_fsync()</i>function returns the value 0 to thecalling process if the I/O operation is successfully queued;otherwise, the function returns the value -1 and sets<i>errno</i>to indicate the error.</blockquote><h4><a name = "tag_000_001_126"> </a>ERRORS</h4><blockquote>The <i>aio_fsync()</i>function will fail if:<dl compact><dt>[EAGAIN]<dd>The requested asynchronous operation was not queued due totemporary resource limitations.<dt>[EBADF]<dd>The<i>aio_fildes</i>member of the<b>aiocb</b>structure referenced by the<i>aiocbp</i>argument is not a valid file descriptor open for writing.<dt>[EINVAL]<dd>This implementation does not support synchronised I/O for this file.<dt>[EINVAL]<dd>A value of<i>op</i>other than O_DSYNC or O_SYNC was specified.<dt>[ENOSYS]<dd>The<i>aio_fsync()</i>function is not supported by this implementation.</dl><p>In the event that any of the queued I/O operations fail,<i>aio_fsync()</i>returns the error condition defined for<i><a href="read.html">read()</a></i>and<i><a href="write.html">write()</a></i>.The error will be returned in the error status for the asynchronous<i><a href="fsync.html">fsync()</a></i>operation, which can be retrieved using<i><a href="aio_error.html">aio_error()</a></i>.</blockquote><h4><a name = "tag_000_001_127"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_001_128"> </a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_000_001_129"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_001_130"> </a>SEE ALSO</h4><blockquote><i><a href="fcntl.html">fcntl()</a></i>,<i><a href="fdatasync.html">fdatasync()</a></i>,<i><a href="fsync.html">fsync()</a></i>,<i><a href="open.html">open()</a></i>,<i><a href="read.html">read()</a></i>,<i><a href="write.html">write()</a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the POSIX Realtime Extension (1003.1b-1993/1003.1i-1995)</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -