> Linux Reviews > man >

io_cancel

io_cancel.2.man

1. io_cancel.2.man

Manpage of IO_CANCEL

IO_CANCEL

Section: Руководство программиста Linux (2)
Updated: 2008-06-18
Index Return to Main Contents

ИМЯ

io_cancel - отменяет невыполненную асинхронную операцию ввода-вывода

ОБЗОР

#include <libaio.h>

int io_cancel(aio_context_t ctx_id, struct iocb *iocb,
              struct io_event *result);

Компонуется при указании параметра -laio.

ОПИСАНИЕ

io_cancel() пытается отменить асинхронную операцию ввода-вывода, ранее отправленную системным вызовом io_submit(2). ctx_id является идентификатором контекста AIO отменяемой операции. Если контекст AIO найден, то событие будет отменено и затем скопировано в память, куда указывает result, без помещения в очередь заполнения.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

В случае успешного завершения io_cancel() возвращает 0. В случае ошибки смотрите ЗАМЕЧАНИЯ.

ОШИБКИ

EAGAIN: Указанный iocb не был отменен.
EFAULT: Одна из структур данных указывает на некорректные данные.
EINVAL: Некорректен контекст AIO, указанный ctx_id.
ENOSYS: Вызов io_cancel() не реализован для этой архитектуры.

ВЕРСИИ

Асинхронные системные вызовы ввода-вывода впервые появились в Linux 2.5 в августе 2002 года.

СООТВЕТСТВИЕ СТАНДАРТАМ

Вызов io_cancel() есть только в Linux, и он не должен использоваться в переносимых программах.

ЗАМЕЧАНИЯ

В glibc нет обёрточной функции для данного системного вызова.

Обёртка io_cancel(), предоставляемая в libaio, не следует соглашениям обычной библиотеки C по возврату ошибки: при ошибке возвращается отрицательный номер ошибки (одно из отрицательных значений, описанных в разделе ОШИБКИ). Если системный вызов вызывается через syscall(2), то возвращаемое значение следует обычным соглашениям для указания на ошибку: -1 с errno равной (положительному) значению ошибки.

СМОТРИТЕ ТАКЖЕ

io_destroy(2), io_getevents(2), io_setup(2), io_submit(2)

This document was created by man2html using the manual pages.
Time: 17:41:43 GMT, May 11, 2012