← Back to branch summary

~ubuntu-branches/ubuntu/saucy/manpages/saucy

« back to all changes in this revision

Viewing changes to man3/aio_return.3

  • Committer: Package Import Robot
  • Author(s): Loïc Minier
  • Date: 2011-10-17 13:06:22 UTC
  • mfrom: (1.1.46 upstream) (2.2.11 sid)
  • Revision ID: package-import@ubuntu.com-20111017130622-rbdw3julnma2baqu
Tags: 3.32-0.2ubuntu1
* Merge from Debian testing/unstable; remaining changes:
  - ptrace.2, prctl.2: document Ubuntu-specific PTRACE_ATTACH,
    PR_SET_PTRACER behavior.
* Keep Debian's glibc-doc version in the Replaces as it's satisfactory for
  upgrades from natty and lucid.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man3/aio_return.3
20
20
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
21
21
.\" USA.
22
22
.\"
23
 
.TH AIO_RETURN 3 2003-11-14  "" "Linux Programmer's Manual"
 
23
.TH AIO_RETURN 3 2010-10-03  "" "Linux Programmer's Manual"
24
24
.SH NAME
25
25
aio_return \- get return status of asynchronous I/O operation
26
26
.SH SYNOPSIS
35
35
function returns the final return status for the asynchronous I/O request
36
36
with control block pointed to by
37
37
.IR aiocbp .
 
38
(See
 
39
.BR aio (7)
 
40
for a description of the
 
41
.I aiocb
 
42
structure.)
38
43
.LP
39
44
This function should be called only once for any given request, after
40
45
.BR aio_error (3)
43
48
.SH "RETURN VALUE"
44
49
If the asynchronous I/O operation has completed, this function returns
45
50
the value that would have been returned in case of a synchronous
46
 
.IR read ,
47
 
.IR write ,
 
51
.BR read (2),
 
52
.BR write (2),
 
53
.BR fsync (2)
48
54
or
49
 
.I fsync
50
 
request.
51
 
Otherwise the return value is undefined.
52
 
On error, the error value is returned.
 
55
.BR fdatasync (2),
 
56
call.
 
57
 
 
58
If the asynchronous I/O operation has not yet completed,
 
59
the return value and effect of
 
60
.BR aio_return ()
 
61
are undefined.
53
62
.SH ERRORS
54
63
.TP
55
64
.B EINVAL
56
65
.I aiocbp
57
66
does not point at a control block for an asynchronous I/O request
58
67
of which the return status has not been retrieved yet.
 
68
.SH VERSIONS
 
69
The
 
70
.BR aio_return ()
 
71
function is available since glibc 2.1.
59
72
.SH "CONFORMING TO"
60
 
POSIX.1-2001.
 
73
POSIX.1-2001, POSIX.1-2008.
 
74
.SH EXAMPLE
 
75
See
 
76
.BR aio (7).
61
77
.SH "SEE ALSO"
62
78
.BR aio_cancel (3),
63
79
.BR aio_error (3),
64
80
.BR aio_fsync (3),
65
81
.BR aio_read (3),
66
82
.BR aio_suspend (3),
67
 
.BR aio_write (3)
 
83
.BR aio_write (3),
 
84
.BR lio_listio (3),
 
85
.BR aio (7)
68
86
.SH COLOPHON
69
 
This page is part of release 3.27 of the Linux
 
87
This page is part of release 3.32 of the Linux
70
88
.I man-pages
71
89
project.
72
90
A description of the project,