Changeset View
Changeset View
Standalone View
Standalone View
head/lib/libc/sys/aio_fsync.2
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd July 21, 2016 | .Dd August 19, 2016 | ||||
.Dt AIO_FSYNC 2 | .Dt AIO_FSYNC 2 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm aio_fsync | .Nm aio_fsync | ||||
.Nd asynchronous file synchronization (REALTIME) | .Nd asynchronous file synchronization (REALTIME) | ||||
.Sh LIBRARY | .Sh LIBRARY | ||||
.Lb libc | .Lb libc | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
Show All 33 Lines | |||||
in order to determine return or error status for the enqueued operation | in order to determine return or error status for the enqueued operation | ||||
while it is in progress. | while it is in progress. | ||||
.Pp | .Pp | ||||
If the request could not be enqueued (generally due to invalid arguments), | If the request could not be enqueued (generally due to invalid arguments), | ||||
the call returns without having enqueued the request. | the call returns without having enqueued the request. | ||||
.Pp | .Pp | ||||
The | The | ||||
.Fa iocb->aio_sigevent | .Fa iocb->aio_sigevent | ||||
structure can be used to request notification of the request's | structure can be used to request notification of the operation's | ||||
completion as described in | completion as described in | ||||
.Xr aio 4 . | .Xr aio 4 . | ||||
.Sh RESTRICTIONS | .Sh RESTRICTIONS | ||||
The asynchronous I/O Control Block structure pointed to by | The Asynchronous I/O Control Block structure pointed to by | ||||
.Fa iocb | .Fa iocb | ||||
must remain valid until the | must remain valid until the | ||||
operation has completed. | operation has completed. | ||||
For this reason, use of auto (stack) variables | |||||
for these objects is discouraged. | |||||
.Pp | .Pp | ||||
The asynchronous I/O control buffer | The asynchronous I/O control buffer | ||||
.Fa iocb | .Fa iocb | ||||
should be zeroed before the | should be zeroed before the | ||||
.Fn aio_fsync | .Fn aio_fsync | ||||
call to avoid passing bogus context information to the kernel. | call to avoid passing bogus context information to the kernel. | ||||
.Pp | .Pp | ||||
Modifications of the Asynchronous I/O Control Block structure or the | Modification of the Asynchronous I/O Control Block structure is not allowed | ||||
buffer contents after the request has been enqueued, but before the | while the request is queued. | ||||
request has completed, are not allowed. | |||||
.Sh RETURN VALUES | .Sh RETURN VALUES | ||||
.Rv -std aio_fsync | .Rv -std aio_fsync | ||||
.Sh ERRORS | .Sh ERRORS | ||||
The | The | ||||
.Fn aio_fsync | .Fn aio_fsync | ||||
system call will fail if: | system call will fail if: | ||||
.Bl -tag -width Er | .Bl -tag -width Er | ||||
.It Bq Er EAGAIN | .It Bq Er EAGAIN | ||||
▲ Show 20 Lines • Show All 77 Lines • Show Last 20 Lines |