aio_read 或 aio_read64 子例程

用途

异步读取文件。

库

标准 C 库 (libc.a)

语法

#include <aio.h>

int aio_read (aiocbp)
struct aiocb *aiocbp;

描述

aio_read 子例程将 aio_nbytes 从与 aio_fildes 关联的文件读取到 aio_buf指向的缓冲区中。 当读请求已启动或排队到文件或设备时 (即使不能立即传递数据) ，子例程将返回。

aiocbp 值可用作 aio_error 和 aio_return 子例程的自变量，以便确定异步操作在继续时的错误状态和返回状态。 如果在排队期间迂到错误情况，那么函数调用将返回而不启动或排队请求。 请求的操作发生在文件中的绝对位置，如 aio_offset 所给出的那样，就好像在操作之前立即调用了 lseek 子例程，其偏移量等于 aio_offset ，而条件等于 SEEK_SET。 成功调用异步 I/O 操作入队后，未指定该文件的文件偏移量值。

aio_lio_opcode 字段被 aio_read 子例程忽略。

如果此文件支持优先 I/O ，那么将以等于进程调度优先级减去 aiocbp->aio_reqprio的优先级提交异步操作。

aiocbp 参数指向 aiocb 结构。 如果 aio_buf 指向的缓冲区或 aiocbp 指向的控制块在异步 I/O 完成之前成为非法地址，那么行为未定义。

使用相同 aiocbp 的同时异步操作产生未定义的结果。

如果在与 aio_fildes关联的文件上启用了同步 I/O ，那么此子例程的行为是根据同步 I/O 数据完整性完成和同步 I/O 文件完整性完成的定义。

对于在异步 I/O 处于未完成状态时更改进程内存空间的任何系统操作，未定义该操作的结果。

对于常规文件，不会发生超出打开文件描述中确定的最大偏移量的数据传输。

如果将 aio_read 或 aio_read64 子例程与通过调用 shm_open 子例程获得的文件描述符配合使用，那么它将失败并返回 EINVAL。

参数

aiocb 结构

int               aio_fildes
off_t             aio_offset
char             *aio_buf
size_t            aio_nbytes
int               aio_reqprio
struct sigevent   aio_sigevent
int               aio_lio_opcode

执行环境

只能从 进程环境 调用 aio_read 和 aio_read64 子例程。

返回值

如果 I/O 操作成功排队，那么 aio_read 子例程将 0 返回到调用进程。 否则会返回-1并设置errno全局变量来指示错误。

错误代码

可以在调用 aio_read 子例程时同步检测以下每个条件，也可以异步检测。 如果同步检测到以下任何条件，aio_read子程序将返回-1并将errno全局变量设置为相应值。 如果异步检测到以下任一条件，异步操作的返回状态将设置为-1，异步操作的错误状态将设置为相应的值。

旧 AIO aio_read 子例程

用途: 从文件异步读取。

库 (旧 AIO aio_read 子例程)

标准 C 库 (libc.a)

语法 (旧 AIO aio_read 子例程)

#include <aio.h>

描述 (旧 AIO aio_read 子例程)

aio_read 子例程从文件异步读取。 具体而言， aio_read 子例程从与 FileDescriptor 参数相关联的文件读取到缓冲区中。

aio_read64 子例程类似于 aio_read 子例程 execpt ，它采用 aiocb64 引用参数。 这允许 aio_read64 子例程指定超出 OFF_MAX (2 千兆字节减去 1) 的偏移量。

在启用了大文件的编程环境中， aio_read 将重新定义为 aio_read64 。

如果将 aio_read 或 aio_read64 子例程与通过调用 shm_open 子例程获得的文件描述符配合使用，那么它将失败并返回 EINVAL。

读取的详细信息由 aiocb 结构中的信息提供，该结构由 aiocbp 参数指向。 此信息包含以下字段:

当读请求已排队时， aio_read 子例程将更新由aio_whence和aio_offsetaiocb 结构中的字段，就好像所请求的 I/O 已完成一样。 然后返回到调用程序。 该aio_whence和aio_offset字段具有与 lseek 子例程中的 whence 和 offset 参数相同的含义。 对于无法查找的文件对象，子例程将忽略它们。

如果在调用期间发生错误，那么读取请求不会排队。 要确定请求的状态，请使用 aio_error 子例程。

要使调用进程在 I/O 操作完成时接收到 SIGIO 信号，请在aio_flagaiocb 结构中的字段。

#define _AIO_AIX_SOURCE
#include <sys/aio.h>

->xlc ... -D_AIO_AIX_SOURCE ... legacy_aio_program.c 

由于此时不支持优先 I/O ，因此目前不使用结构的 aio_reqprio 字段。

参数 (旧 AIO aio_read 子例程)

aiocb 结构

struct aiocb
{
       int                 aio_whence;
       off_t               aio_offset;
       char                *aio_buf;
       ssize_t             aio_return;
       int                 aio_errno;
       size_t              aio_nbytes;
       union {
              int          reqprio;
              struct {
                     int   version:8;
                     int   priority:8;
                     int   cache_hint:16;
              } ext;
       } aio_u1;
       int                 aio_flag;
       int                 aio_iocpfd;
       aio_handle_t        aio_handle;
}

#define aio_reqprio        aio_u1.reqprio
#define aio_version        aio_u1.ext.version
#define aio_priority       aio_u1.ext.priority
#define aio_cache_hint     aio_u1.ext.cache_hint

执行环境 (旧 AIO aio_read 子例程)

只能从进程环境调用 aio_read 和 aio_read64 子例程。

返回值 (旧 AIO aio_read 子例程)

当读取请求队列成功时， aio_read 子例程返回值 0。 否则，返回值为-1，并设置全局变量errno来标识错误。

可将返回码设置为以下 errno 值:

将 I/O 完成端口与 AIO 请求配合使用时，还可以将返回码设置为以下 errno 值: