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

« back to all changes in this revision

Viewing changes to man3/aio_error.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:
20
20
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
21
21
.\" USA.
22
22
.\"
23
 
.TH AIO_ERROR 3 2003-11-14  "" "Linux Programmer's Manual"
 
23
.TH AIO_ERROR 3 2010-10-03  "" "Linux Programmer's Manual"
24
24
.SH NAME
25
25
aio_error \- get error status of asynchronous I/O operation
26
26
.SH SYNOPSIS
35
35
function returns the error 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
.SH "RETURN VALUE"
39
 
This function returns
40
 
.B EINPROGRESS
 
44
This function returns one of the following:
 
45
.IP * 3
 
46
.BR EINPROGRESS ,
41
47
if the request has not been
42
48
completed yet.
43
 
It returns
44
 
.B ECANCELED
 
49
.IP *
 
50
.BR ECANCELED ,
45
51
if the request was canceled.
46
 
It returns 0 if the request completed successfully.
47
 
Otherwise an error value is returned, the same value that would have
48
 
been stored in the
 
52
.IP *
 
53
0, if the request completed successfully.
 
54
.IP *
 
55
A positive error, if the asynchronous I/O operation failed.
 
56
This is the same value that would have been stored in the
49
57
.I errno
50
 
variable in case of a synchronous
51
 
.IR read ,
52
 
.IR write ,
53
 
.IR fsync ,
 
58
variable in the case of a synchronous
 
59
.BR read (2),
 
60
.BR write (2),
 
61
.BR fsync (2),
54
62
or
55
 
.I fdatasync
56
 
request.
57
 
On error, the error value is returned.
 
63
.BR fdatasync (2)
 
64
call.
58
65
.SH ERRORS
59
66
.TP
60
67
.B EINVAL
63
70
of which the return status (see
64
71
.BR aio_return (3))
65
72
has not been retrieved yet.
 
73
.SH VERSIONS
 
74
The
 
75
.BR aio_error ()
 
76
function is available since glibc 2.1.
66
77
.SH "CONFORMING TO"
67
 
POSIX.1-2001.
 
78
POSIX.1-2001, POSIX.1-2008.
 
79
.SH EXAMPLE
 
80
See
 
81
.BR aio (7).
68
82
.SH "SEE ALSO"
69
83
.BR aio_cancel (3),
70
84
.BR aio_fsync (3),
71
85
.BR aio_read (3),
72
86
.BR aio_return (3),
73
87
.BR aio_suspend (3),
74
 
.BR aio_write (3)
 
88
.BR aio_write (3),
 
89
.BR lio_listio (3),
 
90
.BR aio (7)
75
91
.SH COLOPHON
76
 
This page is part of release 3.27 of the Linux
 
92
This page is part of release 3.32 of the Linux
77
93
.I man-pages
78
94
project.
79
95
A description of the project,