aboutsummaryrefslogtreecommitdiffstats
path: root/tools/libaio/man/io_fsync.3
diff options
context:
space:
mode:
authorIan Campbell <ian.campbell@citrix.com>2013-07-31 16:15:51 +0100
committerIan Campbell <ian.campbell@citrix.com>2013-08-20 15:34:03 +0100
commit3d4678108a2157db6ae8c290897f67aaed14cdfa (patch)
treee5ce4b22b9fc9f68036937aa931059aee6c79491 /tools/libaio/man/io_fsync.3
parent03145f0fe42c007834c1ef50d95fe6c4f58a326a (diff)
downloadxen-3d4678108a2157db6ae8c290897f67aaed14cdfa.tar.gz
xen-3d4678108a2157db6ae8c290897f67aaed14cdfa.tar.bz2
xen-3d4678108a2157db6ae8c290897f67aaed14cdfa.zip
tools: remove in tree libaio
We have defaulted to using the system libaio for a while now and I din't think there are any relevant distros which don't have it that running Xen 4.4 would be reasonable on. Also it has caused confusion because it is not ever wanted on ARM, but the build system doesn't express that (could be fixed, but deleting is the right thing to do anyway). Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Reviewed-by: Andrew Cooper <andrew.cooper3@citrix.com> Acked-by: Matt Wilson <msw@amazon.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
Diffstat (limited to 'tools/libaio/man/io_fsync.3')
-rw-r--r--tools/libaio/man/io_fsync.382
1 files changed, 0 insertions, 82 deletions
diff --git a/tools/libaio/man/io_fsync.3 b/tools/libaio/man/io_fsync.3
deleted file mode 100644
index 53eb63d278..0000000000
--- a/tools/libaio/man/io_fsync.3
+++ /dev/null
@@ -1,82 +0,0 @@
-./" static inline int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)
-./" {
-./" io_prep_fsync(iocb, fd);
-./" io_set_callback(iocb, cb);
-./" return io_submit(ctx, 1, &iocb);
-./" }
-.TH io_fsync 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-io_fsync \- Synchronize a file's complete in-core state with that on disk
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <libaio.h>
-.sp
-.br
-.BI "int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.sp
-typedef void (*io_callback_t)(io_context_t ctx, struct iocb *iocb, long res, long res2);
-.sp
-.fi
-.SH DESCRIPTION
-When dealing with asynchronous operations it is sometimes necessary to
-get into a consistent state. This would mean for AIO that one wants to
-know whether a certain request or a group of request were processed.
-This could be done by waiting for the notification sent by the system
-after the operation terminated, but this sometimes would mean wasting
-resources (mainly computation time).
-.PP
-Calling this function forces all I/O operations operating queued at the
-time of the function call operating on the file descriptor
-.IR "iocb->io_fildes"
-into the synchronized I/O completion state . The
-.IR "io_fsync"
-function returns
-immediately but the notification through the method described in
-.IR "io_callback"
-will happen only after all requests for this
-file descriptor have terminated and the file is synchronized. This also
-means that requests for this very same file descriptor which are queued
-after the synchronization request are not affected.
-.SH "RETURN VALUES"
-Returns 0, otherwise returns errno.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-referenced data outside of the program's accessible address space.
-.TP
-.B EINVAL
-.I ctx
-refers to an unitialized aio context, the iocb pointed to by
-.I iocbs
-contains an improperly initialized iocb,
-.TP
-.B EBADF
-The iocb contains a file descriptor that does not exist.
-.TP
-.B EINVAL
-The file specified in the iocb does not support the given io operation.
-.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_getevents(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)