#include <aio.h>
/*
函数名 ：int aio_write(struct aiocb *aiocbp)
参 数 ：struct aiocb *aiocbp
返回值 ：执行成功返回0，出错返回-1，并设置errno的值
说 明 ：请求对一个有效的文件描述符进行异步读操作，
这个文件描述符可以表示一个文件、套接字甚至管道
*/
int aio_write(struct aiocb *aiocbp);
/*
函数名 ：int aio_read(struct aiocb *aiocbp)
参 数 ：struct aiocb *aiocbp
返回值 ：执行成功返回0，出错返回-1，并设置errno的值
说 明 ：请求对一个有效的文件描述符进行异步写操作，
这个文件描述符可以表示一个文件、套接字甚至管道
*/
int aio_read(struct aiocb *aiocbp);
/*
函数名 ：int aio_error(struct aiocb *aiocbp)
参 数 ：struct aiocb *aiocbp
返回值 ：EINPROGRESS:说明请求尚未完成
ECANCELLED:说明请求被应用程序取消
说 明 ：被用来确定请求状态
*/
int aio_error(struct aiocb *aiocbp);
/*
函数名 ：int aio_return(struct aiocb *aiocbp)
参 数 ：struct aiocb *aiocbp
返回值 ：
说 明 :1、异步I/O和标准I/O方式之间的另外一个区别是:不能立即访问这个函数的返回状态，
因为异步I/O并没有阻塞在read()调用上。
2、在标准的read调用中返回状态时:在该函数返回时提供的
3、但是在异步I/O中，我们要使用aio_return函数
*/
ssize_t aio_return(struct aiocb *aiocbp);
/*
函数名 ：int aio_suspend(const struct aiocb *const list[],int nent,const struct timespec *timeout);
参 数 ：struct aiocb *aiocbp
返回值 ：
说 明 :挂起调用进程直到IO完成或时间到期
用户可以使用aio_suspend()函数来挂起或阻塞掉用进程，直到异步请求完成为止，
此时产生一个信号，或者在发生其他超时操作时会导致aio_suspend()返回
*/
int aio_suspend(const struct aiocb *const list[],int nent,const struct timespec *timeout);
/*
函数名 ：int aio_cancel(int fd,struct aiocb *aiocbp);
参 数 ：struct aiocb *aiocbp
返回值 ：
说 明 :允许用户取消对某个文件描述符执行的一个或所有的I.O请求
用户需要提供一个aiocb指针，如果这个请求被成功取消，
1、那么这个函数就会返回AIO_CANCELED,
2、如果请求完成，此函数就会返回AIO_TCANCELED
3、aiocbp参数设置为NULL，如果所有的请求都被取消了，这个函数将返回AIO_CANCELED,
4、如果至少有一个请求被取消，那么这个函数就会返回AIO_NOT_CANCELED
5、如果一个也没被取消就会返回AIO_ALLODNOE
*/
int aio_cancel(int fd,struct aiocb *aiocbp);
/*
函数名 ：int lio_listio(int mode,struct aiocb *restrict const list[restrict],int nent,struct sigevent *restrict notification);
参 数 ：int mode -- mode参数可以是LIO_WAIT或LIO_NOWAIT
-- LIO_WAIT会阻塞这个调用，直到所有的I/O都完成为止
-- LIO_NOWAIT立即返回
参 数 ：list -- aiocb的引用列表
参 数 ：nent -- 最大元素个数
返回值 ：正在进行IO操作返回EINPROGRESS
说 明 :
*/
int lio_listio(int mode,struct aiocb *restrict const list[restrict],int nent,struct sigevent *restrict notification);
struct aiocb{
int aio_filds; //要被读写的fd
off_t aio_offset; //读写操作对应的内存buffer
volatile void *aio_buf;//读写操作对应的文件偏移
size_t aio_nbytes; //需要读写的字节长度
int aio_reqprio; //请求的优先级
struct sigevent aio_sigevent; //异步事件，定义异步操作完成时的通知信号或回调函数
int aio_lio_opcode;
};
struct sigevent{
union sigval sigev_value;
int sigv_signo;
int sigev_notify;//异步事件的通知类型 SIGEV_NONE（不通知）、SIGEV_SIGNAL(生成信号)、SIGEV_THREAD(执行sigev_notify_function指定的函数)
void (*sigev_notify_function) (union sigval);
pthread_attr_t *sigev_notify_attrbutes;
