1 /* Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Library General Public License for more details.
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB. If not,
16 write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 Boston, MA 02111-1307, USA. */
20 * ISO/IEC 9945-1:1996 6.7: Asynchronous Input and Output
30 #include <sys/types.h>
34 /* Asynchronous I/O control block. */
37 int aio_fildes
; /* File desriptor. */
38 int aio_lio_opcode
; /* Operation to be performed. */
39 int aio_reqprio
; /* Request priority offset. */
40 volatile void *aio_buf
; /* Location of buffer. */
41 size_t aio_nbytes
; /* Length of transfer. */
42 struct sigevent aio_sigevent
; /* Signal number and value. */
44 /* Internal members. */
45 struct aiocb
*__next_prio
;
49 __ssize_t __return_value
;
51 #ifndef __USE_FILE_OFFSET64
52 __off_t aio_offset
; /* File offset. */
53 char __pad
[sizeof (__off64_t
) - sizeof (__off_t
)];
55 __off64_t aio_offset
; /* File offset. */
60 /* The same for the 64bit offsets. */
61 #ifdef __USE_LARGEFILE64
64 int aio_fildes
; /* File desriptor. */
65 int aio_lio_opcode
; /* Operation to be performed. */
66 int aio_reqprio
; /* Request priority offset. */
67 volatile void *aio_buf
; /* Location of buffer. */
68 size_t aio_nbytes
; /* Length of transfer. */
69 struct sigevent aio_sigevent
; /* Signal number and value. */
71 /* Internal members. */
75 __ssize_t __return_value
;
77 __off64_t aio_offset
; /* File offset. */
84 /* To customize the implementation one can use the following struct.
85 This implementation follows the one in Irix. */
88 int aio_threads
; /* Maximal number of threads. */
89 int aio_num
; /* Number of expected simultanious requests. */
90 int aio_locks
; /* Not used. */
91 int aio_usedba
; /* Not used. */
92 int aio_debug
; /* Not used. */
93 int aio_numusers
; /* Not used. */
99 /* Return values of cancelation function. */
103 #define AIO_CANCELED AIO_CANCELED
105 #define AIO_NOTCANCELED AIO_NOTCANCELED
107 #define AIO_ALLDONE AIO_ALLDONE
111 /* Operation codes for `aio_lio_opcode'. */
115 #define LIO_READ LIO_READ
117 #define LIO_WRITE LIO_WRITE
119 #define LIO_NOP LIO_NOP
123 /* Synchronization options for `lio_listio' function. */
127 #define LIO_WAIT LIO_WAIT
129 #define LIO_NOWAIT LIO_NOWAIT
133 /* Allow user to specify optimization. */
135 extern void aio_init (__const
struct aioinit
*__init
) __THROW
;
139 #ifndef __USE_FILE_OFFSET64
140 /* Enqueue read request for given number of bytes and the given priority. */
141 extern int aio_read (struct aiocb
*__aiocbp
) __THROW
;
142 /* Enqueue write request for given number of bytes and the given priority. */
143 extern int aio_write (struct aiocb
*__aiocbp
) __THROW
;
145 /* Initiate list of I/O requests. */
146 extern int lio_listio (int __mode
, struct aiocb
*__const __list
[],
147 int __nent
, struct sigevent
*__restrict __sig
) __THROW
;
149 /* Retrieve error status associated with AIOCBP. */
150 extern int aio_error (__const
struct aiocb
*__aiocbp
) __THROW
;
151 /* Return status associated with AIOCBP. */
152 extern __ssize_t
aio_return (struct aiocb
*__aiocbp
) __THROW
;
154 /* Try to cancel asynchronous I/O requests outstanding against file
155 descriptor FILDES. */
156 extern int aio_cancel (int __fildes
, struct aiocb
*__aiocbp
) __THROW
;
158 /* Suspend calling thread until at least one of the asynchronous I/O
159 operations referenced by LIST has completed. */
160 extern int aio_suspend (__const
struct aiocb
*__const __list
[], int __nent
,
161 __const
struct timespec
*__restrict __timeout
) __THROW
;
163 /* Force all operations associated with file desriptor described by
164 `aio_fildes' member of AIOCBP. */
165 extern int aio_fsync (int __operation
, struct aiocb
*__aiocbp
) __THROW
;
168 extern int __REDIRECT (aio_read
, (struct aiocb
*__aiocbp
) __THROW
, aio_read64
);
169 extern int __REDIRECT (aio_write
, (struct aiocb
*__aiocbp
) __THROW
,
172 extern int __REDIRECT (lio_listio
,
173 (int __mode
, struct aiocb
*__const __restrict __list
[],
174 int __nent
, struct sigevent
*__restrict __sig
) __THROW
,
177 extern int __REDIRECT (aio_error
, (__const
struct aiocb
*__aiocbp
) __THROW
,
179 extern __ssize_t
__REDIRECT (aio_return
, (struct aiocb
*__aiocbp
) __THROW
,
182 extern int __REDIRECT (aio_cancel
,
183 (int __fildes
, struct aiocb
*__aiocbp
) __THROW
,
186 extern int __REDIRECT (aio_suspend
,
187 (__const
struct aiocb
*__const __restrict __list
[],
189 __const
struct timespec
*__restrict __timeout
) __THROW
,
192 extern int __REDIRECT (aio_fsync
,
193 (int __operation
, struct aiocb
*__aiocbp
) __THROW
,
197 # define aio_read aio_read64
198 # define aio_write aio_write64
199 # define lio_listio lio_listio64
200 # define aio_error aio_error64
201 # define aio_return aio_return64
202 # define aio_cancel aio_cancel64
203 # define aio_suspend aio_suspend64
204 # define aio_fsync aio_fsync64
208 #ifdef __USE_LARGEFILE64
209 extern int aio_read64 (struct aiocb64
*__aiocbp
) __THROW
;
210 extern int aio_write64 (struct aiocb64
*__aiocbp
) __THROW
;
212 extern int lio_listio64 (int __mode
, struct aiocb64
*__const __list
[],
213 int __nent
, struct sigevent
*__restrict __sig
)
216 extern int aio_error64 (__const
struct aiocb64
*__aiocbp
) __THROW
;
217 extern __ssize_t
aio_return64 (struct aiocb64
*__aiocbp
) __THROW
;
219 extern int aio_cancel64 (int __fildes
, struct aiocb64
*__aiocbp
) __THROW
;
221 extern int aio_suspend64 (__const
struct aiocb64
*__const __list
[], int __nent
,
222 __const
struct timespec
*__restrict __timeout
)
225 extern int aio_fsync64 (int __operation
, struct aiocb64
*__aiocbp
) __THROW
;